@trustware/sdk-staging 1.0.16-staging.13 → 1.0.17-staging.14

package/dist/index.d.cts

@@ -54,8 +54,11 @@ type BuildRouteBody = {
     fromAddress: string;
     toAddress: string;
     fromAmountUsd?: string;
+    fromAmountUSD?: string;
     refundAddress?: string;
+    direction?: string;
     slippage?: number;
+    slippageBps?: number;
     linkId?: string;
     memo?: string;
 };
@@ -80,6 +83,16 @@ declare function buildRoute(body: BuildRouteBody, signal?: AbortSignal): Promise
     };
     route: RoutePlan | undefined;
 }>;
+declare function buildDepositAddress(body: BuildRouteBody, signal?: AbortSignal): Promise<{
+    intentId: string;
+    depositAddress: string;
+    actions: unknown[];
+    finalExchangeRate: {
+        fromAmountUSD?: string;
+        toAmountMinUSD?: string;
+    };
+    route: RoutePlan | undefined;
+}>;
 declare function submitReceipt(intentId: string, txHash: string): Promise<any>;
 declare function getStatus(intentId: string): Promise<Transaction>;
 declare function pollStatus(intentId: string, { intervalMs, timeoutMs }?: {
@@ -316,12 +329,14 @@ type ResolvedRetryConfig = {
 };
 declare const DEFAULT_RETRY_CONFIG: ResolvedRetryConfig;
 
-type WalletId = "metamask" | "coinbase" | "walletconnect" | "rainbow" | "phantom-evm" | "rabby" | "brave" | "okx" | "zerion" | "taho" | "safe" | "imtoken" | "trust" | "bitget" | "kucoin";
+type WalletId = "metamask" | "coinbase" | "walletconnect" | "rainbow" | "phantom-evm" | "phantom-solana" | "solflare" | "backpack" | "rabby" | "brave" | "okx" | "zerion" | "taho" | "safe" | "imtoken" | "trust" | "bitget" | "kucoin";
 type WalletCategory = "injected" | "walletconnect" | "app";
+type WalletEcosystem = "evm" | "solana" | "multi";
 type WalletMeta = {
     id: WalletId;
     name: string;
     category: WalletCategory;
+    ecosystem: WalletEcosystem;
     logo: string;
     emoji?: string;
     homepage?: string;
@@ -356,12 +371,37 @@ type EIP6963ProviderDetail = {
 };
 type DetectedWallet = {
     meta: WalletMeta;
-    via: "eip6963" | "injected-flag" | "walletconnect";
+    via: "eip6963" | "injected-flag" | "walletconnect" | "solana-window";
     detail?: EIP6963ProviderDetail;
     provider?: any;
 };
-type WalletInterFaceAPI = {
+type SolanaProviderLike = {
+    isPhantom?: boolean;
+    isSolflare?: boolean;
+    isBackpack?: boolean;
+    isConnected?: boolean;
+    publicKey?: {
+        toString(): string;
+    };
+    connect?: (options?: Record<string, unknown>) => Promise<unknown>;
+    disconnect?: () => Promise<void>;
+    signAndSendTransaction?: (transaction: unknown, options?: Record<string, unknown>) => Promise<{
+        signature?: string;
+    } | string>;
+    signTransaction?: (transaction: unknown) => Promise<{
+        serialize: () => Uint8Array;
+    }>;
+    on?: (event: string, listener: (...args: unknown[]) => void) => void;
+    off?: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeListener?: (event: string, listener: (...args: unknown[]) => void) => void;
+};
+type BaseWalletInterface = {
+    ecosystem: "evm" | "solana";
     getAddress(): Promise<string>;
+    disconnect?(): Promise<void>;
+};
+type EvmWalletInterface = BaseWalletInterface & {
+    ecosystem: "evm";
     getChainId(): Promise<number>;
     switchChain(chainId: number): Promise<void>;
 } & ({
@@ -381,10 +421,16 @@ type WalletInterFaceAPI = {
         hash: `0x${string}`;
     }>;
 });
+type SolanaWalletInterface = BaseWalletInterface & {
+    ecosystem: "solana";
+    type: "solana";
+    getChainKey(): Promise<string>;
+    sendSerializedTransaction(serializedTransactionBase64: string, rpcUrl?: string): Promise<string>;
+};
+type WalletInterFaceAPI = EvmWalletInterface | SolanaWalletInterface;
 type SimpleWalletInterface = {
     getAddress(): Promise<string>;
-    getChainId(): Promise<number>;
-    switchChain(chainId: number): Promise<void>;
+    disconnect?(): Promise<void>;
 };
 
 type ChainMeta = {
@@ -407,11 +453,14 @@ type TokenMeta = {
 type BalanceRow = {
     chain_key: string;
     category: "native" | "erc20" | "spl" | "btc";
-    contract?: `0x${string}`;
+    contract?: string;
+    address?: string;
     symbol?: string;
     decimals: number;
     balance: string;
     name?: string;
+    logoURI?: string;
+    usdPrice?: number;
 };
 type WalletAddressBalanceWrapper = {
     chain_id: string;
@@ -475,12 +524,121 @@ type TokenWithBalance = TokenDef & {
     balance?: bigint;
 };
 
-/** Map chainId -> backend chain_key and return balances */
-declare function getBalances(chainId: string | number, address: string): Promise<BalanceRow[]>;
+type WalletAddressSource = "provider" | "manual" | "imported";
+type WalletIdentityAddress = {
+    address: string;
+    chainType: ChainType;
+    chainKey?: string;
+    chainId?: string;
+    providerId?: string;
+    source: WalletAddressSource;
+};
+type WalletIdentity = {
+    addresses: WalletIdentityAddress[];
+};
+type WalletAddressResolution = {
+    status: "resolved";
+    address: string;
+    source: WalletAddressSource;
+    chainType: ChainType;
+    chainKey?: string;
+    chainId?: string;
+} | {
+    status: "missing" | "invalid";
+    reason: string;
+    address?: string;
+    source?: WalletAddressSource;
+    chainType?: ChainType;
+    chainKey?: string;
+    chainId?: string;
+};
+type WalletIdentityChainLike = ChainDef | ChainType | string | null;
+
+type WagmiConnector = {
+    /** Human label like "MetaMask", "WalletConnect" */
+    name: string;
+    /** Free-form type hint: "injected" | "walletConnect" | ... */
+    type?: string;
+};
+type WagmiBridge = {
+    /** Host app believes it’s connected (Wagmi state) */
+    isConnected(): boolean;
+    /** List of available connectors */
+    connectors(): WagmiConnector[];
+    /** Try connecting via a specific connector */
+    connect(connector: WagmiConnector): Promise<void>;
+    /** Disconnect current session */
+    disconnect(): Promise<void>;
+};
+
+declare function createWalletIdentity(addresses?: WalletIdentityAddress[]): WalletIdentity;
+declare function upsertWalletIdentityAddress(identity: WalletIdentity, next: WalletIdentityAddress): WalletIdentity;
+declare function resolveWalletAddressForChain(identity: WalletIdentity, chain?: WalletIdentityChainLike): WalletAddressResolution;
+declare function buildWalletIdentityAddress(params: {
+    address: string;
+    chain: WalletIdentityChainLike;
+    source: WalletAddressSource;
+    providerId?: string;
+}): WalletIdentityAddress | null;
+declare class IdentityStore {
+    private _identity;
+    get snapshot(): WalletIdentity;
+    reset(): void;
+    upsert(next: WalletIdentityAddress): WalletIdentity;
+    resolve(chain?: WalletIdentityChainLike): WalletAddressResolution;
+}
+
+type Status$1 = "idle" | "detecting" | "connecting" | "connected" | "error";
+type Listener = (s: Status$1) => void;
+declare class WalletManager {
+    private _status;
+    private _wallet;
+    private _detected;
+    private _listeners;
+    private _error;
+    private _identity;
+    private _providerCleanup;
+    private _connectedWalletId;
+    get status(): Status$1;
+    get error(): unknown;
+    get detected(): DetectedWallet[];
+    get wallet(): WalletInterFaceAPI | null;
+    get simple(): SimpleWalletInterface | null;
+    get identity(): WalletIdentity;
+    get connectedWalletId(): string | null;
+    onChange(fn: Listener): () => boolean;
+    private emit;
+    /** Provide detection results (from your hook or custom function). */
+    setDetected(list: DetectedWallet[]): void;
+    /** Optional: auto attach to the first/best detected wallet. */
+    autoAttach(opts?: {
+        wagmi?: WagmiBridge;
+        pick?: (list: DetectedWallet[]) => DetectedWallet | undefined;
+    }): Promise<void>;
+    connectDetected(target: DetectedWallet, opts?: {
+        wagmi?: WagmiBridge;
+    }): Promise<void>;
+    disconnect(wagmi?: WagmiBridge): Promise<void>;
+    /** Directly attach a pre-provided wallet interface (from old provider prop). */
+    attachWallet(api: WalletInterFaceAPI): void;
+    /** Optional helper to set explicit status (e.g., "initializing" UX). */
+    setStatus(s: Status$1): void;
+    addIdentityAddress(address: WalletIdentityAddress): void;
+    resolveAddressForChain(chain: Parameters<IdentityStore["resolve"]>[0]): WalletAddressResolution;
+    private clearProviderCleanup;
+    private clearConnectedWalletState;
+    private bindProviderEvents;
+    private syncIdentityFromWallet;
+}
+declare const walletManager: WalletManager;
+/** If you’re in React, call this once near your widget to push detection results into the manager. */
+declare function useWireDetectionIntoManager(): void;
+
+/** Map chain reference -> backend chain_key and return enriched balances */
+declare function getBalances(chainRef: string | number, address: string): Promise<BalanceRow[]>;
 declare function getBalancesByAddress(address: string): Promise<WalletAddressBalanceWrapper[]>;
 
-declare function sendRouteTransaction(b: BuildRouteResult, fallbackChainId?: number): Promise<`0x${string}`>;
-/** One-shot flow that mirrors your old runTopUp */
+declare function sendRouteTransaction(b: BuildRouteResult, fallbackChainId?: number | string): Promise<string>;
 declare function runTopUp(params: {
     fromChain?: string;
     toChain?: string;
@@ -554,6 +712,24 @@ interface UseTokensResult {
  */
 declare function useTokens(chainId: number | null | undefined): UseTokensResult;
 
+type AddressValidationResult = {
+    isValid: boolean;
+    error?: string;
+};
+declare function validateEvmAddress(address: string): AddressValidationResult;
+declare function validateSeiAddress(address: string): AddressValidationResult;
+declare function validateSolanaAddress(address: string): AddressValidationResult;
+declare function validateBtcAddress(address: string): AddressValidationResult;
+declare function validateAddressForChain(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
+declare function validateRouteAddresses(params: {
+    fromChain?: ChainDef | ChainType | string | null;
+    toChain?: ChainDef | ChainType | string | null;
+    fromAddress: string;
+    toAddress: string;
+    refundAddress?: string;
+    direction?: string;
+}): AddressValidationResult;
+
 declare const Trustware: {
     /** Initialize config */
     init(cfg: TrustwareConfigOptions): Promise</*elided*/ any>;
@@ -566,9 +742,13 @@ declare const Trustware: {
     setDestinationAddress(address?: string | null): /*elided*/ any;
     /** Read active wallet */
     getWallet(): WalletInterFaceAPI | null;
+    getIdentity(): WalletIdentity;
+    resolveAddressForChain(chain: Parameters<typeof walletManager.resolveAddressForChain>[0]): WalletAddressResolution;
+    addIdentityAddress(address: Parameters<typeof walletManager.addIdentityAddress>[0]): /*elided*/ any;
     /** Simple helpers */
     getAddress(): Promise<string>;
     buildRoute: typeof buildRoute;
+    buildDepositAddress: typeof buildDepositAddress;
     submitReceipt: typeof submitReceipt;
     getStatus: typeof getStatus;
     pollStatus: typeof pollStatus;
@@ -576,6 +756,8 @@ declare const Trustware: {
     getBalancesByAddress: typeof getBalancesByAddress;
     useChains: typeof useChains;
     useTokens: typeof useTokens;
+    validateAddressForChain: typeof validateAddressForChain;
+    validateRouteAddresses: typeof validateRouteAddresses;
     sendRouteTransaction: typeof sendRouteTransaction;
     runTopUp: typeof runTopUp;
 };
@@ -587,23 +769,6 @@ declare class RateLimitError extends Error {
     constructor(info: RateLimitInfo, retriesExhausted: boolean);
 }
 
-type WagmiConnector = {
-    /** Human label like "MetaMask", "WalletConnect" */
-    name: string;
-    /** Free-form type hint: "injected" | "walletConnect" | ... */
-    type?: string;
-};
-type WagmiBridge = {
-    /** Host app believes it’s connected (Wagmi state) */
-    isConnected(): boolean;
-    /** List of available connectors */
-    connectors(): WagmiConnector[];
-    /** Try connecting via a specific connector */
-    connect(connector: WagmiConnector): Promise<void>;
-    /** Disconnect current session */
-    disconnect(): Promise<void>;
-};
-
 /** Try wagmi bridge first (if provided), otherwise return EIP-1193 adapter. */
 declare function connectDetectedWallet(dw: DetectedWallet, opts?: {
     wagmi?: WagmiBridge;
@@ -613,9 +778,6 @@ declare function connectDetectedWallet(dw: DetectedWallet, opts?: {
     api: WalletInterFaceAPI | null;
 }>;
 
-/** If you’re in React, call this once near your widget to push detection results into the manager. */
-declare function useWireDetectionIntoManager(): void;
-
 declare function useEIP1193(eth: EIP1193): WalletInterFaceAPI;
 declare function useWagmi(client: any): WalletInterFaceAPI;
 
@@ -707,4 +869,4 @@ declare function TrustwareProvider({ config, wallet, autoDetect, children, }: {
 }): react_jsx_runtime.JSX.Element;
 declare function useTrustware(): Ctx;
 
-export { type BalanceRow, type BuildRouteResult, type ChainDef, type ChainMeta, type ChainType, DEFAULT_AUTO_DETECT_PROVIDER, DEFAULT_MESSAGES, DEFAULT_RETRY_CONFIG, DEFAULT_SLIPPAGE, DEFAULT_THEME, type DetectedWallet, type EIP1193, type EIP6963ProviderDetail, type NativeCurrency, RateLimitError, type RateLimitInfo, type ResolvedRetryConfig, type ResolvedTrustwareConfig, type ResolvedWalletConnectConfig, type RetryConfig, type RouteEstimate, type RouteIntent, type RouteParams, type RoutePlan, type SimpleWalletInterface, type TokenDef, type TokenMeta, type TokenType, type TokenWithBalance, type Transaction, Trustware, type TrustwareConfigOptions, type TrustwareCore, TrustwareError, TrustwareProvider, TrustwareWidgetV2 as TrustwareWidget, type TrustwareWidgetMessages, type TrustwareWidgetTheme, type WagmiBridge, type WagmiConnector, type WalletAddressBalanceWrapper, type WalletCategory, type WalletConnectConfig, type WalletId, type WalletInterFaceAPI, type WalletMeta, connectDetectedWallet, toWalletInterfaceFromDetected, useEIP1193, useTrustware, useWagmi, useWalletDetection, useWireDetectionIntoManager };
+export { type BalanceRow, type BuildRouteResult, type ChainDef, type ChainMeta, type ChainType, DEFAULT_AUTO_DETECT_PROVIDER, DEFAULT_MESSAGES, DEFAULT_RETRY_CONFIG, DEFAULT_SLIPPAGE, DEFAULT_THEME, type DetectedWallet, type EIP1193, type EIP6963ProviderDetail, type EvmWalletInterface, IdentityStore, type NativeCurrency, RateLimitError, type RateLimitInfo, type ResolvedRetryConfig, type ResolvedTrustwareConfig, type ResolvedWalletConnectConfig, type RetryConfig, type RouteEstimate, type RouteIntent, type RouteParams, type RoutePlan, type SimpleWalletInterface, type SolanaProviderLike, type SolanaWalletInterface, type TokenDef, type TokenMeta, type TokenType, type TokenWithBalance, type Transaction, Trustware, type TrustwareConfigOptions, type TrustwareCore, TrustwareError, TrustwareProvider, TrustwareWidgetV2 as TrustwareWidget, type TrustwareWidgetMessages, type TrustwareWidgetTheme, type WagmiBridge, type WagmiConnector, type WalletAddressBalanceWrapper, type WalletAddressResolution, type WalletAddressSource, type WalletCategory, type WalletConnectConfig, type WalletEcosystem, type WalletId, type WalletIdentity, type WalletIdentityAddress, type WalletIdentityChainLike, type WalletInterFaceAPI, type WalletMeta, buildWalletIdentityAddress, connectDetectedWallet, createWalletIdentity, resolveWalletAddressForChain, toWalletInterfaceFromDetected, upsertWalletIdentityAddress, useEIP1193, useTrustware, useWagmi, useWalletDetection, useWireDetectionIntoManager, validateAddressForChain, validateBtcAddress, validateEvmAddress, validateRouteAddresses, validateSeiAddress, validateSolanaAddress };

package/dist/index.d.ts

@@ -54,8 +54,11 @@ type BuildRouteBody = {
     fromAddress: string;
     toAddress: string;
     fromAmountUsd?: string;
+    fromAmountUSD?: string;
     refundAddress?: string;
+    direction?: string;
     slippage?: number;
+    slippageBps?: number;
     linkId?: string;
     memo?: string;
 };
@@ -80,6 +83,16 @@ declare function buildRoute(body: BuildRouteBody, signal?: AbortSignal): Promise
     };
     route: RoutePlan | undefined;
 }>;
+declare function buildDepositAddress(body: BuildRouteBody, signal?: AbortSignal): Promise<{
+    intentId: string;
+    depositAddress: string;
+    actions: unknown[];
+    finalExchangeRate: {
+        fromAmountUSD?: string;
+        toAmountMinUSD?: string;
+    };
+    route: RoutePlan | undefined;
+}>;
 declare function submitReceipt(intentId: string, txHash: string): Promise<any>;
 declare function getStatus(intentId: string): Promise<Transaction>;
 declare function pollStatus(intentId: string, { intervalMs, timeoutMs }?: {
@@ -316,12 +329,14 @@ type ResolvedRetryConfig = {
 };
 declare const DEFAULT_RETRY_CONFIG: ResolvedRetryConfig;
 
-type WalletId = "metamask" | "coinbase" | "walletconnect" | "rainbow" | "phantom-evm" | "rabby" | "brave" | "okx" | "zerion" | "taho" | "safe" | "imtoken" | "trust" | "bitget" | "kucoin";
+type WalletId = "metamask" | "coinbase" | "walletconnect" | "rainbow" | "phantom-evm" | "phantom-solana" | "solflare" | "backpack" | "rabby" | "brave" | "okx" | "zerion" | "taho" | "safe" | "imtoken" | "trust" | "bitget" | "kucoin";
 type WalletCategory = "injected" | "walletconnect" | "app";
+type WalletEcosystem = "evm" | "solana" | "multi";
 type WalletMeta = {
     id: WalletId;
     name: string;
     category: WalletCategory;
+    ecosystem: WalletEcosystem;
     logo: string;
     emoji?: string;
     homepage?: string;
@@ -356,12 +371,37 @@ type EIP6963ProviderDetail = {
 };
 type DetectedWallet = {
     meta: WalletMeta;
-    via: "eip6963" | "injected-flag" | "walletconnect";
+    via: "eip6963" | "injected-flag" | "walletconnect" | "solana-window";
     detail?: EIP6963ProviderDetail;
     provider?: any;
 };
-type WalletInterFaceAPI = {
+type SolanaProviderLike = {
+    isPhantom?: boolean;
+    isSolflare?: boolean;
+    isBackpack?: boolean;
+    isConnected?: boolean;
+    publicKey?: {
+        toString(): string;
+    };
+    connect?: (options?: Record<string, unknown>) => Promise<unknown>;
+    disconnect?: () => Promise<void>;
+    signAndSendTransaction?: (transaction: unknown, options?: Record<string, unknown>) => Promise<{
+        signature?: string;
+    } | string>;
+    signTransaction?: (transaction: unknown) => Promise<{
+        serialize: () => Uint8Array;
+    }>;
+    on?: (event: string, listener: (...args: unknown[]) => void) => void;
+    off?: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeListener?: (event: string, listener: (...args: unknown[]) => void) => void;
+};
+type BaseWalletInterface = {
+    ecosystem: "evm" | "solana";
     getAddress(): Promise<string>;
+    disconnect?(): Promise<void>;
+};
+type EvmWalletInterface = BaseWalletInterface & {
+    ecosystem: "evm";
     getChainId(): Promise<number>;
     switchChain(chainId: number): Promise<void>;
 } & ({
@@ -381,10 +421,16 @@ type WalletInterFaceAPI = {
         hash: `0x${string}`;
     }>;
 });
+type SolanaWalletInterface = BaseWalletInterface & {
+    ecosystem: "solana";
+    type: "solana";
+    getChainKey(): Promise<string>;
+    sendSerializedTransaction(serializedTransactionBase64: string, rpcUrl?: string): Promise<string>;
+};
+type WalletInterFaceAPI = EvmWalletInterface | SolanaWalletInterface;
 type SimpleWalletInterface = {
     getAddress(): Promise<string>;
-    getChainId(): Promise<number>;
-    switchChain(chainId: number): Promise<void>;
+    disconnect?(): Promise<void>;
 };
 
 type ChainMeta = {
@@ -407,11 +453,14 @@ type TokenMeta = {
 type BalanceRow = {
     chain_key: string;
     category: "native" | "erc20" | "spl" | "btc";
-    contract?: `0x${string}`;
+    contract?: string;
+    address?: string;
     symbol?: string;
     decimals: number;
     balance: string;
     name?: string;
+    logoURI?: string;
+    usdPrice?: number;
 };
 type WalletAddressBalanceWrapper = {
     chain_id: string;
@@ -475,12 +524,121 @@ type TokenWithBalance = TokenDef & {
     balance?: bigint;
 };
 
-/** Map chainId -> backend chain_key and return balances */
-declare function getBalances(chainId: string | number, address: string): Promise<BalanceRow[]>;
+type WalletAddressSource = "provider" | "manual" | "imported";
+type WalletIdentityAddress = {
+    address: string;
+    chainType: ChainType;
+    chainKey?: string;
+    chainId?: string;
+    providerId?: string;
+    source: WalletAddressSource;
+};
+type WalletIdentity = {
+    addresses: WalletIdentityAddress[];
+};
+type WalletAddressResolution = {
+    status: "resolved";
+    address: string;
+    source: WalletAddressSource;
+    chainType: ChainType;
+    chainKey?: string;
+    chainId?: string;
+} | {
+    status: "missing" | "invalid";
+    reason: string;
+    address?: string;
+    source?: WalletAddressSource;
+    chainType?: ChainType;
+    chainKey?: string;
+    chainId?: string;
+};
+type WalletIdentityChainLike = ChainDef | ChainType | string | null;
+
+type WagmiConnector = {
+    /** Human label like "MetaMask", "WalletConnect" */
+    name: string;
+    /** Free-form type hint: "injected" | "walletConnect" | ... */
+    type?: string;
+};
+type WagmiBridge = {
+    /** Host app believes it’s connected (Wagmi state) */
+    isConnected(): boolean;
+    /** List of available connectors */
+    connectors(): WagmiConnector[];
+    /** Try connecting via a specific connector */
+    connect(connector: WagmiConnector): Promise<void>;
+    /** Disconnect current session */
+    disconnect(): Promise<void>;
+};
+
+declare function createWalletIdentity(addresses?: WalletIdentityAddress[]): WalletIdentity;
+declare function upsertWalletIdentityAddress(identity: WalletIdentity, next: WalletIdentityAddress): WalletIdentity;
+declare function resolveWalletAddressForChain(identity: WalletIdentity, chain?: WalletIdentityChainLike): WalletAddressResolution;
+declare function buildWalletIdentityAddress(params: {
+    address: string;
+    chain: WalletIdentityChainLike;
+    source: WalletAddressSource;
+    providerId?: string;
+}): WalletIdentityAddress | null;
+declare class IdentityStore {
+    private _identity;
+    get snapshot(): WalletIdentity;
+    reset(): void;
+    upsert(next: WalletIdentityAddress): WalletIdentity;
+    resolve(chain?: WalletIdentityChainLike): WalletAddressResolution;
+}
+
+type Status$1 = "idle" | "detecting" | "connecting" | "connected" | "error";
+type Listener = (s: Status$1) => void;
+declare class WalletManager {
+    private _status;
+    private _wallet;
+    private _detected;
+    private _listeners;
+    private _error;
+    private _identity;
+    private _providerCleanup;
+    private _connectedWalletId;
+    get status(): Status$1;
+    get error(): unknown;
+    get detected(): DetectedWallet[];
+    get wallet(): WalletInterFaceAPI | null;
+    get simple(): SimpleWalletInterface | null;
+    get identity(): WalletIdentity;
+    get connectedWalletId(): string | null;
+    onChange(fn: Listener): () => boolean;
+    private emit;
+    /** Provide detection results (from your hook or custom function). */
+    setDetected(list: DetectedWallet[]): void;
+    /** Optional: auto attach to the first/best detected wallet. */
+    autoAttach(opts?: {
+        wagmi?: WagmiBridge;
+        pick?: (list: DetectedWallet[]) => DetectedWallet | undefined;
+    }): Promise<void>;
+    connectDetected(target: DetectedWallet, opts?: {
+        wagmi?: WagmiBridge;
+    }): Promise<void>;
+    disconnect(wagmi?: WagmiBridge): Promise<void>;
+    /** Directly attach a pre-provided wallet interface (from old provider prop). */
+    attachWallet(api: WalletInterFaceAPI): void;
+    /** Optional helper to set explicit status (e.g., "initializing" UX). */
+    setStatus(s: Status$1): void;
+    addIdentityAddress(address: WalletIdentityAddress): void;
+    resolveAddressForChain(chain: Parameters<IdentityStore["resolve"]>[0]): WalletAddressResolution;
+    private clearProviderCleanup;
+    private clearConnectedWalletState;
+    private bindProviderEvents;
+    private syncIdentityFromWallet;
+}
+declare const walletManager: WalletManager;
+/** If you’re in React, call this once near your widget to push detection results into the manager. */
+declare function useWireDetectionIntoManager(): void;
+
+/** Map chain reference -> backend chain_key and return enriched balances */
+declare function getBalances(chainRef: string | number, address: string): Promise<BalanceRow[]>;
 declare function getBalancesByAddress(address: string): Promise<WalletAddressBalanceWrapper[]>;
 
-declare function sendRouteTransaction(b: BuildRouteResult, fallbackChainId?: number): Promise<`0x${string}`>;
-/** One-shot flow that mirrors your old runTopUp */
+declare function sendRouteTransaction(b: BuildRouteResult, fallbackChainId?: number | string): Promise<string>;
 declare function runTopUp(params: {
     fromChain?: string;
     toChain?: string;
@@ -554,6 +712,24 @@ interface UseTokensResult {
  */
 declare function useTokens(chainId: number | null | undefined): UseTokensResult;
 
+type AddressValidationResult = {
+    isValid: boolean;
+    error?: string;
+};
+declare function validateEvmAddress(address: string): AddressValidationResult;
+declare function validateSeiAddress(address: string): AddressValidationResult;
+declare function validateSolanaAddress(address: string): AddressValidationResult;
+declare function validateBtcAddress(address: string): AddressValidationResult;
+declare function validateAddressForChain(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
+declare function validateRouteAddresses(params: {
+    fromChain?: ChainDef | ChainType | string | null;
+    toChain?: ChainDef | ChainType | string | null;
+    fromAddress: string;
+    toAddress: string;
+    refundAddress?: string;
+    direction?: string;
+}): AddressValidationResult;
+
 declare const Trustware: {
     /** Initialize config */
     init(cfg: TrustwareConfigOptions): Promise</*elided*/ any>;
@@ -566,9 +742,13 @@ declare const Trustware: {
     setDestinationAddress(address?: string | null): /*elided*/ any;
     /** Read active wallet */
     getWallet(): WalletInterFaceAPI | null;
+    getIdentity(): WalletIdentity;
+    resolveAddressForChain(chain: Parameters<typeof walletManager.resolveAddressForChain>[0]): WalletAddressResolution;
+    addIdentityAddress(address: Parameters<typeof walletManager.addIdentityAddress>[0]): /*elided*/ any;
     /** Simple helpers */
     getAddress(): Promise<string>;
     buildRoute: typeof buildRoute;
+    buildDepositAddress: typeof buildDepositAddress;
     submitReceipt: typeof submitReceipt;
     getStatus: typeof getStatus;
     pollStatus: typeof pollStatus;
@@ -576,6 +756,8 @@ declare const Trustware: {
     getBalancesByAddress: typeof getBalancesByAddress;
     useChains: typeof useChains;
     useTokens: typeof useTokens;
+    validateAddressForChain: typeof validateAddressForChain;
+    validateRouteAddresses: typeof validateRouteAddresses;
     sendRouteTransaction: typeof sendRouteTransaction;
     runTopUp: typeof runTopUp;
 };
@@ -587,23 +769,6 @@ declare class RateLimitError extends Error {
     constructor(info: RateLimitInfo, retriesExhausted: boolean);
 }
 
-type WagmiConnector = {
-    /** Human label like "MetaMask", "WalletConnect" */
-    name: string;
-    /** Free-form type hint: "injected" | "walletConnect" | ... */
-    type?: string;
-};
-type WagmiBridge = {
-    /** Host app believes it’s connected (Wagmi state) */
-    isConnected(): boolean;
-    /** List of available connectors */
-    connectors(): WagmiConnector[];
-    /** Try connecting via a specific connector */
-    connect(connector: WagmiConnector): Promise<void>;
-    /** Disconnect current session */
-    disconnect(): Promise<void>;
-};
-
 /** Try wagmi bridge first (if provided), otherwise return EIP-1193 adapter. */
 declare function connectDetectedWallet(dw: DetectedWallet, opts?: {
     wagmi?: WagmiBridge;
@@ -613,9 +778,6 @@ declare function connectDetectedWallet(dw: DetectedWallet, opts?: {
     api: WalletInterFaceAPI | null;
 }>;
 
-/** If you’re in React, call this once near your widget to push detection results into the manager. */
-declare function useWireDetectionIntoManager(): void;
-
 declare function useEIP1193(eth: EIP1193): WalletInterFaceAPI;
 declare function useWagmi(client: any): WalletInterFaceAPI;
 
@@ -707,4 +869,4 @@ declare function TrustwareProvider({ config, wallet, autoDetect, children, }: {
 }): react_jsx_runtime.JSX.Element;
 declare function useTrustware(): Ctx;
 
-export { type BalanceRow, type BuildRouteResult, type ChainDef, type ChainMeta, type ChainType, DEFAULT_AUTO_DETECT_PROVIDER, DEFAULT_MESSAGES, DEFAULT_RETRY_CONFIG, DEFAULT_SLIPPAGE, DEFAULT_THEME, type DetectedWallet, type EIP1193, type EIP6963ProviderDetail, type NativeCurrency, RateLimitError, type RateLimitInfo, type ResolvedRetryConfig, type ResolvedTrustwareConfig, type ResolvedWalletConnectConfig, type RetryConfig, type RouteEstimate, type RouteIntent, type RouteParams, type RoutePlan, type SimpleWalletInterface, type TokenDef, type TokenMeta, type TokenType, type TokenWithBalance, type Transaction, Trustware, type TrustwareConfigOptions, type TrustwareCore, TrustwareError, TrustwareProvider, TrustwareWidgetV2 as TrustwareWidget, type TrustwareWidgetMessages, type TrustwareWidgetTheme, type WagmiBridge, type WagmiConnector, type WalletAddressBalanceWrapper, type WalletCategory, type WalletConnectConfig, type WalletId, type WalletInterFaceAPI, type WalletMeta, connectDetectedWallet, toWalletInterfaceFromDetected, useEIP1193, useTrustware, useWagmi, useWalletDetection, useWireDetectionIntoManager };
+export { type BalanceRow, type BuildRouteResult, type ChainDef, type ChainMeta, type ChainType, DEFAULT_AUTO_DETECT_PROVIDER, DEFAULT_MESSAGES, DEFAULT_RETRY_CONFIG, DEFAULT_SLIPPAGE, DEFAULT_THEME, type DetectedWallet, type EIP1193, type EIP6963ProviderDetail, type EvmWalletInterface, IdentityStore, type NativeCurrency, RateLimitError, type RateLimitInfo, type ResolvedRetryConfig, type ResolvedTrustwareConfig, type ResolvedWalletConnectConfig, type RetryConfig, type RouteEstimate, type RouteIntent, type RouteParams, type RoutePlan, type SimpleWalletInterface, type SolanaProviderLike, type SolanaWalletInterface, type TokenDef, type TokenMeta, type TokenType, type TokenWithBalance, type Transaction, Trustware, type TrustwareConfigOptions, type TrustwareCore, TrustwareError, TrustwareProvider, TrustwareWidgetV2 as TrustwareWidget, type TrustwareWidgetMessages, type TrustwareWidgetTheme, type WagmiBridge, type WagmiConnector, type WalletAddressBalanceWrapper, type WalletAddressResolution, type WalletAddressSource, type WalletCategory, type WalletConnectConfig, type WalletEcosystem, type WalletId, type WalletIdentity, type WalletIdentityAddress, type WalletIdentityChainLike, type WalletInterFaceAPI, type WalletMeta, buildWalletIdentityAddress, connectDetectedWallet, createWalletIdentity, resolveWalletAddressForChain, toWalletInterfaceFromDetected, upsertWalletIdentityAddress, useEIP1193, useTrustware, useWagmi, useWalletDetection, useWireDetectionIntoManager, validateAddressForChain, validateBtcAddress, validateEvmAddress, validateRouteAddresses, validateSeiAddress, validateSolanaAddress };