@trustware/sdk-staging 1.0.17-staging.14 → 1.0.17-staging.15

package/dist/constants.cjs

@@ -29,7 +29,7 @@ __export(constants_exports, {
 });
 module.exports = __toCommonJS(constants_exports);
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.0.17-staging.14";
+var SDK_VERSION = "1.0.17-staging.15";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var API_PREFIX = "/api";
 var ASSETS_BASE_URL = "https://app.trustware.io";

package/dist/constants.mjs

@@ -1,6 +1,6 @@
 // src/constants.ts
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.0.17-staging.14";
+var SDK_VERSION = "1.0.17-staging.15";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var API_PREFIX = "/api";
 var ASSETS_BASE_URL = "https://app.trustware.io";

package/dist/core-DRDMS5t3.d.ts

@@ -0,0 +1,435 @@
+import { p as ChainDef, o as ChainType, B as BalanceRow, n as WalletAddressBalanceWrapper, W as WalletInterFaceAPI, x as WalletIdentity, A as walletManager, y as WalletAddressResolution } from './manager-CgpuAzqn.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;
+};
+
+/** 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;
+    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;
+    onError?: (error: TrustwareError) => void;
+    onSuccess?: (transaction: Transaction) => void;
+    onEvent?: (event: TrustwareEvent) => void;
+};
+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;
+
+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): Promise<WalletAddressBalanceWrapper[]>;
+
+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;
+}
+/**
+ * Hook to load available tokens for a selected chain from the registry.
+ * Supports filtering tokens by name or symbol.
+ */
+declare function useTokens(chainId: 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;
+    /** 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;
+    useChains: typeof useChains;
+    useTokens: typeof useTokens;
+    validateAddressForChain: typeof validateAddressForChain;
+    validateRouteAddresses: typeof validateRouteAddresses;
+    sendRouteTransaction: typeof sendRouteTransaction;
+    runTopUp: typeof runTopUp;
+};
+type TrustwareCore = typeof Trustware;
+
+export { type BuildRouteResult as B, DEFAULT_SLIPPAGE as D, 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, type TrustwareCore as e, validateSeiAddress as f, validateSolanaAddress as g, validateBtcAddress as h, validateAddressForChain as i, validateRouteAddresses as j, type ResolvedWalletConnectConfig as k, type ResolvedTrustwareConfig as l, DEFAULT_AUTO_DETECT_PROVIDER as m, type RetryConfig as n, type ResolvedRetryConfig as o, DEFAULT_RETRY_CONFIG as p, type RouteParams as q, type RouteIntent as r, type RouteEstimate as s, type RoutePlan as t, type TrustwareWidgetTheme as u, validateEvmAddress as v, type TrustwareWidgetMessages as w, DEFAULT_THEME as x, DEFAULT_MESSAGES as y };