@avalabs/fusion-sdk 0.16.0 → 0.18.0

package/dist/types/service.d.cts

@@ -1,12 +1,14 @@
 import { Caip2ChainId } from "./caip.cjs";
 import { BitcoinFunctions } from "./bitcoin.cjs";
 import { FeeRateTier } from "./fee.cjs";
-import { EVM_SERVICE_TYPES, ServiceType } from "../constants.cjs";
-import { Asset, BridgeableUiAsset, ChainAssetMap, NativeAsset } from "./asset.cjs";
+import { AvalancheBlockchainAlias, EVM_SERVICE_TYPES, ServiceType } from "../constants.cjs";
+import { Asset, AssetWithExtras, BridgeableUiAsset, ChainAssetMap, NativeAsset } from "./asset.cjs";
 import { Quote, QuoterProps, ServiceQuoteEventHandler } from "./quote.cjs";
+import { ArrayElement } from "./utility-types.cjs";
+import { GetAtomicUtxosCallback, GetCoreEthAddressCallback, GetUtxosCallback, GetWalletAddressesForChainAliasCallback, GetWalletChangeAddressForChainAliasCallback } from "../transfer-service/avalanche-cct/types.cjs";
 import { Transfer, TransferStepDetails } from "./transfer.cjs";
 import { BtcSigner, EvmSigner, EvmSignerWithMessage, SolanaSigner } from "./signer.cjs";
-import { ArrayElement } from "./utility-types.cjs";
+import { UnsignedTx } from "@avalabs/avalanchejs";
 
 //#region src/types/service.d.ts
 /** Optional EIP-1559-style gas settings. */
@@ -121,11 +123,40 @@ interface EstimateNativeFeeOptions {
     maxPriorityFeePerGas?: bigint;
   }>;
 }
+/**
+* Asset search input used by bridgeable-assets queries.
+*
+* - `type: 'address'` means `value` is matched as an on-chain asset address.
+* - `type: 'keyword'` means `value` is matched against asset name/symbol text.
+*/
+interface AssetSearchQuery {
+  readonly type: "address" | "keyword";
+  readonly value: string;
+}
 interface GetBridgeableAssetsProps {
+  /** Maximum number of assets requested per page. Must be a positive integer. */
+  readonly limit?: number;
+  /** 1-based page index for service-level pagination. */
+  readonly page?: number;
+  /**
+  * Optional query used to search by address or keyword (name/symbol).
+  * Currently, search filtering is only applied by the Markr service.
+  */
+  readonly search?: AssetSearchQuery;
   readonly sourceAsset: Asset;
   readonly sourceChainId: Caip2ChainId;
   readonly targetChainId: Caip2ChainId;
 }
+interface GetBridgeableAssetsResult {
+  /** Assets for the requested page. */
+  readonly assets: readonly BridgeableUiAsset[];
+  /** Service pagination metadata for this response page. */
+  readonly meta: {
+    readonly currentPage: number;
+    readonly hasMore: boolean;
+    readonly nextPage?: number;
+  };
+}
 /**
 * Mapping of services supported chains, and their corresponding supported destination chains.
 */
@@ -165,12 +196,62 @@ interface TransferService {
     result: Promise<Transfer>;
   };
   /** Return assets receivable on targetChainId for the given source, via this service. */
-  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<readonly BridgeableUiAsset[]>;
+  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<GetBridgeableAssetsResult>;
   /** Execute the quote, emitting `onStepChange` for signature steps. */
   transferAsset(props: TransferAssetProps): Promise<Transfer>;
   /** Concrete discriminator for this service. */
   type: ServiceType;
 }
