Swap cross-chain TON vers Ethereum : comment ça marche

Imaginez : votre agent IA détient de l'USDT sur TON, et l'utilisateur lui demande « convertis-moi ça en ETH sur Ethereum ». Le chemin classique : envoyer les fonds sur un exchange centralisé, attendre qu'ils soient crédités, échanger à la main, retirer vers le bon réseau. Un agent ne sait pas faire ça : il n'a pas de compte sur l'exchange, pas de KYC, et surtout — à chaque étape, quelqu'un d'autre détient vos fonds. Qu'un seul maillon se grippe, et l'actif reste coincé entre deux réseaux sans aucune garantie de retour.

La réponse habituelle de l'industrie, c'est un bridge avec un intermédiaire à qui vous confiez vos fonds « le temps de l'opération ». Ce sont précisément ces bridges qui se font pirater pour des centaines de millions. Pour un agent autonome, c'est inacceptable : il lui faut un échange où soit la transaction s'exécute intégralement, soit chacun récupère ses fonds — sans tiers de confiance. C'est exactement ce que résout le swap cross-chain de TON vers Ethereum via un escrow HTLC atomique. Voyons comment il fonctionne de l'intérieur, sur les vrais outils du serveur MCP TONNode — sans garde des fonds et sans magie.

Qu'est-ce qu'un swap cross-chain TON → Ethereum et pourquoi il est atomique

Un swap cross-chain, c'est l'échange d'un actif sur un réseau contre un actif sur un autre, sans blockchain commune capable d'enregistrer les deux opérations dans une seule transaction. TON ne peut physiquement pas « voir » une transaction sur Ethereum, et Ethereum pas davantage une transaction sur TON. Pas d'arbitre commun. Le schéma naïf « j'envoie — tu envoies » bute donc sur un problème de confiance : celui qui joue en premier prend tout le risque.

Le mot-clé ici, c'est l'atomicité. Une opération atomique s'exécute entièrement ou pas du tout ; il n'existe pas d'état intermédiaire « à moitié fait ». Appliqué au swap, c'est une garantie en béton : soit les deux jambes s'exécutent et chacun reçoit ce qu'il attendait, soit la transaction est annulée et chacun récupère ses fonds de départ. L'issue « j'ai envoyé, mais je n'ai rien reçu » n'existe tout simplement pas.

On y parvient non pas en faisant confiance à un intermédiaire, mais par la cryptographie et les timeouts — le mécanisme HTLC.

L'escrow HTLC atomique expliqué simplement : hash, secret et timeout

HTLC signifie Hash Time-Locked Contract — un « contrat verrouillé par hash et par le temps ». Ça paraît compliqué, mais l'idée est très terre à terre. Imaginez un coffre bancaire avec deux serrures :

• La serrure par hash. Le coffre ne s'ouvre qu'à celui qui connaît le secret — une longue chaîne aléatoire S. Le coffre ne contient pas le secret lui-même, mais son « empreinte » — le hash H = hash(S). Impossible de reconstituer le secret à partir de l'empreinte, mais quiconque voit le secret peut vérifier instantanément que l'empreinte en provient bien. Les fonds sont bloqués en escrow « sous ce hash ».
• La serrure par le temps (timeout). Si le secret n'a pas été révélé dans le délai imparti, le coffre se déverrouille automatiquement au profit de celui qui l'avait rempli.

Comment cela produit l'atomicité entre deux réseaux :

1. Côté TON, vos GRAM/USDT sont bloqués en escrow sous le hash H.
2. La contrepartie (un market maker), voyant le blocage, réplique l'escrow sur Ethereum sous le même H — elle réserve votre ETH.
3. Pour récupérer l'ETH sur Ethereum, vous révélez le secret S. Mais révéler S le rend public sur la blockchain.
4. La contrepartie voit S et utilise ce même secret pour récupérer vos fonds dans l'escrow TON.

Il n'y a qu'un seul secret pour les deux jambes du swap. Dès qu'il est révélé pour recevoir l'ETH, il déverrouille automatiquement aussi le côté TON. Le révéler pour une jambe sans céder l'autre est impossible. Et si quelque chose tourne mal et que S n'est jamais révélé — à l'expiration du timeout, chaque partie effectue son remboursement. D'où l'« atomicité » : il n'existe pas de troisième issue. Ce schéma n'exige, par construction, aucune confiance envers un serveur intermédiaire.

Le flux complet en cinq outils : quote → build → track → disclose/refund

