@bankofai/x402 0.5.9 → 0.6.0-beta.0

package/dist/mechanisms/_exact_base/facilitator.js.map

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

package/dist/mechanisms/_exact_base/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared base for the `exact` scheme — mirrors Python
+ * `bankofai.x402.mechanisms._exact_base`.
+ */
+export { DEFAULT_VALIDITY_SECONDS, SCHEME_EXACT, TRANSFER_AUTH_EIP712_TYPES, TRANSFER_AUTH_PRIMARY_TYPE, buildEip712Domain, buildEip712Message, createNonce, createValidityWindow, } from './types.js';
+export type { TransferAuthorization } from './types.js';
+export type { ChainAdapter } from './adapter.js';
+export { EvmChainAdapter } from './evmAdapter.js';
+export { TronChainAdapter } from './tronAdapter.js';
+export { ExactBaseServerMechanism } from './server.js';
+export { ExactBaseFacilitatorMechanism } from './facilitator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mechanisms/_exact_base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/_exact_base/index.js

@@ -0,0 +1,10 @@
+/**
+ * Shared base for the `exact` scheme — mirrors Python
+ * `bankofai.x402.mechanisms._exact_base`.
+ */
+export { DEFAULT_VALIDITY_SECONDS, SCHEME_EXACT, TRANSFER_AUTH_EIP712_TYPES, TRANSFER_AUTH_PRIMARY_TYPE, buildEip712Domain, buildEip712Message, createNonce, createValidityWindow, } from './types.js';
+export { EvmChainAdapter } from './evmAdapter.js';
+export { TronChainAdapter } from './tronAdapter.js';
+export { ExactBaseServerMechanism } from './server.js';
+export { ExactBaseFacilitatorMechanism } from './facilitator.js';
+//# sourceMappingURL=index.js.map

