@stablechain/sdk 1.0.7 → 1.0.9

package/dist/index.d.cts

@@ -222,17 +222,23 @@ interface BridgeGasEstimate {
 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.
+     * Which input produced `seconds`. `"formula"` normally; `"floor"` when the
+     * source chain's measured minimum exceeded it (Ethereum, Arbitrum, Polygon,
+     * Bera, Flare); `"observed"` only when the pathway's ULN config could not be read.
+     */
+    source: "formula" | "floor" | "observed";
+    /**
+     * Median delivery time of recent delivered messages on this exact pathway, from
+     * LayerZero Scan. Reported for comparison but no longer preferred: a 50-message
+     * window can reach back months, so it answers from a ULN config the pathway has
+     * since moved off.
      */
     observedSeconds?: number;
     /**
      * LayerZero's documented estimate:
-     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`.
+     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`. What `seconds`
+     * reports unless the source chain's measured floor is higher.
      */
     formulaSeconds?: number;
     /** Source-chain block confirmations the DVNs wait for before attesting */
@@ -257,12 +263,12 @@ interface BridgeStatus {
 /**
  * Bridge route selection:
  * - `"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;
+ *   addresses name, USDT0, XAUt0 or PYUSD (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 the native OFT mesh (USDT0 or XAUt0) when both chains deploy
+ * - `"auto"` — use the native OFT mesh (USDT0, XAUt0 or PYUSD) when both chains deploy
  *   the requested asset and the token addresses match, else LI.FI.
  *   This is the default.
  */
@@ -367,7 +373,7 @@ interface BridgeCalldata {
     /** The source chain every step must be sent on */
     chainId: number;
     /** Which OFT mesh this send moves through */
-    asset: "usdt0" | "xaut0";
+    asset: "usdt0" | "xaut0" | "pyusd";
     /** The quote these steps were built from, whether supplied or freshly read */
     quote: BridgeQuote;
     /**
@@ -705,7 +711,7 @@ 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";
+type BridgeAsset = "usdt0" | "xaut0" | "pyusd";
 /** One asset's deployment on one chain. */
 interface BridgeTokenConfig {
     /** The ERC-20 a holder owns — what gets debited, and approved when required */
@@ -722,12 +728,18 @@ interface BridgeTokenConfig {
     approvalRequired?: boolean;
     /** False when the adapter exists but has no outbound send pathways configured */
     lzOutbound?: boolean;
+    /**
+     * Overrides the chain's {@link BridgeChainConfig.minDeliverySec} for sends of
+     * this asset. The chain's floor was measured on one asset's pathways; another
+     * asset's DVNs may not share its wait (0 means no floor).
+     */
+    minDeliverySec?: number;
 }
 interface BridgeChainConfig extends ChainConfig {
     lzEid: number;
     /**
-     * Which OFT assets this chain can bridge. A chain may carry one and not the
-     * other — BSC has XAUt0 but no USDT0 deployment.
+     * Which OFT assets this chain can bridge. A chain may carry some and not the
+     * others — BSC has XAUt0 but no USDT0 deployment.
      */
     tokens: Partial<Record<BridgeAsset, BridgeTokenConfig>>;
     /**
@@ -743,6 +755,26 @@ interface BridgeChainConfig extends ChainConfig {
      * requirement into a wall-clock estimate. Measured from mainnet, 2026-07-30.
      */
     blockTimeSec?: number;
+    /**
+     * Floor on delivery time, in seconds, for sends *from* this chain — set only
+     * where the confirmation count is demonstrably not the whole wait.
+     *
+     * Two things sit outside the formula: DVN attestation and destination execution,
+     * a roughly fixed overhead, and on Ethereum and Arbitrum a hold until the send
+     * finalizes on the beacon chain. Where confirmations are high the overhead is lost
+     * in the rounding — Optimism's 1000 and X Layer's 9000 both land within 0.5% of
+     * observed. Where they are low it dominates: Arbitrum's 60 confirmations compute
+     * to ~19s against a real ~18min, Ethereum's 65 to ~13min against ~17min, Polygon's
+     * 32 to ~52s against a real ~70s, Flare's 500 to ~9min against a real ~10min.
+     *
+     * Each figure is taken from deliveries LayerZero Scan held on 2026-08-27, no older
+     * than 45 days — the ceiling of that spread for the two finality-bound chains, so
+     * the estimate errs long, and the median for the rest. Flare's is a median across
+     * its destinations rather than one pathway's, since the hub pathway alone had only
+     * six recent sends to go on; those settled at ~9m30s and the busier pathways to
+     * Ethereum, Arbitrum, Plasma, Polygon and Optimism between ~9m20s and ~10m10s.
+     */
+    minDeliverySec?: number;
 }
 declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
 /**
@@ -916,6 +948,12 @@ declare function clearBridgeEstimateCache(): void;
 declare function buildLzOptions(gasLimit?: bigint, nativeDrop?: bigint, dropReceiver?: Address): Hex;
 
 declare const STABLE_USDT_ADDRESS: Address;
+/**
+ * PayPal USD on Stable mainnet — 6 decimals, ERC-3009 capable. Its EIP-712 domain is
+ * `{ name: "PayPal USD", version: "1" }`, which the ERC-3009 actions resolve on their
+ * own (verified against the contract's DOMAIN_SEPARATOR, 2026-10-20).
+ */
+declare const STABLE_PYUSD_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
 
 declare class StableError extends BaseError {
@@ -975,4 +1013,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeCalldata, type BridgeCalldataStep, 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, OFT_ADAPTER_ABI, type OperationResult, type PrepareBridgeParams, 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, buildLzOptions, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeCalldata, type BridgeCalldataStep, 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, OFT_ADAPTER_ABI, type OperationResult, type PrepareBridgeParams, STABLE_PYUSD_ADDRESS, 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, buildLzOptions, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };

package/dist/index.d.ts

@@ -222,17 +222,23 @@ interface BridgeGasEstimate {
 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.
+     * Which input produced `seconds`. `"formula"` normally; `"floor"` when the
+     * source chain's measured minimum exceeded it (Ethereum, Arbitrum, Polygon,
+     * Bera, Flare); `"observed"` only when the pathway's ULN config could not be read.
+     */
+    source: "formula" | "floor" | "observed";
+    /**
+     * Median delivery time of recent delivered messages on this exact pathway, from
+     * LayerZero Scan. Reported for comparison but no longer preferred: a 50-message
+     * window can reach back months, so it answers from a ULN config the pathway has
+     * since moved off.
      */
     observedSeconds?: number;
     /**
      * LayerZero's documented estimate:
-     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`.
+     * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`. What `seconds`
+     * reports unless the source chain's measured floor is higher.
      */
     formulaSeconds?: number;
     /** Source-chain block confirmations the DVNs wait for before attesting */
@@ -257,12 +263,12 @@ interface BridgeStatus {
 /**
  * Bridge route selection:
  * - `"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;
+ *   addresses name, USDT0, XAUt0 or PYUSD (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 the native OFT mesh (USDT0 or XAUt0) when both chains deploy
+ * - `"auto"` — use the native OFT mesh (USDT0, XAUt0 or PYUSD) when both chains deploy
  *   the requested asset and the token addresses match, else LI.FI.
  *   This is the default.
  */
@@ -367,7 +373,7 @@ interface BridgeCalldata {
     /** The source chain every step must be sent on */
     chainId: number;
     /** Which OFT mesh this send moves through */
-    asset: "usdt0" | "xaut0";
+    asset: "usdt0" | "xaut0" | "pyusd";
     /** The quote these steps were built from, whether supplied or freshly read */
     quote: BridgeQuote;
     /**
@@ -705,7 +711,7 @@ 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";
+type BridgeAsset = "usdt0" | "xaut0" | "pyusd";
 /** One asset's deployment on one chain. */
 interface BridgeTokenConfig {
     /** The ERC-20 a holder owns — what gets debited, and approved when required */
@@ -722,12 +728,18 @@ interface BridgeTokenConfig {
     approvalRequired?: boolean;
     /** False when the adapter exists but has no outbound send pathways configured */
     lzOutbound?: boolean;
+    /**
+     * Overrides the chain's {@link BridgeChainConfig.minDeliverySec} for sends of
+     * this asset. The chain's floor was measured on one asset's pathways; another
+     * asset's DVNs may not share its wait (0 means no floor).
+     */
+    minDeliverySec?: number;
 }
 interface BridgeChainConfig extends ChainConfig {
     lzEid: number;
     /**
-     * Which OFT assets this chain can bridge. A chain may carry one and not the
-     * other — BSC has XAUt0 but no USDT0 deployment.
+     * Which OFT assets this chain can bridge. A chain may carry some and not the
+     * others — BSC has XAUt0 but no USDT0 deployment.
      */
     tokens: Partial<Record<BridgeAsset, BridgeTokenConfig>>;
     /**
@@ -743,6 +755,26 @@ interface BridgeChainConfig extends ChainConfig {
      * requirement into a wall-clock estimate. Measured from mainnet, 2026-07-30.
      */
     blockTimeSec?: number;
+    /**
+     * Floor on delivery time, in seconds, for sends *from* this chain — set only
+     * where the confirmation count is demonstrably not the whole wait.
+     *
+     * Two things sit outside the formula: DVN attestation and destination execution,
+     * a roughly fixed overhead, and on Ethereum and Arbitrum a hold until the send
+     * finalizes on the beacon chain. Where confirmations are high the overhead is lost
+     * in the rounding — Optimism's 1000 and X Layer's 9000 both land within 0.5% of
+     * observed. Where they are low it dominates: Arbitrum's 60 confirmations compute
+     * to ~19s against a real ~18min, Ethereum's 65 to ~13min against ~17min, Polygon's
+     * 32 to ~52s against a real ~70s, Flare's 500 to ~9min against a real ~10min.
+     *
+     * Each figure is taken from deliveries LayerZero Scan held on 2026-08-27, no older
+     * than 45 days — the ceiling of that spread for the two finality-bound chains, so
+     * the estimate errs long, and the median for the rest. Flare's is a median across
+     * its destinations rather than one pathway's, since the hub pathway alone had only
+     * six recent sends to go on; those settled at ~9m30s and the busier pathways to
+     * Ethereum, Arbitrum, Plasma, Polygon and Optimism between ~9m20s and ~10m10s.
+     */
+    minDeliverySec?: number;
 }
 declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
 /**
@@ -916,6 +948,12 @@ declare function clearBridgeEstimateCache(): void;
 declare function buildLzOptions(gasLimit?: bigint, nativeDrop?: bigint, dropReceiver?: Address): Hex;
 
 declare const STABLE_USDT_ADDRESS: Address;
+/**
+ * PayPal USD on Stable mainnet — 6 decimals, ERC-3009 capable. Its EIP-712 domain is
+ * `{ name: "PayPal USD", version: "1" }`, which the ERC-3009 actions resolve on their
+ * own (verified against the contract's DOMAIN_SEPARATOR, 2026-10-20).
+ */
+declare const STABLE_PYUSD_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
 
 declare class StableError extends BaseError {
@@ -975,4 +1013,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeCalldata, type BridgeCalldataStep, 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, OFT_ADAPTER_ABI, type OperationResult, type PrepareBridgeParams, 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, buildLzOptions, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeAsset, type BridgeCalldata, type BridgeCalldataStep, 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, OFT_ADAPTER_ABI, type OperationResult, type PrepareBridgeParams, STABLE_PYUSD_ADDRESS, 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, buildLzOptions, clearBridgeEstimateCache, createStable, createStableReader, erc3009Actions };

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   ERC3009_ABI,
+  STABLE_PYUSD_ADDRESS,
   STABLE_USDT_ADDRESS,
   STABLE_VAULT_ADDRESS,
   StableBulkError,
@@ -18,7 +19,7 @@ import {
   signTransferAuthorization,
   transferWithAuthorization,
   verifyAuthorization
-} from "./chunk-VS6GBRDF.js";
+} from "./chunk-FN7OKBRH.js";
 
 // src/stable.ts
 import {
@@ -1750,8 +1751,14 @@ var XAUT0_DEPLOYMENTS = {
   ["plasma" /* Plasma */]: { address: "0x1B64B9025EEbb9A6239575dF9Ea4b9Ac46D4d193", decimals: 6, oftAdapter: "0x63aB93cBC9d4ecD9c4947b1A38F458147C08E6F7", approvalRequired: false },
   ["bsc" /* BSC */]: { address: "0x21cAef8A43163Eea865baeE23b9C2E327696A3bf", decimals: 6, oftAdapter: "0x53C3A64c8942288e12813C1F8457Db45980BcfC2", approvalRequired: false }
 };
+var PYUSD_DEPLOYMENTS = {
+  // No floor: unlike USDT0's, this pathway's DVNs don't hold for finality. 15
+  // confirmations compute to ~184s; LayerZero Scan observed ~202s (2026-10-27).
+  ["ethereum" /* Ethereum */]: { address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8", decimals: 6, oftAdapter: "0xa2C323fE5A74aDffAd2bf3E007E36bb029606444", approvalRequired: false, minDeliverySec: 0 },
+  ["stable" /* Stable */]: { address: STABLE_PYUSD_ADDRESS, decimals: 6, oftAdapter: "0x2eb79387Fa1a6EF6DC8E25401C8fdc291Cc542C7", approvalRequired: false }
+};
 var USDT0_LOCKBOX_CHAINS = /* @__PURE__ */ new Set(["ethereum" /* Ethereum */, "sepolia" /* Sepolia */]);
-function bridgeChain(chain, lzEid, blockTimeSec, usdt0Adapter) {
+function bridgeChain(chain, lzEid, blockTimeSec, usdt0Adapter, minDeliverySec) {
   const base = C[chain];
   const tokens = {};
   if (usdt0Adapter) {
@@ -1764,7 +1771,9 @@ function bridgeChain(chain, lzEid, blockTimeSec, usdt0Adapter) {
   }
   const xaut0 = XAUT0_DEPLOYMENTS[chain];
   if (xaut0) tokens.xaut0 = xaut0;
-  return { ...base, lzEid, blockTimeSec, tokens, oftAdapter: usdt0Adapter };
+  const pyusd = PYUSD_DEPLOYMENTS[chain];
+  if (pyusd) tokens.pyusd = pyusd;
+  return { ...base, lzEid, blockTimeSec, minDeliverySec, tokens, oftAdapter: usdt0Adapter };
 }
 var BRIDGE_CHAIN_CONFIGS = {
   // ─── Testnet ───────────────────────────────────────────────────────────────
@@ -1772,18 +1781,18 @@ var BRIDGE_CHAIN_CONFIGS = {
   ["stable-testnet" /* StableTestnet */]: bridgeChain("stable-testnet" /* StableTestnet */, 40374, 0.7, "0x779Ded0c9e1022225f8E0630b35a9b54bE713736"),
   // ─── Mainnet ──────────────────────────────────────────────────────────────
   ["stable" /* Stable */]: bridgeChain("stable" /* Stable */, 30396, 0.7, "0xedaba024be4d87974d5aB11C6Dd586963CcCB027"),
-  ["ethereum" /* Ethereum */]: bridgeChain("ethereum" /* Ethereum */, 30101, 12, "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee"),
-  ["arbitrum" /* Arbitrum */]: bridgeChain("arbitrum" /* Arbitrum */, 30110, 0.25, "0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92"),
+  ["ethereum" /* Ethereum */]: bridgeChain("ethereum" /* Ethereum */, 30101, 12, "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee", 1170),
+  ["arbitrum" /* Arbitrum */]: bridgeChain("arbitrum" /* Arbitrum */, 30110, 0.25, "0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92", 1350),
   ["ink" /* Ink */]: bridgeChain("ink" /* Ink */, 30339, 1, "0x1cB6De532588fCA4a21B7209DE7C456AF8434A65"),
-  ["bera" /* Bera */]: bridgeChain("bera" /* Bera */, 30362, 2, "0x3Dc96399109df5ceb2C226664A086140bD0379cB"),
+  ["bera" /* Bera */]: bridgeChain("bera" /* Bera */, 30362, 2, "0x3Dc96399109df5ceb2C226664A086140bD0379cB", 135),
   ["megaeth" /* MegaETH */]: bridgeChain("megaeth" /* MegaETH */, 30398, 1, "0x9151434b16b9763660705744891fa906f660ecc5"),
   ["hyperevm" /* HyperEVM */]: bridgeChain("hyperevm" /* HyperEVM */, 30367, 1, "0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98"),
-  ["polygon" /* Polygon */]: bridgeChain("polygon" /* Polygon */, 30109, 1.5, "0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13"),
+  ["polygon" /* Polygon */]: bridgeChain("polygon" /* Polygon */, 30109, 1.5, "0x6BA10300f0DC58B7a1e4c0e41f5daBb7D7829e13", 70),
   ["plasma" /* Plasma */]: bridgeChain("plasma" /* Plasma */, 30383, 1, "0x02ca37966753bDdDf11216B73B16C1dE756A7CF9"),
   ["optimism" /* Optimism */]: bridgeChain("optimism" /* Optimism */, 30111, 2, "0xF03b4d9AC1D5d1E7c4cEf54C2A313b9fe051A0aD"),
   ["unichain" /* Unichain */]: bridgeChain("unichain" /* Unichain */, 30320, 1, "0xc07bE8994D035631c36fb4a89C918CeFB2f03EC3"),
   ["sei" /* Sei */]: bridgeChain("sei" /* Sei */, 30280, 0.5, "0x56Fe74A2e3b484b921c447357203431a3485CC60"),
-  ["flare" /* Flare */]: bridgeChain("flare" /* Flare */, 30295, 1.1, "0x567287d2A9829215a37e3B88843d32f9221E7588"),
+  ["flare" /* Flare */]: bridgeChain("flare" /* Flare */, 30295, 1.1, "0x567287d2A9829215a37e3B88843d32f9221E7588", 600),
   ["xlayer" /* XLayer */]: bridgeChain("xlayer" /* XLayer */, 30274, 1, "0x94BCCa6bdfd6A61817Ab0E960bFedE4984505554"),
   ["rootstock" /* Rootstock */]: bridgeChain("rootstock" /* Rootstock */, 30333, 31, "0x1a594d5d5d1c426281C1064B07f23F57B2716B61"),
   // XAUt0 only — BSC has no USDT0 deployment. Block time measured 2026-08-20.
@@ -1964,6 +1973,14 @@ function median(values) {
   const mid = Math.floor(sorted.length / 2);
   return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
 }
+function resolveDeliverySeconds(formulaSeconds, observedSeconds, minDeliverySec) {
+  const base = formulaSeconds ?? observedSeconds;
+  if (base === void 0) return void 0;
+  if (minDeliverySec !== void 0 && minDeliverySec > base) {
+    return { seconds: minDeliverySec, source: "floor" };
+  }
+  return { seconds: base, source: formulaSeconds !== void 0 ? "formula" : "observed" };
+}
 var WORKER_EXECUTOR = 1;
 var OPTION_LZRECEIVE = 1;
 var OPTION_NATIVE_DROP = 2;
@@ -2383,16 +2400,22 @@ var LayerZeroService = class {
   /**
    * Estimate how long a USDT0 bridge will take, end to end.
    *
-   * Two independent inputs, both cheap:
-   *  - **observed** — median delivery time of recent messages LayerZero Scan has
-   *    already settled on this exact pathway.
-   *  - **formula** — LayerZero's documented estimate from the on-chain ULN config:
-   *    `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`.
+   * The number comes from the pathway's live ULN config:
+   * `srcBlockTime × confirmations + dstBlockTime × (2 + dvnCount)`, floored at the
+   * source chain's {@link BridgeChainConfig.minDeliverySec} where the confirmation
+   * count is not the whole wait (unless the asset sets its own floor). This is what the DVNs are actually bound by, so it
+   * tracks a config change the moment it lands — and on every pathway that is purely
+   * confirmation-bound it agrees with both usdt0.to's own estimate and the delivery
+   * times Scan reports to well under a percent.
    *
-   * `observed` wins when available. The formula assumes `confirmations` is the whole
-   * wait, which holds for L1 sources but badly understates rollups: Arbitrum→Stable
-   * computes to ~15s (60 blocks × 0.25s) while real deliveries take ~18min, because
-   * the DVNs wait for the L2 batch to finalize on L1.
+   * The observed median of recent deliveries on this exact pathway is fetched too
+   * and reported as {@link BridgeTimeEstimate.observedSeconds}, but it no longer
+   * drives `seconds`. History lags the config: after Optimism→Stable was raised to
+   * 1000 confirmations, a 50-message window still reaching back 261 days put the
+   * median at ~15min against a real ~33min, and pathways quiet for months (Unichain,
+   * XAUt0 from Arbitrum) were answering from configs that no longer exist. It stays
+   * the fallback for the case the formula cannot be computed at all — an RPC that
+   * will not serve the ULN read.
    */
   async estimateBridgeTime({
     fromChain,
@@ -2423,16 +2446,16 @@ var LayerZeroService = class {
       );
       formulaSeconds = Number.isFinite(computed) ? computed : void 0;
     }
-    const seconds = observedSeconds ?? formulaSeconds;
-    if (seconds === void 0) {
+    const floor = srcToken.minDeliverySec ?? src.minDeliverySec;
+    const resolved = resolveDeliverySeconds(formulaSeconds, observedSeconds, floor);
+    if (!resolved) {
       throw new StableQuoteError({
         provider: "layerzero",
         shortMessage: `estimateBridgeTime: no pathway data for ${fromChain}\u2192${toChain}`
       });
     }
     return {
-      seconds,
-      source: observedSeconds !== void 0 ? "observed" : "formula",
+      ...resolved,
       observedSeconds,
       formulaSeconds,
       confirmations: Number.isFinite(uln?.confirmations) ? uln?.confirmations : void 0,
@@ -2927,6 +2950,7 @@ export {
   ERC3009_ABI,
   Network,
   OFT_ADAPTER_ABI,
+  STABLE_PYUSD_ADDRESS,
   STABLE_USDT_ADDRESS,
   STABLE_VAULT_ADDRESS,
   StableBulkError,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@stablechain/sdk",
-    "version": "1.0.7",
+    "version": "1.0.9",
     "description": "Stable SDK",
     "keywords": ["stable", "usdt", "gasless", "web3", "yield"],
     "license": "MIT",