🧵 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:
- 🔹 Create a custodian account in Venly / Onyze.
- 🔹 Create an on-chain identity.
- 🔹 Register that identity.
- 🔹 Add individual verifications (claims).
📋 Workflow Steps Table
| Step | API Operation | Method | Parameters | Outputs | Description |
|---|---|---|---|---|---|
| Add Custodian Account | POST /accounts | - | accountDetails | accountId | Creates the investor's account in Venly custodian |
| Create On-Chain Identity | POST /on-chain-identity | - | accountId | onChainId | Creates an on-chain identity linked to the account |
| Register On-Chain Identity | POST /on-chain-identity/{identityAddress}/register | - | identityAddress, accountAddress | - | Registers the newly created on-chain identity |
| Add Individual Claims | POST /on-chain-identity/{identityAddress}/claims | - | identityAddress, claimData | - | Adds verified claims to the identity profile |
🎨 Workflow Visualizations
🌊 Mermaid Sequence Diagram
sequenceDiagram
participant Client
participant API
Client->>API: POST /accounts (Create custodian account)
API-->>Client: accountId
Client->>API: POST /on-chain-identity
API-->>Client: onChainId Created
Client->>API: POST /on-chain-identity/{identityAddress}/register
API-->>Client: Success
Client->>API: POST /on-chain-identity/{identityAddress}/claims
API-->>Client: ClaimAdded