@4mica/cli 0.2.0

package/templates/buyer-express/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "__DESCRIPTION__",
+  "scripts": {
+    "start": "tsx src/buyer.ts"
+  },
+  "dependencies": {
+    "@4mica/sdk": "workspace:*",
+    "@4mica/sdk-node": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:node24",
+    "tsx": "catalog:",
+    "typescript": "catalog:typescript-latest"
+  }
+}

package/templates/buyer-express/src/buyer.ts

@@ -0,0 +1,82 @@
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+function resolveSellerUrl() {
+  if (process.env.SELLER_URL) return process.env.SELLER_URL;
+  try {
+    const base = readFileSync(
+      join(tmpdir(), "__TMPFILE__"),
+      "utf8",
+    ).trim();
+    if (base) return `${base}/premium`;
+  } catch {
+    return "http://localhost:__PORT__/premium";
+  }
+  return "http://localhost:__PORT__/premium";
+}
+
+const SELLER_URL = resolveSellerUrl();
+
+type X402PaymentRequired = {
+  x402Version: number;
+  accepts: Array<{
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    extra?: { tabEndpoint?: string };
+  }>;
+};
+
+function demoPaymentHeader(
+  requirement: X402PaymentRequired["accepts"][number],
+) {
+  const envelope = {
+    x402Version: 1,
+    scheme: requirement.scheme,
+    network: requirement.network,
+    payload: {
+      claims: {
+        version: "v1",
+        user_address: "0x2222222222222222222222222222222222222222",
+        recipient_address: requirement.payTo,
+        req_id: "0x1",
+        amount: `0x${BigInt(requirement.amount).toString(16)}`,
+        asset_address: requirement.asset,
+        timestamp: Math.floor(Date.now() / 1000),
+      },
+      signature: "0xdemoSignature",
+      scheme: "eip712",
+    },
+  };
+  return Buffer.from(JSON.stringify(envelope)).toString("base64");
+}
+
+async function main() {
+  const first = await fetch(SELLER_URL);
+  console.log(`[buyer] GET ${SELLER_URL} → ${first.status}`);
+  if (first.status !== 402) {
+    console.log("[buyer] unexpected: not paywalled?", await first.text());
+    return;
+  }
+  const required = (await first.json()) as X402PaymentRequired;
+  const requirement = required.accepts[0];
+  console.log("[buyer] payment required:", requirement);
+
+  const header = demoPaymentHeader(requirement);
+
+  const paid = await fetch(SELLER_URL, { headers: { "X-PAYMENT": header } });
+  console.log(`[buyer] GET ${SELLER_URL} (paid) → ${paid.status}`);
+  console.log(
+    "[buyer] X-PAYMENT-RESPONSE:",
+    paid.headers.get("X-PAYMENT-RESPONSE"),
+  );
+  console.log("[buyer] body:", await paid.json());
+}
+
+main().catch((err) => {
+  console.error("[buyer] failed:", err);
+  process.exitCode = 1;
+});

package/templates/buyer-express/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/buyer-hono/.env.example

@@ -0,0 +1,12 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=

package/templates/buyer-hono/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run start
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start the matching seller first, then run this to pay for the gated route.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/buyer-hono/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log

package/templates/buyer-hono/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "__DESCRIPTION__",
+  "scripts": {
+    "start": "tsx src/buyer.ts"
+  },
+  "dependencies": {
+    "@4mica/sdk": "workspace:*",
+    "@4mica/sdk-node": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:node24",
+    "tsx": "catalog:",
+    "typescript": "catalog:typescript-latest"
+  }
+}

package/templates/buyer-hono/src/buyer.ts

