Swaps cross-chain de TON a Ethereum: cómo funcionan por dentro

Imagina la escena: tu agente de IA tiene USDT en TON y el usuario le pide «pásalo a ETH en Ethereum». La vía habitual sería enviar los fondos a un exchange centralizado, esperar a que acrediten el depósito, cambiarlos a mano y retirarlos a la red de destino. Un agente no puede hacer nada de eso: no tiene cuenta en el exchange, no tiene KYC y, lo más grave, en cada paso alguien más custodia tus fondos. Basta con que un eslabón se atasque para que el activo quede atrapado entre redes sin garantía de retorno.

La respuesta clásica de la industria es un puente con un intermediario al que le entregas el dinero «para que lo guarde un rato». Justo esos puentes son los que hackean por cientos de millones. Para un agente autónomo eso es inaceptable: necesita un intercambio donde o bien la operación se ejecuta completa, o bien cada parte recupera sus fondos, sin intermediario de confianza. Eso es exactamente lo que resuelve el swap cross-chain de TON a Ethereum mediante un escrow HTLC atómico. A continuación vemos cómo funciona por dentro, con las herramientas reales del servidor MCP de TONNode — sin custodia y sin magia.

Qué es un swap cross-chain TON → Ethereum y por qué es atómico

Un swap cross-chain es el intercambio de un activo en una red por un activo en otra sin una blockchain común que pueda registrar ambas operaciones en una sola transacción. TON físicamente no puede «ver» una transacción de Ethereum, ni Ethereum una de TON. No hay árbitro común. Por eso el esquema ingenuo de «yo envío — tú envías» choca con el problema de la confianza: quien mueve primero, asume el riesgo.

La palabra clave aquí es atomicidad. Una operación atómica o se ejecuta por completo o no se ejecuta en absoluto; el «a medias» no existe. Aplicado al swap, es una garantía férrea: o se ejecutan ambas patas y cada uno recibe lo que esperaba, o la operación se revierte y cada uno recupera sus fondos originales. El estado «yo entregué y a mí no me llegó» simplemente no existe como desenlace.

Y esto no se consigue confiando en un intermediario, sino con criptografía y timeouts: el mecanismo HTLC.

El escrow HTLC atómico en palabras simples: hash, secreto y timeout

HTLC son las siglas de Hash Time-Locked Contract: un contrato bloqueado por hash y por tiempo. Suena complejo, pero la idea es de lo más cotidiana. Imagina una caja de seguridad con dos cerraduras:

• Cerradura por hash. La caja solo se abre para quien conoce el secreto: una cadena larga y aleatoria S. Dentro de la caja no está el secreto, sino su «huella»: el hash H = hash(S). A partir de la huella no se puede reconstruir el secreto, pero cualquiera que vea el secreto puede comprobar al instante que la huella le corresponde. Los fondos se bloquean en el escrow «bajo ese hash».
• Cerradura por tiempo (timeout). Si en el plazo previsto nadie revela el secreto, la caja se desbloquea automáticamente a favor de quien la llenó.

Así es como se consigue la atomicidad al enlazar dos redes:

1. En el lado de TON, tus GRAM/USDT se bloquean en un escrow bajo el hash H.
2. La contraparte (un market maker), al ver el bloqueo, replica el escrow en Ethereum bajo el mismo H: reserva tu ETH.
3. Para cobrar el ETH en Ethereum, revelas el secreto S. Pero revelar S lo vuelve público en la blockchain.
4. La contraparte ve S y con ese mismo secreto retira tus fondos del escrow de TON.

El secreto es uno solo para las dos patas de la operación. En cuanto se revela para cobrar el ETH, desbloquea automáticamente también el lado de TON. Revelarlo para una pata sin entregar la otra es imposible. Y si algo sale mal y S nunca se revela, al expirar el timeout ambas partes ejecutan la devolución. De ahí la «atomicidad»: no hay tercer desenlace. Por construcción, este esquema no exige confiar en ningún servidor intermediario.

El flujo completo con cinco herramientas: quote → build → track → disclose/refund

En TONNode todo el intercambio HTLC está repartido en cinco herramientas. El orden de las llamadas calca la lógica del HTLC paso a paso.

1. get_crosschain_quote — la cotización

