Fee vault operations

​

Prerequisites

• Access to the ProxyAdminOwner account (required for configuration changes)
• An RPC endpoint for your L2 chain
• cast CLI tool installed (Foundry)

​

Fee vault addresses

​

Checking vault state

​

View current balance

export L2_RPC=<L2_RPC>
export VAULT=<VAULT_ADDRESS>

cast balance $VAULT --rpc-url $L2_RPC

​

View configuration

# Recipient address
cast call $VAULT "recipient()" --rpc-url $L2_RPC

# Minimum withdrawal amount (in wei)
cast call $VAULT "minWithdrawalAmount()" --rpc-url $L2_RPC

# Withdrawal network (0 = L1, 1 = L2)
cast call $VAULT "withdrawalNetwork()" --rpc-url $L2_RPC

# Total native token withdrawn historically
cast call $VAULT "totalProcessed()" --rpc-url $L2_RPC

​

Updating configuration

​

Set recipient

export L2_RPC=<L2_RPC>
export VAULT=<VAULT_ADDRESS>
export PK=<PROXY_ADMIN_OWNER_PRIVATE_KEY>

cast send --rpc-url $L2_RPC --private-key $PK \
  $VAULT "setRecipient(address)" <NEW_RECIPIENT_ADDRESS>

​

Set minimum withdrawal amount

cast send --rpc-url $L2_RPC --private-key $PK \
  $VAULT "setMinWithdrawalAmount(uint256)" <AMOUNT_IN_WEI>

​

Set withdrawal network

# 0 = L1, 1 = L2
cast send --rpc-url $L2_RPC --private-key $PK \
  $VAULT "setWithdrawalNetwork(uint8)" <0_OR_1>

​

Withdrawing fees

​

Trigger a withdrawal

cast send --rpc-url $L2_RPC --private-key $PK \
  $VAULT "withdraw()"

​

Withdrawal behavior by network

• L2 withdrawal (withdrawalNetwork = 1): Funds are transferred immediately to the recipient on L2. The transaction completes in a single step.
• L1 withdrawal (withdrawalNetwork = 0): An L2-to-L1 withdrawal is initiated via the L2ToL1MessagePasser. After calling withdraw(), you must still:
  1. Wait for the withdrawal to be included in an L2 output root
  2. Prove the withdrawal on L1
  3. Wait for the finalization period
  4. Finalize the withdrawal on L1
  For details on completing L1 withdrawals, see Withdrawal flow.

​

Initial configuration during deployment

​

Monitoring

• Vault balances: Track balances to know when withdrawals can be triggered.
• totalProcessed: Monitor cumulative withdrawals over time to understand revenue trends.

​

Next steps

• Read the fee vaults explainer to understand how vaults work at the protocol level.
• See Transaction Fees 101 to learn how to tune fee parameters.
• Review fee components and formulas for detailed fee calculations.