Devin becba35854 docs: Chain 138 alignment audit + deprecate stale token-addresses master
- Add CHAIN138_ALIGNMENT_AUDIT_2026-04-18.md: drift report covering 67 unique
  Chain-138 addresses from 7 canonical sources, cross-checked against on-chain
  state at https://rpc-core.d-bis.org (chainId 0x8a / 138).
- Add docs/data/chain138-alignment.json: structured findings for downstream tooling.
- Banner CHAIN138_TOKEN_ADDRESSES.md as DEPRECATED (only 5 of 15+ tokens, 0 of 43
  infrastructure contracts).

Findings highlights:
- 64 of 67 referenced addresses are live on-chain; 3 ghosts (in allowlist only).
- 61 deployed contracts are missing from CHAIN138_TOKEN_ADDRESSES.md.
- WETH9 genesis slot (0xC02aaA39...Cc2) is a non-ERC20 shim (decimals=0); real
  WETH9 is at 0x3304b747...E6 per smom/docs/ADDRESS_MAPPING.md.
- WETH10 at canonical 0xf4BB2e28...A9F works (18 decimals, 'Wrapped Ether v10').
- 15 compliant fiat/metal tokens (cEURC, cGBPC, cAUDC, cJPYC, cCHFC, cCADC,
  cXAUC, cXAUT, cEURT, cGBPT, plus non-compliant-wrapper USDT/USDC) all live on-chain,
  all absent from CHAIN138_TOKEN_ADDRESSES.md.

Recommended follow-ups listed in the audit doc.
2026-04-18 23:49:35 +00:00

Ledger Chain 138 Integration — Generated Code for All 8 Steps

Purpose: Drop-in or reference code for integrating Defi Oracle Meta Mainnet (Chain ID 138) with Ledger Wallet. Use after Ledger has accepted the integration request.

Reference: LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE.md | ADD_CHAIN138_TO_LEDGER_LIVE.md | DEFI_ORACLE_META_MAINNET_PROJECT_DESCRIPTION.md


Layout

Step Path Description
1 step-01-currency/ Cryptoassets currency entry for ledger-live
2 step-02-device-app-lib/ App-ethereum network entry (patch/snippet)
3 step-03-coin-module/ Coin-module skeleton (Ethereum family extension)
4 step-04-signer/ Signer types and getAddress resolver
5 step-05-api/ RPC/explorer config and network module
6 step-06-lld-llm/ live-common setup and config
7 step-07-wallet-api/ Wallet API family (validation, types, serializer)
8 step-08-manual-tests/ Manual test plan and checklist script

Additional files:

Path Description
chains/eip155-138.json Chain spec for ChainList / Ledger chains registry
app-ethereum/makefile_conf/chain/defi_oracle.mk Device app (nanos) build config for Chain 138
docs/ Full integration guide, project description, and Ledger form instructions

Gaps and missing integrations

See GAPS_AND_MISSING_INTEGRATIONS.md for test results, fixes applied (e.g. Step 3 Blockscout v2 API), and a checklist of possible missing pieces (tokens/CAL, swap, staking, Clear Signing, i18n, E2E tests, etc.).

Usage

  1. Submit the Ledger form and wait for approval.
  2. Fork/clone LedgerHQ/ledger-live and optionally LedgerHQ/wallet-api.
  3. Copy or adapt the files from each step into the Ledger repos as instructed in the step README or comments.
  4. Run Step 8 manual tests before submitting to Ledger.
Description
No description provided
Readme 74 KiB
Languages
TypeScript 93.9%
C 3.1%
Shell 2.5%
Makefile 0.5%