@naculus/connect-appkit-core 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -484,6 +484,15 @@ declare function createNotificationSettingsStorage(): NotificationSettingsStorag
 declare function loadNotificationSettings(storage: NotificationSettingsStorage): Promise<NotificationSettings | null>;
 declare function saveNotificationSettings(storage: NotificationSettingsStorage, settings: NotificationSettings): void;
 declare function updateNotificationSettings(current: NotificationSettings, update: Partial<NotificationSettings>): NotificationSettings;
+/** One settings change, computed from the settings it applies to. */
+type NotificationSettingsUpdate = (current: NotificationSettings) => Partial<NotificationSettings>;
+/**
+ * The settings once the persisted ones finish loading: every change made
+ * before the load resolved, replayed in order on top of what was persisted
+ * (or the defaults when nothing was). Without this the late load overwrote
+ * those changes, e.g. a chain muted during the first render came back.
+ */
+declare function replayNotificationSettings(persisted: NotificationSettings | null, updates: readonly NotificationSettingsUpdate[]): NotificationSettings;
 declare function channelsUpdate(channels: string[]): Partial<NotificationSettings>;
 declare function mutedChainSettings(settings: NotificationSettings, chainId: string, muted: boolean): Partial<NotificationSettings>;
 declare function createNotification(item: Omit<NotificationItem, "id" | "timestamp">): NotificationItem;
