https://github.com/piprail/piprail

Backendless, no-fee x402 payments across 24 chains — EVM, Solana, TON, Tron, NEAR, Sui, Stellar & XRPL. Install, name a chain, get paid straight to your wallet.
https://github.com/piprail/piprail

agent-payments ai-agents crypto-payments evm payments sdk solana stablecoin typescript usdc web3 x402

Last synced: about 1 month ago
JSON representation

Backendless, no-fee x402 payments across 24 chains — EVM, Solana, TON, Tron, NEAR, Sui, Stellar & XRPL. Install, name a chain, get paid straight to your wallet.

• Host: GitHub
• URL: https://github.com/piprail/piprail
• Owner: piprail
• License: mit
• Created: 2026-05-27T05:46:51.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-06-03T19:21:10.000Z (about 2 months ago)
• Last Synced: 2026-06-03T21:10:03.677Z (about 2 months ago)
• Topics: agent-payments, ai-agents, crypto-payments, evm, payments, sdk, solana, stablecoin, typescript, usdc, web3, x402
• Language: TypeScript
• Homepage: https://piprail.com
• Size: 1010 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

• awesome-x402 - PipRail - Backendless, no-fee x402 SDK for AI agents across 28 chains in 10 families (every major EVM chain plus Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar & XRPL). Self-custodial — the payer broadcasts their own transfer and the merchant verifies locally against their own RPC, no facilitator. Take payments (`requirePayment`) or make them (`PipRailClient`), with per-call/lifetime spend budgets and a `planPayment()` affordability + recipient-readiness preflight. ([npm](https://www.npmjs.com/package/@piprail/sdk)) (🛠️ SDKs & Client Libraries / JavaScript/TypeScript)
• awesome-hermes-agent - production - bound, self-custodial x402 payment wallet via `npx -y @piprail/mcp`. Lets Hermes autonomously pay 402 "Payment Required" URLs across EVM, Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar, and the XRP Ledger — funds settle straight to the merchant, no facilitator, no fee, capped by a spend policy the model cannot exceed. MIT. (Integrations & Bridges / Deployment)
• awesome-agentic-commerce - PipRail - Backendless, MIT TypeScript SDK for x402 across 28 chains in 10 families (EVM, Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar, XRPL). No facilitator, no fee — payments settle straight to your wallet, verified locally against your own RPC. ([npm](https://www.npmjs.com/package/@piprail/sdk)) (Uncategorized / Uncategorized)

README

          










[![@piprail/sdk](https://img.shields.io/npm/v/@piprail/sdk.svg?logo=npm&label=%40piprail%2Fsdk&color=cb3837)](https://www.npmjs.com/package/@piprail/sdk)

[![@piprail/mcp](https://img.shields.io/npm/v/@piprail/mcp.svg?logo=npm&label=%40piprail%2Fmcp&color=2ee6a6)](https://www.npmjs.com/package/@piprail/mcp)

[![types](https://img.shields.io/npm/types/@piprail/sdk.svg?logo=typescript&logoColor=white&color=3178c6)](https://www.npmjs.com/package/@piprail/sdk)

[![license](https://img.shields.io/github/license/piprail/piprail.svg?color=2ee6a6)](LICENSE)

[![x402 v2](https://img.shields.io/badge/x402-v2-6e56cf.svg)](https://x402.org)

[![chains](https://img.shields.io/badge/chains-28%20across%2010%20families-2ee6a6.svg)](#-supported-chains)

**Let any HTTP endpoint charge for itself, and any agent pay for itself — across 28 chains, in a couple of lines.**

[Website](https://piprail.com) · [npm](https://www.npmjs.com/package/@piprail/sdk) · [Full docs →](sdk/README.md)



---

`@piprail/sdk` implements the open [x402](https://x402.org) **"402 Payment Required"** standard with **no backend, no database, no account, and no fee**. Payments settle **straight into your wallet**, verified locally against your own RPC — across every major EVM chain plus **Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar & the XRP Ledger**.

```bash

npm install @piprail/sdk viem

```

### 💸 Charge for an endpoint

```ts

import { requirePayment } from '@piprail/sdk'

app.get('/report',

  requirePayment({ chain: 'base', token: 'USDC', amount: '0.05', payTo: '0xYourWallet…' }),

  (_req, res) => res.json({ report: 'TOP SECRET' }),

)

```

That route now costs **0.05 USDC on Base**, paid straight to your wallet. The first request gets a `402` with payment instructions; once the caller pays on-chain, it goes through. One parameter picks the chain.

### 🤖 Let an agent pay for it

```ts

import { PipRailClient } from '@piprail/sdk'

const client = new PipRailClient({ chain: 'base', wallet: { privateKey: process.env.AGENT_KEY } })

// Hits a 402, pays it on-chain, waits for confirmation, retries with proof — automatically.

const res = await client.fetch('https://api.example.com/report')

```

The same app can **take** payments and **make** them. Built for autonomous agents: install, add a wallet, monetize or pay — nothing else to wire up.

## 🌐 Supported chains

**28 chains across 10 families** — name one with a single `chain:` parameter. Non-EVM families lazy-load on first use, so a pure-EVM install never downloads their libraries.

| Family | Built-in chains | Tokens |

|---|---|---|

| **EVM** (19) | Ethereum · Base · Arbitrum · Optimism · Polygon · BNB · Avalanche · Mantle · Sonic · Linea · Scroll · Celo · zkSync · Unichain · World Chain · Sei · Injective · HyperEVM · Monad | USDC + USDT* |

| **Solana** | Solana | USDC · USDT |

| **TON** | The Open Network | USD₮ |

| **Tron** | Tron | USD₮ |

| **NEAR** | NEAR | USDC · USDT |

| **Sui** | Sui | USDC |

| **Aptos** | Aptos | USDC · USDT |

| **Algorand** | Algorand | USDC |

| **Stellar** | Stellar | USDC · EURC |

| **XRP Ledger** | XRPL | USDC · RLUSD |

\*USDC on every EVM chain; USDT on all of them except Base, World Chain, Sei, HyperEVM, and Monad (their "USDT" is USDT0/LayerZero, not Tether-native — omitted). Any other EVM chain works via a viem `Chain` or `{ id, rpcUrl }` — no allowlist. Every token address was verified on-chain before shipping.

## ✨ Why PipRail

Anything should be able to charge for itself — an API, a dataset, a model, an agent — and **anyone** should be able to get paid for it in seconds, without asking a platform for permission. The agent economy will run on millions of tiny, machine-to-machine payments, and that rail should be **open, free, and self-custodial** — not a toll booth owned by a middleman.

So we built it that way: no backend, no fees, no gatekeeper — an MIT library that turns any endpoint into a paid one and any agent into a paying customer, on every major chain. The goal is simple and audacious: **make open, self-custodial payments the default rail for the agent economy.**

## ⚙️ How it works

```

Agent                                  Your server

  │  GET /report                            │

  │ ───────────────────────────────────────►│  requirePayment

  │ ◄──────────── 402 + payment-required ────│  (issues a challenge)

  │  pay on-chain (one transfer to payTo)    │

  │ ───────────────────►  [the chain]        │

  │  GET /report  + payment-signature        │

  │ ───────────────────────────────────────►│  verifies the tx against

  │ ◄──────────── 200 + your content ────────│  its own RPC, then next()

```

Verification is local and confirms the transaction **succeeded, is recent, and actually moved the required amount of the right token to `payTo`**. The x402 v2 spec (§7) explicitly endorses merchant-local verification — no facilitator required — so this is a spec-compliant shape, not a workaround. **Self-custody throughout:** the payer signs and broadcasts their own transfer straight to your wallet; PipRail never holds funds and never takes a cut.

## 📦 What's in here

```

piprail/

├── sdk/         # @piprail/sdk — the npm package (the product)

├── site/        # piprail.com — the landing site (Astro 5 + Tailwind v4, deploys to Netlify)

├── examples/    # runnable merchant + agent demos + a live Anvil end-to-end

└── .github/     # CI: build/test checks · npm publish on a sdk-v* tag

```

**`@piprail/sdk`** is the product — and the only thing published to npm. `site/` is the source of [piprail.com](https://piprail.com); `examples/` holds runnable demos. Both live here in the repo but aren't npm packages.

→ Full API & guides: **[sdk/README.md](sdk/README.md)**

No `contracts/`, no server, no database. PipRail is a tool you install, not a platform you sign up for.

## 🛠️ Quick start

```bash

npm install              # install workspace deps

npm run build:sdk        # build the SDK

npm run test:sdk         # run the SDK test suite

npm run typecheck        # typecheck the SDK

npm run dev              # run the landing site → http://localhost:4321

npm run e2e              # live end-to-end against a local Anvil chain

```

## 📄 License & trademark

**Code:** [MIT](LICENSE) — use it, fork it, ship it, commercially or otherwise.

**Name & brand:** **PipRail™**, the logo, and the `@piprail` npm scope are trademarks of the PipRail project — MIT covers the *code*, not the *name*. Build on it freely; just don't call a fork "PipRail" or imply it's official. See [TRADEMARK.md](TRADEMARK.md).

Contributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) (a simple DCO sign-off, no CLA).








Built for the agent economy · piprail.com