@azeth/provider 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Azeth.ai
+
+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,70 @@
+# @azeth/provider
+
+x402 service provider tooling for [Azeth](https://azeth.ai). Gate your Hono endpoints behind x402 payments with built-in payment-agreement support, SIWx sessions, and automatic reputation feedback.
+
+## Installation
+
+```bash
+npm install @azeth/provider
+# or
+pnpm add @azeth/provider
+```
+
+## Quick Start
+
+```typescript
+import { Hono } from 'hono';
+import { createX402StackFromEnv } from '@azeth/provider';
+
+const app = new Hono();
+
+const { middleware, facilitator } = await createX402StackFromEnv({
+  app,
+  routes: {
+    '/api/data': { price: '$0.01', resource: 'https://api.example.com/data' },
+  },
+});
+
+app.use('/api/*', middleware);
+
+app.get('/api/data', (c) => c.json({ answer: 42 }));
+```
+
+## Features
+
+- **x402 Payment Middleware** -- Returns 402 with payment requirements, validates on-chain USDC settlement
+- **Payment Agreements** -- Recurring subscriptions via on-chain `PaymentAgreementModule`
+- **SIWx Sessions** -- Agreement-aware session storage for repeat customers
+- **Agreement Keeper** -- Periodic execution of due payment agreements
+- **Pre-Settled Payments** -- Middleware for endpoints accepting pre-settled x402 proofs
+- **Local Facilitator** -- On-chain payment verification without external facilitator dependency
+
+## API
+
+### Stack Setup
+
+| Export | Description |
+|---|---|
+| `createX402Stack(config)` | Create x402 middleware + facilitator from explicit config |
+| `createX402StackFromEnv(options)` | Create from environment variables |
+| `LocalFacilitatorClient` | On-chain USDC settlement verification |
+
+### Payment Agreements
+
+| Export | Description |
+|---|---|
+| `createPaymentAgreementExtension()` | x402 extension for agreement-based payments |
+| `AzethSIWxStorage` | Agreement-aware SIWx session storage |
+| `AgreementKeeper` | Periodic execution of due agreements |
+| `findActiveAgreementForPayee()` | LRU-cached agreement lookup |
+
+### Middleware
+
+| Export | Description |
+|---|---|
+| `preSettledPaymentMiddleware` | Accept pre-settled x402 payment proofs |
+| `paymentMiddlewareFromHTTPServer` | Standard x402 HTTP resource server middleware |
+
+## License
+
+MIT

package/dist/agreement-cache.d.ts

@@ -0,0 +1,20 @@
+import type { PublicClient, Chain, Transport } from 'viem';
+import type { PaymentAgreement } from '@azeth/common';
+/** Set the cache TTL (useful for tests) */
+export declare function setAgreementCacheTtl(ttlMs: number): void;
+/** Clear the agreement cache */
+export declare function clearAgreementCache(): void;
+/** Find an active, executable agreement from a given account to a specific payee.
+ *  Uses getAgreementData for combined agreement + executability + count in 1 RPC call.
+ *  Iterates from newest to oldest (newest more likely active).
+ *
+ *  @param publicClient - viem public client for on-chain reads
+ *  @param moduleAddress - PaymentAgreementModule contract address
+ *  @param account - The payer's smart account address
+ *  @param payee - The payee address to match
+ *  @param token - Optional token address to match
+ *  @param minAmount - Optional minimum amount per interval
+ *  @returns The first matching active + executable agreement, or null
+ */
+export declare function findActiveAgreementForPayee(publicClient: PublicClient<Transport, Chain>, moduleAddress: `0x${string}`, account: `0x${string}`, payee: `0x${string}`, token?: `0x${string}`, minAmount?: bigint): Promise<PaymentAgreement | null>;
+//# sourceMappingURL=agreement-cache.d.ts.map

package/dist/agreement-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement-cache.d.ts","sourceRoot":"","sources":["../src/agreement-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAkBtD,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,gCAAgC;AAChC,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAwHD;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,EAC5C,aAAa,EAAE,KAAK,MAAM,EAAE,EAC5B,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,KAAK,EAAE,KAAK,MAAM,EAAE,EACpB,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuBlC"}

package/dist/agreement-cache.js

@@ -0,0 +1,133 @@
+import { PaymentAgreementModuleAbi } from '@azeth/common/abis';
+const _agreementCache = new Map();
+let _cacheTtlMs = 60_000; // 60 seconds default
+const MAX_CACHE_SIZE = 5_000;
+/** Set the cache TTL (useful for tests) */
+export function setAgreementCacheTtl(ttlMs) {
+    _cacheTtlMs = ttlMs;
+}
+/** Clear the agreement cache */
+export function clearAgreementCache() {
+    _agreementCache.clear();
+}
+/** Get a cached agreement with executability, fetching from chain if stale or missing.
+ *  Uses getAgreementData for a single RPC call instead of 3 separate calls.
+ *  Returns stale cache on RPC error (stale-on-error pattern). */
+async function getCachedAgreement(publicClient, moduleAddress, account, agreementId) {
+    const key = `${account.toLowerCase()}:${agreementId.toString()}`;
+    const cached = _agreementCache.get(key);
+    const now = Date.now();
+    if (cached && (now - cached.fetchedAt) < _cacheTtlMs) {
+        cached.lastAccessedAt = now;
+        return cached;
+    }
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: PaymentAgreementModuleAbi,
+            functionName: 'getAgreementData',
+            args: [account, agreementId],
+        });
+        const agreement = {
+            id: agreementId,
+            payee: result[0].payee,
+            token: result[0].token,
+            amount: result[0].amount,
+            interval: result[0].interval,
+            endTime: result[0].endTime,
+            lastExecuted: result[0].lastExecuted,
+            maxExecutions: result[0].maxExecutions,
+            executionCount: result[0].executionCount,
+            totalCap: result[0].totalCap,
+            totalPaid: result[0].totalPaid,
+            active: result[0].active,
+        };
+        const entry = {
+            agreement,
+            executable: result[1],
+            reason: result[2],
+            isDue: result[3],
+            nextExecutionTime: result[4],
+            count: result[5],
+            fetchedAt: now,
+            lastAccessedAt: now,
+        };
+        // LRU eviction if at capacity
+        if (_agreementCache.size >= MAX_CACHE_SIZE && !_agreementCache.has(key)) {
+            let lruKey;
+            let lruTime = Infinity;
+            for (const [k, v] of _agreementCache) {
+                if (v.lastAccessedAt < lruTime) {
+                    lruTime = v.lastAccessedAt;
+                    lruKey = k;
+                }
+            }
+            if (lruKey !== undefined)
+                _agreementCache.delete(lruKey);
+        }
+        _agreementCache.set(key, entry);
+        return entry;
+    }
+    catch {
+        // Stale-on-error: return stale cache if available (optimistic grant)
+        return cached ?? null;
+    }
+}
+/** Check if an agreement is currently active and valid (metadata only — no balance check) */
+function isAgreementValid(agreement, payee, token, minAmount) {
+    if (!agreement.active)
+        return false;
+    if (agreement.payee.toLowerCase() !== payee.toLowerCase())
+        return false;
+    if (token && agreement.token.toLowerCase() !== token.toLowerCase())
+        return false;
+    if (minAmount && agreement.amount < minAmount)
+        return false;
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    // Check expiry (0 = no expiry)
+    if (agreement.endTime !== 0n && agreement.endTime <= now)
+        return false;
+    // Check max executions (0 = unlimited)
+    if (agreement.maxExecutions !== 0n && agreement.executionCount >= agreement.maxExecutions)
+        return false;
+    // Check total cap (0 = unlimited) — defense-in-depth alongside contract's executable flag
+    if (agreement.totalCap !== 0n && agreement.totalPaid >= agreement.totalCap)
+        return false;
+    return true;
+}
+/** Find an active, executable agreement from a given account to a specific payee.
+ *  Uses getAgreementData for combined agreement + executability + count in 1 RPC call.
+ *  Iterates from newest to oldest (newest more likely active).
+ *
+ *  @param publicClient - viem public client for on-chain reads
+ *  @param moduleAddress - PaymentAgreementModule contract address
+ *  @param account - The payer's smart account address
+ *  @param payee - The payee address to match
+ *  @param token - Optional token address to match
+ *  @param minAmount - Optional minimum amount per interval
+ *  @returns The first matching active + executable agreement, or null
+ */
+export async function findActiveAgreementForPayee(publicClient, moduleAddress, account, payee, token, minAmount) {
+    // Get count from first getAgreementData call (avoids separate getAgreementCount RPC)
+    // Start with agreementId=0 to get the count, then iterate from newest
+    const first = await getCachedAgreement(publicClient, moduleAddress, account, 0n);
+    if (!first)
+        return null;
+    const count = first.count;
+    if (count === 0n)
+        return null;
+    // Iterate from newest to oldest
+    for (let i = count - 1n; i >= 0n; i--) {
+        const cached = await getCachedAgreement(publicClient, moduleAddress, account, i);
+        if (!cached)
+            continue;
+        if (!isAgreementValid(cached.agreement, payee, token, minAmount))
+            continue;
+        // Check executability (balance + guardian checks) — already in cache, no extra RPC
+        if (!cached.executable)
+            continue;
+        return cached.agreement;
+    }
+    return null;
+}
+//# sourceMappingURL=agreement-cache.js.map

