@piprail/sdk 1.24.0 → 1.25.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to `@piprail/sdk` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
 versions follow [Semantic Versioning](https://semver.org/).
 
+## [1.25.0] — 2026-06-15 — more keyless facilitators (live-verified)
+
+### Added — `KNOWN_FACILITATORS` grows beyond PayAI
+
+- **`KNOWN_FACILITATORS`** now seeds three more keyless facilitators, each **live-settled** on mainnet
+  through PipRail (a real `exact` payment, buyer paid zero gas), not just read from `/supported`:
+  **xpay** on Base (EIP-3009), and **OpenFacilitator** + **Corbits** on Solana (SVM). So
+  `firstKeylessFacilitator()` / the `exact: true` shorthand can resolve a keyless sponsor on more
+  networks, with redundancy beyond PayAI.
+- **Daydreams** and **Questflow** are deliberately **not** seeded: their `/supported` is public but
+  `/verify` returns `401` (an API key is required), so they aren't keyless for *settlement*. A public
+  `/supported` is not proof of keyless settlement — every seeded entry carries a dated, live-verified note.
+
+### Notes
+
+- Pure data + comments; **no behaviour change** to existing rails or defaults. The full, current provider
+  matrix (incl. key-required and self-host options, with on-chain tx proofs) lives in the docs:
+  [Facilitator coverage](https://docs.piprail.com/accepting-payments/facilitator-coverage/).
+
 ## [1.24.0] — 2026-06-14 — multi-chain buying (one buyer, a wallet per chain)
 
 ### Added — pay a 402 on whichever chain it asks for
@@ -1064,6 +1083,7 @@ straight into your wallet. The API is small and self-contained.
   to your wallet; PipRail never holds funds.
 - `viem ^2.21` is a peer dependency. Node 20+ or a modern browser.
 
+[1.25.0]: https://www.npmjs.com/package/@piprail/sdk
 [1.24.0]: https://www.npmjs.com/package/@piprail/sdk
 [1.15.1]: https://www.npmjs.com/package/@piprail/sdk
 [1.15.0]: https://www.npmjs.com/package/@piprail/sdk

package/dist/index.cjs

@@ -5038,25 +5038,49 @@ function normaliseHeader(value) {
 
 // src/facilitators.ts
 var KNOWN_FACILITATORS = {
-  // PayAI — keyless (no API key), sponsors the gas. Verified 2026-06-14 against
-  // https://facilitator.payai.network/supported (exact · eip155:8453) + the live demo.
+  // Base (eip155:8453). Every entry is keyless and LIVE-settled by us (a real EIP-3009
+  // exact payment, buyer paid zero ETH) — not just a /supported read — on the dated day.
   "eip155:8453": [
     {
       url: "https://facilitator.payai.network",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009)"
+      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009). Verified 2026-06-14 (/supported + live demo)."
+    },
+    {
+      url: "https://facilitator.xpay.sh",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "xpay \u2014 keyless, zero-fee, sponsors gas. LIVE-settled on Base 2026-06-15 (tx 0x2273d5\u2026)."
     }
   ],
-  // PayAI on Solana — keyless fee-payer sponsor for the SVM exact rail. Verified 2026-06-14.
+  // Solana (mainnet-beta). Keyless fee-payer sponsors for the SVM exact rail, each LIVE-settled
+  // by us (a real SPL TransferChecked, buyer paid zero SOL) on the dated day — beyond a /supported
+  // read. Daydreams + Questflow are intentionally ABSENT: their /supported is public but /verify
+  // returns 401 (an API key is required), so they are not keyless for settlement.
   "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": [
     {
       url: "https://facilitator.payai.network",
       keyless: true,
       schemes: ["exact"],
       settles: ["svm"],
-      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM)"
+      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM). LIVE-settled 2026-06-14 (tx 4dL8jRKH\u2026)."
+    },
+    {
+      url: "https://pay.openfacilitator.io",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["svm"],
+      note: "OpenFacilitator \u2014 keyless (no signup), fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx 5BabDtX\u2026)."
+    },
+    {
+      url: "https://facilitator.corbits.dev",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["svm"],
+      note: "Corbits \u2014 keyless, Solana-first fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx BCreYer\u2026)."
     }
   ]
 };

package/dist/index.js

@@ -5038,25 +5038,49 @@ function normaliseHeader(value) {
 
 // src/facilitators.ts
 var KNOWN_FACILITATORS = {
-  // PayAI — keyless (no API key), sponsors the gas. Verified 2026-06-14 against
-  // https://facilitator.payai.network/supported (exact · eip155:8453) + the live demo.
+  // Base (eip155:8453). Every entry is keyless and LIVE-settled by us (a real EIP-3009
+  // exact payment, buyer paid zero ETH) — not just a /supported read — on the dated day.
   "eip155:8453": [
     {
       url: "https://facilitator.payai.network",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009)"
+      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009). Verified 2026-06-14 (/supported + live demo)."
+    },
+    {
+      url: "https://facilitator.xpay.sh",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "xpay \u2014 keyless, zero-fee, sponsors gas. LIVE-settled on Base 2026-06-15 (tx 0x2273d5\u2026)."
     }
   ],
-  // PayAI on Solana — keyless fee-payer sponsor for the SVM exact rail. Verified 2026-06-14.
+  // Solana (mainnet-beta). Keyless fee-payer sponsors for the SVM exact rail, each LIVE-settled
+  // by us (a real SPL TransferChecked, buyer paid zero SOL) on the dated day — beyond a /supported
+  // read. Daydreams + Questflow are intentionally ABSENT: their /supported is public but /verify
+  // returns 401 (an API key is required), so they are not keyless for settlement.
   "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": [
     {
       url: "https://facilitator.payai.network",
       keyless: true,
       schemes: ["exact"],
       settles: ["svm"],
-      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM)"
+      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM). LIVE-settled 2026-06-14 (tx 4dL8jRKH\u2026)."
+    },
+    {
+      url: "https://pay.openfacilitator.io",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["svm"],
+      note: "OpenFacilitator \u2014 keyless (no signup), fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx 5BabDtX\u2026)."
+    },
+    {
+      url: "https://facilitator.corbits.dev",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["svm"],
+      note: "Corbits \u2014 keyless, Solana-first fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx BCreYer\u2026)."
     }
   ]
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piprail/sdk",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Accept x402 crypto payments across 29 chains — every major EVM chain plus Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar & XRPL — in a couple of lines. No backend, no database, no fee; payments settle straight to your wallet.",
   "type": "module",
   "main": "./dist/index.cjs",