mppx 0.12.0 → 0.13.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mppx",
   "type": "module",
-  "version": "0.12.0",
+  "version": "0.13.2",
   "main": "./dist/index.js",
   "license": "MIT",
   "homepage": "https://github.com/wevm/mppx#readme",
@@ -163,7 +163,7 @@
     "@x402/hono": ">=2.22.0",
     "@x402/mcp": ">=2.22.0",
     "@x402/next": ">=2.22.0",
-    "elysia": ">=1",
+    "elysia": ">=1.2.0",
     "express": ">=5",
     "hono": ">=4.12.25",
     "next": ">=16.2.6",
@@ -202,11 +202,11 @@
     }
   },
   "dependencies": {
-    "@stripe/stripe-js": "9.13.0",
-    "eventsource-parser": "3.1.1",
+    "@stripe/stripe-js": "9.17.0",
+    "eventsource-parser": "4.1.1",
     "ox": "0.14.45",
-    "structured-headers": "2.0.3",
-    "zod": "^4.4.3"
+    "structured-headers": "2.1.0",
+    "zod": "^4.6.5"
   },
   "repository": {
     "type": "git",

package/dist/tempo/legacy/client/ChannelOps.d.ts

@@ -1,69 +0,0 @@
-/**
- * Shared client-side channel operations.
- *
- * Provides the low-level helpers that both `session()`
- * and `sessionManager()` (orchestrator) rely on: escrow resolution, channel
- * ID computation, on-chain open/voucher/close payload construction, channel
- * recovery from on-chain state, and credential serialization.
- */
-import { Hex } from 'ox';
-import { type Address, type Account as viem_Account, type Client as viem_Client } from 'viem';
-import type { Challenge } from '../../../Challenge.js';
-import type { LegacySessionCredentialPayload } from '../session/Types.js';
-/** Cached channel metadata used by the legacy auto-driving session client. */
-export type ChannelEntry = {
-    /** Voucher authority the channel was opened with. */
-    authorizedSigner: Address;
-    /** Legacy contract-backed channel ID. */
-    channelId: Hex.Hex;
-    /** Salt used to derive the channel ID. */
-    salt: Hex.Hex;
-    /** Highest cumulative voucher amount locally authorized. */
-    cumulativeAmount: bigint;
-    /** Escrow contract backing this channel. */
-    escrowContract: Address;
-    /** Chain ID used for channel ID and voucher domain separation. */
-    chainId: number;
-    /** Whether the client considers the channel reusable. */
-    opened: boolean;
-};
-/** Resolves the chain ID embedded in a legacy session challenge. */
-export declare function resolveChainId(challenge: Challenge): number;
-/** Resolves the server-advertised escrow against the client's trust policy. */
-export declare function resolveEscrow(challenge: {
-    request: {
-        methodDetails?: unknown;
-    };
-}, chainId: number, escrowContractOverride?: Address, allowCustomEscrow?: boolean): Address;
-/** Serializes a legacy session credential with a payer DID source. */
-export declare function serializeCredential(challenge: Challenge, payload: LegacySessionCredentialPayload, chainId: number, account: viem_Account): string;
-/** Creates a legacy cumulative voucher credential payload. */
-export declare function createVoucherPayload(client: viem_Client, account: viem_Account, channelId: Hex.Hex, cumulativeAmount: bigint, escrowContract: Address, chainId: number, voucherSigner?: viem_Account | undefined): Promise<LegacySessionCredentialPayload>;
-/** Creates a legacy cooperative close credential payload. */
-export declare function createClosePayload(client: viem_Client, account: viem_Account, channelId: Hex.Hex, cumulativeAmount: bigint, escrowContract: Address, chainId: number, voucherSigner?: viem_Account | undefined): Promise<LegacySessionCredentialPayload>;
-/** Creates a legacy open transaction credential payload and local channel entry. */
-export declare function createOpenPayload(client: viem_Client, account: viem_Account, options: {
-    voucherSigner?: viem_Account | undefined;
-    escrowContract: Address;
-    payee: Address;
-    currency: Address;
-    deposit: bigint;
-    initialAmount: bigint;
-    chainId: number;
-    feePayer?: boolean | undefined;
-}): Promise<{
-    entry: ChannelEntry;
-    payload: LegacySessionCredentialPayload;
-}>;
-/**
- * Attempt to recover an existing on-chain channel by reading its state.
- *
- * If the channel has a positive deposit and is not finalized, returns a
- * {@link ChannelEntry} with `cumulativeAmount` set to the on-chain settled
- * amount (the safe starting point for new vouchers).
- *
- * Returns `undefined` if the channel doesn't exist, has zero deposit,
- * or is already finalized.
- */
-export declare function tryRecoverChannel(client: viem_Client, escrowContract: Address, channelId: Hex.Hex, chainId: number): Promise<ChannelEntry | undefined>;
-//# sourceMappingURL=ChannelOps.d.ts.map

package/dist/tempo/legacy/client/ChannelOps.js

@@ -1,168 +0,0 @@
-/**
- * Shared client-side channel operations.
- *
- * Provides the low-level helpers that both `session()`
- * and `sessionManager()` (orchestrator) rely on: escrow resolution, channel
- * ID computation, on-chain open/voucher/close payload construction, channel
- * recovery from on-chain state, and credential serialization.
- */
-import { Hex } from 'ox';
-import { encodeFunctionData, } from 'viem';
-import { prepareTransactionRequest, signTransaction } from 'viem/actions';
-import { Abis } from 'viem/tempo';
-import * as Credential from '../../../Credential.js';
-import { getAccountSignerAddress } from '../../internal/account.js';
-import * as defaults from '../../internal/defaults.js';
-import { escrowAbi, getOnChainChannel } from '../session/Chain.js';
-import * as Channel from '../session/Channel.js';
-import { signVoucher } from '../session/Voucher.js';
-function resolveVoucherSigner(account, voucherSigner) {
-    return voucherSigner ?? account;
-}
-/** Resolves the chain ID embedded in a legacy session challenge. */
-export function resolveChainId(challenge) {
-    const md = challenge.request.methodDetails;
-    return md?.chainId ?? 0;
-}
-/** Resolves the server-advertised escrow against the client's trust policy. */
-export function resolveEscrow(challenge, chainId, escrowContractOverride, allowCustomEscrow = false) {
-    const challengeEscrow = challenge.request.methodDetails
-        ?.escrowContract;
-    const escrow = escrowContractOverride ??
-        defaults.escrowContract[chainId];
-    if (!escrow && !(allowCustomEscrow && challengeEscrow))
-        throw new Error('No trusted `escrowContract` available. Provide it in client parameters or use a supported chain.');
-    if (challengeEscrow &&
-        escrow &&
-        challengeEscrow.toLowerCase() !== escrow.toLowerCase() &&
-        (!allowCustomEscrow || escrowContractOverride !== undefined))
-        throw new Error(`Tempo session escrow ${challengeEscrow} does not match client escrow ${escrow}.`);
-    if (challengeEscrow && (!escrow || challengeEscrow.toLowerCase() !== escrow.toLowerCase()))
-        return challengeEscrow;
-    return escrow;
-}
-/** Serializes a legacy session credential with a payer DID source. */
-export function serializeCredential(challenge, payload, chainId, account) {
-    return Credential.serialize({
-        challenge,
-        payload,
-        source: `did:pkh:eip155:${chainId}:${account.address}`,
-    });
-}
-/** Creates a legacy cumulative voucher credential payload. */
-export async function createVoucherPayload(client, account, channelId, cumulativeAmount, escrowContract, chainId, voucherSigner) {
-    const signer = resolveVoucherSigner(account, voucherSigner);
-    const signature = await signVoucher(client, account, { channelId, cumulativeAmount }, escrowContract, chainId, signer);
-    return {
-        action: 'voucher',
-        channelId,
-        cumulativeAmount: cumulativeAmount.toString(),
-        signature,
-    };
-}
-/** Creates a legacy cooperative close credential payload. */
-export async function createClosePayload(client, account, channelId, cumulativeAmount, escrowContract, chainId, voucherSigner) {
-    const signer = resolveVoucherSigner(account, voucherSigner);
-    const signature = await signVoucher(client, account, { channelId, cumulativeAmount }, escrowContract, chainId, signer);
-    return {
-        action: 'close',
-        channelId,
-        cumulativeAmount: cumulativeAmount.toString(),
-        signature,
-    };
-}
-/** Creates a legacy open transaction credential payload and local channel entry. */
-export async function createOpenPayload(client, account, options) {
-    const { escrowContract, payee, currency, deposit, initialAmount, chainId, feePayer } = options;
-    const voucherSigner = resolveVoucherSigner(account, options.voucherSigner);
-    const authorizedSigner = getAccountSignerAddress(voucherSigner);
-    const salt = Hex.random(32);
-    const channelId = Channel.computeId({
-        authorizedSigner,
-        chainId,
-        escrowContract,
-        payee,
-        payer: account.address,
-        salt,
-        token: currency,
-    });
-    const approveData = encodeFunctionData({
-        abi: Abis.tip20,
-        functionName: 'approve',
-        args: [escrowContract, deposit],
-    });
-    const openData = encodeFunctionData({
-        abi: escrowAbi,
-        functionName: 'open',
-        args: [payee, currency, deposit, salt, authorizedSigner],
-    });
-    const validBefore = Math.floor(Date.now() / 1_000) + 25;
-    const prepared = await prepareTransactionRequest(client, {
-        account,
-        calls: [
-            { to: currency, data: approveData },
-            { to: escrowContract, data: openData },
-        ],
-        feeToken: currency,
-        nonceKey: 'expiring',
-        validBefore,
-    });
-    // Estimate before enabling fee-payer mode so Tempo includes sender
-    // signature and access-key verification costs in the gas budget.
-    prepared.gas = (prepared.gas ?? 0n) + 5000n;
-    if (feePayer)
-        prepared.feePayer = true;
-    const transaction = (await signTransaction(client, prepared));
-    const signature = await signVoucher(client, account, { channelId, cumulativeAmount: initialAmount }, escrowContract, chainId, voucherSigner);
-    return {
-        entry: {
-            authorizedSigner,
-            channelId,
-            salt,
-            cumulativeAmount: initialAmount,
-            escrowContract,
-            chainId,
-            opened: true,
-        },
-        payload: {
-            action: 'open',
-            type: 'transaction',
-            channelId,
-            transaction,
-            authorizedSigner,
-            cumulativeAmount: initialAmount.toString(),
-            signature,
-        },
-    };
-}
-/**
- * Attempt to recover an existing on-chain channel by reading its state.
- *
- * If the channel has a positive deposit and is not finalized, returns a
- * {@link ChannelEntry} with `cumulativeAmount` set to the on-chain settled
- * amount (the safe starting point for new vouchers).
- *
- * Returns `undefined` if the channel doesn't exist, has zero deposit,
- * or is already finalized.
- */
-export async function tryRecoverChannel(client, escrowContract, channelId, chainId) {
-    try {
-        const onChain = await getOnChainChannel(client, escrowContract, channelId);
-        if (onChain.deposit > 0n && !onChain.finalized) {
-            return {
-                // A zero on-chain authorizedSigner means the escrow verifies vouchers
-                // against the payer, so record the payer as the voucher authority.
-                authorizedSigner: BigInt(onChain.authorizedSigner) === 0n ? onChain.payer : onChain.authorizedSigner,
-                channelId,
-                salt: '0x',
-                cumulativeAmount: onChain.settled,
-                escrowContract,
-                chainId,
-                opened: true,
-            };
-        }
-    }
-    catch { }
-    return undefined;
-}
-//# sourceMappingURL=ChannelOps.js.map

package/dist/tempo/legacy/client/Session.d.ts

@@ -1,185 +0,0 @@
-import { type Address, type Account as viem_Account } from 'viem';
-import * as Method from '../../../Method.js';
-import * as Account from '../../../viem/Account.js';
-import * as Client from '../../../viem/Client.js';
-import * as z from '../../../zod.js';
-import { type ChannelEntry } from './ChannelOps.js';
-/** Runtime schema for legacy low-level session credential context. */
-export declare const sessionContextSchema: z.ZodMiniObject<{
-    account: z.ZodMiniOptional<z.ZodMiniCustom<`0x${string}` | Account.Account | undefined, `0x${string}` | Account.Account | undefined>>;
-    action: z.ZodMiniOptional<z.ZodMiniEnum<{
-        close: "close";
-        open: "open";
-        topUp: "topUp";
-        voucher: "voucher";
-    }>>;
-    channelId: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    cumulativeAmount: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    cumulativeAmountRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    transaction: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    additionalDeposit: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    additionalDepositRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    depositRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-}, z.core.$strip>;
-/** Context accepted by the legacy low-level session client method. */
-export type SessionContext = z.infer<typeof sessionContextSchema>;
-/**
- * Creates a session payment method for use with `Mppx.create()`.
- *
- * Supports both auto mode (set `deposit` to manage channels automatically)
- * and manual mode (pass `context.action` to control each step).
- *
- * @example
- * ```ts
- * // Auto mode
- * import { Mppx, tempo } from 'mppx/client'
- *
- * const mppx = Mppx.create({
- *   methods: [tempo({
- *     account: privateKeyToAccount('0x...'),
- *     deposit: '10',
- *   })],
- * })
- *
- * const res = await mppx.fetch('/api/chat?prompt=hello')
- * ```
- *
- * @example
- * ```ts
- * // Manual mode
- * const mppx = Mppx.create({
- *   methods: [tempo({ account })],
- * })
- *
- * const credential = await mppx.createCredential(response, {
- *   action: 'voucher',
- *   channelId: '0x...',
- *   cumulativeAmount: '1',
- * })
- * ```
- */
-export declare function session(parameters?: session.Parameters): Method.Client<{
-    readonly name: "tempo";
-    readonly intent: "session";
-    readonly schema: {
-        credential: {
-            payload: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
-                action: z.ZodMiniLiteral<"open">;
-                authorizedSigner: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                channelId: z.ZodMiniString<string>;
-                cumulativeAmount: z.ZodMiniString<string>;
-                descriptor: z.ZodMiniOptional<z.ZodMiniCustom<import("../../session/precompile/Protocol.js").ChannelDescriptor, import("../../session/precompile/Protocol.js").ChannelDescriptor>>;
-                signature: z.ZodMiniString<string>;
-                transaction: z.ZodMiniString<string>;
-                type: z.ZodMiniLiteral<"transaction">;
-            }, z.core.$strip>, z.ZodMiniObject<{
-                action: z.ZodMiniLiteral<"topUp">;
-                additionalDeposit: z.ZodMiniString<string>;
-                channelId: z.ZodMiniString<string>;
-                descriptor: z.ZodMiniOptional<z.ZodMiniCustom<import("../../session/precompile/Protocol.js").ChannelDescriptor, import("../../session/precompile/Protocol.js").ChannelDescriptor>>;
-                transaction: z.ZodMiniString<string>;
-                type: z.ZodMiniLiteral<"transaction">;
-            }, z.core.$strip>, z.ZodMiniObject<{
-                action: z.ZodMiniLiteral<"voucher">;
-                channelId: z.ZodMiniString<string>;
-                cumulativeAmount: z.ZodMiniString<string>;
-                descriptor: z.ZodMiniOptional<z.ZodMiniCustom<import("../../session/precompile/Protocol.js").ChannelDescriptor, import("../../session/precompile/Protocol.js").ChannelDescriptor>>;
-                signature: z.ZodMiniString<string>;
-            }, z.core.$strip>, z.ZodMiniObject<{
-                action: z.ZodMiniLiteral<"close">;
-                channelId: z.ZodMiniString<string>;
-                cumulativeAmount: z.ZodMiniString<string>;
-                descriptor: z.ZodMiniOptional<z.ZodMiniCustom<import("../../session/precompile/Protocol.js").ChannelDescriptor, import("../../session/precompile/Protocol.js").ChannelDescriptor>>;
-                signature: z.ZodMiniString<string>;
-            }, z.core.$strip>], "action">;
-        };
-        request: z.ZodMiniPipe<z.ZodMiniObject<{
-            amount: z.ZodMiniString<string>;
-            chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-            channelId: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            currency: z.ZodMiniString<string>;
-            decimals: z.ZodMiniNumber<number>;
-            escrowContract: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniCustom<viem_Account, viem_Account>]>, z.ZodMiniTransform<boolean, boolean | viem_Account>>>;
-            feeToken: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            minVoucherDelta: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            operator: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            recipient: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            sessionProtocol: z.ZodMiniOptional<z.ZodMiniEnum<{
-                v1: "v1";
-                v2: "v2";
-            }>>;
-            sessionSnapshot: z.ZodMiniOptional<z.ZodMiniCustom<import("../../session/Snapshot.js").SessionSnapshot, import("../../session/Snapshot.js").SessionSnapshot>>;
-            suggestedDeposit: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            unitType: z.ZodMiniString<string>;
-        }, z.core.$strip>, z.ZodMiniTransform<{
-            currency: string;
-            recipient?: string | undefined;
-            unitType: string;
-            amount: string;
-            suggestedDeposit?: string | undefined;
-            methodDetails: {
-                escrowContract: string | undefined;
-                channelId?: string | undefined;
-                minVoucherDelta?: string | undefined;
-                chainId?: number | undefined;
-                feePayer?: boolean | undefined;
-                feeToken?: string | undefined;
-                operator?: string | undefined;
-                sessionProtocol?: "v1" | "v2" | undefined;
-                sessionSnapshot?: import("../../session/Snapshot.js").SessionSnapshot | undefined;
-            };
-        }, {
-            amount: string;
-            chainId?: number | undefined;
-            channelId?: string | undefined;
-            currency: string;
-            decimals: number;
-            escrowContract?: string | undefined;
-            feePayer?: boolean | undefined;
-            feeToken?: string | undefined;
-            minVoucherDelta?: string | undefined;
-            operator?: string | undefined;
-            recipient?: string | undefined;
-            sessionProtocol?: "v1" | "v2" | undefined;
-            sessionSnapshot?: import("../../session/Snapshot.js").SessionSnapshot | undefined;
-            suggestedDeposit?: string | undefined;
-            unitType: string;
-        }>>;
-    };
-}, z.ZodMiniObject<{
-    account: z.ZodMiniOptional<z.ZodMiniCustom<`0x${string}` | Account.Account | undefined, `0x${string}` | Account.Account | undefined>>;
-    action: z.ZodMiniOptional<z.ZodMiniEnum<{
-        close: "close";
-        open: "open";
-        topUp: "topUp";
-        voucher: "voucher";
-    }>>;
-    channelId: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    cumulativeAmount: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    cumulativeAmountRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    transaction: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    additionalDeposit: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    additionalDepositRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    depositRaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
-}, z.core.$strip>>;
-/** Type helpers for the legacy low-level session client method. */
-export declare namespace session {
-    type Parameters = Account.getResolver.Parameters & Client.getResolver.Parameters & {
-        /** Accept a noncanonical escrow contract advertised by the server. @default false */
-        allowCustomEscrow?: boolean | undefined;
-        /** Account that signs voucher digests. Defaults to `account`; access-key accounts sign raw vouchers as their access-key address. */
-        voucherSigner?: viem_Account | undefined;
-        /** Token decimals for parsing human-readable amounts (default: 6). */
-        decimals?: number | undefined;
-        /** Initial deposit amount in human-readable units (e.g. "10" for 10 tokens). When set, the method handles the full channel lifecycle (open, voucher, cumulative tracking) automatically. */
-        deposit?: string | undefined;
-        /** Exact escrow contract address pin. Takes precedence over `allowCustomEscrow`. */
-        escrowContract?: Address | undefined;
-        /** Maximum deposit in human-readable units (e.g. "10"). Caps the server's `suggestedDeposit`. Enables auto-management like `deposit`. */
-        maxDeposit?: string | undefined;
-        /** Called whenever channel state changes (open, voucher, close, recovery). */
-        onChannelUpdate?: ((entry: ChannelEntry) => void) | undefined;
-    };
-}
-//# sourceMappingURL=Session.d.ts.map