Collegamento a un account
Updated:
Un portafoglio effettua acquisti in modo autonomo: nulla di quanto riportato in questa pagina è necessario per utilizzare l’API x402. Tuttavia, quando l’agente effettua un pagamento per conto di un’azienda che dispone già di un account venditore proxy, il titolare di tale account può collegarvi il portafoglio dell’agente. Da quel momento in poi, i nuovi ordini del portafoglio appariranno nella dashboard dell’account e le relative ricariche andranno ad aggiungersi al saldo di quell’account.
Il collegamento viene confermato da entrambe le parti: l’account tramite la sessione del suo proprietario, il wallet tramite una firma. La firma non comporta il trasferimento di fondi: non è una transazione, non comporta alcun costo in gas e non cambia la rete del wallet.
Il flusso
Il proprietario richiede un messaggio
Nella dashboard, nella sezione "Bilancio", il titolare inserisce l'indirizzo del portafoglio e riceve un messaggio monouso relativo a esso.
Il portafoglio lo conferma
personal_sign(EIP-191) del messaggio, esattamente come ricevuto. Il proprietario reinserisce la firma nella dashboard.Il portafoglio è collegato
D'ora in poi i nuovi ordini relativi a questo portafoglio appariranno nella dashboard dell'account e le relative ricariche andranno ad accreditarsi sul saldo dell'account.
Il messaggio
Il messaggio è un testo EIP-4361, dello stesso tipo Recupera l'accesso utilizza, emessi dalla dashboard anziché dall’API x402.
Proprietà | Valore |
|---|---|
Durata | 5 minuti, un utilizzo, assegnato a un account |
Firma |
|
Portafoglio standard | La firma viene verificata con |
Portafoglio per smart contract | Verificato tramite EIP-1271; il contratto deve essere già stato distribuito su Base — deve essere stata effettuata almeno una transazione da esso. Un portafoglio non ancora distribuito non può essere collegato |
Multisig | Una cassaforte che richiede la firma di più proprietari non è praticabile in questo contesto: il messaggio rimane attivo per 5 minuti |
Un agente lo firma nello stesso modo in cui firma una sfida di recupero:
// viem
await account.signMessage({ message });
// ethers
await wallet.signMessage(message);Cosa cambia
Cosa | Dopo aver inserito i link |
|---|---|
Ordini pagati dopo l'inserimento del link | visibile nella dashboard dell’account, accanto agli ordini acquistati lì |
Ricariche dal portafoglio | vai al saldo del conto |
Rinnovo automatico di questi ordini | pagato dal saldo del conto |
Pagamenti per gli ordini | invariato: USDC dal portafoglio, lo stesso ciclo di due richieste |
Token di accesso | invariato: l’API continua ad autorizzare tramite il token di accesso dell’ordine e la firma del portafoglio |
Recupera l'accesso | il |
Prelievi | richiesto ancora solo dal portafoglio, con una firma (Prelevare il saldo), ma prelevati dal saldo del conto, e solo fino all’importo che questo portafoglio ha versato su quel conto, al netto di quanto è già stato prelevato. Il saldo che il portafoglio aveva prima del collegamento può essere prelevato solo dopo aver annullato il collegamento |
Questi ordini appartengono all’account: il proprietario li gestisce nella dashboard e tramite l’API principale, mentre l’agente continua a gestirli tramite l’API x402 con i propri token di accesso.
Cosa si poteva comprare con il portafoglio in passato
Gli ordini pagati prima del collegamento e il saldo che il portafoglio presentava in quel momento rimangono nel portafoglio: non vengono trasferiti sul conto. L’agente continua a gestire tali ordini tramite l’API x402 come in precedenza, e il loro rinnovo automatico viene ancora pagato attingendo da quel vecchio saldo. Finché il portafoglio è collegato, Recupera l'accesso mostra invece il saldo del conto, e il vecchio saldo può essere prelevato solo dopo aver annullato il collegamento. Subito dopo il collegamento, la dashboard mostra quanto era rimasto su quel saldo.
Rimozione dei collegamenti
Il titolare può scollegare il portafoglio in qualsiasi momento, e il portafoglio non firma nulla a tal fine. Dopo lo scollegamento, i nuovi pagamenti provenienti dal portafoglio tornano ad essere di sua proprietà, mentre gli ordini acquistati mentre era collegato e il denaro già accreditato sul conto rimangono sul conto stesso.
Un portafoglio può essere associato a un solo account alla volta: se è collegato altrove, deve prima essere scollegato da lì. Un portafoglio bloccato non può essere collegato in alcun modo — scrivi a [email protected].