JavaScript/TypeScript SDKs for GenesisPay — stablecoin payments over HTTP 402 (x402) that work for both humans and AI agents. USDC on Base; every amount is integer minor units, never floats.
| Package | What it does |
|---|---|
@genesis-tech/genesispay-seller |
Framework-agnostic payment gate: wrap any Fetch-API handler (Next.js, Hono, Bun) and it becomes a paid x402 endpoint. |
@genesis-tech/genesispay-agent |
Agent-side client: pay x402-gated URLs from a policy-guarded agent wallet, discover payable services, handle human approvals. |
@genesis-tech/genesispay-mcp |
MCP stdio server (npx @genesis-tech/genesispay-mcp) exposing genesispay_discover / genesispay_pay / genesispay_payment_status / genesispay_account tools to Claude and other MCP clients. |
@genesis-tech/genesispay-protocol |
Pure x402 V2 types, header codecs, validators, and EIP-3009 typed-data helpers. Zero I/O. |
import { createPaymentGate, genesisPaySettlement } from "@genesis-tech/genesispay-seller";
const gate = createPaymentGate({
amountUsdc: "0.10",
payTo: "0xYourWallet",
description: "Premium market data",
network: "base-sepolia",
});
export const GET = gate.wrap(async () => Response.json({ data: "…" }), {
verifySettlement: genesisPaySettlement({
facilitatorBaseUrl: "https://your-genesispay-instance.example",
apiKey: process.env.GENESISPAY_SELLER_KEY!, // gp_sk_...
}),
});import { GenesisPayAgent } from "@genesis-tech/genesispay-agent";
const agent = new GenesisPayAgent(); // env: GENESISPAY_AGENT_KEY, GENESISPAY_BASE_URL
const [service] = await agent.discover("weather api");
const result = await agent.pay(service.resourceUrl, { maxAmountUsdc: "0.50" });
if (result.settled) console.log(result.json());
else console.log("Needs human approval:", result.approvalUrl);Spending caps, allowlists, and approvals are enforced server-side by GenesisPay — the agent key never holds a raw private key.
claude mcp add genesispay \
--env GENESISPAY_AGENT_KEY=gp_ag_your_key \
--env GENESISPAY_BASE_URL=https://your-genesispay-instance.example \
-- npx -y @genesis-tech/genesispay-mcpSee GenesisTechAT/genesispay-agent-skill
for the full agent skill (discovery-then-pay pattern, approval handling) and
config snippets for other MCP clients.
npm ci
npm run build # tsc -b, dependency order
npm test # vitest, tests run from package sourcesNode >= 20.9. Each package builds to dist/ with tsc; tests are colocated
(src/*.test.ts).
This repository is a read-only publish mirror — development happens in the main GenesisPay repository and is synced here. Issues and PRs are welcome and are folded back upstream.
- Bump versions in
packages/*/package.json. - Tag:
git tag v0.1.1 && git push origin v0.1.1. - The publish workflow builds, tests, and
publishes all packages to npm (requires the
NPM_TOKENrepo secret).
MIT © GenesisTech