Gelato Network Contracts

Intro to Gelato's use of the Diamond Proxy pattern

Gelato Network is designed to handle the rapidly evolving multi-chain landscape with its diversity of L1, L2 and sidechain designs. Significant differences can be found across aspects such as consensus mechanisms, block times, likelihood of block re-orgs and transaction fee models.

To handle the nuances that each blockchain design entails, GelatoV2 smart contracts follow a modular upgradeability standard: EIP-2535 Diamond Proxy.

Diamond Proxy Pattern

A Diamond contains:

• Proxy contract that holds all state variables.

• Facets which are smart contracts that implement any desired functionality and can be replaced at any time.

• Libraries, which can be used to share state variables and utility functions across all Facets.

Benefits of Diamond Proxy Pattern

• Having a single smart contract holding all the state, while not running into issues of exceeding bytecode size.

• Ability to share state variables and functions between multiple Facets.

• Fine-grained control in terms of which components of the protocol to upgrade. This means that protocol upgrades are gas-efficient.

• Optionality of changing GelatoV2 from upgradeable to immutable at any time, simply by revoking rights to upgrade Facets.

Implementing GelatoV2 as a Diamond means that we can easily accommodate new use cases by eliminating integration friction with users and developers, adapt to lower level changes such as a chain changing from the legacy transaction fee model to EIP-1559, and simply adding or removing features as needed without enforcing strong opinions at the application interface level.

GelatoV2 on Ethereum mainnet can be found here: https://louper.dev/diamond/0x3CACa7b48D0573D793d3b0279b5F0029180E83b6

Facets of GelatoV2

Brief guide to the facets that make up GelatoV2 on Ethereum mainnet:

Facet	Function
DiamondCutFacet	Used to make upgrades to the Diamond, such as removing and adding new Facets, and possibly initialising their state variables upon deployment.
DiamondLoupeFacet	Helper smart contract which allows one to inspect all Facets in the Diamond at any given time.
OwnershipFacet	Manage the ownership of GelatoV2, whose owner is currently the Gelato Multisig smart contract.
AddressFacet	Manage Gelato specific utility smart contracts such as the gas price oracle and oracle aggregator.
GelatoV1Facet	Backward compatibility with GelatoV1.
ConcurrentCanExecFacet	Coordination algorithm between multiple Gelato executors.
ExecAccessFacet	Manage Gelato executors.
ExecAccessFlashbotsFacet	Manage Gelato executors that submit their tasks as Flashbots bundles.
ExecAccountingFacet	Manage accounting of transaction fees, and soon also payroll to Gelato executors.
ExecFacet	Main Facet. All tasks submitted to Gelato will be routed through the exec method.
PrepaidExecFacet	Facet where some use-case specific calls will be routed. Currently deprecated.
UniswapV2SwapFacet	Similar to ExecFacet, but automatically handles token swaps upon payment. Currently deprecated.
TransferFacet	Fee withdrawal from GelatoV2, managed by Gelato Multisig.

Implementations of GelatoV2 on other chains can also be found on Louper.