FivoDocs
Docs/Entre Cadeias (Bridge Kit)

Pagamentos Entre Cadeias

Como o Fivo trata pagamentos entre diferentes blockchains automaticamente.

O que é o CCTP?

CCTP (Cross-Chain Transfer Protocol) é o protocolo nativo da Circle para mover USDC entre blockchains. Ao contrário de tokens wrapped ou pontes, o CCTP queima USDC na cadeia de origem e cunha USDC nativo na cadeia de destino, garantindo que recebe sempre USDC real e nativo.

!

Apenas USDC

As transferências entre cadeias via CCTP estão disponíveis apenas para USDC. Pagamentos em EURC funcionam apenas na mesma cadeia. O cliente deve pagar a partir da mesma cadeia da wallet do comerciante.

Benefícios Principais

  • USDC Nativo: Sem tokens wrapped. USDC real em todas as cadeias
  • Seguro: Suportado pelo serviço de atestação da Circle
  • Rápido: Normalmente concluído em 1-2 minutos
  • Automático: O Fivo trata de tudo por si

Quando é que o CCTP é Ativado?

O CCTP é ativado automaticamente quando:

Cadeia de pagamento do cliente ≠ Cadeia de receção do comerciante

Exemplo: O cliente paga com USDC em , mas a wallet do comerciante está em .EthereumPolygon.

Mesma Cadeia (Instantâneo)

Cliente em Polygon → Comerciante em Polygon

Transferência direta, sem necessidade de transferência entre cadeias

Entre Cadeias (Bridge Kit)

Cliente em Ethereum → Comerciante em Polygon

O Bridge Kit trata da queima, atestação e cunhagem (~1-2 min)

Como Funciona

Todo o processo é tratado do lado do cliente pelo SDK Bridge Kit da Circle dentro do widget Fivo. Sem necessidade de envolvimento do backend:

1

Queima na Cadeia de Origem

O cliente aprova USDC e chama no contrato TokenMessenger da Circle. O USDC é queimado e uma mensagem é emitida.depositForBurn()

2

Atestação

O serviço de atestação da Circle verifica a transação de queima e gera uma atestação criptográfica (assinatura) provando que a queima ocorreu.

3

Atestação e Transferência

O Bridge Kit aguarda automaticamente pela atestação da Circle e trata do processo de cunhagem. Normalmente demora 1-2 minutos.

4

Cunhagem na Cadeia de Destino

O Bridge Kit trata automaticamente da atestação e cunhagem na cadeia de destino, entregando USDC diretamente na wallet do comerciante.

✓

Pagamento Concluído

USDC nativo está agora na wallet do comerciante na sua cadeia preferida. O estado do pagamento é atualizado para "completed".

Rotas Suportadas

O CCTP suporta transferências entre todas as 9 cadeias suportadas pelo Fivo:

Ethereum

Domínio CCTP: 0Chain ID: 1

Avalanche

Domínio CCTP: 1Chain ID: 43114

Optimism

Domínio CCTP: 2Chain ID: 10

Arbitrum

Domínio CCTP: 3Chain ID: 42161

Base

Domínio CCTP: 6Chain ID: 8453

Polygon

Domínio CCTP: 7Chain ID: 137

Unichain

Domínio CCTP: 10Chain ID: 130

Linea

Domínio CCTP: 11Chain ID: 59144

Sonic

Domínio CCTP: 13Chain ID: 146
i
Qualquer combinação de origem → destino é suportada. Por exemplo: Ethereum → Polygon, Arbitrum → Base, Avalanche → Optimism, etc.

Estado do Pagamento

Com o Bridge Kit, os pagamentos entre cadeias são concluídos inteiramente no widget antes de notificar o backend. O pagamento chega com o estado . Sem estados intermédios.completed

Mesma cadeia

Estado: (instantâneo)completed

Entre cadeias (Bridge Kit)

Estado: (após a transferência terminar no widget, ~1-2 min)completed

i

Estados CCTP legados

Pagamentos históricos processados pelo antigo relayer CCTP do backend (antes do Bridge Kit) podem ter estados intermédios como , ou . Estes já não ocorrem em novos pagamentos.pending_attestationready_to_mintminted_pending_transfer

Tempos

Transferência na Mesma Cadeia

~15-30 seg

Apenas tempo de confirmação da blockchain

Entre Cadeias (Bridge Kit)

~1-2 min

Queima + Atestação + Cunhagem

!

Congestionamento da Rede

Durante períodos de elevado congestionamento da rede, as transferências via CCTP podem demorar mais (até 15-20 minutos em casos extremos). O pagamento será concluído com sucesso. Apenas demora mais tempo para a atestação.

Custos

Os pagamentos entre cadeias envolvem custos adicionais de gas:

  • Gas na cadeia de origem: Pago pelo cliente para a transação de queima
  • Gas na cadeia de destino: Incluído na taxa de transferência entre cadeias (cobrado ao cliente, não ao comerciante)

O widget mostra a decomposição completa das taxas antes do cliente confirmar. O comerciante recebe sempre o montante exato do produto. Todas as taxas são pagas pelo cliente. Os custos variam por cadeia: L2s como Arbitrum e Base são normalmente as mais baratas.

Para Comerciantes

Não precisa de fazer nada!

A transferência entre cadeias é totalmente automática. Basta configurar a sua wallet de comerciante na sua cadeia preferida, e o Bridge Kit trata de toda a complexidade entre cadeias no widget. Os seus clientes podem pagar a partir de qualquer cadeia suportada, e receberá USDC nativo na sua cadeia.

i

Configuração Recomendada

Para taxas mais baixas, recomendamos configurar a sua wallet de comerciante numa L2 como Polygon, Arbitrum ou Base. Isto minimiza os custos de gas para a cunhagem entre cadeias.

Saiba Mais Sobre o CCTP

Para detalhes técnicos sobre o Cross-Chain Transfer Protocol da Circle:

Documentação CCTP da Circle