Only this pageAll pages
Powered by GitBook
1 of 29

Docs

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Solutions For You

Our Vision: Realtime Ethereum

Start Here: The Future is Instant

Welcome to the ETHGas Docs!

The End of Latency. The Beginning of Realtime.

The promise of the decentralized internet is speed, efficiency, and open access. Yet, today's users are still stuck waiting—stuck with 12-second block times, unpredictable transaction costs, and the constant friction of gas fees. This latency is the single biggest barrier to mass adoption.

ETHGas is the real-time infrastructure layer that fixes this.

We are not just another protocol; we are building the foundational financial market for Ethereum's blockspace. We transform the chaotic, unpredictable auction for transaction inclusion into a structured, liquid, and tradable asset class.

Through this, we enable a profound shift in how the ecosystem operates:

  • For Protocols & dApps: Build stickier products. Our Gas Abstraction Initiative lets you sponsor user gas fees, turning your biggest friction point into your strongest retention tool.

  • For Traders & Market Makers: Gain your critical edge. Trade blockspace as a new liquid asset for precision execution and new forms of alpha.

  • For Validators & Staking Operators: Earn the yield you deserve. Access a superior, more predictable revenue stream by providing the infrastructure for a real-time Ethereum.

Our Mission 💪

To build the realtime infrastructure for Ethereum's economy. We transform gas from a volatile friction point into a tradable asset class while removing the concept of gas from the user experience.

The Future We Create 🪄

We are accelerating the Ethereum of the Future to make it instant—a future where transactions settle immediately, capital flows without friction, and the complexity of gas becomes a relic of the past.

Our Four Pillars

Our Four Pillars: The ETHGas Flywheel

Pillar 1: Real-Time Ethereum ✨ (The Vision)

  • What It Is: This is our grand promise. We are building the infrastructure to enable a new economy where transactions settle in milliseconds, not seconds. It's about giving traders, protocols, and builders the critical edge they need to innovate at the speed of thought.

