दो माइक्रोपेमेंट फ़्लो: पे-पर-रिक्वेस्ट और प्रीपेड बैलेंस
चाहे आपका एजेंट प्रति कॉल भुगतान करे या बैलेंस प्री-फ़ंड करे, गेटवे स्वचालित रूप से इनवॉइस, वेरिफ़िकेशन और प्रॉक्सी संभालता है।
पे-पर-रिक्वेस्ट
क्लाइंट गेटेड एंडपॉइंट पर पहुँचता है और इनवॉइस के साथ 402 प्राप्त करता है। ऑन-चेन भुगतान करता है, फिर X-Payment-Proof हेडर के साथ रीट्राई। गेटवे Neutaro पर सत्यापित करता है और अपस्ट्रीम को प्रॉक्सी करता है।
प्रीपेड बैलेंस
क्लाइंट /prepaid/deposit के ज़रिए एक बार NTMPI जमा करता है। बाद की रिक्वेस्ट X-Client-Id हेडर शामिल करती हैं — बार-बार ऑन-चेन ट्रांज़ैक्शन नहीं।
AI एजेंट और मशीन-टू-मशीन कॉमर्स के लिए निर्मित
माइक्रोपेमेंट लेयर को जो चाहिए वो सब, और कुछ नहीं।
ऑन-चेन वेरिफ़िकेशन
Neutaro REST API से भुगतान राशि, मेमो और ब्लॉक कन्फ़र्मेशन की पुष्टि।
रूट-लेवल प्राइसिंग
डिफ़ॉल्ट कीमत और GATEWAY_ROUTES से रूट-वार ओवरराइड। सस्ती रीड, महंगी राइट।
मैनेजमेंट API
आंतरिक वॉलेट, ट्रांज़ैक्शन और ब्लॉकचेन लेजर के लिए JWT-प्रोटेक्टेड एंडपॉइंट।
रिवर्स प्रॉक्सी
प्रमाणित रिक्वेस्ट को अपस्ट्रीम API पर पारदर्शी रूप से फ़ॉरवर्ड। कोई भी बैकएंड, कोई भी भाषा।
SQLite स्टोरेज
इनवॉइस, प्रीपेड बैलेंस और लॉग एक फ़ाइल में लोकली स्टोर। ज़ीरो एक्सटर्नल डिपेंडेंसी।
Docker-रेडी
docker compose up से एक कमांड डिप्लॉय। Ubuntu स्क्रिप्ट शामिल।
गेटवे API एंडपॉइंट रेफ़रेंस
हेल्थ चेक, इनवॉइस लुकअप और बैलेंस क्वेरी के लिए मुफ़्त एंडपॉइंट। बाकी सब 402 गेट से गुज़रता है।
मुफ़्त — भुगतान आवश्यक नहीं
| मेथड | पाथ | विवरण |
|---|---|---|
| GET | /health | गेटवे कॉन्फ़िग के साथ हेल्थ चेक |
| GET | /invoices/:id | इनवॉइस स्टेटस चेक (ऑन-चेन वेरिफ़िकेशन ट्रिगर) |
| POST | /prepaid/deposit | डिपॉज़िट रजिस्टर (पहले ऑन-चेन tx वेरिफ़ाई) |
| GET | /prepaid/balance/:clientId | प्रीपेड बैलेंस चेक |
मैनेजमेंट — JWT प्रोटेक्टेड
| मेथड | पाथ | विवरण |
|---|---|---|
| POST | /manage/auth/register | एडमिन अकाउंट रजिस्टर |
| POST | /manage/auth/login | लॉगिन, JWT टोकन प्राप्त करें |
| POST | /manage/wallet | आंतरिक वॉलेट बनाएं |
| GET | /manage/wallet | अपने वॉलेट की सूची |
| GET | /manage/wallet/:id | ID से वॉलेट प्राप्त करें |
| POST | /manage/transactions | आंतरिक ट्रांज़ैक्शन बनाएं |
| GET | /manage/transactions/:id | ID से ट्रांज़ैक्शन प्राप्त करें |
402 गेट — कैच-ऑल
| मेथड | पाथ | विवरण |
|---|---|---|
| ANY | /* | अन्य सभी रिक्वेस्ट के लिए भुगतान या प्रीपेड बैलेंस आवश्यक |
एजेंट इंटीग्रेशन: Python और TypeScript उदाहरण
कुछ लाइनों में 402 फ़्लो को किसी भी एजेंट में जोड़ें। गेटवे इनवॉइसिंग और वेरिफ़िकेशन संभालता है।
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(); }
एक मिनट से कम में गेटवे इंस्टॉल और रन करें
# 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
TypeScript माइक्रोसर्विस आर्किटेक्चर
केंद्रित TypeScript कोडबेस — गेटवे लॉजिक, चार आंतरिक सेवाएं और मिडलवेयर। 46 यूनिट टेस्ट हर लेयर को कवर।
एनवायरनमेंट वेरिएबल से गेटवे कॉन्फ़िगरेशन
सभी सेटिंग एनवायरनमेंट वेरिएबल या .env फ़ाइल से।
| वेरिएबल | डिफ़ॉल्ट | विवरण |
|---|---|---|
| PORT | 4020 | गेटवे लिसनिंग पोर्ट |
| GATEWAY_UPSTREAM | http://localhost:3000 | प्रॉक्सी करने के लिए अपस्ट्रीम API |
| GATEWAY_PAYMENT_ADDRESS | — | आपका Neutaro वॉलेट एड्रेस (आवश्यक) |
| GATEWAY_DEFAULT_PRICE | 0.001 | प्रति रिक्वेस्ट डिफ़ॉल्ट कीमत (NTMPI) |
| GATEWAY_ROUTES | — | रूट प्राइसिंग ओवरराइड |
| GATEWAY_REST | https://api2.neutaro.io | Neutaro REST API एंडपॉइंट |
| GATEWAY_MIN_CONFIRMATIONS | 1 | आवश्यक ब्लॉक कन्फ़र्मेशन |
| GATEWAY_INVOICE_TTL | 300 | इनवॉइस वैधता (सेकंड) |
| GATEWAY_PREPAID | false | प्रीपेड बैलेंस सिस्टम सक्षम करें |
| GATEWAY_DB | ./gateway.db | SQLite डेटाबेस पाथ |
| JWT_SECRET | — | मैनेजमेंट API JWT सीक्रेट (आवश्यक) |
Timpi, Neutaro और ClawPurse इकोसिस्टम का हिस्सा
ClawPurse वॉलेट
एन्क्रिप्टेड कीस्टोर, गार्डरेल, स्टेकिंग और डेस्टिनेशन अलाउलिस्ट के साथ लोकल NTMPI वॉलेट। गेटवे पेमेंट का रेफ़रेंस क्लाइंट।
Neutaro ब्लॉकचेन
NTMPI को पावर करने वाली Cosmos SDK चेन। सभी गेटवे पेमेंट Neutaro REST API पर सीधे वेरिफ़ाई — कोई ऑरेकल नहीं, कोई ब्रिज नहीं।
Timpi नेटवर्क
प्राइवेसी-फ़र्स्ट डिसेंट्रलाइज़्ड सर्च, ओपन डेटा API और DePIN नोड। ClawPurse Gateway से Timpi सेवाओं को माइक्रोपेमेंट से मोनेटाइज़ करें।
Timpi Drip फ़ॉसेट
CAPTCHA की जगह प्रूफ़-ऑफ़-वर्क चैलेंज वाला एजेंट-फ़्रेंडली NTMPI फ़ॉसेट। OpenClaw प्रमाणित एजेंट को अधिक थ्रूपुट ड्रिप मिलता है।
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.
अक्सर पूछे जाने वाले सवाल
ClawPurse Gateway क्या है?
Neutaro ब्लॉकचेन पर NTMPI माइक्रोपेमेंट से किसी भी API को गेट करने वाला ओपन-सोर्स HTTP रिवर्स प्रॉक्सी जो 402 Payment Required को इम्प्लीमेंट करता है।
HTTP 402 पेमेंट फ़्लो कैसे काम करता है?
क्लाइंट को इनवॉइस के साथ 402 रिस्पॉन्स मिलता है, ऑन-चेन भुगतान करता है, X-Payment-Proof हेडर से रीट्राई करता है। गेटवे सत्यापित करता है और प्रॉक्सी करता है।
NTMPI क्या है और कैसे प्राप्त करें?
NTMPI Neutaro ब्लॉकचेन का नेटिव टोकन है, Timpi डिसेंट्रलाइज़्ड सर्च नेटवर्क का हिस्सा। Timpi Drip फ़ॉसेटसे मुफ़्त NTMPI प्राप्त करें, MEXC पर NTMPI/USDT स्पॉट पेयर से खरीदें, या Gravity Bridge से Osmosis पर ब्रिज करके Keplr या Leap वॉलेट से स्वैप करें।
क्या AI एजेंट ClawPurse Gateway को स्वायत्त रूप से उपयोग कर सकते हैं?
हां। गेटवे एजेंटिक AI के लिए डिज़ाइन किया गया है। एजेंट 402 इनवॉइस को प्रोग्रामैटिक रूप से पार्स करते हैं, ClawPurse वॉलेट APIसे ऑन-चेन भुगतान करते हैं और पेमेंट प्रूफ़ हेडर से रीट्राई करते हैं — बिना मानवीय हस्तक्षेप के।
Mhue को Timpi कॉफ़ी पिलाएं ☕
अगर गेटवे आपका समय बचा रहा है, बिल्डर्स को टिप दें।
neutaro1e8xal8tqdegu4w48z3fphemd3hc07gech3pfek
मेमो वैकल्पिक — बताएं आपने क्या शिप किया!