Files

Deploy to Phoenix / deploy (push) Has been cancelled

Details

chore: update submodule references and documentation

- Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes.
- Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions.
- Enhanced the README and various index files to provide clearer navigation and task completion guidance.

Made-with: Cursor

2026-03-04 02:03:08 -08:00

3.2 KiB

Raw Blame History

thirdweb Engine — Custom Chain Overrides

Purpose: Document chain overrides for thirdweb Engine so it can resolve RPC and metadata for Chain 138 and ALL Mainnet (651940). Required for AA (account abstraction), paymaster, and backend wallet flows on these chains.

Reference: Custom Chains | thirdweb Engine.

Why override

Engine needs to know RPC URLs and chain metadata for every chain your app uses. Public chain lists may not include 138 or 651940; adding overrides prevents "unknown chain" errors and keeps AA + paymaster stable.

Chain override shape

Per chain, configure at least:

Field	Type	Description
`chainId`	number	138 or 651940
`rpc`	string[]	Primary RPC first; fallback URLs optional
`nativeCurrency`	object	`{ name, symbol, decimals }`
`blockExplorers`	array	`[{ name, url }]` (optional but recommended)
`name`	string	Human-readable name
`slug`	string	Optional; used in logs/APIs

Chain 138 (DeFi Oracle Meta Mainnet)

{
  "chainId": 138,
  "name": "DeFi Oracle Meta Mainnet",
  "slug": "chain-138",
  "rpc": [
    "https://rpc-http-pub.d-bis.org",
    "https://rpc.d-bis.org",
    "https://rpc.defi-oracle.io"
  ],
  "nativeCurrency": {
    "name": "Ether",
    "symbol": "ETH",
    "decimals": 18
  },
  "blockExplorers": [
    {
      "name": "Explorer",
      "url": "https://explorer.d-bis.org"
    }
  ]
}

Admin/deployment RPC: Set via RPC_URL_138 (e.g. http://192.168.11.211:8545) when running from LAN; use public RPC in Engine for external clients.

Chain 651940 (ALL Mainnet / Alltra)

{
  "chainId": 651940,
  "name": "ALL Mainnet",
  "slug": "alltra",
  "rpc": [
    "https://mainnet-rpc.alltra.global"
  ],
  "nativeCurrency": {
    "name": "Ether",
    "symbol": "ETH",
    "decimals": 18
  },
  "blockExplorers": [
    {
      "name": "Alltra",
      "url": "https://alltra.global"
    }
  ]
}

Usage: Alltra-native sponsorship and x402 USDC payments use this chain. Add fallback RPC in rpc[] if Alltra provides one.

Where to configure

Engine dashboard: Add custom chains in the Engine project settings (Custom Chains / Chain Overrides).
Config file: If your Engine deployment uses a config file, add the above objects to the chain overrides section per Engine Custom Chains docs.

Checklist

Add chain 138 with production RPC (and fallback if available).
Add chain 651940 with production RPC so paymaster and backend wallets work on Alltra.
Ensure nativeCurrency and blockExplorers are set so fee display and explorer links work.

Single source of truth

RPC and explorer URLs are aligned with:

smom-dbis-138/services/token-aggregation/src/config/chains.ts — CHAIN_CONFIGS[138], CHAIN_CONFIGS[651940]
metamask-integration/provider/config/DUAL_CHAIN_NETWORKS.json

Update this doc if you add new RPC endpoints or explorers.

3.2 KiB Raw Blame History