Dans TONNode, tout l'échange HTLC est découpé en cinq outils. L'ordre des appels reproduit la logique HTLC à l'identique.

1. get_crosschain_quote — la cotation

On commence par connaître les conditions : combien d'ETH (ou d'USDT sur Ethereum) vous recevrez pour vos fonds sur TON, liquidité et frais compris. L'outil renvoie le taux, le montant attendu en sortie et les paramètres de la route. C'est une lecture pure — rien n'est bloqué, rien n'est signé.

2. build_crosschain_swap_tx — la transaction d'escrow HTLC non signée + le secret

C'est ici que naît le swap. L'outil renvoie une transaction non signée qui bloquera vos fonds dans l'escrow HTLC sous le hash du secret, et — séparément — le secret S lui-même. Point critique : le secret vous est remis, il ne reste pas sur le serveur. La transaction est signée par votre wallet via TonConnect, le serveur ne touche jamais à la signature. C'est ce secret que vous révélerez plus tard pour finaliser le swap — et si le swap se bloque, les fonds verrouillés vous reviennent au timeout, sans révélation du secret.

3. track_crosschain_swap — les phases du swap sur les deux réseaux

Une fois la transaction d'escrow signée et envoyée, il faut savoir où en est le swap : vos fonds sont-ils bien bloqués sur TON, l'escrow miroir est-il apparu côté Ethereum, tout est-il prêt pour le règlement ? track_crosschain_swap montre les phases sur les deux réseaux à la fois — c'est votre vue d'ensemble au-dessus des deux blockchains. Appelez-le jusqu'à ce que le swap atteigne l'état « prêt pour la révélation du secret ».

4a. disclose_crosschain_secret — révéler le secret pour le règlement

Quand le tracking a confirmé que la contrepartie est prête et verrouillée on-chain, vous révélez le secret. C'est l'étape finale : la révélation déclenche le règlement — vous récupérez l'ETH, la contrepartie utilise ce même secret pour récupérer vos GRAM/USDT. Important : ne l'appelez qu'après avoir vérifié l'état on-chain via track_crosschain_swap — révéler le secret trop tôt reviendrait à donner la clé avant que la seconde moitié du coffre ne soit remplie.

4b. build_crosschain_refund — récupérer vos fonds si le swap se bloque

Le scénario de secours. Si l'autre jambe ne s'est jamais exécutée — la contrepartie n'a pas répliqué l'escrow, le timeout a expiré — build_crosschain_refund construit une transaction non signée qui récupère vos fonds depuis l'escrow. C'est la fameuse seconde serrure — celle du temps. Le secret n'est pas révélé, les fonds verrouillés vous reviennent. C'est le fusible de sécurité de l'atomicité : un swap bloqué n'engloutit pas votre argent.

Schématiquement, tout le parcours :

get_crosschain_quote      → combien je reçois
build_crosschain_swap_tx  → tx HTLC non signée + secret (le secret est chez vous)
        ↓ (signée dans le wallet, envoyée)
track_crosschain_swap     → phases côté TON et côté Ethereum
   ├─ prêt on-chain    →  disclose_crosschain_secret   → règlement
   └─ bloqué, timeout  →  build_crosschain_refund      → remboursement

Une fois le serveur branché, vous parlez simplement à l'agent en langage naturel — il enchaînera les outils tout seul :

Échange 50 USDT de mon wallet TON contre de l'ETH sur Ethereum.
Montre-moi d'abord la cotation (get_crosschain_quote).
Si le taux me convient, construis l'escrow HTLC (build_crosschain_swap_tx)
et laisse-moi signer. Ensuite suis le swap (track_crosschain_swap)
et, quand les deux côtés sont prêts on-chain, révèle le secret pour le règlement.
Si rien ne bouge avant le timeout, construis le remboursement.

Pourquoi c'est non-custodial : le serveur ne signe rien et ne détient aucune clé

Revenons au problème posé au début. Un bridge classique est dangereux parce que vous placez vos fonds sous le contrôle d'un intermédiaire. TONNode est construit autrement, et c'est sa position de principe : le serveur ne signe JAMAIS et ne détient jamais ni fonds ni clés privées.

Concrètement, pour l'escrow HTLC :

• build_crosschain_swap_tx renvoie une transaction non signée — tant que vous ne l'avez pas signée avec votre wallet via TonConnect, rien n'est bloqué.
• Le secret S est entre vos mains, pas sur le serveur. Sans votre secret, personne ne peut finaliser le règlement en votre nom.
• Le remboursement au timeout (build_crosschain_refund) est lui aussi construit comme une transaction non signée, à signer par vous.
• Même un wallet généré (outil generate_wallet) vous est remis et ne reste pas sur le serveur.

