Einzahlungsautomatisierung betreiben, ohne einen Rate-Manager zu erfinden.
Eine Bot-Integration ist kein Browser-Flow mit entfernten Schaltflächen. Sie benötigt Duplikatprävention, neustart-sicheren Status, explizite Wallet-Verwahrung, Webhook-Verifizierung und eine klare Regel dafür, wann Liquidität privat sein sollte.
Bot-Sequenz
- 1Laden Sie einen Base-Wallet-Client aus Ihrer eigenen Signer-Infrastruktur.
- 2Rufen Sie deposits(walletAddress) auf, bevor Sie eine neue Einzahlung erstellen; verwenden Sie aktives Inventar wieder, wenn es zur Order passt.
- 3Rufen Sie offramp(walletClient, params) mit integratorId und referralId auf, damit die Automatisierung identifiziert werden kann.
- 4Verwenden Sie otcTaker, wenn der Käufer bereits bekannt ist; andernfalls ist die Einzahlung öffentlich ausführbar.
- 5Speichern Sie depositId, txHash, Plattform, Währung, Betrag und den beabsichtigten Käuferkontext.
- 6Registrieren Sie HMAC-Webhooks, damit Ausführungen und Schließungen Prozessneustarts überstehen.
Wiederholungsdisziplin
- Das SDK setzt nicht delegierte Einzahlungen durch Delegierung fort, anstatt ein Duplikat zu erstellen.
- Das browserbasierte idempotencyKey-Caching schützt keine Node-Worker. Ihr Worker sollte deposits(address) prüfen, bevor er neue Liquidität erstellt.
- Wenn die Delegierung nach der Erstellung fehlschlägt, wiederholen Sie dieselbe Wallet-Route; der Resume-Pfad ist für diesen Status konzipiert.
- Wiederholen Sie USER_CANCELLED nicht automatisch. Dies zeigt an, dass ein Signierer eine Anfrage abgelehnt hat.
Nützliche Bot-Muster
Lohn- oder Auszahlungswarteschlange
Erstellen Sie eine private OTC-Einzahlung pro bekannter Käufer-Wallet und senden Sie dann den zurückgegebenen Link.
Treasury-Liquiditätsbot
Halten Sie eine kleine delegierte Einzahlung auf einer bevorzugten Route aufrecht und füllen Sie nach webhook-bestätigten Ausführungen auf.
Support-Abgleich
Verwenden Sie depositId und txHash als Support-Handles und gleichen Sie dann mit deposits(address) ab.
Keep exploring
Common questions
Kann ein Backend Einzahlungen ohne eine Nutzer-Wallet erstellen?
Ja, wenn es seinen eigenen Base-Signierer und USDC-Guthaben hat. Das SDK signiert über den viem WalletClient, den Sie bereitstellen; Verwahrung und Schlüsselverwaltung liegen bei Ihnen.
Verhindert idempotencyKey doppelte Bot-Einzahlungen?
Nein. idempotencyKey ist browser-session-basiert. In Node oder Workers verwenden Sie deposits(address) und Ihre eigene Auftragsdatenbank, um doppeltes Inventar zu verhindern.