Lien vers un compte
Updated:
Un portefeuille effectue des achats de manière autonome — rien sur cette page n’est nécessaire pour utiliser l’API x402. Cependant, lorsque l’agent effectue un paiement pour le compte d’une entreprise disposant déjà d’un compte de vendeur par procuration, le titulaire de ce compte peut y associer le portefeuille de l’agent. Par la suite, les nouvelles commandes du portefeuille apparaissent dans le tableau de bord du compte, et ses recharges sont créditées sur le solde de ce compte.
La liaison est confirmée par les deux parties : le compte par la session de son propriétaire, le portefeuille par une signature. La signature n'entraîne aucun transfert de fonds : il ne s'agit pas d'une transaction, elle ne coûte pas de « gas » et ne change pas de réseau pour le portefeuille.
Le déroulement
Le propriétaire demande un message
Dans le tableau de bord, section « Balance », le propriétaire saisit l'adresse du portefeuille et reçoit un message à usage unique correspondant à celle-ci.
C'est le portefeuille qui signe
personal_sign(EIP-191) du message, exactement tel qu’il a été reçu. Le propriétaire réintègre la signature dans le tableau de bord.Le portefeuille est lié
Désormais, les nouvelles commandes de ce portefeuille apparaissent dans le tableau de bord du compte et ses recharges sont créditées sur le solde du compte.
Le message
Le message est un texte EIP-4361, du même type Récupérer l'accès utilisations, émises par le tableau de bord plutôt que par l'API x402.
Propriété | Valeur |
|---|---|
Durée de vie | 5 minutes, une seule utilisation, attribué à un seul compte |
Signature |
|
Portefeuille classique | La signature est vérifiée à l'aide de |
Portefeuille de contrats intelligents | Vérifié via EIP-1271 ; le contrat doit déjà être déployé sur Base — avec au moins une transaction provenant de celui-ci. Un portefeuille qui n’est pas encore déployé ne peut pas être associé. |
Multisig | Un coffre-fort nécessitant la signature de plusieurs propriétaires n'est pas adapté ici : le message ne reste affiché que 5 minutes. |
Un agent le signe de la même manière qu’il signe un défi de récupération :
// viem
await account.signMessage({ message });
// ethers
await wallet.signMessage(message);Quels changements ?
Quoi | Après avoir inséré les liens |
|---|---|
Commandes payées après la mise en place du lien | visible dans le tableau de bord du compte, à côté des commandes achetées sur ce site |
Recharges depuis le portefeuille | Aller au solde du compte |
Renouvellement automatique de ces commandes | payé à partir du solde du compte |
Paiements des commandes | inchangé : USDC depuis le portefeuille, le même cycle de deux demandes |
Jetons d'accès | Inchangé : l'API continue d'autoriser l'accès via le jeton d'accès de la commande et la signature du portefeuille. |
Récupérer l'accès | le |
Retraits | toujours demandé uniquement par le portefeuille, avec une signature (Retirer le solde), mais versés à partir du solde du compte, et uniquement à hauteur du montant que ce portefeuille a crédité sur ce compte, déduction faite des montants déjà retirés. Le solde dont disposait le portefeuille avant la liaison ne peut être retiré qu'après la suppression de la liaison |
Ces commandes appartiennent au compte : le propriétaire les gère dans le tableau de bord et via l'API principale, tandis que l'agent continue de les gérer via l'API x402 à l'aide de ses jetons d'accès.
Ce que le portefeuille a acheté auparavant
Les commandes payées avant l'association, ainsi que le solde dont disposait alors le portefeuille, restent dans ce dernier : ils ne sont pas transférés vers le compte. L'agent continue de gérer ces commandes via l'API x402 comme auparavant, et leur renouvellement automatique est toujours payé à partir de cet ancien solde. Tant que le portefeuille est associé, Récupérer l'accès affiche à la place le solde du compte, et l'ancien solde ne peut être retiré qu'après la suppression du lien. Juste après la création du lien, le tableau de bord indique le montant restant sur ce solde.
Suppression des liens
Le titulaire peut dissocier le portefeuille à tout moment, et le portefeuille ne signe rien à cet effet. Après la dissociation, les nouveaux paiements provenant du portefeuille lui reviennent à nouveau, tandis que les commandes achetées pendant qu'il était associé et l'argent déjà crédité sur le compte restent sur ce dernier.
Un portefeuille ne peut être associé qu'à un seul compte à la fois : s'il est déjà associé ailleurs, il faut d'abord le désassocier de cet autre compte. Un portefeuille bloqué ne peut en aucun cas être associé — écrivez à [email protected].