mppx 0.6.30 → 0.7.0

package/dist/tempo/session/precompile/Protocol.d.ts

@@ -0,0 +1,308 @@
+import type { Address, Hex } from 'viem';
+import type * as Challenge from '../../../Challenge.js';
+/** Amount encoded by TIP20EscrowChannel as a `uint96` on-chain value. */
+export type Uint96 = bigint;
+/** Decimal string containing raw token units, before applying token decimals. */
+export type RawAmountString = string;
+/** Returns whether a bigint can be encoded as a TIP20EscrowChannel `uint96` amount. */
+export declare function isUint96(value: bigint): value is Uint96;
+/** Converts a bigint into a TIP20EscrowChannel `uint96` amount after validating bounds. */
+export declare function uint96(value: bigint): Uint96;
+/** Asserts that a bigint can be encoded as a TIP20EscrowChannel `uint96` amount. */
+export declare function assertUint96(value: bigint): void;
+/** Full TIP-1034 channel descriptor used to derive and verify a channel ID. */
+export type ChannelDescriptor = {
+    /** Wallet that funds the channel and authorizes voucher spend. */
+    payer: Address;
+    /** Wallet that receives settlement from the channel. */
+    payee: Address;
+    /** Optional payee-side operator authorized for channel operations; zero address means unset. */
+    operator: Address;
+    /** TIP-20 token escrowed by the channel. */
+    token: Address;
+    /** Payer-selected entropy that makes otherwise identical descriptors unique. */
+    salt: Hex;
+    /** Address authorized to sign vouchers; zero address delegates to `payer`. */
+    authorizedSigner: Address;
+    /** Hash of the signed expiring-nonce open transaction required by TIP-1034. */
+    expiringNonceHash: Hex;
+};
+/** Public descriptor for a TIP-1034 session channel. */
+export type SessionDescriptor = ChannelDescriptor;
+/**
+ * Voucher for cumulative payment.
+ * Cumulative monotonicity prevents replay attacks.
+ */
+export type Voucher = {
+    channelId: Hex;
+    cumulativeAmount: bigint;
+};
+/**
+ * Signed voucher with EIP-712 signature.
+ */
+export type SignedVoucher = Voucher & {
+    signature: Hex;
+};
+/**
+ * Credential payload that opens a TIP-1034 precompile channel and authorizes initial spend.
+ */
+export type OpenCredentialPayload = {
+    action: 'open';
+    type: 'transaction';
+    /** TIP-1034 channel ID derived from descriptor, escrow, and chain ID. */
+    channelId: Hex;
+    /** Signed Tempo transaction containing the precompile `open` call. */
+    transaction: Hex;
+    /** Voucher signature for `cumulativeAmount`. */
+    signature: Hex;
+    /** Descriptor needed to recover and verify the channel. */
+    descriptor: ChannelDescriptor;
+    /** Initial cumulative spend authorized by the opening voucher, as raw units. */
+    cumulativeAmount: RawAmountString;
+    /** Voucher signer selected for the opened channel. */
+    authorizedSigner?: Address | undefined;
+};
+/**
+ * Credential payload that adds deposit to an existing TIP-1034 precompile channel.
+ */
+export type TopUpCredentialPayload = {
+    action: 'topUp';
+    type: 'transaction';
+    /** TIP-1034 channel ID being topped up. */
+    channelId: Hex;
+    /** Signed Tempo transaction containing the precompile `topUp` call. */
+    transaction: Hex;
+    /** Descriptor for the channel being topped up. */
+    descriptor: ChannelDescriptor;
+    /** Additional deposit to add, as raw units. */
+    additionalDeposit: RawAmountString;
+};
+/**
+ * Credential payload that increases cumulative spend authorization.
+ */
+export type VoucherCredentialPayload = {
+    action: 'voucher';
+    /** TIP-1034 channel ID the voucher applies to. */
+    channelId: Hex;
+    /** Descriptor for the voucher's channel. */
+    descriptor: ChannelDescriptor;
+    /** Highest cumulative spend authorized by this voucher, as raw units. */
+    cumulativeAmount: RawAmountString;
+    /** Voucher signature for `cumulativeAmount`. */
+    signature: Hex;
+};
+/**
+ * Credential payload that cooperatively closes a channel at final cumulative spend.
+ */
+export type CloseCredentialPayload = {
+    action: 'close';
+    /** TIP-1034 channel ID being closed. */
+    channelId: Hex;
+    /** Descriptor for the channel being closed. */
+    descriptor: ChannelDescriptor;
+    /** Final cumulative spend authorized at close, as raw units. */
+    cumulativeAmount: RawAmountString;
+    /** Voucher signature for `cumulativeAmount`. */
+    signature: Hex;
+};
+/**
+ * TIP20EscrowChannel precompile session credential payload (discriminated union).
+ */
+export type SessionCredentialPayload = OpenCredentialPayload | TopUpCredentialPayload | VoucherCredentialPayload | CloseCredentialPayload;
+/**
+ * Backend-neutral voucher for cumulative payment.
+ * Cumulative monotonicity prevents replay attacks.
+ */
+export interface SessionVoucher {
+    channelId: Hex;
+    cumulativeAmount: bigint;
+}
+/**
+ * Backend-neutral signed voucher with EIP-712 signature.
+ */
+export interface SessionSignedVoucher extends SessionVoucher {
+    signature: Hex;
+}
+/**
+ * Management action names shared by session credential payloads.
+ */
+export type SessionCredentialAction = 'open' | 'topUp' | 'voucher' | 'close';
+/**
+ * Minimal credential shape shared by transport helpers that only need routing context.
+ */
+export type SessionCredentialContext = {
+    /** Session channel ID referenced by the authorization payload. */
+    channelId: Hex;
+    /** Session management action when the payload is a management credential. */
+    action?: SessionCredentialAction | undefined;
+};
+/** Returns whether a value is a supported session credential action. */
+export declare function isSessionCredentialAction(value: unknown): value is SessionCredentialAction;
+/** Returns whether a value has the session credential fields needed by transports. */
+export declare function isSessionCredentialContext(value: unknown): value is SessionCredentialContext;
+/** Reads the shared session credential context or throws the provided error message. */
+export declare function requireSessionCredentialContext(value: unknown, errorMessage?: string): SessionCredentialContext;
+/** Reads the raw per-unit session amount from a payment challenge. */
+export declare function readSessionChallengeAmount(challenge: Challenge.Challenge): bigint;
+/**
+ * SSE event emitted when session balance is exhausted mid-stream.
+ * The client responds by sending a new voucher credential.
+ *
+ * Per spec §11.6, the event data contains:
+ * - `channelId` — channel identifier
+ * - `requiredCumulative` — minimum cumulative amount the next voucher must authorize
+ * - `acceptedCumulative` — current highest accepted voucher amount
+ * - `deposit` — current on-chain deposit ceiling; when `requiredCumulative > deposit`
+ *   the client must top up the channel before sending a new voucher
+ */
+export interface NeedVoucherEvent {
+    channelId: Hex;
+    /** Minimum cumulative voucher amount required to continue, as raw token units. */
+    requiredCumulative: RawAmountString;
+    /** Highest cumulative voucher amount currently accepted by the server, as raw token units. */
+    acceptedCumulative: RawAmountString;
+    /** Current channel deposit ceiling, as raw token units. */
+    deposit: RawAmountString;
+}
+/** Returns whether a value is a typed need-voucher event payload. */
+export declare function isNeedVoucherEvent(value: unknown): value is NeedVoucherEvent;
+/**
+ * Session receipt returned in Payment-Receipt header.
+ */
+export interface SessionReceipt {
+    /** Payment method that produced the receipt. */
+    method: 'tempo';
+    /** Payment intent that produced the receipt. */
+    intent: 'session';
+    /** Receipt status. */
+    status: 'success';
+    /** ISO timestamp when the receipt was created. */
+    timestamp: string;
+    /** Payment reference (channelId). Satisfies Receipt.Receipt contract. */
+    reference: string;
+    /** Challenge ID that this receipt settles or acknowledges. */
+    challengeId: string;
+    /** TIP-1034 channel ID. */
+    channelId: Hex;
+    /** Highest cumulative voucher amount accepted by the server, as raw token units. */
+    acceptedCumulative: RawAmountString;
+    /** Amount actually consumed by delivered work/content, as raw token units. */
+    spent: RawAmountString;
+    /** Paid units delivered by the server, when the transport reports them. */
+    units?: number | undefined;
+    /** On-chain transaction hash when this receipt came from settlement or close. */
+    txHash?: Hex | undefined;
+}
+/** Returns whether a value is a typed session payment receipt. */
+export declare function isSessionReceipt(value: unknown): value is SessionReceipt;
+/**
+ * Create a session receipt.
+ */
+export declare function createSessionReceipt(params: {
+    challengeId: string;
+    channelId: Hex;
+    acceptedCumulative: bigint;
+    spent: bigint;
+    units?: number | undefined;
+    txHash?: Hex | undefined;
+}): SessionReceipt;
+/**
+ * Serialize a session receipt to the Payment-Receipt header format.
+ */
+export declare function serializeSessionReceipt(receipt: SessionReceipt): string;
+/**
+ * Deserialize a Payment-Receipt header value to a session receipt.
+ */
+export declare function deserializeSessionReceipt(encoded: string): SessionReceipt;
+/**
+ * Parsed SSE event (discriminated union by `type`).
+ */
+export type SseEvent = {
+    type: 'message';
+    data: string;
+} | {
+    type: 'payment-need-voucher';
+    data: NeedVoucherEvent;
+} | {
+    type: 'payment-receipt';
+    data: SessionReceipt;
+};
+/** Returns whether a response carries an SSE event stream. */
+export declare function isEventStream(response: Response): boolean;
+/**
+ * Format a session receipt as a Server-Sent Event.
+ *
+ * Produces a valid SSE event string with `event: payment-receipt`
+ * and the receipt JSON as the `data` field.
+ */
+export declare function formatReceiptEvent(receipt: SessionReceipt): string;
+/**
+ * Format a need-voucher event as a Server-Sent Event.
+ *
+ * Emitted when the channel balance is exhausted mid-stream.
+ */
+export declare function formatNeedVoucherEvent(params: NeedVoucherEvent): string;
+/**
+ * Format an application message as SSE, preserving embedded newlines.
+ *
+ * SSE requires multi-line payloads to be emitted as separate `data:` fields.
+ */
+export declare function formatMessageEvent(value: string): string;
+/**
+ * Parse a raw SSE event string into a typed event.
+ *
+ * Unknown event names fall back to `message`, which preserves compatibility
+ * with generic SSE producers.
+ */
+export declare function parseEvent(raw: string): SseEvent | null;
+/** Extracts the `data:` field value from a single SSE event block. */
+export declare function extractData(event: string): string | null;
+/** In-band WebSocket payment protocol frame. */
+export type Message = {
+    mpp: 'authorization';
+    authorization: string;
+} | {
+    mpp: 'message';
+    data: string;
+} | {
+    mpp: 'payment-close-request';
+} | {
+    mpp: 'payment-close-ready';
+    data: SessionReceipt;
+} | {
+    mpp: 'payment-error';
+    status: number;
+    message: string;
+} | {
+    mpp: 'payment-need-voucher';
+    data: NeedVoucherEvent;
+} | {
+    mpp: 'payment-receipt';
+    data: SessionReceipt;
+};
+/** Input for formatting a WebSocket payment protocol error frame. */
+export type ErrorMessageParameters = {
+    /** Human-readable error message. */
+    message: string;
+    /** HTTP-style payment error status. */
+    status: number;
+};
+/** Formats the initial or follow-up payment authorization frame. */
+export declare function formatAuthorizationMessage(authorization: string): string;
+/** Formats an application payload frame. */
+export declare function formatApplicationMessage(data: string): string;
+/** Formats the client request for a final close-ready receipt. */
+export declare function formatCloseRequestMessage(): string;
+/** Formats the server close-ready receipt frame. */
+export declare function formatCloseReadyMessage(receipt: SessionReceipt): string;
+/** Formats a server request for a larger voucher. */
+export declare function formatNeedVoucherMessage(params: NeedVoucherEvent): string;
+/** Formats an intermediate or final payment receipt frame. */
+export declare function formatReceiptMessage(receipt: SessionReceipt): string;
+/** Formats a payment protocol error frame. */
+export declare function formatErrorMessage(parameters: ErrorMessageParameters): string;
+/** Parses a WebSocket payment protocol frame, returning null for application data. */
+export declare function parseMessage(raw: string): Message | null;
+/** Canonical TIP-1034 TIP-20 Channel Escrow precompile address. */
+export declare const tip20ChannelEscrow = "0x4d50500000000000000000000000000000000000";
+//# sourceMappingURL=Protocol.d.ts.map

