Files
proxmox/docs/11-references/TEZOS_USDTZ_INTEGRATION.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- 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>
2026-02-12 15:46:57 -08:00

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.


References