@stablechain/sdk 1.0.4 → 1.0.6

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import { erc3009Actions } from './erc3009.cjs';
+export { Authorization, AuthorizationUsage, CancelAuthorizationParameters, ERC3009_ABI, Erc3009DomainOverrides, GetAuthorizationStateParameters, GetAuthorizationUsageParameters, PreparedAuthorizationCall, ReceiveWithAuthorizationParameters, SignReceiveAuthorizationParameters, SignTransferAuthorizationParameters, SignedAuthorization, TransferWithAuthorizationParameters, VerifyAuthorizationParameters, VerifyAuthorizationResult, VerifyFailureReason, cancelAuthorization, getAuthorizationState, getAuthorizationUsage, prepareTransferWithAuthorization, receiveWithAuthorization, signReceiveAuthorization, signTransferAuthorization, transferWithAuthorization, verifyAuthorization } from './erc3009.cjs';
 import { Account, Transport, WalletClient, Address, BaseError } from 'viem';
 
 interface EarnConfig {
@@ -86,29 +88,164 @@ declare enum Chain {
     MegaETH = "megaeth",
     Base = "base",
     BSC = "bsc",
-    HyperEVM = "hyperevm"
+    HyperEVM = "hyperevm",
+    Polygon = "polygon",
+    Plasma = "plasma",
+    Optimism = "optimism",
+    Unichain = "unichain",
+    Sei = "sei",
+    Flare = "flare",
+    XLayer = "xlayer",
+    Rootstock = "rootstock"
 }
 declare enum Network {
     Mainnet = "mainnet",
     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;
+    /**
+     * 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;
+}
+/**
+ * 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`
+ * source blocks. Destination execution is a few blocks on top of that.
+ */
+interface BridgeTimeEstimate {
+    /** Best available estimate, in seconds — prefer this for display */
+    seconds: number;
+    /** Which input produced `seconds` — see {@link BridgeTimeEstimate.observedSeconds} */
+    source: "observed" | "formula";
+    /**
+     * Median delivery time of recent delivered messages on this exact pathway,
+     * from LayerZero Scan. More trustworthy than `formulaSeconds` — notably on
+     * rollup sources, where DVNs wait for L1 finality rather than raw block count.
+     */
+    observedSeconds?: number;
+    /**
+     * LayerZero's documented estimate:
+     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`.
+     */
+    formulaSeconds?: number;
+    /** Source-chain block confirmations the DVNs wait for before attesting */
+    confirmations?: number;
+    /** Number of DVNs (required + optional) verifying this pathway */
+    dvnCount?: number;
+}
+/** Delivery state of an in-flight USDT0 bridge, normalized from LayerZero Scan. */
+type BridgeDeliveryState = "pending" | "inflight" | "delivered" | "failed";
+interface BridgeStatus {
+    state: BridgeDeliveryState;
+    /** Raw LayerZero Scan status, e.g. "INFLIGHT" | "DELIVERED" | "FAILED" | "BLOCKED" */
+    raw?: string;
+    srcTxHash: string;
+    /** Destination transaction hash — present once delivered */
+    dstTxHash?: string;
+    /** Seconds since the source transaction was mined */
+    elapsedSeconds?: number;
+    /** Human-facing tracking page */
+    scanUrl: string;
 }
 /**
  * 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;
@@ -122,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 {
@@ -358,8 +510,25 @@ interface StableClient {
     transfer(params: TransferParams): Promise<OperationResult>;
     quoteBridge(params: BridgeParams): Promise<BridgeQuote>;
     bridge(params: BridgeParams): Promise<OperationResult>;
+    /**
+     * 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"> & 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>;
+    /**
+     * ERC-3009 gasless transfers ("Transfer With Authorization"). Sign a portable
+     * authorization the payer can hand off, then have anyone (a relayer, the
+     * recipient, or the enterprise gas-waiver rail) settle it on-chain. See
+     * {@link erc3009Actions} for the individual viem-style actions.
+     */
+    authorization: ReturnType<typeof erc3009Actions>;
     earn: {
         deposit(params: EarnDepositParams): Promise<EarnResult>;
         bulkDeposit(items: EarnDepositParams[], options?: BulkDepositOptions): Promise<BulkEarnResult>;
@@ -413,14 +582,54 @@ 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;
+    /**
+     * Average seconds per block, used to turn LayerZero's block-confirmation
+     * requirement into a wall-clock estimate. Measured from mainnet, 2026-07-30.
+     */
+    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;
 
 declare const STABLE_USDT_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
@@ -449,12 +658,12 @@ declare class StableQuoteError extends StableError {
     });
 }
 declare class StableTransactionError extends StableError {
-    phase: "approve" | "send" | "receipt" | "switch_chain";
+    phase: "approve" | "send" | "receipt" | "switch_chain" | "sign";
     txHash?: `0x${string}`;
     chainId?: number;
     revertReason?: string;
     constructor(args: {
-        phase: "approve" | "send" | "receipt" | "switch_chain";
+        phase: "approve" | "send" | "receipt" | "switch_chain" | "sign";
         shortMessage: string;
         txHash?: `0x${string}`;
         chainId?: number;
@@ -482,4 +691,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeParams, type BridgeQuote, type BridgeRoute, 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, createStable, createStableReader };
+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

@@ -1,3 +1,5 @@
+import { erc3009Actions } from './erc3009.js';
+export { Authorization, AuthorizationUsage, CancelAuthorizationParameters, ERC3009_ABI, Erc3009DomainOverrides, GetAuthorizationStateParameters, GetAuthorizationUsageParameters, PreparedAuthorizationCall, ReceiveWithAuthorizationParameters, SignReceiveAuthorizationParameters, SignTransferAuthorizationParameters, SignedAuthorization, TransferWithAuthorizationParameters, VerifyAuthorizationParameters, VerifyAuthorizationResult, VerifyFailureReason, cancelAuthorization, getAuthorizationState, getAuthorizationUsage, prepareTransferWithAuthorization, receiveWithAuthorization, signReceiveAuthorization, signTransferAuthorization, transferWithAuthorization, verifyAuthorization } from './erc3009.js';
 import { Account, Transport, WalletClient, Address, BaseError } from 'viem';
 
 interface EarnConfig {
@@ -86,29 +88,164 @@ declare enum Chain {
     MegaETH = "megaeth",
     Base = "base",
     BSC = "bsc",
-    HyperEVM = "hyperevm"
+    HyperEVM = "hyperevm",
+    Polygon = "polygon",
+    Plasma = "plasma",
+    Optimism = "optimism",
+    Unichain = "unichain",
+    Sei = "sei",
+    Flare = "flare",
+    XLayer = "xlayer",
+    Rootstock = "rootstock"
 }
 declare enum Network {
     Mainnet = "mainnet",
     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;
+    /**
+     * 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;
+}
+/**
+ * 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`
+ * source blocks. Destination execution is a few blocks on top of that.
+ */
+interface BridgeTimeEstimate {
+    /** Best available estimate, in seconds — prefer this for display */
+    seconds: number;
+    /** Which input produced `seconds` — see {@link BridgeTimeEstimate.observedSeconds} */
+    source: "observed" | "formula";
+    /**
+     * Median delivery time of recent delivered messages on this exact pathway,
+     * from LayerZero Scan. More trustworthy than `formulaSeconds` — notably on
+     * rollup sources, where DVNs wait for L1 finality rather than raw block count.
+     */
+    observedSeconds?: number;
+    /**
+     * LayerZero's documented estimate:
+     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`.
+     */
+    formulaSeconds?: number;
+    /** Source-chain block confirmations the DVNs wait for before attesting */
+    confirmations?: number;
+    /** Number of DVNs (required + optional) verifying this pathway */
+    dvnCount?: number;
+}
+/** Delivery state of an in-flight USDT0 bridge, normalized from LayerZero Scan. */
+type BridgeDeliveryState = "pending" | "inflight" | "delivered" | "failed";
+interface BridgeStatus {
+    state: BridgeDeliveryState;
+    /** Raw LayerZero Scan status, e.g. "INFLIGHT" | "DELIVERED" | "FAILED" | "BLOCKED" */
+    raw?: string;
+    srcTxHash: string;
+    /** Destination transaction hash — present once delivered */
+    dstTxHash?: string;
+    /** Seconds since the source transaction was mined */
+    elapsedSeconds?: number;
+    /** Human-facing tracking page */
+    scanUrl: string;
 }
 /**
  * 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;
@@ -122,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 {
@@ -358,8 +510,25 @@ interface StableClient {
     transfer(params: TransferParams): Promise<OperationResult>;
     quoteBridge(params: BridgeParams): Promise<BridgeQuote>;
     bridge(params: BridgeParams): Promise<OperationResult>;
+    /**
+     * 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"> & 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>;
+    /**
+     * ERC-3009 gasless transfers ("Transfer With Authorization"). Sign a portable
+     * authorization the payer can hand off, then have anyone (a relayer, the
+     * recipient, or the enterprise gas-waiver rail) settle it on-chain. See
+     * {@link erc3009Actions} for the individual viem-style actions.
+     */
+    authorization: ReturnType<typeof erc3009Actions>;
     earn: {
         deposit(params: EarnDepositParams): Promise<EarnResult>;
         bulkDeposit(items: EarnDepositParams[], options?: BulkDepositOptions): Promise<BulkEarnResult>;
@@ -413,14 +582,54 @@ 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;
+    /**
+     * Average seconds per block, used to turn LayerZero's block-confirmation
+     * requirement into a wall-clock estimate. Measured from mainnet, 2026-07-30.
+     */
+    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;
 
 declare const STABLE_USDT_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
@@ -449,12 +658,12 @@ declare class StableQuoteError extends StableError {
     });
 }
 declare class StableTransactionError extends StableError {
-    phase: "approve" | "send" | "receipt" | "switch_chain";
+    phase: "approve" | "send" | "receipt" | "switch_chain" | "sign";
     txHash?: `0x${string}`;
     chainId?: number;
     revertReason?: string;
     constructor(args: {
-        phase: "approve" | "send" | "receipt" | "switch_chain";
+        phase: "approve" | "send" | "receipt" | "switch_chain" | "sign";
         shortMessage: string;
         txHash?: `0x${string}`;
         chainId?: number;
@@ -482,4 +691,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeParams, type BridgeQuote, type BridgeRoute, 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, createStable, createStableReader };
+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 };