@stablechain/sdk 1.0.8 → 1.0.9

package/dist/index.d.cts

@@ -263,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.
  */
@@ -373,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;
     /**
@@ -711,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 */
@@ -728,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>>;
     /**
@@ -942,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 {
@@ -1001,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

@@ -263,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.
  */
@@ -373,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;
     /**
@@ -711,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 */
@@ -728,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>>;
     /**
@@ -942,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 {
@@ -1001,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,6 +1751,12 @@ 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, minDeliverySec) {
   const base = C[chain];
@@ -1764,6 +1771,8 @@ function bridgeChain(chain, lzEid, blockTimeSec, usdt0Adapter, minDeliverySec) {
   }
   const xaut0 = XAUT0_DEPLOYMENTS[chain];
   if (xaut0) tokens.xaut0 = xaut0;
+  const pyusd = PYUSD_DEPLOYMENTS[chain];
+  if (pyusd) tokens.pyusd = pyusd;
   return { ...base, lzEid, blockTimeSec, minDeliverySec, tokens, oftAdapter: usdt0Adapter };
 }
 var BRIDGE_CHAIN_CONFIGS = {
@@ -2394,7 +2403,7 @@ var LayerZeroService = class {
    * 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. This is what the DVNs are actually bound by, so it
+   * 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.
@@ -2437,7 +2446,8 @@ var LayerZeroService = class {
       );
       formulaSeconds = Number.isFinite(computed) ? computed : void 0;
     }
-    const resolved = resolveDeliverySeconds(formulaSeconds, observedSeconds, src.minDeliverySec);
+    const floor = srcToken.minDeliverySec ?? src.minDeliverySec;
+    const resolved = resolveDeliverySeconds(formulaSeconds, observedSeconds, floor);
     if (!resolved) {
       throw new StableQuoteError({
         provider: "layerzero",
@@ -2940,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.8",
+    "version": "1.0.9",
     "description": "Stable SDK",
     "keywords": ["stable", "usdt", "gasless", "web3", "yield"],
     "license": "MIT",