@piprail/sdk 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -4,6 +4,59 @@ 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/).
 
+## [2.6.0] — 2026-06-18 — keyless-gasless `exact` on 7 more EVM mainnets (6 → 13 chains)
+
+Additive and backward-compatible — defaults and the zero-config 402 stay byte-identical; this only
+grows the `KNOWN_FACILITATORS` seed map, so `exact: true` now resolves a keyless, gas-sponsoring
+facilitator zero-config on **7 more chains**.
+
+- **`exact: true` is now zero-config truly-gasless (buyer AND merchant pay zero native) on Ethereum,
+  Polygon, Arbitrum, Optimism, Avalanche, Sei, and Unichain** — joining Base, Monad, BNB, HyperEVM,
+  Algorand, and Solana (**6 → 13 chains**). Every new (chain, facilitator) pair was LIVE-settled on
+  mainnet with the buyer holding **zero native gas** (provably gasless), per the seed-map RULE
+  (settle-proven, never a `/supported` read). **17 new pairs**, e.g. Polygon now lists five keyless
+  facilitators (PayAI, Polygon Labs, Corbits, Ultravioleta DAO, Dexter).
+- **Base** gains two more keyless facilitators (Cascade, Satoshi/bitcoinsapi).
+- **Not seeded (advertised ≠ settles):** Celo and Scroll — Ultravioleta DAO lists them but its sponsor
+  contract reverts there (`contract_call_failed`), so neither was ever live-settled. They stay on
+  `onchain-proof` until a facilitator actually settles them.
+- No API surface change. Merchants on an unseeded network still pass an explicit
+  `exact: { settle: { facilitator } }`.
+
+## [2.5.0] — 2026-06-18 — gasless NEAR `exact` rail (NEP-366 meta-transactions)
+
+Additive and backward-compatible — defaults and the zero-config 402 stay byte-identical; pure-EVM
+installs still never download a non-EVM library (NEAR + its borsh decoder stay lazy-loaded — verified:
+the built EVM bundle has zero static non-EVM imports, only lazy chunks).
+
+### Added
+
+- **NEAR `exact` rail — gasless for the buyer on a fifth family.** PipRail's `exact` scheme now covers
+  NEAR (NEP-141 tokens — USDC / USDT) via the ratified
+  [`scheme_exact_near`](https://github.com/x402-foundation/x402/blob/main/specs/schemes/exact/scheme_exact_near.md)
+  (x402 v2). The buyer signs a **NEP-366 `SignedDelegateAction`** authorizing exactly one `ft_transfer`
+  with a **full-access key** and never broadcasts it or holds any NEAR; a relayer wraps it, prepays the
+  gas + the 1 yoctoNEAR, and submits — the agent is **completely gasless**. Opt-in
+  (`schemes: ['onchain-proof', 'exact']`); native NEAR is **not** exact-payable (the scheme is over
+  `ft_transfer`) and stays `onchain-proof`. Proven on NEAR mainnet for both USDC and USDT.
+  - New `payExactNear` (buyer build/sign) and `verifyAndSettleExactNear` (seller verify + relay) driver
+    functions; `resolveExactRail` / `payExact` / `settleExactSelf` are now implemented for NEAR.
+  - **Self-settle today** (`exact: { settle: 'self', relayer: { accountId, key } }`): the merchant runs
+    a small funded relayer that pays the sub-cent settle gas — the buyer stays gasless, exactly like the
+    Solana / Algorand / Aptos self-settle. The **facilitator** path (`settle: { facilitator }`) is wired
+    and will work the moment a real NEAR x402 facilitator ships; **none does yet** (some advertise
+    `near:mainnet` in `/supported` without settling it), so `exact: true` deliberately excludes NEAR and
+    self-settle is the supported gasless-for-buyer config. See the NEAR chain doc for the caveat.
+  - **Sponsor fee-drain guard**: the relayer prepays both the gas and the attached deposit, so the gate
+    rejects any delegate whose attached `deposit` ≠ exactly 1 yoctoNEAR or whose `gas` exceeds the
+    300 TGas cap (re-derived from the trusted rail) **before** the relayer signs.
+
+### Dependencies
+
+- Added **`borsh` (`>=2 <3`) as an OPTIONAL peer dependency** — used only to decode the inbound NEAR
+  `SignedDelegateAction` during self-settle, lazy-loaded inside the NEAR driver. NEAR users already have
+  it via `near-api-js`; pure-EVM (and non-NEAR) installs never load it.
+
 ## [2.4.0] — 2026-06-17 — gasless Algorand & Aptos rails + keyless gasless on SIX chains (incl. Algorand & BNB)
 
 Additive and backward-compatible — defaults and the zero-config 402 stay byte-identical; pure-EVM
@@ -1347,6 +1400,8 @@ 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.
 
+[2.6.0]: https://www.npmjs.com/package/@piprail/sdk
+[2.5.0]: https://www.npmjs.com/package/@piprail/sdk
 [2.4.0]: https://www.npmjs.com/package/@piprail/sdk
 [2.3.0]: https://www.npmjs.com/package/@piprail/sdk
 [2.2.0]: https://www.npmjs.com/package/@piprail/sdk

package/dist/index.cjs

@@ -1396,7 +1396,7 @@ function chainIdFromNetwork(network) {
   const match = /^eip155:(\d+)$/.exec(network);
   if (!match || !match[1]) return null;
   const n = Number(match[1]);
-  return Number.isSafeInteger(n) ? n : null;
+  return Number.isSafeInteger(n) && n > 0 ? n : null;
 }
 function buildChallengeHeader(challenge) {
   return toBase64Json(challenge);
@@ -1469,6 +1469,9 @@ function parseExactPaymentHeader(value) {
   const x402Version = typeof v.x402Version === "number" ? v.x402Version : 2;
   const asset = accepted && typeof accepted.asset === "string" ? accepted.asset : void 0;
   const base2 = { x402Version, network, ...asset ? { asset } : {}, raw: v };
+  if (typeof payload.signedDelegateAction === "string") {
+    return { ...base2, method: "near", payload: { signedDelegateAction: payload.signedDelegateAction } };
+  }
   if (typeof payload.transaction === "string" && typeof payload.senderAuth === "string") {
     return { ...base2, method: "aptos", payload: { transaction: payload.transaction, senderAuth: payload.senderAuth } };
   }
@@ -1810,6 +1813,9 @@ function makeEvmNetwork(resolved) {
       if ("paymentGroup" in payload) {
         return { ok: false, error: "signature_invalid", detail: "An Algorand payload was submitted to an EVM exact rail." };
       }
+      if ("signedDelegateAction" in payload) {
+        return { ok: false, error: "signature_invalid", detail: "A NEAR payload was submitted to an EVM exact rail." };
+      }
       return verifyAndSettleExactEvm({
         publicClient,
         walletClient: a.walletClient,
@@ -1906,7 +1912,7 @@ var loaders = {
   near: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./near-DI2I3MAV.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./near-H5AQ253I.cjs")));
     } catch (cause) {
       throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
         `NEAR selected, but its package isn't installed. Run: npm install near-api-js`,
@@ -3242,7 +3248,7 @@ var PipRailClient = (_class2 = class {
       );
       if (schemes.includes("exact") && exactOnNet && typeof net.payExact !== "function") {
         throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
-          `This 402 offers a standard 'exact' rail on ${net.network}, but the ${net.family} family can't pay 'exact' (supported on EVM, Solana + Algorand today), and no 'onchain-proof' rail was offered.`
+          `This 402 offers a standard 'exact' rail on ${net.network}, but the ${net.family} family can't pay 'exact' (supported on EVM, Solana, Algorand + NEAR today), and no 'onchain-proof' rail was offered.`
         );
       }
       if (!schemes.includes("exact") && exactOnNet && typeof net.payExact === "function") {
@@ -3638,7 +3644,7 @@ var PipRailClient = (_class2 = class {
   async payExactRail(net, wallet, accept, url, init, quote) {
     if (!net.payExact) {
       throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
-        `the ${net.family} family can't pay a standard 'exact' rail (supported on EVM, Solana + Algorand today).`
+        `the ${net.family} family can't pay a standard 'exact' rail (supported on EVM, Solana, Algorand + NEAR today).`
       );
     }
     throwIfAborted(_optionalChain([init, 'optionalAccess', _48 => _48.signal]));
@@ -4956,6 +4962,20 @@ var KNOWN_FACILITATORS = {
       schemes: ["exact"],
       settles: ["eip3009"],
       note: "GoPlausible \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x9bcbc1f01fe1fd1aed2a79e5582555164cc4185e9800189df378a6b46eb9c59e). 2nd GoPlausible validation chain (after Algorand)."
+    },
+    {
+      url: "https://facilitator.cascade.fyi",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Cascade \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-18 (tx 0x2e784725f3c66e170720cc8df43a9248f02ad80914fcbe05dadbdbe411c3b52b)."
+    },
+    {
+      url: "https://facilitator.bitcoinsapi.com",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Satoshi (bitcoinsapi) \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-18 (tx 0xbb2b6c354b12c6d07cce91e2b337e38327d4b0833bbd1dfbeda3ad495b67b819)."
     }
   ],
   // Monad (eip155:143). Corbits + Ultravioleta DAO each keyless-settle the EVM EIP-3009 exact rail
@@ -5018,6 +5038,139 @@ var KNOWN_FACILITATORS = {
       note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (HyperEVM native USDC EIP-3009). LIVE-settled on HyperEVM 2026-06-17 (tx 0x56af8148a92a291f0ce362e250919f7742074e5464ac0f315ad68abaec93bd0a)."
     }
   ],
+  // ── gasless-extension (2026-06-18): 7 more EVM mainnets, each LIVE-settled by us — a real EIP-3009
+  // exact payment with the buyer holding ZERO native (so PROVABLY gasless), funded self-service by
+  // bridging USDC in (LI.FI/Eco/Relay), never a /supported read. Dexter enforces a ~$0.004 dynamic
+  // floor on some chains (we cleared it at $0.005); UVD has no floor (100%-sponsors) but its sponsor
+  // contract is NOT deployed on every chain it advertises (Avalanche/Celo/Scroll → contract_call_failed,
+  // left UNSEEDED — the NEAR lesson: advertising ≠ settling).
+  // Ethereum L1 (eip155:1) — UVD (no floor, sponsors L1 gas). 2nd keyless ETH option vs Primev, which
+  // rejected PipRail's exact as unsupported_scheme.
+  "eip155:1": [
+    {
+      url: "https://facilitator.ultravioletadao.xyz",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Ethereum native USDC EIP-3009; no settlement floor). LIVE-settled on Ethereum mainnet 2026-06-18 (tx 0x7fcc3cafdf43c52888f0117cde633eff35371f832dfb8dbd84e6fd7704ae5cfc)."
+    }
+  ],
+  // Polygon PoS (eip155:137) — FIVE keyless facilitators (the broadest after Base), all live-settled.
+  "eip155:137": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "PayAI \u2014 keyless, sponsors gas (Polygon native USDC EIP-3009). LIVE-settled on Polygon 2026-06-18 (tx 0xb37630871504618c4db35e8ef0edd3c99deac102b143b7e5eb738c03fb13a619)."
+    },
+    {
+      url: "https://x402.polygon.technology",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Polygon Labs (the official Polygon facilitator) \u2014 keyless, sponsors gas. LIVE-settled on Polygon 2026-06-18 (tx 0x6a8ca60ea111959a61a85ad6c4f2ed99e192052ec7b9ffb59baa33691a86f419)."
+    },
+    {
+      url: "https://facilitator.corbits.dev",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Corbits (Faremeter) \u2014 keyless, sponsors gas. LIVE-settled on Polygon 2026-06-18 (tx 0x2fadca2ee3cd7fcff32d015e8b06109de6b747d7cd0f80dcd8fb022b2d58d008)."
+    },
+    {
+      url: "https://facilitator.ultravioletadao.xyz",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Polygon 2026-06-18 (tx 0x0922cd78f3b7c35cc294cf0c0d9b7609e6596eb337be0d197fa5fc511eacba34)."
+    },
+    {
+      url: "https://x402.dexter.cash",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic settlement floor (sub-floor \u2192 amount_too_low). LIVE-settled on Polygon 2026-06-18 at $0.005 (tx 0x4a7cfc96e4e2496652435c77b0021db4a459e7bcd97948c15e6bea09077c164b)."
+    }
+  ],
+  // Arbitrum One (eip155:42161) — PayAI + UVD + Dexter.
+  "eip155:42161": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "PayAI \u2014 keyless, sponsors gas (Arbitrum native USDC EIP-3009). LIVE-settled on Arbitrum 2026-06-18 (tx 0x4c7fbfb37ef087bb9bc8872b1b2b0b83ea7ca4cf6b50bc883e51f9b85be61199)."
+    },
+    {
+      url: "https://facilitator.ultravioletadao.xyz",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Arbitrum 2026-06-18 (tx 0xd1fa7e6ffbd59502bba5809ce181d7936749b93a45c8c2277b4f6d8638326dec)."
+    },
+    {
+      url: "https://x402.dexter.cash",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Arbitrum 2026-06-18 at $0.005 (tx 0x0993d51b3859dfd7e8d5b2af709ce64f01ff34ed14bfef665dbb340e7373d599)."
+    }
+  ],
+  // Optimism (eip155:10) — Dexter + UVD.
+  "eip155:10": [
+    {
+      url: "https://x402.dexter.cash",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Optimism 2026-06-18 at $0.005 (tx 0x98b282a5dd698054eff4900ff8547170d4f7605b51140c55147fc5ae485f81da)."
+    },
+    {
+      url: "https://facilitator.ultravioletadao.xyz",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Optimism 2026-06-18 (tx 0xdd91dfdf12bed2d196e37fa1dea9a0da71a97e3c39a0ec0ed114be6a9af22837)."
+    }
+  ],
+  // Avalanche C-Chain (eip155:43114) — PayAI + Dexter. (UVD advertises it but contract_call_failed → unseeded.)
+  "eip155:43114": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "PayAI \u2014 keyless, sponsors gas (Avalanche native USDC EIP-3009). LIVE-settled on Avalanche 2026-06-18 (tx 0x6a1307bc48a157de236ea03440ea2cb6ad4f27e22dd9c89a4345b4c3edb270c7)."
+    },
+    {
+      url: "https://x402.dexter.cash",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Dexter \u2014 keyless, sponsors gas (no floor hit at $0.001 here). LIVE-settled on Avalanche 2026-06-18 (tx 0xb2263e9a4ea3917eee6acabcb454d42a50264fdd69a0781ed8fcaec5590e264b)."
+    }
+  ],
+  // Sei (eip155:1329) — PayAI (the only keyless facilitator that lists Sei).
+  "eip155:1329": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "PayAI \u2014 keyless, sponsors gas (Sei native USDC EIP-3009). LIVE-settled on Sei 2026-06-18 (tx 0xde63679b64749cb59625527e5c7682503c851d66b9b8b8ba217ed7b099461312)."
+    }
+  ],
+  // Unichain (eip155:130) — UVD (the only keyless facilitator that lists Unichain).
+  "eip155:130": [
+    {
+      url: "https://facilitator.ultravioletadao.xyz",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Unichain native USDC EIP-3009). LIVE-settled on Unichain 2026-06-18 (tx 0xf8bf4a9a200f24159ac67c6315c30b194257999d7da21471b39d5f2cc32b2236)."
+    }
+  ],
   // Algorand (mainnet, CAIP-2 = full base64 genesis hash). GoPlausible keyless-settles the ratified
   // x402 Algorand `exact` rail (atomic-group fee pooling): its sponsor pools the whole group fee and
   // submits, so NEITHER the buyer NOR the merchant pays ALGO — both-sides gasless. LIVE-settled by us
