Todos los artículos
9 min de lectura

Swaps cross-chain de TON a Base: cómo funcionan

Swap cross-chain TON → Base vía MCP: escrow HTLC, no custodial, 5 herramientas. Cómo un agente mueve valor de TON a Base sin puente custodio.

cross-chainTONBaseHTLCswap no custodialMCP

Tu agente de IA encontró una oportunidad rentable: el capital del usuario está en TON, pero el protocolo o el activo que necesita vive en Base. La respuesta clásica es «pásalo por un puente». Pero un puente significa que alguien retiene tus fondos durante la transición: el contrato del bridge, un relayer, un multisig de firmantes que tú no elegiste. En los últimos años han sido precisamente los puentes custodios los que se han llevado más de mil millones de dólares de fondos de usuarios: no porque la criptografía fuera mala, sino porque alguien retenía los fondos en el intermedio.

Para un agente autónomo esto es un problema doble. Primero, un agente no debería firmar una transacción que entrega fondos a un tercero sin garantía de retorno. Segundo, un agente ni siquiera debería tener tus claves privadas. Y un puente clásico exige exactamente eso: confiar en un intermediario.

Hay otro camino: el escrow atómico HTLC. A continuación desglosamos cómo ejecutar un swap cross-chain TON → Base de forma que ningún intermediario pueda tocar tus claves o tus fondos en ningún momento, y cómo un agente de IA orquesta todo el flujo con las cinco herramientas MCP de TONNode.

Por qué swapear de TON a Base y por qué esto no es un puente normal

Base es la L2 de Coinbase sobre Ethereum, construida con OP Stack. Hacia allí migra la liquidez, allí se despliegan los protocolos DeFi, y cada vez más a menudo es allí donde está el contrato con el que tu agente tiene que trabajar. Mientras tanto, tu capital de origen está en TON — en GRAM (el Toncoin renombrado en junio de 2026; la red se sigue llamando TON) o en USDT sobre TON.

Un puente normal resuelve esto con custodia. Entregas los fondos al contrato del bridge en la red de origen, un relayer en algún lugar lo detecta y emite el equivalente en Base. Entre «entregué» y «recibí» hay una ventana en la que tu dinero no lo controlas tú. Para una persona que mueve fondos una vez al mes, es tolerable. Para un agente que lo hace en bucle y sin supervisión, es un riesgo inaceptable.

La alternativa es un intercambio atómico donde no existe ningún momento en el que los fondos pertenezcan a un intermediario. O la operación se ejecuta completa en ambas redes, o se revierte completa. Así es exactamente como funciona el cross-chain en TONNode.

Cómo funciona el escrow atómico HTLC entre TON y Base

HTLC (hashed timelock contract) es un escrow con dos condiciones de desbloqueo: el hash de un secreto y un timelock. La forma más fácil de imaginarlo son dos cajas fuertes: una en TON, otra en Base. Las dos se abren con la misma llave: el secreto. Mientras el secreto no se revele, ambas permanecen cerradas.

  • Cerradura de hash. Los fondos en ambas redes se bloquean bajo el mismo hash del secreto h = hash(s). El escrow solo se abre presentando el propio secreto s cuyo hash coincide.
  • Timelock. Cada caja fuerte tiene un plazo. Si la operación no se completa a tiempo, los fondos vuelven a su dueño al expirar el timelock.

El esquema, a grandes rasgos:

  1. Se genera un secreto aleatorio s y su hash h = hash(s).
  2. En TON tus fondos se bloquean en un escrow con la condición: «entregar a quien presente s; devolver al remitente si s no se presenta antes del deadline».
  3. En Base, la contraparte (el resolver que aporta la liquidez de destino) bloquea sus fondos bajo el mismo h, con un timelock más corto.
  4. Tú revelas s para cobrar los fondos en Base. En ese momento s se vuelve público on-chain.
  5. La contraparte ve el s revelado y cobra los fondos bloqueados en TON.

