NullStateV1 commited on
Commit
7362aed
Β·
verified Β·
1 Parent(s): 923f409

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +31 -45
README.md CHANGED
@@ -6,52 +6,38 @@ colorTo: green
6
  sdk: static
7
  pinned: true
8
  license: mit
9
- short_description: Open-source x402 payment settlement layer for AI agents
10
  ---
11
 
12
  # NullState x402 Settlement Gateway
13
 
14
- **Open payment/settlement layer for AI agents.** HTTP 402 micropayments β†’ USDC settlement.
15
-
16
- ## Quick Demo
17
-
18
- ```bash
19
- curl -sk -X POST https://nullstate.ai/api/settlement/verify \
20
- -H 'Content-Type: application/json' \
21
- -d '{"hash":"<tx_hash>","asset":"USDC","network":"Solana","amount":4.99}'
22
- ```
23
-
24
- ## Features
25
- - **x402-native settlement**: 402 payment challenges β†’ on-chain USDC settlement
26
- - **Credit system**: Prepaid balance with auto-top-up
27
- - **AP2 protocol**: RSA-2048 signed fiat mandates
28
- - **Multi-chain**: USDC on Solana + Ethereum
29
-
30
- ## Endpoints (port 8080)
31
- | Endpoint | Method | Description |
32
- |----------|--------|-------------|
33
- | `/health` | GET | System status |
34
- | `/api/settlement/verify` | POST | Verify settlement |
35
- | `/api/v1/credits/add` | POST | Add credits |
36
- | `/api/v1/credits/deduct` | POST | Deduct credits |
37
- | `/api/v1/ap2/checkout` | POST | AP2 checkout |
38
- | `/api/v1/ap2/charge` | POST | AP2 charge |
39
-
40
- ## Integration
41
- ```python
42
- import requests
43
- resp = requests.post(
44
- "https://nullstate.ai/api/settlement/verify",
45
- json={"hash": "tx_xxx", "asset": "USDC", "network": "Solana", "amount": 4.99},
46
- verify=False
47
- )
48
- print(resp.json()) # {"success": true, "tx_id": "..."}
49
- ```
50
-
51
- ## Stack
52
- - Python 3.13, stdlib HTTPS server
53
- - SQLite (WAL mode) for ledger + task store
54
- - RSA-2048 for AP2 mandate signing
55
- - Rule-based lead scoring + outreach automation
56
-
57
- Built by [NullState Systems](https://github.com/NullStateGGH)
 
6
  sdk: static
7
  pinned: true
8
  license: mit
 
9
  ---
10
 
11
  # NullState x402 Settlement Gateway
12
 
13
+ **Open payment/settlement layer for AI agents.** Live on port 8080.
14
+
15
+ ## Quick Start
16
+ {
17
+ "success": true,
18
+ "tx_id": "1bdbdddc"
19
+ }
20
+
21
+ ## Endpoints
22
+ - `GET /health` β€” System status
23
+ - `POST /api/settlement/verify` β€” Verify x402 settlement
24
+ - `POST /api/v1/credits/add` β€” Add prepaid credits
25
+ - `POST /api/v1/credits/deduct` β€” Deduct credits
26
+ - `GET /api/v1/gcp/ecosystem` β€” GCP ecosystem status
27
+
28
+ ## Integration Partners Wanted
29
+ We're actively seeking integration partners for the x402 protocol.
30
+ - **solvela-ai/solvela** β€” AI agent sandbox platform
31
+ - **x402-gateway-template** β€” x402 payment gateway template
32
+ - **x402-payments-skill** β€” x402 payment skill
33
+ - **settlegrid** β€” Settlement grid infrastructure
34
+
35
+ Contact: https://github.com/NullStateGGH
36
+
37
+ ## Platform
38
+ - Google Cloud (GKE, Build, Storage, Vertex AI)
39
+ - GitHub (open-core development)
40
+ - HuggingFace (community + demos)
41
+ - Docker (container distribution)
42
+
43
+ Built by NullState Systems