Link zu einem Account
Aktualisiert:
Ein Wallet kauft selbstständig ein – für die Nutzung der x402-API ist nichts auf dieser Seite erforderlich. Wenn der Agent jedoch für ein Unternehmen bezahlt, das bereits über ein Proxy-Verkäufer-Konto verfügt, kann der Inhaber dieses Kontos das Wallet des Agenten damit verknüpfen. Danach erscheinen neue Bestellungen der Wallet im Dashboard des Kontos, und die Aufladungen fließen auf das Guthaben dieses Kontos.
Die Verknüpfung wird von beiden Seiten bestätigt: das Konto durch die Sitzung seines Besitzers, die Wallet durch eine Signatur. Durch das Signieren werden keine Gelder bewegt: Es handelt sich nicht um eine Transaktion, es fallen keine Gas-Kosten an und das Netzwerk der Wallet wird nicht gewechselt.
Der Ablauf
Der Eigentümer bittet um eine Nachricht
Im Dashboard, im Bereich „Guthaben“, gibt der Inhaber die Adresse der Wallet ein und erhält dafür eine einmalige Nachricht.
Die Geldbörse unterschreibt
personal_sign(EIP-191) der Nachricht, genau so, wie sie empfangen wurde. Der Eigentümer fügt die Signatur wieder in das Dashboard ein.Die Geldbörse ist verknüpft
Ab sofort erscheinen neue Bestellungen dieser Geldbörse im Dashboard des Kontos, und die Aufladungen werden dem Kontostand gutgeschrieben.
Die Nachricht
Die Meldung ist ein EIP-4361-Text, also derselbe Typ Zugriff wiederherstellen Verwendung, die über das Dashboard statt über die x402-API erfolgt.
Eigenschaft | Wert |
|---|---|
Lebensdauer | 5 Minuten, einmalige Nutzung, für ein Konto |
Unterschrift |
|
Normale Geldbörse | Die Signatur wird überprüft mit |
Smart-Contract-Wallet | Überprüft gemäß EIP-1271; der Vertrag muss bereits auf „Base“ bereitgestellt worden sein – es muss mindestens eine Transaktion davon vorliegen. Eine Wallet, die noch nicht bereitgestellt wurde, kann nicht verknüpft werden. |
Multisig | Ein Tresor, für dessen Öffnung mehrere Besitzer unterschreiben müssen, ist hier unpraktisch: Die Nachricht bleibt 5 Minuten lang bestehen. |
Ein Agent signiert es auf dieselbe Weise, wie er eine Wiederherstellungsaufgabe signiert:
// viem
await account.signMessage({ message });
// ethers
await wallet.signMessage(message);Was ändert sich?
Was | Nach dem Einfügen des Links |
|---|---|
Bezahlte Aufträge nach Verlinkung | sichtbar im Dashboard des Kontos, neben den dort gekauften Aufträgen |
Aufladungen über das Wallet | Zum Kontostand |
Automatische Verlängerung dieser Aufträge | bezahlt vom Kontostand |
Zahlungen für Aufträge | unverändert: USDC aus der Wallet, derselbe Zwei-Anfragen-Zyklus |
Zugriffstoken | Unverändert: Die API führt die Autorisierung weiterhin anhand des Zugriffstokens der Bestellung und der Signatur der Wallet durch. |
Zugriff wiederherstellen | das |
Abhebungen | wird weiterhin nur vom Wallet angefordert, mit einer Signatur (Guthaben abheben), wird jedoch vom Kontostand ausgezahlt, und zwar nur bis zu dem Betrag, den diese Wallet auf dieses Konto aufgeladen hat, abzüglich der bereits abgehobenen Beträge. Der Kontostand, den die Wallet vor der Verknüpfung hatte, kann erst nach der Aufhebung der Verknüpfung abgehoben werden |
Diese Aufträge gehören zum Konto: Der Eigentümer verwaltet sie im Dashboard und über die Haupt-API, während der Agent sie weiterhin über die x402-API mit seinen Zugriffstoken verwaltet.
Was die Geldbörse zuvor gekauft hat
Bestellungen, die vor der Verknüpfung bezahlt wurden, sowie der zu diesem Zeitpunkt auf dem Wallet vorhandene Restbetrag verbleiben auf dem Wallet: Sie werden nicht auf das Konto übertragen. Der Agent verwaltet diese Bestellungen weiterhin wie bisher über die x402-API, und ihre automatische Verlängerung wird nach wie vor aus diesem alten Restbetrag bezahlt. Solange das Wallet verknüpft ist, Zugriff wiederherstellen zeigt stattdessen den Kontostand an, und der alte Kontostand kann erst nach der Aufhebung der Verknüpfung abgehoben werden. Unmittelbar nach der Verknüpfung zeigt das Dashboard an, wie viel von diesem Guthaben noch übrig war.
Entkopplung
Der Inhaber kann die Verknüpfung der Geldbörse jederzeit aufheben, und die Geldbörse unterzeichnet dafür nichts. Nach der Aufhebung der Verknüpfung gehören neue Zahlungen aus der Geldbörse wieder ihr selbst, während die während der Verknüpfung gekauften Bestellungen und das bereits dem Konto gutgeschriebene Geld beim Konto verbleiben.
Ein Wallet gehört jeweils nur zu einem Konto: Wenn es an anderer Stelle verknüpft ist, muss die Verknüpfung dort zunächst aufgehoben werden. Ein gesperrtes Wallet kann überhaupt nicht verknüpft werden – schreiben Sie an [email protected].