feat: facilitator

examples/client/.env.example

@@ -0,0 +1 @@
+EVM_PRIVATE_KEY=0xYourEvmPrivateKey

examples/client/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

examples/client/index.ts

@@ -0,0 +1,36 @@
+import { x402Client, x402HTTPClient } from "@x402/core/client";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { wrapFetchWithPayment } from "@x402/fetch";
+import { privateKeyToAccount } from "viem/accounts";
+
+// Create signer
+const signer = privateKeyToAccount(
+  process.env.EVM_PRIVATE_KEY as `0x${string}`
+);
+
+// Create x402 client and register EVM scheme
+const client = new x402Client();
+client.register("eip155:16661", new ExactEvmScheme(signer));
+
+// Wrap fetch with payment handling
+const fetchWithPayment = wrapFetchWithPayment(fetch, client);
+
+// Make request - payment is handled automatically
+const response = await fetchWithPayment("http://localhost:3000/weather", {
+  method: "GET",
+  headers: {
+    "Content-Type": "application/json",
+  },
+});
+
+const data = await response.json();
+console.log("Response:", data);
+
+// Get payment receipt from response headers
+if (response.ok) {
+  const httpClient = new x402HTTPClient(client);
+  const paymentResponse = httpClient.getPaymentSettleResponse((name) =>
+    response.headers.get(name)
+  );
+  console.log("Payment settled:", paymentResponse);
+}

examples/client/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "newt0n-client-example",
+  "module": "index.ts",
+  "type": "module",
+  "private": true,
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@x402/evm": "^2.10.0",
+    "@x402/fetch": "^2.10.0",
+    "viem": "^2.48.0"
+  }
+}

examples/client/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "types": ["bun"],
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

examples/server/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

examples/server/index.ts

@@ -0,0 +1,64 @@
+import { HTTPFacilitatorClient } from "@x402/core/server";
+import { ExactEvmScheme } from "@x402/evm/exact/server";
+import { paymentMiddleware, x402ResourceServer } from "@x402/hono";
+import { Hono } from "hono";
+import { logger } from "hono/logger";
+
+const app = new Hono();
+const evmAddress = "0xYourEvmAddress";
+
+const facilitatorClient = new HTTPFacilitatorClient({
+  url: "http://facilitator.newt0n.ai",
+});
+
+app.use(logger());
+
+const zeroGExactScheme = new ExactEvmScheme();
+zeroGExactScheme.registerMoneyParser(
+  async (amount: number, _network: string) => {
+    const tokenAmount = Math.floor(amount * 1_000_000).toString();
+
+    return {
+      amount: tokenAmount,
+      asset: "0x1f3aa82227281ca364bfb3d253b0f1af1da6473e",
+      extra: {
+        name: "Bridged USDC",
+        version: "2",
+      },
+    };
+  }
+);
+
+app.use(
+  paymentMiddleware(
+    {
+      "GET /weather": {
+        accepts: [
+          {
+            scheme: "exact",
+            price: "$0.001",
+            network: "eip155:16661",
+            payTo: evmAddress,
+          },
+        ],
+        description: "Weather data",
+        mimeType: "application/json",
+      },
+    },
+    new x402ResourceServer(facilitatorClient).register(
+      "eip155:16661",
+      zeroGExactScheme
+    )
+  )
+);
+
+app.get("/weather", (c) => {
+  return c.json({
+    report: {
+      weather: "sunny",
+      temperature: 70,
+    },
+  });
+});
+
+export default app;

examples/server/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "newt0n-server-example",
+  "module": "index.ts",
+  "type": "module",
+  "private": true,
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@x402/core": "^2.10.0",
+    "@x402/evm": "^2.10.0",
+    "@x402/hono": "^2.10.0",
+    "hono": "^4.12.14"
+  }
+}