For Retail Users: Experience a seamless Web3. Through our partners, your gas fees become gas rebates, making your on-chain life effortless and rewarding.
Who It's For: High-frequency traders, sophisticated protocols, and anyone who needs absolute certainty and speed.
  • The Core Message: "Gain a critical edge with millisecond transaction settlement. This is the future of on-chain execution."

  • Pillar 2: The Blockspace Trading Platform ⚙️ (The Engine)

    • What It Is: This is the engine at the heart of our ecosystem. We've transformed raw, chaotic blockspace into standardized, tradable products like Inclusion Guarantees and Whole Blocks. This creates a liquid and efficient marketplace for the first time.

    • Who It's For:

      • Blockspace Buyers: Traders and protocols who can now achieve the precise execution they need without being block-building experts.

      • Blockspace Sellers: Validators and staking providers who can now sell programmable blockspace as a premium asset.

    • The Core Message: "We've turned blockspace into a liquid, tradable asset. Participate in the market with unprecedented ease and efficiency."

    Pillar 3: Superior, Predictable Yield 💰 (The Fuel)

    • What It Is: This is the powerful incentive that fuels our engine. By selling their blockspace on our platform, validators and staking providers can access an additional, and completely separate revenue stream that goes far beyond standard staking rewards and unpredictable MEV.

    • Who It's For: Staking operators, validators, and every single person who has ETH staked.

    • The Core Message: "Your staked ETH is underperforming. Demand more from your staking provider. Demand the superior, predictable yield that ETHGas enables."

    Pillar 4: The Open Gas Initiative: Gasless User Layer 🚀 (The Experience)

    • What It Is: This is where our powerful engine meets the end-user. Through our Gas Abstraction Initiative, we empower dApps to subsidize gas fees for their community via our simple, zero-code rebates program.

    • Who It's For: Protocols, dApps, and everyday retail users.

    • The Core Message: "Stop losing users to gas fees. Join our Open Gas Initiative to build a loyal community and create the seamless experience your users deserve."

    The Synergy: How It All Works Together 🔄

    This isn't just a list; it's a powerful, self-reinforcing flywheel:

    Superior Yield (Pillar 3) attracts validators to our Blockspace Trading Platform (Pillar 2), creating deep, liquid supply. This supply allows us to offer the groundbreaking products that enable Real-Time Ethereum (Pillar 1). The efficiency and value this creates attracts protocols, who then use the (Open Gas) Gasless User Layer (Pillar 4) to onboard more users. This drives more transaction volume back into the ecosystem, which in turn increases the potential yield for validators, making our supply-side even stronger.

    It's a closed loop where each pillar amplifies the others.

    What is ETHGas?

    From Digital Chaos to Realtime Ethereum.

    Sending a transaction on Ethereum today is like navigating a chaotic system. You face unpredictable costs, uncertain wait times, and a frustrating lack of control. It’s the single biggest point of friction holding Web3 back.

    ETHGas builds the infrastructure to bring order to this chaos.

    We are transforming the economic fabric of Ethereum, turning volatile gas fees and blockspace into a structured, predictable, and highly efficient market. We do this through two core innovations:

    1. Blockspace Commitment: Your Premier Logistics Network

    Think of the Ethereum network as a massive global shipping system. A normal transaction is like dropping a package into standard mail during the holidays—you hope it gets there on time, but there are no guarantees.

    A Blockspace Commitment from ETHGas is your upgrade to a premier, white-glove logistics service.

    You are purchasing a pre-paid, customs-cleared, priority air freight container on the very next flight out. It’s a guarantee that your transaction is delivered with absolute precision, right when you need it. For traders, protocols, and dApps, this provides the certainty needed for a critical edge.

    This isn't just a promise; it's a suite of guarantees you can choose from:

    • The Priority Boarding Pass (An Inclusion Guarantee): This is the most direct upgrade. It's a guarantee that your package gets on that next flight, no matter how long the line is at the airport. Your transaction is guaranteed to be included in the next block.

    • The Verified Delivery (An Execution Guarantee): This goes a step further. Not only is your package on the next flight, but we also guarantee a specific outcome upon arrival—like getting a signature from the exact person you sent it to. Your transaction doesn't just get included; it achieves a specific, guaranteed result on-chain.

    • Chartering the Entire Plane (A Whole Block Commitment): This is the ultimate form of control. You aren't just booking space for a package; you are chartering the entire cargo plane. You decide exactly what goes in it, how it's organized, and you can even sell the empty space to others who need to ship their own packages. This gives you total command over the block's contents and value.

    By turning blockspace into a structured logistics network, we give you the power to choose the exact level of certainty and precision your transaction requires.

    2. Gas Rebates & Hedging: The Neighborhood Coffee Shop

    How does this powerful engine benefit the everyday user? It allows dApps to finally fix the most frustrating part of Web3: gas fees.

    Imagine your favorite coffee shop had a volatile "utility fee" that changed every few seconds. It would make buying a coffee feel like a gamble.

    ETHGas provides the tools to fix this for dApps and their users

    Our Open Gas Initiative lets the coffee shop (the dApp) fix this by offering you a seamless cashback.

    It works like this: you transact on a partner dApp and pay the gas fee as usual. But in the background, the dApp sponsors that fee for you. Later, you visit your ETHGas dashboard and see all the rebates you've earned from across Web3, ready to be claimed in a single click. What was once a frustrating cost is transformed into a rewarding experience.

    In the future,

    • For the dApp (The Shop Owner): The dApp uses our Gas Hedging products (coming soon) to lock in a fixed price for their "electricity" (their gas costs). This turns a volatile headache into a predictable operational expense.

    • For you (The Coffee Lover): Because the shop's costs are stable, you get a simple, delightful experience. You pay a flat $5 for your latte, every time. Even better, the shop can now use our Gas Rebates system to give you a loyalty card. Your 10th coffee is free.

    This is the seamless, "gasless" experience. You're just enjoying your dApp, getting rewards and instant transactions, completely unaware of the complex gas market being managed perfectly for you in the background.

    By mastering the logistics of blockspace, we empower developers to finally build the simple, rewarding experiences that will bring the next billion users to Web3.

    So, What Does This Mean for You?

    It means the end of gas anxiety.

    It means submitting a swap on a DEX or a bid on an NFT and getting an instant confirmation. It means we are giving developers the tools to finally build a seamless, gasless experience that feels as fast and fluid as the centralized web.

    This is the foundation for a true Realtime Ethereum.

    Products Deepdive

    ETHGas has four distinct products: Inclusion Preconfirmations, Execution Preconfirmations, Whole Blocks, and Base Fee Trading.

    Conventions:

    • Prices are denominated in GWEI

    • Settled in ETH

    • Referenced in USD

    • Minimum Size: 10k Gas Units

    • Minimum Increment: 1k Gas Units

    • Minimum Price: 0.01 Gwei

    • Minimum Tick Size: 0.01 Gwei

    • Order Types: Market Orders, Limit Orders, All-Or-None

    Blockspace Actors & Integrations

    Collateral AVS

    The Collateral AVS will enable native ETH stakers and validators to restake their ETH and provide security to their blockspace commitments. With Eigenlayer's 'redistribution' feature now 'live' on mainnet, and with Obol integration almost complete, we look forward to share more on this shortly.

    Base Fee Futures

    Est. Q1 2026

    • Base Fee futures are Calendar Futures for a specific slot that enable trader to go Long or Short the Base Fee accordingly

    • Settlement: Cash

    • Initial Margin: [ 100% ]

    • Maintenance Margin: [ 50% ]

    More on this shortly

    What are Gas Markets?

    Gas represents the economic fabric that binds blockchains together. Validators supply blockspace (and compute) for transactions, and Buyers pay for this blockspace, to process transactions. While Gas may ‘fuel’ blockchains, or be seen simply as ‘transaction fees’, the onset of Gas Markets very much changes this definition.

    • At a macro level, gas prices move rapidly and are often seen as a barometer for industry volatility. The early motivation behind gas markets in this context is to remove the volatility/uncertainty, so that both the risk of transacting in DeFi is reduced, and more importantly, so that the end user experience can be streamlined. Gas Markets enable Chains, Protocols (via B2B sales), and Wallets to abstract gas prices away entirely removing gas vol from the end-user altogether

    • At a micro level, the concept of gas extends beyond just ‘blockspace’ into a market perhaps more analogous to Oil Refining or Real Estate. How much gas should Validators (called Proposers) sell? When do they sell? Which ‘parcels’ of gas to sell? Do they enter into revenue sharing agreements? Do they securitize their blockspace? And so forth…there are countless comparisons to Commodity Trading and various forms of offtake agreements.

    • In DeFi, most of the trades and Validator Execution-Layer Revenues are driven by Institutional/HFT players. These traders need realtime precision and will pay handsomely for custom order execution - for example, guaranteeing inclusion into a specific block (called an Inclusion Preconf), guaranteeing a result or ‘state’ in a specific block (called an Execution Preconf), or the option to guarantee either of the above.

    • Custom order execution is not new - some of this is done already via private or OTC markets with Block Builders. Block Builders play an essential role in PBS but don’t ‘own’ the blockspace however, and so they are limited in their capacity to offer and support certain guarantees.

    With Validators now able to structure markets as they choose and delegate this accordingly, gas markets will not only increase the choices that gas buyers have, it will dramatically increase the fees that Validators earn triggering a paradigm shift for both blockchains and onchain actors in general.

    Note that the terms Validator and Proposer may be used interchangeably.

    Security

    Our collateral contract (EthgasPool) has been audited by Sigma Prime and Node Security, with our Commit Boost module has been audited by Sigma Prime.

    Link: https://github.com/ethgas-developer/ethgas-audit

    Developer Resources

    Traders

    As a superset of Commitment Buyers, traders may submit their private orderflow via API. Such orderflow will only be emitted at expiration of a Slot and only to the appropriate Builder/Sequencer at such point in time:

    • API: developers.ethgas.com

    Execution Preconfirmations

    Coming est. 2nd half of 2025

    Execution Preconfirmations (or Execution Preconfs) are Inclusion Preconfs but with a guarantee by the Proposer of a specific state or result. Bids are for specific Trades or Bundles, requiring both a certain amount of Blockspace.

    Execution guarantees come in many forms - reach out to us at: [email protected], or on Twitter/X, to discuss some of the specific types of guarantees that would best suit your needs

    Execution Preconfs are only for the current slot. More details coming shortly.

    For Validators & Staking Operators

    Earn More While Powering a Realtime Ethereum

    Standard staking rewards and unpredictable MEV are no longer the ceiling for your yield. There is a new, superior revenue stream available—one that is more predictable and directly tied to the economic activity you enable. It's time to evolve beyond simple block building.

    The Solution: Become a Realtime Ethereum Provider By integrating with ETHGas, you transform your validation infrastructure into a premium service provider for the entire on-chain economy.

    • Superior, Predictable Yield: Sell your blockspace as a programmable, high-value asset on our platform. This creates a consistent, diversified revenue stream that complements and exceeds traditional rewards.

    • Power the Future: You become the backbone of Realtime Ethereum, providing the guaranteed, priority blockspace that high-value traders and protocols demand.

    • Simple & Secure: Our infrastructure is designed for seamless integration, allowing you to access this new market without compromising on security or operational stability.

    Your staked ETH is underperforming. Learn how to integrate with ETHGas' Commit Boost module and start earning the yield you deserve:

    The ETHGas Architecture

    ETHGas is an out-of-protocol initiative that broadly intermediates Validators (called Proposers) alongside their Gas Market Products with Buyers of blockspace (Builders, Traders, Searchers, Wallets, End-Users, and more) looking for custom order flow types.

    Inclusion Preconf & Whole Block Flow

    Inclusion Preconfirmations

    Inclusion Preconfirmations (or Inclusion Preconfs) are commitments whereby the Proposer guarantees to include your transactions within a specific block N. Bids are for a fixed amount of blockspace (e.g. 200k gas units), may be included anywhere in the block, and do not carry any reversion guarantees.

    Inclusion Preconf markets are created only when a Validator/Proposer has performed an initial, primary market sale of the Preconfs into the market. That is, it is not possible to ‘short’ an Inclusion Preconf.

    Transaction Fees: [ 5% ] on Initial Sale, [ 30 ] bps on secondary market trading TBC

    For Traders & Market Makers

    A New Liquid Asset Class. Trade the Fabric of Ethereum.

    For years, blockspace has been an opaque, inefficient, and inaccessible asset. We've changed that. We've transformed raw blockspace into a suite of standardized, liquid, and tradable products, creating the first true marketplace for on-chain execution.

    The Solution: The Blockspace Trading Platform Our platform gives you the tools to trade the core components of Ethereum itself, unlocking unprecedented opportunities for alpha generation and risk management.

    • Precision Execution: Purchase Inclusion Guarantees to secure top-of-block placement with absolute certainty. This is the ultimate edge for latency-sensitive strategies.

    • Hedge Volatility: Use our upcoming Base Fee Futures to hedge against gas price volatility, turning an unpredictable cost into a manageable variable.

    For Protocols & dApps

    Build Stickier Products. Let Your Users Forget About Gas.

    The single greatest point of friction in Web3 is the gas fee. It’s a constant source of anxiety, confusion, and abandoned carts. What if you could eliminate it completely and turn your biggest cost center into your most powerful marketing engine?

    The Solution: The Gas Abstraction Initiative Our Gasless User Layer is a revolutionary, zero-code solution that lets you sponsor gas fees for your community through a simple rebates program.

    • Eliminate Friction: Onboard new users with a seamless, Web2-like experience. No more confusing pop-ups or failed transactions.

    • Boost Retention: Reward your most loyal users. By subsidizing their gas, you build a powerful moat and a thriving, engaged ecosystem.

    Our Technology

    The Engine of a Realtime Ethereum

    ETHGas is proud to introduce real time blockspace commitments, enabling Ethereum to guarantee settlement as fast as 3ms, and as frequently as 100k per second (subject to blockspace limitations).

    Blockspace Commitments is a broad term describing a suite of products that provide more customization around how and when users get their orders executed. Do you want your order guaranteed to be included in this slot? Do you want it to come with a specific result or state?

    While these commitments give end-users more choice, it can also result in higher fees for the validators that provide such an array of options. As a validator, do you prefer to build vanilla blocks? Do you opt-in to MEV-Boost? Would you want to offer a broader product suite, and as a result, earn higher fees?

    ETHGas is compatible with the existing PBS / block construction process making it easy to integrate with existing infrastructure and systems.

    We envision a future where end-users can insulate themselves against gas price volatility, where they can get real time / instant settlements (vs waiting 12 secs) - basically getting what they want, when they want it. Over time, we'll enable Protocols, Wallets and their end-users to store gas, remove the concept of gas altogether, and much, much more.

    Real time Gas Markets enable Ethereum and its based Rollups to hyperscale providing an experience that is as fast as it’s CeFi counterpart, but decentralized and privacy centric. LFG 🚀🚀🚀


    For Retail Users

    Turn Your Gas Fees into Rewards.

    Every swap, mint, and transaction comes with a gas fee. It feels like paying a constant toll on the crypto highway. What if you could get that money back? What if you got rewarded for being active on-chain?

    The Solution: The ETHGas Rebates Program We're flipping the script on gas fees. Through our partnerships with the protocols and dApps you love, your costs are now your rewards.

    • Get Your Gas Back: Think of it like cashback for your on-chain life. When you transact on any partner protocol, you're earning rebates. We handle all the tracking, and you can claim your accumulated rewards in a single, easy transaction.

    • Meet Gassy Jack & Earn Beans: It’s not just about rebates; it’s about being part of the mission! Join our gamified points program, complete fun quests with our mascot Gassy Jack, and collect beans for your activity.

    Whole Block Commitments

    A Whole Block purchased in the primary market reserves the entire block, ~ 36mm gas units (remark: gas limit can be dynamically adjusted by validators), for the buyer. Buyers may decide to strip apart and sell a mix of Inclusion Preconfirmations or Execution Guarantees. At such point, the Whole Block instrument now comprises a mix of other commitments whereupon subsequent secondary market sales of the Whole Block will be defined to be contingent upon including those other commitments.

    Sequencing Rights are also conferred to the Block Buyer making a whole block buyer a synthetic Block Builder as articulated in . Should a block buyer looking to retain key positions/guarantees in a block be unable to , they may include their own Execution Guarantees or Inclusion Preconfirmations, and either:

    • Not sequence the Block, following which ETHGas will be the fallback Builder,

    Overview

    ETHGas is a marketplace to source and trade blockspace commitments, alongside the Base Fee itself. It operates as a hybrid exchange - a centralized venue, where the central limit orderbook (CLOB) matches buyers with sellers, alongside a non-custodial smart contract where the collateral is held to backstop validator commitments. ETHGas is a neutral party offering end-to-end privacy.

    Blockspace commitments come in three forms

    1. where the buyer has the exclusive right to sequence and include any valid transactions up until ~36mm gas units. The buyer has the option to subdivide and sell a combination of Inclusion Preconfirmations or Execution Guarantees (coming soon). The buyer can also reserve the Top or Bottom of the block for themselves whilst selling off the rest of the block. The Whole block market open at most 64 slots in advance.

    2. (or Inclusion Guarantees) where trades are guaranteed to be included in a block up to a specific maximum number of gas units. Validators ‘create’ Inclusion Preconf markets by providing an initial sale. From then on, secondary trading of such instruments may occur between various parties. Inclusion preconf market opens 32 slots in advance.

    Relays

    The ETHGas Relay

    Relays serves as a trusted intermediary between validators and builders. In the standard PBS flow, builders constantly submit blocks to the Relay. Validators then retrieve the most profitable block header without the body from the Relay and then submit the signed header back to the Relay in return for the release of the block body containing the transactions.

    ETHGas' preconf flow is quite similar to the PBS flow, with the addition that the Relay may perform an extra set of checks on blocks submitted by the builders to ensure all preconf transactions of the specific slot are included. Validators have to connect to our relay or other authorized Relays to receive the block headers, otherwise Validators may end up signing a header without honoring all preconf commitments thus resulting in slashing.

    Currently, our relay runs within an Optimistic Mode, that enables blocks to propagate without simulation.

    Our relay is currently based on the developed by Flashbots.

    Check the for relay URLs in different regions.

    Other Authorized Relays

    Technical Integration

    We are already live on Mainnet and users can also test on Hoodi environment.

    Exchange Specifications:

    • TPS: 100k TPS

    • Latency: 3-5ms latency, depending on colo or direct EC2

    • Location: AWS - Asia Pacific (Tokyo) / ap-northeast-1

    Collateral Contract (EthgasPool)

  • Capital Efficiency: Trade a new, liquid asset class that is deeply correlated with on-chain activity, opening up a world of sophisticated arbitrage and hedging strategies against the broader market.

  • The future of on-chain trading is here. Access the Blockspace Trading platform and gain your critical edge:

    • ETHGas Trading is currently available on Mainnet and for testing on the Hoodi network.

    • Monitor the markets in our Testnet App UI (Read Only): https://app.ethgas.com/

    • Testing is only available via API – view our support docs and developer docs to get started

    Drive Growth: Use gas rebates as a powerful user acquisition tool. Run campaigns to attract new users and watch your key metrics soar.

    Ready to build a loyal community? Explore the Open Gas Initiative and learn how to set up your first rebate campaign in minutes.

    • Learn more about our Open Gas Initiative: https://www.ethgas.com/open-gas/

    • Design & estimate your protocol rebates directly: https://www.ethgas.com/open-gas/design-rebates/

    • Join the Open Gas partner program & submit your enquiry: https://docs.google.com/forms/d/e/1FAIpQLSftEvhkn8_9l5F9wENCpDgXCf_565SlrCimSVUY-FFjFvqL6A/viewform

    Quick Start:

    • For Researchers: The Design Process

    • For All Users: Product Specs

    • For Traders: Visit the API integration docs & Developer Docs on: developers.ethgas.com

    • For Validators: Visit our Validator integration docs

  • Beans Unlock Rewards: Every bean you earn is a direct path to our future rewards. By participating, you're not just saving money—you're building ownership in the future of Ethereum.

  • Ready to join the adventure? Help Gassy Jack Plant the First Bean! Connect your X account, complete your first quest, and start your journey toward a Gasless Future today: https://www.ethgas.com/community/overview/

    https://docs.ethgas.com/actors-and-integrations/validators
  • Execution Preconfirmations (or Execution Guarantees, coming soon!) where trades are additionally guaranteed to have a specific state or result attached to them. These markets are structured as a progressive auction. While we have looked at other auction mechanics (e.g. VCG and other forms of GSP) further research is warranted to optimize this for both parties accordingly.

  • Base Fee Markets: (coming shortly)

    Block Building: By the 2 second mark before the start of the slot (subject to Validator Timing Adjustment), each Buyer is required to have submitted their trades to be included alongside their Preconfirmations, at which point the Builder will request to get a list of Preconf transactions.

    Whole block owners have the ability to:

    • Build the block themselves as indicated above, or

    • Delegate the rest of the block to a specific builder, or

    • Auction off the block to a selection of all builders

    The Block Builders will then construct and optimize any remaining portions of the block accordingly including, amongst others, private transactions and public mempool trades accordingly. These Blocks will then propagate via the ETHGas Relay and onto the Proposer accordingly.

    Sharing Orderflow with ETHGas or Sending Directly to the Builder: Block Owners and Traders are not required to share orderflow with ETHGas and may elect to share transactions directly with the Block Builder instead to minimize latency. Note that any trades shared directly to the builder (and not to ETHGas) will not be covered under any Guarantee compensation should those trades not ultimately be placed in the block.

    See more details in the Inclusion Preconf Flow in the Architecture section

    Whole Block
    Inclusion Preconfirmations
    Validators must source blocks only from the ETHGas relay as it is the only relay equipped to verify the blockspace commitments. ETHGas is in discussions with other Relays, however, to stream the commitments and assist with block propagation. More on this soon.
    mev-boost-relay
    Technical Integration
    Sell the Block, or
  • Delegate the Sequencing to a specific Builder

  • Market Details:

    • Transaction Fees: [ 5% ] on Primary sale, [ 30 ]bps on secondary market trading TBC

    The Design Process
    Sequence a block accordingly

    Mainnet : 0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3

  • Hoodi: 0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1

  • Recommend to deposit collateral via our website

  • Relays:

    Region
    Mainnet
    Hoodi

    Tokyo

    Frankfurt

    Virginia

    Docs & Source code

    API docs: developers.ethgas.com

    Validator Registration & Setting (Commit Boost Module): https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module

    Modified rbuilder: https://github.com/ethgas-developer/preconf-builder

    Builder Registration: https://github.com/ethgas-developer/ethgas-builder-scripts

    Builders & Sequencers

    Block Building Package

    To simplify the integration process for builders to support and fulfill the proposer’s commitments, we will provide a modified version of rbuilder, a blazingly fast MEV-Boost Rust-based block builder developed by Flashbots. Our changes will achieve 3 goals:

    • Stream the latest preconf transactions from the ETHGas exchange

    • Build a block that includes all preconf transactions of a specific slot

    • Ensure the correct positions of the top and bottom bundles submitted by the whole block buyers

    • Fill up the block with transactions from the mempool if the gas used is below the block gas limit and the block buyers haven't set the remaining blockspace as empty

    Modified rbuilder:

    Builder Registration:


    Who Builds the Blocks?

    Traders that are Whole Block owners may choose to i) Build/Sequence the block themselves, ii) delegate this to someone else: Specialist Builders, or the Fallback Builder, iii) auction off the block, or iv) they may also elect for the Block to include no trades.

    Self Building: Whole Block Owners as Sequencer/Builders

    Traders who own the whole block are entitled to sequencing rights, conditional upon including the previously confirmed constraints/commitments. Before the start of the slot (T < 0 sec), traders build the block including their trades, and sequencing all the trades accordingly. They then send the block via our Relay upon which it then follows the standard PBS flow.

    Delegated Building

    Unlike Self Building above, where the Block Owner is also the Builder, traders may elect to delegate the building to a 3rd party. This 3rd party may be either a Specialist Builder, or the Fallback Builder.

    Prior to both delegation , traders must submit their transactions via API (subject to the amount of blockspace they own) so that the Builders know which trades to include accordingly.

    Specialist Builders

    Traders may delegate Building to a 3rd party Specialist or Dedicated Builder. Specialist Builders may or may not pass on priority fees or any other economics back to the Trader. This is at the Specialist Builder's discretion. Traders should negotiate with the 3rd party Builders about the fee distribution via other channels. [ More details shortly ]

    Fallback Builder - ETHGas

    ETHGas will perform the role as a Fallback Builder and sequence the block accordingly when:

    • The Block has not been Self Built, or

    • The Block has not been delegated to a 3rd party Specialist Builder, or

    • The Block built by the Builder does not conform to the commitment requirements,

    Any priority fees from trades included in the block will pass back to the Block owner. More on the fallback sequencing algorithm in due course.

    Auctioned Building

    In most cases, the Block Owner will auction off the block to an array of builders each of which will compete to place their trades in the block. The builder whose blocks have the highest fee paid to the Block Owner will then be available via our Relay for proposing. This process is not too dissimilar from the MEV-Boost auction mechanic, however, instead of paying the Validator the Builder pays the Block Owner who had already purchased the block from the Validator.

    Empty Block

    The Fallback Builder flow assumes that Traders will always want a block to be built with any residual value (i.e. remaining Tips/Priority fees from mempool transactions) being passed back to the Trader. There may be cases, albeit rare, where the Trader has sold no commitments and elects for no trades to be included. In these cases, traders must send an API request to this effect so that an empty block will be submitted to the relay and then proposed by the validators. There is a caveat that a completely empty block cannot be proposed by the validators so a 0-value self transfer transaction will be included in an empty block.

    Commitment Buyers

    Buyers, that is, Traders, Searchers, Wallets, Protocols, and other End-Users of blockspace products directly submit Bids via API to the ETHGas exchange. See our API Docs.

    Validators (called Proposers) are recommended, although not required, to post 1 ETH of collateral for an entire block, though they can post whatever amount they prefer. In the event the Proposers do not include certain commitments in their block, this triggers a ‘default’ upon which their collateral will be slashed accordingly. The proceeds from slashing will then be distributed to Commitment buyers proportionate to the size of the commitment. More details can be found in Collateral & Slashing.

    To further help Buyers assess counterparty risk, we have assigned a Counterparty risk metric denoted CTPY which is a function of the Percent of all the previous commitments honored. [ More, soon ]

    While Whole Blocks and potentially Execution Guarantees & Consecutive Blocks (in the future) inherently carry more counterparty risk than Inclusion Guarantees per unit of gas, we feel it is not warranted to institute a dynamic collateral or margining mechanic for fear of overcomplication. We may explore this in the future to the extent it is relevant.

    Buyers could purchase whole blocks up to 64 slots in advance but they can only buy preconf commitments up to 32 slots in advance.

    Timing & Execution of Preconfs

    Commitment Buyers submit a signed transaction object via API to the ETHGas Exchange. Following this, Builders may constantly fetch the list of preconf transactions from ETHGas, build the blocks and submit them through the relay accordingly. The timeline is as follows:

    • Whole Block and Preconf Markets close at T = - 4 secs where T = 0 sec is the start of the slot

    • Trades/Bundles to be submitted to the Exchange by T = - 2 secs

    • Block Owners / Builders must submit the block to our relay before T = 0 sec

    Bundle Types

    There are 3 types of bundle, i.e. single transaction bundle, basic bundle and mev bundle.

    • The first one is the bundle containing only one transaction. The second one is the bundle with multiple transactions and all their sender addresses are the same. The third one is the bundle with multiple transactions and at least 2 of their sender addresses are different.

    • The single transaction bundle and the basic bundle are at the same priority which means the block owner cannot kick away those bundle after those bundles are accepted by exchange. Normal users are welcomed to submit single transaction bundle and basic bundle but not mev bundle though they can still submit it without any guarantee because mev bundles can be kicked away by the block owner without any compensation or notification. If multiple normal users submit conflicting mev bundles, we follow the first come, first served principle.

    • Users can also set whether the remaining purchased but unfilled blockspace can be filled by the block owner/builder or not. This is a per-slot setting and the default value is that the unfilled blockspace can be filled by the block owner.

    Bundle Ordering

    Only last block owner can submit bundle with top or bottom order specified. If a block owner sell the block, the ordering of their submitted bundles will not be respected.

    Target Users

    • Inclusion Preconfs: Latency-based order flow, Intents/Exchanges with offchain order matching,

    • Execution Preconfs: Searchers, CEX/DEX Stat Arb, HFT

    • Whole Block: Market Makers, Searchers, Stat Arb

    API Integration Example

    1. get jwt via and

    2. get all active market info via or

    3. place order via or

    4. get order status via or

    More details can be found in .

    The Design Process

    The basis for our market construction and product design prioritizes maximizing Validator income taking into consideration (among others):

    • the feasibility / ability for what Validators could sell

    • the near-term roadmap for Ethereum L1

    • the customized orderflow that traders would desire

    • Making the gas markets accessible (and of interest) to as many players as possible

    At a micro level, we look to introduce as few new concepts or terms as needed while also limiting any possibility of fragmentation. The result is as follows…

    Whole Blocks

    In a risk-neutral environment, it is optimal to sell an entire block, and where possible, to sell consecutive blocks whenever sufficient market information has been factored into the price.

    Assuming perfect information, an entire block captures the most information and affords the buyer the most flexibility to insert and prioritize any combination of their own trades (alongside bundles including public mempool trades) into the block

    Secondary Markets & Standardization

    As a prerequisite for a marketplace, it is essential that we standardize as much as possible. While there may be many future variants and permutations, to the extent we can reduce these to as few types as possible, the easier it will be to establish a sufficient number of both buyers and sellers for a marketplace.

    Secondary markets are important for any asset or instrument with value. When you have a secondary market, the economic cost turns from the purchase price (i.e. absolute cost) to the carrying cost (i.e. relative cost). That is, if you buy an instrument at T=0, and sell at T = 1 sec, then the carrying cost is only the difference in price between those two periods (alongside the time-value of money to be pedantic).

    A Secondary market further enables price discovery answering the question of “what is the right price” for an instrument - the right answer of course being the ‘market price’ having digested (theoretically) all the available information to arrive at that specific level. Without price discovery, both the buyer and seller risk not maximizing their utility which invariably hurts both sides leading to deadweight loss.

    For these reasons, product standardization and a secondary market are important, if not critical for gas market products to be priced properly, and for the market as a whole to reach its full potential.

    Deconstruction of Whole Blocks

    A block is worth more than the sum of its parts.

    While entire blocks may have secondary markets, there are times of imperfect information (and/or imperfect execution, or irrational exuberance) whereby it would be optimal to deconstruct or decompose a block into its constituent parts. This is where product standardization comes into play again.

    In these scenarios, external parties value parts of the blockspace (for unknown reasons, e.g. private order flow) moreso than the holder of the current block. This then enables the original buyer the ability to strip down and sell off portions of the block thus decreasing their carrying cost or increasing the inherent value of the block accordingly.

    There are three possible scenarios from holding the whole block:

    Note that the following scenarios are not too dissimilar to what an integrated Block Builder faces today - they are easily able to buy the whole block when it makes sense, albeit with some uncertainty. This uncertainty ultimately results in a less-than-optimal value capture for the Proposer.

    Scenario 1: The Buyer composes the block however they like, potentially capturing value greater than the original purchase price.

    Scenario 2: The Buyer is unable to capture most of the value themselves. They meanwhile see strong demand for blockspace beyond their current capacity/knowledge and so they strip the block into it's constituent parts and sell them off accordingly.

    Scenario 3: The Buyer is very much unable to capture any of the value. While at a slight loss, they are still able however to salvage some value by decomposing it into an array of different blockspace products accordingly.

    Market Makers

    By standardizing or commoditizing products, creating secondary markets, and allowing for decomposition, we enable market participants outside of the typical PBS players to enter these markets, for example, Market Makers.

    Market Makers do not necessarily need to know how the PBS flow works, they only need to know that there are Four Products: Whole Blocks, Inclusion Guarantees, Execution Guarantees, and the public mempool, that they can simply rearrange and optimize for on an ongoing basis.

    This is quite similar in principle to Options market making. In a perfect world, one can trade Options (i.e. the singular instrument), or one can trade the Greeks (e.g. Vol, Delta, Theta, Gamma, etc...) for which Options can be decomposed into.


    As such, our Product Roadmap is designed to start with larger gas-market products (with greater potential value) and then strip these down only when necessary.

    Validators

    Support of L1 Validators is critical in building the marketplace and creating off-the-shelf product availability for buyers. As such, we have designed both the Marketplace and Product suite to align highly with their interests.

    ETHGas is designed to unambiguously earn more than running MEV Boost alone with both minimal risk and minimal technical integration required.

    Validators with staking enabled can enjoy certain % of trading revenue via our Staking Incentive Program (Details soon)

    To get started, Validators must use Commit Boost and transfer the appropriate Collateral.


    Commit Boost

    Commit Boost is a sidecar for proposers to create commitments. Validators need to run Commit Boost which uses a validator BLS key to sign messages signaling their intent to register on ETHGas exchange platform and delegate to more sophisticated parties (e.g. our Pricer server) to sell preconfs

    https://github.com/ethgas-developer/preconf-builder
    https://github.com/ethgas-developer/ethgas-builder-scripts

    For blob-carrying bundles, the block owner has the priority to fill up the blockspace up to the max blob limit. There is no guarantee to include the bundles with blobs submitted by the normal users

    submit bundle via POST /user/bundle/send

  • retrieve all your submitted bundles via GET /account/slot/bundles

  • POST /user/login
    POST /user/login/verify
    GET /p/inclusion-preconf/markets
    GET /p/wholeblock/markets
    POST /inclusion-preconf/order
    POST /wholeblock/order
    GET /user/inclusion-preconf/orders
    GET /user/wholeblock/orders
    API Docs
    https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@ap-relay.ethgas.com
    https://0xb20c3fe59db9c3655088839ef3d972878d182eb745afd8abb1dd2abf6c14f93cd5934ed4446a5fe1ba039e2bc0cf1011@hoodi-relay.ethgas.com
    https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@eu-relay.ethgas.com
    https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@us-relay.ethgas.com
    Gas Market Products

    Link: https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module

    different commit boost components

    Collateral & Slashing

    As long as the validator can successfully propose a block obtained from our relay, the validator is not subject to any slashing risk. We ensure all blocks obtained from our relay honoring all commitments sold from our exchange. If not, we as the platform will be slashed.

    What is Considered a Slashable Event?

    • missing a slot with commitments attached to it

    • not proposing blocks obtained from our relay

    Providing Collateral

    Validators are able to provide collateral by either:

    • Deposit ETH directly to our collateral smart contract on L1. Check the Technical Integration for details. Note that this collateral will not accrue Consensus/Execution layer rewards during such time, or

    • Collateral AVS - our Eigenlayer AVS that enables natively staked ETH to be provided as security. See the Collateral AVS page for further information.

    ETHGas Exchange also posts collateral as a liveness bond to insure against our platform going offline

    Collateral Amounts

    Proposers are recommended to post at least 1 ETH collateral per slot as collateral held against the non-delivery of commitments. There are two metrics used for collateral calculation purposes:

    • Trading Account Collateral

    • Collateral per Slot

    The Trading Account Collateral is the total possible amount of ETH that can be used as collateral. The Collateral per Slot is the total possible amount of ETH that can be used as collateral, per slot.

    For example, let's assume a Validator posts 10 ETH as Trading Account Collateral, and then determines the Collateral per Slot to be 1 ETH. This then exposes the Validator to a maximum loss of 1 ETH per slot for up to a maximum of 10 slots of blockspace. In the event the Validator has say 15 slots within the look-ahead, the Validator will only be allowed to sell up to 2/3rds of the blockspace (in any order) accordingly. Once that threshold has been reached, the Validator would need to top-up additional collateral.

    The Collateral per Slot will be broadcasted to the Buyers enabling them to price their counterparty risk accordingly. Higher collateral amounts will generally confer greater blockspace prices/rewards to Validators.

    We currently make no distinction between faults due to defaults on sequencing rights vs inclusion preconfirmations. That is, defaults of either type are weighted proportionate to the amount of blockspace utilized and not to the 'type' of preconfirmation sold.

    We expect to update this in due course with feedback from the community where perhaps the majority of the collateral will be held as reserve against Sequencing Rights defaults, and the minority held held against Inclusion Preconfs. This is still currently under review.

    While the 1 ETH number is arbitrary, we feel it provides an accessible/sufficient threshold to Buyers in the near-term, and yet is still accessible to most larger Validators for which will be the early adopters. As more information is gathered, both preconf buyers and the market in general will be able to better understand and price counterparty risk accordingly. As such, collateral requirements may change subject to market conditions and further research.

    Execution of Slashing Event

    The slashing happens when the block is finalized, i.e. 2 epochs after the block is proposed. The detailed steps are as follow

    1. Check if the slot is empty

    2. Get a full list of transactions of the block from the RPC

    3. Get all preconf bundles of that slot from our exchange API

    4. Check whether all preconf bundles are inside the full list of transactions of the block

    5. Check the records of get_header and submit_signed_header from our relay to determine whether the validator correctly gets the block

    Our backend will debit certain amount of collateral from validators and credit proportional amount of collateral to the affected preconf/whole block buyers internally in our database where the user balance can be queried from our API. Then, users can request withdrawal to get back the ETH collateral to their on-chain wallets.

    The total slashed amount of a validator in a slot = collateral per slot set by the validator * total gas limit of the missing preconf bundles / block gas limit

    Default Pricing Settings for Validators

    The Proposer must decide to sell either the Whole Block, Inclusion Preconfs or mix of Inclusion and Execution Preconfs in the future. The assumption is that Proposers will not take an active or dynamic approach to selling block space products however - and they will prefer a default setting which will automatically seek to maximize validator fees.

    • Default 1: As the Whole block is worth strictly more than any mix of the Inclusion and Execution Preconfs - the risk-neutral fee maximisation option is to sell the Whole Block provided there is sufficient information to price the block accordingly.

    Learn more about the Flow in the Architecture section

    Community

    Welcome to the Gasless Future!

    Welcome, adventurer! You’ve arrived at the Community Hub.

    Join Gassy Jack on a Mission to a Gasless Future

    Every great adventure has a story. This is ours.

    Who is Gassy Jack? He’s a friendly, mischievous donkey with a bit of a gas problem. In fact, we’re all Gassy Jack. We've all felt the pain of high gas fees while exploring the world of DeFi. Gassy Jack represents our collective struggle against a toxic, high-gas world.

    But now, the escape plan is in motion. We are embarking on a journey together, a chapter-based saga to leave the gassy world behind and build something better. This is more than just a campaign; it's our mission to create the #GaslessFuture.

    Your adventure begins now.

    Are you ready? #LFGGasless

    Beanstalk Bonanza - Social Quests & Referral Trapped in a world of toxic, high-gas air, Gassy Jack has a single mission: to escape. He finds a single, magical bean and understands that its growth is his only hope. He plants this first seed, and your initial action—onboard into the program and sharing the news—provides the first burst of light and air it needs to sprout.

    By joining this quest, you become a founding member of Gassy Jack's community, committed to helping him grow his escape route to a better, gas-less world. Every quest you complete and every friend you refer helps the beanstalk grow taller, stronger, and closer to freedom.

    Great Gas Reckoning - Gas Report The beanstalk has finally pierced the dense, gassy clouds. From this new height, Gassy Jack can see something he never could before: his entire journey laid out below. This is the moment of truth—The Great Gas Reckoning.

    To climb higher, he must first look back. He needs to understand the path he's taken and the energy he's spent. This report reveals his true on-chain identity—his Gassy Jack Grade—and shows him the protocols that cost him the most gas.

    This awareness is his power. By generating your own Gas ID, you join Gassy Jack in this moment of clarity. You are rewarded with Beans for this knowledge, and the most legendary adventurers among you will discover a pre-forged Fused Avatar, a badge of honor recognizing your historical significance.

    Sky-Castle Bounty: The Open Gas Initiative

    Leaving the toxic clouds far below, Gassy Jack steps onto the solid, shimmering grounds of the Sky-Castle. The climb is over; the alliance building begins.

    Inside the Great Hall, he is greeted by the "OG Partners"—the first legends who have already pledged to make gas fees a relic of the past. But the Hall is vast, and Jack sees Golden Thrones reserved for the next wave of champions. The Open Gas Initiative is the master key that unlocks the Sky-Castle’s treasury.

    Jack cannot issue these invitations alone. He needs his community to send out the ravens. Your mission is to take the Open Gas proclamation, broadcast it to the world, and summon your favorite protocols to claim their reserved spots at the castle. The more allies we gather, the more gas we eliminate. The more allies we gather, the more gas we eliminate, and the closer we can drive onchain adoption to onboard the next billion users.

    Chapter 4: Secret Chapter 🤫

    Community FAQ

    Got questions? We've got answers.

    General

    What is the Gasless Future initiative?

    The Gasless Future is more than a campaign—it's our shared mission. We believe DeFi should be accessible to everyone, without the pain and complexity of high gas fees.

    This initiative is our community's rally to make that vision a reality.

    Led by our mascot, Gassy Jack, this chapter-based adventure invites you to become a founding builder of the ETHGas ecosystem. By completing quests on his journey, you're not just earning Beans for future rewards; you are helping lay the groundwork for a world where transacting on-chain is simple and affordable.

    You are a pioneer on the quest to build the #GaslessFuture.

    Who is Gassy Jack?

    Gassy Jack is our friendly donkey mascot! He represents all of us DeFi users who have felt the pain of high gas fees. His journey to escape the toxic, high-gas world is our journey.

    What is the goal of this initiative?

    The goal is twofold:

    • To find and reward the founding members of the ETHGas community (that's you!).

    • To collectively build a "Gasless Future" by launching the core community products that will power the ETHGas ecosystem.

    Onboarding

    How do I join the Gassy Jack adventure and start earning Beans?

    Simple! Visit our onboarding page at

    • Step 1: Connect your X (Twitter) account. This is how we'll verify your participation and track your rewards on the mission to a gasless future.

    • Step 2: Authorize ETHGas Official. We will never post without your permission.

    What if I join late? Can I still participate?

    Absolutely! New adventurers can join at any time. While some quests in earlier chapters might close, you can always complete the active chapter's quests and get ready for what's next. The best time to start is always NOW!

    Beans & Quests

    What are "Beans" and how do I earn them?

    Beans are the magical seeds of the #GaslessFuture! Think of them as the official points of the community program. You earn them by completing quests—each quest you finish provides the "nutrients" Gassy Jack needs to grow his beanstalk and escape the toxic, high-gas world. They are proof of your contribution to building our new world.

    Okay, so what are Beans for?

    The Beans you collect are your stake in the adventure's outcome! They are a direct measure of your contribution to the ETHGas community. The more Beans you collect by the end of Gassy Jack's journey, the larger your future reward allocation will be. So, more Beans = bigger reward. Simple as that!

    Why do some quests give more Beans than others?

    Just like growing a real beanstalk, some actions provide a bigger growth spurt! Simple social quests are like watering the plant, keeping it healthy. But bringing new allies into the community through referrals is like adding powerful, magical nutrients to the soil—it strengthens the stalk immensely. That's why referral quests, which are vital for our collective mission, award the most Beans in Chapter 1. As for Chapter 2, you uncover your gas legacy and reveal your historical gas spend, as a token of appreciation to thank our users for their contribution to the Ethereum ecosystem, we reward a significant amount of Bonus Beans based on their onchain activities.

    I followed ETHGas on X / joined Discord / Telegram, but didn't get my Beans. What happened?

    Great question! The social quests are a two-step mission:

    1. Action: First, you complete the action (e.g., follow on X, join our Discord/Telegram).

    2. Verification: Then, you must return to the quest on your Dashboard and follow the quest verification instructions

    I see a Leaderboard. How does that work?

    The Leaderboard is where legends are made! It’s the official ranking of the top climbers in the Gassy Jack saga, showing who is leading the charge to the #GaslessFuture. But this isn't just about who has the most points; it's about who is contributing the most to our shared mission.

    Here’s exactly how the ranking is determined:

    1. Total Beans Reign Supreme: First and foremost, your rank is determined by your total number of Beans. This is the purest measure of your overall effort—every quest completed and every milestone reached helps you climb higher.

    How do I complete the "Subscribe to ETHGas Newsletter" quest?

    Subscribing is the best way to get alpha on new features, partner announcements, and future quests.

    Completing the quest is a quick two-step process:

    Step 1: Submit Your Email On the quest modal, enter your best email address in the field provided and hit 'Submit'.

    Step 2: Confirm Your Subscription (The Important Part!) Now, head over to your email inbox. You need to find the confirmation email to make it official!

    Wallet Connection

    What is a "Primary Wallet" and why is it so important for my quest?

    Think of your Primary Wallet as your master key for the entire Gassy Jack adventure! 🔑 While your X account got you into the mission, your Primary Wallet is what links you to all future rewards.

    You must connect it to:

    • Unlock New Social Quests: Instantly get access to new social quests to earn more Beans.

    Is it safe to link my wallet? Will it cost me any gas?

    Your security is our top priority. Linking your Primary Wallet is 100% safe and completely gas-free!

    You are simply signing a gasless message (like a digital handshake) to prove you own the wallet. This action does not grant us any permission to access your funds or make transactions. It's a free and secure way to link your on-chain identity to your Gassy Jack profile.

    What's the best way to link my primary wallet?

    Use a desktop browser with a wallet extension for reliability—it's the most consistent option for a smooth connection

    1. Open ETHGas in a desktop browser like Chrome or Firefox

    2. Use a browser extension such as MetaMask

    What if desktop isn't an option? Try these mobile alternatives.
    • Choose WalletConnect: Scan the QR code with a mobile wallet app for a stable bridge—useful for custom chain support without integration issues

    • MetaMask In-App Browser: Open ETHGas Community Dashboard () inside MetaMask's browser on your phone to handle notifications better

    Why should I link secondary wallets to my profile?
    • Linking extra wallets will allow you to aggregate your gas report stats (e.g. the total gas spend on your Gas ID) for a more complete picture

    • You will potentially earn more bonus beans with a higher total historical gas spend.

    Gas Report

    What is Chapter 2: The Great Gas Reckoning?

    The Great Gas Reckoning is the second phase of our mission to build a gasless future. Where Chapter 1 was about bringing your friends along, Chapter 2 is about awareness. It’s centered around a powerful new tool called the Gas ID, which helps you understand your personal on-chain history and rewards you for it.

    What is a Gas ID and how do I get mine?

    Your Gas ID is a personalized on-chain identity. It analyzes your wallet's history to create a report showing your total gas spend, transaction count, and your Gassy Jack Grade.

    To generate it:

    Step 1: Connect X on Gas Report

    Your journey begins in the "Gas Report" tab in your ETHGas Community. Connect X to access:

    Step 2: Assemble Your Wallets in the Gas Report Hub

    Now, HOLD UP! Before you click generate, look for the "Link a secondary wallet" option. This is the most important part of the mission! Add

    How is my Gassy Jack Grade determined?

    Your Gassy Jack Grade is a fun character that represents your historical on-chain activity on Ethereum! The more you've used Ethereum, the more experienced your Gassy Jack becomes.

    Think of it as a badge of honor for your time on-chain. Here’s the path your Jack can take:

    • 👶 Baby Jack: The newcomer, just starting their journey (Up to 0.05 ETH spent)

    How do I earn Beans in Chapter 2?

    Here’s how you can stack them:

    • Generate Your Gas ID: Earn 50 Beans instantly.

    • Share on X Quest: Complete the quest to share your Gas ID on X to earn 100 Beans.

    Does my recent wallet activity affect my Bonus Bean or gas report generation?

    Yes! The Great Gas Reckoning is about the current state of the Ethereum economy. To celebrate the users who are on the front lines today, your Historical Gas Spend Bonus Beans includes a Freshness Multiplier.

    Wallets with more recent on-chain activity receive a bonus multiplier on their Beans. It's our way of giving an extra reward to the active pioneers of the Ethereum ecosystem!

    Our gas report is tracking transactions since the Ethereum Beacon Chain launch (Dec 1, 2020) up until end of last month at report generation time.

    If your linked wallet has no activity up until end of last month, e.g. you are generating the report with a wallet in Oct 2025 that has no activity before Sep 30, 2025, you will see the "No Wallet Activity" error that prompts you to add other active wallets before proceeding to generate.

    How do I verify that I have completed the 'Share my Gas ID on X' quest?

    To successfully verify you have shared your Gas ID on X:

    1. Copy and paste the image of your Gas ID within your X post and

    2. Ensure that it contains your referral link too (e.g. “ethgas.com/community/gas-report?referral=...”)

    See reference screenshot below:

    What is the Fused Avatar and how do I get one?

    The Fused Avatar is a legendary, one-of-a-kind PFP, AI-generated by fusing your X profile picture with your Gassy Jack Grade accessory.

    This is not a reward you compete for; it's a badge of honor we have pre-selected for two groups:

    1. The Top 500 historical on-chain users in our community (after anti-sybil checks)

    I generated my report but didn't get a Fused Avatar. Why?

    The Fused Avatar was reserved for a pre-selected group of users based on a snapshot of historical on-chain data and ecosystem influence taken before the launch of Chapter 2.

    Don't worry if you weren't in the initial group! The Fused Avatar is just the first reward on ETHGas. Your continued participation, Bean collection, and community involvement will unlock future opportunities for exclusive rewards and status.

    I already generated my Gas Report but forgot to add all my wallets. Can I get more Bonus Beans?

    Yes! 🥳 We've heard you! For the month of October 2025, we're giving our early supporters a special chance to regenerate their Gas Report. Just add your other wallets and regenerate the report to get a more accurate picture of your gas history and claim any additional Bonus Beans you've earned!

    For a limited time until Oct 31 23:59 UTC, you can regenerate your Gas ID for more Bonus Beans (up to 4,000 Beans based on your aggregated historical gas spend across all your linked wallets): 1. Go to the Gas Report page 2. Click “Regenerate Report” 🔄 3. Add all your wallets 4. Claim your Bonus Beans 🫘

    Note: Your Bonus Beans amount is normally based on your first gas report generation. Only for Oct 2025, you will get one more chance to regenerate for more Bonus Beans.

    Starting November 1st, report generation will go back to its regular schedule:

    I regenerated my report. How do I see my updated Bonus Beans?

    Great question! Your new beans will appear in one of two ways:

    • If you haven't claimed your quest rewards yet: You'll see an "Unlocked Quest" notification with the updated Bonus Beans amount. Click on the notification to claim the Bonus Beans - follow ETHGas on X first if you haven't already.

    • If you've already claimed:

    What happens if I generate my first-ever report after Oct 2025? Will I still get Bonus Beans?

    Absolutely! The "Bonus Beans" reward is for generating your first Gas Report. So, if your first time is in November, you'll still get those beans. However, the special regeneration option is only for October, so you won't be able to regenerate your report in November to update your bean count.

    Open Gas

    What is Chapter 3: Sky-Castle Bounty?

    What is the Sky-Castle Bounty? The Sky-Castle Bounty is the third chapter of Gassy Jack’s saga. We have built the infrastructure to "vent" the gas burden, but now we need allies to flip the switch. In this chapter, your mission is to identify and recruit "OG Partners"—the top protocols where you’ve spent the most gas. We aren't just asking them to join; we are showing them the massive demand for a gasless future.

    Click here to learn more about Open Gas:

    What is my objective in this Chapter?

    You are acting as a community ambassador. Your goal is to complete the "Signal the Signal" Quest. By tagging your favorite protocols on X (formerly Twitter), you are publicly inviting them to adopt our zero-code rebate solution. You are telling them: "I spent gas on you—now help me earn it back."

    Why should I participate if I can't claim my gas rebates yet?
    1. Future Rewards: Completing these quests earns you beans toward the upcoming Chapter 4.

    2. Prioritization: The more noise we make for a specific protocol (e.g., Uniswap, Aave), the faster we can onboard them, meaning you get your rebates sooner.

    How do I complete the Quote-tweet quest?
    1. Connect X on the ETHGas Community Dashboard and locate the "Quote tweet Open Gas Thread on X" quest

    2. Click to quote-tweet the Open Gas announcement thread on X

    My quote tweet isn't verifying. What's wrong?

    Our verification bot looks for specific criteria. Please check the following:

    • Did you tag the Partner? The quest requires you to tag the specific protocol (e.g., @CurveFinance) in your text.

    • Did you use the right link? Ensure you pasted the URL of your Quote Tweet, not the URL of your profile or the original post. Try to remove the ending URL string that contains the

    Referral

    How does the referral system work?

    Once you onboard, you'll get a unique referral link on Dashboard page. When someone onboards using your link and completes the first step to connect X, your referral is considered successful.

    Where can I find my referral link or referral code?

    Once your onboard, go to Dashboard page at . You will see the referral section under your profile. Your referral link is unique to you and your referral code is the 7-character string after ?referral={referral_code}

    e.g. for my referral link: , the referral code is caridee

    We suggest you to share your referral link directly, so the referral code will be auto-populated and confirmed via the URL parameter for your potential referees.

    What happens when I refer more than 100 users?

    To reward our most dedicated beanstalk builders, we've supercharged the rewards for our top referrers. Once you successfully refer your first 100 users, a special bonus activates:

    • You will earn 2 Beans for every additional user you refer.

    • This bonus applies for up to 400 additional referrals (from user #101 to #500).

    What happens when I refer more than 500 users?

    Adventurers who bring in over 500 new members are true community legends! While there isn't an automatic bonus programmed at this milestone, the core team is keeping a close eye on our top referrers for special recognition and potential surprises. Your massive contribution to the #GaslessFuture will not go unnoticed!

    What do "indirect referrals" mean?

    An indirect referral is when someone you referred successfully refers someone else. For example: You refer Amy (that's a direct referral). Then, Amy refers Bob (that's an indirect referral for you). We track this to show you the full network effect of your influence! You earn 1 Bean per indirect referral, capped at max. 100 Beans.

    Technical & Support

    Encountered a Glitch? Try This First-Aid Checklist! 💊

    We've built the Gassy Jack adventure to be as seamless as possible, but in the fast-moving world of Web3, sometimes browsers and connections need a quick reset! Before reaching out for support, try these simple but powerful steps—they solve 90% of common issues.

    Step 1: Switch to Desktop 💻

    For the best and most stable experience, especially for wallet connections and quest verifications, we strongly recommend using a laptop or desktop computer. Mobile browsers can sometimes be unpredictable with pop-ups and wallet extension connections.

    Step 2: Clear Your Browser's Cache 🧹

    Your browser stores old data to load pages faster, but this can sometimes cause conflicts with new quests. Clearing your cache gives our platform a fresh start.

    Why isn't my "Share on X" quest validating?

    This is a common issue with a few easy checks! Our system needs a moment to verify your post. If it's not validating, please try these steps:

    1. Follow Quest Instructions: Ensure your post contains the referral link, e.g.

      1. for "Share your Referral Link on X", your post must contain your referral link e.g. ethgas.com/community/onboarding?referral=...

    My X account was suspended and I can't log in to ETHGas Community. What should I do?

    If your account has been suspended on X, we recommend to reach out to X directly to resolve the matter. We are unable to fix this issue on our side.

    We strongly recommend all users to join our community using an X account that refrains from activity that may result in suspension on X as this will impact your eligibility for future rewards

    Why isn't my referral being attributed?

    You may ask your friend (referee) to check their profile section on Dashboard page to see if there is a "Referred by @{referrer_X_handle}" tag.

    If you're sure a friend onboarded but you didn't get credit, it's usually due to one of a few common reasons. Let's run through the checklist:

    • Direct Link Not Used: The most common issue is that your friend didn't use your unique referral link to land on the page. They must start their journey through your link for the system to track it automatically.

    Where can I provide feedback?

    We're all about building this community together. Tell us what you love, what could be improved, or any wild ideas for future chapters (like social quests or referrals) at

    Where can I get help or report a problem?

    Our official Discord is the Community HQ! We have dedicated channels where our team and community mods are ready to help you out -

    • Discuss openly with the community and team in real-time 💬

    1. Jump into our Discord and head to

    Step 3: [Optional] Input your referral code and click [Confirm] to validate it. If you are using a referral link, the referral code will be auto-confirmed.

  • Step 4: Click [Continue]

  • Once you see the “You’re Onboarded!” screen, you're officially part of the mission and earned 10 Beans for onboarding!

  • For join Discord, go to the #🫛┃start-earning-beans channel and click [Start Verification] button

  • For join Telegram, go to the 👮Verification topic and click [Start Verification] button

  • This second step triggers our verification bots (like Fuul for X, or our custom bots for Discord/Telegram) to confirm you completed the mission. Once verified, your Beans will be awarded instantly! If you ever get stuck, make sure you've completed both steps.

    Tie-Breaker #1: Your Community Allies: What if you and another adventurer have the exact same number of Beans? The tie is broken by your total number of direct referrals. Why? Because bringing new allies to the mission is one of the most powerful ways to strengthen the beanstalk for everyone. This rewards true community leaders.

  • Tie-Breaker #2: The Pioneer's Advantage: In the rare case of a tie in both Beans and referrals, we honor the pioneers. The final tie-breaker is your onboarding time. The adventurer who joined the mission first gets the higher rank. It's our way of saluting the very first believers who saw the vision from the start.

  • So, the leaderboard rewards a powerful combination of effort (Beans), leadership (referrals), and vision (being early). Every single action matters on the climb to the top!

    📧 From: ETHGas ([email protected])
  • Subject: ETHGas Newsletter Subscription

  • Open that email and click the 'Confirm your email' button inside. This proves you're you and officially completes the quest!

    ✅ Quest Complete! Once you've confirmed, head back to the ETHGas Dashboard. Your quest will be marked as complete, and your well-earned beans will be added to your total.

    🤔 Can't find the email? No sweat! Be sure to check your Spam, Junk, or even Promotions folders. Sometimes our emails get a little lost on their way to you!

    Prepare for Future Chapters: This wallet will be used to check your eligibility for gas rebates and batch-claim the gas rebates for your other secondary wallets in chapter 3.

    Connecting it is the single most important step you can take after onboarding!

    Click "Link Primary Wallet" and follow prompts

    Note: Update your wallet to the latest version first to resolve common glitches

    Different Mobile Browsers:

    • For iOS, Safari works smoother than chrome

    • For Android, enable pop-ups and clear cache for improved compatibility

    You will potentially be eligible for more upcoming gas rebates
  • You can link up to 50 wallets to your profile

  • After linking a secondary wallet, you will NOT be able to unlink it from your profile or link it with another profile

  • ALL
    your other wallets to:
    • 📊 Aggregate your stats for a complete on-chain picture.

    • 🫘 Earn the maximum Bonus Beans from your full gas history.

    • 🎟️ Be eligible for upcoming gas rebates in Chapter 3.

    ℹ️ Your Bonus Beans is only based on your 1st report generation

    Step 3: Generate Your Gas ID & Meet Your Gassy Jack

    Once all your wallets are linked, smash that "All Set! Generate My Gas Report" button. This is the moment you'll discover your official Gassy Jack Grade and see if a legendary Fused Avatar was forged for you.

    Step 4: Share Your Gas ID & Complete the Quests

    Your on-chain history is a badge of honor. Now, complete the final quest: share your new Gas ID card on X. You'll not only earn 100 Beans but also help spread the word about the Great Gas Reckoning. Don't forget to follow ETHGas on X to earn 50 Beans and claim your Bonus Beans! (up to 4,000 Beans)

    🧒 Kiddo Jack: An explorer, learning the ropes (Up to 0.2 ETH spent)
  • 🧑‍🎤 Teen Jack: An active participant, braving the gassy clouds (Up to 1 ETH spent)

  • 🦸 Hero Jack: A seasoned veteran of the network (Up to 4 ETH spent)

  • ✨ Legendary Jack: A true on-chain legend! (More than 4 ETH spent)

  • 💫 Divine Jack: A celestial being who has transcended the gassy atmosphere. (More than 20 ETH spent)

  • 👑 Apex Jack: A true master, shaping the Ethereum ecosystem. (More than 50 ETH spent)

  • ♾️ Omni Jack: A foundational force of the on-chain world, one with the chain itself. (More than 100 ETH spent)

  • Heads Up! It's not just about the total ETH spent! Your grade also considers how recently you've been active on-chain. We want to celebrate the heroes who are part of Ethereum's story today!

    Referral Quests: Get your referred friends to generate their own Gas IDs to earn up to 200 Beans.

  • The Bonus Beans based on Historical Gas Spend: This is the big one! You can earn up to 4,000 Beans based on your aggregated historical gas spend across all your linked wallets. To claim this bonus, you must complete a verification step to confirm you are following @ETHGasOfficial on X.

  • Key influential voices across the Ethereum ecosystem.

    To see if a Fused Avatar is waiting for you, simply generate your Gas ID.

    one report per month
    .
    You'll see a claimed "Bonus Beans" notification with the additional Bonus Beans amount. Your new Bonus Beans will be automatically added to your total. You can see the update in
    Dashboard's
    "Claim Bonus Beans" quest that you have completed and the
    Beans History
    with the claimed amount updated accordingly.

    Note: Your Bonus Beans amount is normally based on your first gas report generation. Only for Oct 2025, you will get one more chance to regenerate for more Bonus Beans. You can earn up to 4,000 Beans based on your aggregated historical gas spend across all your linked wallets.

    Influence: You are helping build the "Gasless User Layer" by proving to protocols that users demand better gas economics.

    Tag your favourite protocols that should join the Open Gas before posting
  • Copy your quote-tweet link and paste it into the "Post URL" field to verify for quest completion

  • ?s=12
  • Is your account public? We cannot verify posts from private X accounts.

  • This allows you to earn a maximum of 800 extra Beans from this referral power-up!

    Your massive contribution to the #GaslessFuture will be directly rewarded!

    How: This process is slightly different for each browser (Chrome, Brave, Firefox), but you can usually find it under Settings > Privacy and Security > Clear Browsing Data. Make sure to select "Cached images and files."

    Step 3: The "Re-Auth" Refresh 🔄

    Sometimes, the connection between your X account and our platform just needs a quick refresh to sync up properly.

    • How: Navigate to your ETHGas Dashboard. Go to the navigation bar to disconnect your X account, and then immediately reconnect it. This simple action often resolves verification issues by establishing a fresh, secure link.

    If you've gone through this entire checklist and are still facing an issue, our mission support team is ready to help! Check out the Where can I get help or report a problem? FAQ

  • for "Share your Gas ID on X", your post must contain your referral link e.g. ethgas.com/community/gas-report?referral=...

    1. Enter the shared post URL: Click the bottom right share icon on your post and then click [Copy Link] to copy to clipboard, paste the link in the "Post URL" field to verify

    2. Check Privacy: Make sure your X (Twitter) profile is public and active. Our bot can't see posts from private nor banned accounts.

    3. Try Reposting: If it's still not working after a few minutes, delete the original post and try sharing it again from the quest dashboard. This usually resets the connection.

    Manual Code Not Confirmed: If your friend entered your referral code manually, they must click the "Confirm" button next to the input box before clicking [Continue].

  • Fair Play System: To keep the adventure fair for everyone, our system includes anti-Sybil measures. This means you cannot refer yourself, and any attempts to do so will not be attributed. We're all here to build a real community together!

  • If you've checked these points and believe there's still an error, please head to **#tickets channel under "SUPPORT"** on our Discord to open a ticket with you and your friend’s X handle.

    Describe the bug in the channel directly — we and the rest of the community are all ears👂

    • Create a private ticket for sensitive issues 🔒

    1. Jump into our Discord and head to #tickets channel under "SUPPORT"

    2. Click [General Support] button to open a private ticket.

    3. A private chat #ticket-XXXX under "INQUIRIES" will be created between you and our moderators.

      1. Tell us about the bug briefly and how we could reproduce your issue step-by-step. Feel free to share any screenshots as well.

    ⚠️ Please note that we will NEVER ask for your X password nor wallet private keys for debugging and we WILL NEVER DM YOU.

    General
    Onboarding
    Beans & Quests
    Wallet Connection
    Gas Report
    Open Gas
    Referral
    Technical & Support
    https://www.ethgas.com/community/onboarding/
    https://www.ethgas.com/community/dashboard/
    https://www.ethgas.com/community/gas-report/
    https://www.ethgas.com/open-gas/
    https://www.ethgas.com/community/dashboard/
    https://www.ethgas.com/community/onboarding?referral=caridee
    https://forms.gle/W71spAQ9cw5YWoti6
    #helpdesk channel under "LOUNGE"
    Connect X on Dashboard page to see your unique referral link