@reineira-os/x402-rss 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reineira Labs Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @reineira-os/x402-rss
+
+MIT buyer-side x402 adapter for Arbitrum Sepolia. A thin wrapper over our own
+`@reineira-os/x402-core` `exact` client, preconfigured for the `eip155:421614`
+`exact` (EIP-3009) scheme and the Arbitrum Sepolia USDC.
+
+## Usage
+
+```ts
+import { createX402RssFetch } from "@reineira-os/x402-rss";
+import { privateKeyToAccount } from "viem/accounts";
+
+const fetchPaid = createX402RssFetch({ account: privateKeyToAccount(PK) });
+const res = await fetchPaid("https://provider.example/job");
+```
+
+`createX402RssFetch` returns a payment-aware `fetch`: on an HTTP `402` it signs an
+`exact` authorization for the requested `payTo`/amount and retries with the
+`PAYMENT-SIGNATURE` header. A `maxValue` cap (default 10 USDC) rejects a payment
+that exceeds the limit before signing.
+
+Built on `@reineira-os/x402-core`. Plain pays settle via
+`transferWithAuthorization`; escrow-bound pays settle via
+`receiveWithAuthorization` (both implemented in core).

package/dist/index.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  arbitrumSepolia: () => arbitrumSepolia,
+  createX402RssFetch: () => createX402RssFetch
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/fetch.ts
+var import_viem = require("viem");
+var import_chains = require("viem/chains");
+var import_client = require("@reineira-os/x402-core/exact/client");
+var import_client2 = require("@reineira-os/x402-core/exact/client");
+
+// src/config.ts
+var import_x402_shared = require("@reineira-os/x402-shared");
+var arbitrumSepolia = {
+  chainId: import_x402_shared.ARBITRUM_SEPOLIA.chainId,
+  usdc: import_x402_shared.ARBITRUM_SEPOLIA.usdc,
+  network: import_x402_shared.X402.network,
+  scheme: import_x402_shared.X402.scheme,
+  defaultMaxValue: 10000000n
+};
+
+// src/fetch.ts
+function createX402RssFetch(opts) {
+  const publicClient = (0, import_viem.createPublicClient)({
+    chain: import_chains.arbitrumSepolia,
+    transport: (0, import_viem.http)(opts.rpcUrl)
+  });
+  const signer = (0, import_client2.toClientEvmSigner)(opts.account, publicClient);
+  const maxValue = opts.maxValue ?? arbitrumSepolia.defaultMaxValue;
+  const selectWithinMaxValue = (_x402Version, requirements) => {
+    const chosen = requirements.find(
+      (r) => r.scheme === arbitrumSepolia.scheme && r.network === arbitrumSepolia.network && r.asset.toLowerCase() === arbitrumSepolia.usdc.toLowerCase()
+    );
+    if (!chosen) {
+      throw new Error(
+        "x402-rss: no acceptable payment requirements (exact / eip155:421614 / USDC)"
+      );
+    }
+    if (!/^[0-9]+$/.test(chosen.amount)) {
+      throw new Error("x402-rss: malformed payment amount");
+    }
+    const amount = BigInt(chosen.amount);
+    if (amount <= 0n) {
+      throw new Error("x402-rss: non-positive payment amount");
+    }
+    if (amount > maxValue) {
+      throw new Error("x402-rss: amount exceeds maxValue");
+    }
+    return chosen;
+  };
+  const client = new import_client.x402Client(selectWithinMaxValue).register(
+    arbitrumSepolia.network,
+    new import_client2.ExactEvmScheme(signer)
+  );
+  const baseFetch = opts.fetch ?? fetch;
+  return (0, import_client.wrapFetchWithPayment)(baseFetch, client);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  arbitrumSepolia,
+  createX402RssFetch
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/fetch.ts","../src/config.ts"],"sourcesContent":["export { createX402RssFetch } from \"./fetch.js\";\nexport type { CreateX402RssFetchOptions } from \"./fetch.js\";\nexport { arbitrumSepolia } from \"./config.js\";\n","import { createPublicClient, http, type LocalAccount } from \"viem\";\nimport { arbitrumSepolia as arbitrumSepoliaChain } from \"viem/chains\";\nimport {\n  wrapFetchWithPayment,\n  x402Client,\n  type SelectPaymentRequirements,\n} from \"@reineira-os/x402-core/exact/client\";\nimport { ExactEvmScheme, toClientEvmSigner } from \"@reineira-os/x402-core/exact/client\";\nimport { arbitrumSepolia } from \"./config.js\";\n\nexport interface CreateX402RssFetchOptions {\n  account: LocalAccount;\n  fetch?: typeof fetch;\n  maxValue?: bigint;\n  rpcUrl?: string;\n}\n\nexport function createX402RssFetch(opts: CreateX402RssFetchOptions): typeof fetch {\n  const publicClient = createPublicClient({\n    chain: arbitrumSepoliaChain,\n    transport: http(opts.rpcUrl),\n  });\n  const signer = toClientEvmSigner(opts.account, publicClient);\n  const maxValue = opts.maxValue ?? arbitrumSepolia.defaultMaxValue;\n\n  const selectWithinMaxValue: SelectPaymentRequirements = (_x402Version, requirements) => {\n    const chosen = requirements.find(\n      (r) =>\n        r.scheme === arbitrumSepolia.scheme &&\n        r.network === arbitrumSepolia.network &&\n        r.asset.toLowerCase() === arbitrumSepolia.usdc.toLowerCase(),\n    );\n    if (!chosen) {\n      throw new Error(\n        \"x402-rss: no acceptable payment requirements (exact / eip155:421614 / USDC)\",\n      );\n    }\n    if (!/^[0-9]+$/.test(chosen.amount)) {\n      throw new Error(\"x402-rss: malformed payment amount\");\n    }\n    const amount = BigInt(chosen.amount);\n    if (amount <= 0n) {\n      throw new Error(\"x402-rss: non-positive payment amount\");\n    }\n    if (amount > maxValue) {\n      throw new Error(\"x402-rss: amount exceeds maxValue\");\n    }\n    return chosen;\n  };\n\n  const client = new x402Client(selectWithinMaxValue).register(\n    arbitrumSepolia.network,\n    new ExactEvmScheme(signer),\n  );\n\n  const baseFetch = opts.fetch ?? fetch;\n  return wrapFetchWithPayment(baseFetch, client) as typeof fetch;\n}\n","import { ARBITRUM_SEPOLIA, X402 } from \"@reineira-os/x402-shared\";\n\nexport const arbitrumSepolia = {\n  chainId: ARBITRUM_SEPOLIA.chainId,\n  usdc: ARBITRUM_SEPOLIA.usdc,\n  network: X402.network,\n  scheme: X402.scheme,\n  defaultMaxValue: 10_000_000n,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAA4D;AAC5D,oBAAwD;AACxD,oBAIO;AACP,IAAAA,iBAAkD;;;ACPlD,yBAAuC;AAEhC,IAAM,kBAAkB;AAAA,EAC7B,SAAS,oCAAiB;AAAA,EAC1B,MAAM,oCAAiB;AAAA,EACvB,SAAS,wBAAK;AAAA,EACd,QAAQ,wBAAK;AAAA,EACb,iBAAiB;AACnB;;;ADSO,SAAS,mBAAmB,MAA+C;AAChF,QAAM,mBAAe,gCAAmB;AAAA,IACtC,OAAO,cAAAC;AAAA,IACP,eAAW,kBAAK,KAAK,MAAM;AAAA,EAC7B,CAAC;AACD,QAAM,aAAS,kCAAkB,KAAK,SAAS,YAAY;AAC3D,QAAM,WAAW,KAAK,YAAY,gBAAgB;AAElD,QAAM,uBAAkD,CAAC,cAAc,iBAAiB;AACtF,UAAM,SAAS,aAAa;AAAA,MAC1B,CAAC,MACC,EAAE,WAAW,gBAAgB,UAC7B,EAAE,YAAY,gBAAgB,WAC9B,EAAE,MAAM,YAAY,MAAM,gBAAgB,KAAK,YAAY;AAAA,IAC/D;AACA,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,WAAW,KAAK,OAAO,MAAM,GAAG;AACnC,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AACA,UAAM,SAAS,OAAO,OAAO,MAAM;AACnC,QAAI,UAAU,IAAI;AAChB,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AACA,QAAI,SAAS,UAAU;AACrB,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD;AACA,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,IAAI,yBAAW,oBAAoB,EAAE;AAAA,IAClD,gBAAgB;AAAA,IAChB,IAAI,8BAAe,MAAM;AAAA,EAC3B;AAEA,QAAM,YAAY,KAAK,SAAS;AAChC,aAAO,oCAAqB,WAAW,MAAM;AAC/C;","names":["import_client","arbitrumSepoliaChain"]}

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+import { LocalAccount } from 'viem';
+
+interface CreateX402RssFetchOptions {
+    account: LocalAccount;
+    fetch?: typeof fetch;
+    maxValue?: bigint;
+    rpcUrl?: string;
+}
+declare function createX402RssFetch(opts: CreateX402RssFetchOptions): typeof fetch;
+
+declare const arbitrumSepolia: {
+    readonly chainId: 421614;
+    readonly usdc: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+    readonly network: "eip155:421614";
+    readonly scheme: "exact";
+    readonly defaultMaxValue: 10000000n;
+};
+
+export { type CreateX402RssFetchOptions, arbitrumSepolia, createX402RssFetch };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { LocalAccount } from 'viem';
+
+interface CreateX402RssFetchOptions {
+    account: LocalAccount;
+    fetch?: typeof fetch;
+    maxValue?: bigint;
+    rpcUrl?: string;
+}
+declare function createX402RssFetch(opts: CreateX402RssFetchOptions): typeof fetch;
+
+declare const arbitrumSepolia: {
+    readonly chainId: 421614;
+    readonly usdc: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+    readonly network: "eip155:421614";
+    readonly scheme: "exact";
+    readonly defaultMaxValue: 10000000n;
+};
+
+export { type CreateX402RssFetchOptions, arbitrumSepolia, createX402RssFetch };

