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

package/dist/vaults.d.ts

@@ -1,5 +1,5 @@
 import { erc20Abi, Address, Hex } from 'viem';
-import { Y as YieldType, C as ChainId } from './chain-utils-CRMbWzu7.js';
+import { C as ChainId } from './chain-utils-CbVFMjwR.js';
 import 'viem/chains';
 
 /**
@@ -8,15 +8,16 @@ import 'viem/chains';
  */
 
 /**
- * Parameters required for preparing an approval transaction
+ * Parameters required for preparing an ERC20 approval transaction
+ *
  * @interface PrepareApproveDepositTokenTxParams
- * @property {YieldType} yieldType - Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER")
- * @property {Address} depositAsset - Token contract address to approve
- * @property {string} [approvalAmount] - Optional amount to approve (defaults to maximum approval)
- * @property {ChainId} chainId - ID of the chain where the approval will occur
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} depositAsset - Token contract address to approve. Must match the vault's supported asset.
+ * @property {string} [approvalAmount] - Optional amount to approve as a decimal string (defaults to maximum approval)
+ * @property {ChainId} chainId - ID of the chain where the approval will occur. Must match the vault's chain.
  */
 interface PrepareApproveDepositTokenTxParams {
-    yieldType: YieldType;
+    vaultName: string;
     depositAsset: Address;
     approvalAmount?: string;
     chainId: ChainId;
@@ -41,11 +42,12 @@ interface ApproveDepositTokenTxData {
  *
  * This function prepares an ERC20 approval transaction that allows the vault's
  * CommunityCodeDepositor contract to spend the user's deposit tokens.
+ * The vault is validated against the provided `vaultName`, `chainId`, and `depositAsset`.
  *
  * @example
  * ```typescript
  * const approveData = await prepareApproveDepositTokenTxData({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   depositAsset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  *   approvalAmount: "1000.0", // Approve 1000 USDC
  *   chainId: 1,
@@ -54,9 +56,9 @@ interface ApproveDepositTokenTxData {
  *
  * @param {PrepareApproveDepositTokenTxParams} params - Parameters for the approval operation
  * @returns {Promise<ApproveDepositTokenTxData>} Promise resolving to the prepared transaction data
- * @throws {APIError} If parameters are invalid or vault not found
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contracts not configured
  */
-declare function prepareApproveDepositTokenTxData({ yieldType, depositAsset, approvalAmount, chainId, }: PrepareApproveDepositTokenTxParams): Promise<ApproveDepositTokenTxData>;
+declare function prepareApproveDepositTokenTxData({ vaultName, depositAsset, approvalAmount, chainId, }: PrepareApproveDepositTokenTxParams): Promise<ApproveDepositTokenTxData>;
 
 declare const CommunityCodeDepositorAbi: readonly [{
     readonly inputs: readonly [{
@@ -395,19 +397,19 @@ interface DepositTxData {
     chainId: number;
 }
 /**
- * Parameters for prepareDepositTransactionData()
- * Accepts yieldType, to, depositAsset, and chainId for automatic vault resolution
+ * Parameters for prepareDepositTxData()
+ *
  * @interface PrepareDepositTxDataParams
- * @property {YieldType} yieldType - Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER")
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
  * @property {Address} to - Ethereum address of the recipient. Must be the same as the address used to sign the deposit transaction.
- * @property {Address} depositAsset - Token contract address to deposit. Must be supported by the vault.
+ * @property {Address} depositAsset - Token contract address to deposit. Must match the vault's supported asset.
  * @property {string} depositAmount - Amount of assets to deposit as a decimal string (e.g., "1.5")
- * @property {number | string} chainId - ID of the chain where the deposit will occur
+ * @property {ChainId} chainId - ID of the chain where the deposit will occur. Must match the vault's chain.
  * @property {number} [slippage] - Optional (default is 50 (0.5%)): Maximum acceptable slippage in basis points (e.g., 100 for 1%).
  * @property {string} [distributorCode] - Optional (default is empty string): Distributor code for fee attribution
  */
 interface PrepareDepositTxDataParams {
-    yieldType: YieldType;
+    vaultName: string;
     to: Address;
     depositAsset: Address;
     depositAmount: string;
@@ -419,12 +421,12 @@ interface PrepareDepositTxDataParams {
  * Prepares the transaction data needed to deposit assets into a vault
  *
  * This function calculates the minimum amount of vault tokens to be minted based on
- * the current exchange rate and the specified slippage tolerance. It automatically
- * resolves the vault from yieldType, depositToken, and chainId parameters.
+ * the current exchange rate and the specified slippage tolerance. The vault is resolved
+ * and validated against the provided `vaultName`, `chainId`, and `depositAsset`.
  *
  * ```typescript
  * const depositData = await prepareDepositTxData({
- *   yieldType: 'CORE',
+ *   vaultName: 'Amplify USDC Core',
  *   to: '0x1234...',
  *   depositAsset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  *   depositAmount: "1.0",
@@ -434,8 +436,8 @@ interface PrepareDepositTxDataParams {
  * });
  * ```
  *
- * @param {PrepareDepositTransactionDataParams} params - Parameters for the deposit operation
- * @returns {Promise<DepositTransactionData>} Promise resolving to the prepared transaction data
+ * @param {PrepareDepositTxDataParams} params - Parameters for the deposit operation
+ * @returns {Promise<DepositTxData>} Promise resolving to the prepared transaction data
  * @throws {APIError} If vault cannot be resolved, asset not found, or contracts not configured
  */
 declare function prepareDepositTxData(params: PrepareDepositTxDataParams): Promise<DepositTxData>;
@@ -562,23 +564,23 @@ interface ParsedPermitSignature {
  * T009: Parameters for prepareDepositPermitSignature
  * Input parameters for generating permit typed data
  *
- * @property yieldType - Vault yield strategy
- * @property depositAsset - Token contract address to deposit
- * @property depositAmount - Deposit amount as decimal string
- * @property to - User address (permit owner)
- * @property chainId - Blockchain network ID
- * @property deadline - Optional permit expiration (defaults to 1 hour)
- * @property nonce - Optional pre-fetched nonce (skips RPC call if provided)
- * @property decimals - Optional pre-fetched token decimals (skips RPC call)
- * @property tokenName - Optional pre-fetched token name (skips RPC call)
- * @property tokenVersion - Optional pre-fetched token version (skips RPC call)
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} depositAsset - Token contract address to deposit. Must match the vault's supported asset.
+ * @property {string} depositAmount - Deposit amount as decimal string (e.g., "100.25")
+ * @property {Address} to - User address (permit owner)
+ * @property {ChainId} chainId - Chain ID where the vault is deployed. Must match the vault's chain.
+ * @property {bigint} [deadline] - Optional permit expiration (defaults to 1 hour from now)
+ * @property {bigint} [nonce] - Optional pre-fetched nonce (skips RPC call if provided)
+ * @property {number} [decimals] - Optional pre-fetched token decimals (skips RPC call)
+ * @property {string} [tokenName] - Optional pre-fetched token name for EIP-712 domain (skips RPC call)
+ * @property {string} [tokenVersion] - Optional pre-fetched token version for EIP-712 domain (skips RPC call, defaults to "1")
  */
 interface PrepareDepositPermitSignatureParams {
-    yieldType: YieldType;
+    vaultName: string;
     depositAsset: Address;
     depositAmount: string;
     to: Address;
-    chainId: number;
+    chainId: ChainId;
     deadline?: bigint;
     /** Pre-fetched nonce from getTokenPermitInfoWithAllowance */
     nonce?: bigint;
@@ -603,7 +605,7 @@ type UnencodedDepositWithPermitData = Awaited<ReturnType<typeof prepareDepositWi
  * @example
  * ```typescript
  * const permitData = await prepareDepositPermitSignature({
- *   yieldType: 'CORE',
+ *   vaultName: 'Amplify USDC Core',
  *   depositAsset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  *   depositAmount: '1000.0',
  *   to: userAddress,
@@ -669,8 +671,18 @@ declare function prepareDepositPermitSignature(params: PrepareDepositPermitSigna
  */
 declare function parsePermitSignature(signature: Hex): ParsedPermitSignature;
 /**
- * T048: Updated parameters for prepareDepositWithPermitTxData()
- * Now accepts raw signature and deadline for complete transaction encoding
+ * T048: Parameters for prepareDepositWithPermitTxData()
+ * Accepts raw signature and deadline for complete transaction encoding.
+ *
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} to - Recipient address for vault shares
+ * @property {Address} depositAsset - Token contract address to deposit. Must match the vault's supported asset.
+ * @property {string} depositAmount - Amount to deposit as a decimal string (e.g., "100.25")
+ * @property {ChainId} chainId - Chain ID where the vault is deployed. Must match the vault's chain.
+ * @property {Hex} signature - Raw hex signature from wallet signing of permit typed data
+ * @property {bigint} deadline - Permit expiration timestamp (must match the signed permit)
+ * @property {number} [slippage] - Optional slippage in basis points (default: 50 = 0.5%)
+ * @property {string} [distributorCode] - Optional distributor code for fee attribution
  *
  * @example
  * ```typescript
@@ -678,7 +690,7 @@ declare function parsePermitSignature(signature: Hex): ParsedPermitSignature;
  * const signature = await signTypedData(permitData);
  *
  * const params: PrepareDepositWithPermitTxDataParams = {
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   to: "0x1234567890123456789012345678901234567890",
  *   depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
  *   depositAmount: "100.25",
@@ -691,11 +703,11 @@ declare function parsePermitSignature(signature: Hex): ParsedPermitSignature;
  * ```
  */
 interface PrepareDepositWithPermitTxDataParams {
-    yieldType: YieldType;
+    vaultName: string;
     to: Address;
     depositAsset: Address;
     depositAmount: string;
-    chainId: number | ChainId;
+    chainId: ChainId;
     signature: Hex;
     deadline: bigint;
     slippage?: number;
@@ -1194,15 +1206,15 @@ declare function isAlreadyApprovedAuth(result: DepositAuthorizationResult): resu
  * Parameters for prepareDepositAuthorization
  */
 interface PrepareDepositAuthorizationParams {
-    /** Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER") */
-    yieldType: YieldType;
-    /** Token contract address to deposit */
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Token contract address to deposit. Must match the vault's supported asset. */
     depositAsset: Address;
     /** Amount of assets to deposit as decimal string (e.g., "100.25") */
     depositAmount: string;
     /** User's wallet address (permit owner / approval sender) */
     to: Address;
-    /** Blockchain network ID */
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
     /** Optional deadline for permit signature (defaults to 1 hour from now) */
     deadline?: bigint;
@@ -1214,15 +1226,15 @@ interface PrepareDepositAuthorizationParams {
  * Unified deposit function accepting optional permit signature
  */
 interface PrepareDepositParams {
-    /** Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER") */
-    yieldType: YieldType;
-    /** Token contract address to deposit */
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Token contract address to deposit. Must match the vault's supported asset. */
     depositAsset: Address;
     /** Amount of assets to deposit as decimal string (e.g., "100.25") */
     depositAmount: string;
     /** Recipient address for vault shares */
     to: Address;
-    /** Blockchain network ID */
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
     /** Optional slippage in basis points (default: 50 = 0.5%) */
     slippage?: number;
@@ -1273,7 +1285,7 @@ type PrepareDepositResult = StandardDepositResult | PermitDepositResult;
  * import { prepareDepositAuthorization, DepositAuthMethod } from "@paxoslabs/amplify-sdk";
  *
  * const authResult = await prepareDepositAuthorization({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
  *   depositAmount: "1000.0",
  *   to: "0x1234...",
@@ -1363,7 +1375,7 @@ declare function prepareDepositAuthorization(params: PrepareDepositAuthorization
  *
  * // Scenario 1: Permit deposit (with signature from prepareDepositAuthorization)
  * const permitDeposit = await prepareDeposit({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  *   depositAmount: "1000.0",
  *   to: "0x1234...",
@@ -1375,7 +1387,7 @@ declare function prepareDepositAuthorization(params: PrepareDepositAuthorization
  *
  * // Scenario 2: Standard deposit (after approval)
  * const standardDeposit = await prepareDeposit({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   depositAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  *   depositAmount: "1000.0",
  *   to: "0x1234...",
@@ -2009,15 +2021,17 @@ declare const BoringVaultAbi: readonly [{
 }];
 
 /**
- * Parameters required for preparing an approval transaction (NEW AmplifyVault schema)
+ * Parameters required for preparing a vault-share approval transaction
+ *
  * @interface PrepareApproveWithdrawOrderTxDataParams
- * @property {YieldType} yieldType - Yield strategy type (CORE, TREASURY, or FRONTIER)
- * @property {Address} wantAssetAddress - Address of the want token
- * @property {string} withdrawAmount - Amount to approve as a decimal string (defaults to maximum approval)
- * @property {ChainId} chainId - ID of the chain where the approval will occur
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} wantAssetAddress - Address of the want token. Must match the vault's supported asset.
+ * @property {string} [withdrawAmount] - Optional amount to approve as a decimal string (defaults to maximum approval)
+ * @property {ChainId} chainId - ID of the chain where the vault is deployed. Must match the vault's chain.
+ * @property {number} [shareDecimals] - Optional: Pre-fetched vault share decimals (avoids redundant RPC call)
  */
 interface PrepareApproveWithdrawOrderTxDataParams {
-    yieldType: YieldType;
+    vaultName: string;
     wantAssetAddress: Address;
     withdrawAmount?: string;
     chainId: ChainId;
@@ -2042,31 +2056,29 @@ interface ApproveWithdrawOrderTxData {
 /**
  * Prepares the transaction data needed to approve vault shares for the WithdrawQueue contract
  *
- * This function prepares an ERC20 approval transaction that allows the WithdrawQueue
- * contract to spend the user's vault shares. It uses the new AmplifyVault schema
- * with asset decimals from the API (no on-chain calls).
+ * The vault is resolved and validated against `vaultName`, `chainId`, and `wantAssetAddress`
+ * before any calldata is constructed.
  *
  * @example
  * ```typescript
- * const vaults = await fetchVaults({ chainId: 1 });
  * const approveData = await prepareApproveWithdrawOrderTxData({
- *   yieldType: 'CORE',
+ *   vaultName: "Amplify USDC Core",
  *   wantAssetAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
- *   withdrawAmount: "10.0", // Approve 10 USDC
+ *   withdrawAmount: "10.0", // Approve 10 vault shares
  *   chainId: 1,
  * });
  * ```
  *
  * @param {PrepareApproveWithdrawOrderTxDataParams} params - Parameters for the approval operation
- * @param {YieldType} params.yieldType - Yield strategy type (CORE, TREASURY, or FRONTIER)
+ * @param {string} params.vaultName - Human-readable vault name
  * @param {Address} params.wantAssetAddress - Address of the want token
  * @param {string} [params.withdrawAmount] - Optional amount to approve as a decimal string (defaults to maximum approval)
- * @param {number | string} params.chainId - ID of the chain where the approval will occur
+ * @param {ChainId} params.chainId - ID of the chain where the vault is deployed
  *
  * @returns {Promise<ApproveWithdrawOrderTxData>} Promise resolving to the prepared transaction data
- * @throws {APIError} If the vault is not on the correct chain or contracts not configured
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contracts not configured
  */
-declare function prepareApproveWithdrawOrderTxData({ yieldType, wantAssetAddress, withdrawAmount, chainId, shareDecimals, }: PrepareApproveWithdrawOrderTxDataParams): Promise<ApproveWithdrawOrderTxData>;
+declare function prepareApproveWithdrawOrderTxData({ vaultName, wantAssetAddress, withdrawAmount, chainId, shareDecimals, }: PrepareApproveWithdrawOrderTxDataParams): Promise<ApproveWithdrawOrderTxData>;
 
 declare const WithdrawQueueAbi: readonly [{
     readonly inputs: readonly [{
@@ -3471,13 +3483,13 @@ declare const WithdrawQueueAbi: readonly [{
  * Parameters for preparing a cancel withdrawal order transaction
  *
  * @interface PrepareCancelWithdrawOrderTxDataParams
- * @property {YieldType} yieldType - Yield strategy type (CORE, TREASURY, or FRONTIER)
- * @property {Address} wantAsset - Address of the want token (used to find the correct vault/queue)
- * @property {ChainId} chainId - ID of the chain where the order exists
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} wantAsset - Address of the want token (used to validate the vault). Must match the vault's supported asset.
+ * @property {ChainId} chainId - ID of the chain where the order exists. Must match the vault's chain.
  * @property {bigint} orderIndex - Index of the order to cancel (provided by user)
  */
 interface PrepareCancelWithdrawOrderTxDataParams {
-    yieldType: YieldType;
+    vaultName: string;
     wantAsset: Address;
     chainId: ChainId;
     orderIndex: bigint;
@@ -3500,22 +3512,22 @@ interface CancelWithdrawOrderTxData {
 /**
  * Prepares transaction data to cancel a withdrawal order on the WithdrawQueue contract
  *
- * This function prepares the transaction to cancel an existing order in the queue.
- * Only the order owner can cancel their order.
+ * The vault is resolved and validated against `vaultName`, `chainId`, and `wantAsset`
+ * before any calldata is constructed. Only the order owner can cancel their order.
  *
  * @param {PrepareCancelWithdrawOrderTxDataParams} params - Parameters for the cancel operation
  * @returns {Promise<CancelWithdrawOrderTxData>} Promise resolving to the prepared transaction data
- * @throws {APIError} If the vault is not found, chain mismatch, or contracts not configured
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contracts not configured
  *
  * @example
  * ```typescript
  * import { prepareCancelWithdrawOrderTxData } from "@paxoslabs/amplify-sdk";
  *
  * const txData = await prepareCancelWithdrawOrderTxData({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   wantAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
  *   chainId: 1,
- *   orderIndex: 42n, // The order index to cancel
+ *   orderIndex: 42n,
  * });
  *
  * // Execute with viem
@@ -3526,7 +3538,7 @@ interface CancelWithdrawOrderTxData {
  * await writeContract(txData);
  * ```
  */
-declare const prepareCancelWithdrawOrderTxData: ({ yieldType, wantAsset, chainId, orderIndex, }: PrepareCancelWithdrawOrderTxDataParams) => Promise<CancelWithdrawOrderTxData>;
+declare const prepareCancelWithdrawOrderTxData: ({ vaultName, wantAsset, chainId, orderIndex, }: PrepareCancelWithdrawOrderTxDataParams) => Promise<CancelWithdrawOrderTxData>;
 
 /**
  * @file Standard withdrawal functionality for WithdrawQueue contract
@@ -3552,14 +3564,14 @@ declare const EMPTY_SIGNATURE_PARAMS: {
  * Parameters for preparing a submit order transaction
  *
  * @interface PrepareWithdrawOrderTxDataParams
- * @property {YieldType} yieldType - Yield strategy type (CORE, TREASURY, or FRONTIER)
- * @property {Address} wantAsset - Address of the token to receive upon withdrawal
+ * @property {string} vaultName - Human-readable vault name (e.g. "Amplify USDC Core")
+ * @property {Address} wantAsset - Address of the token to receive upon withdrawal. Must match the vault's supported asset.
  * @property {Address} userAddress - User's wallet address (used for intendedDepositor, receiver, refundReceiver)
- * @property {ChainId} chainId - ID of the chain where the withdrawal will occur
+ * @property {ChainId} chainId - ID of the chain where the vault is deployed. Must match the vault's chain.
  * @property {string} amountOffer - Amount of vault shares to withdraw as a decimal string
  */
 interface PrepareWithdrawOrderTxDataParams {
-    yieldType: YieldType;
+    vaultName: string;
     wantAsset: Address;
     userAddress: Address;
     chainId: ChainId;
@@ -3592,21 +3604,22 @@ interface WithdrawOrderTxData {
 /**
  * Prepares transaction data to submit a withdrawal order to the WithdrawQueue contract
  *
- * This function prepares a user request for the new WithdrawQueue contract.
- * Unlike the old AtomicQueue, this does not require exchange rate queries or slippage parameters.
+ * The vault is resolved and validated against `vaultName`, `chainId`, and `wantAsset`
+ * before any calldata is constructed. Unlike the old AtomicQueue, this does not require
+ * exchange rate queries or slippage parameters.
  * It intentionally does not perform allowance pre-checks; callers should use
  * `prepareWithdrawalAuthorization` when they need approval routing.
  *
  * @param {PrepareWithdrawOrderTxDataParams} params - Parameters for the withdraw operation
  * @returns {Promise<WithdrawOrderTxData>} Promise resolving to the prepared transaction data
- * @throws {APIError} If the vault is not found, chain mismatch, or contracts not configured
+ * @throws {APIError} If vault not found, chain/asset mismatch, or contracts not configured
  *
  * @example
  * ```typescript
  * import { prepareWithdrawOrderTxData } from "@paxoslabs/amplify-sdk";
  *
  * const txData = await prepareWithdrawOrderTxData({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   wantAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
  *   userAddress: "0x1234...",
  *   chainId: 1,
@@ -3621,7 +3634,7 @@ interface WithdrawOrderTxData {
  * await writeContract(txData);
  * ```
  */
-declare const prepareWithdrawOrderTxData: ({ yieldType, wantAsset, userAddress, chainId, amountOffer, }: PrepareWithdrawOrderTxDataParams) => Promise<WithdrawOrderTxData>;
+declare const prepareWithdrawOrderTxData: ({ vaultName, wantAsset, userAddress, chainId, amountOffer, }: PrepareWithdrawOrderTxDataParams) => Promise<WithdrawOrderTxData>;
 
 /**
  * @file Unified withdrawal module with wrapper functions
@@ -3714,15 +3727,15 @@ declare function isWithdrawAlreadyApprovedAuth(result: WithdrawAuthorizationResu
  * Parameters for prepareWithdrawalAuthorization
  */
 interface PrepareWithdrawalAuthorizationParams {
-    /** Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER") */
-    yieldType: YieldType;
-    /** Token address the user wants to receive upon withdrawal */
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Token address the user wants to receive upon withdrawal. Must match the vault's supported asset. */
     wantAsset: Address;
     /** Amount of vault shares to withdraw as decimal string */
     withdrawAmount: string;
     /** User's wallet address (owner of vault shares) */
     userAddress: Address;
-    /** Blockchain network ID */
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
     /**
      * Force specific authorization routing behavior:
@@ -3736,15 +3749,15 @@ interface PrepareWithdrawalAuthorizationParams {
  * Unified withdrawal wrapper that maps to standard withdraw tx preparation.
  */
 interface PrepareWithdrawalParams {
-    /** Yield strategy type (e.g., "CORE", "TREASURY", "FRONTIER") */
-    yieldType: YieldType;
-    /** Token address the user wants to receive upon withdrawal */
+    /** Human-readable vault name (e.g. "Amplify USDC Core") */
+    vaultName: string;
+    /** Token address the user wants to receive upon withdrawal. Must match the vault's supported asset. */
     wantAsset: Address;
     /** Amount of vault shares to withdraw as decimal string */
     withdrawAmount: string;
     /** User's wallet address (owner of vault shares) */
     userAddress: Address;
-    /** Blockchain network ID */
+    /** Chain ID where the vault is deployed. Must match the vault's chain. */
     chainId: ChainId;
 }
 /**
@@ -3785,7 +3798,7 @@ declare function prepareWithdrawal(params: PrepareWithdrawalParams): Promise<Pre
  * } from "@paxoslabs/amplify-sdk";
  *
  * const authResult = await prepareWithdrawalAuthorization({
- *   yieldType: "CORE",
+ *   vaultName: "Amplify USDC Core",
  *   wantAsset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  *   withdrawAmount: "1.0",
  *   userAddress: "0x1234...",

package/dist/vaults.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunk2YPKHXFJ_js = require('./chunk-2YPKHXFJ.js');
-require('./chunk-5CV25BTQ.js');
-require('./chunk-WZXCJAKM.js');
+var chunkZJBJFFBQ_js = require('./chunk-ZJBJFFBQ.js');
+require('./chunk-E2HBXOZY.js');
+require('./chunk-EHRZFLWL.js');
 require('./chunk-3I3PYX2F.js');
-require('./chunk-BQG3XKTU.js');
+require('./chunk-R5G6F7RP.js');
 
 
 
 Object.defineProperty(exports, "DepositAuthMethod", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.DepositAuthMethod; }
+  get: function () { return chunkZJBJFFBQ_js.DepositAuthMethod; }
 });
 Object.defineProperty(exports, "PERMIT_TYPES", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.PERMIT_TYPES; }
+  get: function () { return chunkZJBJFFBQ_js.PERMIT_TYPES; }
 });
 Object.defineProperty(exports, "WithdrawAuthMethod", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.WithdrawAuthMethod; }
+  get: function () { return chunkZJBJFFBQ_js.WithdrawAuthMethod; }
 });
 Object.defineProperty(exports, "isAlreadyApprovedAuth", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.isAlreadyApprovedAuth; }
+  get: function () { return chunkZJBJFFBQ_js.isAlreadyApprovedAuth; }
 });
 Object.defineProperty(exports, "isApprovalAuth", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.isApprovalAuth; }
+  get: function () { return chunkZJBJFFBQ_js.isApprovalAuth; }
 });
 Object.defineProperty(exports, "isPermitAuth", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.isPermitAuth; }
+  get: function () { return chunkZJBJFFBQ_js.isPermitAuth; }
 });
 Object.defineProperty(exports, "isWithdrawAlreadyApprovedAuth", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.isWithdrawAlreadyApprovedAuth; }
+  get: function () { return chunkZJBJFFBQ_js.isWithdrawAlreadyApprovedAuth; }
 });
 Object.defineProperty(exports, "isWithdrawApprovalAuth", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.isWithdrawApprovalAuth; }
+  get: function () { return chunkZJBJFFBQ_js.isWithdrawApprovalAuth; }
 });
 Object.defineProperty(exports, "parsePermitSignature", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.parsePermitSignature; }
+  get: function () { return chunkZJBJFFBQ_js.parsePermitSignature; }
 });
 Object.defineProperty(exports, "prepareApproveDepositTokenTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareApproveDepositTokenTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareApproveDepositTokenTxData; }
 });
 Object.defineProperty(exports, "prepareApproveWithdrawOrderTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareApproveWithdrawOrderTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareApproveWithdrawOrderTxData; }
 });
 Object.defineProperty(exports, "prepareCancelWithdrawOrderTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareCancelWithdrawOrderTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareCancelWithdrawOrderTxData; }
 });
 Object.defineProperty(exports, "prepareDeposit", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareDeposit; }
+  get: function () { return chunkZJBJFFBQ_js.prepareDeposit; }
 });
 Object.defineProperty(exports, "prepareDepositAuthorization", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareDepositAuthorization; }
+  get: function () { return chunkZJBJFFBQ_js.prepareDepositAuthorization; }
 });
 Object.defineProperty(exports, "prepareDepositPermitSignature", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareDepositPermitSignature; }
+  get: function () { return chunkZJBJFFBQ_js.prepareDepositPermitSignature; }
 });
 Object.defineProperty(exports, "prepareDepositTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareDepositTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareDepositTxData; }
 });
 Object.defineProperty(exports, "prepareDepositWithPermitTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareDepositWithPermitTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareDepositWithPermitTxData; }
 });
 Object.defineProperty(exports, "prepareWithdrawOrderTxData", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareWithdrawOrderTxData; }
+  get: function () { return chunkZJBJFFBQ_js.prepareWithdrawOrderTxData; }
 });
 Object.defineProperty(exports, "prepareWithdrawal", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareWithdrawal; }
+  get: function () { return chunkZJBJFFBQ_js.prepareWithdrawal; }
 });
 Object.defineProperty(exports, "prepareWithdrawalAuthorization", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.prepareWithdrawalAuthorization; }
+  get: function () { return chunkZJBJFFBQ_js.prepareWithdrawalAuthorization; }
 });
 Object.defineProperty(exports, "toEthSignTypedDataV4", {
   enumerable: true,
-  get: function () { return chunk2YPKHXFJ_js.toEthSignTypedDataV4; }
+  get: function () { return chunkZJBJFFBQ_js.toEthSignTypedDataV4; }
 });
 //# sourceMappingURL=vaults.js.map
 //# sourceMappingURL=vaults.js.map

package/dist/vaults.mjs

@@ -1,7 +1,7 @@
-export { DepositAuthMethod, PERMIT_TYPES, WithdrawAuthMethod, isAlreadyApprovedAuth, isApprovalAuth, isPermitAuth, isWithdrawAlreadyApprovedAuth, isWithdrawApprovalAuth, parsePermitSignature, prepareApproveDepositTokenTxData, prepareApproveWithdrawOrderTxData, prepareCancelWithdrawOrderTxData, prepareDeposit, prepareDepositAuthorization, prepareDepositPermitSignature, prepareDepositTxData, prepareDepositWithPermitTxData, prepareWithdrawOrderTxData, prepareWithdrawal, prepareWithdrawalAuthorization, toEthSignTypedDataV4 } from './chunk-TPU2HZAX.mjs';
-import './chunk-CQZCGPZK.mjs';
-import './chunk-VZED4E3L.mjs';
+export { DepositAuthMethod, PERMIT_TYPES, WithdrawAuthMethod, isAlreadyApprovedAuth, isApprovalAuth, isPermitAuth, isWithdrawAlreadyApprovedAuth, isWithdrawApprovalAuth, parsePermitSignature, prepareApproveDepositTokenTxData, prepareApproveWithdrawOrderTxData, prepareCancelWithdrawOrderTxData, prepareDeposit, prepareDepositAuthorization, prepareDepositPermitSignature, prepareDepositTxData, prepareDepositWithPermitTxData, prepareWithdrawOrderTxData, prepareWithdrawal, prepareWithdrawalAuthorization, toEthSignTypedDataV4 } from './chunk-L3X5UBG6.mjs';
+import './chunk-4OEL42W2.mjs';
+import './chunk-HBFBGNRH.mjs';
 import './chunk-7RWWVUHP.mjs';
-import './chunk-RW7PZETN.mjs';
+import './chunk-7RAFG3NI.mjs';
 //# sourceMappingURL=vaults.mjs.map
 //# sourceMappingURL=vaults.mjs.map