mppx 0.0.1 → 0.1.0

package/dist/tempo/server/internal/transport.js

@@ -0,0 +1,118 @@
+/**
+ * Tempo-specific SSE transport that wraps the base HTTP transport
+ * with metering logic (context capture from credentials, per-token
+ * charging via Sse.serve).
+ *
+ * @internal
+ */
+import * as Transport from '../../../server/Transport.js';
+import * as Sse_core from '../../stream/Sse.js';
+/**
+ * Creates a Tempo-metered SSE transport.
+ *
+ * Wraps an HTTP transport with:
+ * - Context capture from credentials (channelId, tickCost)
+ * - Per-token charging via Sse.serve for generator/iterable responses
+ * - Auto-detection of upstream SSE responses
+ * - Fallback to standard HTTP receipt handling for plain Response
+ */
+export function sse(options) {
+    const { pollingInterval, poll } = options;
+    // When `poll` is true, strip `waitForUpdate` so the SSE charge loop
+    // falls back to polling. This is needed for runtimes like Cloudflare Workers
+    // where resolving promises across request contexts is not supported.
+    const store = (() => {
+        if (!poll)
+            return options.store;
+        const { waitForUpdate: _, ...store } = options.store;
+        return store;
+    })();
+    const contextMap = new Map();
+    const base = Transport.http();
+    return Transport.from({
+        name: 'sse',
+        getCredential(request) {
+            const credential = base.getCredential(request);
+            if (credential) {
+                try {
+                    const ctx = Sse_core.fromRequest(request);
+                    contextMap.set(ctx.challengeId, ctx);
+                }
+                catch {
+                    // ignore — non-SSE credentials won't have stream context
+                }
+            }
+            return credential;
+        },
+        respondChallenge(options) {
+            return base.respondChallenge(options);
+        },
+        respondReceipt({ receipt, response, challengeId }) {
+            // Auto-detect upstream SSE responses and parse them into an
+            // AsyncIterable so they flow through the metered pipeline.
+            // This lets proxy consumers simply pass `result.withReceipt(upstreamRes)`
+            // and get per-event charging automatically.
+            const resolved = response instanceof Response && Sse_core.isEventStream(response) && response.body
+                ? Sse_core.iterateData(response, { skip: (d) => d === '[DONE]' })
+                : response;
+            if (isAsyncGeneratorFunction(resolved) || isAsyncIterable(resolved)) {
+                const ctx = contextMap.get(challengeId);
+                if (!ctx)
+                    throw new Error('No SSE context available — credential was not parsed');
+                contextMap.delete(challengeId);
+                // Pass async generator functions directly so Sse.serve gives them
+                // a StreamController for manual charge(). Pass raw AsyncIterables
+                // as-is so Sse.serve auto-charges per yielded value.
+                const generate = isAsyncGeneratorFunction(resolved)
+                    ? resolved
+                    : resolved;
+                const stream = Sse_core.serve({
+                    store,
+                    channelId: ctx.channelId,
+                    challengeId,
+                    tickCost: ctx.tickCost,
+                    pollIntervalMs: pollingInterval,
+                    generate,
+                });
+                return Sse_core.toResponse(stream);
+            }
+            return base.respondReceipt({ receipt, response: response, challengeId });
+        },
+    });
+}
+/** Default SSE serve: iterates values and emits `event: message` per value. */
+export function defaultServe(options) {
+    const iterable = typeof options.generate === 'function' ? options.generate(undefined) : options.generate;
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const value of iterable) {
+                    controller.enqueue(encoder.encode(`event: message\ndata: ${value}\n\n`));
+                }
+            }
+            catch (e) {
+                controller.error(e);
+            }
+            finally {
+                controller.close();
+            }
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            'Content-Type': 'text/event-stream; charset=utf-8',
+            'Cache-Control': 'no-cache, no-transform',
+            Connection: 'keep-alive',
+        },
+    });
+}
+function isAsyncGeneratorFunction(value) {
+    if (typeof value !== 'function')
+        return false;
+    return value.constructor?.name === 'AsyncGeneratorFunction';
+}
+function isAsyncIterable(value) {
+    return value !== null && typeof value === 'object' && Symbol.asyncIterator in value;
+}
+//# sourceMappingURL=transport.js.map

