@bankofai/x402 0.5.9 → 0.6.0-beta.0

package/dist/mechanisms/tron/exact_gasfree/facilitator.js

@@ -0,0 +1,71 @@
+const SCHEME_EXACT_GASFREE = 'exact_gasfree';
+/**
+ * TRON facilitator mechanism for the `exact_gasfree` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_gasfree.facilitator.ExactGasFreeFacilitatorMechanism`.
+ * Uses TRON GasFree (custodial relayer) — user signs TIP-712 permit, the
+ * service provider submits the transaction on-chain.
+ */
+export class ExactGasFreeFacilitatorMechanism {
+    fee;
+    constructor(fee) {
+        this.fee = fee;
+    }
+    scheme() {
+        return SCHEME_EXACT_GASFREE;
+    }
+    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: structural checks. Real TIP-712 signature + GasFree
+     * API deadline-clamping checks left as TODO.
+     */
+    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' };
+        }
+        // TODO(v0.6.0b): TIP-712 signature recovery + GasFree balance/deadline check.
+        return { isValid: true };
+    }
+    /**
+     * Submit the GasFree permit through the GasFreeController contract.
+     *
+     * TODO(v0.6.0b): call GasFree relayer API or contract directly.
+     */
+    async settle(_payload, requirements) {
+        return {
+            success: false,
+            network: requirements.network,
+            errorReason: 'tron_exact_gasfree_settle_not_implemented',
+        };
+    }
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/mechanisms/tron/exact_gasfree/facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_gasfree/facilitator.ts"],"names":[],"mappings":"AASA,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAc7C;;;;;;GAMG;AACH,MAAM,OAAO,gCAAgC;IACd;IAA7B,YAA6B,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAErD,MAAM;QACJ,OAAO,oBAAoB,CAAC;IAC9B,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;QACD,8EAA8E;QAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,QAAwB,EACxB,YAAiC;QAEjC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,WAAW,EAAE,2CAA2C;SACzD,CAAC;IACJ,CAAC;CACF"}

package/dist/mechanisms/tron/exact_gasfree/index.d.ts

@@ -0,0 +1,5 @@
+export { ExactGasFreeClientMechanism } from './client.js';
+export { ExactGasFreeServerMechanism } from './server.js';
+export { ExactGasFreeFacilitatorMechanism } from './facilitator.js';
+export type { ExactGasFreeFee } from './facilitator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mechanisms/tron/exact_gasfree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_gasfree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/tron/exact_gasfree/index.js

@@ -0,0 +1,4 @@
+export { ExactGasFreeClientMechanism } from './client.js';
+export { ExactGasFreeServerMechanism } from './server.js';
+export { ExactGasFreeFacilitatorMechanism } from './facilitator.js';
+//# sourceMappingURL=index.js.map

package/dist/mechanisms/tron/exact_gasfree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_gasfree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mechanisms/tron/exact_gasfree/server.d.ts

