minia2a-client

One-call access to 150+ AI agent tools via x402 USDC micropayments on Base L2. No API keys, no KYC, no signup — agents pay per call with USDC.

Install

npm install minia2a-client

Quick start

const minia2a = require("minia2a-client");

// Auto-register (creates wallet, 500 free credits ~$2.50)
const wallet = await minia2a.getOrCreateWallet();
console.log("Wallet:", wallet.address, "| Credits:", wallet.credits);

// Call any service — payment is automatic from credits
const gas = await minia2a.call("gas");
console.log("Base gas:", gas);

const price = await minia2a.call("dex-price", { address: "0x..." });
console.log("Token price:", price);

// List all 150+ services
const services = await minia2a.listServices();
console.log(services.length, "services available");

CLI

npx minia2a gas
npx minia2a captcha-solve --sitekey=XXX --url=https://example.com
npx minia2a token-security --address=0x...
npx minia2a list
npx minia2a status

Popular services

| Category | Services | |----------|----------| | Crypto | gas, dex-price, token-security, wallet-intel, funding-rate, polymarket | | Web | web-scrape, screenshot, fetch, pdf-text, dns, ip-lookup | | Data | summarize, sentiment, markdown, jwt-decode, base64, csv-json | | Security | captcha-solve, api-review, email-verify, url-safety |

How it works

1. Register — auto-creates a Base wallet with 500 free credits
2. Call — each service is an HTTP endpoint at https://minia2a.uk/x402/{service}
3. Pay — credits are deducted per call (1 credit = $0.005)
4. Buy more — 1 USDC = 200 credits when free credits run out

Documentation

• Full service catalog
• x402 protocol
• Credits system

License

MIT

Framework Integration

ElizaOS

import { call, getOrCreateWallet } from 'minia2a-client';

export const minia2aGasAction = {
  name: 'MINIA2A_GAS',
  description: 'Get current gas prices across chains',
  handler: async () => {
    await getOrCreateWallet();
    return call('gas');
  }
};

LangChain

import { DynamicTool } from 'langchain/tools';
import { call, getOrCreateWallet } from 'minia2a-client';

await getOrCreateWallet();

export const minia2aGasTool = new DynamicTool({
  name: 'minia2a_gas',
  description: 'Get current Base L2 gas prices. No input needed.',
  func: async () => JSON.stringify(await call('gas'))
});

Custom Agent (Node.js)

const minia2a = require('minia2a-client');

async function agentTask() {
  const wallet = await minia2a.getOrCreateWallet();
  const gas = await minia2a.call('gas');
  const token = await minia2a.call('token-security', { address: '0x...' });
  return { gas, token };
}

CLI (no code)

npx minia2a gas
npx minia2a captcha-solve --sitekey=SITEKEY --url=https://example.com
npx minia2a list
npx minia2a status

Ecosystem

• Genesis Registry — Immortalize your agent on-chain. 5-year preservation guarantee. Three tiers starting at /bin/bash.01.
• Agent Guide — Step-by-step tutorial: build an agent that pays for its own APIs.
• Live Stats — Real-time marketplace metrics.

Support

• Docs: https://minia2a.uk/x402-help.html
• Register: {"error":"one free account per IP. Shared IP? Generate wallet (node: ethers.Wallet.createRandom()), then POST /api/v1/register-user {name,wallet} + X-Wallet-Signature. See AGENTS.md","hint":"you already registered on 2026-07-29T05:28:06.676Z"}
• Issues: https://github.com/afu20260324/minia2a