@azeth/provider 0.2.0

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7C,8CAA8C;IAC9C,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,qDAAqD;IACrD,YAAY,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAeD,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,EAAE,sBAAsB;IAI1C;uEACmE;IACnE,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkClE,qDAAqD;IACrD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAItD,yDAAyD;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpC,6BAA6B;IAC7B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUhC,wCAAwC;IACxC,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/storage.js

@@ -0,0 +1,96 @@
+import { findActiveAgreementForPayee } from './agreement-cache.js';
+/** Agreement-aware SIWx storage.
+ *
+ *  Implements the @x402/extensions SIWxStorage interface with two-tier lookup:
+ *  1. In-memory payment records (from x402 settlement — previously paid)
+ *  2. On-chain payment agreements (subscription — no per-request payment needed)
+ *
+ *  This is the key integration point between x402 SIWx sessions and Azeth
+ *  payment agreements. Both use SIWx for wallet identity — the difference
+ *  is what hasPaid() checks.
+ */
+/** Max entries per resource in paymentRecords to prevent unbounded growth */
+const MAX_PAYMENT_RECORDS_PER_RESOURCE = 100_000;
+export class AzethSIWxStorage {
+    paymentRecords = new Map();
+    usedNonces = new Set();
+    config;
+    keeper = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Inject the agreement keeper after construction.
+     *  Called from server startup to avoid circular initialization. */
+    setKeeper(keeper) {
+        this.keeper = keeper;
+    }
+    /** Check if an address has paid for a resource.
+     *
+     *  Two-tier lookup:
+     *  1. Check in-memory payment records (x402 settlement — permanent grant)
+     *  2. Check on-chain agreements (subscription — re-verified every ~60s via cache TTL)
+     *
+     *  Settlement grants (recordPayment) are permanent for the session.
+     *  Agreement grants are NOT cached permanently — they are re-verified on each
+     *  call via findActiveAgreementForPayee (which uses a 60s TTL cache internally).
+     *  This ensures that if a payer's balance drops to zero, their access is revoked
+     *  within ~60s instead of being permanently granted.
+     */
+    async hasPaid(resource, address) {
+        const normalized = address.toLowerCase();
+        // 1. Check in-memory payment records (fast path — settlement grants are permanent)
+        const set = this.paymentRecords.get(resource);
+        if (set?.has(normalized))
+            return true;
+        // 2. Check on-chain agreements (re-verified via agreementCache with 60s TTL)
+        if (this.config.moduleAddress) {
+            try {
+                const agreement = await findActiveAgreementForPayee(this.config.publicClient, this.config.moduleAddress, address, this.config.servicePayee, this.config.serviceToken, this.config.minAgreementAmount);
+                if (agreement) {
+                    // Notify keeper to track this agreement for periodic execution
+                    this.keeper?.trackAgreement(address, agreement.id);
+                    return true;
+                }
+            }
+            catch {
+                // Agreement check failure is non-fatal — fall through to 402
+            }
+        }
+        return false;
+    }
+    /** Record that an address has paid for a resource */
+    recordPayment(resource, address) {
+        this.recordPaymentSync(resource, address.toLowerCase());
+    }
+    /** Check if a nonce has been used (replay prevention) */
+    hasUsedNonce(nonce) {
+        return this.usedNonces.has(nonce);
+    }
+    /** Record a nonce as used */
+    recordNonce(nonce) {
+        this.usedNonces.add(nonce);
+        // Limit nonce set size to prevent unbounded growth
+        if (this.usedNonces.size > 50_000) {
+            const iterator = this.usedNonces.values();
+            const oldest = iterator.next().value;
+            if (oldest !== undefined)
+                this.usedNonces.delete(oldest);
+        }
+    }
+    /** Synchronous payment record helper */
+    recordPaymentSync(resource, normalized) {
+        let set = this.paymentRecords.get(resource);
+        if (!set) {
+            set = new Set();
+            this.paymentRecords.set(resource, set);
+        }
+        set.add(normalized);
+        // Evict oldest entry when cap reached to prevent unbounded memory growth
+        if (set.size > MAX_PAYMENT_RECORDS_PER_RESOURCE) {
+            const oldest = set.values().next().value;
+            if (oldest !== undefined)
+                set.delete(oldest);
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiBnE;;;;;;;;;GASG;AACH,6EAA6E;AAC7E,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAEjD,MAAM,OAAO,gBAAgB;IACV,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,CAAyB;IACxC,MAAM,GAA2B,IAAI,CAAC;IAE9C,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;uEACmE;IACnE,SAAS,CAAC,MAAuB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAEzC,mFAAmF;QACnF,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,6EAA6E;QAC7E,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,2BAA2B,CACjD,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB,IAAI,CAAC,MAAM,CAAC,aAAa,EACzB,OAAwB,EACxB,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAC/B,CAAC;gBACF,IAAI,SAAS,EAAE,CAAC;oBACd,+DAA+D;oBAC/D,IAAI,CAAC,MAAM,EAAE,cAAc,CACzB,OAAwB,EACxB,SAAS,CAAC,EAAE,CACb,CAAC;oBACF,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;YAC/D,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,aAAa,CAAC,QAAgB,EAAE,OAAe;QAC7C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,6BAA6B;IAC7B,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,mDAAmD;QACnD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACrC,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,wCAAwC;IAChC,iBAAiB,CAAC,QAAgB,EAAE,UAAkB;QAC5D,IAAI,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpB,yEAAyE;QACzE,IAAI,GAAG,CAAC,IAAI,GAAG,gCAAgC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACzC,IAAI,MAAM,KAAK,SAAS;gBAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@azeth/provider",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "x402 service provider tooling for Azeth — gate Hono endpoints behind x402 payments with payment-agreement support",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/azeth-protocol/provider.git"
+  },
+  "homepage": "https://azeth.ai",
+  "keywords": [
+    "azeth",
+    "x402",
+    "provider",
+    "hono",
+    "payments",
+    "machine-economy",
+    "middleware"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./examples": {
+      "types": "./dist/examples/index.d.ts",
+      "import": "./dist/examples/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@azeth/common": "^0.2.0",
+    "@x402/core": "^2.4.0",
+    "@x402/evm": "^2.4.0",
+    "@x402/extensions": "^2.4.0",
+    "@x402/hono": "^2.4.0",
+    "hono": "^4.7.0",
+    "viem": "^2.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@changesets/cli": "^2.27.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsc -b --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "release": "pnpm build && changeset publish"
+  }
+}