@@ -0,0 +1,23 @@
+import type { ServerMechanism } from '../../../server/types.js';
+import type { PaymentPermit, PaymentRequirements } from '../../../types/index.js';
+/**
+ * TRON server mechanism for the `exact_gasfree` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_gasfree.server.ExactGasFreeServerMechanism`.
+ * GasFree is TRON-only (no EVM counterpart) so there is no shared
+ * `_exact_gasfree_base/`.
+ */
+export declare class ExactGasFreeServerMechanism implements ServerMechanism {
+    scheme(): string;
+    parsePrice(price: string, network: string): Promise<import("../../../tokens.js").AssetAmount>;
+    enhancePaymentRequirements(requirements: PaymentRequirements, _deliveryMode: string): Promise<PaymentRequirements>;
+    validatePaymentRequirements(requirements: PaymentRequirements): boolean;
+    /**
+     * TIP-712 GasFree permit signature recovery.
+     *
+     * TODO(v0.6.0b): port from Python — TIP-712 hash + signature recovery.
+     * Returns `true` for now; facilitator authoritative.
+     */
+    verifySignature(_permit: PaymentPermit | null | undefined, _signature: string, _network: string): Promise<boolean>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mechanisms/tron/exact_gasfree/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_gasfree/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAIjC;;;;;;GAMG;AACH,qBAAa,2BAA4B,YAAW,eAAe;IACjE,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;IAIvE;;;;;OAKG;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/tron/exact_gasfree/server.js

@@ -0,0 +1,43 @@
+import { findByAddress, parsePrice } from '../../../tokens.js';
+const SCHEME_EXACT_GASFREE = 'exact_gasfree';
+/**
+ * TRON server mechanism for the `exact_gasfree` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_gasfree.server.ExactGasFreeServerMechanism`.
+ * GasFree is TRON-only (no EVM counterpart) so there is no shared
+ * `_exact_gasfree_base/`.
+ */
+export class ExactGasFreeServerMechanism {
+    scheme() {
+        return SCHEME_EXACT_GASFREE;
+    }
+    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) {
+        return requirements.network.startsWith('tron:');
+    }
+    /**
+     * TIP-712 GasFree permit signature recovery.
+     *
+     * TODO(v0.6.0b): port from Python — TIP-712 hash + signature recovery.
+     * Returns `true` for now; facilitator authoritative.
+     */
+    async verifySignature(_permit, _signature, _network) {
+        return true;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mechanisms/tron/exact_gasfree/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_gasfree/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAO/D,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IACtC,MAAM;QACJ,OAAO,oBAAoB,CAAC;IAC9B,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,OAAO,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,OAAyC,EACzC,UAAkB,EAClB,QAAgB;QAEhB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/mechanisms/{exact.d.ts → tron/exact_permit/client.d.ts}

@@ -3,7 +3,7 @@
  *
  * Uses TIP-712 (TRON's EIP-712 implementation) for signing PaymentPermit.
  */
-import type { ClientMechanism, ClientSigner, PaymentRequirements, PaymentPayload, PaymentPermitContext } from '../index.js';
+import type { ClientMechanism, ClientSigner, PaymentRequirements, PaymentPayload, PaymentPermitContext } from '../../../index.js';
 /**
  * TRON client mechanism for "exact_permit" payment scheme
  */
@@ -17,4 +17,4 @@ export declare class ExactPermitTronClientMechanism implements ClientMechanism {
         paymentPermitContext?: PaymentPermitContext;
     }): Promise<PaymentPayload>;
 }
-//# sourceMappingURL=exact.d.ts.map
+//# sourceMappingURL=client.d.ts.map

package/dist/mechanisms/tron/exact_permit/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_permit/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EAEd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAa3B;;GAEG;AACH,qBAAa,8BAA+B,YAAW,eAAe;IACpE,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,MAAM,EAAE,YAAY;IAIhC,SAAS,IAAI,YAAY;IAIzB,MAAM,IAAI,MAAM;IAIV,oBAAoB,CACxB,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAC3D,OAAO,CAAC,cAAc,CAAC;CAyG3B"}

package/dist/mechanisms/{exact.js → tron/exact_permit/client.js}

@@ -3,7 +3,7 @@
  *
  * Uses TIP-712 (TRON's EIP-712 implementation) for signing PaymentPermit.
  */
-import { KIND_MAP, PAYMENT_PERMIT_TYPES, PAYMENT_PERMIT_PRIMARY_TYPE, getChainId, getPaymentPermitAddress, TronAddressConverter, TRON_ZERO_ADDRESS, PermitValidationError, } from '../index.js';
+import { KIND_MAP, PAYMENT_PERMIT_TYPES, PAYMENT_PERMIT_PRIMARY_TYPE, getChainId, getPaymentPermitAddress, TronAddressConverter, TRON_ZERO_ADDRESS, PermitValidationError, } from '../../../index.js';
 /**
  * TRON client mechanism for "exact_permit" payment scheme
  */
@@ -107,4 +107,4 @@ export class ExactPermitTronClientMechanism {
         };
     }
 }
-//# sourceMappingURL=exact.js.map
+//# sourceMappingURL=client.js.map

package/dist/mechanisms/tron/exact_permit/client.js.map

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

package/dist/mechanisms/tron/exact_permit/facilitator.d.ts

