Smart contracts for EV-Reth, including the FeeVault for collecting and distributing fees.

The AdminProxy contract solves the bootstrap problem for admin addresses at genesis. It acts as an intermediary owner/admin for other contracts and precompiles (like the Mint Precompile) when the final admin (e.g., a multisig) is not known at genesis time.

See AdminProxy documentation for detailed setup and usage instructions.

The FeeVault is an optional contract for chains that need on-chain fee splitting logic. The base fee redirect (baseFeeSink) works with any address — an EOA or multisig is sufficient if you just need fees sent to a single destination.

FeeVault is useful when you need:

• Automatic splitting of accumulated fees between two recipients (e.g., 80% to a bridge contract, 20% to a treasury)
• Minimum threshold to avoid distributing uneconomically small amounts
• Keeper incentive (callFee) so anyone can trigger distribution and get compensated

If your chain only needs fees routed to a single address, skip FeeVault and point baseFeeSink directly at that address.

• Foundry

forge build

forge test

The FeeVault uses CREATE2 for deterministic addresses across chains.

All configuration is set via constructor arguments at deploy time:

*Required if BRIDGE_SHARE_BPS < 10000

Note: BRIDGE_RECIPIENT must be set via setBridgeRecipient() after deployment for the vault to be operational.

Any bytes32 value works as a salt. Common approaches:

# Simple approach - just use a version number
export SALT=0x0000000000000000000000000000000000000000000000000000000000000001

# Or hash a meaningful string
export SALT=$(cast keccak "FeeVault-v1")

To see what address will be deployed to without actually deploying:

export OWNER=0xYourOwnerAddress
export SALT=0x0000000000000000000000000000000000000000000000000000000000000001
export DEPLOYER=0xYourDeployerAddress  # The address that will run the script

forge script script/DeployFeeVault.s.sol:ComputeFeeVaultAddress

# Required
export OWNER=0xYourOwnerAddress
export SALT=0x0000000000000000000000000000000000000000000000000000000000000001

# Optional - configure at deploy time (can also be set later)
export MINIMUM_AMOUNT=1000000000000000000  # 1 ETH in wei
export CALL_FEE=100000000000000  # 0.0001 ETH
export BRIDGE_SHARE_BPS=8000  # 80% to bridge
export OTHER_RECIPIENT=0xOtherAddress

# Dry run (no broadcast)
forge script script/DeployFeeVault.s.sol:DeployFeeVault \
    --rpc-url <RPC_URL>

# Deploy for real
forge script script/DeployFeeVault.s.sol:DeployFeeVault \
    --rpc-url <RPC_URL> \
    --private-key <PRIVATE_KEY> \
    --broadcast

After deployment, set the bridge recipient address:

cast send <FEEVAULT_ADDRESS> "setBridgeRecipient(address)" <BRIDGE_RECIPIENT_ADDRESS> \
    --rpc-url <RPC_URL> \
    --private-key <PRIVATE_KEY>

All functions are owner-only: