Last updated

๐Ÿงต Create and Register a Valid Investor Account

Welcome to the complete guide for the "Create and Register a Valid Investor Account" workflow for the Token City Blockchain API.

This workflow enables you to create a custodian account for an investor, generate and register an on-chain identity, and add the necessary verifications, ensuring their proper integration into the investment platform.

๐ŸŒŸ Objective: Secure and automated onboarding of investors into the Token City ecosystem.


๐Ÿ“š OpenAPI Documentation


โœจ Workflow Summary

This workflow automates the process of creating a valid investor on Token City and blockchain:

  1. ๐Ÿ”น Create a custodian account in Venly / Onyze.
  2. ๐Ÿ”น Create an on-chain identity.
  3. ๐Ÿ”น Register that identity.
  4. ๐Ÿ”น Add individual verifications (claims).

๐Ÿ“‹ Workflow Steps Table

StepAPI OperationMethodParametersOutputsDescription
Add Custodian AccountPOST /accounts-accountDetailsaccountIdCreates the investor's account in Venly custodian
Create On-Chain IdentityPOST /on-chain-identity-accountIdonChainIdCreates an on-chain identity linked to the account
Register On-Chain IdentityPOST /on-chain-identity/{identityAddress}/register-identityAddress, accountAddress-Registers the newly created on-chain identity
Add Individual ClaimsPOST /on-chain-identity/{identityAddress}/claims-identityAddress, claimData-Adds verified claims to the identity profile

๐ŸŽจ Workflow Visualizations

๐ŸŒŠ Mermaid Sequence Diagram

ClientAPIPOST /accounts (Create custodian account)accountIdPOST /on-chain-identityonChainId CreatedPOST /on-chain-identity/{identityAddress}/registerSuccessPOST /on-chain-identity/{identityAddress}/claimsClaimAddedClientAPI