Skip to content

spaceships-javaAPIs

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

spaceships-javaAPIs

README.md

spaceships-javaAPIs token sample cordapp

IMPORTANT: this project is using TokenSDK snapshot until quarterly release available on mavenCentral

// FOR USE with snapshot source (pre-release JAVA APIs)
tokens_release_group = 'com.r3.corda.lib.tokens'
tokens_release_version = '1.2-SNAPSHOT'

You must download the latest source here and then run the gradle task 'publishToMavenLocal'

This cordapp demonstrates the new Java Apis released with TokenSDK 1.2

The core changes include easier access to the following Utility classes and functions from Java:

  • com.r3.corda.lib.tokens.money
    • MoneyUtilities
    • DigitalCurrency
    • FiatCurrency
  • com.r3.corda.lib.tokens.selection
    • DatabaseSelectionConfig
    • SelectionUtilities
    • TokenQueryBy
    • DatabaseTokenSelection
  • com.r3.corda.lib.tokens.contracts.utilities
    • AmountUtilities
  • com.r3.corda.lib.tokens.workflows.utilities
    • FlowUtilities
    • NotaryUtilities
    • QueryUtilities
    • TokenUtilities

Additionally two new Java Builder classes have been added to allow easy creation of both Fungible and NonFungible Tokens:

  • FungibleTokenBuilder
  • NonFungibleTokenBuilder

The Cordapp will allow International Planetary Council (IPC) residents to use their local currencies to either purchase unique spaceships (represented by NonFungibleToken) OR invest in partial ownership of a spaceship (represented by a FungibleToken).

Examples of the new Java APIs will be used throughout and identified as such.

Concepts

Flows

Flows are executed through the FlowTests class in the workflows module. They can also be run through the CrashShell.

Pre-Requisites

See https://docs.corda.net/getting-set-up.html.

For a brief introduction to Token SDK in Corda, see https://medium.com/corda/introduction-to-token-sdk-in-corda-9b4dbcf71025

Usage

Running the CorDapp

Open a terminal and go to the project root directory and type: (to deploy the nodes using bootstrapper)

./gradlew clean deployNodes

Then type: (to run the nodes)

./build/nodes/runnodes

Interacting with the nodes

Shell

When started via the command line, each node will display an interactive shell:

Welcome to the Corda interactive shell.
Useful commands include 'help' to see what is available, and 'bye' to shut down the node.

Tue July 09 11:58:13 GMT 2019>>>

You can use this shell to interact with your node.