FivoDocs
Docs/Inter-chaînes (Bridge Kit)

Paiements inter-chaînes

Comment Fivo gère automatiquement les paiements entre différentes blockchains.

Qu'est-ce que le CCTP ?

Le CCTP (Cross-Chain Transfer Protocol) est le protocole natif de Circle pour déplacer les USDC entre blockchains. Contrairement aux tokens encapsulés ou aux bridges, le CCTP brûle les USDC sur la chaîne source et crée des USDC natifs sur la chaîne de destination, garantissant que vous recevez toujours de vrais USDC natifs.

!

USDC uniquement

Les transferts inter-chaînes CCTP sont disponibles uniquement pour USDC. Les paiements EURC fonctionnent uniquement sur la même chaîne. Le client doit payer depuis la même chaîne que le wallet du marchand.

Avantages clés

  • USDC natifs : Pas de tokens encapsulés. De vrais USDC sur chaque chaîne
  • Sécurisé : Soutenu par le service d'attestation de Circle
  • Rapide : Se termine généralement en 1 à 2 minutes
  • Automatique : Fivo gère tout pour vous

Quand le CCTP s'active-t-il ?

Le CCTP est déclenché automatiquement lorsque :

La chaîne de paiement du client ≠ la chaîne de réception du marchand

Exemple : Le client paie en USDC sur , mais le wallet du marchand est sur .EthereumPolygon.

Même chaîne (instantané)

Client sur Polygon → Marchand sur Polygon

Transfert direct, aucun transfert inter-chaînes nécessaire

Inter-chaînes (Bridge Kit)

Client sur Ethereum → Marchand sur Polygon

Bridge Kit gère la destruction, l'attestation et la création (~1-2 min)

Comment ça fonctionne

L'ensemble du processus est géré côté client par le SDK Bridge Kit de Circle à l'intérieur du widget Fivo. Aucune intervention du serveur nécessaire :

1

Destruction sur la chaîne source

Le client approuve les USDC et appelle sur le contrat TokenMessenger de Circle. Les USDC sont brûlés et un message est émis.depositForBurn()

2

Attestation

Le service d'attestation de Circle vérifie la transaction de destruction et génère une attestation cryptographique (signature) prouvant que la destruction a eu lieu.

3

Attestation et transfert inter-chaînes

Bridge Kit attend automatiquement l'attestation de Circle et gère le processus de création. Cela prend généralement 1 à 2 minutes.

4

Création sur la chaîne de destination

Bridge Kit gère automatiquement l'attestation et la création sur la chaîne de destination, livrant les USDC directement au wallet du marchand.

✓

Paiement terminé

Les USDC natifs sont maintenant dans le wallet du marchand sur sa chaîne préférée. Le statut du paiement passe à « completed ».

Routes supportées

Le CCTP supporte les transferts entre toutes les 9 chaînes supportées par Fivo :

Ethereum

Domaine CCTP: 0Chain ID: 1

Avalanche

Domaine CCTP: 1Chain ID: 43114

Optimism

Domaine CCTP: 2Chain ID: 10

Arbitrum

Domaine CCTP: 3Chain ID: 42161

Base

Domaine CCTP: 6Chain ID: 8453

Polygon

Domaine CCTP: 7Chain ID: 137

Unichain

Domaine CCTP: 10Chain ID: 130

Linea

Domaine CCTP: 11Chain ID: 59144

Sonic

Domaine CCTP: 13Chain ID: 146
i
Toute combinaison source → destination est supportée. Par exemple : Ethereum → Polygon, Arbitrum → Base, Avalanche → Optimism, etc.

Statut du paiement

Avec Bridge Kit, les paiements inter-chaînes se terminent entièrement dans le widget avant de notifier le serveur. Le paiement arrive avec le statut . Aucun état intermédiaire.completed

Même chaîne

Statut : (instantané)completed

Inter-chaînes (Bridge Kit)

Statut : (après la fin du transfert inter-chaînes dans le widget, ~1-2 min)completed

i

Statuts CCTP historiques

Les paiements historiques traités par l'ancien relayeur CCTP côté serveur (avant Bridge Kit) peuvent avoir des statuts intermédiaires comme , ou . Ceux-ci ne se produisent plus pour les nouveaux paiements.pending_attestationready_to_mintminted_pending_transfer

Délais

Transfert sur la même chaîne

~15-30 sec

Uniquement le temps de confirmation blockchain

Inter-chaînes (Bridge Kit)

~1-2 min

Destruction + Attestation + Création

!

Congestion réseau

En période de forte congestion réseau, les transferts CCTP peuvent prendre plus de temps (jusqu'à 15-20 minutes dans les cas extrêmes). Le paiement se terminera tout de même avec succès. Il faut simplement plus de temps pour l'attestation.

Coûts

Les paiements inter-chaînes impliquent des frais de gas supplémentaires :

  • Gas chaîne source : Payé par le client pour la transaction de destruction
  • Gas chaîne de destination : Inclus dans les frais de transfert inter-chaînes (facturé au client, pas au marchand)

Le widget affiche le détail complet des frais avant que le client confirme. Le marchand reçoit toujours le montant exact du produit. Tous les frais sont payés par le client. Les coûts varient selon la chaîne : les L2 comme Arbitrum et Base sont généralement les moins chers.

Pour les marchands

Vous n'avez rien à faire !

Le transfert inter-chaînes est entièrement automatique. Configurez simplement votre wallet marchand sur votre chaîne préférée, et Bridge Kit gère toute la complexité inter-chaînes dans le widget. Vos clients peuvent payer depuis n'importe quelle chaîne supportée, et vous recevrez des USDC natifs sur votre chaîne.

i

Configuration recommandée

Pour des frais réduits, nous recommandons de configurer votre wallet marchand sur un L2 comme Polygon, Arbitrum ou Base. Cela minimise les coûts de gas pour la création inter-chaînes.

En savoir plus sur le CCTP

Pour les détails techniques sur le Cross-Chain Transfer Protocol de Circle :

Documentation CCTP de Circle