piprail

KO | EN

gitlite — search

#typescript #cpp #data-science #chatbot #animation #anthropic #mysql #awesome #reactjs #openai

(★ 9)

x402 (HTTP 402 Payment Required) SDK + MCP server: let any API charge for itself and any AI agent pay for itself, USDC & stablecoins across EVM, Solana & 8 more chain families, in a couple of lines. Backendless, no fee, self-custodial, paid straight to your wallet. TypeScript, MIT.

File Explorer

ZIP Download

- - add-chain.md
  - deploy.md
  - release.md
  - verify-gate.md
- SURFACES.md
- - bug_report.yml
  - chain_request.yml
  - config.yml
  - feature_request.yml
- - create-piprail-release.yml
  - deploy-docs.yml
  - indexnow.yml
  - integrations-publish.yml
  - mcp-registry.yml
  - mcp-release.yml
  - mcp.yml
  - release.yml
  - sdk.yml
  - site.yml
- CODE_OF_CONDUCT.md
- FUNDING.yml
- pull_request_template.md
- SECURITY.md
- - bin.ts
  - index.ts
  - render.ts
- - render.test.ts
- CHANGELOG.md
- package.json
- README.md
- tsconfig.json
- tsconfig.test.json
- tsup.config.ts
- - .nojekyll
  - 1a7e59a4b79dd5cf3b5c74dd6d400c27.txt
  - apple-touch-icon.png
  - CNAME
  - favicon-16.png
  - favicon-32.png
  - logo-dark.png
  - logo-light.png
  - logo.png
  - og.png
  - robots.txt
- - gen-logo-variants.mjs
- - content.config.ts
- .gitignore
- astro.config.mjs
- package.json
- tsconfig.json
- - dump-envelopes.mjs
  - interop_probe.py
  - README.md
- - lib.mjs
  - package-lock.json
  - package.json
  - README.md
  - test.mjs
- - README.md
- CONCEPTS.md
- README.md
- README.md
- TESTING.md
- - banner.ts
  - bin.ts
  - config.ts
  - confirm.ts
  - index.ts
  - server.ts
  - start.ts
  - version.ts
- - banner.test.ts
  - config.test.ts
  - confirm.test.ts
  - integration.test.ts
  - multi-chain.test.ts
  - server.test.ts
  - version.test.ts
- .env.example
- .gitignore
- CHANGELOG.md
- LICENSE
- package.json
- README.md
- server.json
- smithery.yaml
- tsconfig.json
- tsconfig.test.json
- tsup.config.ts
- - harness.mjs
  - l2-bounds.mjs
  - l2-gate.mjs
  - l2-invariants.mjs
  - l2-mcp.mjs
  - l2-merchant.mjs
  - l2-modes.mjs
  - l2-receipts.mjs
  - l2-selling.mjs
  - l3-endpoints.mjs
  - l3-facilitators.mjs
  - l3-reserves.mjs
  - l3-swaps.mjs
  - l4-gasless.mjs
  - l4-payments.mjs
  - l4-sovereign.mjs
  - run-one.mjs
- - check.mjs
  - graph.mjs
  - links.mjs
  - rules.mjs
  - sources.mjs
- - audit.mjs
  - coverage.json
- contacts.mjs
- lab-coverage.mjs
- load-env.mjs
- load-env.test.mjs
- prose-allow.json
- prose-audit.mjs
- rotate-npm-token.sh
- smoke.mjs
- sweep.mjs
- verify-gate.mjs
- verify-swap-proofs.mjs
- - adapters.ts
  - agent.ts
  - agentGuide.ts
  - classify.ts
  - client.ts
  - discovery.ts
  - errors.ts
  - facilitator.ts
  - facilitators.ts
  - index.ts
  - indexes.ts
  - indexProxy.ts
  - landing.ts
  - ledger.ts
  - merchant.ts
  - node.ts
  - payer.ts
  - policy.ts
  - receipts.ts
  - render.ts
  - selfdescribe.ts
  - server.ts
  - spendstore.ts
  - swap.ts
  - swapProviders.ts
  - x402.ts