package/dist/tempo/server/internal/transport.js.map

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

package/dist/tempo/stream/Chain.d.ts

@@ -0,0 +1,52 @@
+import { type Account, type Address, type Client, type Hex, type ReadContractReturnType } from 'viem';
+import { escrowAbi } from './escrow.abi.js';
+import type { SignedVoucher } from './Types.js';
+export { escrowAbi };
+/**
+ * On-chain channel state from the escrow contract.
+ */
+export type OnChainChannel = ReadContractReturnType<typeof escrowAbi, 'getChannel'>;
+/**
+ * Read channel state from the escrow contract.
+ */
+export declare function getOnChainChannel(client: Client, escrowContract: Address, channelId: Hex): Promise<OnChainChannel>;
+/**
+ * Verify a topUp by re-reading on-chain channel state.
+ */
+export declare function verifyTopUpTransaction(client: Client, escrowContract: Address, channelId: Hex, previousDeposit: bigint): Promise<{
+    deposit: bigint;
+}>;
+/**
+ * Submit a settle transaction on-chain.
+ */
+export declare function settleOnChain(client: Client, escrowContract: Address, voucher: SignedVoucher): Promise<Hex>;
+/**
+ * Submit a close transaction on-chain.
+ */
+export declare function closeOnChain(client: Client, escrowContract: Address, voucher: SignedVoucher, account?: Account): Promise<Hex>;
+export type BroadcastResult = {
+    txHash: Hex | undefined;
+    onChain: OnChainChannel;
+};
+export declare function broadcastOpenTransaction(parameters: {
+    client: Client;
+    serializedTransaction: Hex;
+    escrowContract: Address;
+    channelId: Hex;
+    recipient: Address;
+    currency: Address;
+    feePayer?: Account | undefined;
+}): Promise<BroadcastResult>;
+export declare function broadcastTopUpTransaction(parameters: {
+    client: Client;
+    serializedTransaction: Hex;
+    escrowContract: Address;
+    channelId: Hex;
+    declaredDeposit: bigint;
+    previousDeposit: bigint;
+    feePayer?: Account | undefined;
+}): Promise<{
+    txHash: Hex;
+    newDeposit: bigint;
+}>;
+//# sourceMappingURL=Chain.d.ts.map

package/dist/tempo/stream/Chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chain.d.ts","sourceRoot":"","sources":["../../../src/tempo/stream/Chain.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EAGX,KAAK,GAAG,EAER,KAAK,sBAAsB,EAE5B,MAAM,MAAM,CAAA;AAIb,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,CAAA;AAIpB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC,OAAO,SAAS,EAAE,YAAY,CAAC,CAAA;AAEnF;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,GAAG,GACb,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,GAAG,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAY9B;AAQD;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,GAAG,CAAC,CAUd;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,GAAG,CAAC,CAed;AAcD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,GAAG,GAAG,SAAS,CAAA;IACvB,OAAO,EAAE,cAAc,CAAA;CACxB,CAAA;AAED,wBAAsB,wBAAwB,CAAC,UAAU,EAAE;IACzD,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB,EAAE,GAAG,CAAA;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,GAAG,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B,GAAG,OAAO,CAAC,eAAe,CAAC,CA+F3B;AAED,wBAAsB,yBAAyB,CAAC,UAAU,EAAE;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,qBAAqB,EAAE,GAAG,CAAA;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,GAAG,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAwF/C"}

package/dist/tempo/stream/Chain.js

