Integration Use Cases

This section contains a collection of API integration use cases. Each use case describes a sequence of steps and the corresponding API requests used in those steps.

Use Case 1: Token Migration

To migrate tokens from Ethereum (INS) to Insolar (XNS):

  1. Get a new seed (node.getSeed).

  2. Create a wallet (member.migraionCreate with the seed) by providing a public key.

  3. Receive:

    • member’s reference — address in the Insolar network;

    • migration address — a special Ethereum address to transfer INS tokens to.

  4. Transfer INS tokens to the migration address in the Ethereum network.

    Insolar monitors all transactions to migration addresses and transfers the equivalent amount of the XNS tokens to a member’s deposit. All the newly created deposits initially have are ‘locked’ for a predefined period of time. Once they are unlocked, the tokens can be transferred from the deposits to accounts.

    The deposits can

  5. Monitor the deposit status via Web Wallet or the /api/member/{reference} endpoint of the observer node.

  6. Once the XNS tokens are available for transfer from the deposit, transfer them to the member’s account.