- - _dual-rail.ts
  - adapters.test.ts
  - agent-modes.test.ts
  - agent-selling-adversarial.test.ts
  - agent-selling.test.ts
  - agent.test.ts
  - agentGuide.test.ts
  - breakit-2141.test.ts
  - budget-concurrency.test.ts
  - chains.test.ts
  - classify.test.ts
  - client-asset-discovery.test.ts
  - client-confirm-timeout.test.ts
  - client-exact.test.ts
  - client-readonly.test.ts
  - client-safety.test.ts
  - client-spend-controls.test.ts
  - client-upto.test.ts
  - client-verify-receipt.test.ts
  - client.budget.test.ts
  - client.test.ts
  - config-validation.test.ts
  - conformance.test.ts
  - cost.test.ts
  - describe-asset.test.ts
  - discover.test.ts
  - discovery-conformance.test.ts
  - discovery-e2e.test.ts
  - discovery-pagination.test.ts
  - discovery.test.ts
  - driver-addressof.test.ts
  - edge-cases.test.ts
  - errors.test.ts
  - exact-family-strings.test.ts
  - exact-transfer-method.test.ts
  - facilitator-4xx.test.ts
  - facilitator.test.ts
  - facilitators-surface.test.ts
  - facilitators.test.ts
  - fuzz-payment-paths.test.ts
  - indexes.test.ts
  - landing.test.ts
  - ledger-spend-controls.test.ts
  - ledger.test.ts
  - merchant.test.ts
  - multi-accept-near-sui.test.ts
  - multi-accept-new-chains.test.ts
  - multi-accept-rpcurl.test.ts
  - multi-accept-verify.test.ts
  - multi-accept.test.ts
  - multi-chain-assets.test.ts
  - multi-chain-payer.test.ts
  - multi-chain-policy.test.ts
  - native-reserve.test.ts
  - node-spendstore.test.ts
  - notify-both-sides.test.ts
  - plan-payment.test.ts
  - policy-spend-controls.test.ts
  - policy.test.ts
  - receipt-wire.test.ts
  - receipts.test.ts
  - recipient-ready.test.ts
  - register.test.ts
  - registry.test.ts
  - render.test.ts
  - replay-concurrency.test.ts
  - routing.test.ts
  - selfdescribe.test.ts
  - server-algorand-exact.test.ts
  - server-aptos-exact.test.ts
  - server-exact.test.ts
  - server-near-exact.test.ts
  - server-onfailed.test.ts
  - server-onpaid.test.ts
  - server-payment-identifier.test.ts
  - server-receipts.test.ts
  - server-replay.test.ts
  - server-svm-exact.test.ts
  - server-upto.test.ts
  - server-verifyobject.test.ts
  - server.test.ts
  - swap-contract-all-families.test.ts
  - swap-edge-cases.test.ts
  - swap-providers-surface.test.ts
  - swap-providers.test.ts
  - swap-tron-approval.test.ts
  - swap.test.ts
  - units.test.ts
  - verify.test.ts
  - x402-corpus.test.ts
  - x402-exact-wire.test.ts
  - x402-extension-points.test.ts
  - x402-network-aliases.test.ts
  - x402-upto-wire.test.ts
  - x402-v1-buyer.test.ts
  - x402.test.ts
- .gitignore
- .npmignore
- CHAINS.md
- CHANGELOG.md
- DISCOVERY.md
- ERRORS.md
- LICENSE
- package.json
- README.md
- STANDARDS.md
- tsconfig.json
- tsconfig.test.json
- tsup.config.ts
- vitest.config.ts
- - 1a7e59a4b79dd5cf3b5c74dd6d400c27.txt
  - apple-touch-icon.png
  - favicon-16.png
  - favicon-32.png
  - favicon-48.png
  - flow.png
  - llms-full.txt
  - llms.txt
  - logo-no-background.png
  - logo.png
  - og.png
  - PipRail-deck.pdf
  - robots.txt
  - security.txt
- - check-sync.mjs
  - gen-facilitators.mjs
  - gen-swap-providers.mjs