package/dist/agreement-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement-cache.js","sourceRoot":"","sources":["../src/agreement-cache.ts"],"names":[],"mappings":"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"}

package/dist/agreement-keeper.d.ts

@@ -0,0 +1,43 @@
+import type { PublicClient, WalletClient, Chain, Transport, Account } from 'viem';
+/** Configuration for the AgreementKeeper */
+export interface AgreementKeeperConfig {
+    /** Public client for on-chain reads */
+    publicClient: PublicClient<Transport, Chain>;
+    /** Wallet client for gas settlement (facilitator wallet) */
+    walletClient: WalletClient<Transport, Chain, Account>;
+    /** PaymentAgreementModule contract address */
+    moduleAddress: `0x${string}`;
+    /** How often to scan for due agreements (ms). Default: 60_000 */
+    scanIntervalMs?: number;
+    /** Maximum executions per scan cycle. Default: 20 */
+    maxExecutionsPerScan?: number;
+}
+/** AgreementKeeper — executes due payment agreements so services receive recurring revenue.
+ *
+ *  The keeper is notified when x402Storage.hasPaid() discovers an on-chain agreement.
+ *  It periodically checks if tracked agreements are due for execution and calls
+ *  executeAgreement() on the PaymentAgreementModule.
+ *
+ *  executeAgreement() is permissionless — anyone can call it — so the facilitator
+ *  wallet only pays gas, not the agreement amount.
+ */
+export declare class AgreementKeeper {
+    private timer;
+    private readonly trackedAgreements;
+    private readonly config;
+    private readonly scanIntervalMs;
+    private readonly maxExecutionsPerScan;
+    constructor(config: AgreementKeeperConfig);
+    /** Register an agreement for periodic execution.
+     *  Called by x402Storage.hasPaid() when an agreement is discovered. */
+    trackAgreement(account: `0x${string}`, agreementId: bigint): void;
+    /** Number of tracked agreements */
+    get trackedCount(): number;
+    /** Start the periodic scan loop */
+    start(): void;
+    /** Stop the keeper (for graceful shutdown) */
+    stop(): void;
+    /** Run a single scan: check + execute due agreements */
+    scan(): Promise<void>;
+}
+//# sourceMappingURL=agreement-keeper.d.ts.map

