mppx 0.6.31 → 0.8.0

package/dist/tempo/session/client/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../../src/tempo/session/client/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,MAAM,CAAA;AAI/C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAA;AACnD,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAA;AACjD,OAAO,KAAK,EACV,cAAc,IAAI,eAAe,EACjC,kBAAkB,IAAI,mBAAmB,EAC1C,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AASzE,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEhF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,UAAU,GAAE,OAAO,CAAC,UAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAoE1D;AAED,qEAAqE;AACrE,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,cAAc,GAAG,eAAe,CAAA;IACrC,KAAK,kBAAkB,GAAG,mBAAmB,CAAA;IAE7C,KAAK,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,GAC9C,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;QAC9B,mFAAmF;QACnF,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;QACvC,sEAAsE;QACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,2CAA2C;QAC3C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC5B,0GAA0G;QAC1G,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,6CAA6C;QAC7C,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;QAC7D,2FAA2F;QAC3F,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;KAC5C,CAAA;CACJ"}

package/dist/tempo/session/client/Session.js

@@ -0,0 +1,69 @@
+import { parseUnits } from 'viem';
+import { tempo as tempo_chain } from 'viem/chains';
+import * as Constants from '../../../Constants.js';
+import * as Method from '../../../Method.js';
+import * as Account from '../../../viem/Account.js';
+import * as Client from '../../../viem/Client.js';
+import * as defaults from '../../internal/defaults.js';
+import * as Methods from '../../Methods.js';
+import { serializeCredential } from './ChannelOps.js';
+import { createChannelStore } from './ChannelStore.js';
+import { executeCredentialPlan, planCredential, resolveChallengeContext, resolveRecoverContext, sessionContextSchema, } from './CredentialState.js';
+export { sessionContextSchema } from './CredentialState.js';
+/**
+ * Creates the low-level TIP-1034 session payment method for use with `Mppx.create()`.
+ *
+ * Supports auto mode (server hints drive open/top-up sizing, with optional
+ * `maxDeposit` as a local cap) and manual mode (`context.action` with a
+ * channel descriptor).
+ */
+export function session(parameters = {}) {
+    const { account, channelStore, decimals = defaults.decimals, escrow: escrowOverride, getClient: getClientParameter, maxDeposit: maxDepositParameter, onChannelUpdate, resolveAccount, } = parameters;
+    const getClient = Client.getResolver({
+        chain: tempo_chain,
+        getClient: getClientParameter,
+        rpcUrl: defaults.rpcUrl,
+    });
+    const getAccount = Account.getResolver({ account });
+    const maxDeposit = maxDepositParameter !== undefined ? parseUnits(maxDepositParameter, decimals) : undefined;
+    const store = channelStore ?? createChannelStore();
+    const sink = { store, notifyUpdate: (entry) => onChannelUpdate?.(entry) };
+    return Method.toClient(Methods.session, {
+        canHandleChallenge({ challenge }) {
+            return (Constants.getMethodDetail(challenge.request.methodDetails, Constants.MethodDetailKeys.sessionProtocol) === Constants.SessionProtocols.v2);
+        },
+        context: sessionContextSchema,
+        async createCredential({ challenge, context }) {
+            const resolved = await resolveChallengeContext({
+                challenge,
+                escrowOverride,
+                getClient,
+            });
+            const defaultAccount = getAccount(resolved.client, context);
+            const entry = await store.get(resolved.key);
+            // Resolve recovery hints early so account selection can satisfy an existing channel authority.
+            const recoverContext = resolveRecoverContext({ context, snapshot: resolved.snapshot });
+            const descriptor = context?.action
+                ? context.descriptor
+                : (entry?.descriptor ?? recoverContext?.descriptor);
+            const account = (await resolveAccount?.({
+                account: defaultAccount,
+                chainId: resolved.chainId,
+                operation: {
+                    kind: 'authorizePaymentChannel',
+                    ...(descriptor ? { authority: descriptor.authorizedSigner } : {}),
+                },
+            })) ?? defaultAccount;
+            const payload = await executeCredentialPlan(planCredential({
+                account,
+                entry,
+                context,
+                decimals,
+                maxDeposit,
+                resolved,
+            }), sink);
+            return serializeCredential(challenge, payload, resolved.chainId, account);
+        },
+    });
+}
+//# sourceMappingURL=Session.js.map