package/dist/tempo/session/precompile/Protocol.d.ts.map

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

package/dist/tempo/session/precompile/Protocol.js

@@ -0,0 +1,264 @@
+import { Base64 } from 'ox';
+const maxUint96 = (1n << 96n) - 1n;
+/** Returns whether a bigint can be encoded as a TIP20EscrowChannel `uint96` amount. */
+export function isUint96(value) {
+    return value >= 0n && value <= maxUint96;
+}
+/** Converts a bigint into a TIP20EscrowChannel `uint96` amount after validating bounds. */
+export function uint96(value) {
+    assertUint96(value);
+    return value;
+}
+/** Asserts that a bigint can be encoded as a TIP20EscrowChannel `uint96` amount. */
+export function assertUint96(value) {
+    if (!isUint96(value))
+        throw new Error(`Value ${value} is outside uint96 bounds.`);
+}
+const sessionCredentialActions = new Set(['open', 'topUp', 'voucher', 'close']);
+function isObject(value) {
+    return value !== null && typeof value === 'object';
+}
+/** Returns whether a value is a supported session credential action. */
+export function isSessionCredentialAction(value) {
+    return typeof value === 'string' && sessionCredentialActions.has(value);
+}
+/** Returns whether a value has the session credential fields needed by transports. */
+export function isSessionCredentialContext(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    if (typeof candidate.channelId !== 'string')
+        return false;
+    if (candidate.action !== undefined && !isSessionCredentialAction(candidate.action))
+        return false;
+    return true;
+}
+/** Reads the shared session credential context or throws the provided error message. */
+export function requireSessionCredentialContext(value, errorMessage = 'No session credential context available.') {
+    if (!isSessionCredentialContext(value))
+        throw new Error(errorMessage);
+    return value;
+}
+/** Reads the raw per-unit session amount from a payment challenge. */
+export function readSessionChallengeAmount(challenge) {
+    const amount = challenge.request.amount;
+    if (typeof amount !== 'string')
+        throw new Error('Session challenge is missing amount.');
+    return BigInt(amount);
+}
+/** Returns whether a value is a typed need-voucher event payload. */
+export function isNeedVoucherEvent(value) {
+    if (!isObject(value))
+        return false;
+    return (typeof value.channelId === 'string' &&
+        typeof value.requiredCumulative === 'string' &&
+        typeof value.acceptedCumulative === 'string' &&
+        typeof value.deposit === 'string');
+}
+/** Returns whether a value is a typed session payment receipt. */
+export function isSessionReceipt(value) {
+    if (!isObject(value))
+        return false;
+    return (value.method === 'tempo' &&
+        value.intent === 'session' &&
+        value.status === 'success' &&
+        typeof value.timestamp === 'string' &&
+        typeof value.reference === 'string' &&
+        typeof value.challengeId === 'string' &&
+        typeof value.channelId === 'string' &&
+        typeof value.acceptedCumulative === 'string' &&
+        typeof value.spent === 'string' &&
+        (value.units === undefined || typeof value.units === 'number') &&
+        (value.txHash === undefined || typeof value.txHash === 'string'));
+}
+/**
+ * Create a session receipt.
+ */
+export function createSessionReceipt(params) {
+    return {
+        method: 'tempo',
+        intent: 'session',
+        status: 'success',
+        timestamp: new Date().toISOString(),
+        reference: params.channelId,
+        challengeId: params.challengeId,
+        channelId: params.channelId,
+        acceptedCumulative: params.acceptedCumulative.toString(),
+        spent: params.spent.toString(),
+        ...(params.units !== undefined && { units: params.units }),
+        ...(params.txHash !== undefined && { txHash: params.txHash }),
+    };
+}
+/**
+ * Serialize a session receipt to the Payment-Receipt header format.
+ */
+export function serializeSessionReceipt(receipt) {
+    const json = JSON.stringify(receipt);
+    return Base64.fromString(json, { pad: false, url: true });
+}
+/**
+ * Deserialize a Payment-Receipt header value to a session receipt.
+ */
+export function deserializeSessionReceipt(encoded) {
+    const json = Base64.toString(encoded);
+    const value = JSON.parse(json);
+    if (!isSessionReceipt(value))
+        throw new Error('Invalid session receipt.');
+    return value;
+}
+/** Returns whether a response carries an SSE event stream. */
+export function isEventStream(response) {
+    const ct = response.headers.get('content-type');
+    return ct?.toLowerCase().startsWith('text/event-stream') ?? false;
+}
+/**
+ * Format a session receipt as a Server-Sent Event.
+ *
+ * Produces a valid SSE event string with `event: payment-receipt`
+ * and the receipt JSON as the `data` field.
+ */
+export function formatReceiptEvent(receipt) {
+    return `event: payment-receipt\ndata: ${JSON.stringify(receipt)}\n\n`;
+}
+/**
+ * Format a need-voucher event as a Server-Sent Event.
+ *
+ * Emitted when the channel balance is exhausted mid-stream.
+ */
+export function formatNeedVoucherEvent(params) {
+    return `event: payment-need-voucher\ndata: ${JSON.stringify(params)}\n\n`;
+}
+/**
+ * Format an application message as SSE, preserving embedded newlines.
+ *
+ * SSE requires multi-line payloads to be emitted as separate `data:` fields.
+ */
+export function formatMessageEvent(value) {
+    const data = String(value)
+        .split('\n')
+        .map((line) => `data: ${line}`)
+        .join('\n');
+    return `event: message\n${data}\n\n`;
+}
+/**
+ * Parse a raw SSE event string into a typed event.
+ *
+ * Unknown event names fall back to `message`, which preserves compatibility
+ * with generic SSE producers.
+ */
+export function parseEvent(raw) {
+    let eventType = 'message';
+    const dataLines = [];
+    for (const line of raw.split('\n')) {
+        if (line.startsWith('event: ')) {
+            eventType = line.slice(7).trim();
+        }
+        else if (line.startsWith('data: ')) {
+            dataLines.push(line.slice(6));
+        }
+        else if (line === 'data:') {
+            dataLines.push('');
+        }
+    }
+    if (dataLines.length === 0)
+        return null;
+    const data = dataLines.join('\n');
+    switch (eventType) {
+        case 'message':
+            return { type: 'message', data };
+        case 'payment-need-voucher': {
+            const parsed = parseJson(data);
+            return isNeedVoucherEvent(parsed) ? { type: 'payment-need-voucher', data: parsed } : null;
+        }
+        case 'payment-receipt': {
+            const parsed = parseJson(data);
+            return isSessionReceipt(parsed) ? { type: 'payment-receipt', data: parsed } : null;
+        }
+        default:
+            return { type: 'message', data };
+    }
+}
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Extracts the `data:` field value from a single SSE event block. */
+export function extractData(event) {
+    const dataLines = [];
+    for (const line of event.split('\n')) {
+        if (line.startsWith('data: '))
+            dataLines.push(line.slice(6));
+        else if (line === 'data:')
+            dataLines.push('');
+    }
+    return dataLines.length > 0 ? dataLines.join('\n') : null;
+}
+/** Formats the initial or follow-up payment authorization frame. */
+export function formatAuthorizationMessage(authorization) {
+    return JSON.stringify({ mpp: 'authorization', authorization });
+}
+/** Formats an application payload frame. */
+export function formatApplicationMessage(data) {
+    return JSON.stringify({ mpp: 'message', data });
+}
+/** Formats the client request for a final close-ready receipt. */
+export function formatCloseRequestMessage() {
+    return JSON.stringify({ mpp: 'payment-close-request' });
+}
+/** Formats the server close-ready receipt frame. */
+export function formatCloseReadyMessage(receipt) {
+    return JSON.stringify({ mpp: 'payment-close-ready', data: receipt });
+}
+/** Formats a server request for a larger voucher. */
+export function formatNeedVoucherMessage(params) {
+    return JSON.stringify({ mpp: 'payment-need-voucher', data: params });
+}
+/** Formats an intermediate or final payment receipt frame. */
+export function formatReceiptMessage(receipt) {
+    return JSON.stringify({ mpp: 'payment-receipt', data: receipt });
+}
+/** Formats a payment protocol error frame. */
+export function formatErrorMessage(parameters) {
+    return JSON.stringify({ mpp: 'payment-error', ...parameters });
+}
+/** Parses a WebSocket payment protocol frame, returning null for application data. */
+export function parseMessage(raw) {
+    const parsed = parseJsonObject(raw);
+    if (!parsed)
+        return null;
+    if (parsed.mpp === 'authorization' && typeof parsed.authorization === 'string')
+        return { mpp: 'authorization', authorization: parsed.authorization };
+    if (parsed.mpp === 'message' && typeof parsed.data === 'string')
+        return { mpp: 'message', data: parsed.data };
+    if (parsed.mpp === 'payment-close-request')
+        return { mpp: 'payment-close-request' };
+    if (parsed.mpp === 'payment-close-ready' && isSessionReceipt(parsed.data))
+        return { mpp: 'payment-close-ready', data: parsed.data };
+    if (parsed.mpp === 'payment-error' &&
+        typeof parsed.status === 'number' &&
+        typeof parsed.message === 'string')
+        return { mpp: 'payment-error', status: parsed.status, message: parsed.message };
+    if (parsed.mpp === 'payment-need-voucher' && isNeedVoucherEvent(parsed.data))
+        return { mpp: 'payment-need-voucher', data: parsed.data };
+    if (parsed.mpp === 'payment-receipt' && isSessionReceipt(parsed.data))
+        return { mpp: 'payment-receipt', data: parsed.data };
+    return null;
+}
+function parseJsonObject(raw) {
+    try {
+        const value = JSON.parse(raw);
+        if (value === null || typeof value !== 'object')
+            return null;
+        return value;
+    }
+    catch {
+        return null;
+    }
+}
+/** Canonical TIP-1034 TIP-20 Channel Escrow precompile address. */
+export const tip20ChannelEscrow = '0x4d50500000000000000000000000000000000000';
+//# sourceMappingURL=Protocol.js.map

