Architecture
DobProtocol is a set of user-facing products that share a common backend, a set of public APIs and SDKs, and smart contracts deployed across multiple blockchains. This page describes how the pieces connect at the level you need to integrate with the platform — without leaking internal implementation choices.
System Overview
+===========================================================================+
| USER LAYER |
| |
| +-------------+ +-------------+ +-----------+ +----------+ |
| | DobValidator| |Token Studio | | DobDex | | DobLink | |
| | (Verify) | |(Tokenize & | | (LP-priced| | (Embed) | |
| | | | Distribute) | | exits) | | | |
| +------+------+ +------+------+ +-----+-----+ +----+-----+ |
| | | | | |
+=========|================|===============|==============|=================+
| | | |
+=========|================|===============|==============|=================+
| v v v v PUBLIC API |
| |
| REST API (auth, pools, marketplace, agent endpoints) |
| |
| JavaScript / TypeScript SDK (@dobprotocol/sdk) |
| |
+===========================================================================+
|
+=================================|==========================================+
| v BLOCKCHAIN LAYER |
| |
| +-------------------+ +----------------------------------+ |
| | Stellar Soroban | | EVM Chains | |
| | | | | |
| | - Splitter v1/v2 | | - DobValidator (TRUFA registry) | |
| | - Crowdfunding v1 | | - DobDex hook + registries | |
| | - Validator | | - Pooled LN vault | |
| | - Exit Liquidity | | - Cross-chain oracle sync | |
| +-------------------+ +----------------------------------+ |
+============================================================================+
Core Pipeline
The four products form a sequential pipeline for tokenizing and trading a real-world asset:
1. VERIFY 2. TOKENIZE 3. DISTRIBUTE 4. TRADE
+-----------+ +-------------+ +--------------+ +-----------+
| | | | | | | |
| Dob | --> | Token | --> | Distribution | --> | DobDex / |
| Validator | | Studio | | Engine | | Market |
| | | | | | | |
+-----------+ +-------------+ +--------------+ +-----------+
TRUFA AI Pools & Push (V1) / LP-priced
Scoring Shares Pull (V2) exits + Resale
Each stage produces on-chain artifacts that the next stage consumes:
| Stage | Input | Output |
|---|---|---|
| Verify | Project metadata bundle | On-chain TRUFA verification + certificate |
| Tokenize | Verified project + pool configuration | Pool contract with share ledger |
| Distribute | Revenue deposit | Distribution round (claimable by shareholders) |
| Trade | Share ownership | Marketplace listing or DobDex exit through a Liquidity Node |
How to integrate
You don't need to know the internal database or the backend services to build on DobProtocol. There are three public surfaces:
1. The REST / Agent API
A documented REST API authenticated with API keys. Use it to discover pools, prepare and submit trades, manage portfolios, and listen to webhooks. See Agent API Reference.
2. The JavaScript / TypeScript SDK
@dobprotocol/sdk (npm) wraps the API and adds widget management, pool helpers, and typed responses. Useful for partner sites embedding DobLink, or any web app that needs typed access. See DobLink Overview and SDK Reference.
3. The on-chain contracts
Deployed smart contracts on Stellar Soroban and EVM networks. You can interact with them directly from any client (ethers, viem, Stellar SDK, etc.) using the published ABIs. See Smart Contracts Overview.
Blockchain Layer
DobProtocol is multi-chain by design. Pools live on Stellar Soroban; the DEX, validator registry, and cross-chain oracle live on EVM chains.
Stellar Soroban
Primary chain for distribution pools. Anyone can read pool state directly from Soroban RPC.
| Component | Purpose |
|---|---|
| Splitter v1 | Push-based distribution — admin loops shareholders |
| Splitter v2 | Pull-based lazy claims — scales to many shareholders |
| Crowdfunding v1 | Initial pool funding rounds |
| Validator | On-chain mirror of TRUFA approvals |
| Exit Liquidity | Optional buy-back program for early exit |
EVM Chains
Used for the DobValidator registry, the DobDex custom-accounting hook, and cross-chain oracle synchronisation.
| Component | Purpose |
|---|---|
DOBValidator | TRUFA verification registry (on-chain truth source) |
DobPegHook + DobValidatorRegistry | Custom-accounting DEX, oracle-priced buys, LP-priced exits |
DobLPRegistry + DobPooledLN | Liquidity-node positions and the shared LN vault |
OracleAlertReceiver + ReactiveOracleSync | Cross-chain oracle propagation via Reactive Network |
For RPCs, chain IDs, and passphrases per network, see Supported Networks.
Where each product lives
| Product | URL |
|---|---|
| Token Studio | home.dobprotocol.com |
| DobValidator | validator.dobprotocol.com |
| DobDex | dex.dobprotocol.com |
| Documentation | docs.dobprotocol.com |
| Marketing site | www.dobprotocol.com |
What's deliberately not on this page
This page intentionally omits the names of internal frameworks, ORMs, database tables, deployment infrastructure, and internal sync scripts. They are implementation details that may change without notice. Build against the public API, the SDK, and the on-chain contract ABIs — those are the stable surfaces we maintain for integrators.