package/dist/tempo/session/client/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../../../src/tempo/session/client/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAA;AACnD,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAA;AAKjD,OAAO,KAAK,QAAQ,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAqB,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAA;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,aAAiC,EAAE;IACzD,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAC5B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,mBAAmB,EAC/B,eAAe,EACf,cAAc,GACf,GAAG,UAAU,CAAA;IACd,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC;QACnC,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC,CAAA;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IACnD,MAAM,UAAU,GACd,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3F,MAAM,KAAK,GAAG,YAAY,IAAI,kBAAkB,EAAE,CAAA;IAClD,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,KAAmB,EAAE,EAAE,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,CAAA;IAEvF,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;QACtC,kBAAkB,CAAC,EAAE,SAAS,EAAE;YAC9B,OAAO,CACL,SAAS,CAAC,eAAe,CACvB,SAAS,CAAC,OAAO,CAAC,aAAa,EAC/B,SAAS,CAAC,gBAAgB,CAAC,eAAe,CAC3C,KAAK,SAAS,CAAC,gBAAgB,CAAC,EAAE,CACpC,CAAA;QACH,CAAC;QACD,OAAO,EAAE,oBAAoB;QAC7B,KAAK,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;YAC3C,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC;gBAC7C,SAAS;gBACT,cAAc;gBACd,SAAS;aACV,CAAC,CAAA;YACF,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC3D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YAC3C,+FAA+F;YAC/F,MAAM,cAAc,GAAG,qBAAqB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;YACtF,MAAM,UAAU,GAAG,OAAO,EAAE,MAAM;gBAChC,CAAC,CAAC,OAAO,CAAC,UAAU;gBACpB,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,UAAU,CAAC,CAAA;YACrD,MAAM,OAAO,GACX,CAAC,MAAM,cAAc,EAAE,CAAC;gBACtB,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE;oBACT,IAAI,EAAE,yBAAyB;oBAC/B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClE;aACF,CAAC,CAAC,IAAI,cAAc,CAAA;YACvB,MAAM,OAAO,GAAG,MAAM,qBAAqB,CACzC,cAAc,CAAC;gBACb,OAAO;gBACP,KAAK;gBACL,OAAO;gBACP,QAAQ;gBACR,UAAU;gBACV,QAAQ;aACT,CAAC,EACF,IAAI,CACL,CAAA;YACD,OAAO,mBAAmB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3E,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/tempo/session/client/SessionManager.d.ts

