Dari niat hingga bukti.

Dapatkan Kunci API

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

Responsnya berisi account_id, key_id, dan api_key satu kali. Simpan dengan aman. Pembuatan akun dan penerbitan kunci baru menciptakan kredensial baru pada setiap panggilan yang berhasil; mereka bukan titik akhir pemutaran ulang. Kunci yang hilang tidak dapat dipulihkan oleh layanan pengembangan ini. Terbitkan kunci Agen cakupan dari konsol.

1. Catat pembayaran yang diharapkan

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"}'

Jumlah adalah string desimal. Testnet dan Mainnet tidak dapat dicampur. Tujuan dan identitas Agen adalah pernyataan, bukan bukti otorisasi. payer_address opsional memungkinkan pencocokan pengirim; tanpanya, pencocokan pembayar tidak akan diperiksa. Gunakan context_hash untuk konteks tugas sensitif.

2. Bayar secara eksternal, lalu kirimkan hashnya

Kode pembayaran Testnet Anda sendiri yang mengirimkan pembayaran. Jangan pernah mengirimkan benih dompet atau kunci pribadi ke layanan.

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>"}'

Respons 202 berarti verifikasi tertunda. Coba lagi audit penulisan dengan Idempotency-Key yang sama dan minta isi setelah kesalahan pengangkutan. Menggunakan kembali kunci dengan isi yang berbeda akan menghasilkan 409.

3. Periksa status, unduh, dan verifikasi secara independen

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

Status pembayaran dan status jangkar terpisah. Hanya anchor_validated yang melakukan penahan lengkap. Laporan yang diunduh mungkin tertunda; verifikasi independen kemudian harus gagal dengan jelas. Gunakan halaman Verifikasi secara lokal atau jalankan scripts/verify_report.py dari repositori.

Kesalahan dan batasan dukungan

400: input tidak valid, jaringan salah, atau penerbit dinonaktifkan. 401: kunci tidak valid/dicabut. 403: cakupan tidak mencukupi. 404: catatan tidak ada atau tidak dapat diakses. 409: idempotensi/konflik transaksi atau laporan belum siap. 413: badan terlalu besar. 429: kuota terlampaui, coba lagi nanti. 503: penyimpanan/penyedia tidak tersedia; coba lagi dengan aman.

Interpretasi pembayaran yang didukung: aset XRP langsung dan RLUSD yang diaktifkan. Pembayaran sebagian yang berhasil menggunakan metadata yang dikirimkan, bukan Jumlah yang diminta. Jalur rumit, konversi, dan transaksi non-Pembayaran tidak didukung. Batas waktu node tetap tertunda dan mungkin memerlukan pemulihan operator dari antrian surat mati.

Batasan bukti dan privasi

Laporan dan deklarasi bersifat pribadi untuk akun Anda. Bukti publik mengekspos hash dan informasi batch/jaringan minimal. Sebuah jangkar membuktikan integritas catatan yang disediakan, bukan klaimnya, pengiriman atau cakupan setiap pembayaran. Penahan platform menggunakan penandatangan Testnet terbatas khusus, anggaran eksplisit, dan langkah pemberdayaan operator.