Swap cross-chain TON → Arbitrum : comment ça marche

Swap cross-chain TON → Arbitrum : de l'argent coincé entre deux réseaux

Scénario classique : votre agent IA détient un solde sur un wallet TON — du GRAM ou de l'USDT — et il doit payer un contrat sur Arbitrum. Là-bas, le gaz est bon marché, la liquidité est là, le protocole dont vous avez besoin aussi. Le chemin habituel ressemble à ceci : retirer vers un exchange, attendre le crédit, acheter de l'ETH, le retirer vers Arbitrum, perdre sur le spread et les frais — le tout à la main, via un service custodial à qui vous confiez vos fonds « le temps que ça passe ». Pour un humain, c'est une demi-heure de manipulations. Pour un agent autonome, c'est un mur : il n'a pas de compte sur un exchange, pas de KYC, et confier sa clé privée au serveur de quelqu'un d'autre est exclu par définition. Et chaque bridge, c'est encore une intégration à part, un point de défaillance supplémentaire, et son lot régulier de gros titres du genre « le bridge a été piraté ».

Le swap cross-chain TON → Arbitrum répond exactement à ce problème : déplacer de la valeur de TON vers un autre réseau en une seule transaction atomique, sans remettre votre clé privée à qui que ce soit. Voici comment c'est construit sous le capot, et comment le brancher à un agent via les cinq outils MCP de TONNode.

Pourquoi swapper de TON vers Arbitrum, et quels autres réseaux sont disponibles

Arbitrum est une destination L2 populaire au-dessus d'Ethereum : frais bas, infrastructure DeFi mature, beaucoup de protocoles absents de TON. Les raisons typiques d'y aller :

• récupérer de l'USDT dans un écosystème où le protocole visé l'accepte ;
• entrer en position sur un DEX natif d'Arbitrum ou un protocole de perps ;
• payer sur le réseau que votre contrepartie prend en charge.

Chez TONNode, le cross-chain prend en charge six réseaux de destination :

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

Une limite importante à garder en tête : TON est toujours la source. Le flux va de TON vers un réseau EVM, jamais l'inverse. Et TRON n'est pas encore pris en charge — si quelqu'un attend de l'USDT-TRC20 en direct, cette route n'existe pas, ne l'intégrez pas dans la logique de votre agent. Arbitrum n'est ici qu'un destinataire parmi six ; tout ce qui suit vaut mot pour mot pour un passage TON → Ethereum ou TON → Base — seul change le réseau de destination dans la cotation.

Qu'est-ce qu'un escrow HTLC et pourquoi le swap est atomique

La grande question de tout échange cross-chain : comment échanger un actif sur le réseau A contre un actif sur le réseau B quand les deux réseaux n'ont pas d'« arbitre » commun ? L'option naïve — faire confiance à un intermédiaire — est précisément le fameux risque custodial.

TONNode utilise un escrow HTLC atomique (Hashed TimeLock Contract — un contrat à verrou par hachage et à minuterie). L'analogie : deux coffres-forts, un sur chaque réseau, qui s'ouvrent tous les deux avec le même secret en guise de clé. Le mécanisme repose sur deux propriétés :

• Le verrou par hachage (hash lock). On génère un secret aléatoire S, dont on dérive le hachage H = hash(S). Les deux coffres — l'escrow sur TON et l'escrow sur Arbitrum — sont verrouillés sur ce hachage, avec la condition « remettre les fonds à quiconque présente S tel que hash(S) == H ». Tant que le secret n'est pas révélé, personne ne touche à rien ; dès que S est présenté d'un côté, il devient visible de l'autre.
• La minuterie (time lock). Chaque coffre a une échéance. Si l'échange n'aboutit pas, les fonds reviennent à leur propriétaire d'origine à l'expiration du timelock.

D'où le mot atomique : soit l'échange passe sur les deux réseaux (secret révélé — les deux escrows exécutés), soit il ne passe nulle part (timelock expiré — deux remboursements). L'état intermédiaire « l'argent a quitté TON mais n'est pas arrivé sur Arbitrum » n'existe tout simplement pas. Ce n'est pas un bridge à pool commun qu'on peut pirater, mais une paire d'escrows indépendants, synchronisés par un seul secret.

Le flux d'un swap cross-chain TON → Arbitrum, étape par étape

