@naculus/connect-appkit-core 0.2.4 → 0.2.5

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Namespace, UniversalWalletSession, WalletCapabilities, TokenConfig, WalletError, WalletErrorCode, NameResolverConfig, NameResolver } from '@naculus/connect-core';
+import { Namespace, UniversalWalletSession, WalletCapabilities, TokenConfig, WalletError, WalletErrorCode, NameResolverConfig, NameResolver, NotificationSettings, InAppChannel, NotificationItem } from '@naculus/connect-core';
 
 /**
  * The types the framework-neutral half of appkit is built on.
@@ -425,6 +425,148 @@ declare function getResolver(config?: NameResolverConfig): NameResolver;
 /** Test seam: drop the shared instance. */
 declare function __resetResolverForTests(): void;
 
+/** Framework-neutral in-app notification actions and settings persistence. */
+
+interface NotificationSettingsStorage {
+    getItem<T>(key: string): Promise<T | null>;
+    setItem<T>(key: string, value: T): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+declare const NOTIFICATION_SETTINGS_KEY = "naculus_notif_react_settings";
+declare const DEFAULT_NOTIFICATION_SETTINGS: NotificationSettings;
+/** Preserve the existing localStorage adapter and fail-open UI fallback. */
+declare function createNotificationSettingsStorage(): NotificationSettingsStorage;
+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;
+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;
+declare function addInAppNotification(channel: InAppChannel, item: Omit<NotificationItem, "id" | "timestamp">): void;
+/** InAppChannel has no remove-one method; preserve its clear/replay behavior. */
+declare function clearOneInAppNotification(channel: InAppChannel, id: string): Promise<NotificationItem[]>;
+
+/**
+ * Destination-address checks shared by the React hook and the Vue composable.
+ *
+ * Syntactic only. `"ok"` means none of these checks found anything wrong —
+ * not that the recipient is who the user thinks. This cannot see an
+ * address-poisoning lookalike, a contract that will not release the funds,
+ * or a known-malicious destination. Labelling that "safe" once put a green
+ * tick beside a scammer's address; the level is deliberately not "safe".
+ */
+type AddressValidationLevel = "ok" | "warning" | "blocked";
+/** Machine-readable reason; the framework layer maps it to a user string. */
+type DestinationIssue = "empty" | "invalid_format" | "zero_address" | "burn_address";
+interface DestinationValidation {
+    isValid: boolean;
+    level: AddressValidationLevel;
+    issue: DestinationIssue | null;
+}
+/**
+ * Burn heuristic kept from the React hook: known sinks plus any well-formed
+ * address containing "dead". Stricter than connect-core's prefix-only
+ * `isBurnAddress`; unifying the two is a connect-lib change.
+ */
+declare function isBurnDestination(address: string): boolean;
+declare function validateDestination(address: string): DestinationValidation;
+/**
+ * The bare `0x…` account from either a CAIP-10 id (`eip155:1:0x…`) or a plain
+ * hex address; null when it is neither. Hooks and composables should not each
+ * carry their own copy of this split.
+ */
+declare function bareEvmAddress(account: string | null | undefined): `0x${string}` | null;
+
+/**
+ * Chain-abstraction (routing) domain types and the few decisions the React
+ * hooks and Vue composables share. The hooks inject the actual quote /
+ * compare / execute functions; nothing here talks to a network.
+ */
+interface RouteQuote {
+    routeId: string;
+    provider: string;
+    netReceiveFormatted: string;
+    toTokenSymbol: string;
+}
+interface RouteQuoteOptions {
+    sortBy?: "cost" | "time" | "balance";
+    maxSlippage?: number;
+}
+interface RouteQuoteInput {
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken?: string;
+    amount: string;
+    options?: RouteQuoteOptions;
+}
+type GetRouteQuotes = (from: string, to: string, token: string, amount: string, options?: RouteQuoteOptions, toToken?: string) => Promise<RouteQuote[]>;
+/**
+ * `BigInt()` throws on anything that is not a decimal integer — "1.5", "abc",
+ * "1e18" — so a user typing into an amount field must not reach it. Only a
+ * positive base-unit integer is a quotable amount.
+ */
+declare function isPositiveIntegerAmount(amount: string): boolean;
+/** True when every field a quote needs is present and the amount is quotable. */
+declare function isQuotableInput(input: RouteQuoteInput): boolean;
+interface CostComparison {
+    chain: string;
+    chainName: string;
+    totalCost: string;
+    gasCost: string;
+    estimatedTimeMs: number;
+}
+type CostComparisonOperation = "send_erc20" | "swap" | "bridge" | (string & {});
+interface CostComparisonOptions {
+    amount?: string;
+    token?: string;
+    [key: string]: unknown;
+}
+interface CompareCostsInput {
+    operation: CostComparisonOperation;
+    chains: string[];
+    options?: CostComparisonOptions;
+}
+type CompareCosts = (operation: string, chains: string[], options?: CostComparisonOptions) => Promise<CostComparison[]>;
+/**
+ * Value key for a compare-costs input. `chains` is an array and `options` an
+ * object; keying on identity re-fired the fetch on every render/reactive tick
+ * for a caller writing the natural inline literal — an unbounded loop against
+ * a cost API.
+ */
+declare function compareCostsKey(input: CompareCostsInput): string;
+interface ExecutableQuote {
+    routeId: string;
+    provider: string;
+    totalCost?: bigint;
+    estimatedTimeMs?: number;
+    toChain?: string;
+}
+interface ExecuteRouteResult {
+    fromTxHash: string;
+    toTxHash?: string;
+}
+interface ExecuteRouteOptions {
+    timeoutMs?: number;
+    gasLimit?: bigint;
+}
+interface ExecuteRouteError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type ExecuteRoute = (quote: ExecutableQuote, recipient: string, options?: ExecuteRouteOptions) => Promise<ExecuteRouteResult>;
+/**
+ * Recipient check before a cross-chain execution. An empty recipient is wrong
+ * on every chain. Beyond that the destination namespace decides: when the
+ * quote names `toChain`, the address is validated for that namespace; when it
+ * does not, this returns null and the executor decides, rather than rejecting
+ * a valid non-EVM address on a guess.
+ */
+declare function validateRouteRecipient(quote: ExecutableQuote | null | undefined, recipient: string): ExecuteRouteError | null;
+/** Normalise whatever an executor threw into the hook's error shape. */
+declare function toExecuteRouteError(cause: unknown): ExecuteRouteError;
+
 declare function withTimeout<T>(promise: Promise<T>, ms: number, label?: string): Promise<T>;
 interface RetryOptions {
     maxRetries: number;
@@ -465,4 +607,4 @@ type Web3Action = {
 declare const initialWeb3State: Web3State;
 declare function web3Reducer(state: Web3State, action: Web3Action): Web3State;
 
-export { type AtomicSupport, type ChainCapabilities, type ChainInfo, type ConnectionStatus, type DecimalsCache, type RetryOptions, type SolanaIdentity, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, atomicSupportFor, chainNamespace, chainNumber, chainsForNamespace, createDecimalsCache, decodeRevertReason, describeChain, eip155ChainIdToNumber, getResolver, initialWeb3State, isEvmChainId, normalizeCapabilities, normalizeEip155ChainId, readDecimals, readSolanaRoles, resolveChain, resolveEvmChainId, resolveRevertReason, selectChainCapabilities, toChainSwitchError, toEip155Accounts, toViemChain, tokenChainMismatch, tokenKey, 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 DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SolanaIdentity, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, atomicSupportFor, bareEvmAddress, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createNotification, createNotificationSettingsStorage, decodeRevertReason, describeChain, eip155ChainIdToNumber, getResolver, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, readDecimals, readSolanaRoles, resolveChain, resolveEvmChainId, resolveRevertReason, saveNotificationSettings, selectChainCapabilities, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Namespace, UniversalWalletSession, WalletCapabilities, TokenConfig, WalletError, WalletErrorCode, NameResolverConfig, NameResolver } from '@naculus/connect-core';
+import { Namespace, UniversalWalletSession, WalletCapabilities, TokenConfig, WalletError, WalletErrorCode, NameResolverConfig, NameResolver, NotificationSettings, InAppChannel, NotificationItem } from '@naculus/connect-core';
 
 /**
  * The types the framework-neutral half of appkit is built on.
@@ -425,6 +425,148 @@ declare function getResolver(config?: NameResolverConfig): NameResolver;
 /** Test seam: drop the shared instance. */
 declare function __resetResolverForTests(): void;
 
+/** Framework-neutral in-app notification actions and settings persistence. */
+
+interface NotificationSettingsStorage {
+    getItem<T>(key: string): Promise<T | null>;
+    setItem<T>(key: string, value: T): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+declare const NOTIFICATION_SETTINGS_KEY = "naculus_notif_react_settings";
+declare const DEFAULT_NOTIFICATION_SETTINGS: NotificationSettings;
+/** Preserve the existing localStorage adapter and fail-open UI fallback. */
+declare function createNotificationSettingsStorage(): NotificationSettingsStorage;
+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;
+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;
+declare function addInAppNotification(channel: InAppChannel, item: Omit<NotificationItem, "id" | "timestamp">): void;
+/** InAppChannel has no remove-one method; preserve its clear/replay behavior. */
+declare function clearOneInAppNotification(channel: InAppChannel, id: string): Promise<NotificationItem[]>;
+
+/**
+ * Destination-address checks shared by the React hook and the Vue composable.
+ *
+ * Syntactic only. `"ok"` means none of these checks found anything wrong —
+ * not that the recipient is who the user thinks. This cannot see an
+ * address-poisoning lookalike, a contract that will not release the funds,
+ * or a known-malicious destination. Labelling that "safe" once put a green
+ * tick beside a scammer's address; the level is deliberately not "safe".
+ */
+type AddressValidationLevel = "ok" | "warning" | "blocked";
+/** Machine-readable reason; the framework layer maps it to a user string. */
+type DestinationIssue = "empty" | "invalid_format" | "zero_address" | "burn_address";
+interface DestinationValidation {
+    isValid: boolean;
+    level: AddressValidationLevel;
+    issue: DestinationIssue | null;
+}
+/**
+ * Burn heuristic kept from the React hook: known sinks plus any well-formed
+ * address containing "dead". Stricter than connect-core's prefix-only
+ * `isBurnAddress`; unifying the two is a connect-lib change.
+ */
+declare function isBurnDestination(address: string): boolean;
+declare function validateDestination(address: string): DestinationValidation;
+/**
+ * The bare `0x…` account from either a CAIP-10 id (`eip155:1:0x…`) or a plain
+ * hex address; null when it is neither. Hooks and composables should not each
+ * carry their own copy of this split.
+ */
+declare function bareEvmAddress(account: string | null | undefined): `0x${string}` | null;
+
+/**
+ * Chain-abstraction (routing) domain types and the few decisions the React
+ * hooks and Vue composables share. The hooks inject the actual quote /
+ * compare / execute functions; nothing here talks to a network.
+ */
+interface RouteQuote {
+    routeId: string;
+    provider: string;
+    netReceiveFormatted: string;
+    toTokenSymbol: string;
+}
+interface RouteQuoteOptions {
+    sortBy?: "cost" | "time" | "balance";
+    maxSlippage?: number;
+}
+interface RouteQuoteInput {
+    fromChain: string;
+    toChain: string;
+    fromToken: string;
+    toToken?: string;
+    amount: string;
+    options?: RouteQuoteOptions;
+}
+type GetRouteQuotes = (from: string, to: string, token: string, amount: string, options?: RouteQuoteOptions, toToken?: string) => Promise<RouteQuote[]>;
+/**
+ * `BigInt()` throws on anything that is not a decimal integer — "1.5", "abc",
+ * "1e18" — so a user typing into an amount field must not reach it. Only a
+ * positive base-unit integer is a quotable amount.
+ */
+declare function isPositiveIntegerAmount(amount: string): boolean;
+/** True when every field a quote needs is present and the amount is quotable. */
+declare function isQuotableInput(input: RouteQuoteInput): boolean;
+interface CostComparison {
+    chain: string;
+    chainName: string;
+    totalCost: string;
+    gasCost: string;
+    estimatedTimeMs: number;
+}
+type CostComparisonOperation = "send_erc20" | "swap" | "bridge" | (string & {});
+interface CostComparisonOptions {
+    amount?: string;
+    token?: string;
+    [key: string]: unknown;
+}
+interface CompareCostsInput {
+    operation: CostComparisonOperation;
+    chains: string[];
+    options?: CostComparisonOptions;
+}
+type CompareCosts = (operation: string, chains: string[], options?: CostComparisonOptions) => Promise<CostComparison[]>;
+/**
+ * Value key for a compare-costs input. `chains` is an array and `options` an
+ * object; keying on identity re-fired the fetch on every render/reactive tick
+ * for a caller writing the natural inline literal — an unbounded loop against
+ * a cost API.
+ */
+declare function compareCostsKey(input: CompareCostsInput): string;
+interface ExecutableQuote {
+    routeId: string;
+    provider: string;
+    totalCost?: bigint;
+    estimatedTimeMs?: number;
+    toChain?: string;
+}
+interface ExecuteRouteResult {
+    fromTxHash: string;
+    toTxHash?: string;
+}
+interface ExecuteRouteOptions {
+    timeoutMs?: number;
+    gasLimit?: bigint;
+}
+interface ExecuteRouteError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type ExecuteRoute = (quote: ExecutableQuote, recipient: string, options?: ExecuteRouteOptions) => Promise<ExecuteRouteResult>;
+/**
+ * Recipient check before a cross-chain execution. An empty recipient is wrong
+ * on every chain. Beyond that the destination namespace decides: when the
+ * quote names `toChain`, the address is validated for that namespace; when it
+ * does not, this returns null and the executor decides, rather than rejecting
+ * a valid non-EVM address on a guess.
+ */
+declare function validateRouteRecipient(quote: ExecutableQuote | null | undefined, recipient: string): ExecuteRouteError | null;
+/** Normalise whatever an executor threw into the hook's error shape. */
+declare function toExecuteRouteError(cause: unknown): ExecuteRouteError;
+
 declare function withTimeout<T>(promise: Promise<T>, ms: number, label?: string): Promise<T>;
 interface RetryOptions {
     maxRetries: number;
@@ -465,4 +607,4 @@ type Web3Action = {
 declare const initialWeb3State: Web3State;
 declare function web3Reducer(state: Web3State, action: Web3Action): Web3State;
 
-export { type AtomicSupport, type ChainCapabilities, type ChainInfo, type ConnectionStatus, type DecimalsCache, type RetryOptions, type SolanaIdentity, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, atomicSupportFor, chainNamespace, chainNumber, chainsForNamespace, createDecimalsCache, decodeRevertReason, describeChain, eip155ChainIdToNumber, getResolver, initialWeb3State, isEvmChainId, normalizeCapabilities, normalizeEip155ChainId, readDecimals, readSolanaRoles, resolveChain, resolveEvmChainId, resolveRevertReason, selectChainCapabilities, toChainSwitchError, toEip155Accounts, toViemChain, tokenChainMismatch, tokenKey, 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 DestinationIssue, type DestinationValidation, type ExecutableQuote, type ExecuteRoute, type ExecuteRouteError, type ExecuteRouteOptions, type ExecuteRouteResult, type GetRouteQuotes, NOTIFICATION_SETTINGS_KEY, type NotificationSettingsStorage, type RetryOptions, type RouteQuote, type RouteQuoteInput, type RouteQuoteOptions, type SolanaIdentity, type SolanaPayer, type SolanaRoles, type SolanaRolesAbsence, type SolanaRolesSource, type SolanaRolesState, type SolanaSigner, type SolanaWalletFeatures, type TokenIdentity, type ViemChainShape, type WalletChain, type Web3Action, type Web3State, __resetResolverForTests, addInAppNotification, atomicSupportFor, bareEvmAddress, chainNamespace, chainNumber, chainsForNamespace, channelsUpdate, clearOneInAppNotification, compareCostsKey, createDecimalsCache, createNotification, createNotificationSettingsStorage, decodeRevertReason, describeChain, eip155ChainIdToNumber, getResolver, initialWeb3State, isBurnDestination, isEvmChainId, isPositiveIntegerAmount, isQuotableInput, loadNotificationSettings, mutedChainSettings, normalizeCapabilities, normalizeEip155ChainId, readDecimals, readSolanaRoles, resolveChain, resolveEvmChainId, resolveRevertReason, saveNotificationSettings, selectChainCapabilities, toChainSwitchError, toEip155Accounts, toExecuteRouteError, toViemChain, tokenChainMismatch, tokenKey, updateNotificationSettings, validateDestination, validateRouteRecipient, web3Reducer, withRetry, withTimeout, writeDecimals };

package/dist/index.js

@@ -226,6 +226,172 @@ function __resetResolverForTests() {
   sharedResolver = null;
 }
 
+// src/notification.ts
+import {
+  createStorageAdapter
+} from "@naculus/connect-core";
+var NOTIFICATION_SETTINGS_KEY = "naculus_notif_react_settings";
+var DEFAULT_NOTIFICATION_SETTINGS = {
+  telegram: false,
+  webpush: false,
+  inapp: true,
+  frequency: "final-only",
+  mutedChains: [],
+  mutedTypes: []
+};
+function createNotificationSettingsStorage() {
+  const storage = createStorageAdapter("local", "naculus_notif_");
+  return {
+    getItem: async (key) => {
+      try {
+        return await storage.get(key);
+      } catch (cause) {
+        console.warn("useNotification: failed to read from storage:", cause);
+        return null;
+      }
+    },
+    setItem: async (key, value) => {
+      try {
+        await storage.set(key, value);
+      } catch (cause) {
+        console.warn("useNotification: failed to write to storage:", cause);
+      }
+    },
+    removeItem: async (key) => {
+      try {
+        await storage.remove(key);
+      } catch (cause) {
+        console.warn("useNotification: failed to remove from storage:", cause);
+      }
+    }
+  };
+}
+async function loadNotificationSettings(storage) {
+  return storage.getItem(NOTIFICATION_SETTINGS_KEY);
+}
+function saveNotificationSettings(storage, settings) {
+  storage.setItem(NOTIFICATION_SETTINGS_KEY, settings).catch(() => {
+  });
+}
+function updateNotificationSettings(current, update) {
+  return { ...current, ...update };
+}
+function channelsUpdate(channels) {
+  const update = {};
+  if (channels.includes("telegram")) update.telegram = true;
+  if (channels.includes("webpush")) update.webpush = true;
+  if (channels.includes("inapp")) update.inapp = true;
+  return update;
+}
+function mutedChainSettings(settings, chainId, muted) {
+  return {
+    mutedChains: muted ? [.../* @__PURE__ */ new Set([...settings.mutedChains, chainId])] : settings.mutedChains.filter((id) => id !== chainId)
+  };
+}
+function createNotification(item) {
+  return {
+    ...item,
+    id: `notif_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+    timestamp: Date.now()
+  };
+}
+function sendItem(channel, item) {
+  return channel.send({
+    id: item.id,
+    userId: "",
+    txHash: item.txHash,
+    chainId: "",
+    chainName: item.chainName,
+    status: item.status,
+    title: item.title,
+    body: item.body,
+    valueFormatted: item.valueFormatted,
+    explorerUrl: item.explorerUrl,
+    timestamp: item.timestamp
+  });
+}
+function addInAppNotification(channel, item) {
+  void sendItem(channel, createNotification(item));
+}
+async function clearOneInAppNotification(channel, id) {
+  const remaining = channel.getHistory().filter((item) => item.id !== id);
+  channel.clear();
+  await Promise.all(remaining.map((item) => sendItem(channel, item)));
+  return channel.getHistory();
+}
+
+// src/destination.ts
+import { isEvmAddress, isZeroAddress } from "@naculus/connect-core";
+var DEAD_ADDRESSES = /* @__PURE__ */ new Set([
+  "0x0000000000000000000000000000000000000001",
+  "0x000000000000000000000000000000000000dead"
+]);
+function isBurnDestination(address) {
+  const lower = address.toLowerCase();
+  return DEAD_ADDRESSES.has(lower) || lower.includes("dead");
+}
+function validateDestination(address) {
+  if (!address) return { isValid: false, level: "blocked", issue: "empty" };
+  if (!isEvmAddress(address)) {
+    return { isValid: false, level: "blocked", issue: "invalid_format" };
+  }
+  if (isZeroAddress(address)) {
+    return { isValid: false, level: "blocked", issue: "zero_address" };
+  }
+  if (isBurnDestination(address)) {
+    return { isValid: false, level: "blocked", issue: "burn_address" };
+  }
+  return { isValid: true, level: "ok", issue: null };
+}
+function bareEvmAddress(account) {
+  if (!account) return null;
+  const value = account.includes(":") ? account.split(":").pop() : account;
+  return value && isEvmAddress(value) ? value : null;
+}
+
+// src/routing.ts
+import { isValidAddress } from "@naculus/connect-core";
+function isPositiveIntegerAmount(amount) {
+  return /^(?:0|[1-9][0-9]*)$/.test(amount) && BigInt(amount) > 0n;
+}
+function isQuotableInput(input) {
+  return Boolean(
+    input.fromChain && input.toChain && input.fromToken && isPositiveIntegerAmount(input.amount)
+  );
+}
+function compareCostsKey(input) {
+  const options = input.options;
+  const optionsKey = options ? Object.keys(options).sort().map((key) => {
+    const value = options[key];
+    return `${key}=${typeof value === "object" && value !== null ? "[object]" : String(value)}`;
+  }).join("&") : "";
+  return `${input.operation}|${(input.chains ?? []).join(",")}|${optionsKey}`;
+}
+function validateRouteRecipient(quote, recipient) {
+  if (typeof recipient !== "string" || recipient.trim() === "") {
+    return {
+      code: "invalid_recipient",
+      message: "A recipient address is required"
+    };
+  }
+  const namespace = quote?.toChain?.split(":")[0];
+  if (namespace && !isValidAddress(recipient, namespace)) {
+    return {
+      code: "invalid_recipient",
+      message: `"${recipient}" is not a valid ${namespace} address for the destination chain ${quote?.toChain}`
+    };
+  }
+  return null;
+}
+function toExecuteRouteError(cause) {
+  const error = cause;
+  return {
+    code: error?.code ?? "execution_failed",
+    message: error?.message ?? String(cause),
+    details: error?.details
+  };
+}
+
 // src/web3-store.ts
 import { logger } from "@naculus/connect-core";
 function withTimeout(promise, ms, label = "Operation") {
@@ -315,18 +481,32 @@ function web3Reducer(state, action) {
   }
 }
 export {
+  DEFAULT_NOTIFICATION_SETTINGS,
+  NOTIFICATION_SETTINGS_KEY,
   __resetResolverForTests,
+  addInAppNotification,
   atomicSupportFor,
+  bareEvmAddress,
   chainNamespace,
   chainNumber,
   chainsForNamespace,
+  channelsUpdate,
+  clearOneInAppNotification,
+  compareCostsKey,
   createDecimalsCache,
+  createNotification,
+  createNotificationSettingsStorage,
   decodeRevertReason,
   describeChain,
   eip155ChainIdToNumber,
   getResolver,
   initialWeb3State,
+  isBurnDestination,
   isEvmChainId,
+  isPositiveIntegerAmount,
+  isQuotableInput,
+  loadNotificationSettings,
+  mutedChainSettings,
   normalizeCapabilities,
   normalizeEip155ChainId,
   readDecimals,
@@ -334,12 +514,17 @@ export {
   resolveChain,
   resolveEvmChainId,
   resolveRevertReason,
+  saveNotificationSettings,
   selectChainCapabilities,
   toChainSwitchError,
   toEip155Accounts,
+  toExecuteRouteError,
   toViemChain,
   tokenChainMismatch,
   tokenKey,
+  updateNotificationSettings,
+  validateDestination,
+  validateRouteRecipient,
   web3Reducer,
   withRetry,
   withTimeout,