Lo primero es conocer las condiciones: cuánto ETH (o USDT en Ethereum) recibirás por tus fondos en TON, teniendo en cuenta la liquidez y las comisiones. Devuelve el tipo de cambio, el importe esperado a la salida y los parámetros de la ruta. Es una lectura: no bloquea ni firma nada.

2. build_crosschain_swap_tx — transacción HTLC de escrow sin firmar + el secreto

Aquí nace la operación. La herramienta devuelve una transacción sin firmar que bloqueará tus fondos en el escrow HTLC bajo el hash del secreto y, por separado, el propio secreto S. Punto crítico: el secreto te llega a ti, no se queda en el servidor. La transacción la firma tu wallet vía TonConnect; el servidor no toca la firma. Ese mismo secreto es el que revelarás más adelante para cerrar la operación — y si la operación se atasca, lo bloqueado vuelve a ti al vencer el timeout, sin llegar a revelar el secreto.

3. track_crosschain_swap — las fases de la operación en ambas redes

Una vez firmada y enviada la transacción de escrow, necesitas saber en qué punto está la operación: si tus fondos ya quedaron bloqueados en TON, si apareció el escrow espejo del lado de Ethereum, si todo está listo para la liquidación. track_crosschain_swap muestra las fases en ambas redes a la vez: es tu vista unificada por encima de las dos blockchains. Lo llamas hasta que la operación llegue al estado «listo para revelar el secreto».

4a. disclose_crosschain_secret — revelar el secreto para liquidar

Cuando el tracking confirma que la contraparte está lista y bloqueada on-chain, revelas el secreto. Es el paso final: la revelación dispara la liquidación — tú cobras el ETH y la contraparte, con ese mismo secreto, retira tus GRAM/USDT. Es importante llamarlo solo tras comprobar on-chain que todo está listo vía track_crosschain_swap: revelar el secreto antes de tiempo sería entregar la llave antes de que la otra mitad de la caja esté llena.

4b. build_crosschain_refund — recuperar los fondos si la operación se atascó

El escenario de respaldo. Si la pata contraria nunca llegó a ejecutarse — la contraparte no replicó el escrow, expiró el timeout — build_crosschain_refund construye una transacción sin firmar que devuelve tus fondos desde el escrow. Es la segunda cerradura: la de tiempo. El secreto no se revela y lo bloqueado vuelve a ti. Es el fusible de emergencia de la atomicidad: una operación colgada no se come tu dinero.

El recorrido completo, en esquema:

get_crosschain_quote      → cuánto voy a recibir
build_crosschain_swap_tx  → HTLC-tx sin firmar + secreto (el secreto es tuyo)
        ↓ (firmada en la wallet, enviada)
track_crosschain_swap     → fases en TON y en Ethereum
   ├─ listo on-chain    →  disclose_crosschain_secret   → liquidación
   └─ atascada, timeout →  build_crosschain_refund      → devolución

Con el servidor conectado, se lo pides al agente con palabras humanas y él arma la cadena de herramientas por su cuenta:

Cambia 50 USDT de mi wallet de TON por ETH en la red Ethereum.
Primero muéstrame la cotización (get_crosschain_quote).
Si el precio me convence, construye el escrow HTLC (build_crosschain_swap_tx)
y dámelo a firmar. Luego haz seguimiento de la operación (track_crosschain_swap)
y, cuando ambas partes estén listas on-chain, revela el secreto para liquidar.
Si al vencer el timeout nada se mueve, construye la devolución.

Por qué es no custodial: el servidor no firma ni guarda claves

Volvamos al problema del principio. Un puente clásico es peligroso porque entregas los fondos al control de un intermediario. TONNode está construido de otra manera, y esa es una postura de principio: el servidor NUNCA firma ni almacena fondos ni claves privadas.

Qué significa eso para el escrow HTLC en la práctica:

• build_crosschain_swap_tx entrega una transacción sin firmar: hasta que no la firmes con tu wallet vía TonConnect, no se bloquea nada.
• El secreto S lo guardas tú, no el servidor. Sin tu secreto, nadie puede cerrar la liquidación en tu nombre.
• La devolución por timeout (build_crosschain_refund) también se construye como transacción sin firmar, pendiente de tu firma.
• Incluso una wallet generada (herramienta generate_wallet) se te entrega a ti y no se queda en el servidor.

