Gelato
  • Introduction
    • Gelato, The Web3 Cloud Platform
  • Smart Wallets
    • Introduction
      • Understanding EIP-7702
      • Understanding ERC-4337
      • ERC-4337 vs EIP-7702
    • Templates & Examples
    • How-To Guides
      • Create a Sponsor API Key
      • Sponsor gas for your users
      • Allow users to pay gas with erc20
      • Allow users to pay gas with native
      • Create Dynamic's Environment Id
      • Use Dynamic/Privy signers with React SDK
      • Estimate Gas for your transactions
    • React SDK
    • Demo
    • Supported Networks
  • Rollup As A Service
    • Introduction
    • Rollup Stacks
      • Arbitrum Orbit
        • Run a Full Orbit Node
      • OP Stack
        • Run OP Node
    • Deploy your Rollup
    • Customization
      • Data Availability
        • Celestia
        • Avail
        • Eigen DA
      • Custom Gas Token
      • Marketplace
        • Gelato Services
        • Data Indexers
        • Block Explorers
        • Oracles
        • Bridges
        • Account Abstraction
        • On & Off-ramp
        • Community
        • Identity & KYC
        • Others
      • Verifier Node Package
    • Public Testnet
  • RPC Nodes
    • Introduction
    • Compute Units
    • Using RPC Nodes
    • Supported Networks
    • Pricing and Plans
    • FAQ
  • Web3 Services
    • Web3 Functions
      • Understanding Web3 Functions
        • Trigger Types
        • Typescript Function
        • Solidity Function
        • Automated Transactions
      • Security Considerations
      • Template & Use Cases
      • Quick Start
        • Writing Typescript Functions
          • Event Trigger
          • Private Typescript Functions
          • Callbacks
        • Test, Deploy & Run Typescript functions
        • Writing Solidity Functions
        • Test, Deploy & Run Solidity Functions
        • Initiate an Automated Transaction
      • Create a Web3 Function Task
        • Using the UI
        • Using the Safe App
        • Using a Smart Contract
        • Using the Automate SDK
      • Analytics & Monitoring
      • Supported Networks
      • Subscription & Payments
      • Legacy Automate Migration Guide
    • Relay
      • What is Relaying?
      • Security Considerations
        • ERC-2771 Delegatecall Vulnerability
      • Templates
      • Quick Start
        • Sponsored Calls
        • Non-Sponsored Calls
      • ERC-2771 (recommended)
        • SponsoredCallERC2771
        • CallWithSyncFeeERC2771
          • Relay Context Contracts ERC2771
      • Non-ERC-2771
        • SponsoredCall
        • CallWithSyncFee
          • Relay Context Contracts
      • Relay API
      • Gelato's Fee Oracle
      • Tracking your Relay Request
      • Supported Networks
      • Subscriptions and Payments
        • 1Balance & Relay
        • SyncFee Payment Tokens
        • Relay Pricing
      • ERC2771 Migration Guide
    • VRF
      • Understanding VRF
      • How does Gelato VRF Work?
      • Security Considerations
      • Template
      • Quick Start
      • Create a VRF Task
        • Create a Fallback VRF
        • Migrating from Chainlink VRF
      • Supported Networks
      • Pricing & Rate Limits
    • Oracles
      • Understanding Gelato Oracles
      • Quick Start
      • Data Providers
        • Stork
        • Choas Labs
      • Migrating from Chainlink Oracles
      • Available Price Feeds
      • Supported Networks
      • Pricing & Rate Limits
    • Account Abstraction
      • Understanding ERC-4337
      • Introduction to Gelato Bundler
      • Templates & Examples
      • Quick Start
      • Supported Networks
      • Bundler API Endpoints
        • eth_sendUserOperation
        • eth_estimateUserOperationGas
        • eth_getUserOperationByHash
        • eth_getUserOperationReceipt
        • eth_supportedEntryPoints
        • eth_maxPriorityFeePerGas
        • eth_chainId
    • 1Balance
      • 1Balance Alerts
      • Subscription Plans
      • Subscription Notifications
      • USDC Addresses
    • AI Agents
    • Teams
  • GELATO DAO
    • DAO & Token (GEL)
    • GEL Token Contracts
    • Governance Process
  • Social Media
Powered by GitBook
On this page

Last updated 2 months ago

This only applies if you are using @gelatonetwork/relay-sdk v3 or contracts from the package @gelatonetwork/relay-context v2

Gelato Relay ERC2771 proxy contracts are immutable for security reasons. We have deployed new versions of our ERC2771 proxy contracts with enhanced security: GelatoRelayERC2771.sol and GelatoRelay1BalanceERC2771.sol, new addresses of which you can find .

To support these new contracts, Relay Context Contracts found in the package @gelatonetwork/relay-context have been updated to version v3, along with the Gelato Relay SDK package @gelatonetwork/relay-sdk, which has been updated to version v4.

Gelato Relay continues to support ERC2771 contracts that inherit from the legacy @gelatonetwork/relay-context v2, so you can upgrade at your own convenience. Nevertheless we recommend you to upgrade as soon as possible to ensure optimal security, features and support.

To illustrate package and contract compatibility please refer to the following matrix:

Gelato Relay ERC2771 Contract
relay-sdk
relay-context

Please note that contract addresses differ on .

Using @gelatonetwork/relay-sdk v3 with contracts inheriting from @gelatonetwork/relay-context v3, or using @gelatonetwork/relay-sdk v4 with contracts inheriting from @gelatonetwork/relay-context v2 won't work, as they refer to different Gelato Relay ERC2771 contracts.

Migration steps

  1. If you deployed contracts that inherit from @gelatonetwork/relay-context - update the package version and either upgrade or redeploy your contracts.

    • If you are using sponsoredCallERC2771 in combination with ERC2771Context.sol - make sure to use the new GelatoRelay1BalanceERC2771.sol contract address as the trustedForwarder which you can find .

  2. If you are using @gelatonetwork/relay-sdk - update the package version in your project.

  3. Make sure you use your newly upgraded/deployed contract addresses with the updated Gelato Relay SDK package.

If you cannot upgrade or redeploy your ERC2771-compatible contracts, please to find a future-proof solution together.

  1. Web3 Services
  2. Relay

ERC2771 Migration Guide

How to migrate to the new Gelato Relay ERC2771 contracts

PreviousRelay PricingNextVRF

Legacy GelatoRelayERC2771.sol: 0xBf175FCC7086b4f9bd59d5EAE8eA67b8f940DE0d

v3

v2

GelatoRelayERC2771.sol: 0xb539068872230f20456CF38EC52EF2f91AF4AE49

v4

v3

GelatoRelay1BalanceERC2771.sol: 0xd8253782c45a12053594b9deB72d8e8aB2Fca54c

v4

v3

contact us
here
zkSync Era
here