@@ -0,0 +1,215 @@
+import { decodeFunctionData, getAbiItem, isAddressEqual, toFunctionSelector, } from 'viem';
+import { readContract, sendRawTransactionSync, signTransaction, writeContract } from 'viem/actions';
+import { Transaction } from 'viem/tempo';
+import { BadRequestError, ChannelClosedError, VerificationFailedError } from '../../Errors.js';
+import { escrowAbi } from './escrow.abi.js';
+export { escrowAbi };
+const UINT128_MAX = 2n ** 128n - 1n;
+/**
+ * Read channel state from the escrow contract.
+ */
+export async function getOnChainChannel(client, escrowContract, channelId) {
+    return readContract(client, {
+        address: escrowContract,
+        abi: escrowAbi,
+        functionName: 'getChannel',
+        args: [channelId],
+    });
+}
+/**
+ * Verify a topUp by re-reading on-chain channel state.
+ */
+export async function verifyTopUpTransaction(client, escrowContract, channelId, previousDeposit) {
+    const channel = await getOnChainChannel(client, escrowContract, channelId);
+    if (channel.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is finalized on-chain' });
+    }
+    if (channel.deposit <= previousDeposit) {
+        throw new VerificationFailedError({ reason: 'channel deposit did not increase' });
+    }
+    return { deposit: channel.deposit };
+}
+function assertUint128(amount) {
+    if (amount < 0n || amount > UINT128_MAX) {
+        throw new VerificationFailedError({ reason: 'cumulativeAmount exceeds uint128 range' });
+    }
+}
+/**
+ * Submit a settle transaction on-chain.
+ */
+export async function settleOnChain(client, escrowContract, voucher) {
+    assertUint128(voucher.cumulativeAmount);
+    return writeContract(client, {
+        account: client.account,
+        chain: client.chain,
+        address: escrowContract,
+        abi: escrowAbi,
+        functionName: 'settle',
+        args: [voucher.channelId, voucher.cumulativeAmount, voucher.signature],
+    });
+}
+/**
+ * Submit a close transaction on-chain.
+ */
+export async function closeOnChain(client, escrowContract, voucher, account) {
+    assertUint128(voucher.cumulativeAmount);
+    const resolved = account ?? client.account;
+    if (!resolved)
+        throw new Error('Cannot close channel: no account available. Provide an `account` in the session config or a `getClient` that returns an account-bearing client.');
+    return writeContract(client, {
+        account: resolved,
+        chain: client.chain,
+        address: escrowContract,
+        abi: escrowAbi,
+        functionName: 'close',
+        args: [voucher.channelId, voucher.cumulativeAmount, voucher.signature],
+    });
+}
+const escrowOpenSelector = /*#__PURE__*/ toFunctionSelector(getAbiItem({ abi: escrowAbi, name: 'open' }));
+const escrowTopUpSelector = /*#__PURE__*/ toFunctionSelector(getAbiItem({ abi: escrowAbi, name: 'topUp' }));
+const erc20ApproveSelector = /*#__PURE__*/ toFunctionSelector('function approve(address spender, uint256 amount)');
+export async function broadcastOpenTransaction(parameters) {
+    const { client, serializedTransaction, escrowContract, channelId, recipient, currency, feePayer, } = parameters;
+    const transaction = Transaction.deserialize(serializedTransaction);
+    const calls = transaction.calls ?? [];
+    const openCall = calls.find((call) => {
+        if (!call.to || !isAddressEqual(call.to, escrowContract))
+            return false;
+        if (!call.data)
+            return false;
+        return call.data.slice(0, 10) === escrowOpenSelector;
+    });
+    if (!openCall)
+        throw new BadRequestError({
+            reason: 'transaction does not contain a valid escrow open call',
+        });
+    if (feePayer) {
+        for (const call of calls) {
+            if (!call.to || !call.data) {
+                throw new BadRequestError({
+                    reason: 'fee-sponsored transactions must not contain calls without target or data',
+                });
+            }
+            const selector = call.data.slice(0, 10);
+            const isEscrowOpen = isAddressEqual(call.to, escrowContract) && selector === escrowOpenSelector;
+            const isTokenApprove = isAddressEqual(call.to, currency) && selector === erc20ApproveSelector;
+            if (!isEscrowOpen && !isTokenApprove) {
+                throw new BadRequestError({
+                    reason: 'fee-sponsored open transaction contains an unauthorized call',
+                });
+            }
+        }
+    }
+    const { args: openArgs } = decodeFunctionData({ abi: escrowAbi, data: openCall.data });
+    const [payee, token] = openArgs;
+    if (!isAddressEqual(payee, recipient)) {
+        throw new VerificationFailedError({
+            reason: 'open transaction payee does not match server recipient',
+        });
+    }
+    if (!isAddressEqual(token, currency)) {
+        throw new VerificationFailedError({
+            reason: 'open transaction token does not match server currency',
+        });
+    }
+    const serializedTransaction_final = await (async () => {
+        if (feePayer) {
+            return signTransaction(client, {
+                ...transaction,
+                account: feePayer,
+                feePayer,
+            });
+        }
+        return serializedTransaction;
+    })();
+    let txHash;
+    try {
+        const receipt = await sendRawTransactionSync(client, {
+            serializedTransaction: serializedTransaction_final,
+        });
+        if (receipt.status !== 'success') {
+            throw new VerificationFailedError({
+                reason: `open transaction reverted: ${receipt.transactionHash}`,
+            });
+        }
+        txHash = receipt.transactionHash;
+    }
+    catch (error) {
+        const onChain = await getOnChainChannel(client, escrowContract, channelId);
+        if (onChain.deposit > 0n) {
+            return { txHash: undefined, onChain };
+        }
+        throw error;
+    }
+    const onChain = await getOnChainChannel(client, escrowContract, channelId);
+    return { txHash, onChain };
+}
+export async function broadcastTopUpTransaction(parameters) {
+    const { client, serializedTransaction, escrowContract, channelId, declaredDeposit, previousDeposit, feePayer, } = parameters;
+    const transaction = Transaction.deserialize(serializedTransaction);
+    const calls = transaction.calls ?? [];
+    const topUpCall = calls.find((call) => {
+        if (!call.to || !isAddressEqual(call.to, escrowContract))
+            return false;
+        if (!call.data)
+            return false;
+        return call.data.slice(0, 10) === escrowTopUpSelector;
+    });
+    if (!topUpCall)
+        throw new BadRequestError({
+            reason: 'transaction does not contain a valid escrow topUp call',
+        });
+    if (feePayer) {
+        for (const call of calls) {
+            if (!call.to || !call.data) {
+                throw new BadRequestError({
+                    reason: 'fee-sponsored transactions must not contain calls without target or data',
+                });
+            }
+            const selector = call.data.slice(0, 10);
+            const isEscrowTopUp = isAddressEqual(call.to, escrowContract) && selector === escrowTopUpSelector;
+            const isTokenApprove = selector === erc20ApproveSelector;
+            if (!isEscrowTopUp && !isTokenApprove) {
+                throw new BadRequestError({
+                    reason: 'fee-sponsored topUp transaction contains an unauthorized call',
+                });
+            }
+        }
+    }
+    const { args: topUpArgs } = decodeFunctionData({ abi: escrowAbi, data: topUpCall.data });
+    const [txChannelId, txAmount] = topUpArgs;
+    if (txChannelId.toLowerCase() !== channelId.toLowerCase()) {
+        throw new VerificationFailedError({
+            reason: 'topUp transaction channelId does not match payload channelId',
+        });
+    }
+    if (BigInt(txAmount) !== declaredDeposit) {
+        throw new VerificationFailedError({
+            reason: `topUp transaction amount (${txAmount}) does not match declared additionalDeposit (${declaredDeposit})`,
+        });
+    }
+    const serializedTransaction_final = await (async () => {
+        if (feePayer) {
+            return signTransaction(client, {
+                ...transaction,
+                account: feePayer,
+                feePayer,
+            });
+        }
+        return serializedTransaction;
+    })();
+    const receipt = await sendRawTransactionSync(client, {
+        serializedTransaction: serializedTransaction_final,
+    });
+    if (receipt.status !== 'success') {
+        throw new VerificationFailedError({
+            reason: `topUp transaction reverted: ${receipt.transactionHash}`,
+        });
+    }
+    const onChain = await getOnChainChannel(client, escrowContract, channelId);
+    if (onChain.deposit <= previousDeposit) {
+        throw new VerificationFailedError({ reason: 'channel deposit did not increase after topUp' });
+    }
+    return { txHash: receipt.transactionHash, newDeposit: onChain.deposit };
+}
+//# sourceMappingURL=Chain.js.map

