Skip to main content

Initializing Your Account

onboarding architecture

Overview: This document details the technical workflow for user onboarding in our system, utilizing backend services and blockchain technology to ensure a secure and transparent process. The sequence involves creating agents and escrows, integral components for user interactions within the platform. This onboarding is necessary only once, when a new user joins the system.


  • User Interface (UI)
  • Backend
    • Agent Factory
    • Agent
  • Blockchain
    • Escrow Factory
    • Escrow
    • Escrow Map
    • Agent Map


  1. Agent Creation Request: The user begins the process by submitting an agent creation request via the User Interface (UI). Currently, this happens when the user places their first trade.
  2. Agent Creation (Backend): The Backend's Agent Factory receives the request and generates a new Agent entity. A new Agent is created in the backend system.
  3. Agent Created Notification (Backend to UI): The Backend sends a confirmation notification to the UI, informing the user of the successful creation of the Agent. The user receives confirmation of Agent creation.
  4. Agent Mapping on Blockchain: The user maps the newly created Agent on the blockchain by updating the Agent Map smart contract. The Agent is recorded on the blockchain for transparency and discoverability.
  5. Agent Mapped Notification: The blockchain sends a notification back to the User, confirming that the Agent has been successfully mapped. The user receives confirmation of the mapping.
  6. Escrow Creation Request: The user then requests the creation of an Escrow, following the successful creation and mapping of the Agent.
  7. Escrow Creation (Blockchain): The user calls the Escrow Factory on the blockchain to create a new Escrow entity. A new Escrow is created on the blockchain.
  8. Escrow Created Notification: The blockchain sends a notification back to the user, confirming the successful creation of the Escrow. The User receives confirmation of the escrow creation.

Beyond: Once this process is done, user can lock funds in his escrow which in turn means placing of trade.

Note: This architecture is subject to change as the architecture evolves. Ensure that it is regularly updated to reflect the most current state of the system's architecture.