Vault shares: compare conversions with withdrawable assets
Vault shares represent a claim whose displayed asset conversion may differ from what a particular owner can withdraw now. Research the interface semantics before valuing a position as immediately accessible assets. A conversion estimate, a transaction preview and a withdrawal limit answer distinct questions.
ERC-4626 defines tokenized vault interfaces, including conversions, previews and maximum withdrawal or redemption methods. The specification distinguishes idealized conversion from transaction-specific conditions. Actual implementation, fees, limits and current state still require inspection.
Preserve shares and underlying units
Record the vault network, contract, underlying asset and share decimals. Store the holder’s share balance separately from represented underlying quantity. A convenient asset-value display can hide the fact that the object directly held is a share token with its own transfer and redemption conditions.
Identify the question behind each interface call. A conversion function can describe an idealized exchange relationship. A preview concerns the corresponding transaction’s expected calculation under its specified semantics. A maximum function concerns the amount allowed for the given owner. None should be substituted for another simply because each returns an asset-like number.
Retain the caller or owner used for account-dependent observations, along with block and method. A vault-wide total and a personal limit have different scopes. Do not compare them as if both were balances available to the same user.
Hypothetical conversion and access gap
Assume a fictional owner holds 100 shares. An idealized conversion reports 120 underlying units. A redemption preview reports 118 after the stipulated transaction treatment, while the current owner-specific maximum permits redemption of only 40 shares. These are three observations, not three competing estimates of one quantity.
Under a deliberately simplified proportional assumption, the preview for 40 shares would correspond to 47.2 underlying units. A real vault must be queried under the actual transaction amount and rules; nonlinear fees, rounding or restrictions can invalidate that scaling. All figures are hypothetical.
The memo should therefore distinguish the 120-unit conversion representation, the relevant preview and the currently permitted size. Calling all 120 units cash available now would ignore the access constraint. Calling the difference a realized loss would also overstate what has happened.
Interface comparison worksheet
| Object | Record | Research meaning |
|---|---|---|
| Share balance | Owner, units and block | Position directly held |
| Asset conversion | Method and input shares | Idealized representation under its semantics |
| Transaction preview | Exact method and amount | Corresponding calculation, with applicable treatment |
| Owner-specific maximum | Owner and method | Current permitted amount |
| Actual redemption | Transaction and received units | Realized outcome if executed |
Keep raw integer results and documented rounding direction. Small-unit differences may be arithmetic effects rather than economic fees. Conversely, attributing every gap to rounding can conceal genuine restrictions. Classify the difference only after inspecting the relevant method definitions and implementation.
Avoid false liquidity conclusions
A high totalAssets value does not establish that all assets can be delivered to one owner immediately. Strategy positions, protocol states or per-owner restrictions can create different access conditions. Do not invent a restriction because one is possible; seek the actual deployed evidence and mark unresolved dependencies explicitly.
Repeat observations when relevant configuration changes, preserving the earlier snapshot. A limit changing later does not mean the earlier observation was incorrect. The final research note should state what the shares represent, what the methods reported and what current access evidence remains missing. It should not turn a standardized interface into a universal redemption guarantee.
FAQ
Is convertToAssets a guaranteed net redemption quote?
No. Read its specified semantics and distinguish it from previews, limits and actual transaction outcomes.
Does a withdrawal limit below the displayed value prove insolvency?
No. Access restrictions and solvency require separate evidence. Investigate the relevant implementation and state before assigning a cause.