@userill/spend

Typed wallet client for Rill Spend.

Agents can also pay with MCP rill_pay_url or POST /spend/pay-url. Use this kit when you want a typed client.

Docs: userill.com/docs/spend

Install

npm i @userill/spend

Usage

import { RillSpendClient } from "@userill/spend";

const spend = new RillSpendClient(
  "https://api.userill.com",
  process.env.RILL_VW_KEY!,
);

const paid = await spend.payUrl({
  url: "https://api.userill.com/r/your-gate",
  max_amount_cents: 25,
  idempotency_key: "pay-1",
});

payUrl is the primary path (MPP / x402 against any HTTPS URL). pay() is the background ledger / handle transfer.

Publish

Create the @rill org on npm (once), then:

pnpm test:unit && pnpm publish --access public

License

MIT