[contracts] Vault views: getPositions, getTotalAmounts, getPoolKey, sharePrice, TVL cap

[ozpool]

Context

Read-only views used by frontend + keeper + tests. Includes TVL cap enforcement on deposit.

Ref: PRISM_PRD_v1.0.html §Day 1 Core Interfaces.

Scope

In scope:

• All IVault views
• Share price helper
• TVL cap check integrated into deposit revert path

Out of scope:

• Historical views (post-MVP)

Acceptance Criteria

• Views return consistent values across deposit/withdraw cycles
• Compiles with forge build (Solidity 0.8.25)
• Custom errors only (Errors.sol); no string reverts
• ReentrancyGuardTransient on PoolManager-facing externals where applicable
• NatSpec on every external/public
• Unit tests: happy + reverts + access control
• forge test -vvv passes; forge fmt --check clean
• Slither + Aderyn: no new findings
• Gas snapshot saved; no regression vs CLAUDE.md §Gas Targets

Dependencies

• Blocks: [test] Vault unit tests: happy path + reverts + access control + reentrancy probes #38, [frontend] Vault detail page layout: header + TVL/APR/share-price metrics + positions table #50, [frontend] PrismVisual: d3 component rendering tick-range distribution with weight heights #51, [frontend] Deposit form: paired amount inputs + approval flow + preview + tx state machine #52, [frontend] Withdraw form: share input + proportional preview + tx state machine #53
• Blocked by: [contracts] Vault: storage layout + ERC-20 share accounting + constructor wiring #26

References

• N/A

Estimate

S