Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
1.8 KiB
1.8 KiB
Tezos USDtz Integration — Chain138 to Tezos Routing
Last Updated: 2026-02-01
Document Version: 1.0
Status: Active Documentation
Mission
Enable deterministic conversion of ChainID 138 assets into Tezos-native USDtz via a route-planned swap/bridge orchestration engine with full auditability.
Default Strategy
Prefer mint/burn corridors when available; otherwise stablecoin relay to Tezos (CCIP/AlltraAdapter source→1, then ETH→Tezos bridge, then Tezos DEX to USDtz); custodial/wrapped bridges are optional and feature-flagged.
Supported Source Chains
| Chain | ID | Bridge to ETH |
|---|---|---|
| Chain138 | 138 | CCIP |
| ALL Mainnet | 651940 | AlltraAdapter |
Route Classes
| Class | Description | Feasibility |
|---|---|---|
| A — Canonical OFT | 138 → hub with USDtz corridor → mint to Tezos | Add when corridor confirmed |
| B — Stablecoin relay | 138 swap → CCIP to ETH → ETH→Tezos bridge → Tezos DEX to USDtz | Phase 1 MVP |
| C — Wrapped/escrow | Same as B with custodial bridge | Feature-flagged |
Key Components
- Chain Metadata: multi-chain-execution
src/chain-adapters/config.ts— Tezos chainId 1729 - Tezos Address Validation: dbis_core
src/shared/utils/tezos-address.ts - Bridge Capability Matrix: dbis_core
src/core/defi/tezos-usdtz/bridge-capability-matrix.ts - Route Planner: dbis_core
src/core/defi/tezos-usdtz/route-planner.service.ts - Tezos Token Registry: TEZOS_TOKEN_REGISTRY.md
API
POST /v1/routes/chain138-to-usdtz — Returns RoutePlan[] for Chain138 asset → Tezos USDtz.