Examples

NOTES:

There is a typescript project directly in this wiki repository with all the example sources - you can check it out and inspect:

• git clone https://github.com/proximax-storage/tsjs-xpx-chain-sdk.wiki
  • see folder files/demo/src/demo

Helper code.

(those are referenced from other examples through Network class)

• Get generationHash from block 1 (class NetworkProperties)
  • you need it as a mandatory parameter for every transaction signing
• Wait for a transaction to be confirmed (method announceAndWaitForConfirmation)
• Put all the http api endpoint classes into a single wrapper (class ApiEndpoint)

Basic functions.

• Generates new Keypair.
• Generates a Keypair from a private key.
• Generate Account struct.
• Generate address from a public key.
• Generate address from a private key.

Types of requests

Account gets

• Get AccountInfo for an account.
• Get AccountsInfo for different accounts.
• Get confirmed transactions information.
• Get incoming transactions information.
• Get outgoing transactions information.
• Get unconfirmed transactions information.
• Get aggregate bonded transactions information.
• Get multisig account information.
• Get multisig account graph information.

Transaction gets

• Get transaction information of transactionId or transactionHash.
• Get transaction information for a given set of transactionId or transactionHash.
• Get transaction status of transactionId or transactionHash.
• Get an array of transaction statuses for a given set of transactionId or transactionHash.

Mosaic gets

• Get mosaic information.
• Get information for a set of mosaics.
• Get readable names for a set of mosaics.
• Get an array of MosaicInfo from mosaics created under provided namespace.

Namespace gets

• Get namespace information.
• Get namespaces an account owns.
• Get readable names for a set of namespaces.
• Get an array of NamespaceInfo for a given set of addresses.

BlockChain gets

• Get BlockInfo for a given block height.
• Get transactions from a block.
• Get the current height of the chain.
• Get the current score of the chain.
• Get the storage information.
• Get an array of BlockInfo for a given block height and limit.

Network gets

• Get the current network type of the chain.

Announces a transaction

Transfer Transaction

• Create a transfer transaction

Register namespace transaction

• Create a root namespace
• Create a sub namespace

Mosaic definition transaction

• Create a mosaic definition transaction

Mosaic supply change transaction

• Create a mosaic supply change transaction

Modify multisig account transaction

• Create a modify multisig account transaction

Complex example of

• Aggregate complete transaction

• Aggregate bonded transaction

• Aggregate cosignature transaction

• Lock funds transaction

• Scenario:
  • Seed account sends funds to both Alice and Bob in single aggregate complete transaction
  • Alice prepares and signs aggregate bonded transaction containing two inner transactions - one alice-to-bob and one bob-to-alice
  • Alice prepares and announces lock funds transactions for the above prepared aggregate bonded transaction
  • Alice announces the above prepared aggregate bonded transaction
  • Bob cosigns the aggregate bonded transaction from Alice and announces aggregate cosignature transaction
  • finally, the aggregate bonded transaction gets confirmed

Complex example of

• Secret lock transaction

• Secret proof transaction

• Scenario:
  • precondition: Alice and Bob have a shared secret
  • Alice announces secret lock transaction using a hash of the shared secret (only hash of the secret is visible to the network)
  • Bob announces secret proof transaction using the same shared secret (secret is revealed, Bob proves he knows the same secret as Alice)

Websocket

• Subscribe a block channel
• Subscribe a confirmedAdded channel
• Subscribe a unconfirmedAdded channel
• Subscribe a unconfirmedRemoved channel
• Subscribe a partialAdded channel
• Subscribe a partialRemoved channel
• Subscribe a cosignature channel
• Subscribe a status channel