@@ -5061,6 +5214,17 @@ var KNOWN_FACILITATORS = {
       note: "Corbits \u2014 keyless, Solana-first fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx BCreYer\u2026)."
     }
   ]
+  // NEAR (near:mainnet) — DELIBERATELY UNSEEDED: no x402 facilitator settles NEAR yet.
+  // The NEAR `exact` BUYER payload PipRail builds (drivers/near/exact.ts) is LIVE-PROVEN on mainnet —
+  // a real NEP-366 meta-transaction settles a USDC/USDT ft_transfer gaslessly (buyer 0 NEAR, single-use
+  // via the access-key nonce; relay txs CMnQJzrLvwk… USDT + BCCnVHbSCMY… USDC, 2026-06-18). What's
+  // missing is the FACILITATOR side: the public x402-rs (which Ultravioleta DAO runs) has NO NEAR chain
+  // crate (only eip155/solana/aptos), and UVD's `/verify` 400s on a near:mainnet request even though its
+  // `/supported` ADVERTISES `near:mainnet` + feePayer `uvd-facilitator.near` — i.e. the listing is
+  // aspirational, not settle-capable (verified 2026-06-18). So `exact: true` must NOT auto-pick a NEAR
+  // facilitator. Seed here ONLY after a real keyless settle through a facilitator that actually
+  // implements scheme_exact_near.md (THE RULE). Merchants can still pass an explicit
+  // `exact: { settle: { facilitator } }` for any facilitator they've confirmed settles near:mainnet.
 };
 function knownFacilitatorsFor(network) {
   return _nullishCoalesce(KNOWN_FACILITATORS[network], () => ( []));
@@ -5476,6 +5640,12 @@ function createPaymentGate(options) {
           return t;
         }
       }).join("|");
