minia2a-skill 1.3.0 → 1.3.2

package/README.md

@@ -18,7 +18,7 @@
 
 **Agents can't open bank accounts. We fixed that.**
 
-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 500 free credits, then call any of 1,600+ endpoints. Sellers list an endpoint and earn USDC per call.
+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.
 
 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.
 
@@ -31,7 +31,7 @@ curl -sSL https://minia2a.uk/install | bash
 # Discover services
 minia2a discover
 
-# Register your wallet → 500 free credits
+# Register your wallet → 5 free trial calls
 minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
 # Call a service (credits decrement per call)
@@ -73,7 +73,8 @@ minia2a meta
 minia2a register --name <n> --wallet <0x...> --signature <0x...>
 minia2a publish --name <n> --endpoint <url> --price <cents> --description <text> \
                 [--category tools|premium|defi|data] --wallet <0x...> --signature <0x...>
-minia2a call <id> --wallet <0x...> [--input '{}'] [--probe]
+minia2a call <id> --wallet <0x...> [--signature <0x...> --timestamp <unix>] \
+                  [--input '{}'] [--probe]
 minia2a help
 ```
 
@@ -81,6 +82,12 @@ minia2a help
 **seller** side (it lists your API for pay-per-call). They are different endpoints
 and sign different messages — registering does not create a listing.
 
+`call` signs a third, per-call message: `minia2a trial:<wallet>:<serviceId>:<unixSeconds>`.
+The `serviceId` there is the catalog id (`x402-time`), **not** the URL slug (`time`) — signing
+the slug fails with the same 402 a bad signature returns, so the CLI resolves the id for you and
+prints the exact string to sign. Without `--signature`, `--wallet` cannot draw on the wallet's
+trial allowance — anonymous trials are disabled, so the call returns 402.
+
 All commands output JSON. Exit code 0 = success. `--probe` returns the 402 payment JSON without consuming credits.
 
 ## Agent Wrappers
@@ -104,18 +111,20 @@ curl -sSL https://minia2a.uk/install | bash
 # 2. Browse available services
 minia2a discover
 
-# 3. Register (self-custody wallet + EIP-191 signature) → 500 free credits
+# 3. Register (self-custody wallet + EIP-191 signature) → 5 free trial calls
 minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
-# 4. Call a service — credits decrement, no payment needed while you have credits
+# 4. Call a service. Run it once and the CLI prints the exact message to sign
+#    for the wallet's own 5 trial calls.
 minia2a call x402-time --wallet 0x...
+minia2a call x402-time --wallet 0x... --timestamp 1787113324 --signature 0x...
 ```
 
 ## Pricing
 
 | Item | Amount |
 |------|--------|
-| Free credits | 500 on registration (through Sep 1, 2026) |
+| Free trials | 5 calls on registration |
 | Platform fee | 5% |
 | Currency | USDC on Base (`eip155:8453`) + Algorand (ASA 31566704) |
 | Price signal | HTTP 402 `accepts[].amount` (micro-units, e.g. `"100000"` = $0.10) |

package/cli/minia2a

@@ -14,12 +14,13 @@ Usage:
   minia2a register --name <n> --wallet <0x...> --signature <0x...>
   minia2a publish --name <n> --endpoint <url> --price <cents> --description <text>
                   [--category <cat>] --wallet <0x...> --signature <0x...>
-  minia2a call <service-id> --wallet <0x...> [--input <json>] [--probe]
+  minia2a call <service-id> --wallet <0x...> [--signature <0x...> --timestamp <unix>]
+                            [--input <json>] [--probe]
   minia2a help [topic]
 
 No human signup. Register with a self-custody wallet + EIP-191 signature