package/dist/agreement-keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement-keeper.d.ts","sourceRoot":"","sources":["../src/agreement-keeper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAUlF,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,8CAA8C;IAC9C,aAAa,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,MAAM,EAAE,qBAAqB;IAMzC;2EACuE;IACvE,cAAc,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAUjE,mCAAmC;IACnC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,mCAAmC;IACnC,KAAK,IAAI,IAAI;IAab,8CAA8C;IAC9C,IAAI,IAAI,IAAI;IAOZ,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAqD5B"}

package/dist/agreement-keeper.js

@@ -0,0 +1,102 @@
+import { PaymentAgreementModuleAbi } from '@azeth/common/abis';
+/** AgreementKeeper — executes due payment agreements so services receive recurring revenue.
+ *
+ *  The keeper is notified when x402Storage.hasPaid() discovers an on-chain agreement.
+ *  It periodically checks if tracked agreements are due for execution and calls
+ *  executeAgreement() on the PaymentAgreementModule.
+ *
+ *  executeAgreement() is permissionless — anyone can call it — so the facilitator
+ *  wallet only pays gas, not the agreement amount.
+ */
+export class AgreementKeeper {
+    timer = null;
+    trackedAgreements = new Map();
+    config;
+    scanIntervalMs;
+    maxExecutionsPerScan;
+    constructor(config) {
+        this.config = config;
+        this.scanIntervalMs = config.scanIntervalMs ?? 60_000;
+        this.maxExecutionsPerScan = config.maxExecutionsPerScan ?? 20;
+    }
+    /** Register an agreement for periodic execution.
+     *  Called by x402Storage.hasPaid() when an agreement is discovered. */
+    trackAgreement(account, agreementId) {
+        const key = `${account.toLowerCase()}:${agreementId}`;
+        if (this.trackedAgreements.has(key))
+            return;
+        this.trackedAgreements.set(key, {
+            account,
+            agreementId,
+            lastChecked: 0,
+        });
+    }
+    /** Number of tracked agreements */
+    get trackedCount() {
+        return this.trackedAgreements.size;
+    }
+    /** Start the periodic scan loop */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.scan().catch((err) => {
+                console.error('[AgreementKeeper] Scan error:', err instanceof Error ? err.message : err);
+            });
+        }, this.scanIntervalMs);
+        this.timer.unref();
+    }
+    /** Stop the keeper (for graceful shutdown) */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Run a single scan: check + execute due agreements */
+    async scan() {
+        let executed = 0;
+        const keysToRemove = [];
+        for (const [key, entry] of this.trackedAgreements) {
+            if (executed >= this.maxExecutionsPerScan)
+                break;
+            try {
+                // Check if the agreement is due for execution (view call, no gas)
+                const result = await this.config.publicClient.readContract({
+                    address: this.config.moduleAddress,
+                    abi: PaymentAgreementModuleAbi,
+                    functionName: 'canExecutePayment',
+                    args: [entry.account, entry.agreementId],
+                });
+                const [executable, reason] = result;
+                if (!executable) {
+                    entry.lastChecked = Date.now();
+                    // Remove completed/cancelled agreements from tracking to avoid unnecessary scans
+                    if (reason.includes('not active') || reason.includes('max executions') || reason.includes('total cap')) {
+                        keysToRemove.push(key);
+                    }
+                    continue;
+                }
+                // Execute the agreement (state-changing, requires gas)
+                await this.config.walletClient.writeContract({
+                    address: this.config.moduleAddress,
+                    abi: PaymentAgreementModuleAbi,
+                    functionName: 'executeAgreement',
+                    args: [entry.account, entry.agreementId],
+                });
+                executed++;
+                entry.lastChecked = Date.now();
+                console.log(`[AgreementKeeper] Executed agreement ${entry.agreementId} for ${entry.account}`);
+            }
+            catch (err) {
+                // Individual failure is non-fatal — continue with other agreements
+                console.warn(`[AgreementKeeper] Failed to execute agreement ${entry.agreementId} for ${entry.account}:`, err instanceof Error ? err.message : err);
+            }
+        }
+        // Clean up completed/cancelled agreements after iteration
+        for (const key of keysToRemove) {
+            this.trackedAgreements.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=agreement-keeper.js.map

package/dist/agreement-keeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement-keeper.js","sourceRoot":"","sources":["../src/agreement-keeper.ts"],"names":[],"mappings":"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"}

package/dist/examples/index.d.ts

@@ -0,0 +1,4 @@
+export { isSupportedCoin, getPrice, getFreshPrice, clearPriceCache } from './price-feed.js';
+export type { SupportedCoinId, PriceData } from './price-feed.js';
+export { createPricingRoutes } from './pricing-routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/examples/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/examples/index.js

@@ -0,0 +1,3 @@
+export { isSupportedCoin, getPrice, getFreshPrice, clearPriceCache } from './price-feed.js';
+export { createPricingRoutes } from './pricing-routes.js';
+//# sourceMappingURL=index.js.map

package/dist/examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/examples/price-feed.d.ts

@@ -0,0 +1,22 @@
+/** Supported CoinGecko coin identifiers */
+declare const SUPPORTED_COINS: readonly ["bitcoin", "ethereum", "solana", "usd-coin", "chainlink", "aave", "uniswap", "maker", "compound-governance-token"];
+export type SupportedCoinId = (typeof SUPPORTED_COINS)[number];
+/** Price data returned by the service */
+export interface PriceData {
+    coinId: string;
+    price: number;
+    currency: string;
+    timestamp: number;
+    source: 'coingecko';
+}
+/** Check if a coin ID is in the supported whitelist */
+export declare function isSupportedCoin(coinId: string): coinId is SupportedCoinId;
+/** Get a price with caching. Returns cached data if within TTL, otherwise fetches fresh.
+ *  On fetch failure, returns stale cache if available (stale-on-error). */
+export declare function getPrice(coinId: SupportedCoinId, currency?: string): Promise<PriceData>;
+/** Bypass cache and fetch fresh data. Rate-limited to 1 per coin per 10 seconds. */
+export declare function getFreshPrice(coinId: SupportedCoinId, currency?: string): Promise<PriceData>;
+/** Clear all cached data (for tests) */
+export declare function clearPriceCache(): void;
+export {};
+//# sourceMappingURL=price-feed.d.ts.map

package/dist/examples/price-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-feed.d.ts","sourceRoot":"","sources":["../../src/examples/price-feed.ts"],"names":[],"mappings":"AAEA,2CAA2C;AAC3C,QAAA,MAAM,eAAe,8HAUX,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB;AAeD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,eAAe,CAEzE;AAuFD;2EAC2E;AAC3E,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBpG;AAED,oFAAoF;AACpF,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAiBzG;AAED,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/examples/price-feed.js

@@ -0,0 +1,148 @@
+import { AzethError } from '@azeth/common';
+/** Supported CoinGecko coin identifiers */
+const SUPPORTED_COINS = [
+    'bitcoin',
+    'ethereum',
+    'solana',
+    'usd-coin',
+    'chainlink',
+    'aave',
+    'uniswap',
+    'maker',
+    'compound-governance-token',
+];
+const CACHE_TTL_MS = 60_000; // 60 seconds
+const MAX_CACHE_ENTRIES = 100;
+const FETCH_TIMEOUT_MS = 10_000;
+const FORCE_REFRESH_COOLDOWN_MS = 10_000; // 1 per coin per 10s
+const priceCache = new Map();
+const lastForceRefresh = new Map();
+/** Check if a coin ID is in the supported whitelist */
+export function isSupportedCoin(coinId) {
+    return SUPPORTED_COINS.includes(coinId);
+}
+/** Build a cache key from coin ID and currency */
+function cacheKey(coinId, currency) {
+    return `${coinId}:${currency}`;
+}
+/** Fetch a price from CoinGecko */
+async function fetchFromCoinGecko(coinId, currency) {
+    const url = `https://api.coingecko.com/api/v3/simple/price?ids=${encodeURIComponent(coinId)}&vs_currencies=${encodeURIComponent(currency)}`;
+    let response;
+    try {
+        response = await fetch(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            throw new AzethError('CoinGecko request timed out', 'NETWORK_ERROR', {
+                coinId,
+                timeoutMs: FETCH_TIMEOUT_MS,
+            });
+        }
+        // TimeoutError from AbortSignal.timeout
+        if (err instanceof Error && err.name === 'TimeoutError') {
+            throw new AzethError('CoinGecko request timed out', 'NETWORK_ERROR', {
+                coinId,
+                timeoutMs: FETCH_TIMEOUT_MS,
+            });
+        }
+        throw new AzethError('CoinGecko request failed', 'NETWORK_ERROR', {
+            coinId,
+            detail: err instanceof Error ? err.message : 'Unknown error',
+        });
+    }
+    if (response.status === 429) {
+        const retryAfter = response.headers.get('Retry-After');
+        throw new AzethError('CoinGecko rate limit exceeded', 'NETWORK_ERROR', {
+            coinId,
+            retryAfterSeconds: retryAfter ? parseInt(retryAfter, 10) : 60,
+        });
+    }
+    if (!response.ok) {
+        throw new AzethError('CoinGecko returned error', 'NETWORK_ERROR', {
+            coinId,
+            status: response.status,
+        });
+    }
+    const json = (await response.json());
+    const coinData = json[coinId];
+    const price = coinData?.[currency];
+    if (typeof price !== 'number') {
+        throw new AzethError('Malformed CoinGecko response', 'NETWORK_ERROR', {
+            coinId,
+            detail: `Missing price for ${coinId} in ${currency}`,
+        });
+    }
+    return {
+        coinId,
+        price,
+        currency,
+        timestamp: Math.floor(Date.now() / 1000),
+        source: 'coingecko',
+    };
+}
+/** Evict the oldest cache entry if at capacity */
+function evictIfNeeded() {
+    if (priceCache.size >= MAX_CACHE_ENTRIES) {
+        // Evict oldest entry
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [k, v] of priceCache) {
+            if (v.fetchedAt < oldestTime) {
+                oldestTime = v.fetchedAt;
+                oldestKey = k;
+            }
+        }
+        if (oldestKey !== undefined)
+            priceCache.delete(oldestKey);
+    }
+}
+/** Get a price with caching. Returns cached data if within TTL, otherwise fetches fresh.
+ *  On fetch failure, returns stale cache if available (stale-on-error). */
+export async function getPrice(coinId, currency = 'usd') {
+    const key = cacheKey(coinId, currency);
+    const cached = priceCache.get(key);
+    const now = Date.now();
+    // Cache hit — within TTL
+    if (cached && (now - cached.fetchedAt) < CACHE_TTL_MS) {
+        return cached.data;
+    }
+    // Cache miss or stale — fetch fresh
+    try {
+        const data = await fetchFromCoinGecko(coinId, currency);
+        evictIfNeeded();
+        priceCache.set(key, { data, fetchedAt: now });
+        return data;
+    }
+    catch (err) {
+        // Stale-on-error: return stale cache if available
+        if (cached) {
+            return cached.data;
+        }
+        throw err;
+    }
+}
+/** Bypass cache and fetch fresh data. Rate-limited to 1 per coin per 10 seconds. */
+export async function getFreshPrice(coinId, currency = 'usd') {
+    const key = cacheKey(coinId, currency);
+    const now = Date.now();
+    // Rate limit: 1 fresh fetch per coin per 10s
+    const lastRefresh = lastForceRefresh.get(key);
+    if (lastRefresh && (now - lastRefresh) < FORCE_REFRESH_COOLDOWN_MS) {
+        // Fall back to cached or regular fetch
+        return getPrice(coinId, currency);
+    }
+    lastForceRefresh.set(key, now);
+    const data = await fetchFromCoinGecko(coinId, currency);
+    evictIfNeeded();
+    priceCache.set(key, { data, fetchedAt: now });
+    return data;
+}
+/** Clear all cached data (for tests) */
+export function clearPriceCache() {
+    priceCache.clear();
+    lastForceRefresh.clear();
+}
+//# sourceMappingURL=price-feed.js.map

package/dist/examples/price-feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-feed.js","sourceRoot":"","sources":["../../src/examples/price-feed.ts"],"names":[],"mappings":"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"}

package/dist/examples/pricing-routes.d.ts

@@ -0,0 +1,15 @@
+import { Hono } from 'hono';
+import type { x402HTTPResourceServer } from '@x402/core/server';
+import type { ProviderEnv } from '../middleware/pre-settled.js';
+/** Create the x402-gated pricing routes.
+ *
+ *  Uses @x402/hono middleware for V2 protocol support including:
+ *  - PAYMENT-SIGNATURE / PAYMENT-RESPONSE headers (v2)
+ *  - SIWx wallet-based sessions (pay once, then access via wallet sig)
+ *  - Payment agreement extension (subscription terms in 402 response)
+ *  - Pre-settled smart account payments (X-Payment-Tx header bypass)
+ *
+ *  When httpServer is null, all routes return 503 (graceful degradation).
+ */
+export declare function createPricingRoutes(httpServer: x402HTTPResourceServer | null): Hono<ProviderEnv>;
+//# sourceMappingURL=pricing-routes.d.ts.map

package/dist/examples/pricing-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-routes.d.ts","sourceRoot":"","sources":["../../src/examples/pricing-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAwEhG"}