@trustware/sdk-staging 1.0.17-staging.17 → 1.1.3-staging.20

package/README.md

@@ -14,6 +14,8 @@ The refactored widget keeps the same behavior, but the configuration surface is
 
 ## Installation
 
+Supports React `18.2+` and `19`.
+
 ```bash
 npm install @trustware/sdk
 # or
@@ -309,5 +311,6 @@ If retries are exhausted, the SDK throws `RateLimitError`.
 
 - [Integration Guide](docs/intergrationGuide.md)
 - [Core Guide](docs/coreGuide.md)
+- [Backend RPC Offload PDR](docs/backend-rpc-offload-pdr.md)
 - [Widget Architecture Boundaries](docs/widget-architecture-boundaries.md)
 - [Widget Refactor Baseline](docs/widget-refactor-baseline.md)

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.17";
+var SDK_VERSION = "1.1.3-staging.20";
 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.17";
+var SDK_VERSION = "1.1.3-staging.20";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var API_PREFIX = "/api";
 var ASSETS_BASE_URL = "https://app.trustware.io";

package/dist/{core-DXxIIFgy.d.cts → core-B0-MyOv6.d.cts}

@@ -1,4 +1,4 @@
-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.cjs';
+import { v as ChainDef, t as ChainType, B as BalanceRow, s as BalanceStreamOptions, n as WalletAddressBalanceWrapper, W as WalletInterFaceAPI, F as WalletIdentity, J as walletManager, G as WalletAddressResolution } from './manager-BPgytsNL.cjs';
 import { T as Token } from './types-BrVfNxND.cjs';
 
 declare enum TrustwareErrorCode {
@@ -199,6 +199,27 @@ type TrustwareEvent = {
 } | {
     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) */
@@ -259,6 +280,7 @@ type TrustwareConfigOptions = {
     messages?: Partial<TrustwareWidgetMessages>;
     retry?: RetryConfig;
     walletConnect?: WalletConnectConfig;
+    features?: FeatureFlags;
     onError?: (error: TrustwareError) => void;
     onSuccess?: (transaction: Transaction) => void;
     onEvent?: (event: TrustwareEvent) => void;
@@ -285,10 +307,19 @@ type ResolvedTrustwareConfig = {
     messages: TrustwareWidgetMessages;
     retry: ResolvedRetryConfig;
     walletConnect?: ResolvedWalletConnectConfig;
+    features: ResolvedFeatureFlags;
     onError?: (error: TrustwareError) => void;
     onSuccess?: (transaction: Transaction) => void;
     onEvent?: (event: TrustwareEvent) => void;
 };
+type FeatureFlags = {
+    tokensPagination?: boolean;
+    balanceStreaming?: boolean;
+};
+type ResolvedFeatureFlags = {
+    tokensPagination: boolean;
+    balanceStreaming: boolean;
+};
 declare const DEFAULT_SLIPPAGE = 1;
 declare const DEFAULT_AUTO_DETECT_PROVIDER = false;
 type RateLimitInfo = {
@@ -327,6 +358,7 @@ type ResolvedRetryConfig = {
     onRateLimitApproaching?: (info: RateLimitInfo, threshold: number) => void;
 };
 declare const DEFAULT_RETRY_CONFIG: ResolvedRetryConfig;
+declare const DEFAULT_FEATURE_FLAGS: ResolvedFeatureFlags;
 
 type AddressValidationResult = {
     isValid: boolean;
@@ -348,7 +380,8 @@ declare function validateRouteAddresses(params: {
 
 /** 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 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: {
@@ -392,12 +425,14 @@ interface UseTokensResult {
     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;
 }
-/**
- * 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 function useTokens(chainId: string | number | null | undefined): UseTokensResult;
 
 declare const Trustware: {
     /** Initialize config */
@@ -423,6 +458,7 @@ declare const Trustware: {
     pollStatus: typeof pollStatus;
     getBalances: typeof getBalances;
     getBalancesByAddress: typeof getBalancesByAddress;
+    getBalancesByAddressStream: typeof getBalancesByAddressStream;
     useChains: typeof useChains;
     useTokens: typeof useTokens;
     validateAddressForChain: typeof validateAddressForChain;
@@ -432,4 +468,4 @@ declare const Trustware: {
 };
 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 };
+export { DEFAULT_MESSAGES as A, type BuildRouteResult as B, DEFAULT_SLIPPAGE 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, 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, type ResolvedFeatureFlags as m, DEFAULT_AUTO_DETECT_PROVIDER as n, type RetryConfig as o, type ResolvedRetryConfig as p, DEFAULT_RETRY_CONFIG as q, DEFAULT_FEATURE_FLAGS as r, type RouteParams as s, type RouteIntent as t, type RouteEstimate as u, validateEvmAddress as v, type RoutePlan as w, type TrustwareWidgetTheme as x, type TrustwareWidgetMessages as y, DEFAULT_THEME as z };

package/dist/{core-DRDMS5t3.d.ts → core-qSEzIBWs.d.ts}

@@ -1,4 +1,4 @@
-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 { v as ChainDef, t as ChainType, B as BalanceRow, s as BalanceStreamOptions, n as WalletAddressBalanceWrapper, W as WalletInterFaceAPI, F as WalletIdentity, J as walletManager, G as WalletAddressResolution } from './manager-BPgytsNL.js';
 import { T as Token } from './types-BrVfNxND.js';
 
 declare enum TrustwareErrorCode {
@@ -199,6 +199,27 @@ type TrustwareEvent = {
 } | {
     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) */
@@ -259,6 +280,7 @@ type TrustwareConfigOptions = {
     messages?: Partial<TrustwareWidgetMessages>;
     retry?: RetryConfig;
     walletConnect?: WalletConnectConfig;
+    features?: FeatureFlags;
     onError?: (error: TrustwareError) => void;
     onSuccess?: (transaction: Transaction) => void;
     onEvent?: (event: TrustwareEvent) => void;
@@ -285,10 +307,19 @@ type ResolvedTrustwareConfig = {
     messages: TrustwareWidgetMessages;
     retry: ResolvedRetryConfig;
     walletConnect?: ResolvedWalletConnectConfig;
+    features: ResolvedFeatureFlags;
     onError?: (error: TrustwareError) => void;
     onSuccess?: (transaction: Transaction) => void;
     onEvent?: (event: TrustwareEvent) => void;
 };
+type FeatureFlags = {
+    tokensPagination?: boolean;
+    balanceStreaming?: boolean;
+};
+type ResolvedFeatureFlags = {
+    tokensPagination: boolean;
+    balanceStreaming: boolean;
+};
 declare const DEFAULT_SLIPPAGE = 1;
 declare const DEFAULT_AUTO_DETECT_PROVIDER = false;
 type RateLimitInfo = {
@@ -327,6 +358,7 @@ type ResolvedRetryConfig = {
     onRateLimitApproaching?: (info: RateLimitInfo, threshold: number) => void;
 };
 declare const DEFAULT_RETRY_CONFIG: ResolvedRetryConfig;
+declare const DEFAULT_FEATURE_FLAGS: ResolvedFeatureFlags;
 
 type AddressValidationResult = {
     isValid: boolean;
@@ -348,7 +380,8 @@ declare function validateRouteAddresses(params: {
 
 /** 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 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: {
@@ -392,12 +425,14 @@ interface UseTokensResult {
     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;
 }
-/**
- * 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 function useTokens(chainId: string | number | null | undefined): UseTokensResult;
 
 declare const Trustware: {
     /** Initialize config */
@@ -423,6 +458,7 @@ declare const Trustware: {
     pollStatus: typeof pollStatus;
     getBalances: typeof getBalances;
     getBalancesByAddress: typeof getBalancesByAddress;
+    getBalancesByAddressStream: typeof getBalancesByAddressStream;
     useChains: typeof useChains;
     useTokens: typeof useTokens;
     validateAddressForChain: typeof validateAddressForChain;
@@ -432,4 +468,4 @@ declare const Trustware: {
 };
 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 };
+export { DEFAULT_MESSAGES as A, type BuildRouteResult as B, DEFAULT_SLIPPAGE 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, 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, type ResolvedFeatureFlags as m, DEFAULT_AUTO_DETECT_PROVIDER as n, type RetryConfig as o, type ResolvedRetryConfig as p, DEFAULT_RETRY_CONFIG as q, DEFAULT_FEATURE_FLAGS as r, type RouteParams as s, type RouteIntent as t, type RouteEstimate as u, validateEvmAddress as v, type RoutePlan as w, type TrustwareWidgetTheme as x, type TrustwareWidgetMessages as y, DEFAULT_THEME as z };