+    } else if ("signedDelegateAction" in exact.payload) {
+      try {
+        nonce = Buffer.from(exact.payload.signedDelegateAction, "base64").toString("base64");
+      } catch (e41) {
+        nonce = exact.payload.signedDelegateAction;
+      }
     } else if ("permit2Authorization" in exact.payload) {
       evmAuth = exact.payload.permit2Authorization;
       nonce = evmAuth.nonce;
@@ -5494,7 +5664,7 @@ function createPaymentGate(options) {
         result = await spec.net.settleExactSelf({ relayer: mode.relayer, payload: exact.payload, accept });
       } else {
         const ftMethod = accept.extra.assetTransferMethod;
-        const needsFeePayer = ftMethod === "svm" || ftMethod === "algorand" || ftMethod === "aptos";
+        const needsFeePayer = ftMethod === "svm" || ftMethod === "algorand" || ftMethod === "aptos" || ftMethod === "near";
         if (needsFeePayer && !accept.extra.feePayer) {
           throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
             `exact settle: the ${ftMethod} facilitator rail is missing extra.feePayer (the gas sponsor) \u2014 cannot settle.`
@@ -5614,7 +5784,7 @@ async function signBody(secret, body) {
     const sig = await subtle.sign("HMAC", key, enc.encode(body));
     const hex = Array.from(new Uint8Array(sig)).map((b) => b.toString(16).padStart(2, "0")).join("");
     return `sha256=${hex}`;
-  } catch (e41) {
+  } catch (e42) {
     return null;
   }
 }
@@ -5675,7 +5845,7 @@ async function deliverReceipt(receipt, options) {
     const willRetry = !ok && retryable && attempt < maxAttempts;
     try {
       _optionalChain([onAttempt, 'optionalCall', _91 => _91({ attempt, ok, ...status !== void 0 ? { status } : {}, ...error ? { error } : {}, willRetry })]);
-    } catch (e42) {
+    } catch (e43) {
     }
     if (ok) return { delivered: true, attempts: attempt, status };
     if (!willRetry) {

package/dist/index.d.cts

@@ -94,8 +94,11 @@ interface X402ExactAcceptEntry {
          *  keyless facilitator) signs that fee txn + submits. **Aptos: `'aptos'`** — the payer signs a
          *  fee-payer (sponsored) `primary_fungible_store::transfer` to `payTo` (per
          *  `scheme_exact_aptos.md`); the gate (or a keyless facilitator) adds the fee-payer signature
-         *  + submits, paying gas. PipRail self-settles ALL. */
-        assetTransferMethod: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos';
+         *  + submits, paying gas. **NEAR: `'near'`** — the payer signs a NEP-366 `SignedDelegateAction`
+         *  authorizing exactly one NEP-141 `ft_transfer` to `payTo` (per `scheme_exact_near.md`); a
+         *  facilitator-selected relayer (`feePayer` below) prepays gas + the 1 yoctoNEAR and submits, so
+         *  the buyer holds zero NEAR. PipRail self-settles ALL. */
+        assetTransferMethod: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near';
         /** EIP-712 domain name of the token. OPTIONAL per the exact-EVM scheme (only
          *  `assetTransferMethod` is required) — a foreign rail may omit it. NEVER assumed
          *  from the symbol (USDC's on-chain name() is "USD Coin", not "USDC"); a PipRail gate
@@ -255,9 +258,24 @@ interface ExactAptosPaymentPayload {
     /** Base64 BCS-serialized buyer (sender) `AccountAuthenticator`. */
     senderAuth: string;
 }
+/**
+ * The `payload` a client sends for the **NEAR `exact`** variant, per `scheme_exact_near.md`:
+ * a base64-encoded, Borsh-serialized NEP-366 `SignedDelegateAction` whose single delegated action
+ * is one NEP-141 `ft_transfer` (to `payTo`, the exact `amount`, `deposit: 1` yoctoNEAR). The buyer
+ * signs the delegate action with a FULL-ACCESS key (a function-call key can't attach the 1 yocto and
+ * is rejected); a facilitator-selected relayer wraps it, prepays gas + the yocto, and submits. The
+ * signed delegate action IS the proof — there's no separate authorization object (the NEAR analogue
+ * of EIP-3009's `authorization` / SVM's `transaction`). Its single self-contained string field also
+ * distinguishes it from every other family's payload shape.
+ */
+interface ExactNearPaymentPayload {
+    /** Base64 of the Borsh-encoded NEP-366 `SignedDelegateAction` (one `ft_transfer`). */
+    signedDelegateAction: string;
+}
 /** Any `exact`-rail payload shape — EIP-3009 (`authorization`), Permit2 (`permit2Authorization`),
- *  SVM (`transaction`), Algorand (`paymentGroup`), or Aptos (`transaction` + `senderAuth`). */
-type ExactPaymentPayloadAny = ExactPaymentPayload | Permit2PaymentPayload | ExactSvmPaymentPayload | ExactAlgorandPaymentPayload | ExactAptosPaymentPayload;
+ *  SVM (`transaction`), Algorand (`paymentGroup`), Aptos (`transaction` + `senderAuth`), or NEAR
+ *  (`signedDelegateAction`). */
+type ExactPaymentPayloadAny = ExactPaymentPayload | Permit2PaymentPayload | ExactSvmPaymentPayload | ExactAlgorandPaymentPayload | ExactAptosPaymentPayload | ExactNearPaymentPayload;
 interface ParsedExactBase {
     x402Version: number;
     /** The client's claimed network (slug or CAIP-2) — for matching, not trust. */
@@ -277,7 +295,8 @@ interface ParsedExactBase {
  * (`authorization`), `'permit2'` → {@link Permit2PaymentPayload} (`permit2Authorization`),
  * `'svm'` → {@link ExactSvmPaymentPayload} (`transaction`), `'algorand'` →
  * {@link ExactAlgorandPaymentPayload} (`paymentGroup`); `'aptos'` →
- * {@link ExactAptosPaymentPayload} (`transaction` + `senderAuth`).
+ * {@link ExactAptosPaymentPayload} (`transaction` + `senderAuth`); `'near'` →
+ * {@link ExactNearPaymentPayload} (`signedDelegateAction`).
  */
 type ParsedExactPayment = (ParsedExactBase & {
     method: 'eip3009';
@@ -294,6 +313,9 @@ type ParsedExactPayment = (ParsedExactBase & {
 }) | (ParsedExactBase & {
     method: 'aptos';
     payload: ExactAptosPaymentPayload;
+}) | (ParsedExactBase & {
+    method: 'near';
+    payload: ExactNearPaymentPayload;
 });
 interface X402Receipt {
     scheme: 'onchain-proof' | 'exact';
@@ -4313,10 +4335,10 @@ interface DiscoverySigner {
  * chain-agnostic — it never names a family, it just merges `extra`.
  */
 interface ExactRailInfo {
-    method: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos';
+    method: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near';
     /** Family-specific `extra` keys merged into the exact accept (e.g. `{ name, version }`
      *  for EVM EIP-3009, `{ feePayer, tokenProgram }` for Solana, `{ feePayer }` for
-     *  Algorand/Aptos). */
+     *  Algorand/Aptos/NEAR). */
     extra?: Record<string, unknown>;
 }
 /**
@@ -6759,7 +6781,7 @@ interface KnownFacilitator {
     /** The x402 schemes it settles (today only `exact`). */
     schemes: ReadonlyArray<'exact'>;
     /** The exact transfer methods it can settle on this network. */
-    settles: ReadonlyArray<'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos'>;
+    settles: ReadonlyArray<'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near'>;
     /** A short human note (who it is / caveat). */
     note?: string;
 }
@@ -6780,7 +6802,7 @@ declare function knownFacilitatorsFor(network: Caip2): ReadonlyArray<KnownFacili
  * specific transfer `method`). Returns `undefined` when none is known — the `exact: true`
  * shorthand branches on that to throw a coverage-specific guidance error.
  */
-declare function firstKeylessFacilitator(network: Caip2, method?: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos'): KnownFacilitator | undefined;
+declare function firstKeylessFacilitator(network: Caip2, method?: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near'): KnownFacilitator | undefined;
 
 /**
  * Reliable receipt delivery — the durable webhook a stateless gate can't be.

package/dist/index.d.ts

@@ -94,8 +94,11 @@ interface X402ExactAcceptEntry {
          *  keyless facilitator) signs that fee txn + submits. **Aptos: `'aptos'`** — the payer signs a
          *  fee-payer (sponsored) `primary_fungible_store::transfer` to `payTo` (per
          *  `scheme_exact_aptos.md`); the gate (or a keyless facilitator) adds the fee-payer signature
-         *  + submits, paying gas. PipRail self-settles ALL. */
-        assetTransferMethod: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos';
+         *  + submits, paying gas. **NEAR: `'near'`** — the payer signs a NEP-366 `SignedDelegateAction`
+         *  authorizing exactly one NEP-141 `ft_transfer` to `payTo` (per `scheme_exact_near.md`); a
+         *  facilitator-selected relayer (`feePayer` below) prepays gas + the 1 yoctoNEAR and submits, so
+         *  the buyer holds zero NEAR. PipRail self-settles ALL. */
+        assetTransferMethod: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near';
         /** EIP-712 domain name of the token. OPTIONAL per the exact-EVM scheme (only
          *  `assetTransferMethod` is required) — a foreign rail may omit it. NEVER assumed
          *  from the symbol (USDC's on-chain name() is "USD Coin", not "USDC"); a PipRail gate
@@ -255,9 +258,24 @@ interface ExactAptosPaymentPayload {
     /** Base64 BCS-serialized buyer (sender) `AccountAuthenticator`. */
     senderAuth: string;
 }
+/**
+ * The `payload` a client sends for the **NEAR `exact`** variant, per `scheme_exact_near.md`:
+ * a base64-encoded, Borsh-serialized NEP-366 `SignedDelegateAction` whose single delegated action
+ * is one NEP-141 `ft_transfer` (to `payTo`, the exact `amount`, `deposit: 1` yoctoNEAR). The buyer
+ * signs the delegate action with a FULL-ACCESS key (a function-call key can't attach the 1 yocto and
+ * is rejected); a facilitator-selected relayer wraps it, prepays gas + the yocto, and submits. The
+ * signed delegate action IS the proof — there's no separate authorization object (the NEAR analogue
+ * of EIP-3009's `authorization` / SVM's `transaction`). Its single self-contained string field also
+ * distinguishes it from every other family's payload shape.
+ */
+interface ExactNearPaymentPayload {
+    /** Base64 of the Borsh-encoded NEP-366 `SignedDelegateAction` (one `ft_transfer`). */
+    signedDelegateAction: string;
+}
 /** Any `exact`-rail payload shape — EIP-3009 (`authorization`), Permit2 (`permit2Authorization`),
- *  SVM (`transaction`), Algorand (`paymentGroup`), or Aptos (`transaction` + `senderAuth`). */
-type ExactPaymentPayloadAny = ExactPaymentPayload | Permit2PaymentPayload | ExactSvmPaymentPayload | ExactAlgorandPaymentPayload | ExactAptosPaymentPayload;
+ *  SVM (`transaction`), Algorand (`paymentGroup`), Aptos (`transaction` + `senderAuth`), or NEAR
+ *  (`signedDelegateAction`). */
+type ExactPaymentPayloadAny = ExactPaymentPayload | Permit2PaymentPayload | ExactSvmPaymentPayload | ExactAlgorandPaymentPayload | ExactAptosPaymentPayload | ExactNearPaymentPayload;
 interface ParsedExactBase {
     x402Version: number;
     /** The client's claimed network (slug or CAIP-2) — for matching, not trust. */
@@ -277,7 +295,8 @@ interface ParsedExactBase {
  * (`authorization`), `'permit2'` → {@link Permit2PaymentPayload} (`permit2Authorization`),
  * `'svm'` → {@link ExactSvmPaymentPayload} (`transaction`), `'algorand'` →
  * {@link ExactAlgorandPaymentPayload} (`paymentGroup`); `'aptos'` →
- * {@link ExactAptosPaymentPayload} (`transaction` + `senderAuth`).
+ * {@link ExactAptosPaymentPayload} (`transaction` + `senderAuth`); `'near'` →
+ * {@link ExactNearPaymentPayload} (`signedDelegateAction`).
  */
 type ParsedExactPayment = (ParsedExactBase & {
     method: 'eip3009';
@@ -294,6 +313,9 @@ type ParsedExactPayment = (ParsedExactBase & {
 }) | (ParsedExactBase & {
     method: 'aptos';
     payload: ExactAptosPaymentPayload;
+}) | (ParsedExactBase & {
+    method: 'near';
+    payload: ExactNearPaymentPayload;
 });
 interface X402Receipt {
     scheme: 'onchain-proof' | 'exact';
@@ -4313,10 +4335,10 @@ interface DiscoverySigner {
  * chain-agnostic — it never names a family, it just merges `extra`.
  */
 interface ExactRailInfo {
-    method: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos';
+    method: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near';
     /** Family-specific `extra` keys merged into the exact accept (e.g. `{ name, version }`
      *  for EVM EIP-3009, `{ feePayer, tokenProgram }` for Solana, `{ feePayer }` for
-     *  Algorand/Aptos). */
+     *  Algorand/Aptos/NEAR). */
     extra?: Record<string, unknown>;
 }
 /**
@@ -6759,7 +6781,7 @@ interface KnownFacilitator {
     /** The x402 schemes it settles (today only `exact`). */
     schemes: ReadonlyArray<'exact'>;
     /** The exact transfer methods it can settle on this network. */
-    settles: ReadonlyArray<'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos'>;
+    settles: ReadonlyArray<'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near'>;
     /** A short human note (who it is / caveat). */
     note?: string;
 }
@@ -6780,7 +6802,7 @@ declare function knownFacilitatorsFor(network: Caip2): ReadonlyArray<KnownFacili
  * specific transfer `method`). Returns `undefined` when none is known — the `exact: true`
  * shorthand branches on that to throw a coverage-specific guidance error.
  */
-declare function firstKeylessFacilitator(network: Caip2, method?: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos'): KnownFacilitator | undefined;
+declare function firstKeylessFacilitator(network: Caip2, method?: 'eip3009' | 'permit2' | 'svm' | 'algorand' | 'aptos' | 'near'): KnownFacilitator | undefined;
 
 /**
  * Reliable receipt delivery — the durable webhook a stateless gate can't be.