package/dist/tempo/session/precompile/Protocol.js.map

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

package/dist/tempo/session/precompile/Voucher.d.ts

@@ -0,0 +1,40 @@
+import type { Account, Address, Client, Hex } from 'viem';
+import type { Voucher, SignedVoucher } from './Protocol.js';
+/**
+ * EIP-712 domain for voucher signing.
+ */
+export declare function getVoucherDomain(escrowContract: Address, chainId: number): {
+    readonly name: "TIP20 Channel Reserve";
+    readonly version: "1";
+    readonly chainId: number;
+    readonly verifyingContract: `0x${string}`;
+};
+/**
+ * EIP-712 types for voucher signing.
+ * Matches @tempo/stream-channels/voucher and on-chain VOUCHER_TYPEHASH.
+ */
+export declare const voucherTypes: {
+    readonly Voucher: readonly [{
+        readonly name: "channelId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "cumulativeAmount";
+        readonly type: "uint96";
+    }];
+};
+/**
+ * Sign a voucher with an account.
+ */
+export declare function signVoucher(client: Client, account: Account, voucher: Voucher, verifyingContract: Address, chainId: number, _authorizedSigner?: Address | undefined): Promise<Hex>;
+/**
+ * Verify a voucher signature matches the expected signer.
+ *
+ * Only accepts raw secp256k1 signatures — the escrow contract verifies
+ * via ecrecover. Keychain, p256, and webAuthn signatures are rejected.
+ */
+export declare function verifyVoucher(escrowContract: Address, chainId: number, voucher: SignedVoucher, expectedSigner: Address): boolean;
+/**
+ * Parse a voucher from credential payload.
+ */
+export declare function parseVoucherFromPayload(channelId: Hex, cumulativeAmount: string, signature: Hex): SignedVoucher;
+//# sourceMappingURL=Voucher.d.ts.map

package/dist/tempo/session/precompile/Voucher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voucher.d.ts","sourceRoot":"","sources":["../../../../src/tempo/session/precompile/Voucher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAMzD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAQ3D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;;;;;EAOxE;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAKf,CAAA;AA4BV;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,GACtC,OAAO,CAAC,GAAG,CAAC,CA2Bd;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,OAAO,GACtB,OAAO,CA6BT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,GAAG,EACd,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,GAAG,GACb,aAAa,CAMf"}