package/dist/tempo/stream/Chain.js.map

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

package/dist/tempo/stream/Channel.d.ts

@@ -0,0 +1,26 @@
+import type * as Hex from 'ox/Hex';
+/**
+ * Computes a channel ID from its parameters.
+ *
+ * Mirrors the onchain `computeChannelId` function: `keccak256(abi.encode(payer, payee, token, salt, authorizedSigner, escrowContract, chainId))`.
+ */
+export declare function computeId(parameters: computeId.Parameters): Hex.Hex;
+export declare namespace computeId {
+    type Parameters = {
+        /** Address authorized to sign vouchers on behalf of the payer. */
+        authorizedSigner: Hex.Hex;
+        /** Chain ID of the network the escrow contract is deployed on. */
+        chainId: number;
+        /** Address of the escrow contract. */
+        escrowContract: Hex.Hex;
+        /** Address of the payee (recipient). */
+        payee: Hex.Hex;
+        /** Address of the payer (sender). */
+        payer: Hex.Hex;
+        /** Unique salt to differentiate channels with the same parameters. */
+        salt: Hex.Hex;
+        /** Address of the token used for payment. */
+        token: Hex.Hex;
+    };
+}
+//# sourceMappingURL=Channel.d.ts.map

package/dist/tempo/stream/Channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../../src/tempo/stream/Channel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,QAAQ,CAAA;AAElC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAsBnE;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,UAAU,GAAG;QAChB,kEAAkE;QAClE,gBAAgB,EAAE,GAAG,CAAC,GAAG,CAAA;QACzB,kEAAkE;QAClE,OAAO,EAAE,MAAM,CAAA;QACf,sCAAsC;QACtC,cAAc,EAAE,GAAG,CAAC,GAAG,CAAA;QACvB,wCAAwC;QACxC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAA;QACd,qCAAqC;QACrC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAA;QACd,sEAAsE;QACtE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAA;QACb,6CAA6C;QAC7C,KAAK,EAAE,GAAG,CAAC,GAAG,CAAA;KACf,CAAA;CACF"}

