Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.generalmarket.io/llms.txt

Use this file to discover all available pages before exploring further.

Deployed Contract Addresses

The addresses are the protocol. Everything else — the code, the documentation, the diagrams — is explanation. These are the facts on-chain, across two chains.
┌─────────────────────────────────────────────────────────┐
│                  INDEX L3 (Chain 111222333)              │
│                                                         │
│  ┌──────────┐  ┌────────────────┐  ┌─────────────────┐  │
│  │  Index    │  │  Governance    │  │  OracleRegistry │  │
│  └──────────┘  └────────────────┘  └─────────────────┘  │
│  ┌──────────────────┐  ┌───────────────────────────┐    │
│  │ CollateralRegistry│  │  BLSCustody              │    │
│  └──────────────────┘  └───────────────────────────┘    │
│  ┌──────────────────┐  ┌───────────────────────────┐    │
│  │ L3BridgeCustody  │  │  L3BridgeProxy            │    │
│  └──────────────────┘  └───────────────────────────┘    │
│  ┌──────────────────┐  ┌───────────────────────────┐    │
│  │ L3BridgedItpFact.│  │  Vision                   │    │
│  └──────────────────┘  └───────────────────────────┘    │
│  ┌──────────────────┐  ┌───────────────────────────┐    │
│  │  ITP Vault #1    │  │  ITP Vault #2             │    │
│  └──────────────────┘  └───────────────────────────┘    │
│  ┌──────────────────┐                                   │
│  │  L3 WUSDC (18d)  │                                   │
│  └──────────────────┘                                   │
│                          │                              │
│                          │ Bridge                       │
│                          │                              │
├──────────────────────────┼──────────────────────────────┤
│                          │                              │
│              SETTLEMENT (Chain 14601)                   │
│                                                         │
│  ┌──────────────────────────┐  ┌──────────────────────┐ │
│  │ SettlementBridgeProxy    │  │ SettlementBridgeCust.│ │
│  └──────────────────────────┘  └──────────────────────┘ │
│  ┌──────────────────────────┐  ┌──────────────────────┐ │
│  │ SettlementBridgedItpFact.│  │ SettlementOracleReg. │ │
│  └──────────────────────────┘  └──────────────────────┘ │
│  ┌──────────────────────────┐                           │
│  │ Settlement USDC (6d)     │                           │
│  └──────────────────────────┘                           │
└─────────────────────────────────────────────────────────┘
Contract addresses are loaded from deployments/active-deployment.json and may differ between environments (testnet, staging, production). Always verify addresses against the active deployment file before interacting with contracts directly.

Network Information

Index L3

PropertyValue
Chain NameIndex L3 (Arbitrum Orbit)
Chain ID111222333
RPC Endpointhttps://rpc.generalmarket.io/
Collateral TokenWUSDC (18 decimals on L3)
ConsensusArbitrum Orbit with BLS oracle consensus

Settlement

PropertyValue
Chain NameSettlement
Chain ID14601
Collateral TokenUSDC (6 decimals)

L3 Contracts (Chain 111222333)

Core Protocol

ContractAddressDescription
Index0xc405a458b63b5ee8E19eB5C4ECf86fAD41F2E902Main entry point for order management, DTF creation, and NAV computation.
Governance0xE0A07455F9e92FFf3e8DF8EBd64BB68463D3bcECAdministrative controls for pausing, parameter updates, and UUPS upgrades.
OracleRegistry0xB2b2c21Fa066b216a583493aE0e82eb16A37f275Manages oracle node registration and BLS public key storage.
CollateralRegistry0x907eCdB6AD282122893D2Ea0f733421497b693a7Whitelist of accepted collateral tokens for order placement.

Bridge & Custody

ContractAddressDescription
L3BridgeProxy0x45014B4d25df82a99a47926D8EfcabA0427a5EacL3-side bridge proxy for cross-chain order routing.
L3BridgeCustody0xb7a4B6Dc1bB9Cf2b63E74aE06a8aB0a00df0d475Holds escrowed assets on L3 during cross-chain operations.
BLSCustody0x1d7bab069f8D161622B0bd12e6D010C1f05b14cCCustody contract for BLS-verified operations.
L3BridgedItpFactory0x53C5d94c48b1d276cA5dB1f759b5765e3F546efEFactory that deploys ERC-4626 DTF share tokens on L3.

Vision

ContractAddressDescription
Vision0x8aF92d1D6397c0073f47D1f754983A2Da51C06C8Prediction market contract for batch management and player operations.

DTF Vaults

ContractAddressDescription
DTF Vault #10x069c34442E40dD574E90e568710d2fbDAfeEb5dBFirst Dex Traded Fund vault (BridgedITP).
DTF Vault #20x87E53b1A665864a1385Fc080259B0e81DC7f5713Second Dex Traded Fund vault.

Tokens

TokenAddressDecimals
L3 WUSDC0xE24D18004EAAB5E771684679846D6d5EE7a9663c18
Mock USDT0xAC5c355b7cD34572AFE96d82e5AEC91EC4F9367B

Morpho Lending

ContractAddressDescription
Morpho0x2b43723840e5935a4E4b832d18C7c033a1C15074Morpho core lending protocol.
Adaptive IRM0x095e7F85a7569B64cdEA8d4b5F148ff77f371907Interest rate model for the USDC/DTF market.
MirrorOracleRegistry0xB2b2c21Fa066b216a583493aE0e82eb16A37f275Mirror of OracleRegistry used as oracle registry.
DTF NAV Oracle0x172D6F3330CD4c993C4F49341E38f8d551E1c5d3Oracle providing DTF NAV for Morpho liquidation pricing.
MetaMorpho Vault0xB4FF430878a980cf23d06CC31EEE2f26AbD1bbb2Curated vault for USDC lending against DTF collateral.

Settlement Contracts (Chain 14601)

ContractAddressDescription
SettlementBridgeProxy0x8026b02F341248339C65a2c07727a0fB34F8f36fSettlement-side bridge proxy for cross-chain order routing.
SettlementBridgeCustody0x774095bC7E274Bb3e9A42f481Eeb6D636354E937Holds escrowed USDC on Settlement during bridge operations.
SettlementBridgedItpFactory0x86169A8852e99f98d1C3b9412fD01f0f4fE5eE11Factory that deploys DTF share tokens on Settlement.
SettlementOracleRegistry0xe880B2E9c546cBe478C05bcb551AC97B1EC89371Oracle registry mirror on Settlement for BLS verification.

Tokens

TokenAddressDecimals
Settlement USDC0xae7DacD7a5192193f726E94e5BCF3bd37C251DbE6

Retrieving Addresses

From the Deployment File

The deployment JSON is the source of truth. This page is a convenience.
cat deployments/active-deployment.json
Updated by deploy scripts after each deployment.

In the Frontend

import deployment from "@/lib/contracts/deployment.json";

// Access individual contract addresses
const indexAddress = deployment.contracts.Index;
const oracleRegistry = deployment.contracts.OracleRegistry;

Adding to a Wallet

To interact with the Index L3 chain from a wallet like MetaMask:
  1. Open your wallet’s network settings
  2. Add a custom network with the following details:
    • Network Name: Index L3
    • RPC URL: https://rpc.generalmarket.io/
    • Chain ID: 111222333
    • Currency Symbol: ETH

Contract Upgrade Policy

UUPS proxies. The addresses on this page are permanent. Only the implementation behind them changes. The proxy is the identity; the implementation is the behavior.