@@ -890,6 +899,60 @@ interface PaymentRecord {
  */
 declare function describePayment(input: RequestInfo | URL, result: PaymentFetchResult): PaymentRecord | null;
 
+/** Request options accepted by a caller-built MPP session fetch. */
+interface MppSessionRequestInit extends RequestInit {
+    units?: bigint;
+}
+/** An open MPP payment channel, represented without depending on payments-mpp. */
+interface MppSessionChannel {
+    channelId: string;
+    payer: string;
+    payee: string;
+    mint: string;
+    channelProgram: string;
+    deposit: bigint;
+    gracePeriodSeconds: number;
+    openSlot: bigint;
+    salt: bigint;
+}
+/** A successful MPP receipt, represented structurally. */
+interface MppSessionReceipt {
+    status: "success";
+    method: string;
+    timestamp: string;
+    reference: string;
+    [field: string]: unknown;
+}
+interface MppSessionFetchResult {
+    response: Response;
+    receipt: unknown;
+    channel: unknown;
+}
+type MppSessionRequest = (input: RequestInfo | URL, init?: MppSessionRequestInit) => Promise<MppSessionFetchResult>;
+interface MppSessionForceCloseResult {
+    requestCloseTxHash: string;
+    withdrawPayer(): Promise<string>;
+}
+interface MppSessionMeter {
+    add(units: bigint): void;
+    readonly pending: bigint;
+}
+/** The caller-owned session surface consumed by the React and Vue shells. */
+interface MppSessionFetch extends MppSessionRequest {
+    readonly meter: MppSessionMeter;
+    readonly channels: readonly unknown[];
+    close(): Promise<MppSessionFetchResult>;
+    forceClose(): Promise<MppSessionForceCloseResult>;
+}
+/** Return a channel only when all public fields have the expected shape. */
+declare function readMppSessionChannel(value: unknown): MppSessionChannel | null;
+/** Return the newest structurally valid channel currently held by a session. */
+declare function readCurrentMppSessionChannel(session: Pick<MppSessionFetch, "channels">): MppSessionChannel | null;
+/** Return a receipt only when it has the public success-receipt shape. */
+declare function readMppSessionReceipt(value: unknown): MppSessionReceipt | null;
+/** A post-send channel-open failure carries the channel that can be recovered. */
+declare function readMppRecoveryChannelId(error: unknown): string | null;
+
 /**
  * Solana session keys for the appkit shells (connect-lib STATE thread 18).
  *
@@ -946,7 +1009,12 @@ interface RetryOptions {
     label?: string;
 }
 declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
-/** Convert EIP-1193 chainChanged values into the CAIP-2 form used by sessions. */
+/**
+ * Convert EIP-1193 chainChanged values into the CAIP-2 form used by sessions.
+ * Refuses chain 0 and anything above `Number.MAX_SAFE_INTEGER`, as
+ * connect-core's `normalizeEip155ChainId` does; switch to that export once
+ * the connect-lib release that adds it is the minimum supported version.
+ */
 declare function normalizeEip155ChainId(value: unknown): string | undefined;
 declare function toEip155Accounts(accounts: unknown[], chainId: string): string[];
 /**
@@ -1011,4 +1079,4 @@ declare function siwxResultToSession<M extends SiwxMessageLike>(result: SiwxResu
     refreshedAt: null;
 };
 
-export { type AddressValidationLevel, type AtomicSupport, type ChainCapabilities, type ChainInfo, type CompareCosts, type CompareCostsInput, type ConnectionStatus, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_NOTIFICATION_SETTINGS, type DecimalsCache, type DelegationFrameworkAdapterOptions, type DelegationPolicyDeps, type DelegationPolicyFlow, type DelegationPolicyPreview, type DelegationTypedData, type DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, InvalidUserOperationReceiptError, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type PaymentFetch, type PaymentFetchResult, type PaymentRecord, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionPreview, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PolicySignatureVerifier, type PreparedPolicyExecution, type RedemptionCodec, type RedemptionRpc, type RedemptionTransaction, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SimulationCallClient, type SimulationTransaction, type SiwxLocation, type SiwxMessageLike, type SiwxResultLike, type SmartAccountOptionsLike, type SmartAccountType, type SolanaIdentity, type SolanaOwnerSigner, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSessionKeyFlow, type SolanaSessionKeyFlowDeps, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type TransactionSimulationContext, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, assertHexSignature, atomicSupportFor, bareEvmAddress, buildDelegationPolicyMessage, buildSmartAccountConfig, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createDelegationFrameworkAdapter, createDelegationPolicyFlow, createNotification, createNotificationSettingsStorage, createSolanaSessionKeyFlow, decodeRevertReason, defaultSiwxDomain, defaultSiwxUri, describeChain, describePayment, eip155ChainIdToNumber, encodeErc20Approve, encodeErc20Transfer, encodeErc20TransferFrom, fetchUserOperationReceipt, getResolver, getSharedSessionKeyManager, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, isSiwxExpired, isSiwxNotBeforeValid, isVerifiablePolicy, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, parseUserOperationReceipt, readDecimals, readSolanaRoles, resetSharedSessionKeyManager, resolveChain, resolveContextSimulationEndpoint, resolveEvmChainId, resolveRevertReason, resolveSimulationEndpoint, resolveUserOpChain, sameExecutionIntent, saveNotificationSettings, selectChainCapabilities, sessionKeyConfigFingerprint, simulateTransactionPreview, siwxResultToSession, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };
+export { type AddressValidationLevel, type AtomicSupport, type ChainCapabilities, type ChainInfo, type CompareCosts, type CompareCostsInput, type ConnectionStatus, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_NOTIFICATION_SETTINGS, type DecimalsCache, type DelegationFrameworkAdapterOptions, type DelegationPolicyDeps, type DelegationPolicyFlow, type DelegationPolicyPreview, type DelegationTypedData, type DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, InvalidUserOperationReceiptError, type MppSessionChannel, type MppSessionFetch, type MppSessionFetchResult, type MppSessionForceCloseResult, type MppSessionMeter, type MppSessionReceipt, type MppSessionRequest, type MppSessionRequestInit, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type NotificationSettingsUpdate, type PaymentFetch, type PaymentFetchResult, type PaymentRecord, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionPreview, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PolicySignatureVerifier, type PreparedPolicyExecution, type RedemptionCodec, type RedemptionRpc, type RedemptionTransaction, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SimulationCallClient, type SimulationTransaction, type SiwxLocation, type SiwxMessageLike, type SiwxResultLike, type SmartAccountOptionsLike, type SmartAccountType, type SolanaIdentity, type SolanaOwnerSigner, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSessionKeyFlow, type SolanaSessionKeyFlowDeps, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type TransactionSimulationContext, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, assertHexSignature, atomicSupportFor, bareEvmAddress, buildDelegationPolicyMessage, buildSmartAccountConfig, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createDelegationFrameworkAdapter, createDelegationPolicyFlow, createNotification, createNotificationSettingsStorage, createSolanaSessionKeyFlow, decodeRevertReason, defaultSiwxDomain, defaultSiwxUri, describeChain, describePayment, eip155ChainIdToNumber, encodeErc20Approve, encodeErc20Transfer, encodeErc20TransferFrom, fetchUserOperationReceipt, getResolver, getSharedSessionKeyManager, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, isSiwxExpired, isSiwxNotBeforeValid, isVerifiablePolicy, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, parseUserOperationReceipt, readCurrentMppSessionChannel, readDecimals, readMppRecoveryChannelId, readMppSessionChannel, readMppSessionReceipt, readSolanaRoles, replayNotificationSettings, resetSharedSessionKeyManager, resolveChain, resolveContextSimulationEndpoint, resolveEvmChainId, resolveRevertReason, resolveSimulationEndpoint, resolveUserOpChain, sameExecutionIntent, saveNotificationSettings, selectChainCapabilities, sessionKeyConfigFingerprint, simulateTransactionPreview, siwxResultToSession, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };

package/dist/index.d.ts

@@ -484,6 +484,15 @@ declare function createNotificationSettingsStorage(): NotificationSettingsStorag
 declare function loadNotificationSettings(storage: NotificationSettingsStorage): Promise<NotificationSettings | null>;
 declare function saveNotificationSettings(storage: NotificationSettingsStorage, settings: NotificationSettings): void;
 declare function updateNotificationSettings(current: NotificationSettings, update: Partial<NotificationSettings>): NotificationSettings;
+/** One settings change, computed from the settings it applies to. */
+type NotificationSettingsUpdate = (current: NotificationSettings) => Partial<NotificationSettings>;
+/**
+ * The settings once the persisted ones finish loading: every change made
+ * before the load resolved, replayed in order on top of what was persisted
+ * (or the defaults when nothing was). Without this the late load overwrote
+ * those changes, e.g. a chain muted during the first render came back.
+ */
+declare function replayNotificationSettings(persisted: NotificationSettings | null, updates: readonly NotificationSettingsUpdate[]): NotificationSettings;
 declare function channelsUpdate(channels: string[]): Partial<NotificationSettings>;
 declare function mutedChainSettings(settings: NotificationSettings, chainId: string, muted: boolean): Partial<NotificationSettings>;
 declare function createNotification(item: Omit<NotificationItem, "id" | "timestamp">): NotificationItem;
@@ -890,6 +899,60 @@ interface PaymentRecord {
  */
 declare function describePayment(input: RequestInfo | URL, result: PaymentFetchResult): PaymentRecord | null;
 
+/** Request options accepted by a caller-built MPP session fetch. */
+interface MppSessionRequestInit extends RequestInit {
+    units?: bigint;
+}
+/** An open MPP payment channel, represented without depending on payments-mpp. */
+interface MppSessionChannel {
+    channelId: string;
+    payer: string;
+    payee: string;
+    mint: string;
+    channelProgram: string;
+    deposit: bigint;
+    gracePeriodSeconds: number;
+    openSlot: bigint;
+    salt: bigint;
+}
+/** A successful MPP receipt, represented structurally. */
+interface MppSessionReceipt {
+    status: "success";
+    method: string;
+    timestamp: string;
+    reference: string;
+    [field: string]: unknown;
+}
+interface MppSessionFetchResult {
+    response: Response;
+    receipt: unknown;
+    channel: unknown;
+}
+type MppSessionRequest = (input: RequestInfo | URL, init?: MppSessionRequestInit) => Promise<MppSessionFetchResult>;
+interface MppSessionForceCloseResult {
+    requestCloseTxHash: string;
+    withdrawPayer(): Promise<string>;
+}
+interface MppSessionMeter {
+    add(units: bigint): void;
+    readonly pending: bigint;
+}
+/** The caller-owned session surface consumed by the React and Vue shells. */
+interface MppSessionFetch extends MppSessionRequest {
+    readonly meter: MppSessionMeter;
+    readonly channels: readonly unknown[];
+    close(): Promise<MppSessionFetchResult>;
+    forceClose(): Promise<MppSessionForceCloseResult>;
+}
+/** Return a channel only when all public fields have the expected shape. */
+declare function readMppSessionChannel(value: unknown): MppSessionChannel | null;
+/** Return the newest structurally valid channel currently held by a session. */
+declare function readCurrentMppSessionChannel(session: Pick<MppSessionFetch, "channels">): MppSessionChannel | null;
+/** Return a receipt only when it has the public success-receipt shape. */
+declare function readMppSessionReceipt(value: unknown): MppSessionReceipt | null;
+/** A post-send channel-open failure carries the channel that can be recovered. */
+declare function readMppRecoveryChannelId(error: unknown): string | null;
+
 /**
  * Solana session keys for the appkit shells (connect-lib STATE thread 18).
  *
@@ -946,7 +1009,12 @@ interface RetryOptions {
     label?: string;
 }
 declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
-/** Convert EIP-1193 chainChanged values into the CAIP-2 form used by sessions. */
+/**
+ * Convert EIP-1193 chainChanged values into the CAIP-2 form used by sessions.
+ * Refuses chain 0 and anything above `Number.MAX_SAFE_INTEGER`, as
+ * connect-core's `normalizeEip155ChainId` does; switch to that export once
+ * the connect-lib release that adds it is the minimum supported version.
+ */
 declare function normalizeEip155ChainId(value: unknown): string | undefined;
 declare function toEip155Accounts(accounts: unknown[], chainId: string): string[];
 /**
@@ -1011,4 +1079,4 @@ declare function siwxResultToSession<M extends SiwxMessageLike>(result: SiwxResu
     refreshedAt: null;
 };
 
-export { type AddressValidationLevel, type AtomicSupport, type ChainCapabilities, type ChainInfo, type CompareCosts, type CompareCostsInput, type ConnectionStatus, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_NOTIFICATION_SETTINGS, type DecimalsCache, type DelegationFrameworkAdapterOptions, type DelegationPolicyDeps, type DelegationPolicyFlow, type DelegationPolicyPreview, type DelegationTypedData, type DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, InvalidUserOperationReceiptError, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type PaymentFetch, type PaymentFetchResult, type PaymentRecord, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionPreview, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PolicySignatureVerifier, type PreparedPolicyExecution, type RedemptionCodec, type RedemptionRpc, type RedemptionTransaction, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SimulationCallClient, type SimulationTransaction, type SiwxLocation, type SiwxMessageLike, type SiwxResultLike, type SmartAccountOptionsLike, type SmartAccountType, type SolanaIdentity, type SolanaOwnerSigner, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSessionKeyFlow, type SolanaSessionKeyFlowDeps, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type TransactionSimulationContext, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, assertHexSignature, atomicSupportFor, bareEvmAddress, buildDelegationPolicyMessage, buildSmartAccountConfig, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createDelegationFrameworkAdapter, createDelegationPolicyFlow, createNotification, createNotificationSettingsStorage, createSolanaSessionKeyFlow, decodeRevertReason, defaultSiwxDomain, defaultSiwxUri, describeChain, describePayment, eip155ChainIdToNumber, encodeErc20Approve, encodeErc20Transfer, encodeErc20TransferFrom, fetchUserOperationReceipt, getResolver, getSharedSessionKeyManager, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, isSiwxExpired, isSiwxNotBeforeValid, isVerifiablePolicy, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, parseUserOperationReceipt, readDecimals, readSolanaRoles, resetSharedSessionKeyManager, resolveChain, resolveContextSimulationEndpoint, resolveEvmChainId, resolveRevertReason, resolveSimulationEndpoint, resolveUserOpChain, sameExecutionIntent, saveNotificationSettings, selectChainCapabilities, sessionKeyConfigFingerprint, simulateTransactionPreview, siwxResultToSession, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };
+export { type AddressValidationLevel, type AtomicSupport, type ChainCapabilities, type ChainInfo, type CompareCosts, type CompareCostsInput, type ConnectionStatus, type CostComparison, type CostComparisonOperation, type CostComparisonOptions, DEFAULT_NOTIFICATION_SETTINGS, type DecimalsCache, type DelegationFrameworkAdapterOptions, type DelegationPolicyDeps, type DelegationPolicyFlow, type DelegationPolicyPreview, type DelegationTypedData, type DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, InvalidUserOperationReceiptError, type MppSessionChannel, type MppSessionFetch, type MppSessionFetchResult, type MppSessionForceCloseResult, type MppSessionMeter, type MppSessionReceipt, type MppSessionRequest, type MppSessionRequestInit, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type NotificationSettingsUpdate, type PaymentFetch, type PaymentFetchResult, type PaymentRecord, type PolicyExecutionAdapter, type PolicyExecutionCheck, type PolicyExecutionPreview, type PolicyExecutionRoute, type PolicyExecutionSubmission, type PolicySignatureVerifier, type PreparedPolicyExecution, type RedemptionCodec, type RedemptionRpc, type RedemptionTransaction, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SimulationCallClient, type SimulationTransaction, type SiwxLocation, type SiwxMessageLike, type SiwxResultLike, type SmartAccountOptionsLike, type SmartAccountType, type SolanaIdentity, type SolanaOwnerSigner, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSessionKeyFlow, type SolanaSessionKeyFlowDeps, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type TransactionSimulationContext, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, assertHexSignature, atomicSupportFor, bareEvmAddress, buildDelegationPolicyMessage, buildSmartAccountConfig, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createDelegationFrameworkAdapter, createDelegationPolicyFlow, createNotification, createNotificationSettingsStorage, createSolanaSessionKeyFlow, decodeRevertReason, defaultSiwxDomain, defaultSiwxUri, describeChain, describePayment, eip155ChainIdToNumber, encodeErc20Approve, encodeErc20Transfer, encodeErc20TransferFrom, fetchUserOperationReceipt, getResolver, getSharedSessionKeyManager, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, isSiwxExpired, isSiwxNotBeforeValid, isVerifiablePolicy, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, parseUserOperationReceipt, readCurrentMppSessionChannel, readDecimals, readMppRecoveryChannelId, readMppSessionChannel, readMppSessionReceipt, readSolanaRoles, replayNotificationSettings, resetSharedSessionKeyManager, resolveChain, resolveContextSimulationEndpoint, resolveEvmChainId, resolveRevertReason, resolveSimulationEndpoint, resolveUserOpChain, sameExecutionIntent, saveNotificationSettings, selectChainCapabilities, sessionKeyConfigFingerprint, simulateTransactionPreview, siwxResultToSession, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };

package/dist/index.js

@@ -478,6 +478,13 @@ function saveNotificationSettings(storage, settings) {
 function updateNotificationSettings(current, update) {
   return { ...current, ...update };
 }
+function replayNotificationSettings(persisted, updates) {
+  let settings = persisted ?? DEFAULT_NOTIFICATION_SETTINGS;
+  for (const update of updates) {
+    settings = updateNotificationSettings(settings, update(settings));
+  }
+  return settings;
+}
 function channelsUpdate(channels) {
   const update = {};
   if (channels.includes("telegram")) update.telegram = true;
@@ -1347,6 +1354,36 @@ function describePayment(input, result) {
   };
 }
 
+// src/mpp-session.ts
+function record2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function readMppSessionChannel(value) {
+  const channel = record2(value);
+  if (!channel || typeof channel.channelId !== "string" || typeof channel.payer !== "string" || typeof channel.payee !== "string" || typeof channel.mint !== "string" || typeof channel.channelProgram !== "string" || typeof channel.deposit !== "bigint" || typeof channel.gracePeriodSeconds !== "number" || typeof channel.openSlot !== "bigint" || typeof channel.salt !== "bigint") {
+    return null;
+  }
+  return channel;
+}
+function readCurrentMppSessionChannel(session) {
+  for (let index = session.channels.length - 1; index >= 0; index--) {
+    const channel = readMppSessionChannel(session.channels[index]);
+    if (channel) return channel;
+  }
+  return null;
+}
+function readMppSessionReceipt(value) {
+  const receipt = record2(value);
+  if (receipt?.status !== "success" || typeof receipt.method !== "string" || typeof receipt.timestamp !== "string" || typeof receipt.reference !== "string") {
+    return null;
+  }
+  return receipt;
+}
+function readMppRecoveryChannelId(error) {
+  const channelId = record2(error)?.channelId;
+  return typeof channelId === "string" && channelId !== "" ? channelId : null;
+}
+
 // src/solana-session-key.ts
 import {
   verifySignedOwnerTransaction,
@@ -1465,18 +1502,25 @@ async function withRetry(fn, options) {
 }
 function normalizeEip155ChainId(value) {
   if (typeof value !== "string") return void 0;
+  let raw;
+  if (value.startsWith("eip155:")) {
+    raw = value.slice("eip155:".length);
+    if (!/^\d+$/.test(raw)) return void 0;
+  } else if (/^0x[0-9a-f]+$/i.test(value) || /^\d+$/.test(value)) {
+    raw = value;
+  } else {
+    return void 0;
+  }
+  let numeric;
   try {
-    if (value.startsWith("eip155:")) {
-      const reference = value.slice("eip155:".length);
-      if (!/^\d+$/.test(reference)) return void 0;
-      return `eip155:${BigInt(reference).toString(10)}`;
-    }
-    if (/^0x[0-9a-f]+$/i.test(value) || /^\d+$/.test(value)) {
-      return `eip155:${BigInt(value).toString(10)}`;
-    }
+    numeric = BigInt(raw);
   } catch {
+    return void 0;
   }
-  return void 0;
+  if (numeric <= 0n || numeric > BigInt(Number.MAX_SAFE_INTEGER)) {
+    return void 0;
+  }
+  return `eip155:${numeric.toString(10)}`;
 }
 function toEip155Accounts(accounts, chainId) {
   const reference = chainId.split(":")[1];
@@ -1606,8 +1650,13 @@ export {
   normalizeCapabilities,
   normalizeEip155ChainId,
   parseUserOperationReceipt,
+  readCurrentMppSessionChannel,
   readDecimals,
+  readMppRecoveryChannelId,
+  readMppSessionChannel,
+  readMppSessionReceipt,
   readSolanaRoles,
+  replayNotificationSettings,
   resetSharedSessionKeyManager,
   resolveChain,
   resolveContextSimulationEndpoint,