@vallum/standards 0.0.0-prerelease

package/dist/x402.js

@@ -0,0 +1,76 @@
+import { mapX402PaymentRequiredToManifest, } from "@vallum/manifest";
+import { evaluateAgentActionPolicy, } from "@vallum/policy-gateway";
+import { createX402ExternalPaymentReceiptState, redactX402PaymentMetadata, } from "@vallum/receipts";
+export function redactX402PaymentLogMetadata(input) {
+    return redactX402PaymentMetadata(input);
+}
+export async function runX402MockFacilitatorFlow(options) {
+    const manifest = mapX402PaymentRequiredToManifest(options.paymentRequired, {
+        ...options.manifestContext,
+        now: options.now ?? options.manifestContext.now,
+    });
+    const policyDecision = evaluateAgentActionPolicy(options.policy, manifest, { now: options.now });
+    if (!policyDecision.allowed)
+        return { approved: false, manifest, denial: policyDecision, stage: "policy" };
+    const accepted = options.paymentRequired.accepts.at(options.manifestContext.acceptedIndex ?? 0);
+    if (!accepted) {
+        throw new Error("x402 flow cannot start without an accepted payment requirement.");
+    }
+    const paymentId = manifest.idempotencyKey;
+    const paymentPayload = {
+        x402Version: 2,
+        resource: options.paymentRequired.resource,
+        accepted,
+        payload: options.paymentPayload ?? {
+            paymentId,
+            paymentSignature: "0xpayment-signature",
+        },
+        extensions: {
+            "payment-identifier": {
+                id: paymentId,
+            },
+        },
+    };
+    const facilitatorRequest = {
+        x402Version: 2,
+        paymentPayload,
+        paymentRequirements: accepted,
+    };
+    const verify = await options.facilitator.verify(facilitatorRequest);
+    if (!verify.isValid) {
+        const receipt = createX402ExternalPaymentReceiptState({ paymentId, verify });
+        return {
+            approved: false,
+            manifest,
+            receipt,
+            paymentFailure: {
+                stage: "verify",
+                reasonCode: "X402_VERIFY_FAILED",
+                message: verify.invalidMessage ?? verify.invalidReason ?? "x402 verification failed.",
+            },
+            logSafePaymentMetadata: redactX402PaymentLogMetadata({ paymentId, paymentPayload, verify }),
+        };
+    }
+    const settle = await options.facilitator.settle(facilitatorRequest);
+    const receipt = createX402ExternalPaymentReceiptState({ paymentId, verify, settle });
+    if (!settle.success) {
+        return {
+            approved: false,
+            manifest,
+            receipt,
+            paymentFailure: {
+                stage: "settle",
+                reasonCode: "X402_SETTLE_FAILED",
+                message: settle.errorMessage ?? settle.errorReason ?? "x402 settlement failed.",
+            },
+            logSafePaymentMetadata: redactX402PaymentLogMetadata({ paymentId, paymentPayload, verify, settle }),
+        };
+    }
+    return {
+        approved: true,
+        manifest,
+        receipt,
+        toolResult: await options.invokeTool(),
+        logSafePaymentMetadata: redactX402PaymentLogMetadata({ paymentId, paymentPayload, verify, settle }),
+    };
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@vallum/standards",
+  "version": "0.0.0-prerelease",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@vallum/manifest": "0.0.0-prerelease",
+    "@vallum/policy-gateway": "0.0.0-prerelease",
+    "@vallum/receipts": "0.0.0-prerelease",
+    "@vallum/registry": "0.0.0-prerelease"
+  },
+  "description": "Standards bridge adapters for Vallum.",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  }
+}