@stablechain/sdk 1.0.5 → 1.0.6

package/dist/index.d.cts

@@ -103,20 +103,96 @@ declare enum Network {
     Testnet = "testnet"
 }
 interface BridgeQuote {
-    /** Estimated output amount on the destination chain */
+    /**
+     * Amount the recipient is expected to receive on the destination chain.
+     *
+     * On native OFT routes this is `oft.amountReceivedLD` — the input minus any
+     * OFT-level fee and minus dust removed by decimal conversion — and falls back
+     * to the input amount when `quoteOFT` could not be read.
+     */
     toAmount?: number;
-    /** LayerZero native messaging fee (wei) — only present for USDT0→USDT0 (OFT) routes */
+    /**
+     * LayerZero messaging fee (wei of the source chain's native token) — only
+     * present for native OFT routes. This is the whole `MessagingFee.nativeFee`
+     * that `send` must be called with: DVN fees, executor fee and any requested
+     * destination native drop, bundled. `quoteSend` returns no breakdown of it.
+     */
     nativeFee?: bigint;
-    /** LayerZero fee paid in LZ token (wei) — only present for USDT0→USDT0 (OFT) routes */
+    /** LayerZero fee paid in LZ token (wei) — only present for native OFT routes */
     lzTokenFee?: bigint;
     /**
-     * How long the bridge is expected to take. Only present for USDT0 (OFT) routes,
+     * OFT-level accounting for the send: what the adapter itself debits, credits
+     * and charges, independent of the LayerZero messaging fee. Only present for
+     * native OFT routes, and omitted when the `quoteOFT` read failed.
+     */
+    oft?: BridgeOftQuote;
+    /**
+     * Source-chain execution cost of the `send` transaction. Only present for
+     * native OFT routes, and omitted when neither simulation nor fallback could
+     * produce a number. Excludes {@link BridgeQuote.nativeFee}.
+     */
+    srcGas?: BridgeGasEstimate;
+    /**
+     * Everything the sender pays out of their native balance, in wei:
+     * `srcGas.costWei + nativeFee`. Present only when both parts are known.
+     */
+    totalCostWei?: bigint;
+    /**
+     * How long the bridge is expected to take. Only present for native OFT routes,
      * and omitted if the estimate could not be resolved — never treat it as required.
      */
     estimate?: BridgeTimeEstimate;
 }
 /**
- * Expected end-to-end delivery time for a USDT0 (LayerZero OFT) bridge.
+ * One fee the OFT itself reports for a send, from `quoteOFT`'s `oftFeeDetails`.
+ *
+ * Every pathway in BRIDGE_CHAIN_CONFIGS reported none when checked on 2026-08-20
+ * (Ethereum, Stable, Arbitrum and Plasma adapters), so an empty `fees` array is the
+ * normal case rather than a failed read. A deployment that does charge at the OFT
+ * level — the kind of thing a bridge UI shows as its own fee row — reports it here
+ * rather than inside the LayerZero messaging fee.
+ */
+interface BridgeOftFee {
+    /** Fee in the source token's smallest unit. Negative means a credit, not a charge. */
+    amountLD: bigint;
+    /** Human-readable amount, same sign convention as {@link BridgeOftFee.amountLD} */
+    amount: number;
+    /** Whatever the adapter calls this fee — its own string, shown as-is */
+    description: string;
+}
+/** What the OFT adapter reports for a send, read from `quoteOFT`. */
+interface BridgeOftQuote {
+    /** Amount debited on the source chain, in the source token's smallest unit */
+    amountSentLD: bigint;
+    /** Amount credited on the destination chain, in the source token's smallest unit */
+    amountReceivedLD: bigint;
+    /** Human-readable {@link BridgeOftQuote.amountReceivedLD} */
+    amountReceived: number;
+    /** Fees the adapter charges. Empty on pathways that charge none. */
+    fees: BridgeOftFee[];
+    /** Smallest amount this pathway accepts, in the source token's smallest unit */
+    minAmountLD: bigint;
+    /** Largest amount this pathway accepts, in the source token's smallest unit */
+    maxAmountLD: bigint;
+}
+/** Source-chain gas for the OFT `send` transaction. */
+interface BridgeGasEstimate {
+    /** Gas units */
+    gas: bigint;
+    /** Price per gas unit (wei) — `maxFeePerGas` where the chain is EIP-1559 */
+    gasPriceWei: bigint;
+    /** `gas × gasPriceWei` */
+    costWei: bigint;
+    /**
+     * `"simulated"` means `gas` came from simulating the real `send` — trust it.
+     * `"fallback"` means the simulation failed (no allowance or no balance yet is
+     * the usual reason when quoting before approving) and `gas` is a typical-send
+     * constant, so treat the cost as indicative only.
+     */
+    source: "simulated" | "fallback";
+}
+/**
+ * Expected end-to-end delivery time for a native (LayerZero OFT) bridge.
  *
  * Almost all of the wait is source-chain finality: the DVNs securing the pathway
  * refuse to attest until the send transaction is buried under `confirmations`
@@ -159,13 +235,17 @@ interface BridgeStatus {
 }
 /**
  * Bridge route selection:
- * - `"usdt0"` — force the USDT0 LayerZero OFT path (no protocol fee, just gas + LZ
- *   messaging fee; slower). Throws if the chain pair has no USDT0 adapter.
+ * - `"oft"` — force the native LayerZero OFT path for whichever asset the token
+ *   addresses name, USDT0 or XAUt0 (no protocol fee, just gas + LZ messaging fee;
+ *   slower). Throws if the chain pair has no adapter for that asset.
+ * - `"usdt0"` — deprecated alias for `"oft"`, kept for compatibility. It does not
+ *   restrict the route to USDT0; the token addresses decide the asset.
  * - `"lifi"` — force the LI.FI aggregator path (fast, charges a fee).
- * - `"auto"` — use USDT0 when both chains support it and tokens match, else LI.FI.
+ * - `"auto"` — use the native OFT mesh (USDT0 or XAUt0) when both chains deploy
+ *   the requested asset and the token addresses match, else LI.FI.
  *   This is the default.
  */