Tout l'échange tient en cinq outils, appelés dans l'ordre. Chacun fait exactement une chose.

1. get_crosschain_quote — la cotation

Vous demandez : combien vais-je recevoir sur Arbitrum pour X GRAM (ou pour X USDT sur TON). Vous obtenez une cotation ferme pour la route — taux, frais, paramètres.

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

Le serveur assemble une transaction non signée qui crée l'escrow côté TON, et vous remet le secret S (la fameuse clé des deux coffres). La transaction n'est ni envoyée ni signée — c'est le wallet de l'utilisateur qui la signera via TonConnect. Le secret reste chez vous ; c'est avec lui que vous finaliserez le règlement plus tard.

3. track_crosschain_swap — les phases de l'échange sur les deux réseaux

Une fois l'escrow créé sur TON, la contrepartie dépose l'escrow miroir sur Arbitrum. Cet outil affiche les phases de l'échange sur les deux réseaux : l'escrow source est-il créé, l'escrow de destination est-il apparu, tout est-il prêt pour le règlement. C'est votre détecteur de disponibilité on-chain — vous voyez littéralement les deux coffres.

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

Le moment clé côté sécurité. Le secret n'est révélé qu'après vérification on-chain de la disponibilité de l'escrow — c'est-à-dire une fois que l'outil s'est assuré que le coffre miroir sur Arbitrum existe bel et bien et qu'il est approvisionné sous le bon verrou de hachage. Le sens de cette vérification est direct : tant que l'escrow de la contrepartie n'est pas en place, il ne faut pas révéler le secret — sinon la contrepartie récupère vos fonds sans exécuter sa part. Une fois le secret révélé, chaque partie reçoit son dû.

5. build_crosschain_refund — l'assurance

Si l'échange est bloqué, cet outil assemble la transaction de remboursement des fonds depuis l'escrow à l'expiration du timelock. On y revient dans une section dédiée plus bas.

Le schéma du flux :

get_crosschain_quote      → cotation TON → Arbitrum
build_crosschain_swap_tx  → tx HTLC non signée + secret  (signée par le wallet)
track_crosschain_swap     → phases sur TON et sur Arbitrum
disclose_crosschain_secret→ révéler le secret après vérification on-chain
build_crosschain_refund   → remboursement si l'échange est bloqué

Côté agent, un prompt en langage naturel suffit — il choisira et appellera lui-même les outils dans le bon ordre :

Swappe 50 USDT depuis mon wallet TON vers Arbitrum.
Montre-moi d'abord la cotation via get_crosschain_quote,
assemble la transaction d'escrow HTLC via build_crosschain_swap_tx
et laisse-moi la signer dans mon wallet. Ensuite, suis les phases
sur les deux réseaux et ne révèle le secret que lorsque
l'escrow de destination est prêt on-chain.

À aucune étape l'agent ne vous demande votre clé privée.

Non-custodial : le serveur ne signe rien et ne stocke aucune clé

C'est ce qui distingue fondamentalement cette approche. build_crosschain_swap_tx renvoie un message TonConnect non signé — la signature vient du wallet de l'utilisateur, pas du serveur. Le serveur ne signe jamais rien et ne détient ni fonds ni clés privées.

Concrètement :

• Le secret du HTLC vous est remis à vous dans build_crosschain_swap_tx, il ne reste pas sur le serveur ; sa révélation est un acte délibéré de votre part via disclose_crosschain_secret.
• Les fonds restent en permanence dans des escrows on-chain, pas sur le wallet du fournisseur.
• Même si le serveur voulait « détourner » l'argent, il n'en aurait pas les moyens : pas de clés, une signature qui n'est pas la sienne, et une révélation du secret que vous seul déclenchez.

La même règle vaut pour les autres outils « d'écriture » de TONNode : le swap et generate_wallet sont strictement non-custodiaux. À titre de comparaison, le @ton/mcp officiel de la TON Foundation est construit autrement : c'est un wallet-agent custodial en split-key, où la clé operator est détenue — et utilisée pour signer — par l'agent lui-même. L'approche se défend et a ses atouts (dépense autonome, NFT, DNS, statut officiel), mais elle est custodiale et ne fonctionne qu'à l'intérieur de TON — pas de cross-chain. TONNode fait délibérément le choix inverse : la signature reste toujours côté utilisateur. Pour creuser ce modèle appliqué aux agents, voir pourquoi le swap d'un agent doit être non-custodial.

Que faire si l'échange est bloqué : le remboursement depuis l'escrow

Le cross-chain, ce sont deux réseaux indépendants, et il arrive que la contrepartie n'exécute pas sa part : l'escrow sur Arbitrum n'apparaît pas, ou le règlement reste en suspens. Vos fonds ne sont pas perdus pour autant — ils sont dans votre escrow sur TON, sous timelock.

build_crosschain_refund assemble une transaction de remboursement non signée — elle aussi à signer par votre wallet. À l'expiration du timelock, les fonds quittent l'escrow et reviennent sur votre adresse TON :

L'échange n'est pas passé, l'escrow est bloqué.
Assemble le remboursement via build_crosschain_refund et donne-le-moi à signer.

C'est la seconde moitié de l'« atomicité » : si l'échange n'aboutit pas sur les deux réseaux, il est annulé. Dans le pire des cas, vous perdez un peu de temps et du gaz, mais pas le montant de l'échange. Aucun solde « coincé dans le bridge » qu'il faudrait ensuite réclamer pendant des mois auprès du support.

Règle pratique pour l'agent : si track_crosschain_swap tarde à montrer un escrow de destination prêt alors que le timelock approche de son échéance — ne révélez pas le secret, appelez build_crosschain_refund.

Comment brancher les outils cross-chain à un agent IA

Les cinq outils cross-chain font partie du serveur MCP de TONNode. MCP (Model Context Protocol) est le standard par lequel Claude, Cursor, ChatGPT/Codex et n'importe quel autre client MCP appellent des outils. Le branchement tient en un fichier de config.

En local, gratuitement (config publique, tous les outils de lecture) :

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

Le lancement local gratuit donne le jeu complet des outils de lecture. Les outils cross-chain et de swap (assemblage des transactions — build_crosschain_swap_tx, track_crosschain_swap, disclose_crosschain_secret, build_crosschain_refund) fonctionnent avec une clé hosted — y compris la clé Hobby gratuite (voir la section tarifs plus bas).

Hosted (débit garanti, votre propre clé) :

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

Le paquet @tonnode/mcp est open source (MIT), publié sur npm et GitHub (tonnode/mcp), et parle le protocole natif ADNL de TON, sans couche HTTP intermédiaire.

Deux précisions techniques pour que l'agent ne trébuche pas. GRAM est le nouveau nom de Toncoin (renommage en juin 2026) ; le réseau, lui, s'appelle toujours TON — si l'agent manipule du « GRAM » dans une cotation, c'est bien le même token natif. La clé hosted se paie en GRAM ou en USDT sur le réseau TON via TonConnect, ou en BTC/ETH/SOL et d'autres monnaies via une facture xRocket dans Telegram — la clé est délivrée automatiquement une fois le paiement réglé.

Les tarifs et ce qu'ils incluent

Les 16 outils de TONNode — dont les cinq cross-chain — sont disponibles sur tous les plans. Vous ne payez que le débit, pas le « déblocage » de fonctionnalités :

• Hobby — gratuit à vie, 60 requêtes/min ;
• Pro — 29 $/mois, 300 requêtes/min ;
• Scale — 199 $/mois, 1200 requêtes/min.

La clé Hobby gratuite est délivrée dès la connexion, sans carte bancaire.

En bref

Le swap cross-chain TON → Arbitrum chez TONNode, c'est un escrow HTLC atomique : un seul secret relie deux coffres sur deux réseaux, donc l'échange passe en entier ou est remboursé à l'expiration du timelock. Cinq outils couvrent tout le flux — cotation, assemblage de la transaction HTLC non signée avec son secret, suivi des phases sur les deux réseaux, révélation du secret après vérification on-chain de la disponibilité, et remboursement en cas de blocage — tandis que le serveur, lui, reste non-custodial : il ne signe rien et ne détient ni fonds ni clés. Le même mécanisme sert pour les autres destinations : voir les analyses du swap TON → Ethereum et TON → Base, ainsi que pourquoi le premier transfert de valeur cross-chain depuis TON via MCP est important.

Envie d'essayer sur un agent réel ? Obtenez une clé Hobby gratuite (les 16 outils, cross-chain inclus, 60 requêtes/min, sans carte bancaire) et faites un tour sur la page des outils.