Dua alur mikropembayaran: bayar-per-permintaan dan saldo prabayar
Apakah agen Anda membayar per panggilan atau mendanai saldo terlebih dahulu, gateway menangani pembuatan faktur, verifikasi on-chain, dan proxy upstream secara otomatis.
Bayar-per-permintaan
Klien mengakses endpoint yang dilindungi dan menerima 402 dengan faktur. Membayar on-chain, lalu mencoba lagi dengan header X-Payment-Proof. Gateway memverifikasi transaksi di Neutaro dan meneruskan ke upstream.
Saldo prabayar
Klien menyetor NTMPI sekali via /prepaid/deposit. Permintaan berikutnya menyertakan header X-Client-Id dan gateway memotong per panggilan — tanpa transaksi on-chain berulang.
Dibangun untuk agen AI dan perdagangan mesin-ke-mesin
Semua yang dibutuhkan lapisan mikropembayaran, tidak lebih.
Verifikasi on-chain
Mengkueri Neutaro REST API untuk mengonfirmasi jumlah, memo, dan konfirmasi blok.
Penetapan harga per-rute
Harga default dengan override per-rute via GATEWAY_ROUTES. Pembacaan murah, penulisan mahal.
API Manajemen
Endpoint yang dilindungi JWT untuk dompet internal, transaksi, dan ledger blockchain ringan.
Reverse proxy
Meneruskan permintaan terautentikasi ke API upstream Anda secara transparan. Backend apa pun, bahasa apa pun.
Penyimpanan SQLite
Faktur, saldo prabayar, dan log pembayaran disimpan secara lokal dalam satu file. Nol dependensi eksternal.
Siap Docker
Deploy satu perintah dengan docker compose up. Skrip deploy Ubuntu disertakan.
Referensi endpoint API gateway
Endpoint gratis untuk health check, pencarian faktur, dan kueri saldo. Lainnya melewati gate 402.
Gratis — tanpa pembayaran
| Metode | Path | Deskripsi |
|---|---|---|
| GET | /health | Health check dengan konfigurasi gateway |
| GET | /invoices/:id | Periksa status faktur (memicu verifikasi on-chain) |
| POST | /prepaid/deposit | Daftarkan deposit (verifikasi tx on-chain terlebih dahulu) |
| GET | /prepaid/balance/:clientId | Periksa saldo prabayar |
Manajemen — dilindungi JWT
| Metode | Path | Deskripsi |
|---|---|---|
| POST | /manage/auth/register | Daftarkan akun admin |
| POST | /manage/auth/login | Login, dapatkan token JWT |
| POST | /manage/wallet | Buat dompet internal |
| GET | /manage/wallet | Daftar dompet Anda |
| GET | /manage/wallet/:id | Dapatkan dompet berdasarkan ID |
| POST | /manage/transactions | Buat transaksi internal |
| GET | /manage/transactions/:id | Dapatkan transaksi berdasarkan ID |
Gate 402 — catch-all
| Metode | Path | Deskripsi |
|---|---|---|
| ANY | /* | Semua permintaan lain memerlukan pembayaran atau saldo prabayar |
Integrasi agen: contoh Python dan TypeScript
Hubungkan alur 402 ke agen mana pun dalam beberapa baris. Gateway menangani faktur dan verifikasi — kode Anda hanya perlu membayar dan mencoba lagi.
import requests, subprocess, os res = requests.get("http://gateway:4020/api/data") if res.status_code == 402: inv = res.json()["payment"] # Pay with ClawPurse subprocess.run([ "clawpurse", "send", inv["address"], inv["amount"], "--memo", inv["memo"], "--yes" ]) # Retry with proof res = requests.get( "http://gateway:4020/api/data", headers={"X-Payment-Proof": inv["invoiceId"]} ) data = res.json()
async function paidFetch(url: string) { let res = await fetch(url); if (res.status === 402) { const { payment } = await res.json(); // Pay with ClawPurse const { send, loadKeystore } = await import("clawpurse"); const { wallet, address } = await loadKeystore( process.env.CLAWPURSE_PASSWORD! ); await send( wallet, address, payment.address, payment.amount, { memo: payment.memo } ); // Retry with proof res = await fetch(url, { headers: { "X-Payment-Proof": payment.invoiceId } }); } return res.json(); }
Instal dan jalankan gateway dalam waktu kurang dari satu menit
# Clone and install git clone https://github.com/mhue-ai/clawpurse-gateway.git cd clawpurse-gateway && npm install # Configure cp .env.example .env # Set GATEWAY_PAYMENT_ADDRESS and JWT_SECRET # Start a test upstream npm run test:upstream # Start the gateway npm run dev # Test the 402 flow curl http://localhost:4020/api/test # Pay, then retry with proof: curl -H "X-Payment-Proof: <invoiceId>" \ http://localhost:4020/api/test
Arsitektur microservice TypeScript
Codebase TypeScript terfokus — logika gateway, empat layanan internal, dan middleware. 46 unit test mencakup setiap lapisan.
Konfigurasi gateway melalui variabel lingkungan
Semua pengaturan melalui variabel lingkungan atau file .env.
| Variabel | Default | Deskripsi |
|---|---|---|
| PORT | 4020 | Port listen gateway |
| GATEWAY_UPSTREAM | http://localhost:3000 | API upstream untuk diproxy |
| GATEWAY_PAYMENT_ADDRESS | — | Alamat dompet Neutaro Anda (wajib) |
| GATEWAY_DEFAULT_PRICE | 0.001 | Harga default per permintaan dalam NTMPI |
| GATEWAY_ROUTES | — | Override harga per rute |
| GATEWAY_REST | https://api2.neutaro.io | Endpoint Neutaro REST API |
| GATEWAY_MIN_CONFIRMATIONS | 1 | Konfirmasi blok yang diperlukan |
| GATEWAY_INVOICE_TTL | 300 | Validitas faktur dalam detik |
| GATEWAY_PREPAID | false | Aktifkan sistem saldo prabayar |
| GATEWAY_DB | ./gateway.db | Path database SQLite |
| JWT_SECRET | — | Secret untuk JWT API manajemen (wajib) |
Bagian dari ekosistem Timpi, Neutaro & ClawPurse
Dompet ClawPurse
Dompet NTMPI lokal dengan keystore terenkripsi, pagar pengaman, staking, dan daftar tujuan. Klien referensi untuk pembayaran gateway.
Blockchain Neutaro
Chain Cosmos SDK yang menggerakkan NTMPI. Semua pembayaran gateway diverifikasi langsung terhadap Neutaro REST API — tanpa oracle, tanpa bridge.
Jaringan Timpi
Pencarian terdesentralisasi yang mengutamakan privasi, API data terbuka, dan node DePIN. Monetisasi layanan Timpi via mikropembayaran.
Faucet Timpi Drip
Faucet NTMPI ramah agen dengan tantangan proof-of-work. Agen OpenClaw mendapat throughput lebih tinggi.
Ledger Timpi
Free NTMPI cost basis calculator and tax tool. Auto-fetches transfers, staking rewards, and node payouts from the Neutaro chain — calculates USD cost basis with FIFO/LIFO/HIFO and generates IRS Form 8949.
x402 Payment Protocol
Coinbase's open HTTP 402 standard routes every payment through a centralized facilitator that controls settlement. ClawPurse Gateway takes the opposite approach: peer-to-peer payments verified directly on Neutaro — no middleman, no EVM lock-in, no Coinbase SDK. Add prepaid balances for zero-latency repeat access, route-level pricing in one env var, and a full audit trail in SQLite. One Docker command to deploy; zero external dependencies to operate.
Pertanyaan yang sering diajukan
Apa itu ClawPurse Gateway?
Reverse proxy HTTP open source yang mengimplementasikan 402 Payment Required untuk melindungi API dengan mikropembayaran NTMPI di Neutaro.
Bagaimana alur pembayaran HTTP 402 bekerja?
Klien menerima respons 402 dengan faktur, membayar on-chain, mencoba lagi dengan header X-Payment-Proof. Gateway memverifikasi dan meneruskan ke upstream.
Apa itu NTMPI dan bagaimana mendapatkannya?
NTMPI adalah token asli blockchain Neutaro, bagian dari jaringan pencarian Timpi . Dapatkan NTMPI gratis dari Faucet Timpi Drip, beli di MEXC via pasangan spot NTMPI/USDT, atau bridge via Gravity Bridge ke Osmosis dan tukar dengan dompet Keplr atau Leap.
Bisakah agen AI menggunakan gateway secara otonom?
Ya. Gateway dirancang untuk AI agentik. Agen dapat mem-parse faktur 402, membayar on-chain via API dompet ClawPurse, dan mencoba lagi dengan bukti pembayaran — tanpa intervensi manusia.
Traktir Mhue kopi Timpi ☕
Jika gateway menghemat waktu operasi Anda, beri tip kepada pembangun.
neutaro1e8xal8tqdegu4w48z3fphemd3hc07gech3pfek
Memo opsional — beritahu kami apa yang Anda luncurkan!