-type BridgeRoute = "auto" | "usdt0" | "lifi";
+type BridgeRoute = "auto" | "oft" | "usdt0" | "lifi";
 interface BridgeParams {
     fromChain: Chain;
     toChain: Chain;
@@ -179,11 +259,26 @@ interface BridgeParams {
     /** Recipient address — defaults to the signer */
     recipient?: string;
     /**
-     * Which bridge to use. Defaults to "auto" (USDT0 OFT when available, else LI.FI).
+     * Which bridge to use. Defaults to "auto" (native OFT when available, else LI.FI).
      * See {@link BridgeRoute}.
      */
     route?: BridgeRoute;
-    /** Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to bridge() */
+    /**
+     * Destination native token (wei) to airdrop to the recipient alongside the
+     * tokens — LayerZero's executor native-drop option, what bridge UIs call
+     * "gas on destination". Paid for by the sender through a larger
+     * {@link BridgeQuote.nativeFee}.
+     *
+     * Only supported on native OFT routes, and capped per pathway by the
+     * executor's configured `nativeCap`: asking for more makes `quoteSend`
+     * revert rather than silently clamping.
+     */
+    dstNativeDrop?: bigint;
+    /**
+     * Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to
+     * bridge(). Must have been quoted with the same `dstNativeDrop`, since the
+     * drop is part of what `nativeFee` pays for.
+     */
     quote?: BridgeQuote;
 }
 interface EarnDepositParams {
@@ -416,11 +511,14 @@ interface StableClient {
     quoteBridge(params: BridgeParams): Promise<BridgeQuote>;
     bridge(params: BridgeParams): Promise<OperationResult>;
     /**
-     * Expected delivery time for a USDT0 (LayerZero OFT) bridge, before sending.
-     * Throws for chain pairs with no USDT0 adapter — LI.FI carries its own ETA.
+     * Expected delivery time for a native OFT (LayerZero) bridge, before sending.
+     * Throws for chain pairs with no OFT adapter — LI.FI carries its own ETA.
+     *
+     * Pass `fromToken`/`toToken` to estimate a specific asset; omitting them
+     * estimates the USDT0 pathway.
      */
-    estimateBridgeTime(params: Pick<BridgeParams, "fromChain" | "toChain">): Promise<BridgeTimeEstimate>;
-    /** Delivery status of an in-flight USDT0 bridge, by source transaction hash. */
+    estimateBridgeTime(params: Pick<BridgeParams, "fromChain" | "toChain"> & Partial<Pick<BridgeParams, "fromToken" | "toToken">>): Promise<BridgeTimeEstimate>;
+    /** Delivery status of an in-flight OFT bridge, by source transaction hash. */
     trackBridge(srcTxHash: string): Promise<BridgeStatus>;
     quoteSwap(params: SwapParams): Promise<SwapQuote>;
     swap(params: SwapParams): Promise<OperationResult>;
@@ -484,9 +582,37 @@ interface ChainConfig {
 }
 declare const CHAIN_CONFIGS: Partial<Record<Chain, ChainConfig>>;
 
+/** An asset with its own LayerZero OFT mesh. Each has separate adapters per chain. */
+type BridgeAsset = "usdt0" | "xaut0";
+/** One asset's deployment on one chain. */
+interface BridgeTokenConfig {
+    /** The ERC-20 a holder owns — what gets debited, and approved when required */
+    address: Address;
+    /** Decimals of that ERC-20 on this chain */
+    decimals: number;
+    /** The OFT (or OFT Adapter) that escrows-or-burns on send */
+    oftAdapter: Address;
+    /**
+     * Whether `send` pulls the token via `transferFrom` and so needs an allowance.
+     * Only the lockbox chain does; remote deployments burn from the caller directly.
+     * Undefined means "approve when the allowance is short" — the safe default.
+     */
+    approvalRequired?: boolean;
+    /** False when the adapter exists but has no outbound send pathways configured */
+    lzOutbound?: boolean;
+}
 interface BridgeChainConfig extends ChainConfig {
     lzEid: number;
-    /** Only set on source chains that have an OFT Adapter deployed */
+    /**
+     * Which OFT assets this chain can bridge. A chain may carry one and not the
+     * other — BSC has XAUt0 but no USDT0 deployment.
+     */
+    tokens: Partial<Record<BridgeAsset, BridgeTokenConfig>>;
+    /**
+     * The USDT0 adapter. Predates XAUt0 and is part of the exported
+     * BRIDGE_CHAIN_CONFIGS surface, so it still means USDT0 specifically —
+     * prefer `tokens[asset].oftAdapter`.
+     */
     oftAdapter?: Address;
     /** False when the OFT adapter exists but has no outbound send pathways configured */
     lzOutbound?: boolean;
@@ -497,6 +623,11 @@ interface BridgeChainConfig extends ChainConfig {
     blockTimeSec?: number;
 }
 declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
+/**
+ * Which OFT asset a token address refers to on a chain, or undefined when the
+ * chain has no OFT deployment matching it.
+ */
+declare function bridgeAssetFor(cfg: BridgeChainConfig, token: string): BridgeAsset | undefined;
 /** Drop cached pathway configs and observed timings — forces the next estimate to refetch. */
 declare function clearBridgeEstimateCache(): void;
 
@@ -560,4 +691,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeDeliveryState, type BridgeParams, type BridgeQuote, type BridgeRoute, type BridgeStatus, type BridgeTimeEstimate, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeChainConfig, type BridgeDeliveryState, type BridgeGasEstimate, type BridgeOftFee, type BridgeOftQuote, type BridgeParams, type BridgeQuote, type BridgeRoute, type BridgeStatus, type BridgeTimeEstimate, type BridgeTokenConfig, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, bridgeAssetFor, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };

package/dist/index.d.ts

@@ -103,20 +103,96 @@ declare enum Network {
     Testnet = "testnet"
 }
 interface BridgeQuote {
-    /** Estimated output amount on the destination chain */
+    /**
+     * Amount the recipient is expected to receive on the destination chain.
+     *
+     * On native OFT routes this is `oft.amountReceivedLD` — the input minus any
+     * OFT-level fee and minus dust removed by decimal conversion — and falls back
+     * to the input amount when `quoteOFT` could not be read.
+     */
     toAmount?: number;
-    /** LayerZero native messaging fee (wei) — only present for USDT0→USDT0 (OFT) routes */
+    /**
+     * LayerZero messaging fee (wei of the source chain's native token) — only
+     * present for native OFT routes. This is the whole `MessagingFee.nativeFee`
+     * that `send` must be called with: DVN fees, executor fee and any requested
+     * destination native drop, bundled. `quoteSend` returns no breakdown of it.
+     */
     nativeFee?: bigint;
-    /** LayerZero fee paid in LZ token (wei) — only present for USDT0→USDT0 (OFT) routes */
+    /** LayerZero fee paid in LZ token (wei) — only present for native OFT routes */
     lzTokenFee?: bigint;
     /**
-     * How long the bridge is expected to take. Only present for USDT0 (OFT) routes,
+     * OFT-level accounting for the send: what the adapter itself debits, credits
+     * and charges, independent of the LayerZero messaging fee. Only present for
+     * native OFT routes, and omitted when the `quoteOFT` read failed.
+     */
+    oft?: BridgeOftQuote;
+    /**
+     * Source-chain execution cost of the `send` transaction. Only present for
+     * native OFT routes, and omitted when neither simulation nor fallback could
+     * produce a number. Excludes {@link BridgeQuote.nativeFee}.
+     */
+    srcGas?: BridgeGasEstimate;
+    /**
+     * Everything the sender pays out of their native balance, in wei:
+     * `srcGas.costWei + nativeFee`. Present only when both parts are known.
+     */
+    totalCostWei?: bigint;
+    /**
+     * How long the bridge is expected to take. Only present for native OFT routes,
      * and omitted if the estimate could not be resolved — never treat it as required.
      */
     estimate?: BridgeTimeEstimate;
 }
 /**
- * Expected end-to-end delivery time for a USDT0 (LayerZero OFT) bridge.
+ * One fee the OFT itself reports for a send, from `quoteOFT`'s `oftFeeDetails`.
+ *
+ * Every pathway in BRIDGE_CHAIN_CONFIGS reported none when checked on 2026-08-20
+ * (Ethereum, Stable, Arbitrum and Plasma adapters), so an empty `fees` array is the
+ * normal case rather than a failed read. A deployment that does charge at the OFT
+ * level — the kind of thing a bridge UI shows as its own fee row — reports it here
+ * rather than inside the LayerZero messaging fee.
+ */
+interface BridgeOftFee {
+    /** Fee in the source token's smallest unit. Negative means a credit, not a charge. */
+    amountLD: bigint;
+    /** Human-readable amount, same sign convention as {@link BridgeOftFee.amountLD} */
+    amount: number;
+    /** Whatever the adapter calls this fee — its own string, shown as-is */
+    description: string;
+}
+/** What the OFT adapter reports for a send, read from `quoteOFT`. */
+interface BridgeOftQuote {
+    /** Amount debited on the source chain, in the source token's smallest unit */
+    amountSentLD: bigint;
+    /** Amount credited on the destination chain, in the source token's smallest unit */
+    amountReceivedLD: bigint;
+    /** Human-readable {@link BridgeOftQuote.amountReceivedLD} */
+    amountReceived: number;
+    /** Fees the adapter charges. Empty on pathways that charge none. */
+    fees: BridgeOftFee[];
+    /** Smallest amount this pathway accepts, in the source token's smallest unit */
+    minAmountLD: bigint;
+    /** Largest amount this pathway accepts, in the source token's smallest unit */
+    maxAmountLD: bigint;
+}
+/** Source-chain gas for the OFT `send` transaction. */
+interface BridgeGasEstimate {
+    /** Gas units */
+    gas: bigint;
+    /** Price per gas unit (wei) — `maxFeePerGas` where the chain is EIP-1559 */
+    gasPriceWei: bigint;
+    /** `gas × gasPriceWei` */
+    costWei: bigint;
+    /**
+     * `"simulated"` means `gas` came from simulating the real `send` — trust it.
+     * `"fallback"` means the simulation failed (no allowance or no balance yet is
+     * the usual reason when quoting before approving) and `gas` is a typical-send
+     * constant, so treat the cost as indicative only.
+     */
+    source: "simulated" | "fallback";
+}
+/**
+ * Expected end-to-end delivery time for a native (LayerZero OFT) bridge.
  *
  * Almost all of the wait is source-chain finality: the DVNs securing the pathway
  * refuse to attest until the send transaction is buried under `confirmations`
@@ -159,13 +235,17 @@ interface BridgeStatus {
 }
 /**
  * Bridge route selection:
- * - `"usdt0"` — force the USDT0 LayerZero OFT path (no protocol fee, just gas + LZ
- *   messaging fee; slower). Throws if the chain pair has no USDT0 adapter.
+ * - `"oft"` — force the native LayerZero OFT path for whichever asset the token
+ *   addresses name, USDT0 or XAUt0 (no protocol fee, just gas + LZ messaging fee;
+ *   slower). Throws if the chain pair has no adapter for that asset.
+ * - `"usdt0"` — deprecated alias for `"oft"`, kept for compatibility. It does not
+ *   restrict the route to USDT0; the token addresses decide the asset.
  * - `"lifi"` — force the LI.FI aggregator path (fast, charges a fee).
- * - `"auto"` — use USDT0 when both chains support it and tokens match, else LI.FI.
+ * - `"auto"` — use the native OFT mesh (USDT0 or XAUt0) when both chains deploy
+ *   the requested asset and the token addresses match, else LI.FI.
  *   This is the default.
  */
-type BridgeRoute = "auto" | "usdt0" | "lifi";
+type BridgeRoute = "auto" | "oft" | "usdt0" | "lifi";
 interface BridgeParams {
     fromChain: Chain;
     toChain: Chain;
@@ -179,11 +259,26 @@ interface BridgeParams {
     /** Recipient address — defaults to the signer */
     recipient?: string;
     /**
-     * Which bridge to use. Defaults to "auto" (USDT0 OFT when available, else LI.FI).
+     * Which bridge to use. Defaults to "auto" (native OFT when available, else LI.FI).
      * See {@link BridgeRoute}.
      */
     route?: BridgeRoute;
-    /** Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to bridge() */
+    /**
+     * Destination native token (wei) to airdrop to the recipient alongside the
+     * tokens — LayerZero's executor native-drop option, what bridge UIs call
+     * "gas on destination". Paid for by the sender through a larger
+     * {@link BridgeQuote.nativeFee}.
+     *
+     * Only supported on native OFT routes, and capped per pathway by the
+     * executor's configured `nativeCap`: asking for more makes `quoteSend`
+     * revert rather than silently clamping.
+     */
+    dstNativeDrop?: bigint;
+    /**
+     * Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to
+     * bridge(). Must have been quoted with the same `dstNativeDrop`, since the
+     * drop is part of what `nativeFee` pays for.
+     */
     quote?: BridgeQuote;
 }
 interface EarnDepositParams {
@@ -416,11 +511,14 @@ interface StableClient {
     quoteBridge(params: BridgeParams): Promise<BridgeQuote>;
     bridge(params: BridgeParams): Promise<OperationResult>;
     /**
-     * Expected delivery time for a USDT0 (LayerZero OFT) bridge, before sending.
-     * Throws for chain pairs with no USDT0 adapter — LI.FI carries its own ETA.
+     * Expected delivery time for a native OFT (LayerZero) bridge, before sending.
+     * Throws for chain pairs with no OFT adapter — LI.FI carries its own ETA.
+     *
+     * Pass `fromToken`/`toToken` to estimate a specific asset; omitting them
+     * estimates the USDT0 pathway.
      */
-    estimateBridgeTime(params: Pick<BridgeParams, "fromChain" | "toChain">): Promise<BridgeTimeEstimate>;
-    /** Delivery status of an in-flight USDT0 bridge, by source transaction hash. */
+    estimateBridgeTime(params: Pick<BridgeParams, "fromChain" | "toChain"> & Partial<Pick<BridgeParams, "fromToken" | "toToken">>): Promise<BridgeTimeEstimate>;
+    /** Delivery status of an in-flight OFT bridge, by source transaction hash. */
     trackBridge(srcTxHash: string): Promise<BridgeStatus>;
     quoteSwap(params: SwapParams): Promise<SwapQuote>;
     swap(params: SwapParams): Promise<OperationResult>;
@@ -484,9 +582,37 @@ interface ChainConfig {
 }
 declare const CHAIN_CONFIGS: Partial<Record<Chain, ChainConfig>>;
 
+/** An asset with its own LayerZero OFT mesh. Each has separate adapters per chain. */
+type BridgeAsset = "usdt0" | "xaut0";
+/** One asset's deployment on one chain. */
+interface BridgeTokenConfig {
+    /** The ERC-20 a holder owns — what gets debited, and approved when required */
+    address: Address;
+    /** Decimals of that ERC-20 on this chain */
+    decimals: number;
+    /** The OFT (or OFT Adapter) that escrows-or-burns on send */
+    oftAdapter: Address;
+    /**
+     * Whether `send` pulls the token via `transferFrom` and so needs an allowance.
+     * Only the lockbox chain does; remote deployments burn from the caller directly.
+     * Undefined means "approve when the allowance is short" — the safe default.
+     */
+    approvalRequired?: boolean;
+    /** False when the adapter exists but has no outbound send pathways configured */
+    lzOutbound?: boolean;
+}
 interface BridgeChainConfig extends ChainConfig {
     lzEid: number;
-    /** Only set on source chains that have an OFT Adapter deployed */
+    /**
+     * Which OFT assets this chain can bridge. A chain may carry one and not the
+     * other — BSC has XAUt0 but no USDT0 deployment.
+     */
+    tokens: Partial<Record<BridgeAsset, BridgeTokenConfig>>;
+    /**
+     * The USDT0 adapter. Predates XAUt0 and is part of the exported
+     * BRIDGE_CHAIN_CONFIGS surface, so it still means USDT0 specifically —
+     * prefer `tokens[asset].oftAdapter`.
+     */
     oftAdapter?: Address;
     /** False when the OFT adapter exists but has no outbound send pathways configured */
     lzOutbound?: boolean;
@@ -497,6 +623,11 @@ interface BridgeChainConfig extends ChainConfig {
     blockTimeSec?: number;
 }
 declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
+/**
+ * Which OFT asset a token address refers to on a chain, or undefined when the
+ * chain has no OFT deployment matching it.
+ */
+declare function bridgeAssetFor(cfg: BridgeChainConfig, token: string): BridgeAsset | undefined;
 /** Drop cached pathway configs and observed timings — forces the next estimate to refetch. */
 declare function clearBridgeEstimateCache(): void;
 
@@ -560,4 +691,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeDeliveryState, type BridgeParams, type BridgeQuote, type BridgeRoute, type BridgeStatus, type BridgeTimeEstimate, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeChainConfig, type BridgeDeliveryState, type BridgeGasEstimate, type BridgeOftFee, type BridgeOftQuote, type BridgeParams, type BridgeQuote, type BridgeRoute, type BridgeStatus, type BridgeTimeEstimate, type BridgeTokenConfig, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, bridgeAssetFor, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };