Fee Claiming
It is possible to periodically withdraw rewards for the Vault's fee shareholders through the Fee Splitter system.
Prerequisites
- Set Fee Claimer Role: In your Vault settings, assign the operator's wallet address as the Fee Claimer in the Roles tab
- Start with Flag: Add the
--claim-fee-splitter
flag when starting the Operator Service
Configuration
The automated fee claiming process can be configured using environment variables:
Environment Variables
FEE_SPLITTER_INTERVAL
- Controls how often fee claiming runs in seconds (default: 86400 seconds = 24 hours)
FEE_SPLITTER_MIN_ASSETS
- Minimum amount accumulated in the fee splitter contract (in Wei) before processing withdrawals to avoid unnecessary gas fees (default: 1000000000000000 Wei = 0.001 ETH)
How It Works
The fee claiming task combines multiple operations into a single multicall transaction:
- Harvest vault rewards from Keeper contract
- Withdraw splitter rewards on behalf of each shareholder (rewards go to exit queue)
- Claim exited assets on behalf of each shareholder (assets go directly to shareholder addresses)
Usage
# Start operator with fee claiming enabled
./operator start-local \
--vault=0x3320a68 \
--consensus-endpoints=http://localhost:5052 \
--execution-endpoints=http://localhost:8545 \
--claim-fee-splitter
Gas Optimization
To avoid unnecessary gas fees from the operator's wallet, withdrawals are processed only if their total amount exceeds the minimum threshold set by FEE_SPLITTER_MIN_ASSETS
.