Proxy Patterns

A comprehensive reference implementation of major EVM proxy patterns with unified test specifications.

Patterns

Pattern	EIP	Key Mechanism
Transparent Proxy	EIP-1967	Admin-gated fallback routing via msg.sender check
UUPS	EIP-1822 + EIP-1967	Upgrade logic in implementation; immutable __self guard
Beacon Proxy	EIP-1967	Fleet of proxies reading implementation from a shared beacon
Clones	EIP-1167	45-byte delegating bytecode via CREATE / CREATE2

Project Structure

proxy-patterns/
├── src/
│   ├── clone/
│   │   └──	Clones.sol
│   ├── ERC1967/
│   │   ├──	beacon/
│   │   │  	├── BeaconProxy.sol
│   │   │  	└── UpgradeableBeacon.sol
│   │   ├──	transparent/
│   │   │  	├── ProxyAdmin.sol
│   │   │  	└── TransparentUpgradeableProxy.sol
│   │   ├──	uups/
│   │   │  	├── UUPSProxy.sol
│   │   │  	└── UUPSUpgradeable.sol
│   │   ├──	ERC1967Proxy.sol
│   │   └──	ERC1967Utils.sol
│   ├── diamond/
│   │   │   faces/
│   │   │   ├── DiamondCutFacet.sol
│   │   │   ├── DiamondLoupeFacet.sol
│   │   │   └── OwnershipFacet.sol
│   │   ├── interfaces/
│   │   │       ├── IDiamondCut.sol
│   │   │       ├── IDiamondLoupe.sol
│   │   │       └── IERC173.sol
│   │   ├── Diamond.sol
│   │   └── LibDiamond.sol
│   ├── utils/
│   ├── Initializable.sol
│   └── Ownable.sol
├── test/
├── script/
└── foundry.toml

Usage

Build

$ forge build

Test

$ forge test

Gas Snapshots

$ forge snapshot

Deploy

$ forge script script/Counter.s.sol:CounterScript --rpc-url <your_rpc_url> --private-key <your_private_key>