package/dist/tempo/stream/Channel.js

@@ -0,0 +1,27 @@
+import { AbiParameters, Hash } from 'ox';
+/**
+ * Computes a channel ID from its parameters.
+ *
+ * Mirrors the onchain `computeChannelId` function: `keccak256(abi.encode(payer, payee, token, salt, authorizedSigner, escrowContract, chainId))`.
+ */
+export function computeId(parameters) {
+    const encoded = AbiParameters.encode(AbiParameters.from([
+        'address payer',
+        'address payee',
+        'address token',
+        'bytes32 salt',
+        'address authorizedSigner',
+        'address escrowContract',
+        'uint256 chainId',
+    ]), [
+        parameters.payer,
+        parameters.payee,
+        parameters.token,
+        parameters.salt,
+        parameters.authorizedSigner,
+        parameters.escrowContract,
+        BigInt(parameters.chainId),
+    ]);
+    return Hash.keccak256(encoded);
+}
+//# sourceMappingURL=Channel.js.map

package/dist/tempo/stream/Channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../../src/tempo/stream/Channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAGxC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,UAAgC;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAClC,aAAa,CAAC,IAAI,CAAC;QACjB,eAAe;QACf,eAAe;QACf,eAAe;QACf,cAAc;QACd,0BAA0B;QAC1B,wBAAwB;QACxB,iBAAiB;KAClB,CAAC,EACF;QACE,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,IAAI;QACf,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,cAAc;QACzB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;KAC3B,CACF,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC"}

package/dist/tempo/stream/ChannelStore.d.ts