Même si le serveur est indisponible ou compromis, il est physiquement incapable de détourner vos fonds ou de finaliser le swap sans votre signature et votre secret. Autrement dit, le HTLC atomique vous protège de la contrepartie, et l'architecture non-custodiale vous protège du service lui-même. Pour approfondir ce modèle, voyez le comparatif MCP custodial contre non-custodial et l'article sur le swap non-custodial pour les agents sur TON.

Pour comparaison : le @ton/mcp officiel de la TON Foundation est un agent-wallet custodial qui détient une clé operator et signe lui-même, et il ne fonctionne qu'à l'intérieur de TON, sans cross-chain. La différence est honnête : chez eux, des dépenses autonomes au prix de la confiance placée dans une clé ; ici, une architecture non-custodiale et la possibilité de sortir de TON.

Réseaux supportés : Ethereum, Arbitrum, Base, BNB, Polygon, Avalanche

TON est toujours la source du swap, et la destination est l'un des six réseaux EVM :

• Ethereum
• Arbitrum
• Base
• BNB Chain
• Polygon
• Avalanche

La mécanique est identique pour tous — un escrow HTLC atomique. TRON n'est pas encore supporté. Si vous visez un L2 pour ses frais réduits, jetez un œil au guide dédié swap cross-chain TON → Arbitrum — le flux est le même, seul le réseau de destination change. Et pour comprendre à quoi ça sert à un agent et où est la valeur pour TON — l'article sur le premier swap cross-chain et la valeur pour le réseau.

Comment brancher le MCP et lancer votre premier swap cross-chain

TONNode est un serveur MCP hébergé pour TON. MCP (Model Context Protocol) est le standard par lequel les agents IA (Claude, Cursor, ChatGPT/Codex et tout client MCP) appellent des outils. Il y a 16 outils au total, et les 16 sont disponibles sur tous les plans — vous ne payez que pour le débit.

En local, gratuitement

La configuration publique avec l'ensemble complet des outils de lecture s'installe en une commande — npx -y @tonnode/mcp :

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

Ajoutez ceci à la configuration de votre client MCP (Claude Desktop, Cursor, Codex, tout client compatible MCP), et les outils get_crosschain_quote, build_crosschain_swap_tx, track_crosschain_swap, disclose_crosschain_secret, build_crosschain_refund deviennent accessibles à l'agent. Le paquet @tonnode/mcp est open source (MIT), disponible sur npm et GitHub (tonnode/mcp), et parle le protocole natif ADNL de TON, sans couche HTTP intermédiaire.

Hosted — avec votre clé

Pour un débit garanti, branchez l'endpoint hébergé avec votre propre clé :

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

Les plans ne diffèrent que par la limite de requêtes : Hobby — gratuit à vie, 60 requêtes/min ; Pro — 29 $/mois, 300 requêtes/min ; Scale — 199 $/mois, 1200 requêtes/min. Les 16 outils sont les mêmes partout. La clé gratuite Hobby est délivrée dès la connexion, sans carte bancaire. Au passage, côté monnaie : GRAM est le Toncoin renommé (le renommage date de juin 2026), le réseau s'appelle toujours TON, et c'est bien GRAM que vous verrez dans les cotations.

Premier swap en une minute

1. Récupérez votre clé Hobby gratuite — sans carte, délivrée dès la connexion.
2. Renseignez la configuration (locale ou hosted).
3. Donnez à l'agent le prompt de la section ci-dessus et signez la transaction d'escrow avec votre wallet.

En bref

Le cross-chain entre réseaux différents n'a pas à reposer sur la confiance. L'escrow HTLC atomique donne la garantie « tout ou rien », et l'architecture non-custodiale de TONNode veille à ce que ni les fonds, ni les clés, ni le secret ne quittent jamais votre contrôle. Cinq outils — get_crosschain_quote, build_crosschain_swap_tx, track_crosschain_swap, disclose_crosschain_secret, build_crosschain_refund — couvrent tout le cycle de vie du swap, y compris le remboursement de secours.

Vous pouvez le vérifier sur un vrai swap, gratuitement : obtenez une clé Hobby et faites votre premier swap cross-chain — sans carte bancaire, 60 requêtes par minute suffisent largement. Le tour d'horizon des 16 outils est sur la page MCP.