@paxoslabs/amplify-sdk 0.4.2 → 0.4.3-alpha.1

package/dist/core.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkWZXCJAKM_js = require('./chunk-WZXCJAKM.js');
-var chunkBQG3XKTU_js = require('./chunk-BQG3XKTU.js');
+var chunkJTURYJHV_js = require('./chunk-JTURYJHV.js');
+var chunkPKGFLHZA_js = require('./chunk-PKGFLHZA.js');
 var viem = require('viem');
 
 async function getVaultAllowance({
@@ -10,7 +10,7 @@ async function getVaultAllowance({
   recipientAddress,
   chainId
 }) {
-  const client = await chunkBQG3XKTU_js.getClient(chainId);
+  const client = await chunkPKGFLHZA_js.getClient(chainId);
   const allowance = await client.readContract({
     abi: viem.erc20Abi,
     address: tokenAddress,
@@ -23,7 +23,7 @@ async function getTotalSupply({
   tokenAddress,
   chainId
 }) {
-  const client = await chunkBQG3XKTU_js.getClient(chainId);
+  const client = await chunkPKGFLHZA_js.getClient(chainId);
   const totalSupply = await client.readContract({
     abi: viem.erc20Abi,
     address: tokenAddress,
@@ -73,10 +73,10 @@ var ChainlinkAbi = [
 async function getEthPrice({
   chainId
 }) {
-  const client = await chunkBQG3XKTU_js.getClient(chainId);
+  const client = await chunkPKGFLHZA_js.getClient(chainId);
   const priceData = await client.readContract({
     abi: ChainlinkAbi,
-    address: chunkBQG3XKTU_js.CHAINLINK_ADDRESS,
+    address: chunkPKGFLHZA_js.CHAINLINK_ADDRESS,
     functionName: "latestRoundData",
     args: []
   });
@@ -1097,7 +1097,7 @@ var getPausedStates = async ({
   tellerAddress,
   chainId
 }) => {
-  const client = await chunkBQG3XKTU_js.getClient(chainId);
+  const client = await chunkPKGFLHZA_js.getClient(chainId);
   const results = await client.multicall({
     contracts: [
       {
@@ -1106,7 +1106,7 @@ var getPausedStates = async ({
         functionName: "isPaused"
       },
       {
-        abi: chunkWZXCJAKM_js.AccountantAbi,
+        abi: chunkJTURYJHV_js.AccountantAbi,
         address: accountantAddress,
         functionName: "accountantState"
       }
@@ -1118,7 +1118,7 @@ var getPausedStates = async ({
 // src/api/withdraw-assets.ts
 var assetsCache = null;
 function constructUrl(params) {
-  const withdrawAssetsUrl = `${chunkBQG3XKTU_js.API_BASE_URL}/v1/protocol/withdraw-assets`;
+  const withdrawAssetsUrl = `${chunkPKGFLHZA_js.API_BASE_URL}/v1/protocol/withdraw-assets`;
   if (!params) return withdrawAssetsUrl;
   const queryParams = new URLSearchParams();
   if (params.chainId) queryParams.append("chainId", params.chainId.toString());
@@ -1149,7 +1149,7 @@ async function fetchWithdrawAssets(params) {
 }
 
 // src/api/solver-slippage.ts
-async function getAssetSlippage(chainId, vaultAddress, tokenAddress, defaultSlippage = chunkBQG3XKTU_js.DEFAULT_SLIPPAGE_BPS) {
+async function getAssetSlippage(chainId, vaultAddress, tokenAddress, defaultSlippage = chunkPKGFLHZA_js.DEFAULT_SLIPPAGE_BPS) {
   try {
     const withdrawAssets = await fetchWithdrawAssets();
     if (!withdrawAssets) {
@@ -1179,7 +1179,7 @@ var getPreviewFee = async ({
   contractAddress,
   chainId
 }) => {
-  const client = await chunkBQG3XKTU_js.getClient(chainId);
+  const client = await chunkPKGFLHZA_js.getClient(chainId);
   const rate = await client.readContract({
     abi: TellerAbi,
     address: contractAddress,
@@ -1191,23 +1191,23 @@ var getPreviewFee = async ({
 
 Object.defineProperty(exports, "getErc20Allowance", {
   enumerable: true,
-  get: function () { return chunkWZXCJAKM_js.getErc20Allowance; }
+  get: function () { return chunkJTURYJHV_js.getErc20Allowance; }
 });
 Object.defineProperty(exports, "getErc20Balance", {
   enumerable: true,
-  get: function () { return chunkWZXCJAKM_js.getErc20Balance; }
+  get: function () { return chunkJTURYJHV_js.getErc20Balance; }
 });
 Object.defineProperty(exports, "getErc20Decimals", {
   enumerable: true,
-  get: function () { return chunkWZXCJAKM_js.getErc20Decimals; }
+  get: function () { return chunkJTURYJHV_js.getErc20Decimals; }
 });
 Object.defineProperty(exports, "getRateInQuoteWithAssetDecimals", {
   enumerable: true,
-  get: function () { return chunkWZXCJAKM_js.getRateInQuoteWithAssetDecimals; }
+  get: function () { return chunkJTURYJHV_js.getRateInQuoteWithAssetDecimals; }
 });
 Object.defineProperty(exports, "toChainId", {
   enumerable: true,
-  get: function () { return chunkBQG3XKTU_js.toChainId; }
+  get: function () { return chunkPKGFLHZA_js.toChainId; }
 });
 exports.fetchWithdrawAssets = fetchWithdrawAssets;
 exports.getAssetSlippage = getAssetSlippage;

package/dist/core.mjs

@@ -1,7 +1,7 @@
-import { AccountantAbi } from './chunk-VZED4E3L.mjs';
-export { getErc20Allowance, getErc20Balance, getErc20Decimals, getRateInQuoteWithAssetDecimals } from './chunk-VZED4E3L.mjs';
-import { DEFAULT_SLIPPAGE_BPS, getClient, CHAINLINK_ADDRESS, API_BASE_URL } from './chunk-RW7PZETN.mjs';
-export { toChainId } from './chunk-RW7PZETN.mjs';
+import { AccountantAbi } from './chunk-USF4CU2K.mjs';
+export { getErc20Allowance, getErc20Balance, getErc20Decimals, getRateInQuoteWithAssetDecimals } from './chunk-USF4CU2K.mjs';
+import { DEFAULT_SLIPPAGE_BPS, getClient, CHAINLINK_ADDRESS, API_BASE_URL } from './chunk-7JMQWERX.mjs';
+export { toChainId } from './chunk-7JMQWERX.mjs';
 import { erc20Abi } from 'viem';
 
 async function getVaultAllowance({

package/dist/display.d.mts

@@ -1,5 +1,5 @@
 import { Address } from 'viem';
-import { Y as YieldType, C as ChainId } from './chain-utils-CRMbWzu7.mjs';
+import { C as ChainId } from './chain-utils-CpOJcWig.mjs';
 import 'viem/chains';
 
 /**
@@ -33,6 +33,7 @@ interface GetWithdrawalRequestsParams {
     userAddress: Address;
     chainId?: number;
     vaultAddress?: Address;
+    vaultName?: string;
     status?: WithdrawalRequestStatus;
     pageSize?: number;
     pageToken?: string;
@@ -44,8 +45,11 @@ interface WithdrawalRequestsResult {
 }
 /** Parameters for getWithdrawalFee */
 interface GetWithdrawalFeeParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address used to validate the vault (should match the vault's supported asset) */
     assetAddress: Address;
     amount: string;
     offerAsset: Address;
@@ -59,8 +63,11 @@ interface WithdrawalFeeResult {
 }
 /** Parameters for getMinimumWithdrawalOrderSize */
 interface GetMinimumWithdrawalOrderSizeParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address used to validate the vault (should match the vault's supported asset) */
     assetAddress: Address;
 }
 /** Return type for getMinimumWithdrawalOrderSize */
@@ -70,8 +77,11 @@ interface MinimumWithdrawalOrderSizeResult {
 }
 /** Parameters for getMinimumMint */
 interface GetMinimumMintParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address to deposit. Must match the vault's supported asset. */
     depositAssetAddress: Address;
     depositAmount: string;
 }
@@ -84,7 +94,8 @@ interface MinimumMintResult {
 }
 /** Parameters for getVaultAPY */
 interface GetVaultAPYParams {
-    vaultAddress: Address;
+    vaultAddress?: Address;
+    vaultName?: string;
     chainId?: number;
 }
 /** Return type for getVaultAPY */
@@ -96,7 +107,8 @@ interface VaultAPYResult {
 }
 /** Parameters for getVaultTVL */
 interface GetVaultTVLParams {
-    vaultAddress: Address;
+    vaultAddress?: Address;
+    vaultName?: string;
     chainId?: number;
 }
 /** Return type for getVaultTVL */
@@ -126,7 +138,7 @@ interface VaultTVLResult {
  * @example
  * ```typescript
  * const result = await getMinimumMint({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   depositAssetAddress: "0xA0b8...", // USDC
  *   depositAmount: "1000.0",
@@ -147,7 +159,7 @@ declare function getMinimumMint(params: GetMinimumMintParams): Promise<MinimumMi
  * Requests the most recent APY data point by using
  * orderByTimestamp=desc with pageSize=1.
  *
- * @param params - Vault identifier parameters
+ * @param params - Vault identifier parameters (vaultAddress, vaultName, or both)
  * @returns Latest APY value and metadata
  * @throws {APIError} If the API request fails or no data found
  *
@@ -166,7 +178,7 @@ declare function getVaultAPY(params: GetVaultAPYParams): Promise<VaultAPYResult>
  * Requests the most recent TVL data point by using
  * includeCurrent=true, orderByTimestamp=desc with pageSize=1.
  *
- * @param params - Vault identifier parameters
+ * @param params - Vault identifier parameters (vaultAddress, vaultName, or both)
  * @returns Current TVL value and metadata
  * @throws {APIError} If the API request fails or no data found
  *
@@ -217,7 +229,7 @@ declare function getWithdrawalRequests(params: GetWithdrawalRequestsParams): Pro
  * @example
  * ```typescript
  * const fee = await getWithdrawalFee({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   assetAddress: "0xA0b8...", // USDC
  *   amount: "1.0",
@@ -239,7 +251,7 @@ declare function getWithdrawalFee(params: GetWithdrawalFeeParams): Promise<Withd
  * @example
  * ```typescript
  * const result = await getMinimumWithdrawalOrderSize({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   assetAddress: "0xA0b8...",
  * });

package/dist/display.d.ts

@@ -1,5 +1,5 @@
 import { Address } from 'viem';
-import { Y as YieldType, C as ChainId } from './chain-utils-CRMbWzu7.js';
+import { C as ChainId } from './chain-utils-CpOJcWig.js';
 import 'viem/chains';
 
 /**
@@ -33,6 +33,7 @@ interface GetWithdrawalRequestsParams {
     userAddress: Address;
     chainId?: number;
     vaultAddress?: Address;
+    vaultName?: string;
     status?: WithdrawalRequestStatus;
     pageSize?: number;
     pageToken?: string;
@@ -44,8 +45,11 @@ interface WithdrawalRequestsResult {
 }
 /** Parameters for getWithdrawalFee */
 interface GetWithdrawalFeeParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address used to validate the vault (should match the vault's supported asset) */
     assetAddress: Address;
     amount: string;
     offerAsset: Address;
@@ -59,8 +63,11 @@ interface WithdrawalFeeResult {
 }
 /** Parameters for getMinimumWithdrawalOrderSize */
 interface GetMinimumWithdrawalOrderSizeParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address used to validate the vault (should match the vault's supported asset) */
     assetAddress: Address;
 }
 /** Return type for getMinimumWithdrawalOrderSize */
@@ -70,8 +77,11 @@ interface MinimumWithdrawalOrderSizeResult {
 }
 /** Parameters for getMinimumMint */
 interface GetMinimumMintParams {
-    yieldType: YieldType;
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
+    /** Token contract address to deposit. Must match the vault's supported asset. */
     depositAssetAddress: Address;
     depositAmount: string;
 }
@@ -84,7 +94,8 @@ interface MinimumMintResult {
 }
 /** Parameters for getVaultAPY */
 interface GetVaultAPYParams {
-    vaultAddress: Address;
+    vaultAddress?: Address;
+    vaultName?: string;
     chainId?: number;
 }
 /** Return type for getVaultAPY */
@@ -96,7 +107,8 @@ interface VaultAPYResult {
 }
 /** Parameters for getVaultTVL */
 interface GetVaultTVLParams {
-    vaultAddress: Address;
+    vaultAddress?: Address;
+    vaultName?: string;
     chainId?: number;
 }
 /** Return type for getVaultTVL */
@@ -126,7 +138,7 @@ interface VaultTVLResult {
  * @example
  * ```typescript
  * const result = await getMinimumMint({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   depositAssetAddress: "0xA0b8...", // USDC
  *   depositAmount: "1000.0",
@@ -147,7 +159,7 @@ declare function getMinimumMint(params: GetMinimumMintParams): Promise<MinimumMi
  * Requests the most recent APY data point by using
  * orderByTimestamp=desc with pageSize=1.
  *
- * @param params - Vault identifier parameters
+ * @param params - Vault identifier parameters (vaultAddress, vaultName, or both)
  * @returns Latest APY value and metadata
  * @throws {APIError} If the API request fails or no data found
  *
@@ -166,7 +178,7 @@ declare function getVaultAPY(params: GetVaultAPYParams): Promise<VaultAPYResult>
  * Requests the most recent TVL data point by using
  * includeCurrent=true, orderByTimestamp=desc with pageSize=1.
  *
- * @param params - Vault identifier parameters
+ * @param params - Vault identifier parameters (vaultAddress, vaultName, or both)
  * @returns Current TVL value and metadata
  * @throws {APIError} If the API request fails or no data found
  *
@@ -217,7 +229,7 @@ declare function getWithdrawalRequests(params: GetWithdrawalRequestsParams): Pro
  * @example
  * ```typescript
  * const fee = await getWithdrawalFee({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   assetAddress: "0xA0b8...", // USDC
  *   amount: "1.0",
@@ -239,7 +251,7 @@ declare function getWithdrawalFee(params: GetWithdrawalFeeParams): Promise<Withd
  * @example
  * ```typescript
  * const result = await getMinimumWithdrawalOrderSize({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   chainId: 1,
  *   assetAddress: "0xA0b8...",
  * });

package/dist/display.js

@@ -1,36 +1,36 @@
 'use strict';
 
-var chunkOZJNKGW6_js = require('./chunk-OZJNKGW6.js');
-require('./chunk-5CV25BTQ.js');
-require('./chunk-WZXCJAKM.js');
+var chunkYEAWQB72_js = require('./chunk-YEAWQB72.js');
+require('./chunk-MB6HYA7R.js');
+require('./chunk-JTURYJHV.js');
 require('./chunk-3I3PYX2F.js');
-require('./chunk-BQG3XKTU.js');
+require('./chunk-PKGFLHZA.js');
 
 
 
 Object.defineProperty(exports, "getMinimumMint", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getMinimumMint; }
+  get: function () { return chunkYEAWQB72_js.getMinimumMint; }
 });
 Object.defineProperty(exports, "getMinimumWithdrawalOrderSize", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getMinimumWithdrawalOrderSize; }
+  get: function () { return chunkYEAWQB72_js.getMinimumWithdrawalOrderSize; }
 });
 Object.defineProperty(exports, "getVaultAPY", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getVaultAPY; }
+  get: function () { return chunkYEAWQB72_js.getVaultAPY; }
 });
 Object.defineProperty(exports, "getVaultTVL", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getVaultTVL; }
+  get: function () { return chunkYEAWQB72_js.getVaultTVL; }
 });
 Object.defineProperty(exports, "getWithdrawalFee", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getWithdrawalFee; }
+  get: function () { return chunkYEAWQB72_js.getWithdrawalFee; }
 });
 Object.defineProperty(exports, "getWithdrawalRequests", {
   enumerable: true,
-  get: function () { return chunkOZJNKGW6_js.getWithdrawalRequests; }
+  get: function () { return chunkYEAWQB72_js.getWithdrawalRequests; }
 });
 //# sourceMappingURL=display.js.map
 //# sourceMappingURL=display.js.map

package/dist/display.mjs

@@ -1,7 +1,7 @@
-export { getMinimumMint, getMinimumWithdrawalOrderSize, getVaultAPY, getVaultTVL, getWithdrawalFee, getWithdrawalRequests } from './chunk-GMMBJB4B.mjs';
-import './chunk-CQZCGPZK.mjs';
-import './chunk-VZED4E3L.mjs';
+export { getMinimumMint, getMinimumWithdrawalOrderSize, getVaultAPY, getVaultTVL, getWithdrawalFee, getWithdrawalRequests } from './chunk-UM7S7U45.mjs';
+import './chunk-KXU3GSF4.mjs';
+import './chunk-USF4CU2K.mjs';
 import './chunk-7RWWVUHP.mjs';
-import './chunk-RW7PZETN.mjs';
+import './chunk-7JMQWERX.mjs';
 //# sourceMappingURL=display.mjs.map
 //# sourceMappingURL=display.mjs.map

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 export { GetMinimumMintParams, GetMinimumWithdrawalOrderSizeParams, GetVaultAPYParams, GetVaultTVLParams, GetWithdrawalFeeParams, GetWithdrawalRequestsParams, MinimumMintResult, MinimumWithdrawalOrderSizeResult, VaultAPYResult, VaultTVLResult, WithdrawalFeeResult, WithdrawalRequest, WithdrawalRequestStatus, WithdrawalRequestsResult, getMinimumMint, getMinimumWithdrawalOrderSize, getVaultAPY, getVaultTVL, getWithdrawalFee, getWithdrawalRequests } from './display.mjs';
 import { Address } from 'viem';
-import { A as AmplifyVault, S as SupportedAsset, a as AssetFilterOptions, V as VaultFilterOptions, W as WithdrawSupportedAsset, Y as YieldType, C as ChainId } from './chain-utils-CRMbWzu7.mjs';
-export { b as APIError } from './chain-utils-CRMbWzu7.mjs';
+import { A as AmplifyVault, S as SupportedAsset, Y as YieldType, a as AssetFilterOptions, V as VaultFilterOptions, W as WithdrawSupportedAsset, C as ChainId } from './chain-utils-CpOJcWig.mjs';
+export { b as APIError, d as VaultSLA, e as VaultSupportedAsset } from './chain-utils-CpOJcWig.mjs';
 export { AlreadyApprovedAuthorizationResult, ApprovalAuthorizationResult, ApproveDepositTokenTxData, ApproveWithdrawOrderTxData, CancelWithdrawOrderTxData, DepositAuthMethod, DepositAuthorizationResult, DepositTxData, EIP712Domain, PERMIT_TYPES, ParsedPermitSignature, PermitAuthorizationResult, PermitDepositResult, PermitSignatureData, PrepareCancelWithdrawOrderTxDataParams, PrepareDepositAuthorizationParams, PrepareDepositParams, PrepareDepositPermitSignatureParams, PrepareDepositResult, PrepareDepositWithPermitTxDataParams, PrepareWithdrawOrderTxDataParams, PrepareWithdrawalAuthorizationParams, PrepareWithdrawalParams, PrepareWithdrawalResult, StandardDepositResult, UnencodedDepositWithPermitData, WithdrawAlreadyApprovedAuthorizationResult, WithdrawApprovalAuthorizationResult, WithdrawAuthMethod, WithdrawAuthorizationResult, WithdrawOrderTxData, isAlreadyApprovedAuth, isApprovalAuth, isPermitAuth, isWithdrawAlreadyApprovedAuth, isWithdrawApprovalAuth, parsePermitSignature, prepareApproveDepositTokenTxData, prepareApproveWithdrawOrderTxData, prepareCancelWithdrawOrderTxData, prepareDeposit, prepareDepositAuthorization, prepareDepositPermitSignature, prepareDepositTxData, prepareDepositWithPermitTxData, prepareWithdrawOrderTxData, prepareWithdrawal, prepareWithdrawalAuthorization, toEthSignTypedDataV4 } from './vaults.mjs';
 import 'viem/chains';
 
@@ -54,6 +54,14 @@ declare class VaultCache {
      * Assets keyed by token address
      */
     private assets;
+    /**
+     * Vaults keyed by boringVaultAddress (lowercase, for case-insensitive lookup)
+     */
+    private vaultsByAddress;
+    /**
+     * Vaults keyed by vault name (lowercase, for case-insensitive lookup)
+     */
+    private vaultsByName;
     /**
      * Unix timestamp (milliseconds) of last successful fetch
      */
@@ -83,6 +91,16 @@ declare class VaultCache {
      * @returns Array of AmplifyVault objects, or undefined if not found
      */
     getVault(tokenAddress: string): AmplifyVault[] | undefined;
+    /**
+     * Gets a vault by its boringVaultAddress (on-chain vault contract).
+     * Case-insensitive lookup.
+     */
+    getVaultByAddress(address: string): AmplifyVault | undefined;
+    /**
+     * Gets a vault by its human-readable name.
+     * Case-insensitive lookup.
+     */
+    getVaultByName(name: string): AmplifyVault | undefined;
     /**
      * Gets asset by token address
      *
@@ -344,6 +362,24 @@ declare function findVaultByConfig(params: {
     yieldType: string;
     chainId: number;
 }): Promise<AmplifyVault | null>;
+/**
+ * Filter options for getVaultsByConfig
+ */
+interface GetVaultsByConfigParams {
+    yieldType?: YieldType;
+    chainId?: number;
+    depositAssetAddress?: Address;
+    withdrawAssetAddress?: Address;
+    settlementAssetAddress?: Address;
+}
+/**
+ * Returns vaults matching the provided configuration filters.
+ *
+ * Results are automatically scoped to the organization associated with
+ * the API key the SDK was initialized with (enterprise filtering is
+ * handled server-side by the amplifySdkConfigs resolver).
+ */
+declare function getVaultsByConfig(params?: GetVaultsByConfigParams): Promise<AmplifyVault[]>;
 /**
  * Gets supported assets grouped by token with available vaults
  *
@@ -724,8 +760,59 @@ declare function waitForCacheReady(): Promise<void>;
  */
 declare function initAmplifySDK(apiKey: string, options?: SDKInitOptions): Promise<void>;
 
-declare const isDepositSpendApproved: ({ yieldType, chainId, depositAssetAddress, recipientAddress, }: {
-    yieldType: YieldType;
+/**
+ * Withdraw operation error types
+ *
+ * Defines all error classes and error scenarios specific to the withdraw flow.
+ * Provides type-safe error handling with clear error messages for different failure modes.
+ *
+ * @module types/withdraw-errors
+ */
+/**
+ * Base class for all withdraw-related errors
+ *
+ * Extends Error with additional context information for better error handling
+ * and debugging in consuming applications.
+ */
+declare class WithdrawError extends Error {
+    /**
+     * Error code for programmatic handling
+     * @example "VAULT_NOT_FOUND", "INVALID_ADDRESS", "INSUFFICIENT_BALANCE"
+     */
+    readonly code: string;
+    /**
+     * Additional context data for debugging
+     */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+declare class VaultNotFoundByAddressError extends WithdrawError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+declare class VaultNotFoundByNameError extends WithdrawError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+declare class UnauthorizedVaultAccessError extends WithdrawError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+declare function isVaultNotFoundByAddressError(error: unknown): error is VaultNotFoundByAddressError;
+declare function isVaultNotFoundByNameError(error: unknown): error is VaultNotFoundByNameError;
+
+/**
+ * Checks whether a deposit spend has been approved for the CommunityCodeDepositor contract.
+ *
+ * Resolves the vault by `vaultName` + `chainId` + `depositAssetAddress`, then reads the
+ * current ERC20 allowance and permit support via a single multicall.
+ *
+ * @param vaultName - Human-readable vault name
+ * @param chainId - Chain ID where the vault is deployed
+ * @param depositAssetAddress - Token contract address being deposited
+ * @param recipientAddress - Wallet address that owns the tokens (permit owner / approval sender)
+ * @returns Allowance, permit support info, and token metadata
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contract read fails
+ */
+declare const isDepositSpendApproved: ({ vaultName, chainId, depositAssetAddress, recipientAddress, }: {
+    vaultName: string;
     chainId: ChainId;
     depositAssetAddress: Address;
     recipientAddress: Address;
@@ -741,8 +828,21 @@ declare const isDepositSpendApproved: ({ yieldType, chainId, depositAssetAddress
     tokenVersion: string;
     error: null;
 }>;
-declare const isWithdrawalSpendApproved: ({ yieldType, chainId, wantAssetAddress, recipientAddress, }: {
-    yieldType: YieldType;
+/**
+ * Checks whether a withdrawal spend has been approved for the WithdrawQueue contract.
+ *
+ * Resolves the vault by `vaultName` + `chainId` + `wantAssetAddress`, then reads the
+ * current vault-share allowance via a multicall.
+ *
+ * @param vaultName - Human-readable vault name
+ * @param chainId - Chain ID where the vault is deployed
+ * @param wantAssetAddress - Token contract address the user wants to receive upon withdrawal
+ * @param recipientAddress - Wallet address that owns the vault shares
+ * @returns Allowance info
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contract read fails
+ */
+declare const isWithdrawalSpendApproved: ({ vaultName, chainId, wantAssetAddress, recipientAddress, }: {
+    vaultName: string;
     chainId: ChainId;
     wantAssetAddress: Address;
     recipientAddress: Address;
@@ -760,4 +860,4 @@ declare const isWithdrawalSpendApproved: ({ yieldType, chainId, wantAssetAddress
     error: null;
 }>;
 
-export { AmplifyVault, AssetFilterOptions, type InitErrorCode, LogLevel, type Logger, type RequestHeaders, type SDKConfig, type SDKInitOptions, SupportedAsset, VaultFilterOptions, WithdrawSupportedAsset, YieldType, fetchSupportedAssets, fetchVaults, findVaultByConfig, getAssetsFromCache, getCache, getLogger, getWithdrawSupportedAssets, initAmplifySDK, initializeCache, isCacheReady, isDepositSpendApproved, isWithdrawalSpendApproved, refreshVaultCache, setLogLevel, setLogger, waitForCacheReady };
+export { AmplifyVault, AssetFilterOptions, type GetVaultsByConfigParams, type InitErrorCode, LogLevel, type Logger, type RequestHeaders, type SDKConfig, type SDKInitOptions, SupportedAsset, UnauthorizedVaultAccessError, VaultFilterOptions, VaultNotFoundByAddressError, VaultNotFoundByNameError, WithdrawSupportedAsset, YieldType, fetchSupportedAssets, fetchVaults, findVaultByConfig, getAssetsFromCache, getCache, getLogger, getVaultsByConfig, getWithdrawSupportedAssets, initAmplifySDK, initializeCache, isCacheReady, isDepositSpendApproved, isVaultNotFoundByAddressError, isVaultNotFoundByNameError, isWithdrawalSpendApproved, refreshVaultCache, setLogLevel, setLogger, waitForCacheReady };