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)
|