tally-sdk 0.1.0 → 0.2.0

package/dist/src/hook.d.ts

@@ -0,0 +1,6 @@
+import type { Store } from "./types.js";
+export interface HookOptions {
+    facilitator: string;
+}
+export declare function createTallyFetch(fetchFn: typeof fetch, store: Store, options?: HookOptions): typeof fetch;
+//# sourceMappingURL=hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAsBD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,KAAK,EACrB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,KAAK,CAiBd"}

package/dist/src/hook.js

@@ -0,0 +1,37 @@
+import { v4 as uuidv4 } from "uuid";
+function extractPayload(body, headers, options) {
+    const b = (body && typeof body === "object" ? body : {});
+    const now = Date.now();
+    return {
+        id: b.id ?? uuidv4(),
+        facilitator: options.facilitator,
+        requestId: b.requestId ?? headers.get("x-request-id") ?? "",
+        fromAddress: b.fromAddress ?? "",
+        toAddress: b.toAddress ?? headers.get("x-payment-address") ?? "",
+        amount: b.amount ?? headers.get("x-payment-amount") ?? "0",
+        asset: b.asset ?? headers.get("x-payment-asset") ?? "USDC",
+        chainId: b.chainId ?? "eip155:1",
+        txHash: b.txHash ?? "",
+        timestamp: b.timestamp ?? now,
+        memo: b.memo ?? undefined,
+        metadata: b.metadata ?? undefined,
+    };
+}
+export function createTallyFetch(fetchFn, store, options) {
+    return async (input, init) => {
+        const response = await fetchFn(input, init);
+        if (options && (response.headers.has("x-facilitator") || response.headers.has("x-request-id"))) {
+            try {
+                const cloned = response.clone();
+                const body = await cloned.json();
+                const payload = extractPayload(body, cloned.headers, options);
+                await store.insert(payload);
+            }
+            catch {
+                // swallow — never break the agent request
+            }
+        }
+        return response;
+    };
+}
+//# sourceMappingURL=hook.js.map

package/dist/src/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAOpC,SAAS,cAAc,CAAC,IAAa,EAAE,OAAgB,EAAE,OAAoB;IAC3E,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;IACpF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,OAAO;QACL,EAAE,EAAG,CAAC,CAAC,EAAa,IAAI,MAAM,EAAE;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAG,CAAC,CAAC,SAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;QACvE,WAAW,EAAG,CAAC,CAAC,WAAsB,IAAI,EAAE;QAC5C,SAAS,EAAG,CAAC,CAAC,SAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAC5E,MAAM,EAAG,CAAC,CAAC,MAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG;QACtE,KAAK,EAAG,CAAC,CAAC,KAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM;QACtE,OAAO,EAAG,CAAC,CAAC,OAAkB,IAAI,UAAU;QAC5C,MAAM,EAAG,CAAC,CAAC,MAAiB,IAAI,EAAE;QAClC,SAAS,EAAG,CAAC,CAAC,SAAoB,IAAI,GAAG;QACzC,IAAI,EAAG,CAAC,CAAC,IAAe,IAAI,SAAS;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAmC,IAAI,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,KAAY,EACZ,OAAqB;IAErB,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YAC/F,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9D,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+import type { TallyClient, TallyConfig } from "./types.js";
+export type { PaymentPayload, Store, TallyConfig, TallyClient } from "./types.js";
+export { handleIncomingPayment } from "./middleware/core.js";
+export type { IncomingPayment } from "./middleware/core.js";
+export declare function createTally(config: TallyConfig): TallyClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAS,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAsB5D"}

package/dist/src/index.js

