get_deposit_status
Get deposit status — Check whether deposits are currently paused on a vault. Use this before building a deposit transaction. Returns: { data: { vaultAddress: string, isPaused: boolean, supported: boolean }, message: string, statusCode: number }.
get_withdraw_status
Get withdraw status — Check whether withdrawals are currently paused on a vault. Returns: { data: { vaultAddress: string, isPaused: boolean, supported: boolean }, message: string, statusCode: number }.
get_queue_withdraw_status
Get queue-withdraw status — Check whether queued (delayed) withdrawals are currently paused on a vault. Returns: { data: { vaultAddress: string, isPaused: boolean, supported: boolean }, message: string, statusCode: number }.
get_vault_portfolio
Get vault portfolio — Returns the underlying token portfolio and breakdown data for a vault from the Aarna engine database. Returns: { data: object, message: string, statusCode: number }.
get_historical_nav
Get historical NAV — Returns historical NAV data points for a vault over a specified period. Each data point contains a timestamp and NAV value. Returns: { data: { timestamp: number, nav: string }[], message: string, statusCode: number }.
get_historical_tvl
Get historical TVL — Returns historical TVL data points for a vault over a specified period. Each data point contains a timestamp and TVL value. Returns: { data: { timestamp: number, tvl: string }[], message: string, statusCode: number }.
build_deposit_tx
Build deposit transaction — Returns an ordered array of `TxStep` objects to execute a vault deposit. Pre-flight checks are run server-side before any calldata is built: - **Deposits paused** — 400 if the vault has deposits paused - **Insufficient balance** — 400 with a human-readable message if the user's wallet balance is below the requested amount - **Allowance check** — the `approve` step is **only included when the user's current allowance is below the deposit amount** (saves gas for repeat depositors) Response contains **1 or 2 steps**: - 1 step → deposit only (allowance already sufficien
build_withdraw_tx
Build withdraw transaction — Returns a `TxStep` array for a standard vault withdrawal. The user redeems vault shares in exchange for an output token. - **step 1** (`type: "withdraw"`) — redeems shares for the output token `minOut` is calculated server-side from the `slippage` parameter using bigint basis-point math. Ensure your wallet is on the `chainId` returned in the step. Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[],
build_stake_tx
Build stake transaction — Returns an ordered array of `TxStep` objects to stake vault tokens into a timelock contract. Pre-flight checks: vault must support staking, user must have sufficient vault token balance. Response is 1–2 steps: - 1 step → stake only (allowance sufficient) - 2 steps → approve then stake Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[], message: string, statusCode: number }.
build_unstake_tx
Build unstake transaction — Returns a `TxStep` to unstake vault tokens from a timelock contract. Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[], message: string, statusCode: number }.
build_queue_withdraw_tx
Build queue-withdraw transaction — Initiates a queued (delayed) withdrawal. The withdrawal must be redeemed separately once it is processed by the vault. Only available on vaults with `STANDARD` or `STANDARD_AUTO_REDEEM` withdraw type. Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[], message: string, statusCode: number }.
build_unqueue_withdraw_tx
Build unqueue-withdraw transaction — Cancels a pending queued withdrawal request. Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[], message: string, statusCode: number }.
build_redeem_withdraw_tx
Build redeem-withdraw transaction — Claims (redeems) a completed queued withdrawal from a vault. Returns: { data: { step: number, label: string, type: "approve" | "deposit" | "withdraw" | "stake" | "unstake" | "queue_withdraw" | "unqueue_withdraw" | "redeem_withdraw", to: string, data: string, value: string, ... }[], message: string, statusCode: number }.
get_user_investments
Get user investments — Returns a user's portfolio and position data across ATV vaults from the Aarna engine database. Returns: { data: object, message: string, statusCode: number }.