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