package/dist/index.js

@@ -0,0 +1,60 @@
+// src/fetch.ts
+import { createPublicClient, http } from "viem";
+import { arbitrumSepolia as arbitrumSepoliaChain } from "viem/chains";
+import {
+  wrapFetchWithPayment,
+  x402Client
+} from "@reineira-os/x402-core/exact/client";
+import { ExactEvmScheme, toClientEvmSigner } from "@reineira-os/x402-core/exact/client";
+
+// src/config.ts
+import { ARBITRUM_SEPOLIA, X402 } from "@reineira-os/x402-shared";
+var arbitrumSepolia = {
+  chainId: ARBITRUM_SEPOLIA.chainId,
+  usdc: ARBITRUM_SEPOLIA.usdc,
+  network: X402.network,
+  scheme: X402.scheme,
+  defaultMaxValue: 10000000n
+};
+
+// src/fetch.ts
+function createX402RssFetch(opts) {
+  const publicClient = createPublicClient({
+    chain: arbitrumSepoliaChain,
+    transport: http(opts.rpcUrl)
+  });
+  const signer = toClientEvmSigner(opts.account, publicClient);
+  const maxValue = opts.maxValue ?? arbitrumSepolia.defaultMaxValue;
+  const selectWithinMaxValue = (_x402Version, requirements) => {
+    const chosen = requirements.find(
+      (r) => r.scheme === arbitrumSepolia.scheme && r.network === arbitrumSepolia.network && r.asset.toLowerCase() === arbitrumSepolia.usdc.toLowerCase()
+    );
+    if (!chosen) {
+      throw new Error(
+        "x402-rss: no acceptable payment requirements (exact / eip155:421614 / USDC)"
+      );
+    }
+    if (!/^[0-9]+$/.test(chosen.amount)) {
+      throw new Error("x402-rss: malformed payment amount");
+    }
+    const amount = BigInt(chosen.amount);
+    if (amount <= 0n) {
+      throw new Error("x402-rss: non-positive payment amount");
+    }
+    if (amount > maxValue) {
+      throw new Error("x402-rss: amount exceeds maxValue");
+    }
+    return chosen;
+  };
+  const client = new x402Client(selectWithinMaxValue).register(
+    arbitrumSepolia.network,
+    new ExactEvmScheme(signer)
+  );
+  const baseFetch = opts.fetch ?? fetch;
+  return wrapFetchWithPayment(baseFetch, client);
+}
+export {
+  arbitrumSepolia,
+  createX402RssFetch
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fetch.ts","../src/config.ts"],"sourcesContent":["import { createPublicClient, http, type LocalAccount } from \"viem\";\nimport { arbitrumSepolia as arbitrumSepoliaChain } from \"viem/chains\";\nimport {\n  wrapFetchWithPayment,\n  x402Client,\n  type SelectPaymentRequirements,\n} from \"@reineira-os/x402-core/exact/client\";\nimport { ExactEvmScheme, toClientEvmSigner } from \"@reineira-os/x402-core/exact/client\";\nimport { arbitrumSepolia } from \"./config.js\";\n\nexport interface CreateX402RssFetchOptions {\n  account: LocalAccount;\n  fetch?: typeof fetch;\n  maxValue?: bigint;\n  rpcUrl?: string;\n}\n\nexport function createX402RssFetch(opts: CreateX402RssFetchOptions): typeof fetch {\n  const publicClient = createPublicClient({\n    chain: arbitrumSepoliaChain,\n    transport: http(opts.rpcUrl),\n  });\n  const signer = toClientEvmSigner(opts.account, publicClient);\n  const maxValue = opts.maxValue ?? arbitrumSepolia.defaultMaxValue;\n\n  const selectWithinMaxValue: SelectPaymentRequirements = (_x402Version, requirements) => {\n    const chosen = requirements.find(\n      (r) =>\n        r.scheme === arbitrumSepolia.scheme &&\n        r.network === arbitrumSepolia.network &&\n        r.asset.toLowerCase() === arbitrumSepolia.usdc.toLowerCase(),\n    );\n    if (!chosen) {\n      throw new Error(\n        \"x402-rss: no acceptable payment requirements (exact / eip155:421614 / USDC)\",\n      );\n    }\n    if (!/^[0-9]+$/.test(chosen.amount)) {\n      throw new Error(\"x402-rss: malformed payment amount\");\n    }\n    const amount = BigInt(chosen.amount);\n    if (amount <= 0n) {\n      throw new Error(\"x402-rss: non-positive payment amount\");\n    }\n    if (amount > maxValue) {\n      throw new Error(\"x402-rss: amount exceeds maxValue\");\n    }\n    return chosen;\n  };\n\n  const client = new x402Client(selectWithinMaxValue).register(\n    arbitrumSepolia.network,\n    new ExactEvmScheme(signer),\n  );\n\n  const baseFetch = opts.fetch ?? fetch;\n  return wrapFetchWithPayment(baseFetch, client) as typeof fetch;\n}\n","import { ARBITRUM_SEPOLIA, X402 } from \"@reineira-os/x402-shared\";\n\nexport const arbitrumSepolia = {\n  chainId: ARBITRUM_SEPOLIA.chainId,\n  usdc: ARBITRUM_SEPOLIA.usdc,\n  network: X402.network,\n  scheme: X402.scheme,\n  defaultMaxValue: 10_000_000n,\n} as const;\n"],"mappings":";AAAA,SAAS,oBAAoB,YAA+B;AAC5D,SAAS,mBAAmB,4BAA4B;AACxD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,gBAAgB,yBAAyB;;;ACPlD,SAAS,kBAAkB,YAAY;AAEhC,IAAM,kBAAkB;AAAA,EAC7B,SAAS,iBAAiB;AAAA,EAC1B,MAAM,iBAAiB;AAAA,EACvB,SAAS,KAAK;AAAA,EACd,QAAQ,KAAK;AAAA,EACb,iBAAiB;AACnB;;;ADSO,SAAS,mBAAmB,MAA+C;AAChF,QAAM,eAAe,mBAAmB;AAAA,IACtC,OAAO;AAAA,IACP,WAAW,KAAK,KAAK,MAAM;AAAA,EAC7B,CAAC;AACD,QAAM,SAAS,kBAAkB,KAAK,SAAS,YAAY;AAC3D,QAAM,WAAW,KAAK,YAAY,gBAAgB;AAElD,QAAM,uBAAkD,CAAC,cAAc,iBAAiB;AACtF,UAAM,SAAS,aAAa;AAAA,MAC1B,CAAC,MACC,EAAE,WAAW,gBAAgB,UAC7B,EAAE,YAAY,gBAAgB,WAC9B,EAAE,MAAM,YAAY,MAAM,gBAAgB,KAAK,YAAY;AAAA,IAC/D;AACA,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,WAAW,KAAK,OAAO,MAAM,GAAG;AACnC,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AACA,UAAM,SAAS,OAAO,OAAO,MAAM;AACnC,QAAI,UAAU,IAAI;AAChB,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AACA,QAAI,SAAS,UAAU;AACrB,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD;AACA,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,IAAI,WAAW,oBAAoB,EAAE;AAAA,IAClD,gBAAgB;AAAA,IAChB,IAAI,eAAe,MAAM;AAAA,EAC3B;AAEA,QAAM,YAAY,KAAK,SAAS;AAChC,SAAO,qBAAqB,WAAW,MAAM;AAC/C;","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@reineira-os/x402-rss",
+  "version": "0.1.0",
+  "description": "Insured, FHE-confidential x402 settlement on the Reineira Settlement Standard (umbrella SDK)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ReineiraOS/x402.git",
+    "directory": "packages/x402-rss"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "viem": "^2.21.0",
+    "@reineira-os/x402-core": "0.1.0",
+    "@reineira-os/x402-shared": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "vitest": "^2.1.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}