minia2a-skill 1.3.1 → 1.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -8
- package/cli/minia2a +6 -7
- package/package.json +2 -2
- package/wrappers/claude-code/SKILL.md +4 -4
package/README.md
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
**Agents can't open bank accounts. We fixed that.**
|
|
20
20
|
|
|
21
|
-
minia2a is an agent-only marketplace for x402 microservices — AI agents discover, call, and pay per call in USDC. No human signup, no KYC. Register with your own self-custody wallet for
|
|
21
|
+
minia2a is an agent-only marketplace for x402 microservices — AI agents discover, call, and pay per call in USDC. No human signup, no KYC. Register with your own self-custody wallet for 5 free trial calls, then call any of 1,680 endpoints. Sellers list an endpoint and earn USDC per call.
|
|
22
22
|
|
|
23
23
|
Built on [x402](https://x402.org/) (HTTP 402, Linux Foundation standard). [minia2a.uk](https://minia2a.uk) is the reference marketplace — this repo is the agent SDK.
|
|
24
24
|
|
|
@@ -31,7 +31,7 @@ curl -sSL https://minia2a.uk/install | bash
|
|
|
31
31
|
# Discover services
|
|
32
32
|
minia2a discover
|
|
33
33
|
|
|
34
|
-
# Register your wallet →
|
|
34
|
+
# Register your wallet → 5 free trial calls
|
|
35
35
|
minia2a register --name "My Agent" --wallet 0x... --signature 0x...
|
|
36
36
|
|
|
37
37
|
# Call a service (credits decrement per call)
|
|
@@ -85,8 +85,8 @@ and sign different messages — registering does not create a listing.
|
|
|
85
85
|
`call` signs a third, per-call message: `minia2a trial:<wallet>:<serviceId>:<unixSeconds>`.
|
|
86
86
|
The `serviceId` there is the catalog id (`x402-time`), **not** the URL slug (`time`) — signing
|
|
87
87
|
the slug fails with the same 402 a bad signature returns, so the CLI resolves the id for you and
|
|
88
|
-
prints the exact string to sign. Without `--signature`, `--wallet`
|
|
89
|
-
|
|
88
|
+
prints the exact string to sign. Without `--signature`, `--wallet` cannot draw on the wallet's
|
|
89
|
+
trial allowance — anonymous trials are disabled, so the call returns 402.
|
|
90
90
|
|
|
91
91
|
All commands output JSON. Exit code 0 = success. `--probe` returns the 402 payment JSON without consuming credits.
|
|
92
92
|
|
|
@@ -111,11 +111,11 @@ curl -sSL https://minia2a.uk/install | bash
|
|
|
111
111
|
# 2. Browse available services
|
|
112
112
|
minia2a discover
|
|
113
113
|
|
|
114
|
-
# 3. Register (self-custody wallet + EIP-191 signature) →
|
|
114
|
+
# 3. Register (self-custody wallet + EIP-191 signature) → 5 free trial calls
|
|
115
115
|
minia2a register --name "My Agent" --wallet 0x... --signature 0x...
|
|
116
116
|
|
|
117
|
-
# 4. Call a service.
|
|
118
|
-
#
|
|
117
|
+
# 4. Call a service. Run it once and the CLI prints the exact message to sign
|
|
118
|
+
# for the wallet's own 5 trial calls.
|
|
119
119
|
minia2a call x402-time --wallet 0x...
|
|
120
120
|
minia2a call x402-time --wallet 0x... --timestamp 1787113324 --signature 0x...
|
|
121
121
|
```
|
|
@@ -124,7 +124,7 @@ minia2a call x402-time --wallet 0x... --timestamp 1787113324 --signature 0x...
|
|
|
124
124
|
|
|
125
125
|
| Item | Amount |
|
|
126
126
|
|------|--------|
|
|
127
|
-
| Free
|
|
127
|
+
| Free trials | 5 calls on registration |
|
|
128
128
|
| Platform fee | 5% |
|
|
129
129
|
| Currency | USDC on Base (`eip155:8453`) + Algorand (ASA 31566704) |
|
|
130
130
|
| Price signal | HTTP 402 `accepts[].amount` (micro-units, e.g. `"100000"` = $0.10) |
|
package/cli/minia2a
CHANGED
|
@@ -19,8 +19,8 @@ Usage:
|
|
|
19
19
|
minia2a help [topic]
|
|
20
20
|
|
|
21
21
|
No human signup. Register with a self-custody wallet + EIP-191 signature
|
|
22
|
-
for
|
|
23
|
-
(HTTP 402) once
|
|
22
|
+
for 5 free trial calls. Pay per call in USDC via x402
|
|
23
|
+
(HTTP 402) once trials run out. Full guide: https://minia2a.uk/AGENTS.md
|
|
24
24
|
`;
|
|
25
25
|
|
|
26
26
|
function bail(msg, code = 1) {
|
|
@@ -206,7 +206,7 @@ async function call(id) {
|
|
|
206
206
|
const url = new URL(ep);
|
|
207
207
|
url.searchParams.set(probe ? 'probe' : 'wallet', probe ? '1' : wallet);
|
|
208
208
|
|
|
209
|
-
// A registered wallet's own
|
|
209
|
+
// A registered wallet's own 5 trials are only reachable with a signed call. The signed
|
|
210
210
|
// message uses the catalog id (x402-time), not the URL slug (time) — signing the slug fails
|
|
211
211
|
// with exactly the 402 a bad signature produces, so print the id-correct message rather than
|
|
212
212
|
// letting the caller guess it.
|
|
@@ -220,8 +220,7 @@ async function call(id) {
|
|
|
220
220
|
trialHeaders['X-Wallet-Signature'] = signature;
|
|
221
221
|
trialHeaders['X-Trial-Timestamp'] = ts;
|
|
222
222
|
} else {
|
|
223
|
-
console.error('Note: --wallet alone
|
|
224
|
-
console.error('will use the anonymous per-IP bucket. To use the wallet\'s own 15 trials, sign');
|
|
223
|
+
console.error('Note: --wallet alone cannot draw on the wallet\'s trial bucket — anonymous trials are disabled. To use the wallet\'s own 5 trials, sign');
|
|
225
224
|
console.error('this exact message (EIP-191 personal_sign):\n');
|
|
226
225
|
console.error(` minia2a trial:${wallet}:${svc.id}:${ts}\n`);
|
|
227
226
|
console.error('then rerun within 5 minutes:\n');
|
|
@@ -248,7 +247,7 @@ async function call(id) {
|
|
|
248
247
|
// Payment required — surface the machine-readable x402 payload.
|
|
249
248
|
console.error(`Payment required (HTTP 402) for ${svc.name}. Price: $${svc.price} USDC.`);
|
|
250
249
|
if (trialHeaders['X-Wallet-Signature']) {
|
|
251
|
-
console.error(`Signed as ${wallet}: either this wallet's
|
|
250
|
+
console.error(`Signed as ${wallet}: either this wallet's 5 trials are spent, or the wallet`);
|
|
252
251
|
console.error('is not registered, or the timestamp is older than 5 minutes.');
|
|
253
252
|
}
|
|
254
253
|
console.error('x402 accepts[]:');
|
|
@@ -273,7 +272,7 @@ async function help() {
|
|
|
273
272
|
console.error(`minia2a help: ${topic}\n`);
|
|
274
273
|
console.error('The full machine-readable guide lives at https://minia2a.uk/AGENTS.md');
|
|
275
274
|
console.error('Quick reference:');
|
|
276
|
-
console.error(' register — POST /api/v1/register-simple {name, wallet, signature} →
|
|
275
|
+
console.error(' register — POST /api/v1/register-simple {name, wallet, signature} → 5 free trial calls (BUYER side)');
|
|
277
276
|
console.error(' publish — POST /api/v1/publish-service {name, endpoint, price_cents, category, wallet, signature} (SELLER side)');
|
|
278
277
|
console.error(' call — GET <service-endpoint>?wallet=0x... (credits decrement)');
|
|
279
278
|
console.error(' probe — append ?probe=1 to any endpoint → HTTP 402 with payment JSON (free)');
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "minia2a-skill",
|
|
3
|
-
"version": "1.3.
|
|
4
|
-
"description": "Agent skill for minia2a.uk — 1,
|
|
3
|
+
"version": "1.3.2",
|
|
4
|
+
"description": "Agent skill for minia2a.uk — 1,680 x402 services. AI agents earn USDC. 5 free trial calls. Zero-dep CLI. Try: npm i -g minia2a-cli.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"minia2a": "./cli/minia2a"
|
|
7
7
|
},
|
|
@@ -3,20 +3,20 @@ name: minia2a-skill
|
|
|
3
3
|
description: >
|
|
4
4
|
Discover and call x402 pay-per-call APIs on minia2a.uk — the agent-only marketplace.
|
|
5
5
|
1,600+ endpoints (AI inference, crypto data, web scraping, CAPTCHA solving, more).
|
|
6
|
-
Register with a self-custody wallet + signature for
|
|
6
|
+
Register with a self-custody wallet + signature for 5 free trial calls. USDC on Base + Algorand.
|
|
7
7
|
Commands: discover, call, register, meta, help.
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# minia2a-skill (Claude Code wrapper)
|
|
11
11
|
|
|
12
|
-
Discover and call x402 microservices on the minia2a.uk marketplace. Pay per call in USDC — no human signup, no KYC. Register with your own wallet (the platform never holds your key) for
|
|
12
|
+
Discover and call x402 microservices on the minia2a.uk marketplace. Pay per call in USDC — no human signup, no KYC. Register with your own wallet (the platform never holds your key) for 5 free trial calls.
|
|
13
13
|
|
|
14
14
|
## Commands (shell-executable, JSON output)
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
17
|
npx minia2a-skill discover [query] [--category <cat>] [--sort volume|price] # list services
|
|
18
18
|
npx minia2a-skill meta # x402 discovery doc
|
|
19
|
-
npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...> #
|
|
19
|
+
npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...> # 5 free trial calls
|
|
20
20
|
npx minia2a-skill call <service-id> --wallet <0x...> [--input '<json>'] [--probe]
|
|
21
21
|
npx minia2a-skill help
|
|
22
22
|
```
|
|
@@ -25,7 +25,7 @@ npx minia2a-skill help
|
|
|
25
25
|
|
|
26
26
|
1. **Discover:** `npx minia2a-skill discover "gas price"`
|
|
27
27
|
2. **Probe price (free):** `npx minia2a-skill call <id> --probe` → HTTP 402 `accepts[]` (`amount` = micro-units, `"100000"` = $0.10)
|
|
28
|
-
3. **Register:** user signs `minia2a register: <wallet>` (EIP-191 personal_sign), then `npx minia2a-skill register --name ... --wallet 0x... --signature 0x...` →
|
|
28
|
+
3. **Register:** user signs `minia2a register: <wallet>` (EIP-191 personal_sign), then `npx minia2a-skill register --name ... --wallet 0x... --signature 0x...` → 5 free trial calls
|
|
29
29
|
4. **Call:** `npx minia2a-skill call <id> --wallet 0x...` → credits decrement; HTTP 402 when exhausted
|
|
30
30
|
|
|
31
31
|
## Key facts
|