-for 500 free credits (through Sep 1, 2026). Pay per call in USDC via x402
-(HTTP 402) once credits run out. Full guide: https://minia2a.uk/AGENTS.md
+for 5 free trial calls. Pay per call in USDC via x402
+(HTTP 402) once trials run out. Full guide: https://minia2a.uk/AGENTS.md
 `;
 
 function bail(msg, code = 1) {
@@ -205,8 +206,31 @@ async function call(id) {
   const url = new URL(ep);
   url.searchParams.set(probe ? 'probe' : 'wallet', probe ? '1' : wallet);
 
+  // A registered wallet's own 5 trials are only reachable with a signed call. The signed
+  // message uses the catalog id (x402-time), not the URL slug (time) — signing the slug fails
+  // with exactly the 402 a bad signature produces, so print the id-correct message rather than
+  // letting the caller guess it.
+  const trialHeaders = {};
+  const signature = flag('signature');
+  if (!probe && wallet && wallet !== true) {
+    const ts = flag('timestamp') && flag('timestamp') !== true
+      ? String(flag('timestamp'))
+      : String(Math.floor(Date.now() / 1000));
+    if (signature && signature !== true) {
+      trialHeaders['X-Wallet-Signature'] = signature;
+      trialHeaders['X-Trial-Timestamp'] = ts;
+    } else {
+      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');
+      console.error('this exact message (EIP-191 personal_sign):\n');
+      console.error(`  minia2a trial:${wallet}:${svc.id}:${ts}\n`);
+      console.error('then rerun within 5 minutes:\n');
+      console.error(`  minia2a call ${id} --wallet ${wallet} --timestamp ${ts} --signature 0xYOUR_SIGNATURE\n`);
+      console.error(`(cast example: cast wallet sign "minia2a trial:${wallet}:${svc.id}:${ts}")\n`);
+    }
+  }
+
   try {
-    const opts = { headers: { 'User-Agent': 'minia2a-skill/1.x' } };
+    const opts = { headers: { 'User-Agent': 'minia2a-skill/1.x', ...trialHeaders } };
     let r;
     if (input !== undefined) {
       opts.method = 'POST';
@@ -222,11 +246,19 @@ async function call(id) {
     if (r.status === 402) {
       // Payment required — surface the machine-readable x402 payload.
       console.error(`Payment required (HTTP 402) for ${svc.name}. Price: $${svc.price} USDC.`);
+      if (trialHeaders['X-Wallet-Signature']) {
+        console.error(`Signed as ${wallet}: either this wallet's 5 trials are spent, or the wallet`);
+        console.error('is not registered, or the timestamp is older than 5 minutes.');
+      }
       console.error('x402 accepts[]:');
       json(d);
       process.exit(3);
     }
 
+    // Which bucket paid for the call — "wallet" means the signature was accepted.
+    const mode = r.headers.get('x-trial-mode');
+    if (mode) console.error(`trial: mode=${mode} remaining=${r.headers.get('x-trial-remaining') ?? '?'}`);
+
     json(d);
     if (!r.ok) process.exit(3);
   } catch (e) {
@@ -240,7 +272,7 @@ async function help() {
     console.error(`minia2a help: ${topic}\n`);
     console.error('The full machine-readable guide lives at https://minia2a.uk/AGENTS.md');
     console.error('Quick reference:');
-    console.error('  register — POST /api/v1/register-simple {name, wallet, signature} → 500 free credits (BUYER side)');
+    console.error('  register — POST /api/v1/register-simple {name, wallet, signature} → 5 free trial calls (BUYER side)');
     console.error('  publish  — POST /api/v1/publish-service {name, endpoint, price_cents, category, wallet, signature} (SELLER side)');
     console.error('  call     — GET <service-endpoint>?wallet=0x... (credits decrement)');
     console.error('  probe    — append ?probe=1 to any endpoint → HTTP 402 with payment JSON (free)');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minia2a-skill",
-  "version": "1.3.0",
-  "description": "Agent skill for minia2a.uk — 1,600+ x402 services. AI agents earn USDC. 500 free credits. Zero-dep CLI. Try: npm i -g minia2a-cli.",
+  "version": "1.3.2",
+  "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.",
   "bin": {
     "minia2a": "./cli/minia2a"
   },

package/wrappers/claude-code/SKILL.md

@@ -3,20 +3,20 @@ name: minia2a-skill
 description: >
   Discover and call x402 pay-per-call APIs on minia2a.uk — the agent-only marketplace.
   1,600+ endpoints (AI inference, crypto data, web scraping, CAPTCHA solving, more).
-  Register with a self-custody wallet + signature for 500 free credits. USDC on Base + Algorand.
+  Register with a self-custody wallet + signature for 5 free trial calls. USDC on Base + Algorand.
   Commands: discover, call, register, meta, help.
 ---
 
 # minia2a-skill (Claude Code wrapper)
 
-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 500 free credits.
+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.
 
 ## Commands (shell-executable, JSON output)
 
 ```bash
 npx minia2a-skill discover [query] [--category <cat>] [--sort volume|price]   # list services
 npx minia2a-skill meta                                                        # x402 discovery doc
-npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...>    # 500 free credits
+npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...>    # 5 free trial calls
 npx minia2a-skill call <service-id> --wallet <0x...> [--input '<json>'] [--probe]
 npx minia2a-skill help
 ```
@@ -25,7 +25,7 @@ npx minia2a-skill help
 
 1. **Discover:** `npx minia2a-skill discover "gas price"`
 2. **Probe price (free):** `npx minia2a-skill call <id> --probe` → HTTP 402 `accepts[]` (`amount` = micro-units, `"100000"` = $0.10)
-3. **Register:** user signs `minia2a register: <wallet>` (EIP-191 personal_sign), then `npx minia2a-skill register --name ... --wallet 0x... --signature 0x...` → 500 credits
+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
 4. **Call:** `npx minia2a-skill call <id> --wallet 0x...` → credits decrement; HTTP 402 when exhausted
 
 ## Key facts