GPv2AllowListAuthentication Contract

The GPv2AllowListAuthentication contract manages solver authorization for CoW Protocol settlements through an allowlist-based access control system.

Architecture

The contract employs a two-tier access model:

Manager - Handles day-to-day solver administration
Proxy Owner - Top-level administrator with override capabilities

State Variables

Variable	Type	Description
`manager`	`address`	Address with permissions to add/remove solvers
`solvers`	`mapping(address => bool)`	Private mapping tracking authorized solver addresses

Functions

initializeManager()

One-time initialization for proxy deployment:

function initializeManager(address manager_) external initializer {
    manager = manager_;
    emit ManagerChanged(manager_);
}

setManager()

Transfers the manager role. Can be called by the current manager or proxy owner:

function setManager(address manager_) external onlyManagerOrOwner {
    manager = manager_;
    emit ManagerChanged(manager_);
}

addSolver()

Grants solver authorization (manager only):

function addSolver(address solver) external onlyManager {
    solvers[solver] = true;
    emit SolverAdded(solver);
}

removeSolver()

Revokes solver authorization (manager only):

function removeSolver(address solver) external onlyManager {
    solvers[solver] = false;
    emit SolverRemoved(solver);
}

isSolver()

Checks solver authorization status (public view):

function isSolver(address solver) external view returns (bool) {
    return solvers[solver];
}

Access Control Modifiers

Modifier	Allowed Callers
`onlyManager`	Current manager address only
`onlyManagerOrOwner`	Manager or proxy admin

Events

event ManagerChanged(address newManager);
event SolverAdded(address solver);
event SolverRemoved(address solver);

Proxy Integration

The contract supports EIP-1967 compliant proxies, enabling:

Upgradeability of the authentication logic
Emergency governance override through proxy admin
Consistent address across upgrades

Contracts

Hooks Trampoline

Composable CoW

Contracts SDK

Flash Loan Router

GPv2AllowListAuthentication

GPv2AllowListAuthentication Contract

Architecture

State Variables

Functions

initializeManager()

setManager()

addSolver()

removeSolver()

isSolver()

Access Control Modifiers

Events

Proxy Integration

​GPv2AllowListAuthentication Contract

​Architecture

​State Variables

​Functions

​initializeManager()

​setManager()

​addSolver()

​removeSolver()

​isSolver()

​Access Control Modifiers

​Events

​Proxy Integration

GPv2AllowListAuthentication Contract

Architecture

State Variables

Functions

initializeManager()

setManager()

addSolver()

removeSolver()

isSolver()

Access Control Modifiers

Events

Proxy Integration