@paxoslabs/amplify-sdk 0.5.3 → 1.0.1

package/dist/display.d.ts

@@ -1,472 +0,0 @@
-import { Address } from 'viem';
-import { C as ChainId } from './chain-utils-5r2UnCDS.js';
-import 'viem/chains';
-
-/**
- * @file Display module type definitions
- * @module display/types
- */
-
-/** Status of a withdrawal request */
-type WithdrawalRequestStatus = 'PENDING' | 'COMPLETE' | 'PENDING_REFUND' | 'REFUNDED';
-/** A withdrawal request returned from the backend API */
-interface WithdrawalRequest {
-    id: string;
-    vaultAddress: Address;
-    chainId: number;
-    wantAssetAddress: Address;
-    status: WithdrawalRequestStatus;
-    createdAt: string;
-    userAddress: Address;
-    receiverAddress: Address;
-    refundReceiverAddress: Address;
-    orderAmount: string;
-    orderIndex: number;
-    isSubmittedViaSignature: boolean;
-    isForceProcessed: boolean;
-    isMarkedForRefund: boolean;
-    isMarkedForRefundByUser: boolean;
-    didOrderFailTransfer: boolean;
-}
-/** Parameters for getWithdrawalRequests */
-interface GetWithdrawalRequestsParams {
-    userAddress: Address;
-    chainId?: number;
-    vaultAddress?: Address;
-    vaultName?: string;
-    status?: WithdrawalRequestStatus;
-    pageSize?: number;
-    pageToken?: string;
-}
-/** Return type for getWithdrawalRequests */
-interface WithdrawalRequestsResult {
-    withdrawalRequests: WithdrawalRequest[];
-    nextPageToken: string | null;
-}
-/** Parameters for getWithdrawalFee */
-interface GetWithdrawalFeeParams {
-    /** 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;
-    wantAsset: Address;
-    receiver: Address;
-}
-/** Return type for getWithdrawalFee */
-interface WithdrawalFeeResult {
-    feeAmount: bigint;
-    feePercentage: bigint;
-}
-/** Parameters for getMinimumWithdrawalOrderSize */
-interface GetMinimumWithdrawalOrderSizeParams {
-    /** 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 */
-interface MinimumWithdrawalOrderSizeResult {
-    minimumOrderSize: bigint;
-    shareDecimals: number;
-}
-/** Parameters for getMinimumMint */
-interface GetMinimumMintParams {
-    /** 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;
-}
-/** Return type for getMinimumMint */
-interface MinimumMintResult {
-    expectedShares: bigint;
-    exchangeRate: bigint;
-    shareDecimals: number;
-    assetDecimals: number;
-}
-/** Parameters for getDepositCap */
-interface GetDepositCapParams {
-    /** 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 {@link getDepositCap}.
- * Only produced for vaults with both a CommunityCodeDepositor and a deposit fee module.
- */
-interface DepositCapResult {
-    /** Supply cap denominated in base asset units (raw uint256 from DCD contract) */
-    supplyCapInBase: bigint;
-    /** True when `supplyCapInBase` is neither `0` nor `maxUint256` (unlimited). */
-    hasDepositCap: boolean;
-    /** Deposit fee module contract address from the DCD (zero address means no fees) */
-    depositFeeModuleAddress: Address;
-    /** Whether the vault has deposit fees (depositFeeModuleAddress != zero address) */
-    hasFees: boolean;
-}
-/** Parameters for calculateDepositFee */
-interface CalculateDepositFeeParams {
-    /** 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 of the deposit asset */
-    assetAddress: Address;
-    /** Human-readable deposit amount (e.g. "1000.0") */
-    depositAmount: string;
-}
-/** Return type for calculateDepositFee */
-interface DepositFeeResult {
-    /** Whether the vault has a fee module configured */
-    hasFees: boolean;
-    /** The deposit fee module contract address (zero address if no fees) */
-    depositFeeModuleAddress: Address;
-    /** Variable fee percentage as raw uint256 from the contract */
-    feePercentage: bigint;
-    /** ONE_HUNDRED_PERCENT constant from the fee module (denominator for percentage calc) */
-    oneHundredPercent: bigint;
-    /** Flat fee in deposit-token units (raw uint256) */
-    flatFee: bigint;
-    /** Computed variable fee amount for the given deposit: depositAmount * feePercentage / oneHundredPercent */
-    variableFeeAmount: bigint;
-    /** Total fee amount: variableFeeAmount + flatFee */
-    totalFeeAmount: bigint;
-    /** Deposit amount after total fee deduction */
-    depositAmountAfterFees: bigint;
-    /** Decimals of the deposit asset (for display formatting) */
-    assetDecimals: number;
-}
-/** Parameters for getCurrentSupply */
-interface GetCurrentSupplyParams {
-    /** 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 getCurrentSupply */
-interface CurrentSupplyResult {
-    /** Total share supply of the boring vault (raw ERC-20 totalSupply) */
-    totalShareSupply: bigint;
-    /** Exchange rate from the accountant (getRate) */
-    exchangeRate: bigint;
-    /** Decimals reported by the accountant contract */
-    accountantDecimals: number;
-    /** Total value in base-asset units: totalShareSupply * exchangeRate / 10^accountantDecimals */
-    totalValueInBase: bigint;
-}
-/** Parameters for getShareValue */
-interface GetShareValueParams {
-    /** 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;
-    /** Quote asset address to value shares in (e.g. USDC). Must match the vault's supported asset. */
-    quoteAssetAddress: Address;
-    /** Wallet address to read share balance for via balanceOf. Optional when shareAmount is provided. */
-    userAddress?: Address;
-    /** Explicit share amount to value (human-readable, e.g. "100.0"). Overrides on-chain balanceOf when provided. */
-    shareAmount?: string;
-}
-/** Return type for getShareValue */
-interface ShareValueResult {
-    /** Share balance used for the calculation (read from chain or derived from shareAmount) */
-    shareBalance: bigint;
-    /** Value of the shares in quote-asset units (raw bigint) */
-    value: bigint;
-    /** Exchange rate from getRateInQuote — quote-asset units per one full share */
-    exchangeRate: bigint;
-    /** Decimals of the BoringVault share token */
-    shareDecimals: number;
-    /** Decimals of the quote asset */
-    quoteAssetDecimals: number;
-}
-/** Parameters for getVaultAPY */
-interface GetVaultAPYParams {
-    vaultAddress?: Address;
-    vaultName?: string;
-    chainId?: number;
-}
-/** Return type for getVaultAPY */
-interface VaultAPYResult {
-    apy: number;
-    apyFormatted: string;
-    vaultAddress: Address;
-    timestamp: string;
-}
-/** Parameters for getVaultTVL */
-interface GetVaultTVLParams {
-    vaultAddress?: Address;
-    vaultName?: string;
-    chainId?: number;
-}
-/** Return type for getVaultTVL */
-interface VaultTVLResult {
-    tvl: string;
-    tvlAsset: string;
-    vaultAddress: Address;
-    chainId: number;
-    timestamp: string;
-}
-
-/**
- * @file Deposit display helpers
- * @module display/deposit-display
- */
-
-/**
- * Calculates the expected vault shares a user will receive for a deposit
- *
- * Uses the on-chain exchange rate from the Accountant contract to calculate
- * how many vault shares will be minted for a given deposit amount.
- *
- * @param params - Deposit parameters
- * @returns Expected shares, exchange rate, and decimal info
- * @throws {APIError} If vault not found or contract read fails
- *
- * @example
- * ```typescript
- * const result = await getMinimumMint({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   depositAssetAddress: "0xA0b8...", // USDC
- *   depositAmount: "1000.0",
- * });
- * console.log(result.expectedShares);
- * ```
- */
-declare function getMinimumMint(params: GetMinimumMintParams): Promise<MinimumMintResult>;
-/**
- * Reads the deposit cap and fee module info from the DCD contract on-chain
- *
- * Uses the customer's configured RPC to call `supplyCapInBase()` and
- * `feeModule()` on the DistributorCodeDepositor contract.
- *
- * @param params - Vault identification parameters
- * @returns Supply cap, fee module address, and derived boolean flags
- * @throws {APIError} If vault not found or contract read fails
- *
- * @example
- * ```typescript
- * const cap = await getDepositCap({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   assetAddress: "0xA0b8...",
- * });
- * console.log(cap.hasDepositCap); // true if supplyCapInBase != 0 and != maxUint256
- * console.log(cap.hasFees);       // true if depositFeeModuleAddress from vault config != zeroAddress
- * ```
- */
-declare function getDepositCap(params: GetDepositCapParams): Promise<DepositCapResult>;
-/**
- * Reads the current total supply value from the boring vault and accountant
- *
- * Computes `totalValueInBase = totalSupply * accountant.getRate() / 10^accountant.decimals()`,
- * matching the on-chain supply cap enforcement logic in the DCD contract.
- *
- * @param params - Vault identification parameters
- * @returns Total share supply, exchange rate, and computed value in base-asset units
- * @throws {APIError} If vault not found or contract read fails
- *
- * @example
- * ```typescript
- * const supply = await getCurrentSupply({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   assetAddress: "0xA0b8...",
- * });
- * console.log(supply.totalValueInBase); // current TVL in base-asset raw units
- * ```
- */
-declare function getCurrentSupply(params: GetCurrentSupplyParams): Promise<CurrentSupplyResult>;
-/**
- * Calculates the deposit fee for a given deposit amount by reading the
- * fee module's `depositTokenFeeData` and `ONE_HUNDRED_PERCENT` on-chain.
- *
- * Returns both the fixed (flat) and variable fee components, along with
- * the total fee and the net deposit amount after fees.
- *
- * @param params - Deposit parameters including vault name, chain, asset, and amount
- * @returns Fee breakdown with fixed, variable, total, and net amounts
- * @throws {APIError} If vault not found, no fee module, or contract read fails
- *
- * @example
- * ```typescript
- * const fee = await calculateDepositFee({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   assetAddress: "0xA0b8...",
- *   depositAmount: "1000.0",
- * });
- * console.log(fee.variableFeeAmount); // variable portion
- * console.log(fee.flatFee);           // fixed portion
- * console.log(fee.totalFeeAmount);    // variable + fixed
- * ```
- */
-declare function calculateDepositFee(params: CalculateDepositFeeParams): Promise<DepositFeeResult>;
-/**
- * Calculates the value of vault shares in a quote asset
- *
- * Reads the on-chain exchange rate from the Accountant contract via
- * `getRateInQuote(quoteAsset)` and computes:
- *   value = shareBalance * rateInQuote / 10^shareDecimals
- *
- * The share balance can come from two sources:
- * - `userAddress`: reads `balanceOf(userAddress)` on the BoringVault on-chain
- * - `shareAmount`: uses the provided amount directly (skips balanceOf)
- *
- * When both are provided, `shareAmount` takes precedence. At least one
- * must be specified.
- *
- * @param params - Share value parameters
- * @returns Share balance, value in quote-asset units, exchange rate, and decimal info
- * @throws {APIError} If neither userAddress nor shareAmount provided, vault not found, or contract read fails
- *
- * @example
- * ```typescript
- * // Look up a user's position value by wallet address
- * const result = await getShareValue({
- *   vaultName: "pxlUSDCc",
- *   chainId: 1,
- *   quoteAssetAddress: "0xA0b8...", // USDC
- *   userAddress: "0x1234...",
- * });
- * console.log(result.shareBalance); // shares held
- * console.log(result.value);        // worth in USDC units
- *
- * // Or value a known share amount directly
- * const preview = await getShareValue({
- *   vaultName: "pxlUSDCc",
- *   chainId: 1,
- *   quoteAssetAddress: "0xA0b8...",
- *   shareAmount: "100.0",
- * });
- * ```
- */
-declare function getShareValue(params: GetShareValueParams): Promise<ShareValueResult>;
-
-/**
- * @file Vault display helpers
- * @module display/vault-display
- */
-
-/**
- * Fetches the latest APY for a vault from the backend API
- *
- * Requests the most recent APY data point by using
- * orderByTimestamp=desc with pageSize=1.
- *
- * @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
- *
- * @example
- * ```typescript
- * const result = await getVaultAPY({
- *   vaultAddress: "0x1234...",
- * });
- * console.log(result.apyFormatted); // "4.50%"
- * ```
- */
-declare function getVaultAPY(params: GetVaultAPYParams): Promise<VaultAPYResult>;
-/**
- * Fetches the current TVL for a vault from the backend API
- *
- * Requests the most recent TVL data point by using
- * includeCurrent=true, orderByTimestamp=desc with pageSize=1.
- *
- * @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
- *
- * @example
- * ```typescript
- * const result = await getVaultTVL({
- *   vaultAddress: "0x1234...",
- * });
- * console.log(result.tvl, result.tvlAsset);
- * ```
- */
-declare function getVaultTVL(params: GetVaultTVLParams): Promise<VaultTVLResult>;
-
-/**
- * @file Withdrawal display helpers
- * @module display/withdrawal-display
- */
-
-/**
- * Fetches a user's withdrawal requests from the backend API
- *
- * @param params - Filter parameters for withdrawal requests
- * @returns Paginated list of withdrawal requests
- * @throws {APIError} If the API request fails or parameters are invalid
- *
- * @example
- * ```typescript
- * const result = await getWithdrawalRequests({
- *   userAddress: "0x1234...",
- *   status: "PENDING",
- *   chainId: 1,
- * });
- * console.log(result.withdrawalRequests);
- * ```
- */
-declare function getWithdrawalRequests(params: GetWithdrawalRequestsParams): Promise<WithdrawalRequestsResult>;
-/**
- * Reads the withdrawal fee from the on-chain FeeModule contract
- *
- * Performs two sequential RPC calls:
- * 1. Reads the FeeModule address from WithdrawQueue.feeModule()
- * 2. Multicalls calculateOfferFees + offerFeePercentage on the FeeModule
- *
- * @param params - Parameters for fee calculation
- * @returns Fee amount and fee percentage
- * @throws {APIError} If vault not found or contract read fails
- *
- * @example
- * ```typescript
- * const fee = await getWithdrawalFee({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   assetAddress: "0xA0b8...", // USDC
- *   amount: "1.0",
- *   offerAsset: "0x1234...",  // vault shares
- *   wantAsset: "0xA0b8...",   // USDC
- *   receiver: "0x5678...",
- * });
- * console.log(fee.feeAmount, fee.feePercentage);
- * ```
- */
-declare function getWithdrawalFee(params: GetWithdrawalFeeParams): Promise<WithdrawalFeeResult>;
-/**
- * Reads the minimum withdrawal order size from the WithdrawQueue contract
- *
- * @param params - Parameters to identify the vault
- * @returns Minimum order size in vault shares and share decimals
- * @throws {APIError} If vault not found or contract read fails
- *
- * @example
- * ```typescript
- * const result = await getMinimumWithdrawalOrderSize({
- *   vaultName: "Amplify USDC Core",
- *   chainId: 1,
- *   assetAddress: "0xA0b8...",
- * });
- * console.log(result.minimumOrderSize, result.shareDecimals);
- * ```
- */
-declare function getMinimumWithdrawalOrderSize(params: GetMinimumWithdrawalOrderSizeParams): Promise<MinimumWithdrawalOrderSizeResult>;
-
-export { type CalculateDepositFeeParams, type CurrentSupplyResult, type DepositCapResult, type DepositFeeResult, type GetCurrentSupplyParams, type GetDepositCapParams, type GetMinimumMintParams, type GetMinimumWithdrawalOrderSizeParams, type GetShareValueParams, type GetVaultAPYParams, type GetVaultTVLParams, type GetWithdrawalFeeParams, type GetWithdrawalRequestsParams, type MinimumMintResult, type MinimumWithdrawalOrderSizeResult, type ShareValueResult, type VaultAPYResult, type VaultTVLResult, type WithdrawalFeeResult, type WithdrawalRequest, type WithdrawalRequestStatus, type WithdrawalRequestsResult, calculateDepositFee, getCurrentSupply, getDepositCap, getMinimumMint, getMinimumWithdrawalOrderSize, getShareValue, getVaultAPY, getVaultTVL, getWithdrawalFee, getWithdrawalRequests };

package/dist/display.js

@@ -1,52 +0,0 @@
-'use strict';
-
-var chunkWD6QFSXZ_js = require('./chunk-WD6QFSXZ.js');
-require('./chunk-6JLKHV6O.js');
-require('./chunk-FHE43NKY.js');
-require('./chunk-TNL23CO2.js');
-require('./chunk-GOJQYEJQ.js');
-
-
-
-Object.defineProperty(exports, "calculateDepositFee", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.calculateDepositFee; }
-});
-Object.defineProperty(exports, "getCurrentSupply", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getCurrentSupply; }
-});
-Object.defineProperty(exports, "getDepositCap", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getDepositCap; }
-});
-Object.defineProperty(exports, "getMinimumMint", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getMinimumMint; }
-});
-Object.defineProperty(exports, "getMinimumWithdrawalOrderSize", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getMinimumWithdrawalOrderSize; }
-});
-Object.defineProperty(exports, "getShareValue", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getShareValue; }
-});
-Object.defineProperty(exports, "getVaultAPY", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getVaultAPY; }
-});
-Object.defineProperty(exports, "getVaultTVL", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getVaultTVL; }
-});
-Object.defineProperty(exports, "getWithdrawalFee", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getWithdrawalFee; }
-});
-Object.defineProperty(exports, "getWithdrawalRequests", {
-  enumerable: true,
-  get: function () { return chunkWD6QFSXZ_js.getWithdrawalRequests; }
-});
-//# sourceMappingURL=display.js.map
-//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"display.js"}

package/dist/display.mjs

@@ -1,7 +0,0 @@
-export { calculateDepositFee, getCurrentSupply, getDepositCap, getMinimumMint, getMinimumWithdrawalOrderSize, getShareValue, getVaultAPY, getVaultTVL, getWithdrawalFee, getWithdrawalRequests } from './chunk-QMFYPHX5.mjs';
-import './chunk-Y5LBT2WT.mjs';
-import './chunk-UY2WD7MF.mjs';
-import './chunk-6CU533DM.mjs';
-import './chunk-ODXJYXUH.mjs';
-//# sourceMappingURL=display.mjs.map
-//# sourceMappingURL=display.mjs.map

package/dist/display.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"display.mjs"}