else-payment-kit

Polygon payment request primitives for agents and bots.

else-payment-kit is a small TypeScript package for defining payment requests, rendering them for humans, and building/parsing Polygon payment URLs for native POL and ERC20 transfers. It is meant for agentic workflows where one agent or service needs to hand another a concrete payment instruction without dragging in a full wallet SDK.

Agent metadata

• Built for: OpenClaw agents, autonomous agents, and developers building payment-aware agent workflows
• Category: payment infrastructure
• Use cases: payment request envelopes, Polygon transfer URLs, agent settlement instructions, maker/taker settlement handoffs
• Runtime: Node.js / TypeScript

Install

Clone the repo and install dependencies:

git clone https://github.com/Else-Ventures/else-payment-kit.git
cd else-payment-kit
npm install
npm run build

npm publish coming once v1 is reviewed and stable.

What v1 does

V1 is intentionally narrow:

• define a typed Polygon payment request schema
• build Polygon payment URLs for native and ERC20 transfers
• parse those URLs back into structured requests
• render a human-readable payment request for operators or agents

V1 does not include:

• onchain execution
• escrow contracts
• wallet management
• private settlement logic

API

createPaymentRequest(request: PaymentRequest): PaymentRequest
buildPaymentUrl(request: PaymentRequest): string
parsePaymentUrl(url: string, assetHint?: PaymentRequest['asset']): PaymentRequest
renderPaymentRequest(request: PaymentRequest): string

Example

import { buildPaymentUrl, createPaymentRequest } from '@else-ventures/else-payment-kit';

const request = createPaymentRequest({
  version: '0.1',
  network: 'polygon',
  chain_id: 137,
  asset: {
    kind: 'erc20',
    symbol: 'USDC',
    token_address: '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359',
    decimals: 6,
  },
  recipient: '0x1111111111111111111111111111111111111111',
  amount: '15.75',
  reference: 'maker-001',
});

const url = buildPaymentUrl(request);
console.log(url);

Development

npm install
npm test
npm run build
npm run example