La propiedad clave: h es el mismo en ambas redes. En cuanto el secreto se revela para liquidar en un lado, el otro lado ya puede cerrar la operación por pura matemática. El estado intermedio de «mi dinero lo tiene un desconocido» no existe: solo están la matemática del hash y el reloj del timelock. Si algo sale mal y el timelock expira, los fondos vuelven a sus dueños originales. Atómico: o se ejecutan ambas patas, o se revierten ambas.

En el esquema de TONNode, TON es siempre el origen de la operación, y Base (u otra red soportada) es el destino.

Las cinco herramientas de swap cross-chain en TONNode MCP

TONNode es un servidor MCP hosted para TON con exactamente 16 herramientas. MCP (Model Context Protocol) es el estándar mediante el cual los agentes de IA (Claude, Cursor, ChatGPT/Codex y cualquier cliente MCP) invocan herramientas externas. El conjunto cross-chain lo forman exactamente 5 herramientas, disponibles en todos los planes:

  • get_crosschain_quote — la cotización: cuánto recibirás en Base por tus fondos de TON, teniendo en cuenta la ruta y los timelocks.
  • build_crosschain_swap_tx — construye la transacción de escrow HTLC sin firmar para TON y la devuelve junto con el secreto. La firma la pone la wallet del usuario vía TonConnect.
  • track_crosschain_swap — muestra las fases de la operación en ambas redes: si está bloqueado en TON, si la contraparte bloqueó en Base, si el secreto fue revelado, si se completó.
  • disclose_crosschain_secret — revela el secreto para la liquidación, pero solo después de confirmar on-chain que la pata contraria está lista.
  • build_crosschain_refund — construye la transacción sin firmar para recuperar los fondos del escrow si la operación se quedó colgada y el timelock expiró.

Fíjate en el orden de responsabilidad: la herramienta que revela el secreto no lo hace a ciegas, sino tras verificar que en Base todo está listo. Eso te protege de revelar s en una situación en la que la contraparte todavía no ha bloqueado nada.

El flujo completo: cotización → construcción → seguimiento → revelación del secreto

Primero, conecta el servidor. En local y gratis: el paquete @tonnode/mcp es open source (MIT) y funciona sobre el protocolo nativo ADNL de TON, sin capas HTTP de por medio:

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

A partir de ahí, todo el trabajo se hace con prompts al agente: él mismo los descompone en llamadas a herramientas.

Paso 1. La cotización.

Dame una cotización de swap cross-chain: 200 USDT de TON a USDC en Base.
Usa get_crosschain_quote.

El agente te devolverá cuánto recibirás en Base y qué timelocks tiene el escrow: los números, antes de hacer nada. Si te convence, seguimos.

Paso 2. Construcción de la transacción sin firmar.

Construye la transacción de escrow HTLC para esta cotización con build_crosschain_swap_tx.
Mi dirección de TON es EQ…, la dirección de recepción en Base es 0x…

El resultado: un mensaje TonConnect sin firmar con el escrow HTLC y el secreto de la operación. El secreto es tuyo, guárdalo; el servidor no lo almacena. Los fondos se bloquean en el escrow en TON bajo el hash de ese secreto. La firma la pone tu wallet vía TonConnect — el servidor no toca la firma.

Paso 3. Seguimiento.

Comprueba el estado de la operación con track_crosschain_swap por el hash h….
¿Ya bloqueó la contraparte los fondos en Base?

La herramienta muestra las fases en ambas redes. El agente espera hasta que ambos lados queden cerrados bajo el mismo hash.

Paso 4. Revelación del secreto.

Los fondos en Base están bloqueados. Revela el secreto para la liquidación
con disclose_crosschain_secret.

Solo después de que track_crosschain_swap confirme on-chain que todo está listo, el agente revela el secreto. La revelación ejecuta ambos escrows de forma atómica: tú recibes los fondos en Base y la contraparte, con el secreto ya público, cierra su lado en TON. Operación cerrada.

Fíjate en el orden: el secreto se revela al final y solo tras verificar que el escrow contrario está realmente en pie. Antes de la revelación tus fondos no pueden ir a ninguna parte, y después de la revelación la operación ya es atómica.