Aunque el servidor esté caído o comprometido, físicamente no puede ni llevarse tus fondos ni cerrar la operación sin tu firma y tu secreto. Dicho de otro modo: el HTLC atómico te protege de la contraparte, y la arquitectura no custodial, del propio servicio. Más sobre este modelo en el análisis de MCP custodial contra no custodial y en el artículo sobre el swap no custodial para agentes en TON.

Para comparar: el @ton/mcp oficial de la TON Foundation es una wallet-agente custodial que guarda la clave de operador y firma por su cuenta, y solo funciona dentro de TON, sin cross-chain. La diferencia es honesta: allí tienes gasto autónomo a cambio de confiar la clave; aquí, arquitectura no custodial más la salida fuera de TON.

Qué redes están soportadas: Ethereum, Arbitrum, Base, BNB, Polygon, Avalanche

TON actúa siempre como origen de la operación, y la red de destino es una de estas seis redes EVM:

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

La mecánica es idéntica en todas: escrow HTLC atómico. TRON no está soportada por ahora. Si apuntas a una L2 por sus comisiones baratas, mira el análisis específico del swap cross-chain TON → Arbitrum: el flujo es el mismo, solo cambia la red de destino. Y para qué le sirve todo esto a un agente y dónde está el valor para TON, lo cuenta el artículo sobre el primer swap cross-chain y el valor para la red.

Cómo conectar el MCP y lanzar tu primer swap cross-chain

TONNode es un servidor MCP hosted para TON. MCP (Model Context Protocol) es el estándar con el que los agentes de IA (Claude, Cursor, ChatGPT/Codex y cualquier cliente MCP) invocan herramientas. Son 16 herramientas en total, y las 16 están disponibles en cualquier plan: solo pagas por la capacidad de peticiones.

En local y gratis

La configuración pública con el set completo de lectura se instala con un solo comando — npx -y @tonnode/mcp:

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

Añade esto a la configuración de tu cliente MCP (Claude Desktop, Cursor, Codex, cualquiera compatible con MCP) y las herramientas get_crosschain_quote, build_crosschain_swap_tx, track_crosschain_swap, disclose_crosschain_secret, build_crosschain_refund quedarán disponibles para el agente. El paquete @tonnode/mcp es open source (MIT), vive en npm y GitHub (tonnode/mcp) y habla el protocolo nativo ADNL de TON, sin capas HTTP intermedias.

Hosted — con tu propia clave

Para una capacidad garantizada, conectas el endpoint hosted con tu clave:

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

Los planes solo se diferencian en el límite de peticiones: Hobby — gratis para siempre, 60 peticiones/min; Pro — $29/mes, 300 peticiones/min; Scale — $199/mes, 1200 peticiones/min. El set de 16 herramientas es el mismo en todos. La clave gratuita de Hobby se emite nada más iniciar sesión, sin tarjeta. Por cierto, un apunte sobre la moneda: GRAM es el Toncoin renombrado (lo renombraron en junio de 2026), la red se sigue llamando TON y en las cotizaciones verás precisamente GRAM.

Tu primer swap en un minuto

1. Consigue la clave gratuita de Hobby: sin tarjeta, se emite nada más iniciar sesión.
2. Escribe la configuración (local o hosted).
3. Dale al agente el prompt de la sección de arriba y firma la transacción de escrow con tu wallet.

En resumen

El cross-chain entre redes distintas no tiene por qué construirse sobre la confianza. El escrow HTLC atómico da la garantía de «todo o nada», y la arquitectura no custodial de TONNode se asegura de que ni los fondos, ni las claves, ni el secreto salgan nunca de tu control. Cinco herramientas — get_crosschain_quote, build_crosschain_swap_tx, track_crosschain_swap, disclose_crosschain_secret, build_crosschain_refund — cubren el ciclo de vida completo de la operación, incluida la devolución de emergencia.

Puedes comprobarlo con un swap real gratis: consigue tu clave Hobby y haz tu primer swap cross-chain — sin tarjeta, y 60 peticiones por minuto son más que suficientes. El repaso de las 16 herramientas está en la página del MCP.