fbda1b4beb
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>
58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# 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](TEZOS_TOKEN_REGISTRY.md)
|
|
|
|
---
|
|
|
|
## API
|
|
|
|
`POST /v1/routes/chain138-to-usdtz` — Returns RoutePlan[] for Chain138 asset → Tezos USDtz.
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- [TEZOS_TOKEN_REGISTRY.md](TEZOS_TOKEN_REGISTRY.md)
|
|
- [CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md](CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md)
|