Skip to main content

Supported Networks

DobProtocol operates across Stellar Soroban and multiple EVM-compatible chains. This page lists every supported network, its configuration, and which products are available on each.

Network Reference

Production Networks

NetworkChain IDTypeExplorer
Stellar Mainnet10Sorobanstellar.expert
Ethereum Mainnet1EVMetherscan.io
Base Mainnet8453EVM (L2)basescan.org
Polygon Mainnet137EVMpolygonscan.com

Test Networks

NetworkChain IDTypeExplorer
Stellar Testnet9Sorobanstellar.expert (testnet)
Sepolia11155111EVMsepolia.etherscan.io
Base Sepolia84532EVM (L2)sepolia.basescan.org
Arbitrum Sepolia421614EVM (L2)sepolia.arbiscan.io

RPC Endpoints

Stellar

NetworkRPC EndpointHorizon Endpoint
Mainnethttps://soroban.stellar.orghttps://horizon.stellar.org
Testnethttps://soroban-testnet.stellar.orghttps://horizon-testnet.stellar.org

Network Passphrases:

Mainnet: "Public Global Stellar Network ; September 2015"
Testnet: "Test SDF Network ; September 2015"

EVM Chains

EVM RPC endpoints are configured per network in the networks database table. Default public endpoints:

NetworkChain IDPublic RPC
Ethereum Mainnet1Via MetaMask default / Infura / Alchemy
Sepolia11155111https://rpc.sepolia.org
Base Mainnet8453https://mainnet.base.org
Base Sepolia84532https://sepolia.base.org
Polygon Mainnet137https://polygon-rpc.com
Arbitrum Sepolia421614https://sepolia-rollup.arbitrum.io/rpc

Product Availability by Network

Not every product is available on every network. The following table shows current availability:

ProductStellar MainnetStellar TestnetEthereumBasePolygonArbitrum
Token Studio (Pools)YesYesYesYesYes--
MarketplaceYesYes--------
Distributions (V1)YesYesYesYesYes--
Distributions (V2)YesYes--------
DobValidator----YesYes--Yes
DobDex----YesYes----
DobLinkYesYesYesYes----
info

Stellar Soroban is the primary chain for pool operations, including V2 lazy-claim distributions and the secondary share marketplace. EVM chains support pool creation and V1 distributions, with V2 and marketplace support planned.

Chain ID Usage in the Codebase

The chain_id field appears throughout the database and API to identify which network a pool, event, or transaction belongs to. When querying or creating resources, always include the appropriate chain ID.

Database Examples

-- Find all active pools on Stellar Mainnet
SELECT * FROM pools WHERE chain_id = '10' AND deleted IS NOT TRUE;

-- Find marketplace listings on Stellar Testnet
SELECT * FROM dob_buy_sales WHERE chain_id = '9' AND is_active = true;

-- Find events for a specific pool on Ethereum
SELECT * FROM "eventRecords" WHERE pool_id = '0x...' AND chain_id = '1';

API Examples

# Query pools on Stellar Mainnet
GET /api/pool?network_id=10

# Query marketplace on Stellar Testnet
GET /api/marketplace?network_id=9

# Frontend URL with network parameter
https://home.dobprotocol.com/marketplace/pool/{address}?network_id=10

Network Configuration Table

The networks database table stores per-network configuration:

ColumnPurpose
idChain ID (primary key)
nameHuman-readable network name
rpc_urlPrimary RPC endpoint
horizon_urlStellar Horizon endpoint (Stellar networks only)
explorer_urlBlock explorer base URL
stellar_pool_wasm_hash_v1Deployed V1 pool contract WASM hash (Stellar only)
stellar_pool_wasm_hash_v2Deployed V2 pool contract WASM hash (Stellar only)
contract_addressesJSON object with deployed contract addresses
is_testnetBoolean flag for test networks
is_activeWhether the network is currently enabled

Wallet Support

Network TypeSupported Wallets
StellarFreighter
EVMMetaMask, WalletConnect-compatible wallets

Connecting to the Right Network

Token Studio automatically detects the connected wallet's network. For Stellar pools, users must have the Freighter browser extension installed. For EVM pools, MetaMask (or a compatible wallet) must be connected to the correct chain.

If a user's wallet is on the wrong network, the frontend prompts them to switch. For EVM chains, the application can request an automatic network switch through the wallet provider.

Adding a New Network

To add support for a new EVM network:

  1. Insert a row into the networks table with the chain configuration
  2. Deploy the required smart contracts to the new chain
  3. Update the frontend network switcher to include the new option
  4. Configure RPC endpoints and explorer URLs
  5. Test pool creation, distribution, and marketplace on the new chain

For Stellar networks, the process also requires uploading the pool contract WASM and storing the hash in the networks table.