For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tracking Your Position

Tracking your position

Everything below is readable onchain without permission. Set these first:

VAULT=<vault proxy>
MANAGER=<manager proxy>
YIELD=<yield proxy>
ASSET=<underlying token>
ME=<your address>
RPC=<rpc url>

Your position

# Shares held
cast call $VAULT "balanceOf(address)(uint256)" $ME --rpc-url $RPC

# Current value, gross
cast call $VAULT "convertToAssets(uint256)(uint256)" <shares> --rpc-url $RPC

# What you would actually be quoted, net of the exit fee
cast call $VAULT "previewRedeem(uint256)(uint256)" <shares> --rpc-url $RPC

Your pending redemption

The assets value is what you will receive — fixed at request time and unaffected by anything that happens afterwards.

Is your withdrawal actually payable?

Cooldown elapsed is necessary but not sufficient. The vault must also hold enough assets.

This is the most useful health check available to a depositor. If the vault's balance is persistently below totalRequestedAmount(), redemptions are not being funded promptly. Tracking this over time tells you more about operational health than the share price does.

Vault-wide state

Yield reporting history

Comparing profit() against loss() gives you the strategy's reported lifetime performance. A stalled epoch() or a lastDistributionTime() far in the past means reporting has stopped.

Events worth watching

Event
Contract
Why you care

DistributeYield

Yield

An epoch's result was reported

TreasuryDebtAccrued

Yield

A loss exceeded what the treasury could absorb

RedemptionRequested

Vault

Your request was recorded, with the locked amount

Withdraw / WithdrawalExecuted

Vault

A redemption was paid

FeeSet, CooldownPeriodUpdated

Vault

Your terms changed

Paused / Unpaused

Vault

Deposits and withdrawals halted or resumed

WhitelistUpdated

Manager

A new destination for capital was authorised

Upgraded

all three

Contract code was replaced

RoleGranted / RoleRevoked

all three

Privileged access changed hands

Monitoring gaps

Two things you cannot track by event:

  • transferToVault emits no event. Redemption funding — the step your withdrawal depends on — is only visible as a plain ERC-20 Transfer to the vault.

  • AssetsWithdrawn is declared but never emitted. Do not build monitoring against it.

Last updated