- .env.example
- .gitignore
- astro.config.mjs
- package.json
- tsconfig.json
.env.example
.gitignore
.mcp.json
AGENTS.md
base-form.png
CITATION.cff
CLAUDE.md
CONTRIBUTING.md
Dockerfile
FUNDING.json
glama.json
LICENSE
netlify.toml
package-lock.json
package.json
PipRail-deck.pdf
README.md
RELEASING.md
TESTING.md
TRADEMARK.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![@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)](https://raw.githubusercontent.com/piprail/piprail/main/LICENSE)
[![x402 v2](https://img.shields.io/badge/x402-v2-6e56cf.svg)](https://x402.org)
[![chains](https://img.shields.io/badge/chains-37%20across%2010%20families-2ee6a6.svg)](https://docs.piprail.com/chains/overview/)
[![GitHub stars](https://img.shields.io/github/stars/piprail/piprail?style=flat&logo=github&label=Star&color=2ee6a6)](https://github.com/piprail/piprail)
[![Follow @piprailhq](https://img.shields.io/badge/Follow-%40piprailhq-1d9bf0?logo=x&logoColor=white)](https://x.com/piprailhq)

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

[Website](https://piprail.com) · [Documentation](https://docs.piprail.com) · [npm](https://www.npmjs.com/package/@piprail/sdk)

</div>

---

PipRail implements the open [x402](https://x402.org) **"402 Payment Required"** standard with **no backend, no database, no account, no API key, 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**. Self-custodial throughout.

## How a payment moves

<sub>**The middle is the difference.** A traditional processor holds the money in transit, takes days to release it, and can freeze or reverse it. PipRail removes the middle entirely — the agent pays the merchant's wallet directly, the merchant verifies it locally against their own RPC, and it settles in one transaction at **0% fee**, self-custodial end to end. &nbsp;<a href="https://piprail.com">See it on piprail.com →</a></sub>

</div>

## 📊 The pitch deck

### ▶︎ &nbsp;[**Open the full deck — PDF**](PipRail-deck.pdf) &nbsp;◀︎

<sub>Opens **right here in your browser** — no download, GitHub renders it inline. 16 slides · every stat sourced in the speaker notes.</sub>

</div>

The whole thesis in one read: **why** agent payments are happening now, **why** chain & token fragmentation is the enemy, and **how** a single `chain:` parameter turns PipRail into the universal adapter. The payment path is **0% forever** — the moat *and* the distribution; value accrues to the layer around the free rail, never the rail itself.

<details>
<summary><b>What's inside — the 16-slide arc</b></summary>

<br/>

| # | Slide | # | Slide |
|---|---|---|---|
| 1 | **Hero** — the universal payment rail for the agent economy | 9 | **The MCP** — give your agent a budget-bound wallet |
| 2 | **Why now** — money is moving on-chain | 10 | **Open · dual-rail · gasless** |
| 3 | **The new buyer** — autonomous agents | 11 | **MPP vs PipRail** — count the middlemen |
| 4 | **The standard** — x402, "402 Payment Required" | 12 | **Discovery + integrations** |
| 5 | **The problem** — chain & token fragmentation | 13 | **Why PipRail wins** — the moat |
| 6 | **The reveal** — the universal adapter | 14 | **Traction** |
| 7 | **How it works** — 402 → pay → verify → 200 | 15 | **Business model** — open core, 0% rail |
| 8 | **Two sides, one SDK** — accept *and* pay | 16 | **The ask** |

<sub>Source `.pptx` (fully editable, brand fonts embedded) lives in [`.claude/skills/branding/design/deck/`](.claude/skills/branding/design/deck/). The root `PipRail-deck.pdf` is regenerated from it — don't hand-edit the PDF.</sub>

</details>

> ### 📖 Full documentation → **[docs.piprail.com](https://docs.piprail.com)**
> The single, searchable **source of truth** — every function, option, chain, and example. This README is just the front door.

## What's here

| | |
|---|---|
| **[`@piprail/sdk`](https://www.npmjs.com/package/@piprail/sdk)** | The TypeScript SDK — accept & make x402 payments. The product. Optionally [swaps tokens](https://docs.piprail.com/making-payments/swapping/) where an open, keyless route exists (no fee, no API key, never automatic). |
| **[`@piprail/mcp`](https://www.npmjs.com/package/@piprail/mcp)** | An MCP server giving any AI agent a budget-bound wallet ([`io.github.piprail/mcp`](https://registry.modelcontextprotocol.io)). |
| **[`@piprail/create`](https://www.npmjs.com/package/@piprail/create)** | `npm create @piprail` — scaffolds a runnable, mainnet-by-default x402 merchant in one command. Paste a public address; no key, no backend. |
| **[`integrations/`](integrations)** | First-party agent-framework integrations — **OpenClaw**, **Hermes**, **elizaOS** (`@piprail/elizaos-plugin`), **n8n** (`@piprail/n8n-nodes-piprail`) & **Mastra**. Each wraps `@piprail/sdk` or `@piprail/mcp`; nothing new to build. |
| **[`site/`](site)** · **[`docs/`](docs)** · **[`examples/`](examples)** | [piprail.com](https://piprail.com) · the [docs.piprail.com](https://docs.piprail.com) source · runnable demos. |

## Quick taste

```bash
npm install @piprail/sdk viem
```

```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. Point an agent at it and it pays itself — name any chain with a single `chain:` parameter. The full quickstart, every chain, the MCP server, spend controls, and the error model are in the **[docs](https://docs.piprail.com)**.

## Documentation & links

- **[docs.piprail.com](https://docs.piprail.com)** — the complete manual (source of truth)
- **[MCP server](https://docs.piprail.com/mcp/overview/)** · **[Discovery](https://docs.piprail.com/discovery/discover-and-register/)** · **[Supported chains](https://docs.piprail.com/chains/overview/)**
- **[Integrations](https://docs.piprail.com/integrations/)** — drop PipRail into agent frameworks: [OpenClaw](integrations/openclaw/piprail), [Hermes](integrations/hermes/piprail), [elizaOS](integrations/elizaos/piprail), [n8n](integrations/n8n/piprail) & [Mastra](integrations/mastra/piprail) (more coming)
- **[Runnable examples](examples)** — merchant + agent demos, a live Anvil end-to-end, and the [`why-402`](examples/basics/why-402/) teardown
- **[Releasing](RELEASING.md)** (tag-driven CI) · **[Contributing](CONTRIBUTING.md)** (DCO)

## Spread the word

PipRail is free, open-source, and has no backend to sell you — so word of mouth is how it grows. If it saved you from building a payments backend, the best way to give back is to help other developers (and their agents) find it:

- ⭐ **[Star PipRail on GitHub](https://github.com/piprail/piprail)** — the #1 way to help others discover it
- 𝕏 **[Follow @piprailhq](https://x.com/piprailhq)** — new chains, ship logs, and agent-payment tips
- 🌐 **[piprail.com](https://piprail.com)** · 📖 **[docs.piprail.com](https://docs.piprail.com)**

## 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).

<sub>Built for the agent economy · <a href="https://piprail.com">piprail.com</a></sub>
</div>

piprail

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README