@reinconsole/gate 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 The supply side of **[Rein](https://github.com/bugiiiii11/rein)** — vendor-side [x402](https://www.x402.org) monetization middleware. Price your routes once and every payment into your API is quoted, cross-checked, screened, rate-limited, settled, and receipted before your handler runs.
 
-> **Status: v0.1 — early open-source infrastructure, live on testnet.** Verified live on Base Sepolia against the hosted x402.org facilitator. APIs may change before 1.0. See it running: [Rein console](https://reinconsole-production.up.railway.app/).
+> **Status: v0.1 — early open-source infrastructure, live on testnet.** Verified live on Base Sepolia against the hosted x402.org facilitator. APIs may change before 1.0. See it running: [Rein console](https://app.reinconsole.com).
 
 ## Install
 

package/dist/index.cjs

@@ -15,59 +15,19 @@ var GateError = class extends Error {
     this.code = code;
     this.name = "GateError";
     this.retryAfterSeconds = options.retryAfterSeconds;
+    this.paymentResponse = options.paymentResponse;
   }
   code;
   /** Seconds until the refused payment could be admitted (throttle codes). */
   retryAfterSeconds;
+  /**
+   * The rails' own failed settlement response, when there is one (a
+   * facilitator settle that answered `success: false`). Refusals of v2
+   * payments relay it verbatim in the PAYMENT-RESPONSE header instead of a
+   * synthesized one, so the payer sees the facilitator's real errorReason.
+   */
+  paymentResponse;
 };
-
-// src/v2.ts
-var CAIP2_ALIASES = {
-  base: "eip155:8453",
-  "base-sepolia": "eip155:84532",
-  polygon: "eip155:137",
-  "polygon-amoy": "eip155:80002",
-  bnb: "eip155:56",
-  bsc: "eip155:56",
-  solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
-  "solana-devnet": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"
-};
-function caip2Of(network) {
-  const key = network.toLowerCase();
-  return CAIP2_ALIASES[key] ?? key;
-}
-function sameNetwork(a, b) {
-  return caip2Of(a) === caip2Of(b);
-}
-function v2Requirements(requirement) {
-  return {
-    scheme: requirement.scheme,
-    network: caip2Of(requirement.network),
-    amount: requirement.maxAmountRequired,
-    asset: requirement.asset,
-    payTo: requirement.payTo,
-    ...requirement.maxTimeoutSeconds !== void 0 ? { maxTimeoutSeconds: requirement.maxTimeoutSeconds } : {},
-    ...requirement.extra ? { extra: requirement.extra } : {}
-  };
-}
-function buildPaymentRequiredV2(requirement, error) {
-  return {
-    x402Version: 2,
-    error,
-    ...requirement.resource ? {
-      resource: {
-        url: requirement.resource,
-        ...requirement.description ? { description: requirement.description } : {},
-        ...requirement.mimeType ? { mimeType: requirement.mimeType } : {}
-      }
-    } : {},
-    accepts: [v2Requirements(requirement)],
-    extensions: {}
-  };
-}
-function encodeBase64Json(value) {
-  return Buffer.from(JSON.stringify(value)).toString("base64");
-}
 var UintString = zod.z.string().regex(/^\d+$/, "must be a decimal integer string");
 var Transfer = zod.z.object({
   from: zod.z.string().min(1),
@@ -209,7 +169,7 @@ function mockFacilitatorRails(facilitator) {
 function facilitatorClientRails(client) {
   const dialectRequirements = (paymentHeader, requirement) => {
     const { envelope, version } = inspectPaymentHeader(paymentHeader);
-    return { envelope, requirements: version === 2 ? v2Requirements(requirement) : requirement };
+    return { envelope, requirements: version === 2 ? sdk.v2Requirements(requirement) : requirement };
   };
   return {
     async verify(paymentHeader, requirement) {
@@ -233,7 +193,9 @@ function facilitatorClientRails(client) {
         classifyTransport(err);
       }
       if (!settled.success) {
-        throw new GateError("settle_failed", settled.errorReason ?? "payment settlement failed");
+        throw new GateError("settle_failed", settled.errorReason ?? "payment settlement failed", {
+          paymentResponse: settled
+        });
       }
       return {
         header: encodeSettlementHeader(settled),
@@ -470,9 +432,11 @@ var Gate = class {
       };
     }
     let payer;
+    let wire;
     try {
       const payment = inspectPaymentHeader(request.payment);
       payer = payment.payer;
+      wire = payment.version;
       this.checkRate(payment.payer);
       this.checkConsistency(payment, requirement);
       this.screenPayer(payment.payer);
@@ -498,7 +462,7 @@ var Gate = class {
       return { kind: "paid", receipt, settlementHeader: settlement.header };
     } catch (err) {
       if (!(err instanceof GateError)) throw err;
-      return this.refuse(err, url.pathname, requirement, payer);
+      return this.refuse(err, url.pathname, requirement, payer, wire);
     }
   }
   stats() {
@@ -542,7 +506,7 @@ var Gate = class {
         `payment scheme "${payment.scheme}" does not match the quoted "${requirement.scheme}"`
       );
     }
-    if (!sameNetwork(payment.network, requirement.network)) {
+    if (!sdk.sameNetwork(payment.network, requirement.network)) {
       throw new GateError(
         "network_mismatch",
         `payment is on "${payment.network}" but the quote wants "${requirement.network}"`
@@ -699,7 +663,7 @@ var Gate = class {
       );
     }
   }
-  refuse(err, resource, requirement, payer) {
+  refuse(err, resource, requirement, payer, wire) {
     this.fire(() => this.store.recordRefusal());
     this.emit({
       type: "gate.refused",
@@ -749,14 +713,15 @@ var Gate = class {
       code: err.code,
       reason: err.message,
       body: { x402Version: 1, accepts: [requirement], error: err.message },
-      ...this.v2Quote(requirement, err.message)
+      ...this.v2Quote(requirement, err.message),
+      ...wire === 2 ? { paymentResponseHeader: v2FailureHeader(err, requirement, payer) } : {}
     };
   }
   /** The v2 half of a dual-stack 402 (see advertiseV2), or nothing. */
   v2Quote(requirement, error) {
     if (!this.advertiseV2) return {};
     return {
-      paymentRequiredHeader: encodeBase64Json(buildPaymentRequiredV2(requirement, error))
+      paymentRequiredHeader: sdk.encodeBase64Json(sdk.buildPaymentRequiredV2(requirement, error))
     };
   }
 };
@@ -766,6 +731,17 @@ function createGate(options) {
 function replayKey(paymentHeader) {
   return crypto.createHash("sha256").update(paymentHeader).digest("hex");
 }
+function v2FailureHeader(err, requirement, payer) {
+  return sdk.encodeBase64Json(
+    err.paymentResponse ?? {
+      success: false,
+      errorReason: err.code,
+      transaction: "",
+      network: sdk.caip2Of(requirement.network),
+      ...payer !== void 0 ? { payer } : {}
+    }
+  );
+}
 function messageOf2(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -792,6 +768,7 @@ function gateMiddleware(gate, options = {}) {
       res.writeHead(outcome.status, {
         "content-type": "application/json",
         ...outcome.paymentRequiredHeader !== void 0 ? { "payment-required": outcome.paymentRequiredHeader } : {},
+        ...outcome.kind === "refused" && outcome.paymentResponseHeader !== void 0 ? { "payment-response": outcome.paymentResponseHeader } : {},
         ...outcome.kind === "refused" && outcome.retryAfterSeconds !== void 0 ? { "retry-after": String(outcome.retryAfterSeconds) } : {}
       });
       res.end(JSON.stringify(outcome.body));
@@ -835,21 +812,39 @@ function createGatedFetch(gate, options = {}) {
       headers: {
         "content-type": "application/json",
         ...outcome.paymentRequiredHeader !== void 0 ? { "payment-required": outcome.paymentRequiredHeader } : {},
+        ...outcome.kind === "refused" && outcome.paymentResponseHeader !== void 0 ? { "payment-response": outcome.paymentResponseHeader } : {},
         ...outcome.kind === "refused" && outcome.retryAfterSeconds !== void 0 ? { "retry-after": String(outcome.retryAfterSeconds) } : {}
       }
     });
   };
 }
 
+Object.defineProperty(exports, "buildPaymentRequiredV2", {
+  enumerable: true,
+  get: function () { return sdk.buildPaymentRequiredV2; }
+});
+Object.defineProperty(exports, "caip2Of", {
+  enumerable: true,
+  get: function () { return sdk.caip2Of; }
+});
+Object.defineProperty(exports, "encodeBase64Json", {
+  enumerable: true,
+  get: function () { return sdk.encodeBase64Json; }
+});
+Object.defineProperty(exports, "sameNetwork", {
+  enumerable: true,
+  get: function () { return sdk.sameNetwork; }
+});
+Object.defineProperty(exports, "v2Requirements", {
+  enumerable: true,
+  get: function () { return sdk.v2Requirements; }
+});
 exports.Gate = Gate;
 exports.GateError = GateError;
 exports.InMemoryGateStore = InMemoryGateStore;
 exports.RailsUnreachableError = RailsUnreachableError;
-exports.buildPaymentRequiredV2 = buildPaymentRequiredV2;
-exports.caip2Of = caip2Of;
 exports.createGate = createGate;
 exports.createGatedFetch = createGatedFetch;
-exports.encodeBase64Json = encodeBase64Json;
 exports.facilitatorClientRails = facilitatorClientRails;
 exports.gateMiddleware = gateMiddleware;
 exports.inspectPaymentHeader = inspectPaymentHeader;
@@ -857,8 +852,6 @@ exports.matchRoute = matchRoute;
 exports.mockFacilitatorRails = mockFacilitatorRails;
 exports.requirementFor = requirementFor;
 exports.routeDecimals = routeDecimals;
-exports.sameNetwork = sameNetwork;
-exports.v2Requirements = v2Requirements;
 exports.validateVelocity = validateVelocity;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map