package/dist/mechanisms/_exact_base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/_exact_base/server.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared base for `exact` scheme server mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_base.base.ExactBaseServerMechanism`.
+ *
+ * Per-chain mechanisms (`evm/exact/server.ts`, `tron/exact/server.ts`)
+ * subclass this and provide a {@link ChainAdapter}. The base handles:
+ * - price parsing (delegate to {@link parsePrice})
+ * - requirements enhancement (token name / version from registry)
+ * - basic validation (network + address format)
+ *
+ * `verify_signature` requires on-chain or chain-specific signing libs — left
+ * abstract here for subclasses to implement with their chain's tooling.
+ */
+import type { ChainAdapter } from './adapter.js';
+import type { ServerMechanism } from '../../server/types.js';
+import type { PaymentPayload, PaymentPermit, PaymentRequirements } from '../../types/index.js';
+export declare abstract class ExactBaseServerMechanism implements ServerMechanism {
+    protected readonly adapter: ChainAdapter;
+    constructor(adapter: ChainAdapter);
+    scheme(): string;
+    parsePrice(price: string, network: string): Promise<import("../../tokens.js").AssetAmount>;
+    /**
+     * Attach token name + version to `extra` so clients have everything needed
+     * to build the EIP-712 / TIP-712 typed-data domain.
+     */
+    enhancePaymentRequirements(requirements: PaymentRequirements, _deliveryMode: string): Promise<PaymentRequirements>;
+    validatePaymentRequirements(requirements: PaymentRequirements): boolean;
+    /**
+     * Server-side signature verification. Chain-specific — subclasses must
+     * implement using their chain's signature recovery primitives (viem for
+     * EVM, tron-utils for TRON).
+     *
+     * For `exact`, the signed object is the `authorization` (ERC-3009-style).
+     */
+    abstract verifySignature(permit: PaymentPermit | null | undefined, signature: string, network: string): Promise<boolean>;
+    /** Convenience hook to pull the authorization out of a payload. */
+    protected extractAuthorization(payload: PaymentPayload): PaymentPayload['payload']['authorization'] | null;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mechanisms/_exact_base/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,8BAAsB,wBAAyB,YAAW,eAAe;IAC3D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY;gBAArB,OAAO,EAAE,YAAY;IAEpD,MAAM,IAAI,MAAM;IAIV,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAI/C;;;OAGG;IACG,0BAA0B,CAC9B,YAAY,EAAE,mBAAmB,EACjC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAa/B,2BAA2B,CAAC,YAAY,EAAE,mBAAmB,GAAG,OAAO;IAOvE;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CACtB,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IAEnB,mEAAmE;IACnE,SAAS,CAAC,oBAAoB,CAC5B,OAAO,EAAE,cAAc,GACtB,cAAc,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,GAAG,IAAI;CAKrD"}

package/dist/mechanisms/_exact_base/server.js

@@ -0,0 +1,62 @@
+/**
+ * Shared base for `exact` scheme server mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_base.base.ExactBaseServerMechanism`.
+ *
+ * Per-chain mechanisms (`evm/exact/server.ts`, `tron/exact/server.ts`)
+ * subclass this and provide a {@link ChainAdapter}. The base handles:
+ * - price parsing (delegate to {@link parsePrice})
+ * - requirements enhancement (token name / version from registry)
+ * - basic validation (network + address format)
+ *
+ * `verify_signature` requires on-chain or chain-specific signing libs — left
+ * abstract here for subclasses to implement with their chain's tooling.
+ */
+import { parsePrice, findByAddress } from '../../tokens.js';
+import { SCHEME_EXACT } from './types.js';
+export class ExactBaseServerMechanism {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    scheme() {
+        return SCHEME_EXACT;
+    }
+    async parsePrice(price, network) {
+        return parsePrice(price, network);
+    }
+    /**
+     * Attach token name + version to `extra` so clients have everything needed
+     * to build the EIP-712 / TIP-712 typed-data domain.
+     */
+    async enhancePaymentRequirements(requirements, _deliveryMode) {
+        const token = findByAddress(requirements.network, requirements.asset);
+        if (!token)
+            return requirements;
+        return {
+            ...requirements,
+            extra: {
+                ...(requirements.extra ?? {}),
+                name: token.name,
+                ...(token.version ? { version: token.version } : {}),
+            },
+        };
+    }
+    validatePaymentRequirements(requirements) {
+        if (!this.adapter.validateNetwork(requirements.network))
+            return false;
+        if (!this.adapter.validateAddress(requirements.asset))
+            return false;
+        if (!this.adapter.validateAddress(requirements.payTo))
+            return false;
+        return true;
+    }
+    /** Convenience hook to pull the authorization out of a payload. */
+    extractAuthorization(payload) {
+        if (payload.payload.authorization)
+            return payload.payload.authorization;
+        const ext = (payload.extensions ?? {})['transferAuthorization'];
+        return ext ?? null;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mechanisms/_exact_base/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,OAAgB,wBAAwB;IACb;IAA/B,YAA+B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAExD,MAAM;QACJ,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAe;QAC7C,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,0BAA0B,CAC9B,YAAiC,EACjC,aAAqB;QAErB,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK;YAAE,OAAO,YAAY,CAAC;QAChC,OAAO;YACL,GAAG,YAAY;YACf,KAAK,EAAE;gBACL,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED,2BAA2B,CAAC,YAAiC;QAC3D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,mEAAmE;IACzD,oBAAoB,CAC5B,OAAuB;QAEvB,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QACxE,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAChE,OAAQ,GAAkD,IAAI,IAAI,CAAC;IACrE,CAAC;CACF"}

package/dist/mechanisms/_exact_base/tronAdapter.d.ts

@@ -0,0 +1,11 @@
+import type { ChainAdapter } from './adapter.js';
+/** TRON (`tron:<name>`) ChainAdapter. */
+export declare class TronChainAdapter implements ChainAdapter {
+    parseChainId(network: string): number;
+    validateNetwork(network: string): boolean;
+    validateAddress(address: string): boolean;
+    normalizeAddress(address: string): string;
+    /** TIP-712 requires 0x-prefixed EVM-hex form for every address field. */
+    toSigningAddress(address: string): string;
+}
+//# sourceMappingURL=tronAdapter.d.ts.map

package/dist/mechanisms/_exact_base/tronAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tronAdapter.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/tronAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAUjD,yCAAyC;AACzC,qBAAa,gBAAiB,YAAW,YAAY;IACnD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQrC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQzC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAYzC,yEAAyE;IACzE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG1C"}

package/dist/mechanisms/_exact_base/tronAdapter.js

@@ -0,0 +1,48 @@
+import { TronAddressConverter, toBase58 } from '../../address.js';
+const TRON_CHAIN_IDS = {
+    'tron:mainnet': 728126428,
+    'tron:shasta': 2494104990,
+    'tron:nile': 3448148188,
+};
+const TRON_CONVERTER = new TronAddressConverter();
+/** TRON (`tron:<name>`) ChainAdapter. */
+export class TronChainAdapter {
+    parseChainId(network) {
+        const id = TRON_CHAIN_IDS[network];
+        if (id === undefined) {
+            throw new Error(`Unknown TRON network: ${network}`);
+        }
+        return id;
+    }
+    validateNetwork(network) {
+        return network.startsWith('tron:');
+    }
+    validateAddress(address) {
+        if (typeof address !== 'string')
+            return false;
+        // Accept both Base58 (T...) and 0x-prefixed hex forms
+        if (address.startsWith('T') && address.length === 34)
+            return true;
+        if (address.startsWith('0x') && address.length === 42)
+            return true;
+        return false;
+    }
+    normalizeAddress(address) {
+        if (!this.validateAddress(address))
+            return address;
+        if (address.startsWith('0x')) {
+            try {
+                return toBase58(address);
+            }
+            catch {
+                return address;
+            }
+        }
+        return address;
+    }
+    /** TIP-712 requires 0x-prefixed EVM-hex form for every address field. */
+    toSigningAddress(address) {
+        return TRON_CONVERTER.toEvmFormat(address);
+    }
+}
+//# sourceMappingURL=tronAdapter.js.map

package/dist/mechanisms/_exact_base/tronAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tronAdapter.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/tronAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGlE,MAAM,cAAc,GAA2B;IAC7C,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,UAAU;IACzB,WAAW,EAAE,UAAU;CACxB,CAAC;AAEF,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAElD,yCAAyC;AACzC,MAAM,OAAO,gBAAgB;IAC3B,YAAY,CAAC,OAAe;QAC1B,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe,CAAC,OAAe;QAC7B,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,eAAe,CAAC,OAAe;QAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,sDAAsD;QACtD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAClE,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CAAC,OAAe;QAC9B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACnD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,yEAAyE;IACzE,gBAAgB,CAAC,OAAe;QAC9B,OAAO,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/mechanisms/{nativeExact.d.ts → _exact_base/types.d.ts}

@@ -4,9 +4,9 @@
  * exact uses ERC-3009 TransferWithAuthorization for direct token transfers
  * without going through a PaymentPermit contract.
  */
-import type { Hex } from '../address.js';
-import type { TransferAuthorization } from '../types/payment.js';
-export type { TransferAuthorization } from '../types/payment.js';
+import type { Hex } from '../../address.js';
+import type { TransferAuthorization } from '../../types/payment.js';
+export type { TransferAuthorization } from '../../types/payment.js';
 /** Scheme name */
 export declare const SCHEME_EXACT = "exact";
 /** Default validity period (1 hour) */
@@ -54,4 +54,4 @@ export declare function createNonce(): string;
  * Adds a 30-second buffer before now to account for clock skew.
  */
 export declare function createValidityWindow(duration?: number): [number, number];
-//# sourceMappingURL=nativeExact.d.ts.map
+//# sourceMappingURL=types.d.ts.map

package/dist/mechanisms/_exact_base/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,kBAAkB;AAClB,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,uCAAuC;AACvC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;CAS7B,CAAC;AAEX,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,MAAiC,GAC1C,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB"}

package/dist/mechanisms/{nativeExact.js → _exact_base/types.js}

@@ -63,4 +63,4 @@ export function createValidityWindow(duration = DEFAULT_VALIDITY_SECONDS) {
     const now = Math.floor(Date.now() / 1000);
     return [now - 30, now + duration];
 }
-//# sourceMappingURL=nativeExact.js.map
+//# sourceMappingURL=types.js.map

package/dist/mechanisms/_exact_base/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_base/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,kBAAkB;AAClB,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC,uCAAuC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,yBAAyB,EAAE;QACzB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;QAC/B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;QACvC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACxC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;KACnC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG,2BAA2B,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,YAAoB,EACpB,OAAe,EACf,iBAAyB;IAEzB,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,YAAY;QACrB,OAAO;QACP,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA2B,EAC3B,gBAAuC;IAEvC,OAAO;QACL,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,wBAAwB;IAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/mechanisms/_exact_permit_base/facilitator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared base for `exact_permit` scheme facilitator mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_permit_base.facilitator.BaseExactPermitFacilitatorMechanism`.
+ */
+import type { FacilitatorMechanism } from '../../facilitator/x402Facilitator.js';
+import type { FeeQuoteResponse, PaymentPayload, PaymentRequirements, SettleResponse, VerifyResponse } from '../../types/index.js';
+/** Fee policy used by `feeQuote`. */
+export interface BaseExactPermitFee {
+    /** Address that collects the facilitator fee. */
+    feeTo: string;
+    /** Optional caller address that the on-chain contract requires. */
+    caller?: string;
+    /**
+     * Base fee in smallest unit, keyed by `${network}:${tokenAddress}`. Tokens
+     * not in this map use {@link defaultBaseFee}.
+     */
+    baseFeesByToken?: Record<string, string>;
+    /** Fallback fee when no per-token entry matches. Default `"0"`. */
+    defaultBaseFee?: string;
+}
+export declare abstract class BaseExactPermitFacilitatorMechanism implements FacilitatorMechanism {
+    protected readonly fee: BaseExactPermitFee;
+    constructor(fee: BaseExactPermitFee);
+    scheme(): string;
+    feeQuote(accept: PaymentRequirements, _context?: Record<string, unknown>): Promise<FeeQuoteResponse | null>;
+    /**
+     * Off-chain verify path: structural checks live here, signature + balance
+     * + nonce + on-chain state checks go in subclass.
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Chain-specific on-chain verification. Default: trust upstream
+     * (returns `isValid: true`). Subclasses MUST override for real
+     * signature recovery + balance + nonce checks.
+     */
+    protected verifyOnChain(_payload: PaymentPayload, _requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Submit the permit on-chain. Chain-specific — subclasses MUST implement
+     * via viem (EVM) / tronweb (TRON).
+     */
+    abstract settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/mechanisms/_exact_permit_base/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/facilitator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8BAAsB,mCAAoC,YAAW,oBAAoB;IAC3E,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAEtD,MAAM,IAAI,MAAM;IAIV,QAAQ,CACZ,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAiBnC;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAuB1B;;;;OAIG;cACa,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,aAAa,EAAE,mBAAmB,GACjC,OAAO,CAAC,cAAc,CAAC;IAI1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CACb,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;CAC3B"}

package/dist/mechanisms/_exact_permit_base/facilitator.js

@@ -0,0 +1,65 @@
+/**
+ * Shared base for `exact_permit` scheme facilitator mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_permit_base.facilitator.BaseExactPermitFacilitatorMechanism`.
+ */
+const SCHEME_EXACT_PERMIT = 'exact_permit';
+export class BaseExactPermitFacilitatorMechanism {
+    fee;
+    constructor(fee) {
+        this.fee = fee;
+    }
+    scheme() {
+        return SCHEME_EXACT_PERMIT;
+    }
+    async feeQuote(accept, _context) {
+        const key = `${accept.network}:${accept.asset.toLowerCase()}`;
+        const feeAmount = this.fee.baseFeesByToken?.[key] ?? this.fee.defaultBaseFee ?? '0';
+        return {
+            fee: {
+                feeTo: this.fee.feeTo,
+                feeAmount,
+                ...(this.fee.caller ? { caller: this.fee.caller } : {}),
+            },
+            pricing: 'fixed',
+            scheme: this.scheme(),
+            network: accept.network,
+            asset: accept.asset,
+        };
+    }
+    /**
+     * Off-chain verify path: structural checks live here, signature + balance
+     * + nonce + on-chain state checks go in subclass.
+     */
+    async verify(payload, requirements) {
+        const permit = payload.payload.paymentPermit;
+        if (!permit) {
+            return { isValid: false, invalidReason: 'missing_permit' };
+        }
+        if (permit.payment.payToken !== requirements.asset) {
+            return { isValid: false, invalidReason: 'asset_mismatch' };
+        }
+        if (permit.payment.payTo !== requirements.payTo) {
+            return { isValid: false, invalidReason: 'payTo_mismatch' };
+        }
+        try {
+            if (BigInt(permit.payment.payAmount) < BigInt(requirements.amount)) {
+                return { isValid: false, invalidReason: 'amount_too_low' };
+            }
+        }
+        catch {
+            return { isValid: false, invalidReason: 'invalid_amount' };
+        }
+        // Chain-specific signature + on-chain balance / nonce checks
+        return this.verifyOnChain(payload, requirements);
+    }
+    /**
+     * Chain-specific on-chain verification. Default: trust upstream
+     * (returns `isValid: true`). Subclasses MUST override for real
+     * signature recovery + balance + nonce checks.
+     */
+    async verifyOnChain(_payload, _requirements) {
+        return { isValid: true };
+    }
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/mechanisms/_exact_permit_base/facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/facilitator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAiB3C,MAAM,OAAgB,mCAAmC;IACxB;IAA/B,YAA+B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAE1D,MAAM;QACJ,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,MAA2B,EAC3B,QAAkC;QAElC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9D,MAAM,SAAS,GACb,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC;QACpE,OAAO;YACL,GAAG,EAAE;gBACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;gBACrB,SAAS;gBACT,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;YACD,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,OAAuB,EACvB,YAAiC;QAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;QAC7D,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;QAC7D,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;QAC7D,CAAC;QAED,6DAA6D;QAC7D,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,aAAa,CAC3B,QAAwB,EACxB,aAAkC;QAElC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CAUF"}

package/dist/mechanisms/_exact_permit_base/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared base for `exact_permit` scheme — mirrors Python
+ * `bankofai.x402.mechanisms._exact_permit_base`.
+ */
+export { BaseExactPermitServerMechanism } from './server.js';
+export { BaseExactPermitFacilitatorMechanism, } from './facilitator.js';
+export type { BaseExactPermitFee } from './facilitator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mechanisms/_exact_permit_base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/_exact_permit_base/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shared base for `exact_permit` scheme — mirrors Python
+ * `bankofai.x402.mechanisms._exact_permit_base`.
+ */
+export { BaseExactPermitServerMechanism } from './server.js';
+export { BaseExactPermitFacilitatorMechanism, } from './facilitator.js';
+//# sourceMappingURL=index.js.map

package/dist/mechanisms/_exact_permit_base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,mCAAmC,GACpC,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/_exact_permit_base/server.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared base for `exact_permit` scheme server mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_permit_base.server.BaseExactPermitServerMechanism`.
+ */
+import type { ServerMechanism } from '../../server/types.js';
+import type { PaymentPermit, PaymentRequirements } from '../../types/index.js';
+export declare abstract class BaseExactPermitServerMechanism implements ServerMechanism {
+    /** CAIP-2 prefix this mechanism handles (`"eip155:"` or `"tron:"`). */
+    protected abstract getNetworkPrefix(): string;
+    /** Format-only address validation (no on-chain lookup). */
+    protected abstract validateAddressFormat(address: string): boolean;
+    scheme(): string;
+    parsePrice(price: string, network: string): Promise<import("../../tokens.js").AssetAmount>;
+    enhancePaymentRequirements(requirements: PaymentRequirements, _deliveryMode: string): Promise<PaymentRequirements>;
+    validatePaymentRequirements(requirements: PaymentRequirements): boolean;
+    /**
+     * Verify the EIP-712 / TIP-712 permit signature server-side.
+     *
+     * TODO(v0.6.0b): port Python's `verify_signature` —
+     * - hash the typed-data per chain
+     * - recover signer from `signature`
+     * - compare to `permit.buyer`
+     *
+     * Until then returns `true` and defers to the facilitator's authoritative
+     * verification. The interface is present so middleware can call it
+     * uniformly when full impl lands.
+     */
+    verifySignature(_permit: PaymentPermit | null | undefined, _signature: string, _network: string): Promise<boolean>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mechanisms/_exact_permit_base/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAI9B,8BAAsB,8BAA+B,YAAW,eAAe;IAC7E,uEAAuE;IACvE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,MAAM;IAC7C,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAElE,MAAM,IAAI,MAAM;IAIV,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIzC,0BAA0B,CAC9B,YAAY,EAAE,mBAAmB,EACjC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAa/B,2BAA2B,CAAC,YAAY,EAAE,mBAAmB,GAAG,OAAO;IAOvE;;;;;;;;;;;OAWG;IACG,eAAe,CACnB,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;CAGpB"}

package/dist/mechanisms/_exact_permit_base/server.js

@@ -0,0 +1,53 @@
+/**
+ * Shared base for `exact_permit` scheme server mechanisms.
+ *
+ * Mirrors Python `mechanisms._exact_permit_base.server.BaseExactPermitServerMechanism`.
+ */
+import { findByAddress, parsePrice } from '../../tokens.js';
+const SCHEME_EXACT_PERMIT = 'exact_permit';
+export class BaseExactPermitServerMechanism {
+    scheme() {
+        return SCHEME_EXACT_PERMIT;
+    }
+    async parsePrice(price, network) {
+        return parsePrice(price, network);
+    }
+    async enhancePaymentRequirements(requirements, _deliveryMode) {
+        const token = findByAddress(requirements.network, requirements.asset);
+        if (!token)
+            return requirements;
+        return {
+            ...requirements,
+            extra: {
+                ...(requirements.extra ?? {}),
+                name: token.name,
+                ...(token.version ? { version: token.version } : {}),
+            },
+        };
+    }
+    validatePaymentRequirements(requirements) {
+        if (!requirements.network.startsWith(this.getNetworkPrefix()))
+            return false;
+        if (!this.validateAddressFormat(requirements.asset))
+            return false;
+        if (!this.validateAddressFormat(requirements.payTo))
+            return false;
+        return true;
+    }
+    /**
+     * Verify the EIP-712 / TIP-712 permit signature server-side.
+     *
+     * TODO(v0.6.0b): port Python's `verify_signature` —
+     * - hash the typed-data per chain
+     * - recover signer from `signature`
+     * - compare to `permit.buyer`
+     *
+     * Until then returns `true` and defers to the facilitator's authoritative
+     * verification. The interface is present so middleware can call it
+     * uniformly when full impl lands.
+     */
+    async verifySignature(_permit, _signature, _network) {
+        return true;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mechanisms/_exact_permit_base/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mechanisms/_exact_permit_base/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO5D,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAE3C,MAAM,OAAgB,8BAA8B;IAMlD,MAAM;QACJ,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAe;QAC7C,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,YAAiC,EACjC,aAAqB;QAErB,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK;YAAE,OAAO,YAAY,CAAC;QAChC,OAAO;YACL,GAAG,YAAY;YACf,KAAK,EAAE;gBACL,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED,2BAA2B,CAAC,YAAiC;QAC3D,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,eAAe,CACnB,OAAyC,EACzC,UAAkB,EAClB,QAAgB;QAEhB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/mechanisms/{nativeExactEvm.d.ts → evm/exact/client.d.ts}

@@ -4,7 +4,7 @@
  * Uses ERC-3009 TransferWithAuthorization with EIP-712 signing.
  * EVM addresses are used directly without conversion.
  */
-import type { ClientMechanism, ClientSigner, PaymentRequirements, PaymentPayload } from '../index.js';
+import type { ClientMechanism, ClientSigner, PaymentRequirements, PaymentPayload } from '../../../index.js';
 /**
  * EVM client mechanism for "exact" payment scheme
  */
@@ -16,4 +16,4 @@ export declare class ExactEvmClientMechanism implements ClientMechanism {
     scheme(): string;
     createPaymentPayload(requirements: PaymentRequirements, resource: string): Promise<PaymentPayload>;
 }
-//# sourceMappingURL=nativeExactEvm.d.ts.map
+//# sourceMappingURL=client.d.ts.map

package/dist/mechanisms/evm/exact/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/evm/exact/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAiB3B;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,MAAM,EAAE,YAAY;IAIhC,SAAS,IAAI,YAAY;IAIzB,MAAM,IAAI,MAAM;IAIV,oBAAoB,CACxB,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC;CAoD3B"}

package/dist/mechanisms/{nativeExactEvm.js → evm/exact/client.js}

@@ -4,9 +4,9 @@
  * Uses ERC-3009 TransferWithAuthorization with EIP-712 signing.
  * EVM addresses are used directly without conversion.
  */
-import { getChainId, EvmAddressConverter, } from '../index.js';
-import { findByAddress } from '../tokens.js';
-import { SCHEME_EXACT, TRANSFER_AUTH_EIP712_TYPES, TRANSFER_AUTH_PRIMARY_TYPE, buildEip712Domain, buildEip712Message, createNonce, createValidityWindow, } from './nativeExact.js';
+import { getChainId, EvmAddressConverter, } from '../../../index.js';
+import { findByAddress } from '../../../tokens.js';
+import { SCHEME_EXACT, TRANSFER_AUTH_EIP712_TYPES, TRANSFER_AUTH_PRIMARY_TYPE, buildEip712Domain, buildEip712Message, createNonce, createValidityWindow, } from '../../_exact_base/types.js';
 /**
  * EVM client mechanism for "exact" payment scheme
  */
@@ -58,4 +58,4 @@ export class ExactEvmClientMechanism {
         };
     }
 }
-//# sourceMappingURL=nativeExactEvm.js.map
+//# sourceMappingURL=client.js.map

package/dist/mechanisms/evm/exact/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/mechanisms/evm/exact/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EACL,UAAU,EACV,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAGpC;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAe;IACrB,gBAAgB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAErD,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,YAAiC,EACjC,QAAgB;QAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEzD,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,oBAAoB,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAE5B,MAAM,aAAa,GAA0B;YAC3C,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,YAAY,CAAC,MAAM;YAC1B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;YAC9B,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;YAChC,KAAK;SACN,CAAC;QAEF,4CAA4C;QAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,SAAS,EAAE,IAAI,IAAI,eAAe,CAAC;QACrD,MAAM,YAAY,GAAG,SAAS,EAAE,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC;QAE9E,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,iBAAiB,CAC9B,SAAS,EACT,YAAY,EACZ,OAAO,EACP,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAC1C,CAAC;QAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAC/C,MAAM,EACN,0BAA0B,EAC1B,OAAO,EACP,0BAA0B,CAC3B,CAAC;QAEF,OAAO;YACL,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;YAC3B,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE;gBACP,SAAS;gBACT,aAAa;aACd;YACD,UAAU,EAAE;gBACV,qBAAqB,EAAE,aAAa;aACrC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/mechanisms/evm/exact/facilitator.d.ts

@@ -0,0 +1,20 @@
+import { ExactBaseFacilitatorMechanism } from '../../_exact_base/facilitator.js';
+import type { PaymentPayload, PaymentRequirements, SettleResponse } from '../../../types/index.js';
+/**
+ * BSC / EVM facilitator mechanism for the `exact` scheme.
+ *
+ * Mirrors Python `mechanisms.evm.exact.facilitator.ExactEvmFacilitatorMechanism`.
+ */
+export declare class ExactEvmFacilitatorMechanism extends ExactBaseFacilitatorMechanism {
+    constructor();
+    /**
+     * Settle the ERC-3009 authorization by calling `transferWithAuthorization`
+     * on the token contract.
+     *
+     * TODO(v0.6.0b): wire a viem `WalletClient` and invoke the contract. Until
+     * then this returns `success: false` so the upstream caller knows the
+     * chain integration is not yet wired.
+     */
+    settle(_payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/mechanisms/evm/exact/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/evm/exact/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEjF,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,6BAA6B;;IAK7E;;;;;;;OAOG;IACG,MAAM,CACV,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;CAO3B"}

package/dist/mechanisms/evm/exact/facilitator.js

@@ -0,0 +1,28 @@
+import { ExactBaseFacilitatorMechanism } from '../../_exact_base/facilitator.js';
+import { EvmChainAdapter } from '../../_exact_base/evmAdapter.js';
+/**
+ * BSC / EVM facilitator mechanism for the `exact` scheme.
+ *
+ * Mirrors Python `mechanisms.evm.exact.facilitator.ExactEvmFacilitatorMechanism`.
+ */
+export class ExactEvmFacilitatorMechanism extends ExactBaseFacilitatorMechanism {
+    constructor() {
+        super(new EvmChainAdapter());
+    }
+    /**
+     * Settle the ERC-3009 authorization by calling `transferWithAuthorization`
+     * on the token contract.
+     *
+     * TODO(v0.6.0b): wire a viem `WalletClient` and invoke the contract. Until
+     * then this returns `success: false` so the upstream caller knows the
+     * chain integration is not yet wired.
+     */
+    async settle(_payload, requirements) {
+        return {
+            success: false,
+            network: requirements.network,
+            errorReason: 'evm_exact_settle_not_implemented',
+        };
+    }
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/mechanisms/evm/exact/facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../../../src/mechanisms/evm/exact/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAOlE;;;;GAIG;AACH,MAAM,OAAO,4BAA6B,SAAQ,6BAA6B;IAC7E;QACE,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,QAAwB,EACxB,YAAiC;QAEjC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,WAAW,EAAE,kCAAkC;SAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/mechanisms/evm/exact/index.d.ts

@@ -0,0 +1,4 @@
+export { ExactEvmClientMechanism } from './client.js';
+export { ExactEvmServerMechanism } from './server.js';
+export { ExactEvmFacilitatorMechanism } from './facilitator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mechanisms/evm/exact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/evm/exact/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC"}