Enlace a una cuenta
Actualizado:
Un monedero realiza compras por sí solo; no se necesita nada de lo que aparece en esta página para utilizar la API x402. Sin embargo, cuando el agente realiza un pago en nombre de una empresa que ya dispone de una cuenta de vendedor proxy, el titular de dicha cuenta puede vincular el monedero del agente a ella. A partir de ese momento, los nuevos pedidos de la cartera aparecerán en el panel de control de la cuenta, y sus recargas se abonarán en el saldo de dicha cuenta.
El enlace se confirma por ambas partes: la cuenta mediante la sesión de su propietario y el monedero mediante una firma. La firma no transfiere fondos: no es una transacción, no cuesta gas y no cambia la red del monedero.
El proceso
El propietario solicita un mensaje
En el panel de control, en la sección «Saldo», el propietario introduce la dirección del monedero y recibe un mensaje de uso único para el mismo.
La cartera lo firma
personal_sign(EIP-191) del mensaje, tal y como se ha recibido. El propietario vuelve a introducir la firma en el panel de control.La cartera está vinculada
A partir de ahora, los nuevos pedidos de este monedero aparecerán en el panel de control de la cuenta y sus recargas se abonarán en el saldo de la cuenta.
El mensaje
El mensaje es un texto EIP-4361, del mismo tipo Recuperar acceso usos, emitidos por el panel de control en lugar de por la API x402.
Propiedad | Valor |
|---|---|
Vida útil | 5 minutos, un uso, asignado a una cuenta |
Firma |
|
Monedero normal | La firma se comprueba con |
Cartera de contratos inteligentes | Se ha comprobado mediante EIP-1271, y el contrato ya tiene que estar desplegado en Base —con al menos una transacción realizada desde él—. No se puede vincular una cartera que aún no esté desplegada. |
Multifirma | Una caja fuerte que requiere la firma de varios propietarios no resulta práctica en este caso: el mensaje dura 5 minutos. |
Un agente lo firma del mismo modo que firma un desafío de recuperación:
// viem
await account.signMessage({ message });
// ethers
await wallet.signMessage(message);Qué cambia
¿Qué? | Después de insertar el enlace |
|---|---|
Pedidos pagados tras el enlace | visible en el panel de control de la cuenta, junto a los pedidos comprados allí |
Recargas desde el monedero | Ir al saldo de la cuenta |
Renovación automática de estos pedidos | pagado con el saldo de la cuenta |
Pagos de los encargos | sin cambios: USDC desde el monedero, el mismo ciclo de dos solicitudes |
Tokens de acceso | Sin cambios: la API sigue autorizando mediante el token de acceso del pedido y la firma del monedero. |
Recuperar acceso | el |
Retiradas | que sigue solicitando únicamente el monedero, con una firma (Retirar saldo), pero se abonará con cargo al saldo de la cuenta, y solo hasta el importe que este monedero haya recargado en dicha cuenta, restando lo que ya se haya retirado. El saldo que tenía el monedero antes de la vinculación solo se podrá retirar tras desvincularlo |
Estos pedidos pertenecen a la cuenta: el propietario los gestiona en el panel de control y a través de la API principal, y el agente sigue gestionándolos a través de la API x402 con sus tokens de acceso.
Lo que se compró con la cartera antes
Los pedidos pagados antes de la vinculación, así como el saldo que tenía el monedero en ese momento, permanecen en el monedero: no se transfieren a la cuenta. El agente sigue gestionando esos pedidos a través de la API x402 como antes, y su renovación automática se sigue pagando con ese saldo anterior. Mientras el monedero esté vinculado, Recuperar acceso En su lugar, muestra el saldo de la cuenta, y el saldo anterior solo se puede retirar tras desvincularla. Justo después de la vinculación, el panel de control muestra cuánto quedaba en ese saldo.
Desvincular
El titular puede desvincular el monedero en cualquier momento, y el monedero no firma nada al respecto. Tras la desvinculación, los nuevos pagos procedentes del monedero vuelven a ser de su propiedad, mientras que los pedidos adquiridos mientras estaba vinculado y el dinero ya abonado en la cuenta permanecen en la cuenta.
Una cartera solo puede estar vinculada a una cuenta a la vez: si está vinculada a otra cuenta, primero hay que desvincularla de allí. Una cartera bloqueada no se puede vincular en absoluto; escribe a [email protected].