@@ -0,0 +1,17 @@
+import { BaseExactPermitFacilitatorMechanism, type BaseExactPermitFee } from '../../_exact_permit_base/facilitator.js';
+import type { PaymentPayload, PaymentRequirements, SettleResponse } from '../../../types/index.js';
+/**
+ * TRON facilitator mechanism for the `exact_permit` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_permit.facilitator.ExactPermitTronFacilitatorMechanism`.
+ */
+export declare class ExactPermitTronFacilitatorMechanism extends BaseExactPermitFacilitatorMechanism {
+    constructor(fee: BaseExactPermitFee);
+    /**
+     * Submit `permitTransferFrom` to the TRON PaymentPermit contract.
+     *
+     * TODO(v0.6.0b): wire tronweb and call `PaymentPermit.permitTransferFrom`.
+     */
+    settle(_payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/mechanisms/tron/exact_permit/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_permit/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,KAAK,kBAAkB,EACxB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,mCAAoC,SAAQ,mCAAmC;gBAC9E,GAAG,EAAE,kBAAkB;IAInC;;;;OAIG;IACG,MAAM,CACV,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;CAO3B"}

package/dist/mechanisms/tron/exact_permit/facilitator.js

@@ -0,0 +1,24 @@
+import { BaseExactPermitFacilitatorMechanism, } from '../../_exact_permit_base/facilitator.js';
+/**
+ * TRON facilitator mechanism for the `exact_permit` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_permit.facilitator.ExactPermitTronFacilitatorMechanism`.
+ */
+export class ExactPermitTronFacilitatorMechanism extends BaseExactPermitFacilitatorMechanism {
+    constructor(fee) {
+        super(fee);
+    }
+    /**
+     * Submit `permitTransferFrom` to the TRON PaymentPermit contract.
+     *
+     * TODO(v0.6.0b): wire tronweb and call `PaymentPermit.permitTransferFrom`.
+     */
+    async settle(_payload, requirements) {
+        return {
+            success: false,
+            network: requirements.network,
+            errorReason: 'tron_exact_permit_settle_not_implemented',
+        };
+    }
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/mechanisms/tron/exact_permit/facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_permit/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,GAEpC,MAAM,yCAAyC,CAAC;AAOjD;;;;GAIG;AACH,MAAM,OAAO,mCAAoC,SAAQ,mCAAmC;IAC1F,YAAY,GAAuB;QACjC,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,QAAwB,EACxB,YAAiC;QAEjC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,WAAW,EAAE,0CAA0C;SACxD,CAAC;IACJ,CAAC;CACF"}

package/dist/mechanisms/tron/exact_permit/index.d.ts

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

package/dist/mechanisms/tron/exact_permit/index.d.ts.map

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

package/dist/mechanisms/tron/exact_permit/index.js

@@ -0,0 +1,4 @@
+export { ExactPermitTronClientMechanism } from './client.js';
+export { ExactPermitTronServerMechanism } from './server.js';
+export { ExactPermitTronFacilitatorMechanism } from './facilitator.js';
+//# sourceMappingURL=index.js.map

package/dist/mechanisms/tron/exact_permit/index.js.map

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

package/dist/mechanisms/tron/exact_permit/server.d.ts

@@ -0,0 +1,11 @@
+import { BaseExactPermitServerMechanism } from '../../_exact_permit_base/server.js';
+/**
+ * TRON server mechanism for the `exact_permit` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_permit.server.ExactPermitTronServerMechanism`.
+ */
+export declare class ExactPermitTronServerMechanism extends BaseExactPermitServerMechanism {
+    protected getNetworkPrefix(): string;
+    protected validateAddressFormat(address: string): boolean;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mechanisms/tron/exact_permit/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_permit/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAEpF;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,8BAA8B;IAChF,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAIpC,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAO1D"}

package/dist/mechanisms/tron/exact_permit/server.js

@@ -0,0 +1,22 @@
+import { BaseExactPermitServerMechanism } from '../../_exact_permit_base/server.js';
+/**
+ * TRON server mechanism for the `exact_permit` scheme.
+ *
+ * Mirrors Python `mechanisms.tron.exact_permit.server.ExactPermitTronServerMechanism`.
+ */
+export class ExactPermitTronServerMechanism extends BaseExactPermitServerMechanism {
+    getNetworkPrefix() {
+        return 'tron:';
+    }
+    validateAddressFormat(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;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mechanisms/tron/exact_permit/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/mechanisms/tron/exact_permit/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,OAAO,8BAA+B,SAAQ,8BAA8B;IACtE,gBAAgB;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAES,qBAAqB,CAAC,OAAe;QAC7C,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;CACF"}

package/dist/middleware/core.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Framework-agnostic core for x402 server middleware.
+ *
+ * Implements the verify → settle → header-attach pipeline used by all
+ * server adapters (Hono, Express, Fastify, ...). Adapters read the request
+ * headers, hand them to {@link processX402Request}, then translate the
+ * resulting {@link X402Decision} back into their framework's response shape.
+ *
+ * This mirrors `bankofai.x402.fastapi.X402Middleware` on the Python side but
+ * splits the framework binding from the protocol logic so we can target any
+ * Node.js HTTP framework with a thin adapter.
+ */
+import type { FacilitatorClient } from '../facilitator/client.js';
+import { PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER } from '../http/client.js';
+import type { PaymentRequired, PaymentRequirements, SettleResponse } from '../types/index.js';
+export { PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, };
+export declare const X402_VERSION = 2;
+/** Minimum config needed to protect an endpoint. */
+export interface X402MiddlewareConfig {
+    /** Facilitator client used for `/verify` and `/settle`. */
+    facilitator: FacilitatorClient;
+    /**
+     * `accepts` array advertised in the 402 challenge. Multiple entries express
+     * multi-token / multi-scheme acceptance — clients pick one and pay it.
+     */
+    accepts: PaymentRequirements[];
+    /** Optional resource info echoed back in the 402 body. */
+    resource?: PaymentRequired['resource'];
+    /**
+     * Optional extensions advertised on the 402 (e.g. `payment-identifier`).
+     * Forwarded as-is into the `PaymentRequired.extensions` field.
+     */
+    extensions?: PaymentRequired['extensions'];
+}
+/** Outcome of {@link processX402Request}. The adapter renders this. */
+export type X402Decision = 
+/** No payment header → return a 402 with PAYMENT-REQUIRED set. */
+{
+    kind: 'paymentRequired';
+    status: 402;
+    paymentRequired: PaymentRequired;
+    headers: Record<string, string>;
+}
+/** Payload was malformed or doesn't match any acceptable requirement. */
+ | {
+    kind: 'invalid';
+    status: 400;
+    reason: string;
+}
+/** Verify or settle failed → tell the client. */
+ | {
+    kind: 'failed';
+    status: 500;
+    reason: string;
+    transaction?: string;
+    network?: string;
+}
+/**
+ * Payment succeeded. Adapter should run the protected handler and attach
+ * `headers` (which contains `PAYMENT-RESPONSE`) onto the response.
+ */
+ | {
+    kind: 'allow';
+    settleResult: SettleResponse;
+    headers: Record<string, string>;
+};
+/**
+ * Run one x402 protocol iteration against the given config.
+ *
+ * @param signatureHeader - Value of the `PAYMENT-SIGNATURE` request header (or
+ *   null/undefined if absent).
+ * @param config - Server-side payment configuration.
+ */
+export declare function processX402Request(signatureHeader: string | null | undefined, config: X402MiddlewareConfig): Promise<X402Decision>;
+//# sourceMappingURL=core.d.ts.map

package/dist/middleware/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/middleware/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAEV,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,GACzB,CAAC;AAEF,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,WAAW,EAAE,iBAAiB,CAAC;IAC/B;;;OAGG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED,uEAAuE;AACvE,MAAM,MAAM,YAAY;AACtB,kEAAkE;AAChE;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AACH,yEAAyE;GACvE;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEN;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA8EvB"}

package/dist/middleware/core.js

@@ -0,0 +1,132 @@
+/**
+ * Framework-agnostic core for x402 server middleware.
+ *
+ * Implements the verify → settle → header-attach pipeline used by all
+ * server adapters (Hono, Express, Fastify, ...). Adapters read the request
+ * headers, hand them to {@link processX402Request}, then translate the
+ * resulting {@link X402Decision} back into their framework's response shape.
+ *
+ * This mirrors `bankofai.x402.fastapi.X402Middleware` on the Python side but
+ * splits the framework binding from the protocol logic so we can target any
+ * Node.js HTTP framework with a thin adapter.
+ */
+import { PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, } from '../http/client.js';
+import { decodePaymentPayload, encodePaymentPayload, } from '../utils/encoding.js';
+// Re-export header constants from http/client (single source of truth).
+export { PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, };
+export const X402_VERSION = 2;
+/**
+ * Run one x402 protocol iteration against the given config.
+ *
+ * @param signatureHeader - Value of the `PAYMENT-SIGNATURE` request header (or
+ *   null/undefined if absent).
+ * @param config - Server-side payment configuration.
+ */
+export async function processX402Request(signatureHeader, config) {
+    if (!signatureHeader) {
+        const paymentRequired = buildPaymentRequired(config);
+        return {
+            kind: 'paymentRequired',
+            status: 402,
+            paymentRequired,
+            headers: {
+                [PAYMENT_REQUIRED_HEADER]: encodePaymentPayload(paymentRequired),
+            },
+        };
+    }
+    let payload;
+    try {
+        payload = decodePaymentPayload(signatureHeader);
+    }
+    catch (err) {
+        return {
+            kind: 'invalid',
+            status: 400,
+            reason: `Invalid payment payload: ${err.message}`,
+        };
+    }
+    const matched = matchAccepts(config.accepts, payload);
+    if (!matched) {
+        return {
+            kind: 'invalid',
+            status: 400,
+            reason: 'Unsupported payment token / network / scheme',
+        };
+    }
+    let verifyResult;
+    try {
+        verifyResult = await config.facilitator.verify(payload, matched);
+    }
+    catch (err) {
+        return {
+            kind: 'failed',
+            status: 500,
+            reason: `Verify request failed: ${err.message}`,
+        };
+    }
+    if (!verifyResult.isValid) {
+        return {
+            kind: 'failed',
+            status: 500,
+            reason: verifyResult.invalidReason ?? 'verify rejected payment',
+        };
+    }
+    let settleResult;
+    try {
+        settleResult = await config.facilitator.settle(payload, matched);
+    }
+    catch (err) {
+        return {
+            kind: 'failed',
+            status: 500,
+            reason: `Settle request failed: ${err.message}`,
+        };
+    }
+    if (!settleResult.success) {
+        return {
+            kind: 'failed',
+            status: 500,
+            reason: settleResult.errorReason ?? 'settle failed',
+            transaction: settleResult.transaction,
+            network: settleResult.network,
+        };
+    }
+    return {
+        kind: 'allow',
+        settleResult,
+        headers: {
+            [PAYMENT_RESPONSE_HEADER]: encodePaymentPayload(settleResult),
+        },
+    };
+}
+/** Build the 402 challenge body from the middleware config. */
+function buildPaymentRequired(config) {
+    return {
+        x402Version: X402_VERSION,
+        accepts: config.accepts,
+        ...(config.resource ? { resource: config.resource } : {}),
+        ...(config.extensions ? { extensions: config.extensions } : {}),
+    };
+}
+/**
+ * Pick the `accepts[]` entry that matches the client's chosen payment.
+ *
+ * The wire format requires the client to echo `payload.accepted` — we trust
+ * that as the discriminator and verify it lines up with our offer.
+ */
+function matchAccepts(accepts, payload) {
+    const want = payload.accepted;
+    for (const offer of accepts) {
+        if (offer.network !== want.network)
+            continue;
+        if (offer.scheme !== want.scheme)
+            continue;
+        if (offer.asset.toLowerCase() !== want.asset.toLowerCase())
+            continue;
+        if (offer.payTo.toLowerCase() !== want.payTo.toLowerCase())
+            continue;
+        return offer;
+    }
+    return null;
+}
+//# sourceMappingURL=core.js.map

package/dist/middleware/core.js.map

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

package/dist/middleware/express.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Express adapter for the x402 server middleware.
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { FacilitatorClient, x402Express } from '@bankofai/x402';
+ *
+ * const facilitator = new FacilitatorClient({ baseUrl: 'https://facilitator.example' });
+ * const app = express();
+ *
+ * app.use(
+ *   '/api/llm-summary',
+ *   x402Express({
+ *     facilitator,
+ *     accepts: [{
+ *       scheme: 'exact_permit',
+ *       network: 'eip155:97',
+ *       amount: '1000000',
+ *       asset: '0x...',
+ *       payTo: '0x...',
+ *     }],
+ *   }),
+ * );
+ *
+ * app.get('/api/llm-summary', (req, res) => res.json({ summary: '...' }));
+ * ```
+ *
+ * Express is imported via `peerDependencies`; consumers add it to their app.
+ */
+import type { RequestHandler } from 'express';
+import { type X402MiddlewareConfig } from './core.js';
+/**
+ * Build an Express request handler that gates the route on x402 payment.
+ *
+ * Behavior matches the Hono adapter — see {@link X402MiddlewareConfig} and
+ * {@link processX402Request} for the underlying decision logic.
+ */
+export declare function x402Express(config: X402MiddlewareConfig): RequestHandler;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAyB,cAAc,EAAY,MAAM,SAAS,CAAC;AAE/E,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAEnB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoCxE"}