taximeter 0.1.0 → 0.1.2

package/docs/RECORDING.md

@@ -1,75 +0,0 @@
-# Record the 20-second demo
-
-`demo.gif` is a 20-second recording of the included simulation running on Windows,
-captured on 2026-09-08. The simulation runs entirely against a local fixture and
-an in-memory ledger. Its signatures and settlement reports are synthetic.
-
-From a source checkout, prepare the built package:
-
-```sh
-npm ci
-npm run build
-node docs/demo.mjs
-```
-
-The simulation prints 20 allowed payments, the documented 402 block for payment
-21, and an exact total of `140` atomic units. It creates no wallet, key, or persistent
-ledger and closes its listeners when finished.
-
-## Captured Windows recording
-
-The shipped GIF captures an actual `cmd.exe` session through Windows ConPTY using
-[node-pty 1.1.0](https://github.com/microsoft/node-pty). The recorder types
-`node docs/demo.mjs`, stores the terminal's output with its original timing in an
-asciicast v2 file, and waits until 20 seconds have elapsed. It checks the block and
-exact ledger total in the captured output and requires the command shell to exit
-successfully. The terminal is 104 columns by 32 rows.
-
-[agg 1.9.0](https://github.com/asciinema/agg/releases/tag/v1.9.0) renders that capture
-using Consolas at 18 px, line height 1.1, the GitHub dark theme, and a 20 fps cap.
-The final frame is held long enough for the complete GIF to last 20 seconds.
-The resulting GIF is 1049×653 and 96,519 bytes. The final block response and ledger
-total remain visible together. No demo output is fabricated or replaced.
-
-The source capture and encoding tools are local development artifacts and are
-excluded from the repository and npm package. FFmpeg converts the GIF to an H.264
-MP4 with one padding row and column for even dimensions. The following recipes
-can reproduce the demonstration from a source checkout.
-
-## VHS
-
-Install VHS and its ffmpeg/ttyd prerequisites from the
-[official VHS instructions](https://github.com/charmbracelet/vhs#installation).
-Run from the repository root on a system supported by VHS (WSL is suitable on Windows):
-
-```sh
-vhs docs/demo.tape
-```
-
-The tape types exactly `node docs/demo.mjs`, then leaves the resulting block and
-total visible. It writes `docs/demo.gif` at 960×660. Review the output before
-committing the replacement; it must fit within the package's 2 MB tarball limit.
-
-## asciinema alternative
-
-With asciinema and agg installed from their official projects, record the same
-script and convert it:
-
-```sh
-mkdir -p tmp
-asciinema rec --cols 104 --rows 32 --command "node docs/demo.mjs" tmp/demo.cast
-agg tmp/demo.cast docs/demo.gif
-```
-
-This quick alternative uses agg's default final pause and produces a shorter GIF.
-For a 20-second result, increase `--last-frame-duration` by the difference between
-20 seconds and the measured GIF duration, then render again. The verified Windows
-rendering helper calculates that pause automatically.
-
-Run these commands in a POSIX shell or WSL. Do not enter account data,
-wallet material, or real payment authorizations while recording. The expected
-terminal script is only the local demo command above.
-
-The Windows ConPTY/agg recording above was executed and visually checked. The VHS
-and asciinema alternatives remain documented recipes, not verified Windows runs.
-Recording tools are optional and are not package dependencies.

package/docs/demo.mjs

@@ -1,145 +0,0 @@
-import assert from "node:assert/strict";
-import { createServer, request } from "node:http";
-import { setTimeout as delay } from "node:timers/promises";
-import { z } from "zod";
-import { closeProxy, createProxy, Ledger, parseConfig, totals } from "../dist/index.js";
-
-// Synthetic envelopes only: no signing, wallet, facilitator, or real payment.
-const asset = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
-const payTo = "0x209693bc6afc0c5328ba36faf03c514ef312287c";
-const payer = "0x857b06519e91e3a54538791bdbb0e22373e36b66";
-const encode = (value) => Buffer.from(JSON.stringify(value)).toString("base64");
-const accepted = {
-  scheme: "exact",
-  network: "eip155:8453",
-  asset,
-  payTo,
-  amount: "7",
-  maxTimeoutSeconds: 60,
-  extra: { name: "USD Coin", version: "2" },
-};
-const upstream = createServer((req, res) => {
-  const header = z.string().optional().parse(req.headers["payment-signature"]);
-  if (!header) {
-    const resource = z
-      .url()
-      .parse(`http://${z.string().parse(req.headers.host)}${z.string().parse(req.url)}`);
-    res.writeHead(402, {
-      "PAYMENT-REQUIRED": encode({
-        x402Version: 2,
-        resource: { url: resource },
-        accepts: [accepted],
-      }),
-    });
-    res.end("Synthetic offer");
-    return;
-  }
-  const payment = z
-    .object({ payload: z.object({ authorization: z.object({ nonce: z.string() }) }) })
-    .parse(JSON.parse(Buffer.from(header, "base64").toString("utf8")));
-  res.writeHead(200, {
-    "PAYMENT-RESPONSE": encode({
-      success: true,
-      network: "eip155:8453",
-      payer,
-      transaction: payment.payload.authorization.nonce,
-    }),
-  });
-  res.end("Synthetic settlement reported");
-});
-async function listen(server) {
-  await new Promise((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(0, "127.0.0.1", () => {
-      server.off("error", reject);
-      resolve();
-    });
-  });
-  return z.object({ port: z.number() }).parse(server.address()).port;
-}
-const ledger = new Ledger(":memory:");
-const proxy = createProxy({
-  ledger,
-  config: parseConfig({ budgets: { perTask: null, perAgent: null, global: { amount: "140" } } }),
-});
-try {
-  const upstreamPort = await listen(upstream);
-  const proxyPort = await listen(proxy);
-  const resource = `http://127.0.0.1:${upstreamPort}/data`;
-  const offer = await fetch(resource);
-  assert.equal(offer.status, 402);
-  const challenge = z
-    .object({
-      x402Version: z.literal(2),
-      resource: z.object({ url: z.url() }),
-      accepts: z.array(z.object({ amount: z.literal("7") })),
-    })
-    .parse(
-      JSON.parse(
-        Buffer.from(z.string().parse(offer.headers.get("payment-required")), "base64").toString(
-          "utf8",
-        ),
-      ),
-    );
-  assert.equal(challenge.resource.url, resource);
-  await offer.arrayBuffer();
-  console.log("Taximeter | local simulation | no money moves");
-  console.log("Budget: 140 atomic units. Each payment: 7 atomic units.");
-  for (let index = 1; index <= 21; index++) {
-    const payload = {
-      signature: `0x${"12".repeat(65)}`,
-      authorization: {
-        from: payer,
-        to: payTo,
-        value: "7",
-        validAfter: "0",
-        validBefore: "9999999999",
-        nonce: `0x${index.toString(16).padStart(64, "0")}`,
-      },
-    };
-    const result = await new Promise((resolve, reject) => {
-      const req = request(
-        {
-          hostname: "127.0.0.1",
-          port: proxyPort,
-          path: resource,
-          headers: {
-            "PAYMENT-SIGNATURE": encode({
-              x402Version: 2,
-              accepted,
-              resource: { url: resource },
-              payload,
-            }),
-            "Taximeter-Task": "demo",
-            "Taximeter-Agent": "local-fixture",
-          },
-        },
-        (res) => {
-          let body = "";
-          res.setEncoding("utf8");
-          res.on("data", (chunk) => {
-            body += z.string().parse(chunk);
-          });
-          res.on("error", reject);
-          res.on("end", () => resolve({ status: res.statusCode, body }));
-        },
-      );
-      req.on("error", reject);
-      req.end();
-    });
-    assert.equal(result.status, index <= 20 ? 200 : 402);
-    console.log(
-      `Payment ${index.toString().padStart(2)} | ${index <= 20 ? "allowed" : "BLOCKED"} | total ${totals(ledger.view())[0]?.amount} atomic units`,
-    );
-    if (index === 21) console.log(result.body);
-    await delay(80);
-  }
-  assert.equal(totals(ledger.view())[0]?.amount, "140");
-  assert.equal(ledger.events().filter((row) => row.status === "blocked").length, 1);
-  console.log("Exact ledger total: 140 atomic units. One blocked event recorded.");
-} finally {
-  if (proxy.listening) await closeProxy(proxy);
-  upstream.closeAllConnections();
-  if (upstream.listening) await new Promise((resolve) => upstream.close(resolve));
-  ledger.close();
-}

package/docs/demo.tape

@@ -1,15 +0,0 @@
-Output docs/demo.gif
-Set Shell "bash"
-Set FontSize 18
-Set Width 960
-Set Height 660
-Set TypingSpeed 50ms
-Set Padding 20
-Hide
-Type "clear"
-Enter
-Sleep 500ms
-Show
-Type "node docs/demo.mjs"
-Enter
-Sleep 18s