@faremeter/facilitator 0.12.0 → 0.14.0

package/README.md

@@ -0,0 +1,32 @@
+# @faremeter/facilitator
+
+Facilitator server implementation for x402 protocol payment settlement and validation.
+
+## Installation
+
+```bash
+pnpm install @faremeter/facilitator
+```
+
+## Features
+
+- Multi-chain support
+- Standard x402 endpoints
+- Payment verification
+- Blockchain settlement
+
+## API Reference
+
+<!-- TSDOC_START -->
+
+<!-- TSDOC_END -->
+
+## Related Packages
+
+- [@faremeter/middleware](https://www.npmjs.com/package/@faremeter/middleware) - Server middleware that uses facilitator
+- [@faremeter/payment-solana](https://www.npmjs.com/package/@faremeter/payment-solana) - Solana payment handler
+- [@faremeter/payment-evm](https://www.npmjs.com/package/@faremeter/payment-evm) - EVM payment handler
+
+## License
+
+LGPL-3.0-only

package/dist/src/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAI1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAKvE,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAkBF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,8EAwLxE"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAI1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAKvE,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAkBF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,8EAgSxE"}

package/dist/src/routes.js

@@ -15,6 +15,67 @@ function summarizeRequirements({ scheme, network, asset, payTo, }) {
 }
 export function createFacilitatorRoutes(args) {
     const router = new Hono();
+    function sendVerifyError(c, status, msg) {
+        const response = {
+            isValid: false,
+        };
+        if (msg !== undefined) {
+            response.invalidReason = msg;
+            logger.error(msg);
+        }
+        else {
+            logger.error("unknown error during verification");
+        }
+        c.status(status);
+        return c.json(response);
+    }
+    router.post("/verify", async (c) => {
+        const x402Req = x.x402VerifyRequest(await c.req.json());
+        if (isValidationError(x402Req)) {
+            return sendVerifyError(c, 400, `couldn't validate request: ${x402Req.summary}`);
+        }
+        let paymentPayload = x402Req.paymentPayload;
+        if (paymentPayload === undefined) {
+            const decodedHeader = x.x402PaymentHeaderToPayload(x402Req.paymentHeader);
+            if (isValidationError(decodedHeader)) {
+                return sendVerifyError(c, 400, `couldn't validate x402 payload: ${decodedHeader.summary}`);
+            }
+            paymentPayload = decodedHeader;
+        }
+        logger.debug("starting verifyment attempt for request: {*}", x402Req);
+        for (const handler of args.handlers) {
+            let t;
+            if (handler.handleVerify === undefined) {
+                continue;
+            }
+            try {
+                t = await handler.handleVerify(x402Req.paymentRequirements, paymentPayload);
+            }
+            catch (e) {
+                let msg = undefined;
+                // XXX - We can do a better job of determining if it's a chain
+                // error, or some other issue.
+                if (e instanceof Error) {
+                    msg = e.message;
+                }
+                else {
+                    msg = "unknown error handling verifyment";
+                }
+                return sendVerifyError(c, 500, msg);
+            }
+            if (t === null) {
+                continue;
+            }
+            logger.debug("facilitator handler agreed to verify and returned: {*}", t);
+            logger.info(`${t.isValid ? "succeeded" : "failed"} verifying request: {*}`, {
+                ...t,
+                requirements: summarizeRequirements(x402Req.paymentRequirements),
+            });
+            return c.json(t);
+        }
+        logger.warning("attempt to verify was made with no handler found, requirements summary was: {*}", summarizeRequirements(x402Req.paymentRequirements));
+        return sendVerifyError(c, 400, "no matching payment handler found");
+    });
     function sendSettleError(c, status, msg) {
         const response = {
             success: false,
@@ -36,9 +97,13 @@ export function createFacilitatorRoutes(args) {
         if (isValidationError(x402Req)) {
             return sendSettleError(c, 400, `couldn't validate request: ${x402Req.summary}`);
         }
-        const paymentPayload = x.x402PaymentHeaderToPayload(x402Req.paymentHeader);
-        if (isValidationError(paymentPayload)) {
-            return sendSettleError(c, 400, `couldn't validate x402 payload: ${paymentPayload.summary}`);
+        let paymentPayload = x402Req.paymentPayload;
+        if (paymentPayload === undefined) {
+            const decodedHeader = x.x402PaymentHeaderToPayload(x402Req.paymentHeader);
+            if (isValidationError(decodedHeader)) {
+                return sendSettleError(c, 400, `couldn't validate x402 payload: ${decodedHeader.summary}`);
+            }
+            paymentPayload = decodedHeader;
         }
         logger.debug("starting settlement attempt for request: {*}", x402Req);
         for (const handler of args.handlers) {