Von der Absicht zum Beweis.

Holen Sie sich einen API-Schlüssel

curl -X POST https://agenttrail.online/api/v1/accounts \
  -H 'Content-Type: application/json' -d '{}'

Die Antwort enthält account_id, key_id und ein einmaliges api_key. Bewahren Sie es sicher auf. Durch die Kontoerstellung und die Ausgabe neuer Schlüssel werden bei jedem erfolgreichen Anruf neue Anmeldeinformationen erstellt. Sie sind keine Wiedergabeendpunkte. Verlorene Schlüssel können von diesem Entwicklungsdienst nicht wiederhergestellt werden. Geben Sie bereichsbezogene Agentenschlüssel über die Konsole aus.

1. Erfassen Sie die erwartete Zahlung

export AUDIT_KEY='<save the one-time API key securely>'
curl -X POST https://agenttrail.online/api/v1/audit/intents \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-intent-reference' \
  -d '{"agent_id":"research-01","network":"xrpl-testnet", "asset":{"type":"native","currency":"XRP"},"expected_amount":"1","recipient":"<recipient classic address>","purpose":"purchase_market_data"}'

Beträge sind Dezimalzeichenfolgen. Testnet und Mainnet können nicht gemischt werden. Zweck und Agentenidentität sind Erklärungen, kein Nachweis der Berechtigung. Optionales payer_address ermöglicht den Absenderabgleich; Ohne sie wird die Zahlerübereinstimmung nicht überprüft. Verwenden Sie context_hash für sensible Aufgabenkontexte.

2. Bezahlen Sie extern und übermitteln Sie dann den Hash

Ihr eigener Testnet-Zahlungscode sendet die Zahlung. Senden Sie dem Dienst niemals einen Wallet-Seed oder privaten Schlüssel.

curl -X POST https://agenttrail.online/api/v1/audit/transactions \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-payment-reference' \
  -d '{"audit_id":"<audit_id>","network":"xrpl-testnet","tx_hash":"<64-character hash>"}'

Eine 202-Antwort bedeutet, dass die Verifizierung aussteht. Wiederholen Sie Audit-Schreibvorgänge mit demselben Idempotency-Key und Anforderungstext nach Transportfehlern. Die Wiederverwendung eines Schlüssels mit einem anderen Körper gibt 409 zurück.

3. Status prüfen, herunterladen und unabhängig verifizieren

curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>
curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>/report -o audit.json

Zahlungsstatus und Ankerstatus sind getrennt. Nur anchor_validated stellt eine abgeschlossene Verankerung her. Heruntergeladene Berichte stehen möglicherweise noch aus; Die unabhängige Überprüfung muss dann eindeutig scheitern. Verwenden Sie die Seite „Überprüfen“ lokal oder führen Sie scripts/verify_report.py aus dem Repository aus.

Fehler und Supportgrenzen

400: ungültige Eingabe, falsches Netzwerk oder deaktivierter Aussteller. 401: ungültiger/widerrufener Schlüssel. 403: unzureichender Umfang. 404: fehlender oder unzugänglicher Datensatz. 409: Idempotenz-/Transaktionskonflikt oder Bericht nicht bereit. 413: Körper zu groß. 429: Kontingent überschritten, später erneut versuchen. 503: Speicher/Anbieter nicht verfügbar; Versuchen Sie es sicher noch einmal.

Unterstützte Zahlungsinterpretation: direkte XRP- und aktivierte RLUSD-Vermögenswerte. Erfolgreiche Teilzahlungen verwenden die bereitgestellten Metadaten, niemals den angeforderten Betrag. Komplexe Pfade, Konvertierungen und Nichtzahlungstransaktionen werden nicht unterstützt. Knoten-Timeouts bleiben ausstehend und erfordern möglicherweise eine Wiederherstellung durch den Bediener aus der Warteschlange für unzustellbare Nachrichten.

Beweis- und Datenschutzgrenzen

Berichte und Erklärungen sind für Ihr Konto privat. Öffentliche Beweise legen Hashes und minimale Batch-/Netzwerkinformationen offen. Ein Anker beweist die Integrität einer bereitgestellten Datei, nicht deren Ansprüche, Lieferung oder Deckung jeder Zahlung. Die Plattformverankerung verwendet einen dedizierten eingeschränkten Testnet-Signer, explizite Budgets und einen Schritt zur Betreiberaktivierung.