Link para uma conta
Atualizado:
Uma carteira realiza compras por conta própria — nada nesta página é necessário para usar a API x402. Mas quando o agente efetua um pagamento em nome de uma empresa que já possui uma conta de vendedor proxy, o titular dessa conta pode vincular a carteira do agente a ela. Depois disso, os novos pedidos da carteira aparecem no painel da conta, e suas recargas vão para o saldo dessa conta.
A vinculação é confirmada por ambas as partes: a conta, pela sessão de seu proprietário; a carteira, por uma assinatura. A assinatura não movimenta fundos: não é uma transação, não custa gas e não altera a rede da carteira.
O fluxo
O proprietário solicita uma mensagem
No painel de controle, na seção “Saldo”, o proprietário insere o endereço da carteira e recebe uma mensagem de uso único para ela.
A carteira assina isso
personal_sign(EIP-191) da mensagem, exatamente como foi recebida. O proprietário insere a assinatura de volta no painel de controle.A carteira está vinculada
A partir de agora, novos pedidos dessa carteira aparecem no painel da conta e suas recargas são creditadas no saldo da conta.
A mensagem
A mensagem é um texto EIP-4361, do mesmo tipo Recuperar acesso usos, emitidos pelo painel de controle em vez da API x402.
Propriedade | Valor |
|---|---|
Vida útil | 5 minutos, uso único, concedido a uma conta |
Assinatura |
|
Carteira comum | A assinatura é verificada com |
Carteira de contratos inteligentes | Verificado por meio do EIP-1271, e o contrato já precisa estar implantado na Base — com pelo menos uma transação proveniente dele. Uma carteira que ainda não esteja implantada não pode ser vinculada |
Multisig | Um cofre que exige a assinatura de vários proprietários não é prático neste caso: a mensagem permanece ativa por 5 minutos |
Um agente assina da mesma forma que assina um desafio de recuperação:
// viem
await account.signMessage({ message });
// ethers
await wallet.signMessage(message);O que mudou
O que | Após inserir os links |
|---|---|
Pedidos pagos após a inserção do link | visível no painel da conta, ao lado dos pedidos comprados lá |
Recargas pela carteira | acesse o saldo da conta |
Renovação automática desses pedidos | pago com o saldo da conta |
Pagamentos de pedidos | inalterado: USDC da carteira, o mesmo ciclo de duas solicitações |
Tokens de acesso | sem alterações: a API ainda realiza a autenticação por meio do token de acesso do pedido e da assinatura da carteira |
Recuperar acesso | o |
Retiradas | ainda solicitado apenas pela carteira, com uma assinatura (Retirar saldo), mas pagos com o saldo da conta, e apenas até o valor que essa carteira recarregou nessa conta, menos o que já foi sacado. O saldo que a carteira possuía antes da vinculação só poderá ser sacado após a desvinculação |
Essas ordens pertencem à conta: o proprietário as gerencia no painel de controle e por meio da API principal, e o agente continua gerenciando-as por meio da API x402 com seus tokens de acesso.
O que a carteira comprou antes
Os pedidos pagos antes do vinculamento e o saldo que a carteira possuía naquele momento permanecem na carteira: eles não são transferidos para a conta. O agente continua gerenciando esses pedidos por meio da API x402, como antes, e a renovação automática deles ainda é paga com esse saldo antigo. Enquanto a carteira estiver vinculada, Recuperar acesso mostra o saldo da conta, e o saldo antigo só pode ser sacado após o desvinculamento. Logo após o vinculamento, o painel mostra quanto restava nesse saldo.
Remover links
O proprietário pode desvincular a carteira a qualquer momento, e a carteira não assina nada para isso. Após a desvinculação, novos pagamentos provenientes da carteira voltam a ser de sua propriedade, enquanto os pedidos adquiridos enquanto ela estava vinculada e o dinheiro já creditado na conta permanecem na conta.
Uma carteira pertence a uma conta por vez: se estiver vinculada a outro lugar, é preciso desvinculá-la primeiro. Uma carteira bloqueada não pode ser vinculada de forma alguma — escreva para [email protected].