@@ -0,0 +1,84 @@
+import type { Hex } from 'ox';
+import { type Address } from 'viem';
+import type * as Account from '../../../viem/Account.js';
+import type * as Client from '../../../viem/Client.js';
+import { type ChannelStore } from '../client/ChannelStore.js';
+import { type SessionReceipt } from '../precompile/Protocol.js';
+import { deserializeSnapshot as deserializeSessionSnapshot, serializeSnapshot as serializeSessionSnapshot } from '../Snapshot.js';
+import type { SessionState } from './Runtime.js';
+import { type TempoSessionChallenge } from './Transports.js';
+import { type SessionManagedWebSocket, type WebSocketConstructor } from './Transports.js';
+import { type SseDriverOptions } from './Transports.js';
+import { type WebSocketDriverOptions } from './Transports.js';
+export { computeFallbackCloseAmount, type FallbackCloseAmountParameters } from './Runtime.js';
+/** Auto-driving client manager for HTTP, SSE, and WebSocket TIP-1034 sessions. */
+export type SessionManager = {
+    /** Active channel ID, when a channel has been opened or recovered. */
+    readonly channelId: Hex.Hex | undefined;
+    /** Local cumulative voucher authorization in raw token units. */
+    readonly cumulative: bigint;
+    /** Whether the manager currently has an open local channel. */
+    readonly opened: boolean;
+    /** Current pure session state-machine state. */
+    readonly state: SessionState;
+    /** Runs the HTTP 402 probe, signs/open/top-ups as needed, retries, and returns receipt metadata. */
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<PaymentResponse>;
+    /** Opens a paid SSE stream and auto-posts vouchers/top-ups when the server requests more headroom. */
+    sse(input: RequestInfo | URL, init?: SessionManagerSseOptions): Promise<AsyncIterable<string>>;
+    /** Opens a paid WebSocket session after an HTTP challenge probe and manages in-band voucher frames. */
+    ws(input: string | URL, init?: SessionManagerWebSocketOptions): Promise<SessionManagedWebSocket>;
+    /** Tops up the active channel deposit. String amounts are parsed with the manager decimals; bigint amounts are raw units. */
+    topUp(amount: string | bigint): Promise<SessionReceipt | undefined>;
+    /** Cooperatively closes the active channel using the latest locally authorized spend boundary. */
+    close(): Promise<SessionReceipt | undefined>;
+};
+/** Options for `SessionManager.sse()`. */
+export type SessionManagerSseOptions = SseDriverOptions;
+/** Options for `SessionManager.ws()`. */
+export type SessionManagerWebSocketOptions = WebSocketDriverOptions;
+/** HTTP response enriched with the latest session payment metadata. */
+export type PaymentResponse = Response & {
+    /** Parsed payment receipt, when the response included one. */
+    receipt: SessionReceipt | null;
+    /** Last session challenge observed by the manager. */
+    challenge: TempoSessionChallenge | null;
+    /** Active channel ID, when available. */
+    channelId: Hex.Hex | null;
+    /** Local cumulative voucher authorization in raw token units. */
+    cumulative: bigint;
+};
+/**
+ * Creates a session manager that handles the full client payment lifecycle:
+ * channel open, incremental vouchers, SSE streaming, and channel close.
+ *
+ * Internally delegates to the `session()` method for all
+ * channel state management and credential creation, and to `Fetch.from`
+ * for the 402 challenge/retry flow.
+ *
+ * `channelStore` can persist reusable channels between manager instances.
+ */
+export declare function sessionManager(parameters: sessionManager.Parameters): SessionManager;
+/** Type helpers for `sessionManager()`. */
+export declare namespace sessionManager {
+    const serializeSnapshot: typeof serializeSessionSnapshot;
+    const deserializeSnapshot: typeof deserializeSessionSnapshot;
+    type Parameters = Account.getResolver.Parameters & Client.getResolver.Parameters & {
+        /** Enables same-route HEAD bootstrap from a server session snapshot before opening a new channel. */
+        bootstrap?: boolean | undefined;
+        /** Viem client instance. Shorthand for `getClient: () => client`. */
+        client?: import('viem').Client | undefined;
+        /** Token decimals used to convert `maxDeposit` to raw units. Defaults to `6`. */
+        decimals?: number | undefined;
+        /** TIP20EscrowChannel precompile address override. */
+        escrow?: Address | undefined;
+        /** Fetch implementation used for HTTP probes, management posts, and paid retries. */
+        fetch?: typeof globalThis.fetch | undefined;
+        /** Maximum deposit in human-readable units (e.g. `'10'` for 10 tokens). Converted to raw units via `decimals`. */
+        maxDeposit?: string | undefined;
+        /** Store for reusable session channels. Defaults to in-memory. */
+        channelStore?: ChannelStore | undefined;
+        /** Optional websocket constructor for runtimes without a global WebSocket. */
+        webSocket?: WebSocketConstructor | undefined;
+    };
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/tempo/session/client/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../../src/tempo/session/client/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,IAAI,CAAA;AAC7B,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAK/C,OAAO,KAAK,KAAK,OAAO,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,KAAK,MAAM,MAAM,yBAAyB,CAAA;AAGtD,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAI3F,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC3F,OAAO,EACL,mBAAmB,IAAI,0BAA0B,EACjD,iBAAiB,IAAI,wBAAwB,EAC9C,MAAM,gBAAgB,CAAA;AAIvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAYhD,OAAO,EAML,KAAK,qBAAqB,EAE3B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAE1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,0BAA0B,EAAE,KAAK,6BAA6B,EAAE,MAAM,cAAc,CAAA;AAE7F,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;IACvC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAE5B,oGAAoG;IACpG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7E,sGAAsG;IACtG,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9F,uGAAuG;IACvG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAChG,6HAA6H;IAC7H,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;IACnE,kGAAkG;IAClG,KAAK,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;CAC7C,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAA;AAEvD,yCAAyC;AACzC,MAAM,MAAM,8BAA8B,GAAG,sBAAsB,CAAA;AAEnE,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG;IACvC,8DAA8D;IAC9D,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B,sDAAsD;IACtD,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACvC,yCAAyC;IACzC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAA;IACzB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAoFD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,GAAG,cAAc,CAqhBpF;AAED,2CAA2C;AAC3C,yBAAiB,cAAc,CAAC;IACvB,MAAM,iBAAiB,iCAA2B,CAAA;IAClD,MAAM,mBAAmB,mCAA6B,CAAA;IAE7D,KAAY,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,GACrD,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;QAC9B,qGAAqG;QACrG,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC/B,qEAAqE;QACrE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1C,iFAAiF;QACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,sDAAsD;QACtD,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC5B,qFAAqF;QACrF,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;QAC3C,kHAAkH;QAClH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,kEAAkE;QAClE,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;QACvC,8EAA8E;QAC9E,SAAS,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;KAC7C,CAAA;CACJ"}