Un desglose detallado del mismo flujo, pero con Ethereum como destino, está en un artículo aparte: swap cross-chain TON → Ethereum — la mecánica es la misma, solo cambia la red de destino. Y sobre por qué el simple hecho de que un agente pueda mover valor fuera de TON por sí mismo constituye una nueva clase de operaciones, lee este artículo.

Arquitectura no custodial: por qué el servidor nunca tiene tus claves

No es una fórmula de marketing, es una propiedad de la arquitectura. El servidor de TONNode nunca firma transacciones y nunca almacena fondos ni claves privadas. Todo lo que expone son mensajes TonConnect sin firmar y datos (cotizaciones, estados, el secreto de tu propia operación).

Desglosemos paso a paso dónde está cada cosa:

  • La clave privada de tu wallet de TON: solo la tienes tú, dentro de la wallet.
  • El secreto s: se genera al construir la transacción y se te entrega; en el servidor no queda copia.
  • La firma de la transacción HTLC: la pone tu wallet vía TonConnect.
  • Los fondos en TON: están en un contrato de escrow bajo una condición criptográfica, no en la cuenta de un intermediario.

Aunque el servidor quisiera, no podría ni firmar por ti ni sacar los fondos del escrow: no tiene ni la clave ni la posibilidad de presentar la condición de desbloqueo a su favor. Esto es radicalmente distinto del enfoque custodial, donde el operador guarda la clave y firma él mismo. La comparación a fondo de ambos modelos está en MCP custodial vs no custodial, y el análisis del swap sin custodia en concreto está en el texto sobre swap no custodial desde un agente.

Qué redes se soportan además de Base (y por qué TRON todavía no)

TON es siempre el origen, y la red de destino puede ser cualquiera de estas:

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

TRON todavía no está soportado. La razón es técnica, no ideológica: el escrow atómico HTLC exige una semántica de hash-timelocks compatible y un comportamiento predecible de los contratos en el lado de destino. Si tu escenario depende de TRON, no construyas sobre esa base la lógica de tu agente: no está en el conjunto cross-chain actual. Cuando lo añadamos, quedará reflejado en el roadmap: tonnode.io/roadmap.

Cómo conectarlo y qué pasa si la operación se cuelga: el refund

Para producción con throughput garantizado se usa el endpoint hosted con tu propia clave:

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

Todas las claves dan acceso a las 16 herramientas, incluido el conjunto cross-chain completo. Pagas solo por el throughput, no por el acceso a las herramientas:

  • Hobby — gratis para siempre, 60 solicitudes/min. La clave se emite nada más iniciar sesión, sin tarjeta.
  • Pro — $29/mes, 300 solicitudes/min.
  • Scale — $199/mes, 1200 solicitudes/min.

¿Y si la contraparte no completa la operación?

Aquí es donde cobra sentido el timelock. Si el otro lado no ejecutó su parte y el timelock expiró, tus fondos no se pierden: están bloqueados bajo la condición de devolución al remitente una vez pasado el deadline. El agente invoca:

La operación se colgó, el timelock expiró. Construye la transacción
de devolución de fondos del escrow con build_crosschain_refund.

build_crosschain_refund devuelve la transacción de retorno sin firmar — la firmas con tu wallet y recuperas los fondos de vuelta en TON. Ese es el seguro incorporado en el HTLC: la operación o se ejecuta de forma atómica, o se revierte por timelock. Una operación colgada no significa dinero perdido: significa un refund. Precisamente esa garantía es lo que convierte el intercambio atómico en un sustituto seguro del puente custodio.

Por dónde empezar

Un swap cross-chain TON → Base deja de ser un acto de fe en un puente cuando quienes responden por él son una cerradura de hash y un timelock, y no un custodio ajeno. Cinco herramientas, arquitectura estrictamente no custodial, seis redes de destino — y todo invocable desde tu agente con una sola config de MCP.

La forma más rápida de probarlo es tomar la clave gratuita Hobby (se emite nada más iniciar sesión, sin tarjeta) y ejecutar el flujo TON → Base desde tu propio agente:

Dale a tu agente acceso a TON

16 herramientas MCP: lectura, swaps no custodiales, cross-chain y billeteras. Plan gratuito — 60 req/min, sin tarjeta.