f46bd213ba
- Updated branding from "SolaceScanScout" to "Solace" across various files including deployment scripts, API responses, and documentation. - Changed default base URL for Playwright tests and updated security headers to reflect the new branding. - Enhanced README and API documentation to include new authentication endpoints and product access details. This refactor aligns the project branding and improves clarity in the API documentation.
47 lines
4.2 KiB
Markdown
47 lines
4.2 KiB
Markdown
# MetaMask and Dual-Chain Provider Integration
|
|
|
|
The explorer (SolaceScan) provides add-to-MetaMask and token list discovery for **Chain 138** (DeFi Oracle Meta Mainnet), **Ethereum Mainnet**, and **ALL Mainnet** (651940).
|
|
|
|
## Explorer as discovery source
|
|
|
|
- **Add to MetaMask:** Use the [Wallet](/wallet) page to add Chain 138, Ethereum Mainnet, or ALL Mainnet to your wallet via `wallet_addEthereumChain`.
|
|
- **Token list URL:** The explorer API serves the dual-chain token list at:
|
|
- **Path:** `/api/config/token-list`
|
|
- **Full URL:** `{EXPLORER_API_BASE}/api/config/token-list` (e.g. `https://blockscout.defi-oracle.io/api/config/token-list` if the API is on the same origin).
|
|
Add this URL in MetaMask **Settings → Token lists** so tokens for Chain 138 and Mainnet appear automatically.
|
|
As of April 3, 2026, the public explorer token list exposes `190` entries, including the full Mainnet `cW*` suite.
|
|
- **Networks config:** `/api/config/networks` returns the same chain params (Chain 138 + Ethereum Mainnet) in JSON for programmatic use.
|
|
- **GRU v2 public rollout status:** the explorer also publishes static status surfaces at `/config/GRU_V2_PUBLIC_DEPLOYMENT_STATUS.json` and `/config/GRU_V2_DEPLOYMENT_QUEUE.json`. Together they summarize the public EVM `cW*` mesh, Wave 1 transport posture, the current public-protocol truth for `Uniswap v3`, `Balancer`, `Curve 3`, `DODO PMM`, and `1inch`, and the remaining operator queue by asset/chain/protocol.
|
|
|
|
## Provider and feature parity
|
|
|
|
- **Dual-chain provider:** For dApps that need add/switch chain, token list, and oracle helpers, use the [metamask-integration/provider](../../metamask-integration/provider) package. See [DUAL_CHAIN_PROVIDER_README.md](../../docs/04-configuration/metamask/DUAL_CHAIN_PROVIDER_README.md).
|
|
- **Feature parity (Swaps, Bridge, pricing):** MetaMask does not natively support Chain 138 for Swaps or Portfolio Bridge. For gaps and build/integration options (custom Snap, token-aggregation API, discovery via token list and liquidity pools), see [METAMASK_CHAIN138_FEATURE_PARITY_ANALYSIS.md](../../docs/04-configuration/metamask/METAMASK_CHAIN138_FEATURE_PARITY_ANALYSIS.md).
|
|
|
|
## Discovery without CMC/CoinGecko
|
|
|
|
Discovery is via **token list** (hosted at the explorer token list URL above), **liquidity pools** (token-aggregation service), and **pricing APIs** (token-aggregation REST API and on-chain oracles). See the feature parity doc for details.
|
|
|
|
**Token-aggregation REST API:** For tokens, pools, prices, volume, and OHLCV (Chain 138 and ALL Mainnet), see [smom-dbis-138/services/token-aggregation/docs/REST_API_REFERENCE.md](../../smom-dbis-138/services/token-aggregation/docs/REST_API_REFERENCE.md).
|
|
|
|
## Optional next steps
|
|
|
|
- **Custom MetaMask Snap:** For in-wallet swap quotes, bridge routes, and pricing on Chain 138, see [SNAP_IMPLEMENTATION_ROADMAP.md](../../docs/04-configuration/metamask/SNAP_IMPLEMENTATION_ROADMAP.md).
|
|
- **Feature parity and optional actions:** [METAMASK_CHAIN138_FEATURE_PARITY_ANALYSIS.md](../../docs/04-configuration/metamask/METAMASK_CHAIN138_FEATURE_PARITY_ANALYSIS.md) — Section 7 lists optional next steps (Snap, CoinGecko, Consensys outreach, market data API).
|
|
|
|
## Live explorer (https://blockscout.defi-oracle.io)
|
|
|
|
- **Wallet page:** https://blockscout.defi-oracle.io/wallet
|
|
- **Token list URL:** https://blockscout.defi-oracle.io/api/config/token-list
|
|
- **Networks config:** https://blockscout.defi-oracle.io/api/config/networks
|
|
- **GRU v2 public rollout status:** https://blockscout.defi-oracle.io/config/GRU_V2_PUBLIC_DEPLOYMENT_STATUS.json
|
|
- **GRU v2 deployment queue:** https://blockscout.defi-oracle.io/config/GRU_V2_DEPLOYMENT_QUEUE.json
|
|
|
|
For backend deployment and integration tests, see [EXPLORER_D_BIS_ORG_INTEGRATION.md](../../docs/04-configuration/metamask/EXPLORER_D_BIS_ORG_INTEGRATION.md).
|
|
For token-list publishing, use `explorer-monorepo/scripts/deploy-explorer-config-to-vmid5000.sh`; it now falls back through the Proxmox host automatically when local `pct` is not installed.
|
|
|
|
## Related
|
|
|
|
- [CHAINLIST_AND_METAMASK_DATA_FLOW.md](CHAINLIST_AND_METAMASK_DATA_FLOW.md) — Chainlist, MetaMask, and token list data flow.
|
|
- [Token list submission links](TOKEN_LIST_SUBMISSION_LINKS.md) — Uniswap token-lists and aggregators.
|