mppx 0.0.1 → 0.1.0

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

@@ -0,0 +1,62 @@
+import type { Hex } from 'ox';
+import type { Address } from 'viem';
+import type * as Challenge from '../../Challenge.js';
+import type * as Account from '../../viem/Account.js';
+import type * as Client from '../../viem/Client.js';
+import type { StreamReceipt } from '../stream/Types.js';
+export type SessionManager = {
+    readonly channelId: Hex.Hex | undefined;
+    readonly cumulative: bigint;
+    readonly opened: boolean;
+    open(options?: {
+        deposit?: bigint;
+    }): Promise<void>;
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<PaymentResponse>;
+    sse(input: RequestInfo | URL, init?: RequestInit & {
+        onReceipt?: ((receipt: StreamReceipt) => void) | undefined;
+        signal?: AbortSignal | undefined;
+    }): Promise<AsyncIterable<string>>;
+    close(): Promise<StreamReceipt | undefined>;
+};
+export type PaymentResponse = Response & {
+    receipt: StreamReceipt | null;
+    challenge: Challenge.Challenge | null;
+    channelId: Hex.Hex | null;
+    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()` MethodIntent plugin for all
+ * channel state management and credential creation, and to `Fetch.from`
+ * for the 402 challenge/retry flow.
+ *
+ * ## Session resumption
+ *
+ * All channel state is held **in memory**. If the client process restarts,
+ * the session is lost and a new on-chain channel will be opened on the next
+ * request — the previous channel's deposit is orphaned until manually closed.
+ *
+ * When the server includes a `channelId` in the 402 challenge `methodDetails`,
+ * the client will attempt to recover the channel by reading its on-chain state
+ * via `getOnChainChannel()`. If the channel has a positive deposit and is not
+ * finalized, it resumes from the on-chain settled amount.
+ */
+export declare function sessionManager(parameters: sessionManager.Parameters): SessionManager;
+export declare namespace sessionManager {
+    type Parameters = Account.getResolver.Parameters & Client.getResolver.Parameters & {
+        /** Address authorized to sign vouchers. Defaults to the account address. */
+        authorizedSigner?: Address | 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;
+        /** Escrow contract address. */
+        escrowContract?: Address | undefined;
+        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;
+    };
+}
+//# sourceMappingURL=SessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,IAAI,CAAA;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7E,GAAG,CACD,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;QAC1D,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KACjC,GACA,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,KAAK,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG;IACvC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,SAAS,CAAC,SAAS,GAAG,IAAI,CAAA;IACrC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,GAAG,cAAc,CAqMpF;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,KAAK,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,GAC9C,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;QAC9B,4EAA4E;QAC5E,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACtC,qEAAqE;QACrE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1C,iFAAiF;QACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,+BAA+B;QAC/B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;QAC3C,kHAAkH;QAClH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAChC,CAAA;CACJ"}

package/dist/tempo/client/SessionManager.js

@@ -0,0 +1,196 @@
+import * as Fetch from '../../client/internal/Fetch.js';
+import { deserializeStreamReceipt } from '../stream/Receipt.js';
+import { parseEvent } from '../stream/Sse.js';
+import { session as sessionPlugin } from './Session.js';
+/**
+ * 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()` MethodIntent plugin for all
+ * channel state management and credential creation, and to `Fetch.from`
+ * for the 402 challenge/retry flow.
+ *
+ * ## Session resumption
+ *
+ * All channel state is held **in memory**. If the client process restarts,
+ * the session is lost and a new on-chain channel will be opened on the next
+ * request — the previous channel's deposit is orphaned until manually closed.
+ *
+ * When the server includes a `channelId` in the 402 challenge `methodDetails`,
+ * the client will attempt to recover the channel by reading its on-chain state
+ * via `getOnChainChannel()`. If the channel has a positive deposit and is not
+ * finalized, it resumes from the on-chain settled amount.
+ */
+export function sessionManager(parameters) {
+    const fetchFn = parameters.fetch ?? globalThis.fetch;
+    let channel = null;
+    let lastChallenge = null;
+    let lastUrl = null;
+    const method = sessionPlugin({
+        account: parameters.account,
+        authorizedSigner: parameters.authorizedSigner,
+        getClient: parameters.client ? () => parameters.client : parameters.getClient,
+        escrowContract: parameters.escrowContract,
+        decimals: parameters.decimals,
+        maxDeposit: parameters.maxDeposit,
+        onChannelUpdate(entry) {
+            channel = entry;
+        },
+    });
+    const wrappedFetch = Fetch.from({
+        fetch: fetchFn,
+        methods: [method],
+        onChallenge(c) {
+            lastChallenge = c;
+        },
+    });
+    function toPaymentResponse(response) {
+        const receiptHeader = response.headers.get('Payment-Receipt');
+        const receipt = receiptHeader ? deserializeStreamReceipt(receiptHeader) : null;
+        return Object.assign(response, {
+            receipt,
+            challenge: lastChallenge,
+            channelId: channel?.channelId ?? null,
+            cumulative: channel?.cumulativeAmount ?? 0n,
+        });
+    }
+    async function doFetch(input, init) {
+        lastUrl = input;
+        const response = await wrappedFetch(input, init);
+        return toPaymentResponse(response);
+    }
+    const self = {
+        get channelId() {
+            return channel?.channelId;
+        },
+        get cumulative() {
+            return channel?.cumulativeAmount ?? 0n;
+        },
+        get opened() {
+            return channel?.opened ?? false;
+        },
+        async open(options) {
+            if (channel?.opened)
+                return;
+            if (!lastChallenge) {
+                throw new Error('No challenge available. Make a request first to receive a 402 challenge, or pass a challenge via .fetch()/.sse().');
+            }
+            const deposit = options?.deposit;
+            const credential = await method.createCredential({
+                challenge: lastChallenge,
+                context: {
+                    ...(deposit !== undefined && { depositRaw: deposit.toString() }),
+                },
+            });
+            if (!lastUrl)
+                throw new Error('No URL available — call fetch() or sse() before open().');
+            const response = await fetchFn(lastUrl, {
+                method: 'POST',
+                headers: { Authorization: credential },
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                const wwwAuth = response.headers.get('WWW-Authenticate') ?? '';
+                throw new Error(`Open request failed with status ${response.status}${body ? `: ${body}` : ''}${wwwAuth ? ` [WWW-Authenticate: ${wwwAuth}]` : ''}`);
+            }
+        },
+        fetch: doFetch,
+        async sse(input, init) {
+            const { onReceipt, signal, ...fetchInit } = init ?? {};
+            const sseInit = {
+                ...fetchInit,
+                headers: {
+                    ...fetchInit.headers,
+                    Accept: 'text/event-stream',
+                },
+            };
+            const response = await doFetch(input, sseInit);
+            if (!response.body)
+                throw new Error('Response has no body.');
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            async function* iterate() {
+                let buffer = '';
+                try {
+                    while (true) {
+                        if (signal?.aborted)
+                            break;
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        const parts = buffer.split('\n\n');
+                        buffer = parts.pop();
+                        for (const part of parts) {
+                            if (!part.trim())
+                                continue;
+                            const event = parseEvent(part);
+                            if (!event)
+                                continue;
+                            switch (event.type) {
+                                case 'message':
+                                    yield event.data;
+                                    break;
+                                case 'payment-need-voucher': {
+                                    if (!channel || !lastChallenge)
+                                        break;
+                                    const required = BigInt(event.data.requiredCumulative);
+                                    channel.cumulativeAmount =
+                                        channel.cumulativeAmount > required ? channel.cumulativeAmount : required;
+                                    const credential = await method.createCredential({
+                                        challenge: lastChallenge,
+                                        context: {
+                                            action: 'voucher',
+                                            channelId: channel.channelId,
+                                            cumulativeAmountRaw: channel.cumulativeAmount.toString(),
+                                        },
+                                    });
+                                    const voucherResponse = await fetchFn(input, {
+                                        method: 'POST',
+                                        headers: { Authorization: credential },
+                                    });
+                                    if (!voucherResponse.ok) {
+                                        throw new Error(`Voucher POST failed with status ${voucherResponse.status}`);
+                                    }
+                                    break;
+                                }
+                                case 'payment-receipt':
+                                    onReceipt?.(event.data);
+                                    break;
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            return iterate();
+        },
+        async close() {
+            if (!channel?.opened || !lastChallenge)
+                return undefined;
+            const credential = await method.createCredential({
+                challenge: lastChallenge,
+                context: {
+                    action: 'close',
+                    channelId: channel.channelId,
+                    cumulativeAmountRaw: channel.cumulativeAmount.toString(),
+                },
+            });
+            let receipt;
+            if (lastUrl) {
+                const response = await fetchFn(lastUrl, {
+                    method: 'POST',
+                    headers: { Authorization: credential },
+                });
+                const receiptHeader = response.headers.get('Payment-Receipt');
+                if (receiptHeader)
+                    receipt = deserializeStreamReceipt(receiptHeader);
+            }
+            return receipt;
+        },
+    };
+    return self;
+}
+//# sourceMappingURL=SessionManager.js.map

package/dist/tempo/client/SessionManager.js.map

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

package/dist/tempo/client/index.d.ts

@@ -0,0 +1,6 @@
+export { charge } from './Charge.js';
+export { tempo } from './MethodIntents.js';
+export { session } from './Session.js';
+export type { PaymentResponse, SessionManager } from './SessionManager.js';
+export { sessionManager } from './SessionManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tempo/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/client/index.js

@@ -0,0 +1,5 @@
+export { charge } from './Charge.js';
+export { tempo } from './MethodIntents.js';
+export { session } from './Session.js';
+export { sessionManager } from './SessionManager.js';
+//# sourceMappingURL=index.js.map

package/dist/tempo/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/index.d.ts

@@ -0,0 +1,3 @@
+export * as MethodIntents from './Intents.js';
+export * as Stream from './stream/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}

package/dist/tempo/index.js

@@ -0,0 +1,3 @@
+export * as MethodIntents from './Intents.js';
+export * as Stream from './stream/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tempo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}

package/dist/tempo/internal/account.d.ts

@@ -0,0 +1,32 @@
+import type { Account, Address } from 'viem';
+/**
+ * Resolves a recipient address and optional fee payer from flexible input parameters.
+ *
+ * Accepts either `account` or `recipient` as the parameter name. When the value
+ * is an `Account`, its address is extracted. If `feePayer` is `true`, the
+ * account also acts as the fee payer. Alternatively, a separate `Account`
+ * can be provided as the fee payer.
+ *
+ * @returns An object with `account`, `feePayer`, and `recipient`.
+ */
+export declare function resolve(parameters: resolve.Parameters): {
+    account: Account | undefined;
+    feePayer: Account | undefined;
+    recipient: Address | undefined;
+};
+export declare namespace resolve {
+    type Parameters = {
+        recipient?: Address | undefined;
+    } & ({
+        /** Account that performs payment operations. */
+        account?: Account | undefined;
+        /** When true, the account also sponsors (pays) transaction fees. */
+        feePayer?: true | undefined;
+    } | {
+        /** Address that receives payment. */
+        account?: Address | undefined;
+        /** Optional fee payer account for covering transaction fees. */
+        feePayer?: Account | undefined;
+    });
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/tempo/internal/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/tempo/internal/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU;;;eAgBA,OAAO,GAAG,SAAS;EACxE;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,CACpD;QACE,gDAAgD;QAChD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,oEAAoE;QACpE,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;KAC5B,GACD;QACE,qCAAqC;QACrC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,gEAAgE;QAChE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC/B,CACJ,CAAA;CACF"}

package/dist/tempo/internal/account.js

@@ -0,0 +1,33 @@
+/**
+ * Resolves a recipient address and optional fee payer from flexible input parameters.
+ *
+ * Accepts either `account` or `recipient` as the parameter name. When the value
+ * is an `Account`, its address is extracted. If `feePayer` is `true`, the
+ * account also acts as the fee payer. Alternatively, a separate `Account`
+ * can be provided as the fee payer.
+ *
+ * @returns An object with `account`, `feePayer`, and `recipient`.
+ */
+export function resolve(parameters) {
+    const account = (() => {
+        if (typeof parameters.account === 'object')
+            return parameters.account;
+        return undefined;
+    })();
+    const recipient = (() => {
+        if (parameters.recipient)
+            return parameters.recipient;
+        if (typeof parameters.account === 'object')
+            return parameters.account.address;
+        return parameters.account;
+    })();
+    const feePayer = (() => {
+        if (typeof parameters.account === 'object' && parameters.feePayer === true)
+            return parameters.account;
+        if (typeof parameters.feePayer === 'object')
+            return parameters.feePayer;
+        return undefined;
+    })();
+    return { account, feePayer, recipient: recipient };
+}
+//# sourceMappingURL=account.js.map

package/dist/tempo/internal/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/tempo/internal/account.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,UAA8B;IACpD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,UAAU,CAAC,OAAO,CAAA;QACrE,OAAO,SAAS,CAAA;IAClB,CAAC,CAAC,EAAE,CAAA;IACJ,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;QACtB,IAAI,UAAU,CAAC,SAAS;YAAE,OAAO,UAAU,CAAC,SAAS,CAAA;QACrD,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAA;QAC7E,OAAO,UAAU,CAAC,OAAO,CAAA;IAC3B,CAAC,CAAC,EAAE,CAAA;IACJ,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;QACrB,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,KAAK,IAAI;YACxE,OAAO,UAAU,CAAC,OAAO,CAAA;QAC3B,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,UAAU,CAAC,QAAQ,CAAA;QACvE,OAAO,SAAS,CAAA;IAClB,CAAC,CAAC,EAAE,CAAA;IACJ,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAgC,EAAE,CAAA;AAC3E,CAAC"}

package/dist/tempo/internal/defaults.d.ts

@@ -0,0 +1,18 @@
+export declare const rpcUrl: {
+    readonly 4217: "https://rpc.tempo.xyz";
+    readonly 42431: "https://rpc.moderato.tempo.xyz";
+};
+export declare const escrowContract: {
+    readonly 4217: "0x0901aED692C755b870F9605E56BAA66C35BEfF69";
+    readonly 42431: "0x542831e3E4Ace07559b7C8787395f4Fb99F70787";
+};
+export declare const testnetChainId = 42431;
+/**
+ * Default token decimals for TIP-20 stablecoins (e.g. alphaUSD).
+ *
+ * All TIP-20 tokens on Tempo use 6 decimals, so there is no risk of
+ * client/server mismatch within the Tempo ecosystem. Other chains and
+ * runtimes should set `decimals` explicitly to match their token.
+ */
+export declare const decimals = 6;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/tempo/internal/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/tempo/internal/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGT,CAAA;AAEV,eAAO,MAAM,cAAc;;;CAGjB,CAAA;AAEV,eAAO,MAAM,cAAc,QAAQ,CAAA;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,IAAI,CAAA"}

package/dist/tempo/internal/defaults.js

@@ -0,0 +1,18 @@
+export const rpcUrl = {
+    4217: 'https://rpc.tempo.xyz',
+    42431: 'https://rpc.moderato.tempo.xyz',
+};
+export const escrowContract = {
+    4217: '0x0901aED692C755b870F9605E56BAA66C35BEfF69',
+    42431: '0x542831e3E4Ace07559b7C8787395f4Fb99F70787',
+};
+export const testnetChainId = 42431;
+/**
+ * Default token decimals for TIP-20 stablecoins (e.g. alphaUSD).
+ *
+ * All TIP-20 tokens on Tempo use 6 decimals, so there is no risk of
+ * client/server mismatch within the Tempo ecosystem. Other chains and
+ * runtimes should set `decimals` explicitly to match their token.
+ */
+export const decimals = 6;
+//# sourceMappingURL=defaults.js.map

package/dist/tempo/internal/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/tempo/internal/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,gCAAgC;CAC/B,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;CAC3C,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAA"}

package/dist/tempo/internal/types.d.ts

@@ -0,0 +1,11 @@
+import type { Account } from 'viem';
+export type DeriveDefaults<parameters, defaults> = Pick<parameters, Extract<keyof parameters, keyof defaults>> & (parameters extends {
+    account: Account | string;
+} ? {
+    recipient: string;
+} : {}) & (parameters extends {
+    recipient: string;
+} ? {
+    recipient: string;
+} : {});
+//# sourceMappingURL=types.d.ts.map

package/dist/tempo/internal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tempo/internal/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,MAAM,MAAM,cAAc,CAAC,UAAU,EAAE,QAAQ,IAAI,IAAI,CACrD,UAAU,EACV,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,CAAC,CAC1C,GACC,CAAC,UAAU,SAAS;IAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAAC,GAC/E,CAAC,UAAU,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAAC,CAAA"}

package/dist/tempo/internal/types.js

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

package/dist/tempo/internal/types.js.map

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

package/dist/tempo/server/Charge.d.ts

@@ -0,0 +1,77 @@
+import type { LooseOmit } from '../../internal/types.js';
+import * as MethodIntent from '../../MethodIntent.js';
+import * as Client from '../../viem/Client.js';
+import * as Intents from '../Intents.js';
+import * as Account from '../internal/account.js';
+import type * as types from '../internal/types.js';
+/**
+ * Creates a Tempo charge method intent for usage on the server.
+ *
+ * @example
+ * ```ts
+ * import { tempo } from 'mppx/server'
+ *
+ * const charge = tempo.charge()
+ * ```
+ */
+export declare function charge<const parameters extends charge.Parameters>(parameters?: parameters): MethodIntent.Server<MethodIntent.MethodIntent<{
+    readonly name: "charge";
+    readonly schema: {
+        readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
+            amount: import("zod/mini").ZodMiniString<string>;
+            currency: import("zod/mini").ZodMiniString<string>;
+            decimals: import("zod/mini").ZodMiniNumber<number>;
+            description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            expires: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniString<string>>;
+            externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            recipient: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+        }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
+            amount: string;
+            currency: string;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }, {
+            amount: string;
+            currency: string;
+            decimals: number;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }>>;
+    };
+}, {
+    readonly method: "tempo";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniDiscriminatedUnion<[import("zod/mini").ZodMiniObject<{
+                hash: import("zod/mini").ZodMiniString<string>;
+                type: import("zod/mini").ZodMiniLiteral<"hash">;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                signature: import("zod/mini").ZodMiniString<string>;
+                type: import("zod/mini").ZodMiniLiteral<"transaction">;
+            }, import("zod/v4/core").$strip>], "type">;
+        };
+        readonly request: {
+            readonly methodDetails: import("zod/mini").ZodMiniObject<{
+                chainId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNumber<number>>;
+                feePayer: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniBoolean<boolean>, import("zod/mini").ZodMiniCustom<import("viem").Account, import("viem").Account>]>, import("zod/mini").ZodMiniTransform<boolean, boolean | import("viem").Account>>>;
+                memo: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>;
+            readonly requires: readonly ["decimals", "recipient"];
+        };
+    };
+}>, charge.DeriveDefaults<parameters>, undefined>;
+export declare namespace charge {
+    type Defaults = LooseOmit<MethodIntent.RequestDefaults<typeof Intents.charge>, 'feePayer' | 'recipient'>;
+    type Parameters = {
+        /** Testnet mode. */
+        testnet?: boolean | undefined;
+    } & Client.getResolver.Parameters & Account.resolve.Parameters & Defaults;
+    type DeriveDefaults<parameters extends Parameters> = types.DeriveDefaults<parameters, Defaults> & {
+        decimals: number;
+    };
+}
+//# sourceMappingURL=Charge.d.ts.map

package/dist/tempo/server/Charge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/tempo/server/Charge.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAC9C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAEjD,OAAO,KAAK,KAAK,KAAK,MAAM,sBAAsB,CAAA;AAUlD;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAC/D,UAAU,GAAE,UAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAkO1C;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,QAAQ,GAAG,SAAS,CACvB,YAAY,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EACnD,UAAU,GAAG,WAAW,CACzB,CAAA;IAED,KAAK,UAAU,GAAG;QAChB,oBAAoB;QACpB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC9B,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,GAC/B,OAAO,CAAC,OAAO,CAAC,UAAU,GAC1B,QAAQ,CAAA;IAEV,KAAK,cAAc,CAAC,UAAU,SAAS,UAAU,IAAI,KAAK,CAAC,cAAc,CACvE,UAAU,EACV,QAAQ,CACT,GAAG;QACF,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF"}