@@ -0,0 +1,22 @@
+import { SqliteStore } from "./store.js";
+import { createTallyFetch } from "./hook.js";
+export { handleIncomingPayment } from "./middleware/core.js";
+export function createTally(config) {
+    const store = config.store ?? new SqliteStore("./tally.db");
+    const originalFetch = globalThis.fetch;
+    const wrappedFetch = createTallyFetch(originalFetch.bind(globalThis), store, { facilitator: config.facilitator });
+    return {
+        fetch: wrappedFetch,
+        wrap() {
+            globalThis.fetch = wrappedFetch;
+        },
+        unwrap() {
+            globalThis.fetch = originalFetch;
+        },
+        store,
+        async close() {
+            await store.close();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,KAAK,GAAU,MAAM,CAAC,KAAK,IAAI,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,gBAAgB,CACnC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAC9B,KAAK,EACL,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,IAAI;YACF,UAAU,CAAC,KAAK,GAAG,YAAY,CAAC;QAClC,CAAC;QACD,MAAM;YACJ,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;QACnC,CAAC;QACD,KAAK;QACL,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/middleware/core.d.ts

@@ -0,0 +1,15 @@
+import type { PaymentPayload, Store } from "../types.js";
+export interface IncomingPayment {
+    facilitator: string;
+    requestId?: string;
+    fromAddress?: string;
+    toAddress?: string;
+    amount?: string;
+    asset?: string;
+    chainId?: string;
+    txHash?: string;
+    memo?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function handleIncomingPayment(store: Store, payment: IncomingPayment): Promise<PaymentPayload>;
+//# sourceMappingURL=core.d.ts.map

package/dist/src/middleware/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/middleware/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAkBzB"}

package/dist/src/middleware/core.js

@@ -0,0 +1,20 @@
+import { v4 as uuidv4 } from "uuid";
+export async function handleIncomingPayment(store, payment) {
+    const payload = {
+        id: uuidv4(),
+        facilitator: payment.facilitator,
+        requestId: payment.requestId ?? "",
+        fromAddress: payment.fromAddress ?? "",
+        toAddress: payment.toAddress ?? "",
+        amount: payment.amount ?? "0",
+        asset: payment.asset ?? "USDC",
+        chainId: payment.chainId ?? "eip155:1",
+        txHash: payment.txHash ?? "",
+        timestamp: Date.now(),
+        memo: payment.memo,
+        metadata: payment.metadata,
+    };
+    await store.insert(payload);
+    return payload;
+}
+//# sourceMappingURL=core.js.map

package/dist/src/middleware/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/middleware/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAgBpC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAY,EACZ,OAAwB;IAExB,MAAM,OAAO,GAAmB;QAC9B,EAAE,EAAE,MAAM,EAAE;QACZ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IAEF,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/middleware/express.d.ts

@@ -0,0 +1,4 @@
+import type { Request, Response, NextFunction } from "express";
+import type { Store } from "../types.js";
+export declare function tallyMiddleware(store: Store, facilitator: string): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=express.d.ts.map

package/dist/src/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/middleware/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,IACvD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA0BxD"}

package/dist/src/middleware/express.js

@@ -0,0 +1,26 @@
+import { handleIncomingPayment } from "./core.js";
+export function tallyMiddleware(store, facilitator) {
+    return (req, res, next) => {
+        const originalJson = res.json.bind(res);
+        res.json = function (body) {
+            if (res.statusCode === 402) {
+                const payment = {
+                    facilitator,
+                    requestId: req.headers["x-request-id"] ?? undefined,
+                    fromAddress: body?.fromAddress,
+                    toAddress: body?.toAddress,
+                    amount: body?.amount,
+                    asset: body?.asset,
+                    chainId: body?.chainId,
+                    txHash: body?.txHash,
+                    memo: body?.memo,
+                    metadata: body?.metadata,
+                };
+                handleIncomingPayment(store, payment).catch(() => { });
+            }
+            return originalJson(body);
+        };
+        next();
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/src/middleware/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/middleware/express.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,WAAmB;IAC/D,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACzD,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAExC,GAAG,CAAC,IAAI,GAAG,UAAU,IAAa;YAChC,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG;oBACd,WAAW;oBACX,SAAS,EAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAY,IAAI,SAAS;oBAC/D,WAAW,EAAG,IAAgC,EAAE,WAAiC;oBACjF,SAAS,EAAG,IAAgC,EAAE,SAA+B;oBAC7E,MAAM,EAAG,IAAgC,EAAE,MAA4B;oBACvE,KAAK,EAAG,IAAgC,EAAE,KAA2B;oBACrE,OAAO,EAAG,IAAgC,EAAE,OAA6B;oBACzE,MAAM,EAAG,IAAgC,EAAE,MAA4B;oBACvE,IAAI,EAAG,IAAgC,EAAE,IAA0B;oBACnE,QAAQ,EAAG,IAAgC,EAAE,QAA+C;iBAC7F,CAAC;gBAEF,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/store.d.ts

@@ -0,0 +1,14 @@
+import type { PaymentPayload, Store } from "./types.js";
+export declare class SqliteStore implements Store {
+    private db;
+    constructor(path: string);
+    insert(payload: PaymentPayload): Promise<void>;
+    list(opts?: {
+        facilitator?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<PaymentPayload[]>;
+    get(id: string): Promise<PaymentPayload | null>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExD,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,EAAE,MAAM;IAsBlB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBjG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/src/store.js

@@ -0,0 +1,84 @@
+import Database from "better-sqlite3";
+export class SqliteStore {
+    db;
+    constructor(path) {
+        this.db = new Database(path);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS payments (
+        id          TEXT PRIMARY KEY,
+        facilitator TEXT NOT NULL,
+        request_id  TEXT NOT NULL,
+        from_addr   TEXT NOT NULL,
+        to_addr     TEXT NOT NULL,
+        amount      TEXT NOT NULL,
+        asset       TEXT NOT NULL DEFAULT 'USDC',
+        chain_id    TEXT NOT NULL,
+        tx_hash     TEXT NOT NULL,
+        memo        TEXT,
+        metadata    TEXT,
+        created_at  INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_payments_facilitator ON payments(facilitator);
+      CREATE INDEX IF NOT EXISTS idx_payments_created_at ON payments(created_at);
+    `);
+    }
+    async insert(payload) {
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO payments
+        (id, facilitator, request_id, from_addr, to_addr, amount, asset, chain_id, tx_hash, memo, metadata, created_at)
+      VALUES
+        (@id, @facilitator, @requestId, @fromAddress, @toAddress, @amount, @asset, @chainId, @txHash, @memo, @metadata, @createdAt)
+    `);
+        stmt.run({
+            id: payload.id,
+            facilitator: payload.facilitator,
+            requestId: payload.requestId,
+            fromAddress: payload.fromAddress,
+            toAddress: payload.toAddress,
+            amount: payload.amount,
+            asset: payload.asset,
+            chainId: payload.chainId,
+            txHash: payload.txHash,
+            memo: payload.memo ?? null,
+            metadata: payload.metadata ? JSON.stringify(payload.metadata) : null,
+            createdAt: payload.timestamp,
+        });
+    }
+    async list(opts) {
+        const conditions = [];
+        const params = {};
+        if (opts?.facilitator) {
+            conditions.push("facilitator = @facilitator");
+            params.facilitator = opts.facilitator;
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const limit = opts?.limit ?? 50;
+        const offset = opts?.offset ?? 0;
+        const rows = this.db.prepare(`SELECT * FROM payments ${where} ORDER BY created_at DESC LIMIT @limit OFFSET @offset`).all({ ...params, limit, offset });
+        return rows.map(rowToPayload);
+    }
+    async get(id) {
+        const row = this.db.prepare("SELECT * FROM payments WHERE id = ?").get(id);
+        return row ? rowToPayload(row) : null;
+    }
+    async close() {
+        this.db.close();
+    }
+}
+function rowToPayload(row) {
+    return {
+        id: row.id,
+        facilitator: row.facilitator,
+        requestId: row.request_id,
+        fromAddress: row.from_addr,
+        toAddress: row.to_addr,
+        amount: row.amount,
+        asset: row.asset,
+        chainId: row.chain_id,
+        txHash: row.tx_hash,
+        memo: row.memo ?? undefined,
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        timestamp: row.created_at,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/src/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,36 @@
+export interface PaymentPayload {
+    id: string;
+    facilitator: string;
+    requestId: string;
+    fromAddress: string;
+    toAddress: string;
+    amount: string;
+    asset: string;
+    chainId: string;
+    txHash: string;
+    timestamp: number;
+    memo?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Store {
+    insert(payload: PaymentPayload): Promise<void>;
+    list(opts?: {
+        facilitator?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<PaymentPayload[]>;
+    get(id: string): Promise<PaymentPayload | null>;
+    close(): Promise<void>;
+}
+export interface TallyConfig {
+    facilitator: string;
+    store?: Store;
+}
+export interface TallyClient {
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    wrap(): void;
+    unwrap(): void;
+    store: Store;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACjG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtE,IAAI,IAAI,IAAI,CAAA;IACZ,MAAM,IAAI,IAAI,CAAA;IACd,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "tally-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Accounting, tax, and compliance layer for the agent economy",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./middleware/express": {
+      "import": "./dist/src/middleware/express.js",
+      "types": "./dist/src/middleware/express.d.ts"
     }
   },
   "scripts": {
@@ -29,7 +33,9 @@
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
+    "@types/express": "^5.0.6",
     "@types/uuid": "^10.0.0",
+    "express": "^5.2.1",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   }

package/src/index.ts

@@ -3,6 +3,8 @@ import { createTallyFetch } from "./hook.js";
 import type { Store, TallyClient, TallyConfig } from "./types.js";
 
 export type { PaymentPayload, Store, TallyConfig, TallyClient } from "./types.js";
+export { handleIncomingPayment } from "./middleware/core.js";
+export type { IncomingPayment } from "./middleware/core.js";
 
 export function createTally(config: TallyConfig): TallyClient {
   const store: Store = config.store ?? new SqliteStore("./tally.db");

package/src/middleware/core.ts

@@ -0,0 +1,38 @@
+import { v4 as uuidv4 } from "uuid";
+import type { PaymentPayload, Store } from "../types.js";
+
+export interface IncomingPayment {
+  facilitator: string;
+  requestId?: string;
+  fromAddress?: string;
+  toAddress?: string;
+  amount?: string;
+  asset?: string;
+  chainId?: string;
+  txHash?: string;
+  memo?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export async function handleIncomingPayment(
+  store: Store,
+  payment: IncomingPayment
+): Promise<PaymentPayload> {
+  const payload: PaymentPayload = {
+    id: uuidv4(),
+    facilitator: payment.facilitator,
+    requestId: payment.requestId ?? "",
+    fromAddress: payment.fromAddress ?? "",
+    toAddress: payment.toAddress ?? "",
+    amount: payment.amount ?? "0",
+    asset: payment.asset ?? "USDC",
+    chainId: payment.chainId ?? "eip155:1",
+    txHash: payment.txHash ?? "",
+    timestamp: Date.now(),
+    memo: payment.memo,
+    metadata: payment.metadata,
+  };
+
+  await store.insert(payload);
+  return payload;
+}

package/src/middleware/express.ts

@@ -0,0 +1,32 @@
+import type { Request, Response, NextFunction } from "express";
+import type { Store } from "../types.js";
+import { handleIncomingPayment } from "./core.js";
+
+export function tallyMiddleware(store: Store, facilitator: string) {
+  return (req: Request, res: Response, next: NextFunction) => {
+    const originalJson = res.json.bind(res);
+
+    res.json = function (body: unknown) {
+      if (res.statusCode === 402) {
+        const payment = {
+          facilitator,
+          requestId: (req.headers["x-request-id"] as string) ?? undefined,
+          fromAddress: (body as Record<string, unknown>)?.fromAddress as string | undefined,
+          toAddress: (body as Record<string, unknown>)?.toAddress as string | undefined,
+          amount: (body as Record<string, unknown>)?.amount as string | undefined,
+          asset: (body as Record<string, unknown>)?.asset as string | undefined,
+          chainId: (body as Record<string, unknown>)?.chainId as string | undefined,
+          txHash: (body as Record<string, unknown>)?.txHash as string | undefined,
+          memo: (body as Record<string, unknown>)?.memo as string | undefined,
+          metadata: (body as Record<string, unknown>)?.metadata as Record<string, unknown> | undefined,
+        };
+
+        handleIncomingPayment(store, payment).catch(() => {});
+      }
+
+      return originalJson(body);
+    };
+
+    next();
+  };
+}

package/.opencode/commands/opsx-apply.md

@@ -1,152 +0,0 @@
----
-description: Implement tasks from an OpenSpec change (Experimental)
----
-
-Implement tasks from an OpenSpec change.
-
-**Input**: Optionally specify a change name (e.g., `/opsx-apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
-
-**Steps**
-
-1. **Select the change**
-
-   If a name is provided, use it. Otherwise:
-   - Infer from conversation context if the user mentioned a change
-   - Auto-select if only one active change exists
-   - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
-
-   Always announce: "Using change: <name>" and how to override (e.g., `/opsx-apply <other>`).
-
-2. **Check status to understand the schema**
-   ```bash
-   openspec status --change "<name>" --json
-   ```
-   Parse the JSON to understand:
-   - `schemaName`: The workflow being used (e.g., "spec-driven")
-   - `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints
-   - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others)
-
-3. **Get apply instructions**
-
-   ```bash
-   openspec instructions apply --change "<name>" --json
-   ```
-
-   This returns:
-   - `contextFiles`: artifact ID -> array of concrete file paths (varies by schema)
-   - Progress (total, complete, remaining)
-   - Task list with status
-   - Dynamic instruction based on current state
-
-   **Handle states:**
-   - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx-continue`
-   - If `state: "all_done"`: congratulate, suggest archive
-   - Otherwise: proceed to implementation
-
-   **Workspace guard:** If status JSON reports `actionContext.mode: "workspace-planning"` and `allowedEditRoots` is empty, explain that full workspace apply is not supported in this slice. Treat linked repos and folders as read-only context, ask the user to select an affected area through an explicit implementation workflow, and STOP before editing files.
-
-4. **Read context files**
-
-   Read every file path listed under `contextFiles` from the apply instructions output.
-   The files depend on the schema being used:
-   - **spec-driven**: proposal, specs, design, tasks
-   - Other schemas: follow the contextFiles from CLI output
-
-5. **Show current progress**
-
-   Display:
-   - Schema being used
-   - Progress: "N/M tasks complete"
-   - Remaining tasks overview
-   - Dynamic instruction from CLI
-
-6. **Implement tasks (loop until done or blocked)**
-
-   For each pending task:
-   - Show which task is being worked on
-   - Make the code changes required
-   - Keep changes minimal and focused
-   - Mark task complete in the tasks file: `- [ ]` → `- [x]`
-   - Continue to next task
-
-   **Pause if:**
-   - Task is unclear → ask for clarification
-   - Implementation reveals a design issue → suggest updating artifacts
-   - Error or blocker encountered → report and wait for guidance
-   - User interrupts
-
-7. **On completion or pause, show status**
-
-   Display:
-   - Tasks completed this session
-   - Overall progress: "N/M tasks complete"
-   - If all done: suggest archive
-   - If paused: explain why and wait for guidance
-
-**Output During Implementation**
-
-```
-## Implementing: <change-name> (schema: <schema-name>)
-
-Working on task 3/7: <task description>
-[...implementation happening...]
-✓ Task complete
-
-Working on task 4/7: <task description>
-[...implementation happening...]
-✓ Task complete
-```
-
-**Output On Completion**
-
-```
-## Implementation Complete
-
-**Change:** <change-name>
-**Schema:** <schema-name>
-**Progress:** 7/7 tasks complete ✓
-
-### Completed This Session
-- [x] Task 1
-- [x] Task 2
-...
-
-All tasks complete! You can archive this change with `/opsx-archive`.
-```
-
-**Output On Pause (Issue Encountered)**
-
-```
-## Implementation Paused
-
-**Change:** <change-name>
-**Schema:** <schema-name>
-**Progress:** 4/7 tasks complete
-
-### Issue Encountered
-<description of the issue>
-
-**Options:**
-1. <option 1>
-2. <option 2>
-3. Other approach
-
-What would you like to do?
-```
-
-**Guardrails**
-- Keep going through tasks until done or blocked
-- Always read context files before starting (from the apply instructions output)
-- If task is ambiguous, pause and ask before implementing
-- If implementation reveals issues, pause and suggest artifact updates
-- Keep code changes minimal and scoped to each task
-- Update task checkbox immediately after completing each task
-- Pause on errors, blockers, or unclear requirements - don't guess
-- Use contextFiles from CLI output, don't assume specific file names
-
-**Fluid Workflow Integration**
-
-This skill supports the "actions on a change" model:
-
-- **Can be invoked anytime**: Before all artifacts are done (if tasks exist), after partial implementation, interleaved with other actions
-- **Allows artifact updates**: If implementation reveals design issues, suggest updating artifacts - not phase-locked, work fluidly