@@ -0,0 +1,82 @@
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+function resolveSellerUrl() {
+  if (process.env.SELLER_URL) return process.env.SELLER_URL;
+  try {
+    const base = readFileSync(
+      join(tmpdir(), "__TMPFILE__"),
+      "utf8",
+    ).trim();
+    if (base) return `${base}/premium`;
+  } catch {
+    return "http://localhost:__PORT__/premium";
+  }
+  return "http://localhost:__PORT__/premium";
+}
+
+const SELLER_URL = resolveSellerUrl();
+
+type X402PaymentRequired = {
+  x402Version: number;
+  accepts: Array<{
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    extra?: { tabEndpoint?: string };
+  }>;
+};
+
+function demoPaymentHeader(
+  requirement: X402PaymentRequired["accepts"][number],
+) {
+  const envelope = {
+    x402Version: 1,
+    scheme: requirement.scheme,
+    network: requirement.network,
+    payload: {
+      claims: {
+        version: "v1",
+        user_address: "0x2222222222222222222222222222222222222222",
+        recipient_address: requirement.payTo,
+        req_id: "0x1",
+        amount: `0x${BigInt(requirement.amount).toString(16)}`,
+        asset_address: requirement.asset,
+        timestamp: Math.floor(Date.now() / 1000),
+      },
+      signature: "0xdemoSignature",
+      scheme: "eip712",
+    },
+  };
+  return Buffer.from(JSON.stringify(envelope)).toString("base64");
+}
+
+async function main() {
+  const first = await fetch(SELLER_URL);
+  console.log(`[buyer] GET ${SELLER_URL} → ${first.status}`);
+  if (first.status !== 402) {
+    console.log("[buyer] unexpected: not paywalled?", await first.text());
+    return;
+  }
+  const required = (await first.json()) as X402PaymentRequired;
+  const requirement = required.accepts[0];
+  console.log("[buyer] payment required:", requirement);
+
+  const header = demoPaymentHeader(requirement);
+
+  const paid = await fetch(SELLER_URL, { headers: { "X-PAYMENT": header } });
+  console.log(`[buyer] GET ${SELLER_URL} (paid) → ${paid.status}`);
+  console.log(
+    "[buyer] X-PAYMENT-RESPONSE:",
+    paid.headers.get("X-PAYMENT-RESPONSE"),
+  );
+  console.log("[buyer] body:", await paid.json());
+}
+
+main().catch((err) => {
+  console.error("[buyer] failed:", err);
+  process.exitCode = 1;
+});

package/templates/buyer-hono/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/buyer-next/.env.example

@@ -0,0 +1,12 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=

package/templates/buyer-next/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run start
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start the matching seller first, then run this to pay for the gated route.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/buyer-next/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log

package/templates/buyer-next/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "__DESCRIPTION__",
+  "scripts": {
+    "start": "tsx src/buyer.ts"
+  },
+  "dependencies": {
+    "@4mica/sdk": "workspace:*",
+    "@4mica/sdk-node": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:node24",
+    "tsx": "catalog:",
+    "typescript": "catalog:typescript-latest"
+  }
+}

package/templates/buyer-next/src/buyer.ts

@@ -0,0 +1,82 @@
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+function resolveSellerUrl() {
+  if (process.env.SELLER_URL) return process.env.SELLER_URL;
+  try {
+    const base = readFileSync(
+      join(tmpdir(), "__TMPFILE__"),
+      "utf8",
+    ).trim();
+    if (base) return `${base}/api/protected`;
+  } catch {
+    return "http://localhost:__PORT__/api/protected";
+  }
+  return "http://localhost:__PORT__/api/protected";
+}
+
+const SELLER_URL = resolveSellerUrl();
+
+type X402PaymentRequired = {
+  x402Version: number;
+  accepts: Array<{
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    extra?: { tabEndpoint?: string };
+  }>;
+};
+
+function demoPaymentHeader(
+  requirement: X402PaymentRequired["accepts"][number],
+) {
+  const envelope = {
+    x402Version: 1,
+    scheme: requirement.scheme,
+    network: requirement.network,
+    payload: {
+      claims: {
+        version: "v1",
+        user_address: "0x2222222222222222222222222222222222222222",
+        recipient_address: requirement.payTo,
+        req_id: "0x1",
+        amount: `0x${BigInt(requirement.amount).toString(16)}`,
+        asset_address: requirement.asset,
+        timestamp: Math.floor(Date.now() / 1000),
+      },
+      signature: "0xdemoSignature",
+      scheme: "eip712",
+    },
+  };
+  return Buffer.from(JSON.stringify(envelope)).toString("base64");
+}
+
+async function main() {
+  const first = await fetch(SELLER_URL);
+  console.log(`[buyer] GET ${SELLER_URL} → ${first.status}`);
+  if (first.status !== 402) {
+    console.log("[buyer] unexpected: not paywalled?", await first.text());
+    return;
+  }
+  const required = (await first.json()) as X402PaymentRequired;
+  const requirement = required.accepts[0];
+  console.log("[buyer] payment required:", requirement);
+
+  const header = demoPaymentHeader(requirement);
+
+  const paid = await fetch(SELLER_URL, { headers: { "X-PAYMENT": header } });
+  console.log(`[buyer] GET ${SELLER_URL} (paid) → ${paid.status}`);
+  console.log(
+    "[buyer] X-PAYMENT-RESPONSE:",
+    paid.headers.get("X-PAYMENT-RESPONSE"),
+  );
+  console.log("[buyer] body:", await paid.json());
+}
+
+main().catch((err) => {
+  console.error("[buyer] failed:", err);
+  process.exitCode = 1;
+});

package/templates/buyer-next/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/seller-express/.env.example

