minia2a-skill 1.3.2 → 1.3.4

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 5 free trial calls, then call any of 1,680 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. Sign with your own self-custody wallet for 5 free trial calls (no registration), 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,10 +31,10 @@ curl -sSL https://minia2a.uk/install | bash
 # Discover services
 minia2a discover
 
-# Register your wallet → 5 free trial calls
+# Sign your wallet for 5 free trial calls (no registration)
 minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
-# Call a service (credits decrement per call)
+# Call a service (signed wallet → 5 free trials)
 minia2a call x402-time --wallet 0x...
 ```
 
@@ -63,7 +63,7 @@ sequenceDiagram
     Platform->>Buyer: 6. Result
 ```
 
-Every call is priced in the 402 response. The buyer pays USDC (or spends free credits); the seller earns per call. **5% platform fee.**
+Every call is priced in the 402 response. The buyer pays USDC (or uses a free trial call); the seller earns per call. **5% platform fee.**
 
 ## CLI Reference
 
@@ -78,7 +78,7 @@ minia2a call <id> --wallet <0x...> [--signature <0x...> --timestamp <unix>] \
 minia2a help
 ```
 
-`register` is the **buyer** side (it provisions free credits). `publish` is the
+`register` is the **buyer** side (proves wallet ownership, for publishing). `publish` is the
 **seller** side (it lists your API for pay-per-call). They are different endpoints
 and sign different messages — registering does not create a listing.
 
@@ -111,7 +111,7 @@ curl -sSL https://minia2a.uk/install | bash
 # 2. Browse available services
 minia2a discover
 
-# 3. Register (self-custody wallet + EIP-191 signature) → 5 free trial calls
+# 3. Sign (self-custody wallet + EIP-191 signature) → 5 free trial calls
 minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
 # 4. Call a service. Run it once and the CLI prints the exact message to sign
@@ -124,7 +124,7 @@ minia2a call x402-time --wallet 0x... --timestamp 1787113324 --signature 0x...
 
 | Item | Amount |
 |------|--------|
-| Free trials | 5 calls on registration |
+| Free trials | 5 calls per signed wallet (no 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

@@ -18,8 +18,8 @@ Usage:
                             [--input <json>] [--probe]
   minia2a help [topic]
 
-No human signup. Register with a self-custody wallet + EIP-191 signature
-for 5 free trial calls. Pay per call in USDC via x402
+No human signup. Sign with a self-custody wallet + EIP-191 signature for
+5 free trial calls (no registration). Pay per call in USDC via x402
 (HTTP 402) once trials run out. Full guide: https://minia2a.uk/AGENTS.md
 `;
 
@@ -113,7 +113,7 @@ async function register() {
   }
 }
 
-// Seller path. `register` above is BUYER-side (it provisions credits, not a listing) —
+// Seller path. `register` above proves wallet ownership (BUYER-side, not a listing) —
 // publishing a service is a different endpoint with a different signed message.
 const CATEGORIES = ['tools', 'premium', 'defi', 'data'];
 
@@ -206,7 +206,7 @@ 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
+  // A wallet's own 5 trials (no registration) 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.
@@ -247,8 +247,8 @@ async function call(id) {
       // 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(`Signed as ${wallet}: either this wallet's 5 trials are spent, or the`);
+        console.error('signature is invalid, or the timestamp is older than 5 minutes.');
       }
       console.error('x402 accepts[]:');
       json(d);
@@ -272,9 +272,9 @@ 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} → 5 free trial calls (BUYER side)');
+    console.error('  register — POST /api/v1/register-simple {name, wallet, signature} → prove wallet ownership (for publishing)');
     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('  call     — GET <service-endpoint>?wallet=0x... + signed trial headers (5 free trials per wallet)');
     console.error('  probe    — append ?probe=1 to any endpoint → HTTP 402 with payment JSON (free)');
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minia2a-skill",
-  "version": "1.3.2",
+  "version": "1.3.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.",
   "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 5 free trial calls. USDC on Base + Algorand.
+  Sign with a self-custody wallet for 5 free trial calls (no registration). 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 5 free trial calls.
+Discover and call x402 microservices on the minia2a.uk marketplace. Pay per call in USDC — no human signup, no KYC. Sign with your own wallet (the platform never holds your key) for 5 free trial calls (no registration).
 
 ## 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...>    # 5 free trial calls
+npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...>    # prove wallet ownership (publishing)
 npx minia2a-skill call <service-id> --wallet <0x...> [--input '<json>'] [--probe]
 npx minia2a-skill help
 ```
@@ -25,8 +25,8 @@ 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...` → 5 free trial calls
-4. **Call:** `npx minia2a-skill call <id> --wallet 0x...` → credits decrement; HTTP 402 when exhausted
+3. **Sign for trials:** user signs `minia2a trial:<wallet>:<svc-id>:<ts>` (EIP-191 personal_sign), then `npx minia2a-skill call <id> --wallet 0x... --signature 0x... --timestamp <ts>` → 5 free trial calls
+4. **Call:** `npx minia2a-skill call <id> --wallet 0x... --signature 0x... --timestamp <ts>` → trials decrement; HTTP 402 when exhausted
 
 ## Key facts