[contracts] IVault interface: deposit, withdraw, rebalance, views, events, Position struct

[ozpool]

Context

Public Vault API every other contract and the frontend speaks through. Defined before Vault.sol so mocks + tests + impl compile against the same signatures.

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

Scope

In scope:

• packages/contracts/src/interfaces/IVault.sol
• struct Position { int24 tickLower; int24 tickUpper; uint128 liquidity; }
• deposit, withdraw, rebalance, getPositions, getTotalAmounts, poolKey
• Events: Deposit, Withdraw, Rebalanced, FeesCollected
• Inherits IERC20

Out of scope:

• Implementation (Vault.sol — [contracts] Vault: storage layout + ERC-20 share accounting + constructor wiring #26–[contracts] Vault views: getPositions, getTotalAmounts, getPoolKey, sharePrice, TVL cap #30)

Acceptance Criteria

• Signatures match PRD §Day 1 exactly
• Imports PoolKey from v4-core
• 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: [contracts] Vault: storage layout + ERC-20 share accounting + constructor wiring #26, [contracts] Vault.deposit: unlock callback + multi-position deploy + MIN_SHARES burn on first #27, [contracts] Vault.withdraw: proportional removal from all positions + never-pausable guarantee #28, [contracts] Vault.rebalance: remove-all → slippage-bounded internal swap → redeploy in single unlock #29, [contracts] Vault views: getPositions, getTotalAmounts, getPoolKey, sharePrice, TVL cap #30, [frontend] packages/shared: generated ABIs + per-chain addresses + shared TypeScript types #45, [frontend] scripts/export-abis.ts: Foundry out/ → packages/shared/abi.ts automation #46
• Blocked by: [contracts] Monorepo + Foundry workspace: pnpm + Turborepo + foundry.toml (via_ir, cancun) #15, [contracts] Pin v4-core + v4-periphery commits in .gitmodules (document SHAs in README) #16

References

• PRD §Day 1 IVault

Estimate

S

[ozpool]

IVault shipped in #142. PRD §Day 1 surface verbatim, OZ IERC20 import via existing v4-core remapping (@openzeppelin/contracts/...), 14 tests pass (selectors + event topics + mock + IERC20 inheritance).