FivoDocs
Docs/Entre Cadenas (Bridge Kit)

Pagos Entre Cadenas

Cómo Fivo gestiona automáticamente los pagos entre diferentes blockchains.

¿Qué es CCTP?

CCTP (Cross-Chain Transfer Protocol) es el protocolo nativo de Circle para mover USDC entre blockchains. A diferencia de los tokens envueltos o puentes, CCTP quema USDC en la cadena de origen y emite USDC nativo en la cadena de destino, asegurando que siempre reciba USDC real y nativo.

!

Solo USDC

Las transferencias entre cadenas CCTP solo están disponibles para USDC. Los pagos con EURC son únicamente en la misma cadena. El cliente debe pagar desde la misma cadena que la wallet del comerciante.

Beneficios Principales

  • USDC nativo: Sin tokens envueltos. USDC real en cada cadena
  • Seguro: Respaldado por el servicio de attestation de Circle
  • Rápido: Normalmente se completa en 1-2 minutos
  • Automático: Fivo se encarga de todo por usted

¿Cuándo se Activa CCTP?

CCTP se activa automáticamente cuando:

La cadena de pago del cliente ≠ La cadena receptora del comerciante

Ejemplo: El cliente paga con USDC en , pero la wallet del comerciante está en .EthereumPolygon.

Misma Cadena (Instantáneo)

Cliente en Polygon → Comerciante en Polygon

Transferencia directa, sin necesidad de transferencia entre cadenas

Entre Cadenas (Bridge Kit)

Cliente en Ethereum → Comerciante en Polygon

Bridge Kit gestiona la quema, attestation y emisión (~1-2 min)

Cómo Funciona

Todo el proceso se gestiona del lado del cliente mediante el SDK Bridge Kit de Circle dentro del widget de Fivo. No se necesita intervención del backend:

1

Quema en la Cadena de Origen

El cliente aprueba USDC y llama a en el contrato TokenMessenger de Circle. El USDC se quema y se emite un mensaje.depositForBurn()

2

Attestation

El servicio de attestation de Circle verifica la transacción de quema y genera una attestation criptográfica (firma) que demuestra que la quema ocurrió.

3

Attestation y Transferencia

Bridge Kit espera automáticamente la attestation de Circle y gestiona el proceso de emisión. Esto normalmente tarda 1-2 minutos.

4

Emisión en la Cadena de Destino

Bridge Kit gestiona automáticamente la attestation y la emisión en la cadena de destino, entregando USDC directamente a la wallet del comerciante.

✓

Pago Completado

El USDC nativo ya está en la wallet del comerciante en su cadena preferida. El estado del pago se actualiza a "completed".

Rutas Compatibles

CCTP admite transferencias entre todas las 9 cadenas compatibles con Fivo:

Ethereum

Dominio CCTP: 0Chain ID: 1

Avalanche

Dominio CCTP: 1Chain ID: 43114

Optimism

Dominio CCTP: 2Chain ID: 10

Arbitrum

Dominio CCTP: 3Chain ID: 42161

Base

Dominio CCTP: 6Chain ID: 8453

Polygon

Dominio CCTP: 7Chain ID: 137

Unichain

Dominio CCTP: 10Chain ID: 130

Linea

Dominio CCTP: 11Chain ID: 59144

Sonic

Dominio CCTP: 13Chain ID: 146
i
Cualquier combinación de origen → destino es compatible. Por ejemplo: Ethereum → Polygon, Arbitrum → Base, Avalanche → Optimism, etc.

Estado del Pago

Con Bridge Kit, los pagos entre cadenas se completan íntegramente en el widget antes de notificar al backend. El pago llega con estado . Sin estados intermedios.completed

Misma cadena

Estado: (instantáneo)completed

Entre cadenas (Bridge Kit)

Estado: (después de que la transferencia finaliza en el widget, ~1-2 min)completed

i

Estados CCTP heredados

Los pagos históricos procesados por el antiguo relayer CCTP del backend (antes de Bridge Kit) pueden tener estados intermedios como , o . Estos ya no ocurren para pagos nuevos.pending_attestationready_to_mintminted_pending_transfer

Tiempos

Transferencia en la Misma Cadena

~15-30 seg

Solo el tiempo de confirmación de la blockchain

Entre Cadenas (Bridge Kit)

~1-2 min

Quema + Attestation + Emisión

!

Congestión de Red

Durante periodos de alta congestión de red, las transferencias CCTP pueden tardar más (hasta 15-20 minutos en casos extremos). El pago se completará con éxito de todos modos. Solo tarda más tiempo en la attestation.

Costes

Los pagos entre cadenas implican costes adicionales de gas:

  • Gas de la cadena de origen: Pagado por el cliente para la transacción de quema
  • Gas de la cadena de destino: Incluido en la tasa de transferencia entre cadenas (cobrado al cliente, no al comerciante)

El widget muestra el desglose completo de costes antes de que el cliente confirme. El comerciante siempre recibe el monto exacto del producto. Todas las comisiones las paga el cliente. Los costes varían según la cadena: las L2 como Arbitrum y Base suelen ser las más económicas.

Para Comerciantes

¡No necesita hacer nada!

La transferencia entre cadenas es completamente automática. Simplemente configure su wallet de comerciante en su cadena preferida, y Bridge Kit se encarga de toda la complejidad entre cadenas en el widget. Sus clientes pueden pagar desde cualquier cadena compatible, y usted recibirá USDC nativo en su cadena.

i

Configuración Recomendada

Para obtener las comisiones más bajas, recomendamos configurar su wallet de comerciante en una L2 como Polygon, Arbitrum o Base. Esto minimiza los costes de gas para la emisión entre cadenas.

Más Información sobre CCTP

Para detalles técnicos sobre el Cross-Chain Transfer Protocol de Circle:

Documentación CCTP de Circle