@trustware/sdk-staging 1.1.5-staging.1 → 1.1.6-staging.2

package/dist/core-CVt6h8aW.d.ts

@@ -1,475 +0,0 @@
-import { C as ChainDef, c as ChainType, B as BalanceRow, a as BalanceStreamOptions, p as WalletAddressBalanceWrapper, W as WalletInterFaceAPI, v as WalletIdentity, J as walletManager, q as WalletAddressResolution } from './manager-tnJ6BGOZ.js';
-import { T as Token } from './types-BrVfNxND.js';
-
-declare enum TrustwareErrorCode {
-    INVALID_CONFIG = "INVALID_CONFIG",
-    INVALID_API_KEY = "INVALID_API_KEY",
-    WALLET_NOT_CONNECTED = "WALLET_NOT_CONNECTED",
-    BRIDGE_FAILED = "BRIDGE_FAILED",
-    NETWORK_ERROR = "NETWORK_ERROR",
-    UNKNOWN_ERROR = "UNKNOWN_ERROR",
-    INPUT_ERROR = "INPUT_ERROR"
-}
-
-declare class TrustwareError extends Error {
-    code: TrustwareErrorCode;
-    userMessage?: string;
-    cause?: unknown;
-    constructor(params: {
-        code: TrustwareErrorCode;
-        message: string;
-        userMessage?: string;
-        cause?: unknown;
-    });
-    toJSON(): {
-        name: string;
-        code: TrustwareErrorCode;
-        message: string;
-        userMessage: string | undefined;
-    };
-}
-
-type TrustwareWidgetTheme = {
-    primaryColor: string;
-    secondaryColor: string;
-    backgroundColor: string;
-    textColor: string;
-    borderColor: string;
-    radius: number;
-};
-type TrustwareWidgetMessages = {
-    title: string;
-    description: string;
-};
-declare const DEFAULT_THEME: TrustwareWidgetTheme;
-declare const DEFAULT_MESSAGES: TrustwareWidgetMessages;
-
-type BuildRouteBody = {
-    fromChain: string;
-    toChain: string;
-    fromToken: string;
-    toToken: string;
-    fromAmount: string;
-    fromAddress: string;
-    toAddress: string;
-    fromAmountUsd?: string;
-    fromAmountUSD?: string;
-    refundAddress?: string;
-    direction?: string;
-    slippage?: number;
-    slippageBps?: number;
-    linkId?: string;
-    memo?: string;
-};
-type TxRequest = {
-    to?: string;
-    target?: string;
-    data: string;
-    value?: string;
-    gasLimit?: string;
-    maxFeePerGas?: string;
-    maxPriorityFeePerGas?: string;
-    chainId?: number | string;
-    gasPrice?: string;
-};
-declare function buildRoute(body: BuildRouteBody, signal?: AbortSignal): Promise<{
-    intentId: string;
-    txReq: TxRequest;
-    actions: unknown[];
-    finalExchangeRate: {
-        fromAmountUSD?: string;
-        toAmountMinUSD?: string;
-    };
-    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 }?: {
-    intervalMs?: number | undefined;
-    timeoutMs?: number | undefined;
-}): Promise<Transaction>;
-
-type RouteParams = {
-    fromChain: string;
-    toChain: string;
-    fromToken: string;
-    toToken: string;
-    fromAmount: string | number;
-    fromAddress: string;
-    toAddress: string;
-    slippage?: number;
-};
-type RouteIntent = {
-    id: string;
-    fromChainId: string | number;
-    toChainId: string | number;
-    fromToken: string;
-    toToken: string;
-    fromAddress: string;
-    toAddress: string;
-    fromAmountWei: string | number;
-    quoteToAmountWei: string | number;
-    minToAmountWei: string | number;
-    requestId?: string;
-    routeRaw?: unknown;
-    status: "created" | "submitted" | "bridging" | "success" | "failed";
-    createdDate: Date | string;
-    updatedDate: Date | string;
-};
-type Transaction = {
-    id: string;
-    intentId: string;
-    fromAddress: string;
-    toAddress: string;
-    fromChainId: string | number;
-    toChainId: string | number;
-    sourceTxHash: string;
-    destTxHash: string;
-    requestId: string;
-    transactionRequest: unknown;
-    status: "submitted" | "bridging" | "success" | "failed";
-    statusRaw?: unknown;
-    routePath?: unknown;
-    routeStatus?: unknown;
-    toAmountWei?: string | number;
-    fromChainBlock: number;
-    toChainBlock: number;
-    fromChainTxUrl?: string;
-    toChainTxUrl?: string;
-    gasStatus?: string;
-    isGMPTransaction?: boolean;
-    axelarTransactionUrl?: string;
-    createdDate: Date | string;
-    updatedDate: Date | string;
-    timeSpentMs?: number;
-};
-type RouteEstimate = {
-    fromAmount?: string;
-    toAmount?: string;
-    toAmountMin?: string;
-    fromAmountUsd?: string;
-    toAmountUsd?: string;
-    totalFeesUsd?: string;
-    toAmountMinUsd?: string;
-    fees?: unknown[];
-};
-type RoutePlan = {
-    estimate?: RouteEstimate;
-    execution?: {
-        transaction?: TxRequest;
-    };
-    steps?: unknown[];
-    provider?: string;
-    requestId?: string;
-    reliabilityScore?: number;
-    diagnostics?: {
-        rawPayload?: unknown;
-    };
-};
-type BuildRouteResult = {
-    intentId: string;
-    txReq: TxRequest;
-    actions: unknown[];
-    finalExchangeRate: {
-        fromAmountUSD?: string;
-        toAmountMinUSD?: string;
-    };
-    route: RoutePlan | undefined;
-};
-
-type TrustwareEvent = {
-    type: "error";
-    error: TrustwareError;
-} | {
-    type: "transaction_started";
-} | {
-    type: "transaction_success";
-    txHash: string;
-    transaction?: Transaction;
-} | {
-    type: "wallet_connected";
-    address: string;
-} | {
-    type: "token_page_loaded";
-    chainRef: string;
-    query?: string;
-    count: number;
-    hasNextPage: boolean;
-    cursor?: string;
-} | {
-    type: "token_page_error";
-    chainRef: string;
-    query?: string;
-    cursor?: string;
-    message: string;
-} | {
-    type: "balance_stream_chunk";
-    address: string;
-    chunkSize: number;
-} | {
-    type: "balance_stream_fallback";
-    address: string;
-    message: string;
-};
-
-/** WalletConnect configuration options (all optional - SDK has built-in defaults) */
-type WalletConnectConfig = {
-    /** Override the built-in WalletConnect project ID (optional - SDK includes one) */
-    projectId?: string;
-    /** Chain IDs to support (defaults to [1] for Ethereum mainnet) */
-    chains?: number[];
-    /** Optional chain IDs (chains that can be switched to) */
-    optionalChains?: number[];
-    /** dApp metadata shown in wallet */
-    metadata?: {
-        name: string;
-        description?: string;
-        url: string;
-        icons?: string[];
-    };
-    /** Custom relay URL (defaults to WalletConnect's relay) */
-    relayUrl?: string;
-    /** Whether to show our custom QR modal (default: true) */
-    showQrModal?: boolean;
-    /** Disable WalletConnect entirely (default: false) */
-    disabled?: boolean;
-};
-/** Resolved WalletConnect config with defaults applied */
-type ResolvedWalletConnectConfig = {
-    projectId: string;
-    chains: number[];
-    optionalChains: number[];
-    metadata: {
-        name: string;
-        description: string;
-        url: string;
-        icons: string[];
-    };
-    relayUrl?: string;
-    showQrModal: boolean;
-};
-type TrustwareConfigOptions = {
-    apiKey: string;
-    routes: {
-        toChain: string;
-        toToken: string;
-        fromToken?: string;
-        fromAddress?: string;
-        toAddress?: string;
-        defaultSlippage?: number;
-        routeType?: string;
-        options?: {
-            routeRefreshMs?: number;
-            fixedFromAmount?: string | number;
-            minAmountOut?: string | number;
-            maxAmountOut?: string | number;
-        };
-    };
-    autoDetectProvider?: boolean;
-    theme?: TrustwareWidgetTheme;
-    messages?: Partial<TrustwareWidgetMessages>;
-    retry?: RetryConfig;
-    walletConnect?: WalletConnectConfig;
-    features?: FeatureFlags;
-    onError?: (error: TrustwareError) => void;
-    onSuccess?: (transaction: Transaction) => void;
-    onEvent?: (event: TrustwareEvent) => void;
-};
-type ResolvedTrustwareConfig = {
-    apiKey: string;
-    routes: {
-        toChain: string;
-        toToken: string;
-        fromToken?: string;
-        fromAddress?: string;
-        toAddress?: string;
-        defaultSlippage: number;
-        routeType: string;
-        options: {
-            routeRefreshMs?: number;
-            fixedFromAmount?: string | number;
-            minAmountOut?: string | number;
-            maxAmountOut?: string | number;
-        };
-    };
-    autoDetectProvider: boolean;
-    theme: TrustwareWidgetTheme;
-    messages: TrustwareWidgetMessages;
-    retry: ResolvedRetryConfig;
-    walletConnect?: ResolvedWalletConnectConfig | WalletConnectConfig | undefined;
-    features: ResolvedFeatureFlags;
-    onError?: (error: TrustwareError) => void;
-    onSuccess?: (transaction: Transaction) => void;
-    onEvent?: (event: TrustwareEvent) => void;
-};
-type FeatureFlags = {
-    tokensPagination?: boolean;
-    balanceStreaming?: boolean;
-    shouldAllowGA4?: boolean;
-};
-type ResolvedFeatureFlags = {
-    tokensPagination: boolean;
-    balanceStreaming: boolean;
-    shouldAllowGA4: boolean;
-};
-declare const DEFAULT_SLIPPAGE = 1;
-declare const DEFAULT_AUTO_DETECT_PROVIDER = false;
-type RateLimitInfo = {
-    /** Maximum requests allowed in the current window */
-    limit: number;
-    /** Requests remaining in the current window */
-    remaining: number;
-    /** Unix timestamp when the rate limit window resets */
-    reset: number;
-    /** Seconds until rate limit resets (only present on 429 responses) */
-    retryAfter?: number;
-};
-type RetryConfig = {
-    /** Enable automatic retry on 429 responses (default: true). Note: This does NOT disable backend rate limits, only client-side retry behavior. */
-    autoRetry?: boolean;
-    /** Maximum number of retries on 429 (default: 3) */
-    maxRetries?: number;
-    /** Base delay in ms for exponential backoff (default: 1000) */
-    baseDelayMs?: number;
-    /** Callback when rate limit info is received from server */
-    onRateLimitInfo?: (info: RateLimitInfo) => void;
-    /** Callback when rate limit is hit (429 received) */
-    onRateLimited?: (info: RateLimitInfo, retryCount: number) => void;
-    /** Callback when remaining requests fall below threshold */
-    onRateLimitApproaching?: (info: RateLimitInfo, threshold: number) => void;
-    /** Threshold for onRateLimitApproaching callback (default: 5) */
-    approachingThreshold?: number;
-};
-type ResolvedRetryConfig = {
-    autoRetry: boolean;
-    maxRetries: number;
-    baseDelayMs: number;
-    approachingThreshold: number;
-    onRateLimitInfo?: (info: RateLimitInfo) => void;
-    onRateLimited?: (info: RateLimitInfo, retryCount: number) => void;
-    onRateLimitApproaching?: (info: RateLimitInfo, threshold: number) => void;
-};
-declare const DEFAULT_RETRY_CONFIG: ResolvedRetryConfig;
-declare const DEFAULT_FEATURE_FLAGS: ResolvedFeatureFlags;
-
-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;
-
-/** 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, opts?: BalanceStreamOptions): Promise<WalletAddressBalanceWrapper[]>;
-declare function getBalancesByAddressStream(address: string, opts?: BalanceStreamOptions): AsyncGenerator<WalletAddressBalanceWrapper[], void, void>;
-
-declare function sendRouteTransaction(b: BuildRouteResult, fallbackChainId?: number | string): Promise<string>;
-declare function runTopUp(params: {
-    fromChain?: string;
-    toChain?: string;
-    fromToken?: string;
-    toToken?: string;
-    toAddress?: string;
-    fromAmount: string | number;
-}): Promise<Transaction>;
-
-interface UseChainsResult {
-    /** All available chains */
-    chains: ChainDef[];
-    /** Popular/featured chains (Ethereum, Polygon, Base) */
-    popularChains: ChainDef[];
-    /** Other chains (not in popular list) */
-    otherChains: ChainDef[];
-    /** Whether chains are currently loading */
-    isLoading: boolean;
-    /** Error message if loading failed */
-    error: string | null;
-    chainMap: Map<string, ChainDef>;
-}
-/**
- * Hook to load available chains from the registry.
- * Returns chains split into popular and other categories.
- */
-declare function useChains(): UseChainsResult;
-
-interface UseTokensResult {
-    /** All available tokens for the selected chain */
-    tokens: Token[];
-    /** Filtered tokens based on search query */
-    filteredTokens: Token[];
-    /** Whether tokens are currently loading */
-    isLoading: boolean;
-    /** Error message if loading failed */
-    error: string | null;
-    /** Current search query */
-    searchQuery: string;
-    /** Set the search query to filter tokens */
-    setSearchQuery: (query: string) => void;
-    /** Whether more tokens can be loaded for the active query */
-    hasNextPage: boolean;
-    /** Load the next token page when pagination is enabled */
-    loadMore: () => Promise<void>;
-    /** Whether an additional page request is in flight */
-    isLoadingMore: boolean;
-}
-declare function useTokens(chainId: string | number | null | undefined): UseTokensResult;
-
-declare const Trustware: {
-    /** Initialize config */
-    init(cfg: TrustwareConfigOptions): Promise</*elided*/ any>;
-    /** Attach a wallet interface directly (skips detection) */
-    useWallet(w: WalletInterFaceAPI): /*elided*/ any;
-    /** Best-effort background attach to detected wallet(s) (detection hook should be running in the app) */
-    autoDetect(_timeoutMs?: number): Promise<boolean>;
-    /** Read resolved config */
-    getConfig(): ResolvedTrustwareConfig;
-    setDestinationAddress(address?: string | null): /*elided*/ any;
-    setDestinationChain(chain: string): /*elided*/ any;
-    setDestinationToken(token: string): /*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;
-    getBalances: typeof getBalances;
-    getBalancesByAddress: typeof getBalancesByAddress;
-    getBalancesByAddressStream: typeof getBalancesByAddressStream;
-    useChains: typeof useChains;
-    useTokens: typeof useTokens;
-    validateAddressForChain: typeof validateAddressForChain;
-    validateRouteAddresses: typeof validateRouteAddresses;
-    sendRouteTransaction: typeof sendRouteTransaction;
-    runTopUp: typeof runTopUp;
-};
-type TrustwareCore = typeof Trustware;
-
-export { validateSolanaAddress as A, type BuildRouteResult as B, DEFAULT_AUTO_DETECT_PROVIDER as D, type FeatureFlags as F, type RateLimitInfo as R, type TrustwareConfigOptions as T, type WalletConnectConfig as W, Trustware as a, TrustwareError as b, type Transaction as c, type TrustwareEvent as d, DEFAULT_FEATURE_FLAGS as e, DEFAULT_MESSAGES as f, DEFAULT_RETRY_CONFIG as g, DEFAULT_SLIPPAGE as h, DEFAULT_THEME as i, type ResolvedFeatureFlags as j, type ResolvedRetryConfig as k, type ResolvedTrustwareConfig as l, type ResolvedWalletConnectConfig as m, type RetryConfig as n, type RouteEstimate as o, type RouteIntent as p, type RouteParams as q, type RoutePlan as r, type TrustwareCore as s, type TrustwareWidgetMessages as t, type TrustwareWidgetTheme as u, validateAddressForChain as v, validateBtcAddress as w, validateEvmAddress as x, validateRouteAddresses as y, validateSeiAddress as z };