Deposit Forwarder System

A system for managing user deposits through deterministic contract addresses.

Architecture

Three main contracts:

1. DepositForwarder — per-user contract that receives and forwards deposits
2. DepositForwarderFactory — creates and tracks DepositForwarder instances
3. MasterForwarder — holds critical addresses and configuration

Role-based access control

• SAFE wallet — controls MasterForwarder

  • Can change destination address
  • Can change deployer address
  • Can change forwarder caller address

• Deployer — authorized to create new deposit forwarders

  • Calls createDepositForwarder on the factory
  • Address managed by MasterForwarder

• Forwarder caller — operator wallet allowed to trigger ERC-20 transfers

  • Calls forward on deposit forwarders
  • Address managed by MasterForwarder

Contract details

DepositForwarder

• Accepts ETH and ERC-20 tokens
• Forwards assets to the destination address
• Deployed at deterministic addresses
• Protected by a reentrancy guard

MasterForwarder

• Manages destination addresses
• Controls deposit forwarders
• Implements multisig security
• Handles emergency procedures

Flows

Deposit address creation

Loading diagram…

Deposit address assignment

Loading diagram…

Processing a user's ETH or ERC-20 deposit

Loading diagram…