+type AvalancheSendTxParams = {
+  baseFeeInNanoAvax: bigint;
+  chainAlias: AvalancheBlockchainAlias;
+  txType: "export" | "import";
+  unsignedTx: UnsignedTx;
+};
+type AvalancheSendTxFunction = (params: AvalancheSendTxParams) => Promise<string>;
+type AvalancheCctInitializer = {
+  type: ServiceType.AVALANCHE_CCT;
+  /**
+  * Sends a fully built Avalanche export/import transaction and returns its transaction hash.
+  *
+  * You must implement signing and broadcasting on your side using the connected wallet/account
+  * for the provided chain alias.
+  */
+  avalancheSendTx: AvalancheSendTxFunction;
+  /**
+  * Maps an EVM C-Chain hex address (for example `0x...`) to the equivalent Coreth bech32 address.
+  *
+  * You must provide the address conversion from your wallet/provider stack so the SDK can route
+  * C-Chain imports/exports that require bech32 address format.
+  */
+  getCoreEthAddress: GetCoreEthAddressCallback;
+  /**
+  * Returns atomic UTXOs that are pending import into `destinationChain` from `sourceChain`.
+  *
+  * You must query Avalanche APIs/wallet state and return only currently importable atomic UTXOs
+  * for the specified source/destination chain pair.
+  */
+  getAtomicUtxos: GetAtomicUtxosCallback;
+  /**
+  * Returns spendable UTXOs for the provided P-Chain or X-Chain alias.
+  *
+  * You must load the wallet's current UTXO set for that chain so export transactions can be built.
+  */
+  getUtxos: GetUtxosCallback;
+  /**
+  * Returns addresses on the provided chain alias that are controlled by the connected wallet.
+  *
+  * You must provide all wallet-owned addresses relevant for transaction input ownership/signing checks.
+  */
+  getWalletAddressesForChainAlias: GetWalletAddressesForChainAliasCallback;
+  /**
+  * Returns the change address for the provided chain alias.
+  *
+  * You must return a valid wallet-controlled address that should receive change outputs
+  * when UTXO-based transactions are constructed.
+  */
+  getWalletChangeAddressForChainAlias: GetWalletChangeAddressForChainAliasCallback;
+};
 /** EVM-family service initializer. */
 type EvmServiceInitializer = {
   type: ArrayElement<typeof EVM_SERVICE_TYPES>;
@@ -186,6 +267,11 @@ type LombardServiceInitializer = {
 /** Markr initializer (swaps, cross-chain swaps). */
 type MarkrServiceInitializer = {
   type: ServiceType.MARKR;
+  /**
+  * EVM signer. Wire up `signTypedData` on the signer to enable Hyperliquid
+  * 2-phase withdrawals; otherwise a plain {@link EvmSigner} is sufficient
+  * for non-HL EVM swaps and bridges.
+  */
   evmSigner: EvmSigner;
   markrApiUrl?: string;
   markrApiToken?: string;
@@ -200,10 +286,23 @@ type MarkrServiceInitializer = {
   * Returns the assets available to receive on targetChainId via Markr cross-chain swaps.
   * The SDK calls this during getBridgeableAssets.
   * Similar to the bitcoinFunctions pattern, this decouples the SDK from any specific token registry.
+  * Any provider-specific metadata can be supplied via BridgeableAsset.extras and is passed through to consumers.
   */
-  getTargetChainAssets: (targetChainId: Caip2ChainId) => Promise<readonly Asset[]>;
+  getTargetChainAssets: (queryProps: {
+    /** Optional query used to search by address or keyword (name/symbol). */search?: AssetSearchQuery;
+    limit: number;
+    page: number;
+    targetChainId: Caip2ChainId;
+  }) => Promise<{
+    readonly assets: readonly AssetWithExtras[];
+    readonly meta: {
+      readonly currentPage: number;
+      readonly hasMore: boolean;
+      readonly nextPage: number | undefined;
+    };
+  }>;
 };
-type ServiceInitializer = EvmServiceInitializer | LombardServiceInitializer | MarkrServiceInitializer;
+type ServiceInitializer = AvalancheCctInitializer | EvmServiceInitializer | LombardServiceInitializer | MarkrServiceInitializer;
 //#endregion
-export { EstimateNativeFeeOptions, EvmServiceInitializer, GasSettings, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, LombardServiceInitializer, MarkrServiceInitializer, MutableGetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps, TransferService };
+export { AssetSearchQuery, AvalancheCctInitializer, AvalancheSendTxFunction, AvalancheSendTxParams, EstimateNativeFeeOptions, EvmServiceInitializer, GasSettings, GetBridgeableAssetsProps, GetBridgeableAssetsResult, GetMinimumTransferAmountProps, GetSupportedChainsResult, LombardServiceInitializer, MarkrServiceInitializer, MutableGetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps, TransferService };
 //# sourceMappingURL=service.d.cts.map

package/dist/types/service.d.ts

@@ -1,12 +1,14 @@
 import { Caip2ChainId } from "./caip.js";
 import { BitcoinFunctions } from "./bitcoin.js";
 import { FeeRateTier } from "./fee.js";
-import { EVM_SERVICE_TYPES, ServiceType } from "../constants.js";
-import { Asset, BridgeableUiAsset, ChainAssetMap, NativeAsset } from "./asset.js";
+import { AvalancheBlockchainAlias, EVM_SERVICE_TYPES, ServiceType } from "../constants.js";
+import { Asset, AssetWithExtras, BridgeableUiAsset, ChainAssetMap, NativeAsset } from "./asset.js";
 import { Quote, QuoterProps, ServiceQuoteEventHandler } from "./quote.js";
+import { ArrayElement } from "./utility-types.js";
+import { GetAtomicUtxosCallback, GetCoreEthAddressCallback, GetUtxosCallback, GetWalletAddressesForChainAliasCallback, GetWalletChangeAddressForChainAliasCallback } from "../transfer-service/avalanche-cct/types.js";
 import { Transfer, TransferStepDetails } from "./transfer.js";
 import { BtcSigner, EvmSigner, EvmSignerWithMessage, SolanaSigner } from "./signer.js";
-import { ArrayElement } from "./utility-types.js";
+import { UnsignedTx } from "@avalabs/avalanchejs";
 
 //#region src/types/service.d.ts
 /** Optional EIP-1559-style gas settings. */
@@ -121,11 +123,40 @@ interface EstimateNativeFeeOptions {
     maxPriorityFeePerGas?: bigint;
   }>;
 }
+/**
+* Asset search input used by bridgeable-assets queries.
+*
+* - `type: 'address'` means `value` is matched as an on-chain asset address.
+* - `type: 'keyword'` means `value` is matched against asset name/symbol text.
+*/
+interface AssetSearchQuery {
+  readonly type: "address" | "keyword";
+  readonly value: string;
+}
 interface GetBridgeableAssetsProps {
+  /** Maximum number of assets requested per page. Must be a positive integer. */
+  readonly limit?: number;
+  /** 1-based page index for service-level pagination. */
+  readonly page?: number;
+  /**
+  * Optional query used to search by address or keyword (name/symbol).
+  * Currently, search filtering is only applied by the Markr service.
+  */
+  readonly search?: AssetSearchQuery;
   readonly sourceAsset: Asset;
   readonly sourceChainId: Caip2ChainId;
   readonly targetChainId: Caip2ChainId;
 }
+interface GetBridgeableAssetsResult {
+  /** Assets for the requested page. */
+  readonly assets: readonly BridgeableUiAsset[];
+  /** Service pagination metadata for this response page. */
+  readonly meta: {
+    readonly currentPage: number;
+    readonly hasMore: boolean;
+    readonly nextPage?: number;
+  };
+}
 /**
 * Mapping of services supported chains, and their corresponding supported destination chains.
 */
@@ -165,12 +196,62 @@ interface TransferService {
     result: Promise<Transfer>;
   };
   /** Return assets receivable on targetChainId for the given source, via this service. */
-  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<readonly BridgeableUiAsset[]>;
+  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<GetBridgeableAssetsResult>;
   /** Execute the quote, emitting `onStepChange` for signature steps. */
   transferAsset(props: TransferAssetProps): Promise<Transfer>;
   /** Concrete discriminator for this service. */
   type: ServiceType;
 }
+type AvalancheSendTxParams = {
+  baseFeeInNanoAvax: bigint;
+  chainAlias: AvalancheBlockchainAlias;
+  txType: "export" | "import";
+  unsignedTx: UnsignedTx;
+};
+type AvalancheSendTxFunction = (params: AvalancheSendTxParams) => Promise<string>;
+type AvalancheCctInitializer = {
+  type: ServiceType.AVALANCHE_CCT;
+  /**
+  * Sends a fully built Avalanche export/import transaction and returns its transaction hash.
+  *
+  * You must implement signing and broadcasting on your side using the connected wallet/account
+  * for the provided chain alias.
+  */
+  avalancheSendTx: AvalancheSendTxFunction;
+  /**
+  * Maps an EVM C-Chain hex address (for example `0x...`) to the equivalent Coreth bech32 address.
+  *
+  * You must provide the address conversion from your wallet/provider stack so the SDK can route
+  * C-Chain imports/exports that require bech32 address format.
+  */
+  getCoreEthAddress: GetCoreEthAddressCallback;
+  /**
+  * Returns atomic UTXOs that are pending import into `destinationChain` from `sourceChain`.
+  *
+  * You must query Avalanche APIs/wallet state and return only currently importable atomic UTXOs
+  * for the specified source/destination chain pair.
+  */
+  getAtomicUtxos: GetAtomicUtxosCallback;
+  /**
+  * Returns spendable UTXOs for the provided P-Chain or X-Chain alias.
+  *
+  * You must load the wallet's current UTXO set for that chain so export transactions can be built.
+  */
+  getUtxos: GetUtxosCallback;
+  /**
+  * Returns addresses on the provided chain alias that are controlled by the connected wallet.
+  *
+  * You must provide all wallet-owned addresses relevant for transaction input ownership/signing checks.
+  */
+  getWalletAddressesForChainAlias: GetWalletAddressesForChainAliasCallback;
+  /**
+  * Returns the change address for the provided chain alias.
+  *
+  * You must return a valid wallet-controlled address that should receive change outputs
+  * when UTXO-based transactions are constructed.
+  */
+  getWalletChangeAddressForChainAlias: GetWalletChangeAddressForChainAliasCallback;
+};
 /** EVM-family service initializer. */
 type EvmServiceInitializer = {
   type: ArrayElement<typeof EVM_SERVICE_TYPES>;
@@ -186,6 +267,11 @@ type LombardServiceInitializer = {
 /** Markr initializer (swaps, cross-chain swaps). */
 type MarkrServiceInitializer = {
   type: ServiceType.MARKR;
+  /**
+  * EVM signer. Wire up `signTypedData` on the signer to enable Hyperliquid
+  * 2-phase withdrawals; otherwise a plain {@link EvmSigner} is sufficient
+  * for non-HL EVM swaps and bridges.
+  */
   evmSigner: EvmSigner;
   markrApiUrl?: string;
   markrApiToken?: string;
@@ -200,10 +286,23 @@ type MarkrServiceInitializer = {
   * Returns the assets available to receive on targetChainId via Markr cross-chain swaps.
   * The SDK calls this during getBridgeableAssets.
   * Similar to the bitcoinFunctions pattern, this decouples the SDK from any specific token registry.
+  * Any provider-specific metadata can be supplied via BridgeableAsset.extras and is passed through to consumers.
   */
-  getTargetChainAssets: (targetChainId: Caip2ChainId) => Promise<readonly Asset[]>;
+  getTargetChainAssets: (queryProps: {
+    /** Optional query used to search by address or keyword (name/symbol). */search?: AssetSearchQuery;
+    limit: number;
+    page: number;
+    targetChainId: Caip2ChainId;
+  }) => Promise<{
+    readonly assets: readonly AssetWithExtras[];
+    readonly meta: {
+      readonly currentPage: number;
+      readonly hasMore: boolean;
+      readonly nextPage: number | undefined;
+    };
+  }>;
 };
-type ServiceInitializer = EvmServiceInitializer | LombardServiceInitializer | MarkrServiceInitializer;
+type ServiceInitializer = AvalancheCctInitializer | EvmServiceInitializer | LombardServiceInitializer | MarkrServiceInitializer;
 //#endregion
-export { EstimateNativeFeeOptions, EvmServiceInitializer, GasSettings, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, LombardServiceInitializer, MarkrServiceInitializer, MutableGetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps, TransferService };
+export { AssetSearchQuery, AvalancheCctInitializer, AvalancheSendTxFunction, AvalancheSendTxParams, EstimateNativeFeeOptions, EvmServiceInitializer, GasSettings, GetBridgeableAssetsProps, GetBridgeableAssetsResult, GetMinimumTransferAmountProps, GetSupportedChainsResult, LombardServiceInitializer, MarkrServiceInitializer, MutableGetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps, TransferService };
 //# sourceMappingURL=service.d.ts.map

package/dist/types/signer.d.cts

@@ -27,9 +27,45 @@ type EvmSignMessage = (params: {
   address: Address;
   chainId: number;
 }, dispatch: EvmDispatch, step: TransferStepDetails) => Promise<Hex>;
+/**
+* EIP-712 typed-data payload passed to `signTypedData`.
+*
+* Mirrors the shape `viem`'s `walletClient.signTypedData` / `useSignTypedData`
+* accept so consumers can forward the object verbatim. Types intentionally use
+* `Record` instead of `viem`'s generics to avoid leaking heavy type plumbing
+* across the SDK surface — runtime shape is stable across EIP-712 versions.
+*/
+interface EvmTypedData {
+  readonly domain: {
+    readonly name?: string;
+    readonly version?: string;
+    readonly chainId?: number;
+    readonly verifyingContract?: Address;
+    readonly salt?: Hex;
+  };
+  readonly types: Readonly<Record<string, ReadonlyArray<{
+    readonly name: string;
+    readonly type: string;
+  }>>>;
+  readonly primaryType: string;
+  readonly message: Readonly<Record<string, unknown>>;
+}
+type EvmSignTypedData = (params: {
+  typedData: EvmTypedData;
+  address: Address;
+  chainId: number;
+}, step: TransferStepDetails) => Promise<Hex>;
 interface EvmSigner {
   sign: EvmSign;
   signBatch?: EvmSignBatch;
+  /**
+  * EIP-712 typed-data signature.
+  *
+  * Optional for backwards compatibility — handlers that require this
+  * (e.g. the Hyperliquid 2-phase withdrawal) throw if the consumer hasn't
+  * wired it.
+  */
+  signTypedData?: EvmSignTypedData;
 }
 interface EvmSignerWithMessage extends EvmSigner {
   signMessage: EvmSignMessage;
@@ -48,5 +84,5 @@ interface SolanaSigner {
   signAndSend: SolanaSign;
 }
 //#endregion
-export { BtcDispatch, BtcSign, BtcSigner, BtcTransactionRequest, EvmDispatch, EvmSign, EvmSignBatch, EvmSignMessage, EvmSigner, EvmSignerWithMessage, EvmTransactionRequest, Hex, SolanaSign, SolanaSigner };
+export { BtcDispatch, BtcSign, BtcSigner, BtcTransactionRequest, EvmDispatch, EvmSign, EvmSignBatch, EvmSignMessage, EvmSignTypedData, EvmSigner, EvmSignerWithMessage, EvmTransactionRequest, EvmTypedData, Hex, SolanaSign, SolanaSigner };
 //# sourceMappingURL=signer.d.cts.map

package/dist/types/signer.d.ts

@@ -27,9 +27,45 @@ type EvmSignMessage = (params: {
   address: Address;
   chainId: number;
 }, dispatch: EvmDispatch, step: TransferStepDetails) => Promise<Hex>;
+/**
+* EIP-712 typed-data payload passed to `signTypedData`.
+*
+* Mirrors the shape `viem`'s `walletClient.signTypedData` / `useSignTypedData`
+* accept so consumers can forward the object verbatim. Types intentionally use
+* `Record` instead of `viem`'s generics to avoid leaking heavy type plumbing
+* across the SDK surface — runtime shape is stable across EIP-712 versions.
+*/
+interface EvmTypedData {
+  readonly domain: {
+    readonly name?: string;
+    readonly version?: string;
+    readonly chainId?: number;
+    readonly verifyingContract?: Address;
+    readonly salt?: Hex;
+  };
+  readonly types: Readonly<Record<string, ReadonlyArray<{
+    readonly name: string;
+    readonly type: string;
+  }>>>;
+  readonly primaryType: string;
+  readonly message: Readonly<Record<string, unknown>>;
+}
+type EvmSignTypedData = (params: {
+  typedData: EvmTypedData;
+  address: Address;
+  chainId: number;
+}, step: TransferStepDetails) => Promise<Hex>;
 interface EvmSigner {
   sign: EvmSign;
   signBatch?: EvmSignBatch;
+  /**
+  * EIP-712 typed-data signature.
+  *
+  * Optional for backwards compatibility — handlers that require this
+  * (e.g. the Hyperliquid 2-phase withdrawal) throw if the consumer hasn't
+  * wired it.
+  */
+  signTypedData?: EvmSignTypedData;
 }
 interface EvmSignerWithMessage extends EvmSigner {
   signMessage: EvmSignMessage;
@@ -48,5 +84,5 @@ interface SolanaSigner {
   signAndSend: SolanaSign;
 }
 //#endregion
-export { BtcDispatch, BtcSign, BtcSigner, BtcTransactionRequest, EvmDispatch, EvmSign, EvmSignBatch, EvmSignMessage, EvmSigner, EvmSignerWithMessage, EvmTransactionRequest, Hex, SolanaSign, SolanaSigner };
+export { BtcDispatch, BtcSign, BtcSigner, BtcTransactionRequest, EvmDispatch, EvmSign, EvmSignBatch, EvmSignMessage, EvmSignTypedData, EvmSigner, EvmSignerWithMessage, EvmTransactionRequest, EvmTypedData, Hex, SolanaSign, SolanaSigner };
 //# sourceMappingURL=signer.d.ts.map

package/dist/types/transfer-manager.d.cts

@@ -2,10 +2,10 @@ import { Caip2ChainId } from "./caip.cjs";
 import { Environment, ServiceType } from "../constants.cjs";
 import { Asset, BridgeableUiAsset } from "./asset.cjs";
 import { Quote, QuoterInterface, QuoterProps } from "./quote.cjs";
+import { Fetch } from "./utility-types.cjs";
 import { SdkError } from "../errors.cjs";
 import { Transfer } from "./transfer.cjs";
-import { Fetch } from "./utility-types.cjs";
-import { EstimateNativeFeeOptions, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.cjs";
+import { EstimateNativeFeeOptions, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.cjs";
 import { QuoterOptions } from "../quoter/quoter.cjs";
 
 //#region src/types/transfer-manager.d.ts
@@ -55,19 +55,28 @@ interface TransferManager {
   /** Estimate the native fee for executing the provided quote. */
   estimateNativeFee(quote: Quote, options?: EstimateNativeFeeOptions): Promise<NativeFeeEstimate>;
   /**
-  * Returns all assets possibly receivable on targetChainId for the given source asset,
-  * across all configured bridge and swap providers. Assets are enriched with logoUri
-  * where available.
+  * Returns a single page of combined bridgeable assets for the given source/target route.
+  * This API is designed for React Query `useInfiniteQuery`:
+  *
+  * - pass `pageParam` to this method as `page`
+  * - use `result.assets` as the current page payload
+  * - use `result.meta.nextPage` in `getNextPageParam`
+  *
+  * `search` is forwarded to all configured services, but currently only Markr
+  * applies search filtering in service implementations.
   *
   * Note: inclusion in this list does not guarantee a quote will succeed — for some
   * providers (e.g. Markr) routes are discovered at quote time and may not always be
   * available.
   */
-  getBridgeableAssets(props: {
-    sourceAsset: Asset;
-    sourceChainId: Caip2ChainId;
-    targetChainId: Caip2ChainId;
-  }): Promise<readonly BridgeableUiAsset[]>;
+  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<{
+    readonly assets: readonly BridgeableUiAsset[];
+    readonly meta: {
+      readonly currentPage: number;
+      readonly hasMore: boolean;
+      readonly nextPage?: number;
+    };
+  }>;
   /**
   * Minimum supported source amount for a given pair.
   *

package/dist/types/transfer-manager.d.ts

@@ -2,10 +2,10 @@ import { Caip2ChainId } from "./caip.js";
 import { Environment, ServiceType } from "../constants.js";
 import { Asset, BridgeableUiAsset } from "./asset.js";
 import { Quote, QuoterInterface, QuoterProps } from "./quote.js";
+import { Fetch } from "./utility-types.js";
 import { SdkError } from "../errors.js";
 import { Transfer } from "./transfer.js";
-import { Fetch } from "./utility-types.js";
-import { EstimateNativeFeeOptions, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.js";
+import { EstimateNativeFeeOptions, GetBridgeableAssetsProps, GetMinimumTransferAmountProps, GetSupportedChainsResult, NativeFeeEstimate, ServiceInitializer, TrackTransferProps, TransferAssetProps } from "./service.js";
 import { QuoterOptions } from "../quoter/quoter.js";
 
 //#region src/types/transfer-manager.d.ts
@@ -55,19 +55,28 @@ interface TransferManager {
   /** Estimate the native fee for executing the provided quote. */
   estimateNativeFee(quote: Quote, options?: EstimateNativeFeeOptions): Promise<NativeFeeEstimate>;
   /**
-  * Returns all assets possibly receivable on targetChainId for the given source asset,
-  * across all configured bridge and swap providers. Assets are enriched with logoUri
-  * where available.
+  * Returns a single page of combined bridgeable assets for the given source/target route.
+  * This API is designed for React Query `useInfiniteQuery`:
+  *
+  * - pass `pageParam` to this method as `page`
+  * - use `result.assets` as the current page payload
+  * - use `result.meta.nextPage` in `getNextPageParam`
+  *
+  * `search` is forwarded to all configured services, but currently only Markr
+  * applies search filtering in service implementations.
   *
   * Note: inclusion in this list does not guarantee a quote will succeed — for some
   * providers (e.g. Markr) routes are discovered at quote time and may not always be
   * available.
   */
-  getBridgeableAssets(props: {
-    sourceAsset: Asset;
-    sourceChainId: Caip2ChainId;
-    targetChainId: Caip2ChainId;
-  }): Promise<readonly BridgeableUiAsset[]>;
+  getBridgeableAssets(props: GetBridgeableAssetsProps): Promise<{
+    readonly assets: readonly BridgeableUiAsset[];
+    readonly meta: {
+      readonly currentPage: number;
+      readonly hasMore: boolean;
+      readonly nextPage?: number;
+    };
+  }>;
   /**
   * Minimum supported source amount for a given pair.
   *

package/dist/types/utility-types.d.cts

@@ -8,6 +8,13 @@
 */
 type ArrayElement<A> = A extends readonly (infer T)[] ? T : never;
 /**
+* Utility type to create a branded type, which is a subtype of the original
+* type but with an additional unique brand property to prevent accidental interchangeability.
+*/
+type Brand<K, T> = K & {
+  readonly __brand: T;
+};
+/**
 * Utility type to make all properties of a type mutable (non-readonly).
 */
 type Mutable<T> = { -readonly [P in keyof T]: T[P] };
@@ -17,5 +24,5 @@ type Mutable<T> = { -readonly [P in keyof T]: T[P] };
 type DeepMutable<T> = { -readonly [P in keyof T]: T[P] extends object ? DeepMutable<T[P]> : T[P] };
 type Fetch = typeof globalThis.fetch;
 //#endregion
-export { ArrayElement, DeepMutable, Fetch, Mutable };
+export { ArrayElement, Brand, DeepMutable, Fetch, Mutable };
 //# sourceMappingURL=utility-types.d.cts.map

package/dist/types/utility-types.d.ts

@@ -8,6 +8,13 @@
 */
 type ArrayElement<A> = A extends readonly (infer T)[] ? T : never;
 /**
+* Utility type to create a branded type, which is a subtype of the original
+* type but with an additional unique brand property to prevent accidental interchangeability.
+*/
+type Brand<K, T> = K & {
+  readonly __brand: T;
+};
+/**
 * Utility type to make all properties of a type mutable (non-readonly).
 */
 type Mutable<T> = { -readonly [P in keyof T]: T[P] };
@@ -17,5 +24,5 @@ type Mutable<T> = { -readonly [P in keyof T]: T[P] };
 type DeepMutable<T> = { -readonly [P in keyof T]: T[P] extends object ? DeepMutable<T[P]> : T[P] };
 type Fetch = typeof globalThis.fetch;
 //#endregion
-export { ArrayElement, DeepMutable, Fetch, Mutable };
+export { ArrayElement, Brand, DeepMutable, Fetch, Mutable };
 //# sourceMappingURL=utility-types.d.ts.map

package/dist/utils/asset-id.cjs

@@ -1,2 +1,2 @@
-const e=require(`../constants.cjs`);function t(t,n){return n.type===e.TokenType.NATIVE?`${t}:${n.type}`:`${t}:${n.type}:${n.address.toLowerCase()}`}exports.getAssetId=t;
+const e=require(`../constants.cjs`);function t(t,n){return n.type===e.TokenType.NATIVE?`${t}::${n.type}`:`${t}::${n.type}::${n.address.toLowerCase()}`}exports.getAssetId=t;
 //# sourceMappingURL=asset-id.cjs.map

package/dist/utils/asset-id.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"asset-id.cjs","names":["TokenType"],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}:native`\n *  - Token assets:  `{chainId}:{tokenType}:{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}:${asset.type}`;\n  }\n\n  return `${chainId}:${asset.type}:${asset.address.toLowerCase()}`;\n}\n"],"mappings":"oCAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAASA,EAAAA,UAAU,OACpB,GAAG,EAAQ,GAAG,EAAM,OAGtB,GAAG,EAAQ,GAAG,EAAM,KAAK,GAAG,EAAM,QAAQ,aAAa"}
+{"version":3,"file":"asset-id.cjs","names":["TokenType"],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}::native`\n *  - Token assets:  `{chainId}::{tokenType}::{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}::${asset.type}`;\n  }\n\n  return `${chainId}::${asset.type}::${asset.address.toLowerCase()}`;\n}\n"],"mappings":"oCAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAASA,EAAAA,UAAU,OACpB,GAAG,EAAQ,IAAI,EAAM,OAGvB,GAAG,EAAQ,IAAI,EAAM,KAAK,IAAI,EAAM,QAAQ,aAAa"}

package/dist/utils/asset-id.js

@@ -1,2 +1,2 @@
-import{TokenType as e}from"../constants.js";function t(t,n){return n.type===e.NATIVE?`${t}:${n.type}`:`${t}:${n.type}:${n.address.toLowerCase()}`}export{t as getAssetId};
+import{TokenType as e}from"../constants.js";function t(t,n){return n.type===e.NATIVE?`${t}::${n.type}`:`${t}::${n.type}::${n.address.toLowerCase()}`}export{t as getAssetId};
 //# sourceMappingURL=asset-id.js.map

package/dist/utils/asset-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-id.js","names":[],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}:native`\n *  - Token assets:  `{chainId}:{tokenType}:{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}:${asset.type}`;\n  }\n\n  return `${chainId}:${asset.type}:${asset.address.toLowerCase()}`;\n}\n"],"mappings":"4CAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAAS,EAAU,OACpB,GAAG,EAAQ,GAAG,EAAM,OAGtB,GAAG,EAAQ,GAAG,EAAM,KAAK,GAAG,EAAM,QAAQ,aAAa"}
+{"version":3,"file":"asset-id.js","names":[],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}::native`\n *  - Token assets:  `{chainId}::{tokenType}::{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}::${asset.type}`;\n  }\n\n  return `${chainId}::${asset.type}::${asset.address.toLowerCase()}`;\n}\n"],"mappings":"4CAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAAS,EAAU,OACpB,GAAG,EAAQ,IAAI,EAAM,OAGvB,GAAG,EAAQ,IAAI,EAAM,KAAK,IAAI,EAAM,QAAQ,aAAa"}

package/dist/utils/bridgeable-assets.cjs

@@ -0,0 +1,2 @@
+const e=require(`../constants.cjs`),t=t=>{let n=new Map,r=[];for(let i of t){let t=n.get(i.id);if(!t){n.set(i.id,{...i,bridgeProviders:[...new Set(i.bridgeProviders)]}),r.push(i.id);continue}let a=t.extras!==void 0||i.extras!==void 0?{...t.extras??{},...i.extras??{}}:void 0,o=i.bridgeProviders.includes(e.ServiceType.MARKR)?i:t;n.set(i.id,{...o,bridgeProviders:[...new Set([...t.bridgeProviders,...i.bridgeProviders])],...a===void 0?{}:{extras:a}})}return r.map(e=>n.get(e)).filter(e=>e!==void 0)};exports.dedupeBridgeableAssets=t;
+//# sourceMappingURL=bridgeable-assets.cjs.map

package/dist/utils/bridgeable-assets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeable-assets.cjs","names":["ServiceType"],"sources":["../../src/utils/bridgeable-assets.ts"],"sourcesContent":["import { ServiceType } from '../constants';\nimport type { BridgeableUiAsset } from '../types/asset';\n\n/**\n * Deduplicates bridgeable assets by ID while preserving first-seen order.\n *\n * When duplicates are found:\n * - bridgeProviders are merged as a unique set (first-seen order)\n * - extras are shallow merged ({ ...existing.extras, ...incoming.extras })\n * - if the incoming duplicate includes MARKR, MARKR is treated as authoritative\n *   for name/symbol/logoUri/address fields\n */\nexport const dedupeBridgeableAssets = (assets: readonly BridgeableUiAsset[]): readonly BridgeableUiAsset[] => {\n  const merged = new Map<string, BridgeableUiAsset>();\n  const orderedIds: string[] = [];\n\n  for (const asset of assets) {\n    const existing = merged.get(asset.id);\n\n    if (!existing) {\n      merged.set(asset.id, {\n        ...asset,\n        bridgeProviders: [...new Set(asset.bridgeProviders)],\n      });\n      orderedIds.push(asset.id);\n      continue;\n    }\n\n    const mergedExtras =\n      existing.extras !== undefined || asset.extras !== undefined\n        ? {\n            ...(existing.extras ?? {}),\n            ...(asset.extras ?? {}),\n          }\n        : undefined;\n    const incomingFromMarkr = asset.bridgeProviders.includes(ServiceType.MARKR);\n    const canonicalAsset = incomingFromMarkr ? asset : existing;\n\n    merged.set(asset.id, {\n      ...canonicalAsset,\n      bridgeProviders: [...new Set([...existing.bridgeProviders, ...asset.bridgeProviders])],\n      ...(mergedExtras !== undefined ? { extras: mergedExtras } : {}),\n    });\n  }\n\n  return orderedIds.map((id) => merged.get(id)).filter((asset): asset is BridgeableUiAsset => asset !== undefined);\n};\n"],"mappings":"oCAYa,EAA0B,GAAuE,CAC5G,IAAM,EAAS,IAAI,IACb,EAAuB,EAAE,CAE/B,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAW,EAAO,IAAI,EAAM,GAAG,CAErC,GAAI,CAAC,EAAU,CACb,EAAO,IAAI,EAAM,GAAI,CACnB,GAAG,EACH,gBAAiB,CAAC,GAAG,IAAI,IAAI,EAAM,gBAAgB,CAAC,CACrD,CAAC,CACF,EAAW,KAAK,EAAM,GAAG,CACzB,SAGF,IAAM,EACJ,EAAS,SAAW,IAAA,IAAa,EAAM,SAAW,IAAA,GAC9C,CACE,GAAI,EAAS,QAAU,EAAE,CACzB,GAAI,EAAM,QAAU,EAAE,CACvB,CACD,IAAA,GAEA,EADoB,EAAM,gBAAgB,SAASA,EAAAA,YAAY,MAAM,CAChC,EAAQ,EAEnD,EAAO,IAAI,EAAM,GAAI,CACnB,GAAG,EACH,gBAAiB,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAS,gBAAiB,GAAG,EAAM,gBAAgB,CAAC,CAAC,CACtF,GAAI,IAAiB,IAAA,GAAuC,EAAE,CAA7B,CAAE,OAAQ,EAAc,CAC1D,CAAC,CAGJ,OAAO,EAAW,IAAK,GAAO,EAAO,IAAI,EAAG,CAAC,CAAC,OAAQ,GAAsC,IAAU,IAAA,GAAU"}

package/dist/utils/bridgeable-assets.d.cts

@@ -0,0 +1,16 @@
+import { BridgeableUiAsset } from "../types/asset.cjs";
+
+//#region src/utils/bridgeable-assets.d.ts
+/**
+* Deduplicates bridgeable assets by ID while preserving first-seen order.
+*
+* When duplicates are found:
+* - bridgeProviders are merged as a unique set (first-seen order)
+* - extras are shallow merged ({ ...existing.extras, ...incoming.extras })
+* - if the incoming duplicate includes MARKR, MARKR is treated as authoritative
+*   for name/symbol/logoUri/address fields
+*/
+declare const dedupeBridgeableAssets: (assets: readonly BridgeableUiAsset[]) => readonly BridgeableUiAsset[];
+//#endregion
+export { dedupeBridgeableAssets };
+//# sourceMappingURL=bridgeable-assets.d.cts.map

package/dist/utils/bridgeable-assets.d.ts

@@ -0,0 +1,16 @@
+import { BridgeableUiAsset } from "../types/asset.js";
+
+//#region src/utils/bridgeable-assets.d.ts
+/**
+* Deduplicates bridgeable assets by ID while preserving first-seen order.
+*
+* When duplicates are found:
+* - bridgeProviders are merged as a unique set (first-seen order)
+* - extras are shallow merged ({ ...existing.extras, ...incoming.extras })
+* - if the incoming duplicate includes MARKR, MARKR is treated as authoritative
+*   for name/symbol/logoUri/address fields
+*/
+declare const dedupeBridgeableAssets: (assets: readonly BridgeableUiAsset[]) => readonly BridgeableUiAsset[];
+//#endregion
+export { dedupeBridgeableAssets };
+//# sourceMappingURL=bridgeable-assets.d.ts.map

package/dist/utils/bridgeable-assets.js

@@ -0,0 +1,2 @@
+import{ServiceType as e}from"../constants.js";const t=t=>{let n=new Map,r=[];for(let i of t){let t=n.get(i.id);if(!t){n.set(i.id,{...i,bridgeProviders:[...new Set(i.bridgeProviders)]}),r.push(i.id);continue}let a=t.extras!==void 0||i.extras!==void 0?{...t.extras??{},...i.extras??{}}:void 0,o=i.bridgeProviders.includes(e.MARKR)?i:t;n.set(i.id,{...o,bridgeProviders:[...new Set([...t.bridgeProviders,...i.bridgeProviders])],...a===void 0?{}:{extras:a}})}return r.map(e=>n.get(e)).filter(e=>e!==void 0)};export{t as dedupeBridgeableAssets};
+//# sourceMappingURL=bridgeable-assets.js.map