@@ -0,0 +1,103 @@
+import type { Address, Hex } from 'viem';
+import type * as Store from '../../Store.js';
+import type { SignedVoucher } from './Types.js';
+/**
+ * State for an on-chain payment channel, including per-session accounting.
+ *
+ * Tracks the channel's identity, on-chain balance, the highest voucher
+ * the server has accepted, and the current session's spend counters.
+ * A channel is created when a payer opens an escrow on-chain and persists
+ * until the channel is finalized (closed/settled).
+ *
+ * One channel = one session. The client owns the key and can't race with
+ * itself, so concurrent session support is unnecessary.
+ *
+ * Monotonicity invariants (enforced by update callbacks):
+ * - `highestVoucherAmount` only increases
+ * - `settledOnChain` only increases
+ * - `deposit` reflects the latest on-chain value
+ */
+export interface State {
+    /** Address authorized to sign vouchers on behalf of the payer. */
+    authorizedSigner: Address;
+    /** Chain ID the channel was opened on. */
+    chainId: number;
+    /** Escrow contract address the channel was opened on. */
+    escrowContract: Address;
+    /** Unique identifier for this payment channel. */
+    channelId: Hex;
+    /** ISO 8601 timestamp when the channel was created. */
+    createdAt: string;
+    /** Current on-chain deposit in the escrow contract. */
+    deposit: bigint;
+    /** Whether the channel has been finalized (closed) on-chain. */
+    finalized: boolean;
+    /** The signed voucher corresponding to `highestVoucherAmount`. */
+    highestVoucher: SignedVoucher | null;
+    /** Highest cumulative voucher amount accepted by the server. */
+    highestVoucherAmount: bigint;
+    /** Address of the payment recipient. */
+    payee: Address;
+    /** Address of the payment sender. */
+    payer: Address;
+    /** Cumulative amount settled on-chain so far. */
+    settledOnChain: bigint;
+    /** Cumulative amount spent (charged) against this channel's current session. */
+    spent: bigint;
+    /** Token contract address used for payments. */
+    token: Address;
+    /** Number of charge operations (API requests) fulfilled in the current session. */
+    units: number;
+}
+/**
+ * Internal store interface for channel state persistence.
+ *
+ * ## Atomicity contract
+ *
+ * The `updateChannel` method uses an atomic read-modify-write callback.
+ * The callback receives the current state (or `null` if none exists), and
+ * returns the next state (or `null` to delete). Implementations must
+ * guarantee that no concurrent mutation occurs between reading `current`
+ * and writing the return value.
+ *
+ * Backends implement this via their native mechanisms:
+ * - **In-memory / JS single-thread**: Synchronous callback execution
+ * - **Durable Objects**: Single-threaded execution model
+ * - **D1 / SQL**: Database transactions
+ */
+export type ChannelStore = {
+    getChannel(channelId: Hex): Promise<State | null>;
+    /**
+     * Atomic read-modify-write for channel state.
+     * Return `null` from `fn` to delete the channel.
+     */
+    updateChannel(channelId: Hex, fn: (current: State | null) => State | null): Promise<State | null>;
+    /**
+     * Wait for the next update to a channel.
+     *
+     * Returns a `Promise` that resolves once `updateChannel` is called for
+     * `channelId`. Implementations should resolve immediately if the channel
+     * was updated between the call to `waitForUpdate` and the `Promise`
+     * being awaited.
+     *
+     * When not implemented, callers fall back to polling.
+     */
+    waitForUpdate?(channelId: Hex): Promise<void>;
+};
+export type DeductResult = {
+    ok: true;
+    channel: State;
+} | {
+    ok: false;
+    channel: State;
+};
+/**
+ * Atomically deduct `amount` from a channel's available balance.
+ *
+ * Returns `{ ok: true, channel }` if the deduction succeeded, or
+ * `{ ok: false, channel }` with the unchanged state if balance is
+ * insufficient. Throws if the channel does not exist.
+ */
+export declare function deductFromChannel(store: ChannelStore, channelId: Hex, amount: bigint): Promise<DeductResult>;
+export declare function fromStore(store: Store.Store): ChannelStore;
+//# sourceMappingURL=ChannelStore.d.ts.map

package/dist/tempo/stream/ChannelStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelStore.d.ts","sourceRoot":"","sources":["../../../src/tempo/stream/ChannelStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AACxC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,KAAK;IACpB,kEAAkE;IAClE,gBAAgB,EAAE,OAAO,CAAA;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAA;IACvB,kDAAkD;IAClD,SAAS,EAAE,GAAG,CAAA;IACd,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAA;IAClB,kEAAkE;IAClE,cAAc,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAA;IACd,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAA;IACd,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAA;IACtB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAA;IACd,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAEjD;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAEjG;;;;;;;;;OASG;IACH,aAAa,CAAC,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAA;AAEvF;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CAavB;AAqBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,YAAY,CA+D1D"}