@@ -0,0 +1,12 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=

package/templates/seller-express/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run dev
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start this, then run a matching buyer to exercise the 402 → 200 handshake.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/seller-express/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log

package/templates/seller-express/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "__DESCRIPTION__",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "start": "tsx src/server.ts"
+  },
+  "dependencies": {
+    "@4mica/sdk": "workspace:*",
+    "@4mica/sdk-express": "workspace:*",
+    "@4mica/sdk-node": "workspace:*",
+    "express": "catalog:"
+  },
+  "devDependencies": {
+    "@types/express": "catalog:",
+    "@types/node": "catalog:node24",
+    "tsx": "catalog:",
+    "typescript": "catalog:typescript-latest"
+  }
+}

package/templates/seller-express/src/server.ts

@@ -0,0 +1,64 @@
+import { rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import type { PaywallConfig, PaywallVerifier } from "@4mica/sdk-express";
+import { paywall } from "@4mica/sdk-express";
+import express from "express";
+
+const PORT_FILE = join(tmpdir(), "__TMPFILE__");
+
+const verifier: PaywallVerifier = {
+  async issueGuarantee(payload) {
+    console.log("[seller] verifying payment payload:", payload);
+    return { claims: "0xdemoClaims", signature: "0xdemoSignature" };
+  },
+};
+
+export const PAYWALL_CONFIG: PaywallConfig = {
+  payTo: "0x1111111111111111111111111111111111111111",
+  asset: "0x0000000000000000000000000000000000000000",
+  network: "base-sepolia",
+  amount: "1000",
+  tabEndpoint: "http://localhost:__PORT__/session",
+  description: "Premium market data feed",
+};
+
+const app = express();
+app.use(express.json());
+
+app.post("/session", (_req, res) => {
+  res.json({
+    userAddress: "0x2222222222222222222222222222222222222222",
+    nextReqId: "0x1",
+  });
+});
+
+app.get("/premium", paywall(verifier, PAYWALL_CONFIG), (_req, res) => {
+  res.json({ ok: true, data: "🔓 premium market data unlocked" });
+});
+
+function listen(port: number, attemptsLeft = 20) {
+  const server = app.listen(port);
+  server.once("listening", () => {
+    const url = `http://localhost:${port}`;
+    PAYWALL_CONFIG.tabEndpoint = `${url}/session`;
+    writeFileSync(PORT_FILE, url);
+    console.log(`[seller-express] listening on ${url}`);
+    console.log(`  GET /premium is paywalled — run the buyer to pay for it.`);
+  });
+  server.once("error", (err: NodeJS.ErrnoException) => {
+    if (err.code === "EADDRINUSE" && attemptsLeft > 0) {
+      console.log(`[seller-express] port ${port} in use, trying ${port + 1}…`);
+      listen(port + 1, attemptsLeft - 1);
+    } else {
+      throw err;
+    }
+  });
+}
+
+const cleanup = () => rmSync(PORT_FILE, { force: true });
+process.on("exit", cleanup);
+process.on("SIGINT", () => process.exit(0));
+process.on("SIGTERM", () => process.exit(0));
+
+listen(Number(process.env.PORT ?? __PORT__));

package/templates/seller-express/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/seller-hono/.env.example

@@ -0,0 +1,12 @@
+# 4Mica runs in DEMO MODE with zero config (mock verifier / demo payment).
+# To go live, swap the mock verifier for createClient() from @4mica/sdk-node
+# and fill these in. Docs: https://4mica.io/docs
+
+# 4MICA_WALLET_PRIVATE_KEY=0x...
+# 4MICA_NETWORK=base-sepolia
+# 4MICA_RPC_URL=
+# 4MICA_ETHEREUM_HTTP_RPC_URL=
+# 4MICA_CONTRACT_ADDRESS=
+# 4MICA_ADMIN_API_KEY=
+# 4MICA_BEARER_TOKEN=
+# 4MICA_AUTH_URL=

package/templates/seller-hono/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+__DESCRIPTION__
+
+Generated with `4mica init` — part of the [4Mica](https://4mica.io) x402 payment network.
+
+## Run (demo mode — no config)
+
+```bash
+npm install
+npm run dev
+```
+
+Demo mode uses a mock verifier and a locally-built payment header, so it runs
+with **zero credentials**. Start this, then run a matching buyer to exercise the 402 → 200 handshake.
+
+## Go live
+
+Copy `.env.example` → `.env`, fill in your `4MICA_*` credentials, and swap the
+mock verifier for `createClient()` from `@4mica/sdk-node`.
+
+## Manage agents & transactions
+
+```bash
+4mica dashboard
+```

package/templates/seller-hono/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.env
+.env.local
+.next
+*.log