# Our Vision: Realtime Ethereum Building the Foundation for Modern Finance on Ethereum. Bringing realtime execution and institutional readiness to validators, traders, wallets, and agents on Ethereum. 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 infrastructure layer and foundational financial market for Ethereum's blockspace. We transform the chaotic, unpredictable auction for transaction inclusion into a structured, liquid, and tradable asset class. ETHGas serves everyone who touches Ethereum blockspace: * **Validators & Node Operators**: sell your blockspace forward and convert uncertain MEV into contracted, recurring revenue, with superior yields and none of the operational complexity. * **Institutions**: transact onchain with settlement certainty, fair ordering, compliance controls, and known, onshore validators. * **Traders & Searchers**: buy preconfirmations for guaranteed inclusion and trade blockspace as an asset. * **Protocols & dApps**: build on 100ms Realtime Blocks and give your users instant, reliable execution. * **Wallets & Order Flow:** reserve capacity and guarantee settlement for instant transactions and predictable gas. * **Agents:** settle agent-driven transactions in realtime with x402 agentic preconfirmations. * **Retail Users:** reclaim a share of the gas you spend through Open Gas rebates. ### **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. # What is ETHGas? ETHGas turns Ethereum blockspace into a tradable asset, then delivers superior yields, agentic execution, and institutional-grade blockspace on top of it. Sending a transaction on Ethereum today means unpredictable costs, uncertain wait times, and no control. It's the single biggest point of friction holding the onchain economy back. **ETHGas brings order to this chaos by turning blockspace into a tradable asset and building a faster, more certain economy on top of it to elevate Ethereum.** #### The foundation: the Blockspace & Preconf Marketplace 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. ETHGas turns that into a **premier logistics network**. Since November 2024, we've made blockspace tradable: buyers reserve guaranteed delivery in advance, and validators sell it as a premium, programmable asset. A **Blockspace Commitment** is your pre-paid, priority freight container on the very next flight out - delivered with precision, right when you need it, settling in **50–100ms**. It's a suite of guarantees you can choose from: * **Inclusion Preconfirmation (the priority boarding pass):** 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.** * **Execution Preconfirmation (verified delivery):** 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.** * **Whole Block Commitment (charter the whole plane):** 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. This marketplace is the foundation. Everything below is built on it. ### What we build on that foundation: three initiatives **1. Superior Yields for validators:** Validators sell their blockspace forward and convert uncertain MEV into contracted, recurring revenue - a superior, more predictable yield that goes beyond standard staking rewards, with none of the block-building complexity. **2. Agentic Execution for the autonomous economy:** Software agents need certainty and speed, not best-effort inclusion. ETHGas gives agents realtime settlement and, through **x402 agentic preconfirmations**, a payment-and-execution rail built for machine-speed activity. **3. Institutional Blockspace for regulated players:** Banks, asset managers, and treasuries get blockspace with settlement certainty, fair ordering, compliance controls, and known, onshore validators. Ethereum on terms their mandates can accept. #### **So, What Does This Mean for You?** The end of transaction uncertainty. Submit a swap or a bid and get near-instant confirmation. Validators earn more, agents transact at machine speed, institutions come onchain with confidence, and users get a seamless experience — all because blockspace is finally a real, liquid market. This is the foundation for a true Realtime Ethereum. # Our Three Initiatives The three outcomes ETHGas delivers on top of the Blockspace & Preconf Marketplace: superior yields, agentic execution, and institutional blockspace. Everything ETHGas does rests on one foundation: the [**Blockspace & Preconf Marketplace**](/overview/blockspace-and-preconf-marketplace), where Ethereum blockspace becomes a standardized, tradable asset. On top of that foundation we deliver three outcomes: **superior yields** for validators, **agentic execution** for the autonomous economy, and **institutional blockspace** for regulated players. Together they form a self-reinforcing flywheel. ### The foundation: Blockspace & Preconf Marketplace Since November 2024, ETHGas has made Ethereum blockspace tradable. We turn raw, chaotic blockspace into standardized products: inclusion preconfirmations, whole-block commitments, execution preconfirmations, and base-fee instruments and match buyers who need guaranteed execution with validators who supply it. ### Initiative 1: Superior Yields 💰 **For validators and staking operators.** Sell your blockspace forward and convert uncertain MEV into contracted, recurring revenue. Because demand for guaranteed and [**Realtime Execution** ](/overview/realtime)is priced ahead of time, validators earn a superior, more predictable yield that complements and exceeds standard staking rewards with none of the block-building complexity. * **Who it's for:** validators, node operators, staking providers, and everyone with staked ETH. * **Core message:** turn volatile MEV into contracted, recurring yield. ### Initiative 2: Agentic Execution 🤖 **For the autonomous economy.** Software agents transacting onchain need certainty and speed, not best-effort inclusion. ETHGas gives agents realtime settlement in **50–100ms** and, through [**x402 agentic preconfirmations**](/overview/x402-agentic-preconfirmations), a payment-and-execution rail built for machine-speed, high-frequency activity. * **Who it's for:** AI agents, automated strategies, and the protocols building agentic products. * **Core message:** settle agent-driven transactions in realtime, at machine speed. ### Initiative 3: Institutional Blockspace 🏛️ **For regulated institutions.** Banks, asset managers, and treasuries can't use Ethereum's opaque default pipeline. ETHGas delivers blockspace with settlement certainty, fair ordering, compliance controls (Policy Engine), and known, onshore validators - so institutions can transact onchain on terms their mandates accept. * **Who it's for:** banks, asset managers, custodians, and protocol treasuries. * **Core message:** compliant, credibly-neutral blockspace institutions can actually underwrite. ### The flywheel: how it reinforces itself 🔄 The marketplace makes blockspace tradable. **Superior yields** attract validators, which deepens blockspace supply. Deep supply makes **agentic execution** and **institutional blockspace** possible at scale and with reliability. Agents and institutions drive demand and volume back into the marketplace, which raises validator yields again, strengthening supply further. Each initiative amplifies the others; the marketplace is the axle they all turn on. # 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 🚀🚀🚀 *** Quick Start: * **For Researchers:** [The Design Process](/overview/our-technology/the-design-process) * **For All Users:** [Product Specs](/overview/blockspace-and-preconf-marketplace) * **For Traders:** [Visit the API integration docs](/get-started/commitment-buyers) & Developer Docs on: [developers.ethgas.com](https://developers.ethgas.com) * **For Validators:** [Visit our Validator integration docs](/get-started/node-operators) # 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. [Whole Block](/overview/blockspace-and-preconf-marketplace/whole-block-commitments) 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. [Inclusion Preconfirmations](/overview/blockspace-and-preconf-marketplace/inclusion-preconfirmations) (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. 3. [Execution Preconfirmations](/overview/blockspace-and-preconf-marketplace/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](/get-started/node-operators#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](/overview/our-technology/the-ethgas-architecture) section # 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.* # The ETHGas Architecture ETHGas is an out-of-protocol initiative that broadly intermediates Validators (called Proposers) alongside their [Gas Market Products](/overview/blockspace-and-preconf-marketplace) with Buyers of blockspace (Builders, Traders, Searchers, Wallets, End-Users, and more) looking for custom order flow types.
## Inclusion Preconf & Whole Block Flow
# 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 [Gas Market Products](/overview/blockspace-and-preconf-marketplace) 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.
# Blockspace & Preconf Marketplace ETHGas has four distinct blockspace 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 # 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 # Execution Preconfirmations Coming est. H2 2026
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. {% hint style="info" %} Execution guarantees come in many forms - reach out to us at: , or on Twitter/X, to discuss some of the specific types of guarantees that would best suit your needs {% endhint %} Execution Preconfs are only for the current slot. More details coming shortly. # 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 [The Design Process](/overview/our-technology/the-design-process). Should a block buyer looking to retain key positions/guarantees in a block be unable to [Sequence a block accordingly](/get-started/builders-and-sequencers), they may include their own Execution Guarantees or Inclusion Preconfirmations, and either: * Not sequence the Block, following which ETHGas will be the fallback Builder, * 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 # Base Fee Futures Est. H2 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 # Realtime Execution ETHGas Realtime Execution is the new block building sidecar that accelerates Ethereum's user experience up to 240x. This enables all users and dapps to benefit from preconfirmations or synthetic block times as fast as 50ms without compromising security guarantees. The Realtime Builder streams pre-confirmations, or preliminary state updates continuously before the next block is finalized providing a seamless user experience for all users and dapps, alongside an economic guarantee to support the broadcasted state. This is built for developers who need a blazingly fast UX from: * Payments: Instant payment confirmations * DeFi: Swap multiple times within a block with positions that update immediately * Marketplaces: Fast and Frictionless * Trading: Prevent frontrunning and delivery real-time price updates. {% embed url="" %} ## Background & How it Works Ethereum blocks are produced every 12 seconds and for years this had been taken as largely immutable. Every new L1 and L2 blockchain's key value proposition has been "we are faster" — and with ETHGas Realtime, that is no longer the case. ETHGas breaks these blocks into hundreds of intervals so instead of waiting for the full block time to execute all transactions, the execution client continuously creates and broadcasts the current state every 50-100 milliseconds. Each realtime block includes all transactions processed so far, along with updated balances and contract states. Apps can query this using the ETHGas realtime RPC or othe rfuture RPC providers that integrate us and deliver the speed their end users expect. ## How to Integrate Realtime Integration is straightforward, designed to be fast and low friction with most apps benefiting from minimal code changes. * In production, simply point your app to a Realtime-aware RPC endpoint from your provider of choice. If your provider doesn't support Realtime yet, let us know on Discord and we'll work to get them added, * Alternatively, you can run your own Realtime-aware node using ETHGas's reth image:
This architecture shows the flow of data and responsibilities in the Realtime block system with ETHGas integration: * The ethgas-reth node runs the execution layer and communicates with the Block Builder to produce realtime blocks * When a Validator has delegated their current slot to be sold via ETHGas, the ETHGas Exchange opens the Whole Block Market for the future slot to be sold * Traders, Builders, and Realtime Agents compete to purchase the exact slot and associated sequencing rights through the Whole Block Market (Let's assume that the Realtime Agents acquired the sequencing rights) * The Realtime Agent delegates the block building to the Realtime Block Builder * The Realtime Block Builder sends the block construction status in two directions simultaneously: * Preconfirmed Realtime Blocks: Directly to the WebSocket Proxy for ultra-fast propagation of Realtime block state and preconfirmations * L1 Block: At the end of the slot, the Block Builder submits the block to the Relay, and onto the Validator for block proposal (i.e. the standard PBS path). * The WebSocket Proxy distributes the realtime block states and preconfirmation data to multiple RPC Providers * RPC Providers instantly deliver realtime preconfirmations and realtime state data to End Users, enabling sub-100ms execution guarantees # Supported Realtime RPC Methods Advanced users can interact with the [real-time builder endpoint](/overview/realtime/builder-rpc-private-orderflow) if do not want the transaction to appear in the public mempool. | Network | URL | Websocket | | ------- | --------------------------------------- | ---------------------------------------- | | Mainnet | | | | Hoodi | | | All modifications done to the existing Ethereum JSON RPC methods are confined to overloading the existing `pending` tag except a few JSON RPC methods which become inherently aware of the preconfirmation state. Originally, this tag was designed to return block data being processed by the node's internal miner It's fitting that we now use it for a similar purpose: exposing blocks in their preconfirmation stage. When queried with the pending tag, the endpoint uses the preconfirmation state to construct the response. The response might include not only transactions but also block metadata like state root and receipt root. The tag is currently in a soft-deprecated state due to inconsistent implementations across clients, particularly after The Merge. However, it's worth noting that it's still actively used for certain endpoints, particularly `eth_getTransactionCount` where it serves the important function of returning the next available nonce for an account (including transactions in the mempool). This presents an opportunity: the tag is well-defined enough to be supported by client libraries, yet loosely defined enough to allow for our preconfirmation use case. While there's a possibility of the tag being removed in the future (see [EIP discussions](https://github.com/ethereum/execution-apis/issues/495)), the design could adapt by introducing a realtime block specific tag if needed. We repurpose the pending tag in the following RPC calls to enable consuming preconfirmed state: * `eth_call` * `eth_estimateGas` * `eth_getBlockByNumber` * `eth_getBalance` * `eth_getTransactionCount` * `eth_subscribe` {% hint style="info" %} **Not all RPC methods explicitly require a "pending" tag to tap into the real time state's awareness.** {% endhint %} The following RPC methods implicitly incorporate realtime block awareness like that whenever possible: * `eth_getTransactionReceipt` * `eth_getTransactionByHash` *** ### **eth\_getTransactionReceipt** {% tabs %} {% tab title="Request" %} ```json { "method": "eth_getTransactionReceipt", "params": ["0x..."], // Transaction hash "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json { "transactionHash": "0x...", "blockHash": "0x0", // Empty hash as placeholder "blockNumber": "0x...", // Current pending block number "transactionIndex": "0x0", "from": "0x...", "to": "0x...", "gasUsed": "0x...", "status": "0x1", "cumulativeGasUsed": "0x...", "effectiveGasPrice": "0x...", "contractAddress": "0x...", // For contract creations "logs": [], "logsBloom": "0x..." } ``` {% endtab %} {% endtabs %} When queried, this endpoint first checks the preconfirmation state for the requested transaction hash before falling back to the standard chain lookup. Some fields in the response cannot be final at the preconfirmation stage and require placeholder values: * `blockHash`: Uses empty hash as placeholder * `blockNumber`: Can be set to the current block number being processed *** ### **eth\_getTransactionByHash** {% tabs %} {% tab title="Request" %} ```json { "method": "eth_getTransactionByHash", "params": ["0x..."], // Transaction hash of the potentially pre-confirmed transaction "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json { "id": 1, "result": { "blockHash": "0x...", "blockNumber": "0x...", "hash": "0x...", "transactionIndex": "0x0", "type": "0x2", "nonce": "0x...", "from": "0x...", "to": "0x...", "gas": "0x...", "value": "0x...", "gasPrice": "0x...", "chainId": "0x..." }, "jsonrpc": "2.0" } ``` {% endtab %} {% endtabs %} When queried, this endpoint first checks the preconfirmation state for the requested transaction hash before falling back to the standard chain state lookup. Some fields in the response cannot be final at the preconfirmation stage and require placeholder values: * `blockHash`: Uses the block hash of the pending blocks at the time the transaction was preconfirmed * `blockNumber`: Can be set to the curent block number being processed *** ### **eth\_getBlockByNumber** {% tabs %} {% tab title="Request" %} ```json { "method": "eth_getBlockByNumber", "params": ["pending", false], // Second parameter indicates full transaction objects (true) or only hashes (false) "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json { "hash": "0x0", // Empty hash as placeholder "parentHash": "0x...", "stateRoot": "0x...", "transactionsRoot": "0x...", "receiptsRoot": "0x...", "number": "0x...", // Current pending block number "gasUsed": "0x...", "gasLimit": "0x...", "timestamp": "0x...", "extraData": "0x...", "mixHash": "0x...", "nonce": "0x...", // // Used to signal realtime block index "transactions": [] // Array of transaction hashes or full transaction objects } ``` {% endtab %} {% endtabs %} The endpoing implements an append-only pattern - multiple queries during the same block's preconfirmation phase will show an expanding list of transactions as new realtime blocks are processed. Each query reflects the current state of all preconfirmed transactions at that moment. *** ### **eth\_getBalance** {% tabs %} {% tab title="Request" %} ```json { "method": "eth_getBalance", "params": ["0x...", "pending"], // Account address and block parameter "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json "0x..." // Balance in wei ``` {% endtab %} {% endtabs %} When queried with the `pending` tag, the endpoint uses the preconfirmation state to return the account balance. If the requested account appears in the AccountMetadata of a received realtime block with a non-null balance field, the RPC provider can directly return this value without needing toa ccess the full state. The response reflects all changes from preconfirmed transactions that affect the requested account's balance. *** ### **eth\_call** {% tabs %} {% tab title="Request" %} ```json { "method": "eth_call", "params": [{"to": "0x...", "data": "0x..."}, "pending"], // Transaction call object and block parameter "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json "0x..." // Return data from the call ``` {% endtab %} {% endtabs %} When queried with the `pending` tag, the endpoint uses the preconfirmation state to return the call result. For this endpoint to work, the preconfirmation stream needs to include state differences for both accounts and storage after each realtime block. Similar to current override functionality in `eth_call` where EVM transitions are executed on top of modified state, this implementation executes the call on top of the preconfirmation state changes. *** ### eth\_estimateGas Generates and returns an estimate of how much gas is necessary to allow the transaction to complete considering the latest pre-confirmed state. {% tabs %} {% tab title="Request" %} ```json { "jsonrpc": "2.0", "method": "eth_estimateGas", "params": [{"from":"0x...","to":"0x...","value":"0x..."}, "pending"], "id": 1 } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": "1", "result": "0x..." // The estimated amount of gas required for the transaction, as a hexadecimal string. } ``` {% endtab %} {% endtabs %} *** ### eth\_getTransactionCount {% tabs %} {% tab title="Request" %} ```json { "method": "eth_getTransactionCount", "params": ["0x...", "pending"],// Account address and block parameter "id": 1, "jsonrpc": "2.0" } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": "1", "result": "0x..."// Nonce value as a hex string } ``` {% endtab %} {% endtabs %} When queried with the `pending` tag, the endpoint returns the transaction count (nonce) of the account from the preconfirmation state. If the requested account appears in the AccountMetadata of a received realtime block, the RPC provider can directly use the nonce field without additional state access. *** ### eth\_subscribe - newFlashblocks Subscribe to receive notifications each time a new flashblock is processed. #### Description Fires a notification with the current pending block state whenever a new flashblock arrives. Each flashblock represents an incremental update to the pending block, so multiple notifications may be emitted for the same block height as new flashblocks are processed. #### Parameters | Position | Name | Type | Description | | -------- | ----------------- | -------- | -------------------------- | | 0 | Subscription type | `string` | Must be `"newFlashblocks"` | #### Returns A unique identifier for the subscription, returned as a 32-byte hex string. {% tabs %} {% tab title="Request" %} ```json { "jsonrpc": "2.0", "id": 1, "method": "eth_subscribe", "params": ["newFlashblocks"] } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": 1, "result": "0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b" } ``` {% endtab %} {% endtabs %} *** ### eth\_subscribe - pendingLogs Subscribe to receive logs from flashblocks pending state that match specified filter criteria. #### Description Returns logs from the current pending flashblock state. Unlike the standard `logs` subscription which only includes logs from confirmed blocks, this subscription provides logs from preconfirmed transactions in flashblocks, giving users earlier visibility into contract events. #### Parameters | Position | Name | Type | Description | | -------- | ----------------- | ------------------- | ------------------------------------------- | | 0 | Subscription type | `string` | Must be `"pendingLogs"` | | 1 | Filter | `object` (optional) | Log filter criteria (same as `eth_getLogs`) | **Filter Object** | Field | Type | Description | | --------- | --------------------------------- | ------------------------------------------------------------------- | | `address` | `string` or `string[]` (optional) | Contract address or array of addresses to filter | | `topics` | `array` (optional) | Array of topic filters (32-byte hex strings or arrays for OR logic) | If no filter is provided, all logs from pending flashblocks will be returned. #### Returns A unique identifier for the subscription, returned as a 32-byte hex string. {% tabs %} {% tab title="Request" %} ```json { "jsonrpc": "2.0", "id": 1, "method": "eth_subscribe", "params": [ "pendingLogs", { "address": "0x1234567890123456789012345678901234567890", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" ] } ] } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": 1, "result": "0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b" } ``` {% endtab %} {% endtabs %} *** ### eth\_subscribe - newFlashblockTransactions Subscribe to receive preconfirmed transasctions #### Description Returns transactions from flashblocks that have been included by the realtime block builder and are effectively preconfirmed. #### Parameters
PositionNameTypeDescription
0Subscription typestringMust be "newFlashblockTransactions"
1Full transactionsboolean (optional)true for full transaction objects, false or omitted for hashes only (default)
#### Returns A unique identifier for the subscription, returned as a 32-byte hex string. #### Example - Hash Mode (Default) {% tabs %} {% tab title="Request" %} ```json { "jsonrpc": "2.0", "id": 1, "method": "eth_subscribe", "params": ["newFlashblockTransactions"] } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": 1, "result": "0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b" } ``` {% endtab %} {% endtabs %} #### Example - Full Transaction Mode {% tabs %} {% tab title="Request" %} *** ```json { "jsonrpc": "2.0", "id": 1, "method": "eth_subscribe", "params": ["newFlashblockTransactions", true] } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": 1, "result": "0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b" } ``` {% endtab %} {% endtabs %} *** ### eth\_unsubscribing All subscription types can be unsubscribed using the standard `eth_unsubscribe` method with the subscription ID. {% tabs %} {% tab title="Request" %} ```json { "jsonrpc": "2.0", "id": 1, "method": "eth_unsubscribe", "params": ["0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b"] } ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": 1, "result": true } ``` {% endtab %} {% endtabs %} # Builder RPC (Private orderflow) | Network | URL | | ------- | ----------------------------------------------------------------------------------------------------- | | Mainnet | | | Hoodi | [https://realtime-rpc.ethgas.com/hoodi/builder]() | ### eth\_sendRawTransaction {% tabs %} {% tab title="Request" %} ``` { "jsonrpc": "2.0", "id": "1", "method": "eth_sendRawTransaction”, "params": ["0x…"], // Signed raw tx hex } ``` {% endtab %} {% tab title="Response" %} ``` {"result":200,"error":null,"id":1} ``` {% endtab %} {% endtabs %} Submits a raw transaction (serialized and signed) for broadcasting to the network. The transaction data should be encoded as a hexadecimal string starting with `0x`. You can create and sign a transaction externally using libraries like [web3.js](https://web3js.readthedocs.io/) or [ethers.js](https://docs.ethers.org/). **Note:** For [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) transactions, the raw form must be in the network format, which includes blobs, KZG commitments, and KZG proofs. # Block Building Algorithm and Flow 1. Sub-block Construction Logic 1. Each sub-block is built independently: * Sources of transactions: * Public mempool — sourced in real-time via Reth's local transaction pool (P2P gossip + txpool contents) * Private orderflow — received directly via the builder's private RPC endpoint * Sorting & Ranking Rules (inside each sub-block): 1. Nonce ordering per sender — strict ascending nonce enforcement 2. Effective gas price (priority fee + optional MEV tips / coinbase payment) 3. Others may affect the ordering * Arrival timestamp (for same effective price) 2. Once a sub-block is confirmed: * It remains immutable — even if higher-value transactions arrive later in the same slot. * No retroactive replacement / reordering is allowed within already-confirmed sub-blocks. * This provides strong preconfirmation-like semantics for early-accepted orderflow and prevents last-moment value extraction races from destabilizing earlier commitments. 3. At the end of the slot (or when the slot deadline is reached): * The builder concatenates all previously confirmed sub-blocks in sequential order (respecting the exact order in which sub-blocks were sealed). * The complete, fully built execution payload is then submitted to one or more relays * Proposer then selects & signs header → Relay unblinds → Proposer publishes to network # Libraries You will need a Realtime-aware RPC endpoint to use the following libraries: ### Wagmi ```javascript import { useSendTransaction, useWaitForTransactionReceipt } from "wagmi"; function SendTransaction() { const { data: hash, sendTransaction } = useSendTransaction(); const { data: receipt } = useWaitForTransactionReceipt({ hash }); return (
{hash &&
Hash: {hash}
} {receipt &&
Included on block number: {receipt.blockNumber}
}
) } ``` ### Viem ```javascript import { createWalletClient, http, parseEther, publicActions } from "viem"; import { privateKeyToAccount } from "viem/accounts"; import { baseSepoliaPreconf } from "viem/chains"; // Create client with the Flashblocks-aware chain. const account = privateKeyToAccount(`0x${process.env.PRIVATE_KEY}`); const client = createWalletClient({ account, chain: baseSepoliaPreconf, transport: http(), }) .extend(publicActions); const submissionTime = new Date(); console.log(`Submitting transaction at: ${submissionTime.toISOString()}`); // Send transaction. const hash = await client.sendTransaction({ to: "0x...", value: parseEther('0.0001'), }); console.log(`Transaction hash: ${hash}`); // Wait for transaction to be included. const receipt = await client.waitForTransactionReceipt({ hash }); const confirmTime = new Date(); console.log(`Transaction included at: ${confirmTime.toISOString()}`); console.log(`Time difference: ${confirmTime - submissionTime}ms`); ``` ### Ethers ```javascript const providerA = new ethers.JsonRpcProvider( process.env.ETHGAS_REALTIME_RPC ); const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, providerA); try { // Create a simple transaction (sending 0.001 ETH to a random address) const tx = { to: "", value: ethers.parseEther("0.0000001"), }; // Submit transaction const submissionTime = new Date(); const transaction = await wallet.sendTransaction(tx); console.log(`Submitting transaction at: ${submissionTime.toISOString()}`); console.log(`Transaction hash: ${transaction.hash}`); await transaction.wait(0); // Make sure to set the confirmation count to 0 console.log("Transaction confirmed"); const confirmationTime = new Date(); console.log(`Transaction confirmed at: ${confirmationTime.toISOString()}`); console.log(`Time difference: ${confirmationTime - submissionTime}ms`); } ``` # Real Time Builder Public Keys Mainnet: * `0x86f3ad359674f58ca09fbb9254d7a65251184b7326b948b6d8057a6d8d062b053e87cca4a74b75603aaac521048174f1` Hoodi: * `0x96b5d4d9f95043b84a541ae8ee38cf51621d8c965c7a9fbc41d75474facfd422bde5d45ce7f2d3a2491e37e5474d0125` # Realtime FAQs ## Block Building and Availability #### How often are Realtime blocks produced * The realtime target interval is variable, but currently set to 100ms. A 12-second canonical block contains \~ 80 realtime sub-blocks (indexed from 0 to \~80) with the block building typically starting at T+4. #### Will the number of Realtime blocks per block always be the maximum? * Not always. Heavy execution in one interval may reduce time available for subsequent intervals. The REALTIME\_TIME setting is a target, not a strict guarantee #### Do large gas transactions get delayed? * High gas transactions can be included in any realtime block with sufficient gas capacity. Placement is optimized by heuristics, but available gas decreases as transactions fill earlier realtime blocks. #### Why isn't the realtime block building always enabled? * Currently we run about 4% of Ethereum Validators through the marketplace. When the validator assigned to the current slot hasn't delegated to us, the realtime block building will be disabled. #### How do you sort each sub-block in real time? * As we assemble every sub-block, we keep reordering simulated bundles/txs by their effective priority fee. So the highest-paying orders are always tried first at each sub-block. #### How does the GWEI token change that ranking? * If the sender holds GWEI token, we boost its simulated profit before ranking using a saturating curve: $$ \text{boost%} = Y\_{\max}\left(1 - e^{-k \cdot B\_{\text{gwei}}}\right) \text{multiplier} = 1 + \frac{\text{boost%}}{100} $$ * Where Bgwei is the holder’s balance expressed in GWEI. The boosted profit produces a higher effective priority fee, so the order moves up in the sub-block queue. ## High Availability and Safety #### What happens if the realtime builder fails? * Our ETHGas relay will fallback to a regular MEV-Boost block build (including pre-confirmation bundles). #### Do Realtime blocks change the safety model of Ethereum? * No, each realtime block is validated by the same execution engine as normal blocks #### Why do we need ETHGas realtime block building? * ETHGas realtime blocks change how fast apps can respond on Ethereum. Instead of waiting for full block finality (12 secs), you get an early signal of inclusion, fast enough to make things like trading, gaming, or live dashboards feel instant. It also works with standard RPC methods and doesn't require any new setup. #### How does ETHGas realtime block building prevent MEV attacks? * As realtime blocks build and finalize a new sub-block roughly over 50-100ms, this leaves limited time for a searcher to see your transaction in the mempool and then exploit it — 100ms sub-blocks are expected to have about 91% less MEV. # Institutional Blockspace Compliant, credibly-neutral blockspace for regulated institutions building on Ethereum. Institutional Blockspace is ETHGas's framework for delivering Ethereum blockspace that meets the compliance, transparency, and settlement-certainty requirements of regulated institutions - without sacrificing Ethereum's credible neutrality. It combines a configurable **Policy Engine**, **fair ordering** guarantees, and a network of **known, onshore, qualified validators** so that banks, asset managers, and protocol treasuries can transact onchain with the assurances their mandates require. ### Why this exists Most institutions cannot use Ethereum's default transaction pipeline as-is. Public mempools expose orders before they settle, block ordering is opaque, and there is no way to know which parties assembled a block or whether it complies with an institution's regulatory obligations. For a regulated desk, that is a non-starter. ETHGas closes that gap. By letting institutions **reserve blockspace in advance** and route it through a policy-governed, transparent build process, we turn Ethereum's public infrastructure into something an institution can actually underwrite: predictable inclusion, auditable ordering, and counterparties that are known rather than anonymous. ### The building blocks #### Policy Engine A configurable rules layer applied to blockspace an institution reserves. Institutions (or the validators serving them) can define policies — for example, screening against sanctions lists, restricting counterparties, or enforcing jurisdictional constraints — and have those policies enforced at build time rather than after settlement. #### Fair ordering Guarantees about how transactions inside reserved blockspace are sequenced, removing the opaque, MEV-driven reordering that institutions cannot audit or explain to a regulator. Ordering becomes a property the buyer can rely on and evidence. #### Known & onshore validators A curated set of validators that are identity-verified, operate in supported jurisdictions ("onshore"), and meet defined operational and compliance standards. Institutions can require that their blockspace is served only by validators in this qualified set. #### Settlement certainty Because blockspace is reserved ahead of time via ETHGas's Blockspace & Preconf Marketplace, institutions get advance assurance that their transactions will be included — turning "we hope this lands in a block" into a contracted commitment. ### How it fits together 1. An institution reserves blockspace (whole-block or preconfirmation) through the Blockspace & Preconf Marketplace. 2. The reserved blockspace is served by validators drawn from the **known & onshore** qualified set. 3. The **Policy Engine** enforces the institution's configured rules as the block is built. 4. **Fair ordering** guarantees govern how transactions are sequenced. 5. The institution receives an auditable record suitable for internal and regulatory review. ### Who this is for * Banks and regulated trading desks executing onchain * Asset managers and ETF/treasury operators * Protocol treasuries with compliance obligations * Custodians and infrastructure providers serving regulated clients # x402 Agentic Preconfirmations Buy a guaranteed Ethereum mainnet preconfirmation with one signed HTTP request. Standard x402, Permit2-native, WETH per call. ETHGas's x402 for Blockspace endpoint lets an agent purchase a preconfirmation for a single Ethereum mainnet transaction. In plain language, you submit a signed transaction, pay the quoted WETH fee with signature via standard HTTP, and ETHGas passes it to the blockspace platform and partnered builders for inclusion. This service works on Ethereum mainnet only. It is intended for users who already have an Ethereum wallet. ### At A Glance * **Endpoint:** `https://x402.ethgas.com/v1/preconfirmations` * **Method:** POST * **Content-Type:** `application/json` * **Authentication:** none — x402 is payment-native. Agents pay per request; no API keys, no accounts * **Network:** Ethereum mainnet only ### Prerequisites Before your first request: * An Ethereum mainnet wallet * Enough WETH to pay the preconfirmation fee (see [Pricing](#pricing)) * Enough ETH to pay the base and priority fee for your transaction * A one-off transaction to grant the standard Permit2 contract the payment permission used by the facilitator to move the WETH fee when you approve the preconfirmation purchase ### Setup Grant the standard Permit2 contract permission to move WETH on your behalf. This is a one-off transaction. After this, no further gas payments to ETHGas are required. * **Permit2 Contract:** [`0x000000000022d473030f116ddee9f6b43ac78ba3`](https://etherscan.io/address/0x000000000022D473030F116dDEE9F6B43aC78BA3) * Permit2 is a contract developed by Uniswap * **Recommended approval amount:** 0.002 ETH should be enough for \~100 swaps * **Via Etherscan:** [approve WETH for Permit2](https://etherscan.io/address/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2#writeContract#F1) * under `1. approve (0x095ea7b3)` * put Permit2 contract address in `guy (address)` field * put approval amount in `wad (uint256)` field ### End-to-End Flow #### Step 1: Sign the transaction you want executed Prepare and sign your Ethereum mainnet transaction as you would for any RPC submission. Requirements: * Valid Ethereum mainnet transaction * Gas limit ≤ 300,000 units (limit in place during initial rollout to prevent any single transaction occupying the majority of blockspace) * Blob transactions (EIP-4844 type 3) are **not** supported #### Step 2: Request a preconfirmation POST the signed transaction to the endpoint: ```bash curl -X POST https://x402.ethgas.com/v1/preconfirmations \ -H "Content-Type: application/json" \ -d '{"rawSignedTransaction": "0x02f8..."}' ``` **If a suitable upcoming block slot is available**, ETHGas responds with `HTTP/1.1 402 Payment Required`: ```http HTTP/1.1 402 Payment Required PAYMENT-REQUIRED: ``` Decoded challenge structure: ```json { "scheme": "exact", "network": "eip155:1", // Ethereum mainnet "amount": "2100000000000", // in wei "asset": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH address "payTo": "0x...", "maxTimeoutSeconds": 180, "extra": { "assetTransferMethod": "permit2" } } ``` **If no upcoming block is available**, no payment request is issued. Wait briefly and request a new quote, do not retry immediately in a tight loop. #### Step 3: Verify the payment challenge Your agent should independently verify: * `network` matches the expected chain (`ethereum`) * `asset` is `WETH` (not ETH — payment is in wrapped ETH via Permit2) * `amount` is within your budget * [`assetTransferMethod`](#user-content-fn-1)[^1] is `permit2` Reject any challenge that doesn't match your policy. #### Step 4: Sign the payment challenge Sign the typed payload using EIP-712 structured data signing. This authorizes the facilitator to pull the WETH fee via Permit2. This signature is gasless, no ETH is spent on the preconfirmation payment leg. #### Step 5: Submit the signed payment Retry the request with the signature in the `PAYMENT-SIGNATURE` header: ```bash curl -X POST https://x402.ethgas.com/v1/preconfirmations \ -H "Content-Type: application/json" \ -H "PAYMENT-SIGNATURE: 0x1b8f..." \ -d '{"rawSignedTransaction": "0x02f8..."}' ``` Payment requests expire in 180 seconds — sign and submit promptly. If a challenge expires, request a new quote rather than reusing the old one. #### Step 6: Settlement and inclusion ETHGas verifies the signature, settles the WETH payment via Permit2, and forwards the original signed transaction to the blockspace platform and partnered builders. Response: ```http HTTP/1.1 200 OK Content-Type: application/json { "success": true, "status": "payment_settling", "pendingTransactionHash": "0x..." } ``` * `pendingTransactionHash` identifies the pending preconf transaction, subject to the successful WETH payment #### Step 7: Confirm on-chain inclusion * Use Etherscan to query the above pending transaction hash or * Poll `pendingTransactionHash` via standard Ethereum RPC to confirm inclusion: ```bash curl -X POST https://ethereum-rpc.publicnode.com \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":[""],"id":1}' ``` #### Reference You could follow the instructions in our [Github Repo](https://github.com/ethgas-developer/ethgas-x402-client) ### Pricing The preconfirmation fee is based on your transaction's **gas limit**, not the gas it eventually consumes: ``` preconfirmation fee = price per gas unit × transaction gas limit ``` **Example:** at a price of `0.1 gwei` per gas unit with a gas limit of `21,000`, the fee is `2,100 gwei` = `0.0000021 WETH`. The preconfirmation fee is separate from and additional to: * **The Ethereum network fee both base and priority fee** for your transaction, paid in ETH as normal ### Inclusion & MEV Protection ETHGas provides fast inclusion via direct routing to block builders, with deterministic inclusion for blocks proposed by ETHGas-partnered validators. * **Fast inclusion.** Once a preconfirmation is issued, ETHGas forwards the signed transaction directly to a network of block builders, including ETHGas's own block-building infrastructure. The transaction bypasses the public mempool. * **Deterministic inclusion for ETHGas-built blocks.** For blocks proposed by ETHGas-partnered validators, inclusion is deterministic once a preconfirmation is issued. Coverage across the Ethereum validator set is growing through ongoing partner onboarding. * **MEV protection.** Because transactions bypass the public mempool, they are not visible to public MEV searchers. This protects them from front-running and sandwich attacks by construction. ### Common failures
ConditionBehavior
No upcoming block availableNo payment request issued. Retry after a short wait
Payment signature invalid or expiredNo preconfirmation issued. Request a new quote
Insufficient WETH balance or missing Permit2 approvalNo preconfirmation issued
Duplicate submission of the same signed transactionMay be rejected while the first attempt is being processed. Do not submit the same signed tx through multiple routes concurrently
Gas limit above 300,000 unitsRejected at intake
Blob transaction (EIP-4844 type 3)Rejected at intake
### Refund * In the uncommon case that the transaction is rejected after the payment is settled, ETHGas will issue a refund to the original payer. [^1]: # Overview ### Building the Foundation for Modern Finance on Ethereum Bringing realtime execution and institutional readiness to validators, traders, wallets, and agents on Ethereum. **ETHGas Solutions for Every Ethereum Ecosystem Users:**
Sell your blockspace forward and enhance native ETH yields/pages/cknOwnmYBSdBRcxpJ1LB
Trade blockspace as an asset, buy preconfirmations for guaranteed inclusion and hedge gas volatility/pages/gmFeDLoCw3ZP3fp6HzRg
Give your users instant transactions by reserving blockspace with ETHGas/pages/eu1StOe0NjuOxxMcArLp/pages/gmFeDLoCw3ZP3fp6HzRg
Transact onchain with compliance and settlement certainty/pages/xiy0bdjt31Q7OY4m2rqp
Build on 50–100ms Realtime Blocks for instant, reliable execution and sponsor gas/pages/jQdLFMjYJmJd6ilZUVSy
# Validators & Node Operators Sell your blockspace forward and enhance native ETH yields 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: Sell your blockspace forward** By integrating with ETHGas, you turn your validation infrastructure into a premium service for the entire onchain 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. * **None of the complexity:** Access this market without becoming a block-building expert, our infrastructure handles the hard parts. * **Power the realtime economy:** You become the backbone of Realtime Ethereum, supplying the guaranteed, priority blockspace that traders, agents, protocols, and institutions demand. * **Simple & secure:** Our infrastructure is designed for seamless integration, allowing you to access this new market without compromising on security or operational stability. **Get started** * Integrate via the Commit-Boost module: # Traders & Searchers Trade blockspace as an asset, buy preconfirmations for guaranteed inclusion and hedge gas volatility. **The Solution: The Blockspace & Preconf Marketplace** Trade the core components of Ethereum execution itself, unlocking new opportunities for alpha and risk management. * **Precision execution:** Buy *inclusion preconfirmations* to secure guaranteed placement with absolute certainty, the ultimate edge for latency-sensitive and searcher strategies. * **Guaranteed inclusion:** Lock in that your transaction lands, settling in **50–100ms**, instead of competing blindly in every block auction. * **Hedge volatility:** Use upcoming *Base Fee Futures* to hedge gas-price volatility, turning an unpredictable cost into a manageable variable. * **A new liquid asset class:** Blockspace is deeply correlated with onchain activity — opening sophisticated arbitrage and hedging strategies against the broader market. **Get started** * ETHGas trading is available on Mainnet and for testing on the Hoodi network. * Monitor the markets in the App UI (read only): * Testing is available via API: see [developer docs](https://developers.ethgas.com/#change-log). * Product detail: [Blockspace & Preconf Marketplace](/overview/blockspace-and-preconf-marketplace) # Wallets & Order Flow Give your users instant transactions by reserving blockspace with ETHGas. Wallets and apps that originate order flow can use ETHGas to **reserve capacity and guarantee settlement,** giving end users **instant transactions** instead of failed sends, stuck transactions, and unpredictable fees. You commit to blockspace ahead of demand; your users feel a fast, reliable, near-gasless experience. ### The problem we solve for you Your users don't care about gas markets, they care that the transaction goes through, quickly, at a price they expected. On the open mempool you can't promise any of that: fees spike, transactions get stuck, and sends fail during congestion. Every one of those is a support ticket and a churn risk. ETHGas lets you buy that reliability in advance. ### What you can do * **Reserve capacity ahead of demand:** Purchase blockspace commitments so your users' transactions have guaranteed inclusion even when the network is congested. * **Guarantee settlement:** Turn "we hope this lands" into a preconfirmed commitment, the transaction is promised inclusion before the block is built. * **Deliver instant UX:** Realtime Execution let you show users near-instant confirmation rather than waiting on the next block. * **Offer predictable gas.** Because you've reserved blockspace at a known price, you can give users a stable, predictable fee experience (or abstract gas away entirely). ### How to get started 1. **Review the marketplace:** See [Blockspace & Preconf Marketplace](/overview/blockspace-and-preconf-marketplace) to understand inclusion preconfirmations and whole-block commitments. 2. **Integrate:** Follow the Technical Integration guide (coming soon) to connect your wallet or order-flow backend. 3. **Reserve blockspace:** Buy the commitments that match your users' transaction volume and timing. 4. **Ship the instant UX:** Surface instant confirmation with [Realtime Execution](/overview/realtime) to your users. # Institutions How regulated institutions use ETHGas to transact onchain with compliance and settlement certainty. If you're a bank, asset manager, custodian, or protocol treasury, ETHGas lets you use Ethereum on terms your mandate can accept: **reserve blockspace in advance**, transact through a **policy-governed, fairly-ordered** build process served by **known, onshore validators**, and get **advance certainty** that your transactions will settle. This page explains what you can do today and how to get started. ### The problem we solve for you | Institutional requirement | Ethereum default | With ETHGas | | ------------------------- | ----------------------------------- | ------------------------------------------------ | | Settlement certainty | Best-effort inclusion; no guarantee | Reserved blockspace = contracted inclusion | | Auditable ordering | Opaque, MEV-driven reordering | Fair-ordering guarantees you can evidence | | Compliance controls | None at build time | Policy Engine enforces rules as blocks are built | | Known counterparties | Anonymous builders/validators | Known & onshore qualified validator set | | Predictable cost | Volatile gas | Blockspace reserved at a known price | ### What you can do * **Reserve blockspace ahead of execution:** Buy whole-block commitments or preconfirmations through the Blockspace & Preconf Marketplace so critical transactions are guaranteed inclusion at a known price, not left to the volatility of the open mempool. * **Apply your compliance policies:** Route reserved blockspace through the Policy Engine to enforce sanctions screening, counterparty restrictions, and jurisdictional rules at build time. * **Require known, onshore validators:** Specify that your blockspace is served only by validators in the qualified set: identity-verified operators in supported jurisdictions. * **Produce an audit trail:** Ordering and inclusion become properties you can document for internal risk and external regulators. ### How to get started 1. **Talk to us:** Reach out via [the ETHGas team](mailto:info@ethgas.com) to scope your [Institutional Blockspace ](/overview/institutional-blockspace)requirements and jurisdiction. 2. **Configure policies:** Work with us to define the compliance rules the Policy Engine will enforce for your blockspace. 3. **Reserve blockspace:** Use the [Blockspace & Preconf Marketplace](/overview/blockspace-and-preconf-marketplace) to purchase the commitments you need. 4. **Execute and reconcile:** Transact with settlement certainty and pull the audit record for your reporting. # Protocols & dApps Build on 50–100ms Realtime Blocks for instant, reliable execution and sponsor gas with Open Gas. Your users judge you on one thing: does the app feel fast and reliable? On default Ethereum you can't promise that: transactions wait for the next block, fail during congestion, and cost an unpredictable amount. ETHGas lets you build on infrastructure that removes that friction at the source. **The Solution: Build on Realtime Blocks** ETHGas breaks Ethereum blocks into synthetic sub-blocks that settle in **50–100ms**, giving your users near-instant, reliable confirmation instead of the 12-second wait. * **Instant UX:** Give users Web2-speed feedback. Preconfirmations mean a transaction is guaranteed inclusion before the block is even built. * **Reliable execution:** Reserve blockspace ahead of demand so critical actions land even when the network is congested — no more failed sends at the worst possible moment. * **Predictable cost:** Blockspace bought in advance at a known price lets you offer users stable, predictable fees. **Also available: sponsor gas with Open Gas** Want to remove gas from the user experience entirely? The Open Gas Initiative is a zero-code rebates program that lets you subsidize gas fees for your community — a powerful acquisition and retention tool. * Reward loyal users by rebating a share of the gas they spend on your protocol. * Run acquisition campaigns using gas rebates as the hook. **Get started** 1. **Ship the instant UX:** Surface instant confirmation with [Realtime Execution](/overview/realtime) to your users. 2. **Enable execution certainty:** see [Blockspace & Preconf Marketplace](/overview/blockspace-and-preconf-marketplace) and Technical Integration as [Commitment Buyers](https://docs.ethgas.com/get-started/commitment-buyers) 3. **Remove gas uncertainty:** Join the [Open Gas](/program/open-gas) partner program to sponsor gas rebates # 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. * **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://www.ethgas.com/community/overview/?utm_source=gitbook) # Node Operators {% hint style="success" %} The collateral requirement to register a validator to ETHGas is currently \***zero**\* ETH! You can start using ETHGas ***today*** for **FREE** and earn higher rewards for every block 🥳 {% endhint %} 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 directly align 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 a certain % of trading revenue via our Staking Incentive Program (Details soon). Check out our Quick Start Guide for a simple setup, or the [repo README](https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module) for a full technical guide. {% content-ref url="/pages/4BiH0Qb0c0UDHhWtTt5R" %} [Quick Start Guide](/get-started/node-operators/quick-start-guide) {% endcontent-ref %} ⭐️ Once you've completed the Quick Start Guide, don't forget to set up Multi-Relay Support ⭐️ {% content-ref url="/pages/WgfzJ4Dz8Ks5Dd3wwzC9" %} [Multi-Relay Support](/get-started/node-operators/multi-relay-support) {% endcontent-ref %} *** ## Commit Boost Commit-Boost is a direct replacement for MEV-Boost and performs the same function, with the ability to add additional functionality. Commit-Boost is a sidecar for proposers to create commitments. Validators need to run Commit-Boost, which uses a validator's 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. Link:

different commit boost components

*** ## Collateral & Slashing {% hint style="success" %} The collateral requirement to register a validator to ETHGas is currently \***zero**\* ETH! You can start using ETHGas ***today*** for **FREE** and earn higher rewards for every block 🥳 {% endhint %} 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 honor all commitments sold from our exchange. If not, the ETHGas platform will be slashed. ### What is Considered a Slashable Event? * Missing a slot with commitments attached to it. * Not proposing blocks obtained from the ETHGas relay. ### Providing Collateral Validators are able to provide collateral by either: * Depositing ETH directly to the ETHGas collateral smart contract on L1. Check the [Technical Integration](/developer-resources/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](/get-started/node-operators/collateral-avs) page for further information. The ETHGas Exchange also posts collateral as a liveness bond to insure against our platform going offline. ### Collateral Amounts {% hint style="success" %} The collateral requirement to register a validator to ETHGas is currently \***zero**\* ETH! You can start using ETHGas ***today*** for **FREE** and earn higher rewards for every block 🥳 {% endhint %} 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. {% hint style="info" %} 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. {% endhint %} 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, who 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 follows: 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 the ETHGas relay to determine whether the validator correctly gets the block. Our backend will debit a certain amount of collateral from validators and credit a 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 a 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](/overview/our-technology/the-ethgas-architecture). ## Quick Start Guide {% content-ref url="/pages/4BiH0Qb0c0UDHhWtTt5R" %} [Quick Start Guide](/get-started/node-operators/quick-start-guide) {% endcontent-ref %} ## Multi-Relay Support {% content-ref url="/pages/WgfzJ4Dz8Ks5Dd3wwzC9" %} [Multi-Relay Support](/get-started/node-operators/multi-relay-support) {% endcontent-ref %} ## Collateral AVS {% content-ref url="/pages/tBlOIG3qf9o5zEjkjNmU" %} [Collateral AVS](/get-started/node-operators/collateral-avs) {% endcontent-ref %} # Quick Start Guide {% hint style="success" %} The collateral requirement to register a validator to ETHGas is currently \***zero**\* ETH! You can start using ETHGas ***today*** for **FREE** and earn higher rewards for every block 🥳 {% endhint %} {% stepper %} {% step %} ### Set up Commit-Boost {% endstep %} {% step %} ### Register validators to ETHGas {% endstep %} {% step %} ### Earn higher rewards That's it, you're earning higher rewards! You can sit back and relax 🏖️ {% endstep %} {% endstepper %} {% hint style="info" %} This guide is a simplified quick start configuration that assumes a standard validator setup. For a full technical guide with every available configuration option, check out the [repo README](https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module). {% endhint %} ### Commit-Boost The `ethgas-preconf-commit-boost-module` repo contains everything needed to setup and run Commit-Boost as well as the ETHGas module. If you are already running an existing version of Commit-Boost, you can either: 1. Use this single repo instead for simpler configuration management. 2. Or, continue using your existing version, making sure to add the configuration, `rpc_url`, ETHGas `[[relays]]`, etc. To get started, clone the repo: ```bash git clone https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module.git ``` Copy `docker-compose-example.yml` as `docker-compose.yml` and make any required modifications. ```bash cp docker-compose-example.yml docker-compose.yml ``` Create an empty `.cb.env` file and generate a new jwt for the signer module by running: ```bash touch .cb.env docker compose -f docker-compose.yml up cb_gen_jwt ``` Create a `config.toml` file and enter the following configuration: ```bash touch config.toml ``` {% hint style="info" %} This is a minimal setup and does not cover all environment types. For a comprehensive list of all available configuration options, open the `config.example.mainnet.toml` file. {% endhint %} {% tabs %} {% tab title="Mainnet" %} {% code title="config.toml" overflow="wrap" lineNumbers="true" %} ```toml chain = "Mainnet" [pbs] # Must be set to true to allow signers to work with PBS module. with_signer = true # Port to receive BuilderAPI calls from beacon node # NOTE: This is the same as the default mev-boost port, # since this PBS module replaces the default mev-boost client port = 18550 # The PBS module needs one or more [[relays]] as defined below. # The configuration options enable_timing_games, target_first_request_ms and frequency_get_header_ms are set as recommended defaults. If those default settings are not included, it may lead to reduced validator performance. [[relays]] id = "ethgas" url = "https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [[relays]] id = "ethgas-us" url = "https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@us-relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [[relays]] id = "ethgas-eu" url = "https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@eu-relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [[relays]] id = "ethgas-ap" url = "https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@ap-relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [signer] port = 20000 ``` {% endcode %} {% endtab %} {% tab title="Hoodi" %} {% code title="config.toml" overflow="wrap" lineNumbers="true" %} ```toml chain = "Hoodi" [pbs] # Must be set to true to allow signers to work with PBS module. with_signer = true # Port to receive BuilderAPI calls from beacon node # NOTE: This is the same as the default mev-boost port, # since this PBS module replaces the default mev-boost client port = 18550 # Execution Layer RPC url to use for extra validation # REQUIRED. Can be set to any accessible RPC. rpc_url = "https://ethereum-hoodi-rpc.publicnode.com" # The PBS module needs one or more [[relays]] as defined below. # The configuration options enable_timing_games, target_first_request_ms and frequency_get_header_ms are set as recommended defaults. If those default settings are not included, it may lead to reduced validator performance. [[relays]] id = "ethgas" url = "https://0xb20c3fe59db9c3655088839ef3d972878d182eb745afd8abb1dd2abf6c14f93cd5934ed4446a5fe1ba039e2bc0cf1011@hoodi-relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [signer] docker_image = "ghcr.io/commit-boost/signer:latest" port = 20000 ``` {% endcode %} {% endtab %} {% endtabs %} ### Signers This section continues the configuration of the `config.toml` file for the signer modules. Select the signer that you are using add the configuration below the `[signer]` section in your `config.toml` file #### Local Signers
Lighthouse **File structure:** ``` ├── keys │   ├── │   │   └── voting-keystore.json │   └── │   └── voting-keystore.json └── secrets    ├──    └── ``` **Config:** {% code title="config.toml" lineNumbers="true" %} ```toml [signer.local.loader] format = "lighthouse" keys_path = "keys" secrets_path = "secrets" ``` {% endcode %}
Prysm **File structure:** ``` ├── wallet │   └── direct │      └── accounts │         └──all-accounts.keystore.json └── secrets    └── password.txt ``` **Config:** {% code title="config.toml" lineNumbers="true" %} ```toml [signer.local.loader] format = "prysm" keys_path = "wallet/direct/accounts/all-accounts.keystore.json" secrets_path = "secrets/password.txt" ``` {% endcode %}
Teku **File structure:** ``` ├── keys │   ├── .json │   └── .json └── secrets    ├── .txt    └── .txt ``` **Config:** {% code title="config.toml" lineNumbers="true" %} ```toml [signer.local.loader] format = "teku" keys_path = "keys" secrets_path = "secrets" ``` {% endcode %}
Lodestar **File structure:** ``` ├── keys │   ├── .json │   └── .json └── secrets    └── password.txt ``` **Config:** {% code title="config.toml" lineNumbers="true" %} ```toml [signer.local.loader] format = "lodestar" keys_path = "keys" secrets_path = "secrets/password.txt" ``` {% endcode %} {% hint style="info" %} All keys have the same password stored in `secrets/password.txt` {% endhint %}
Nimbus **File structure:** ``` ├── keys │   ├── │   │   └── keystore.json │   └── │   └── keystore.json └── secrets    ├──    └── ``` **Config:** {% code title="config.toml" lineNumbers="true" %} ```toml [signer.local.loader] format = "nimbus" keys_path = "keys" secrets_path = "secrets" ``` {% endcode %}
#### Remote Signers
Web3Signer Web3Signer implements the same API as Commit-Boost, so there's no need to set up a Signer module. The parameters needed for the remote signer are: {% code title="config.toml" lineNumbers="true" %} ```toml [signer.remote] # URL of the Web3Signer instance url = "https://remote.signer.url" ``` {% endcode %}
Dirk Dirk is a distributed key management system that can be used to sign transactions. In this case the Signer module is needed as an intermediary between the modules and Dirk. The following parameters are needed: {% code title="config.toml" lineNumbers="true" %} ```toml [signer.dirk] # Path to the client certificate to authenticate with Dirk cert_path = "/path/to/client.crt" # Path to the client key key_path = "/path/to/client.key" # Path to the secrets directory where the accounts passwords are stored secrets_path = "/path/to/secrets" # Path to the CA certificate that signed the Dirk server certificate # OPTIONAL ca_cert_path = "/path/to/ca.crt" # Add one entry like this for each Dirk host [[signer.dirk.hosts]] # Domain name of the server to use in TLS verification, if different from the URL # OPTIONAL server_name = "localhost-1" # Complete URL of a Dirk gateway url = "https://localhost:8881" # Wallets to load consensus keys from accounts = ["Wallet1", "DistributedWallet"] [[signer.dirk.hosts]] server_name = "localhost-2" url = "https://localhost:8882" accounts = ["Wallet2", "DistributedWallet"] ``` {% endcode %} * `cert_path` and `key_path` are the paths to the client certificate and key used to authenticate with Dirk. * `wallets` is a list of wallets from which the Signer module will load all accounts as consensus keys. Generated proxy keys will have format `///`, so accounts found with that pattern will be ignored. * `secrets_path` is the path to the folder containing the passwords of the generated proxy accounts, which will be stored in `////.pass`. {% code title="config.mainnet.toml" lineNumbers="true" %} ```toml # Configuration for how the Signer module should store proxy delegations. # OPTIONAL [signer.dirk.store] proxy_dir = "/path/to/proxies" ``` {% endcode %} Delegation signatures will be stored in files with the format `/delegations//.sig`. A full example of a config file with Dirk can be found [here](https://github.com/Commit-Boost/commit-boost-client/blob/main/examples/configs/dirk_signer.toml).
### ETHGas Module The ETHGas module is run each time you want to update your ETHGas account configuration. This includes actions like: * Registering and deregistering validators * Updating your entity name, etc. {% hint style="info" %} Currently, the only authentication optoions are adding your EOA\_SIGNING\_KEY or ACCESS\_JWT to the config directly (or through a .env file). The EOA\_SIGNING\_KEY can be a new private key and does not need to be associated with any existing wallet or funds. It is used only for authentication for your ETHGas account. An improvement is planned to allow the generation of an API key in the ETHGas validator UI that can then be reused in this module configuration file. This would provide an alternative method for validators who want to use a hardware wallet and/or multisig wallet for authentication. {% endhint %} {% tabs %} {% tab title="Mainnet" %} {% code title="config.toml" lineNumbers="true" %} ```toml [[modules]] id = "ETHGAS_COMMIT" type = "commit" env_file = ".cb.env" docker_image = "ghcr.io/ethgas-developer/commitboost_ethgas_commit:latest" exchange_api_base = "https://mainnet.app.ethgas.com" entity_name = "..." # my_amazing_team overall_wait_interval_in_second = 0 registration_mode = "standard" # standard, standard-mux, ssv, obol, skipped enable_registration = true enable_pricer = true enable_builder = false enable_ofac = false collateral_per_slot = "0" # No collateral is currently required builder_pubkey = "0x94a076b27f294dc44b9fd44d8e2b063fb129bc85ed047da1cefb82d16e1a13e6b50de31a86f5b233d1e6bbaca3c69173" # Titan, you could change it to any other registered builder pubkey is_jwt_provided = false query_pubkey = true # Specify either eoa_signing_key or access_jwt & refresh_jwt depending on is_jwt_provided boolean value # Alternatively, you can set EOA_SIGNING_KEY or ACCESS_JWT & REFRESH_JWT in .cb.env as env variables eoa_signing_key = "0x..." # for registration in exchange, required if is_jwt_provided = false access_jwt = "xxx.xxx.xxx" # required if is_jwt_provided = true refresh_jwt = "xxx.xxx.xxx" # required if is_jwt_provided = true ``` {% endcode %} {% endtab %} {% tab title="Hoodi" %} {% code title="config.toml" lineNumbers="true" %} ```toml [[modules]] id = "ETHGAS_COMMIT" type = "commit" env_file = ".cb.env" docker_image = "ghcr.io/ethgas-developer/commitboost_ethgas_commit:latest" exchange_api_base = "https://hoodi.app.ethgas.com" entity_name = "..." # my_amazing_team overall_wait_interval_in_second = 0 registration_mode = "standard" # standard, standard-mux, ssv, obol, skipped enable_registration = true enable_pricer = true enable_builder = false enable_ofac = false collateral_per_slot = "0" # No collateral is currently required builder_pubkey = "0x94a076b27f294dc44b9fd44d8e2b063fb129bc85ed047da1cefb82d16e1a13e6b50de31a86f5b233d1e6bbaca3c69173" # Titan, you could change it to any other registered builder pubkey is_jwt_provided = false query_pubkey = true # Specify either eoa_signing_key or access_jwt & refresh_jwt depending on is_jwt_provided boolean value # Alternatively, you can set EOA_SIGNING_KEY or ACCESS_JWT & REFRESH_JWT in .cb.env as env variables eoa_signing_key = "0x..." # for registration in exchange, required if is_jwt_provided = false access_jwt = "xxx.xxx.xxx" # required if is_jwt_provided = true refresh_jwt = "xxx.xxx.xxx" # required if is_jwt_provided = true ``` {% endcode %} {% endtab %} {% endtabs %} ### Metrics and Logs {% code title="config.toml" lineNumbers="true" %} ```toml # Configuration for how metrics should be collected and scraped # OPTIONAL, skip metrics collection if missing [metrics] # Whether to collect metrics # OPTIONAL, DEFAULT: true enabled = true # Host to listen on for metrics # OPTIONAL, DEFAULT: 127.0.0.1 host = "127.0.0.1" # Services will listen for Prometheus scrapes on this port, port + 1, +2, etc. # OPTIONAL, DEFAULT: 10000 start_port = 10000 # Configuration stdout logs # OPTIONAL, DEFAULT: enabled [logs.stdout] # Whether to enable stdout logging # OPTIONAL, DEFAULT: true enabled = true # Log level. Supported values: trace, debug, info, warn, error # OPTIONAL, DEFAULT: info level = "info" # Log in JSON format # OPTIONAL, DEFAULT: false use_json = false # Whether to enable ANSI color codes # OPTIONAL, DEFAULT: true color = true # Configuration file logs # OPTIONAL, DEFAULT: disabled [logs.file] # Whether to enable file logging # OPTIONAL, DEFAULT: false enabled = true # Log level. Supported values: trace, debug, info, warn, error # OPTIONAL, DEFAULT: info level = "debug" # Log in JSON format # OPTIONAL, DEFAULT: true use_json = true # Path to the log directory # OPTIONAL, DEFAULT: /var/logs/commit-boost dir_path = "./logs" # Maximum number of log files to keep # OPTIONAL max_files = 30 ``` {% endcode %} ### Start the Signer module {% hint style="info" %} For **DVT validators** or **remote signer**, you don't need to run this module. {% endhint %} For registration of non-DVT validators, run: ```bash docker compose -f docker-compose.yml up cb_signer ``` ✅ If your signer starts successfully, you should see the log similar to: {% code overflow="wrap" %} ``` INFO Starting signing service version="0.8.0" commit_hash="f51f5bd61831fde943057b29ffd6e26e7eb23765" modules=["ETHGAS_COMMIT"] endpoint=0.0.0.0:20000 loaded_consensus=100 loaded_proxies=0 ``` {% endcode %} where `loaded_consensus` indicates the total number of loaded keys. ### Start the ETHGas Commit module You are advised to run this module at or after the 2nd slot of the current epoch, so you can have more time to configure the PBS module. This module only needs to be run whenever you modify the configuration of this module, e.g. when you want to register or deregister a validator to the ETHGas Exchange, to change collateral settings, etc. Think of running this module as "Update my config and sync with ETHGas". To register the validators to the ETHGas Exchange, run: ```bash docker compose -f docker-compose.yml up cb_ethgas_commit ``` ✅ If all goes well, you will see the log: {% code overflow="wrap" %} ``` INFO successful registration, you can now sell preconfs on ETHGas! or INFO successful registration, the default pricer can now sell preconfs on ETHGas on behalf of you! ``` {% endcode %} ❌ If the module encounters `ConnectionRefused` error when it tries to connect to `http://cb_signer:20000/signer/v1/get_pubkeys`, please wait for 20 minutes to retry. ### Start the PBS module Start the PBS module by running: ```bash docker compose -f docker-compose.yml up cb_pbs ``` The default port used by the PBS module is the same default port as MEV-Boost. If you had previously configured a custom port for MEV-Boost, make sure you have configured that on the PBS module. ✅ If all goes well, you will see the log: {% code overflow="wrap" %} ``` DEBUG register_validators{req_id=...}:handler{relay_id="ethgas"}: registration successful code=200 latency=...ms ``` {% endcode %} Once the ETHGas Commit module has completed the registration process and right before the start of the next epoch, stop your existing MEV-Boost client, restart the beacon node with new builder endpoint (if the port is different), and immediately start the PBS module. To hot reload the config without restarting the module, run: ```bash docker compose -f docker-compose.yml exec cb_pbs curl -X POST http://localhost:18550/reload ``` ✅ You will see the log `INFO : config reload successful` if the config reloads successfully. Refer [here](https://commit-boost.github.io/commit-boost-client/get_started/configuration/#hot-reload) for more details about hot reloading. *** ### ⭐️ Next Steps ⭐️ Once you have your validators registered to ETHGas, the next step is to configur Multi-Relay Support. Using multiple relays, alongside the ETHGas relays, will improve the reliability of your block proposals and result in higher rewards. {% content-ref url="/pages/WgfzJ4Dz8Ks5Dd3wwzC9" %} [Multi-Relay Support](/get-started/node-operators/multi-relay-support) {% endcontent-ref %} # Multi-Relay Support > ### **Using multiple relays, alongside the ETHGas relays, will improve the reliability of your block proposals and result in higher rewards** Validators have two relay configuration options when using ETHGas: 1. **Multi-relay:** Connect to any relays. 2. **ETHGas relays only:** Connect to only ETHGas relays. {% hint style="success" %} Both relay configurations use the commit-boost pipeline for block building. {% endhint %} ## 1. Multi-relay To use any relay with a validator registered to ETHGas, additional configuration is required. The fee recipient for the validators using ETHGas must be set to the ETHGasPool contract address. Then, in the ETHGas commit-boost module configuration file, your payout address needs to be set. * **ETHGasPool - Mainnet :** [**0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3**](https://etherscan.io/address/0x3314fb492a5d205a601f2a0521fafbd039502fc3) * **ETHGasPool - Hoodi:** [**0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1**](https://hoodi.etherscan.io/address/0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1) By setting your fee recipient on your validator clients, multi-relay support will automatically be enabled. Payments will still be made directly to your payout address in the block proposed by your validators. {% hint style="info" %} When migrating from ETHGas Relay Only to Multi-Relay, your `payout_address` should be moved from the validator client to the `config.toml` and the ETHGasPool contract address should be used on the validator client. {% endhint %} {% tabs %} {% tab title="Standard" %}
{% endtab %} {% tab title="SSV" %}
{% endtab %} {% tab title="Obol" %}
{% endtab %} {% endtabs %} {% stepper %} {% step %} ### Set the payout address in config.toml The payout address should be set to the address where you want your rewards paid out. {% tabs %} {% tab title="Standard" %} {% code title="config.toml" %} ```toml [[modules]] id = "ETHGAS_COMMIT" type = "commit" ... payout_address = "" # You need to re-register your validators when updating your payout_address registration_mode = "standard" # or standard-mux enable_registration = true ``` {% endcode %} {% endtab %} {% tab title="SSV" %} {% code title="config.toml" %} ```toml [[modules]] id = "ETHGAS_COMMIT" type = "commit" ... # payout_address is not required # You need to re-register your validators when updating your payout_address registration_mode = "ssv" enable_registration = true ... # Each payout address in the array corresponds positionally # to the SSV node operator owner at the same index ssv_node_operator_owner_payout_addresses = [ "0x...", "0x..." ] ``` {% endcode %} {% endtab %} {% tab title="Obol" %} {% code title="config.toml" %} ```toml [[modules]] id = "ETHGAS_COMMIT" type = "commit" ... # payout_address is not required # You need to re-register your validators when updating your payout_address registration_mode = "obol" enable_registration = true ... # Each payout address in the array corresponds positionally # to the Obol node operator owner at the same index obol_node_operator_owner_payout_addresses = [ "0x...", "0x..." ] ``` {% endcode %} {% endtab %} {% endtabs %} * You could set a single payout address across all the validator keys. Alternatively, you could also set different payout addresses for different keys. * More details for the config can be found in {% endstep %} {% step %} ### Re-run the ETHGas commit boost module to activate this change. This step is required to register the changes to the ETHGas account. {% endstep %} {% step %} ### Set the ETHGasPool contract as the validator fee recipient This should be configured on the validator client. * **ETHGasPool - Mainnet :** [**0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3**](https://etherscan.io/address/0x3314fb492a5d205a601f2a0521fafbd039502fc3) * **ETHGasPool - Hoodi:** [**0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1**](https://hoodi.etherscan.io/address/0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1) {% endstep %} {% step %} ### Add additional relays Relays can be added to the `config.toml` using the following format: {% tabs %} {% tab title="Mainnet" %} {% code title="config.toml" %} ```toml [[relays]] id = "ethgas" url = "https://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [[relays]] id = "titan" url = "https://0x8c4ed5e24fe5c6ae21018437bde147693f68cda427cd1122cf20819c30eda7ed74f72dece09bb313f2a1855595ab677d@titanrelay.xyz" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 ``` {% endcode %} {% endtab %} {% tab title="Hoodi" %} {% code title="config.toml" %} ```toml [[relays]] id = "ethgas" url = "https://0xb20c3fe59db9c3655088839ef3d972878d182eb745afd8abb1dd2abf6c14f93cd5934ed4446a5fe1ba039e2bc0cf1011@hoodi-relay.ethgas.com" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 [[relays]] id = "flashbots" url = "https://0xafa4c6985aa049fb79dd37010438cfebeb0f2bd42b115b89dd678dab0670c1de38da0c4e9138c9290a398ecd9a0b3110@boost-relay-hoodi.flashbots.net" enable_timing_games = true target_first_request_ms = 0 frequency_get_header_ms = 100 ``` {% endcode %} {% endtab %} {% endtabs %} * The configuration options `enable_timing_games`, `target_first_request_ms` and `frequency_get_header_ms` are set as recommended defaults. If those default settings are not included, it may lead to reduced validator performance. * You do not have to use any ETHGas relays when using the multi-relay configuration, you can use any relay. But we strongly recommend you to use ETHGas relays to boost the return and enable realtime experience for users. * Full list of relays can be found in {% endstep %} {% step %} ### Restart PBS module This step is required to pick up the relay changes. {% endstep %} {% endstepper %} {% hint style="info" %} Multi-relay configuration supports using different ETHGas `payoutAddress` per validator when used with `[[mux]]`. See the [config.example.toml](config.example.tomlhttps://github.com/ethgas-developer/ethgas-preconf-commit-boost-module/blob/main/config.example.mainnet.toml) for more details. {% endhint %} *** There are two types of setups possible with Multi-Relay: ### Multi-Relay with no ETHGas relays selected
In this scenario, blocks proposed by validators registered to the ETHGas platform will still be sold as whole blocks on the ETHGas marketplace, but they will not have markets open for preconfirmations, Realtime blockspace, or any other additional commitments. ✅ Whole Block Market ❌ Preconfirmations Market ❌ Realtime Market *** ### Multi-Relay with multiple relays, including ETHGas relays
When an ETHGas relay is among the available connected relays, all markets will be available to validators registered to ETHGas, including whole blocks, preconfirmations, Realtime, and more. ✅ Whole Block Market ✅ Preconfirmations Market ✅ Realtime Market *** ## 2. ETHGas relays only (Deprecated) {% hint style="warning" %} Using only the ETHGas relay is a deprecated configuration option and should no longer be used. All node operators should migrate to the multi-relay setup shown above. {% endhint %}
If a validator is connected to only ETHGas relays, then a simplified configuration can be used. {% stepper %} {% step %} ### Setup the ETHGas commit-boost module {% embed url="" %} {% endstep %} {% step %} ### Configure ETHGas commit-boost module to use only the ETHGas relay Ensure that only `$$-relay.ethgas.com` relays are set in the `config.toml` file. {% endstep %} {% endstepper %} ## FAQ
Do I have to use ETHGas relays? No. If you configure your validator clients for multi-relay support then you do not need to use any ETHGas relays. However, we recommend that you do use ETHGas relays to maximize your block reward potential.
How can I confirm that my validators are successfully registered to ETHGas? You can use the `GET /api/v1/user/validators` API to view all your registered validators.
What happens if I forget to set the payoutAddress in the ETHGas Commit module? If you do not set a `payoutAddress`, any rewards you accrue will be held in your ETHGas account. This account is linked to the address you used to register your validators to ETHGas. If you later set the `payoutAddress` through the ETHGas Commit module, then any accrued payments will automatically be paid out to that address. Alternatively, you can manually withdraw the rewards from the [ETHGas app](http://app.ethgas.com/) or directly using the [API](https://developers.ethgas.com/?http#post-api-v1-user-funding-withdraw).
Where can I confirm the ETHGas pool contract address? [Technical Integration](/developer-resources/technical-integration)
# 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. # 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](https://developers.ethgas.com). 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](/get-started/node-operators#collateral-and-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. * 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 ### 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. Deposit collateral via 2. get jwt via [`POST /user/login`](https://developers.ethgas.com/#post-api-v1-user-login) and [`POST /user/login/verify`](https://developers.ethgas.com/#post-api-v1-user-login-verify) 3. get builders from [`GET /p/builders`](https://developers.ethgas.com/#get-api-v1-p-builders) delegate to builders via [`POST /user/delegate/builder`](https://developers.ethgas.com/#get-api-v1-builder-delegation) 4. get all active market info via [`GET /p/inclusion-preconf/markets`](https://developers.ethgas.com/#get-api-v1-p-inclusion-preconf-markets) or [`GET /p/wholeblock/markets`](https://developers.ethgas.com/#get-api-v1-p-wholeblock-markets) 5. place order via [`POST /inclusion-preconf/order`](https://developers.ethgas.com/#post-api-v1-inclusion-preconf-order) or [`POST /wholeblock/order`](https://developers.ethgas.com/#post-api-v1-wholeblock-order) 6. get order status via [`GET /user/inclusion-preconf/orders`](https://developers.ethgas.com/#get-api-v1-user-inclusion-preconf-orders) or [`GET /user/wholeblock/orders`](https://developers.ethgas.com/#get-api-v1-user-wholeblock-orders) 7. submit bundle via [`POST /user/bundle/send`](https://developers.ethgas.com/#post-api-v1-user-bundle-send) 8. retrieve all your submitted bundles via [`GET /account/slot/bundles`](https://developers.ethgas.com/#get-api-v1-account-slot-bundles) More details can be found in [API Docs](https://developers.ethgas.com). # 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](https://developers.ethgas.com) # 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. # 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 [mev-boost-relay](https://github.com/flashbots/mev-boost-relay) developed by Flashbots. Check the [Technical Integration](/developer-resources/technical-integration) for relay URLs in different regions. **Other Authorized Relays** 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. # Audit Reports Our collateral contract (EthgasPool) has been audited by Sigma Prime and Node Security. Our Commit Boost module has been audited by Sigma Prime. Link: # 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) * Mainnet : [0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3](https://etherscan.io/address/0x3314fb492a5d205a601f2a0521fafbd039502fc3) * Hoodi: [0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1](https://hoodi.etherscan.io/address/0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1) * Recommend to deposit collateral via [our website](https://app.ethgas.com/my-portfolio/accounts) Relays:
RegionMainnetHoodi
Tokyohttps://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@ap-relay.ethgas.comhttps://0xb20c3fe59db9c3655088839ef3d972878d182eb745afd8abb1dd2abf6c14f93cd5934ed4446a5fe1ba039e2bc0cf1011@hoodi-relay.ethgas.com
Frankfurthttps://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@eu-relay.ethgas.com
Virginiahttps://0x88ef3061f598101ca713d556cf757763d9be93d33c3092d3ab6334a36855b6b4a4020528dd533a62d25ea6648251e62e@us-relay.ethgas.com
### Docs & Source code API docs: [developers.ethgas.com](https://developers.ethgas.com) Validator Registration & Setting (Commit Boost Module): Modified rbuilder: Builder Registration: # Open Gas Eliminate Gas Fees. Drive Onchain Adoption. ### Overview [Open Gas](https://www.ethgas.com/open-gas/) is an industry-wide initiative led by ETHGas to **eliminate gas fees** from the end-user experience and make interacting with Ethereum seamless. Through Open Gas, participating protocols sponsor gas rebates for **specific on-chain actions** such as deposits, staking, or liquidity provision. Users can accumulate rebates across multiple protocols and claim them in a single dashboard. * For users, this reduces the friction of interacting with DeFi. * For protocols, it turns gas from a barrier into a powerful incentive for growth. **Gas rebates are aggregated monthly** and **paid in ETH on Ethereum mainnet**, with support for additional chains such as BNB Chain and Base coming soon. Open Gas is launching with a group of leading Ethereum protocols that are sponsoring gas rebates for their users. **Launch partners include:** * [EigenCloud](/program/open-gas/eigencloud) * [Ether.fi](/program/open-gas/ether.fi) * [ETHGas Foundation](/program/open-gas/ethgas-foundation) * [Pendle](/program/open-gas/pendle) * [f(x) Protocol](/program/open-gas/f-x-protocol) *Click the individual protocol page to view their rebate details.* **Additional partners joining soon:** * Forest * KIRAPAY * Velvet Finance *** ### How Open Gas Works **Open Gas works like a monthly cashback program for gas fees.** 1. Explore participating protocols and the actions eligible for gas rebates. 2. Interact with those protocols on Ethereum (e.g. deposit, stake, or delegate). 3. ETHGas tracks eligible transactions across all partner protocols. 4. On the next claim cycle, users can batch-claim their gas rebates in one gasless transaction. 5. Withdraw claimed rebates to your wallet at any time. This allows users to interact with multiple protocols while earning back a portion of the gas they spent.
*** ### Benefits for DeFi Users **Lower the cost of participating in DeFi.** Open Gas rewards users for interacting with protocols by returning a portion of the gas spent on eligible actions. Key benefits: * Earn ETH gas rebates from multiple protocols * Batch-claim rewards in a single gasless transaction * Discover new DeFi opportunities through participating protocols * Reduce the friction of interacting on Ethereum Gas rebates accumulate across protocols and can be claimed from the Open Gas dashboard.\ \ **Claim Your Gas Rebates** If you’ve interacted with a participating protocol, you may already have rebates waiting to be claimed. Check your eligibility and claim your rewards from the Open Gas dashboard. Claim Rebates *** ### Benefits for Protocol Partners **Turn gas fees into a growth engine.** Gas costs are one of the biggest sources of friction for new users entering DeFi. Open Gas allows protocols to subsidize specific user actions and make their onboarding experience more attractive. With Open Gas, protocols can: * Incentivize specific actions such as deposits or liquidity provision * Attract new users through gas rebates * Improve user retention and activity * Gain visibility through the Open Gas partner ecosystem ETHGas handles the infrastructure including rebate tracking, dashboards, and claims — allowing protocols to participate with **zero technical integration required**.\ \ **Design Your Gas Rebates** Protocols can easily launch a gas rebate program using ETHGas’s self-service estimator. Simply input your protocol’s contract addresses to analyze user activity and identify which contract functions you would like to subsidize. From there you can design a rebate structure aligned with your growth goals, such as encouraging users to: * deposit assets * add liquidity * stake or delegate * interact with specific pools ETHGas will automatically track eligible transactions and distribute rebates to users. Start designing your rebates here: Design Rebates *** ### The Path to a Gasless Future Open Gas is designed as a multi-phase initiative to remove gas fees from the user experience while creating sustainable incentives for protocols. **Phase 1 — Protocol Sponsored Gas**\ Protocols temporarily subsidize gas fees for key user actions such as deposits or staking. **Phase 2 — Protocol-Native Gas**\ Protocols integrate gas costs into their existing fee models, allowing gas to be offset by protocol revenue. **Phase 3 — Fully Automated Gas Markets**\ ETHGas automates the entire system through on-chain infrastructure, enabling gasless transactions and realtime blockspace markets.
# EigenCloud Open Gas Rebate Details for EigenCloud #### What is EigenCloud? EigenCloud is the world’s first verifiable cloud, enabling developers to build applications, AI products, and AI agents that are provably trustworthy. Built on top of the EigenLayer restaking protocol, EigenCloud extends Ethereum’s security across the digital and even physical world, allowing developers to verify any input, event, or computation using cryptoeconomic guarantees. #### What Actions Qualify for Gas Rebates? Open Gas rebates gas fees for two core EigenLayer actions: depositing assets into restaking strategies and delegating to an operator. Click [here](https://docs.eigencloud.xyz/eigenlayer/restakers/concepts/overview) for more information on staking overview. **Eligible Contracts & Functions for Feb & Mar 2026:**
ContractAddressFunctionWhat it doesWhere to access
StrategyManager

0x858646372CC42E1A627fcE94aa7A7033e7CF075A


  • depositIntoStrategy
Deposit LSTs (e.g. stETH, rETH) into an EigenLayer restaking strategyhttps://app.eigenlayer.xyz/token
DelegationManager0x39053D51B77DC0d36036Fc1fCc8Cb819df8Ef37A
  • delegateTo
Delegate your restaked assets to an EigenLayer operator to earn rewardshttps://app.eigenlayer.xyz/token
**How to Claim Your Rebate:** Head to the [Open Gas Claim Dashboard](https://ethgas.com/open-gas/claim) → Connect your wallet → Claim your ETH gas rebate.
# Ether.fi Open Gas Rebate Details for ether.fi #### What is Ether.fi? ether.fi is a non-custodial liquid staking and restaking protocol that lets users stake ETH and receive liquid tokens like eETH and weETH. Its restaking layer integrates directly with EigenLayer, allowing users to compound staking and restaking rewards while keeping control of their validator keys. #### What Actions Qualify for Gas Rebates? Open Gas rebates gas fees for users who * deposit ETH or stETH into Ether.fi's liquid restaking contracts to receive weETH * deposit into Ether.fi's liquid ETH Yield vault eETH is ether.fi’s flagship Ethereum-backed liquid restaking token for native staking and multichain bridging, designed to simplify yield optimization and expand DeFi utility. Click [here](https://etherfi.gitbook.io/etherfi/staking/eeth) to learn more about the benefits of holding eETH/weETH. **Eligible Contracts & Functions Feb & Mar 2026:**
ContractAddressFunctionDescriptionWhere to access
DepositAdapter0xcfC6d9Bd7411962Bfe7145451A7EF71A24b6A7A2
  • depositETHForWeETH
  • depositStETHForWeETHWithPermit
Deposit ETH/stETH to receive weETHhttps://www.ether.fi/app/weeth
LayerZeroTellerWithRateLimiting0x9AA79C84b79816ab920bBcE20f8f74557B514734
  • deposit
Deposit into Liquid ETH Yieldhttps://www.ether.fi/app/cash/earn/liquid/eth-yield
**How to Claim Your Rebate**\ Head to the[ Open Gas Claim Dashboard](https://ethgas.com/open-gas/claim) → Connect your wallet → Claim your ETH gas rebate.
# ETHGas Foundation Open Gas Rebate Details for ETHGas Foundation #### What is ETHGas Foundation? ETHGas Foundation empowers the Ethereum community to govern and grow the real-time blockspace economy. By staking $GWEI, holders receive veGWEI (Vote-Escrowed GWEI) — granting governance power to propose and vote on critical ecosystem parameters, treasury allocations, and protocol direction. veGWEI holders are the long-term architects of Realtime Ethereum, anchoring the protocol's mission to eliminate gas friction for all users. #### What Actions Qualify for Gas Rebates? Open Gas rebates gas fees for users who * stake $GWEI to receive veGWEI and participate in protocol governance * increase stake on an existing veGWEI position * extend the term of an active $GWEI stake * enable auto-claim & stake to automatically compound staking rewards To qualify, a **minimum stake of 1,000 $GWEI** **and a lock term of at least 1 month** are required. Click [here](https://docs.ethgas.com/foundation/staking-and-vegwei) to learn more about staking $GWEI and how veGWEI works. **Eligible Contracts & Functions:**
ContractAddressFunctionDescriptionWhere to access
Voting Escrow0x13aB49189EBC2287E941a82D9Af154130f96Eb21
  • create_lock
  • increase_amount
  • increase_unlock_time

  • Stake $GWEI, increase stake, or extend staking term

    • Minimum stake of 1,000 $GWEI and a lock term of at least 1 month are required.
https://ethgasfoundation.org/staking/
Staking Reward Distribution0x2Bd8849CCdf22B53eE10C83529B9863Ff9af2c71
  • claim_and_stake
  • set_auto_claim

  • Claim & stake your TGE Airdrop

    • Minimum stake of 1,000 $GWEI

  • Enable auto-claim & stake for your position
https://ethgasfoundation.org/staking/
#### How to Claim Your Rebate Head to the [Open Gas Claim Dashboard](https://app.ethgas.com) → Connect your wallet → Claim your ETH gas rebate. # Pendle Open Gas Rebate Details for Pendle #### What is Pendle? Pendle enables users to tokenize yield by splitting yield-bearing assets into principal and yield components, allowing them to fix rates, speculate on yield, or provide liquidity to time-decaying markets. Its custom AMM is purpose-built for yield assets, supporting sophisticated strategies that go far beyond simple swaps or passive farming. #### What Actions Qualify for Gas Rebates? Open Gas rebates gas fees for users who add liquidity to Pendle's asset pools. Providing liquidity on Pendle can be as simple as just a one-click transaction, allowing you to swap any assets you hold (e.g. USDC) into Pendle LP positions (e.g. Pendle LP-stETH). Similarly, you can even use other Pendle assets like PT or YT to deposit into a Pendle LP. Click [here](https://docs.pendle.finance/pendle-academy/optimizing-yields-with-pendle/chapter-3.2-more-yield-via-liquidity-provision#how-to-start-earning) for more information on how to start earning with Pendle pools. **Eligible Contracts & Functions Feb & Mar 2026:** | **Contract** | **Address** | **Function** | **Description** | **Where to access** | | -------------- | ------------------------------------------ | ------------------------------ | ----------------------------- | -------------------------------------------------------- | | PendleRouterV4 | 0x888888888889758F76e7103c6CbF23ABbF58F946 |
  • addLiquidity
| Add liquidity to Pendle pools | | **How to Claim Your Rebate:**\ Head to the [Open Gas Claim Dashboard](https://ethgas.com/open-gas/claim) → Connect your wallet → Claim your ETH gas rebate. # f(x) Protocol Open Gas Rebate Details for f(x) Protocol #### What is f(x) Protocol? f(x) Protocol is a decentralized system that enables users to mint a fully collateralized stable asset, fxUSD, and gain leveraged long or short exposure to ETH and WBTC through structured onchain positions. #### What Actions Qualify for Gas Rebates? Open Gas rebates gas fees for users who deposit assets or stake within f(x) Protocol's core pools and savings product. Click [here](https://fxprotocol.gitbook.io/fx-docs/f-x-protocol-mechanisms/key-functions-of-f-x) for more information on f(x) protocol’s product mechanisms. **Eligible Contracts & Functions for Feb & Mar 2026:**
ContractAddressFunctionWhat it doesWhere to access
AaveFundingPoolETH Pool0x6Ecfa38FeE8a5277B91eFdA204c235814F0122E8
  • deposit
Deposit ETH into the Aave-funded ETH pool to earn yieldhttps://fx.aladdin.club/v2/trade
wBTC Pool0xAB709e26Fa6B0A30c119D8c55B887DeD24952473
  • deposit
Deposit wBTC into the f(x) wBTC poolhttps://fx.aladdin.club/v2/trade
Short wstETH Pool0x25707b9e6690B52C60aE6744d711cf9C1dFC1876
  • deposit
Deposit into the short wstETH leveraged poolhttps://fx.aladdin.club/v2/trade
Short wBTC Pool0xA0cC8162c523998856D59065fAa254F87D20A5b0
  • deposit
Deposit into the short wBTC leveraged poolhttps://fx.aladdin.club/v2/trade
fxUSD Base Pool Gauge

0xEd92dDe3214c24Ae04F5f96927E3bE8f8DbC3289


  • deposit
Stake LP tokens into the fxUSD base pool gauge to earn FXN rewardshttps://fx.aladdin.club/v2/earn
fxUSD Base Pool FXN0x215D87bd3c7482E2348338815E059DE07Daf798A
  • deposit
Deposit into the fxUSD FXN rewards poolhttps://fx.aladdin.club/v2/earn
FxUSDBasePool0x65C9A641afCEB9C0E6034e558A319488FA0FA3be
  • mint / deposit
Mint fxUSD or deposit into the base stable poolhttps://fx.aladdin.club/v2/fxmint
fxSAVE0x7743e50F534a7f9F1791DdE7dCD89F7783Eefc39
  • deposit
Deposit USDC or fxUSD into fxSAVE to earn passive yieldhttps://fx.aladdin.club/v2/fxsave
**How to Claim Your Rebate**\ Head to the[ Open Gas Claim Dashboard](https://ethgas.com/open-gas/claim) → Connect your wallet → Claim your ETH gas rebate.
# Community (Beans & Quests) 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. {% tabs %} {% tab title="Welcome to Season 2" %} Gassy Jack has left the atmosphere piloting the Open Gas Starship. Join Captain Jack on his interstellar journey in the Gasless Galaxy to liberate the Gassy Planets while claiming rebates from our partner protocols. Your adventure begins now. Are you ready? #LFGGasless
{% endtab %} {% tab title="Chapter 1" %} **The First Fleet - First Rebate**\ Captain Jack has assembled the First Fleet to tackle the Gas Giants—massive planets choked by toxic fees. The Pilot Partners have deployed their scrubbers. Dock your wallet, claim your relief, and help us clear the smog. {% endtab %} {% endtabs %} ## **Community FAQ** Got questions? We've got answers. General Onboarding Beans & Quests Wallet Connection S2CH1: First Rebate Referral Technical & Support ### 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. * **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!
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!
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 1. For join Discord, go to the [**#🫛┃start-earning-beans**](https://discord.com/channels/1202457552479195176/1405122220493377607) **channel** and **click \[Start Verification] button** 2. For join Telegram, go to the [**👮Verification**](https://t.me/c/ethgaspublic/6395) **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.
Why do I see separate Bean balances for Season 1 and Season 2? ETHGas uses a **multi‑season rewards system**. Your Beans are tracked separately for each season so the community can participate in multiple campaigns over time. For example: * Season 1 Beans came from the original Gasless Future quests for referrals and gas report/gas ID * Season 2 Beans are earned through Open Gas missions and rebate activities Your Season 1 Beans remain part of your profile and are not lost. In fact, Season 1 participation unlocks a **Legacy Bonus**, which can provide a multiplier for your final Season 2 rewards. This rewards early community members who helped grow the ETHGas ecosystem from the beginning.
### 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. * **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!
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 3. Click "Link Primary Wallet" and follow prompts Note: Update your wallet to the latest version first to resolve common glitches
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 * **Different Mobile Browsers**: * For iOS, Safari works smoother than chrome * For Android, enable pop-ups and clear cache for improved compatibility
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 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
### S2CH1: First Rebate
What is Open Gas? Open Gas is ETHGas’s gas rebate system that lets users reclaim part of the gas fees they spend when interacting with partner protocols. When you use participating protocols, gas rebates accumulate for your wallet. 1. You can then claim those rebates through the Open Gas dashboard in a single transaction every month. The rebates claiming does not cost any gas and only requires signing a message. 2. You may then withdraw the claimed rebates to your wallet after accumulating for a period of time. The claimed rebates will be sent to your wallet in wETH. Think of it like **cashback for your gas fees**, powered by ETHGas and sponsored by participating protocols.
How to claim your gas rebates with Open Gas? Follow these 4 steps to claim your gas rebates from eligible transactions made in **February 2026 with participating protocols.** 1. **Connect Your Wallet:** Visit the Open Gas Claim Dashboard and connect the wallet you used to interact with partner protocols. Open Gas will automatically detect if your wallet is eligible for gas rebates. 2. **Check Your Available Rebates:** View the total gas rebates available across participating protocols. Your dashboard aggregates rebates from multiple protocols into one claimable balance. 3. **Claim with One Gasless Signature:** Click “Claim now” to initiate a gasless signature and collect all eligible rebates in one step. The rebates will be transferred to your Open Gas Balance. 4. **Withdraw Your Rewards:** You can withdraw them to your wallet anytime and receive wETH. Note: withdrawing requires a standard Ethereum transaction.
***Don’t See Any Rebates Yet?*** * Explore the list of participating protocols on the dashboard to see how to qualify for next month’s rebates. * You can also request your favorite protocol to sponsor gas rebates through the [ETHGas rebate request form.](https://forms.gle/vCBaEUP54L2pWfoS7) Return to the ETHGas Community Quests page to verify your quests and earn Season 2 Beans.
Why are first rebates based on February 2026 transactions? Open Gas rebates are calculated in monthly cycles. For this launch, the available rebates reflect eligible transactions made in **February 2026** with participating partner protocols. Transactions made after this month will be included in upcoming rebate cycles, which are planned to occur on the 2nd Thursday of the next month.
What does the “Connect your wallet with Open Gas” quest require? To complete this quest: 1. Link your wallet(s) to your ETHGas community profile. 2. Visit the Open Gas Claim Dashboard. 3. Connect the same wallet(s) to the Open Gas dashboard. 4. Return to the quest and verify completion. Once verified, you will receive Beans for completing the quest. \ ![](/files/qikFfsynVZnKMXvFGHEP)
How do I complete the “Claim your first gas rebate” quest? 1. Go to the Open Gas Claim Dashboard. 2. Connect your wallet(s) 3. Check which partner protocols have rebates available for your wallet. 4. Claim your eligible rebate. 5. Return to the quest page and verify completion. 1. Note: If you have **multiple wallets eligible for rebates,** make sure your have **linked all** eligible wallets to your community profile before verifying for quest completion. Once verified, you will receive Beans for completing the quest. You will receive up to a max of 400 Beans for the 4 launching protocol partners if you have 4 eligible rebates from all partners. e.g. If Jack has transacted with both Ether.fi and Pendle with 2 wallets. * Jack has transacted with Ether.fi last month with wallet A and qualified for the rebate conditions set by Ether.fi and successfully claimed rebates from Ether.fi. * Jack has another wallet B that he used to transact with Pendle, if Jack forgets to link wallet B to his community profile.
Why isn’t my quest verifying? If your quest does not verify immediately, try the following: • Make sure you used the same wallet(s) linked to your community profile\ • Confirm the wallet is connected to the Open Gas dashboard\ • Wait a few minutes and try verifying again If the issue persists, reach out in the ETHGas Discord or Telegram community for support.
### 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.

Connect X on Dashboard page to see your unique referral link

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. ![](/files/IuMJU6mYSykrAEo6YH2e) ![](/files/WBH8jnZz4KpLSjE28gyx)
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!
### **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. * **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](#where-can-i-get-help-or-report-a-problem)
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? ![](/files/Lkt5od13xHXKWlwKRtsx) 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. * **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"](https://discord.com/channels/1202457552479195176/1369922540935581779)\*\* on our Discord to open a ticket with you and your friend’s X handle.
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 [**#helpdesk channel under "LOUNGE"**](https://discord.com/channels/1202457552479195176/1298196433840771124) 2. 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"**](https://discord.com/channels/1202457552479195176/1369922540935581779) 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.
# Season 1 Archive 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. {% tabs %} {% tab title="Welcome to Season 1" %} 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
{% endtab %} {% tab title="Chapter 1" %} **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.
{% endtab %} {% tab title="Chapter 2" %} **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. {% endtab %} {% tab title="Chapter 3" %} **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. {% endtab %} {% tab title="Chapter 4" %} **Genesis Harvest: $GWEI** Gassy Jack has found the hidden Treasure inside the Sky-Castle, but it's locked tight. The time has come to forge the Key. Complete specific quests to craft the tool that unlocks your rewards. {% endtab %} {% endtabs %} ## **Season 1 FAQ** Got questions? We've got answers. S1CH1: ReferralS1CH2: Gas Report & Gas ID S1CH3: Open GasS1CH4: $GWEI
Technical & SupportFoundation (TGE Timeline & Community Airdrop) ### S1CH1: 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.

Connect X on Dashboard page to see your unique referral link

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. ![](/files/IuMJU6mYSykrAEo6YH2e) ![](/files/WBH8jnZz4KpLSjE28gyx)
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). * 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!
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.
### S1CH2: Gas Report & Gas ID
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: [https://www.ethgas.com/community/gas-report/](https://www.ethgas.com/community/gas-report/?utm_source=blog\&utm_medium=organic\&utm_campaign=chapter2_live) **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 **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. :information\_source: *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)**
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) * 🧒 **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**.](#does-my-recent-wallet-activity-affect-my-bonus-bean-or-gas-report-generation) We want to celebrate the heroes who are part of Ethereum's story *today*!
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**. * **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.
Does my recent wallet activity affect my Bonus Bean or Gassy Jack Grade? 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 **Bonus Beans calculation** includes a **Freshness Multiplier** that represents the **efficiency** of your qualifying historical gas spent based on your gas spent date. * **Gas spent within 3 months:** 🟢 **100% Efficiency** (Maximum Reward) * **Gas spent within 6 months:** 🟡 **95% Efficiency** * **Gas spent within 1 year:** 🟠 **85% Efficiency** * **Gas spent >1 year:** 🔴 **70% Efficiency** `(Gas_Spent_0-3m * 1.0) + (Gas_Spent_3-6m * 0.95) + (Gas_Spent_6-12m * 0.85) + (Gas_Spent_12m+ * 0.70)` **= Total Qualifying Gas Spend** *Note:* The "recency" is calculated at the moment of **Report Generation**. If a user waits three months to generate their report, transactions that were "fresh" today might slide into the "3-6 month" bucket, lowering their qualifying gas spend for Bonus Beans calculation. 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 Gas Report referral link too (e.g. “ethgas.com/community**/gas-report?**referral=...”) :warning: **NOTE:** Using the onboarding referral link would **INVALIDATE** the quest during verification, please make sure you're using the auto-generated `/gas-report` link. The gas report referral link will be able to attribute your referrals as well. See reference screenshot below:
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” :arrows\_counterclockwise:\ 3\. Add all your wallets\ 4\. Claim your Bonus Beans :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: **one report per month**.
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:** 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.
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.
Why does my "Historical Gas Spent" look different or lower than before? We upgraded our data indexing engine in Nov 2025 to ensure your **Gas ID** reflects the most precise financial data possible. If your gas spend number has changed or looks different from other explorers (like Etherscan), it is due to three specific factors regarding how we calculate your "True Cost." **1. The "True Cost" Methodology (vs. Etherscan)**\ Many explorers, including Etherscan, often calculate the gas fees for *incoming* transactions (transfers sent *to* you) as part of your history. However, **you did not pay those fees**—the sender did. * **Our Approach:** To give you an accurate financial picture, ETHGas filters out transactions where you were the receiver. We only count gas fees that actually left your wallet. This ensures your Gas ID represents your true on-chain expenditure. **2. Database Resync & Accuracy Update (November Update)**\ During the initial beta launch of Gas ID, we identified a discrepancy in how certain complex transactions were indexed. * **The Fix:** In November, we completed a full database resync. We re-indexed historical data to correct these discrepancies. The number you see now is the verified, accurate figure. **3. The Data Snapshot Window**\ We do not track gas spend from the very first block of Ethereum (Genesis). Our data tracking is specific to the modern Ethereum era. * **Start Date:** We begin tracking from the **Beacon Chain launch on Dec 1, 2020.** * **End Date:** Data is currently updated through the **end of the previous month**. * *Note: Recent activity from the current month may not yet be reflected in your total lifetime spend.*
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) 2. **Key influential voices** across the Ethereum ecosystem. To see if a Fused Avatar is waiting for you, simply generate your Gas ID.
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.
### S1CH3: 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. 3. **Influence:** You are helping build the "Gasless User Layer" by proving to protocols that users demand better gas economics.
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 3. Tag your favourite protocols that should join the Open Gas before posting 4. Copy your quote-tweet link and paste it into the "Post URL" field to verify for quest completion
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 `?s=12` * **Is your account public?** We cannot verify posts from private X accounts.
### S1CH4: $GWEI
What criteria determine my upcoming Genesis Harvest rewards? Please refer to the foundation FAQ [here](https://docs.ethgas.com/foundation/faq#what-criteria-determine-my-airdrop-eligibility) regarding community airdrop.
What is $GWEI? Please refer to the foundation FAQ [here](https://docs.ethgas.com/foundation/tokenomics) regarding $GWEI tokenomics.
### **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. * **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](#where-can-i-get-help-or-report-a-problem)
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=...` 2. for "Share your Gas ID on X", your post must contain your referral link e.g. `ethgas.com/community/gas-report?referral=...`
2. **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
3. **Check Privacy:** Make sure your X (Twitter) profile is public and active. Our bot can't see posts from private nor banned accounts. 4. **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.
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? ![](/files/Lkt5od13xHXKWlwKRtsx) 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. * **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"](https://discord.com/channels/1202457552479195176/1369922540935581779)\*\* on our Discord to open a ticket with you and your friend’s X handle.
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 [**#helpdesk channel under "LOUNGE"**](https://discord.com/channels/1202457552479195176/1298196433840771124) 2. 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"**](https://discord.com/channels/1202457552479195176/1369922540935581779) 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.
# ETHGas Foundation Governing Realtime Ethereum ## Our Vision A future where ETHGas Foundation leads a decentralized, community-owned foundation that makes Ethereum's infrastructure as efficient and accessible as traditional finance, with $GWEI at the heart of instant, frictionless transactions. ## Our Mission ETHGas Foundation empowers the Ethereum community to govern and grow the real-time blockspace economy. We steward the $GWEI token to drive sustainable value, fund ecosystem innovations, and eliminate gas friction for all users. ## Who Are Gas Markets For? ETHGas touches everyone on the blockchain whether they choose to interact directly with us or not. From: * The Validators who secure the network and earn yields, to * The Users and traders who pay for transactions, to * The Protocols that require gas for core functionality, to * The Developers that create these dAPPs, to * The Wallets that enable Users to interface with dApps, * And many more... As the fabric that powers blockchains, and with billions of dollars flowing through the pipeline each year, it's important that Gas, and ETHGas by extension create a system that enables users to participate in both the product roadmap and economic design. At the core of blockchains, Validators want higher yields, and Users want lower fees. Protocols, Developers, and Wallets, altogether would like to remove Gas from the user experience (e.g. account abstraction). While some of these interests are aligned, some aren't - how do we pay validators more with traders paying less? It's nuanced. An array of products addresses this to some degree on the micro level - while we still have Regular Gas, we now have High Octane (preconfs, state guarantees), as well as Bulk Purchases (blocks). Such product segmentation is driven from the demand-side of the market (i.e. users of gas), vs the supply side (i.e. Validators) with products split by compute, storage, or other. On the macro level, our token is designed to embody these more nuanced, multifaceted or multidimensional relationships aligning the future existence of both ETHGas with that of its users. The ETHGas token $GWEI is a Governance token that enables the community to participate in ETHGas' future product roadmap and tailor the economic incentives to each party accordingly. For more on the product roadmap, see the Vision section. For more on how tokens are used to align incentives, read on. # $GWEI Tokenomics The Fuel for Realtime Ethereum $GWEI serves as the **governance token** for the ETHGas Foundation. It is the primary tool allowing the community to steer the commoditization of blockspace and the Realtime Ethereum engine. ### Token Identity * **Ticker:** $GWEI * **Type:** ERC-20 * Ethereum Mainnet: [`0x2798b1cC5A993085E8A9D46e80499F1B63f42204`](https://etherscan.io/address/0x2798b1cC5A993085E8A9D46e80499F1B63f42204) * BSC: [`0x30117E4bC17d7B044194b76A38365C53b72F7D49`](https://bscscan.com/token/0x30117e4bc17d7b044194b76a38365c53b72f7d49) * **Total Supply:** 10,000,000,000 (10 Billion) * **Token Generation Event:** Jan 21, 2026 ### Token Distribution We have designed a sustainable distribution model with a 10-year horizon for ecosystem growth. The majority of the supply is dedicated to the ecosystem and the long-term health of the protocol.
{% hint style="info" %} **Important Distinction:** The "Community" vesting schedule above refers to the long-term emissions of the total supply allocation. **The Community Airdrop is separate and is NOT subject to the 4-year linear vesting.** {% endhint %} ### Governance & Decentralized Stewardship The $GWEI token is the steering wheel for the ETHGas ecosystem. With billions of dollars flowing through Ethereum gas markets annually, $GWEI transitions holders from passive users into active stewards to participate in the future of the protocol through proposal creation, voting and delegated decision-making. Its primary function is to enable decentralized stewardship of the protocol. **1. On-Chain Decision Making** Holders who stake $GWEI receive $veGWEI (voting escrow), granting them the right to propose and vote on critical changes, which may include: * **Protocol Parameters:** Adjusting fees, incentives and collateral factors to keep the market efficient. * **Supply Dynamics:** Managing how protocol fees are utilized to maintain ecosystem health (e.g., offsetting emissions or allocating treasury tokens). * **Smart Contract Upgrades:** Approving migrations or new integrations to ensure the protocol remains the standard for Realtime Ethereum. **2. Delegation & Liquid Democracy** To enhance scalability and decision quality, $veGWEI supports vote delegation. Token holders can delegate their voting power to trusted individuals, organizations, or professional delegates, while retaining full ownership of their tokens. This liquid democracy model encourages broad participation without requiring every holder to vote on every proposal. **3. Commitment-Based Weighting** Governance influence is aligned with long-term ecosystem health. Voting power is amplified by the duration of your stake. Longer lock durations or higher stake amounts confer proportionately greater voting power. This protects the protocol from short-term opportunists and rewards true long-term believers. **4. Treasury Stewardship** The $veGWEI community governs the protocol treasury. Through proposals, holders decide how to allocate resources for ecosystem initiatives, developer grants, and strategic partnerships. This community-driven resource allocation enables sustainable growth while maintaining decentralized control. **5. Emergency & Upgrade Authority** $veGWEI governance serves as the final authority over protocol upgrades, parameter changes, and emergency actions. While operational responsibilities may be delegated to specialized committees or smart contracts, ultimate decision-making power rests with the governance process. *** |

⚠️ IMPORTANT: SCOPE OF RIGHTS

$GWEI serves as a governance token only. It is not a utility token and is not required to access or use ETHGas or any protocol products/services. $GWEI (and any associated governance rights such as $veGWEI) is a coordination mechanism for proposal submission, voting, and delegated decision-making. $GWEI does not represent or confer any equity, ownership, or membership interest in any entity, nor any right to receive profits, dividends, revenue, fees, buybacks, distributions, or any other economic return from ETHGas, the protocol, the foundation, or any affiliated party. Any references to incentives, “yield,” rewards, emissions, or treasury allocations describe protocol-native incentive mechanisms that may change by governance and are not guaranteed. Holding $GWEI is a commitment to operating and governing the protocol and is not a passive investment.

| | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
# Staking & veGWEI Long-Term Alignment via Vote Escrow ETHGas utilizes a **Vote-Escrowed (ve) model** to align long-term incentives. This system ensures that those who commit to the future of the protocol have the greatest say in its direction. By staking $GWEI, holders receive veGWEI (vote-escrowed GWEI). This action represents a long-term commitment to the ecosystem's stability. veGWEI holders are not just passive participants; they are the architects of the protocol, possessing the governance power to propose and vote on critical ecosystem parameters and treasury allocations. As we transition to a Realtime Ethereum and a Gasless Future, veGWEI holders anchor the economy. They ensure the protocol remains aligned with its mission to elevate Ethereum for the next generation of DeFi. Stake $GWEI ### The Staking Mechanism: How veGWEI Works To participate in governance and earn yield, holders lock their $GWEI to receive veGWEI (Vote-Escrowed GWEI). This mechanism transforms you from a token holder into a protocol architect. **1. Select Your Commitment** You can lock your $GWEI for a duration of your choice, ranging from 1 week to 4 years. * Note: veGWEI is non-transferable. It is tied to your wallet as a representation of your reputation and commitment. **2. The Time-Weighted Multiplier** The veGWEI utilizes a linear decay model where Time = Power. * **The Multiplier:** A 4-year lock grants significantly more voting weight (and potential yield) than a 1-week lock. * **The Logic:** This ensures that the loudest voices in governance belong to long-term guardians, not short-term speculators. ### Why Stake? Staking is the operational engine of the ETHGas Foundation. By staking your tokens, you transition from a beneficiary to a builder, actively participating in: * **Decentralized Stewardship:** You act as a guardian of the ecosystem, holding voting weight to approve protocol parameters and prevent malicious updates. * **Protocol Calibration:** You signal priority for the Realtime Ethereum economy, ensuring the protocol evolves based on user consensus rather than centralized planning. * **Aligned Incentives:** By committing your tokens to the vote-escrow contract, you align your long-term interests with the protocol. This commitment grants you enhanced Governance Power, allowing you to participate in the distribution of protocol emissions directed toward active participants. Dive in the full staking FAQ [here](https://docs.ethgas.com/foundation/foundation-faq#staking). # Foundation FAQ Got questions? We've got answers. ### GeneralTGE TimelineCommunity Airdrop: Season 1EligibilityClaiming & Auto-StakeStaking ### General
What are the official $GWEI and veGWEI Token Contract Address? **Official $GWEI Contract Address:** * Ethereum Mainnet: [`0x2798b1cC5A993085E8A9D46e80499F1B63f42204`](https://etherscan.io/address/0x2798b1cC5A993085E8A9D46e80499F1B63f42204) * BSC: [`0x30117E4bC17d7B044194b76A38365C53b72F7D49`](https://bscscan.com/token/0x30117e4bc17d7b044194b76a38365c53b72f7d49) \ **Official veGWEI Contract Address:** * Ethereum Mainnet: [`0x13aB49189EBC2287E941a82D9Af154130f96Eb21`](https://etherscan.io/address/0x13aB49189EBC2287E941a82D9Af154130f96Eb21) Our token contract is audited by Sigma Prime and you may refer to the security report [here](https://github.com/ethgas-developer/ethgas-audit/blob/main/Sigma_Prime_Ethgas_ERC20_Security_Assessment_Report_v2_0.pdf). {% hint style="danger" %} **SECURITY WARNING:** Please verify token address against our official documentation. Do NOT interact with any other contract claiming to be $GWEI. {% endhint %}
What is the difference between $GWEI and veGWEI? **$GWEI:** The liquid token. You can hold it or trade it. **$veGWEI (Vote-Escrowed):** The governance right you get when you stake $GWEI. You cannot trade $veGWEI, but it gives you voting power and staking rewards.
​​Is $GWEI a security? No. $GWEI is a governance token used strictly for decentralized decision-making within the ETHGas protocol. It conveys no ownership rights, revenue rights, or dividends. Learn more about $GWEI tokenomics and governance [here](/foundation/tokenomics). {% hint style="warning" %} **LEGAL DISCALIMER:** $GWEI serves as a governance token only. It is not a utility token and is not required to access or use ETHGas or any protocol products/services. $GWEI (and any associated governance rights such as $veGWEI) is a coordination mechanism for proposal submission, voting, and delegated decision-making. $GWEI does not represent or confer any equity, ownership, or membership interest in any entity, nor any right to receive profits, dividends, revenue, fees, buybacks, distributions, or any other economic return from ETHGas, the protocol, the foundation, or any affiliated party. Any references to incentives, “yield,” rewards, emissions, or treasury allocations describe protocol-native incentive mechanisms that may change by governance and are not guaranteed. Holding $GWEI is a commitment to operating and governing the protocol and is not a passive investment. {% endhint %}
### Token Generation Event (TGE) Timeline
When is the official TGE (Token Generation Event)? The official launch date of our Token Generate Event is **Jan 21, 2026**. Here is the timeline leading up to TGE: * **Jan 13:** Official TGE and community airdrop announcement * **Jan 19 (00:00 UTC):** Final Airdrop Snapshot of your Beans and "Gasless Future Community Program" quests must be done by this time * **Jan 20 (13:00 UTC):** Season 1 community airdrop eligiblity checker * **Jan 21 (13:00 UTC):** TGE day - season 1 community airdrop claiming and staking Stay tuned for our TGE announcement by [following ETHGas Foundation on X.](https://x.com/intent/follow?screen_name=ethgasfndn) {% hint style="success" %} Bookmark our Foundation website for eligibility check: {% endhint %}
Has the Season 1 community airdrop snapshot been taken yet? The snapshot of the [“Gasless Future Community Program”](https://www.ethgas.com/community/overview/) and your accrued "Beans" were taken on January 19th at 00:00 UTC. Any quest activity after this date will not count toward the season 1 community airdrop.
### Staking
How do I stake $GWEI? 1. Connect your wallet to the official Staking Page (). 1. We strongly recommend you use Desktop for a smoother UX. 2. Scroll down to the Stake Panel to enter "Stake Amount" 1. If you don't have any $GWEI, click the "Get GWEI" button to see available exchanges 2. If your $GWEI is on BNB, you will need to [bridge your tokens to Ethereum Mainnet first](#i-have-usdgwei-on-bsc-binance-smart-chain-.-how-do-i-stake) 3. Select your "Unlock Date" 1. You must stake for a minimum of 7 days and your unlock date will be extended until end of your last active staking cycle. 2. Please note that the staking cycle resets every Thursday at 00:00 UTC so you may only choose an unlock date on Thursdays. 4. Review the staking details before clicking \[Approve & Stake]. Check your wallet to sign the transaction(s). 1. You will need to approve the spending cap of $GWEI and sign twice for `Approve` and `Stake` for your first staking transaction. 5. You will see the success page with "Tokens Secured!". 6. Click \[Back to Staking Dashboard] to see your stake & governance and manage your staking term. Enable “Auto-Claim & Stake” to compound your rewards.
What is veGWEI and how does it work? veGWEI stands for **vote-escrowed GWEI.** It is a non-transferable token that you receive when you stake your GWEI tokens. It represents * your governance power * share of the weekly rewards pool
How do rewards work? Rewards are **distributed weekly (Thursdays 00:00 UTC).** The more veGWEI you hold, the larger your governance power and share of the rewards pool.
How can I boost my rewards? You may boost your reward by improving your veGWEI and governance power of your current stake by 1. **Enable “Auto-Claim & Stake”** to auto-compound your weekly rewards 2. **Increase** your stake amount 3. **Extend** your staking term In our model, **Time = Power.** * Lock for 4 years = Max Multiplier. * Longer locks grant you significantly more veGWEI (voting power) and yield share than shorter locks. This aligns with standard DeFi vote-escrow models (similar to Curve)
Can I increase my staking amount? Yes, you can increase your staking amount at any time. This will add to your existing stake and increase your veGWEI and governance power.
Can I extend my staking term? Yes, you can extend your staking term to increase your veGWEI balance and voting power. Extending the term will **lock your existing stake for a longer period.**
Can I have multiple staking terms? No, currently you cannot have multiple staking terms. Once you have an active stake, you can only * increase the stake amount and/or * extend the whole staking term
Can I unstake early? No. The veToken model is a commitment. If you lock for 1 year, your tokens are escrowed for 1 year. You cannot "rage quit" early. This protects the protocol from volatility and rewards long-term believers.
How is the Protocol-Level Staking APR calculated? The Protocol Staking APR represents the annualized reward rate based on the current weekly reward pool relative to the total eligible staked GWEI in the system. * **The Formula:** `(Weekly GWEI Reward × 52) ÷ Total GWEI Staked` * **What this means:** This is the "global" rate. It gives you a snapshot of the protocol's health and the current efficiency of the reward pool before individual multipliers are applied.
How is my specific User Rewards APR determined? **Your APR is dynamic—you can boost it by increasing your Governance Power.**\ Unlike a standard bank rate, your yield depends on your "share of the pie." This share is determined by your **Governance Power**, which you can increase by locking your stake for longer periods or staking more GWEI. * **The Formula:** `(Weekly GWEI Reward × 52 × Your Governance Power %) ÷ Your Staked Balance` * **Example Scenario:** * **Weekly Reward Pool:** 1,000,000 GWEI * **Your Staked Balance:** 3,316.4 GWEI * **Your Governance Power:** 0.0023% * **Result:** In this scenario, your annualized return would be approximately **36.06%**. *By extending your staking term or increasing your stake amount, you increase your Governance Power %, directly boosting your personal APR.*
How does the "Genesis Multiplier" work? To reward our earliest governance guardians and supporters, the first genesis reward cycle includes a massive multiplier on staking yields with 1M GWEI rewards. To capture this, you **must stake your GWEI before the first reward cycle begins on Jan 22 (00:00 UTC).**
Do I need to claim my weekly $GWEI rewards manually? Rewards are **distributed weekly (Thursdays 00:00 UTC) after the end of each cycle.** You must stake **before the start of a cycle** to be eligible for the cycle's rewards pool. You have 3 claim rewards options via the Staking Dashboard under **"Your Rewards"** 1. **Claim:** Transfer the rewards directly to your wallet as liquid tokens.
2. **Claim & Restake (Manual compound):** Manual claim to restake to increase your veGWEI balance and voting power for future cycles based on your preferred cadence.
3. **Enable "Auto-Claim & Stake" (Auto compound):** Click to toggle ON the **“Auto-Claim & Stake” option** on the Staking Dashboard next to "Your Rewards" to auto-compound your weekly rewards. You will need to sign a transaction on your wallet to approve this weekly rewards auto-compound.
I have $GWEI on BSC (Binance Smart Chain). How do I stake? **You must bridge your tokens to Ethereum Mainnet first.** The $GWEI staking contract is built on Ethereum Mainnet. If you hold tokens on BSC, you cannot stake them directly. 1. **Go to Portal Bridge:** 2. **Connect Wallet:** Select the chain where you currently hold $GWEI (Source: BNB) and the destination (Target: Ethereum). 1. From: BNB `0x30117E4bC17d7B044194b76A38365C53b72F7D49`
2. To: Ethereum Mainnet `0x2798b1cC5A993085E8A9D46e80499F1B63f42204`
3. **Enter & Review the Bridge Amount:** Follow the prompts to connect your wallet, choose the bridge amount to move your assets. 4. **Confirm Bridge Transaction & Stake:** Once the funds arrive in your wallet on Ethereum Mainnet, return to the staking dashboard () to initiate your stake.
Is the $GWEI staking contract secure and audited? **Security is the foundation of our infrastructure.** We operate with a "security-first" mindset. We do not rely on obscurity; we rely on rigorous, top-tier verification. * Tier-1 Audit: Our staking contract has been audited by Sigma Prime, a leading security assessment firm in the Ethereum ecosystem. Open Source: We believe in "Verify, don't just trust." You can review our full audit reports [here](https://github.com/ethgas-developer/ethgas-audit/blob/main/Sigma_Prime_ETHGas_Token_Rebate_Escrow_Security_Assessment_Report_v3.2.pdf).
### Community Airdrop: Season 1 #### Eligibility
What criteria determine my Season 1 airdrop eligibility? Eligibility is based on a combination of your onchain activity and the ["Gasless Future Community Program"](https://www.ethgas.com/community/overview/). We measured the following to verify if you are an active Ethereum user and advocate for ETHGas.\ \ Eligibility for the Season 1 community airdrop was determined by a snapshot of onchain activity and activity within the ["Gasless Future Community Program"](https://www.ethgas.com/community/overview/). To qualify, your wallet must have met specific Social, Engagement, and/or Onchain Activity thresholds to verify you are an active Ethereum user and advocate for ETHGas.\ \ You must meet the following three core requirements before Snapshot on Jan 19 (00:00 UTC) to be eligible: \ **1. The Social Check (You must have completed one of the following quests on X/Twitter)** * Shared your Gas ID on X. * OR Quote-Tweeted (QT) the ETHGas "Open Gas Initiative" announcement. **2. The Activity Qualifier (Must meet at least ONE)** In addition to the Social Check and Bean Floor, you must fall into at least one of these five categories: * **The Ethereum Active User:** Total historical gas spend on Ethereum mainnet ≥ 0.5 ETH. * **The Discord Elite:** Ranked in the Top 100 for Discord Engage Points. * **The Telegram Raider:** Ranked as a Top User in our Telegram community. * **The Community Grinder:** Ranked in the Top 100 on the ETHGas Community Leaderboard * **The Ethereum OG:** Ranked in the Top 5000 on the ETHGas Community Leaderboard AND a minimum of 1.5 ETH in gas spent on Ethereum Mainnet. These users are exempt from the social check. **3. The Bean Floor (Mandatory)** * You must have accumulated a minimum of 500 Beans. Note: If you did not meet the Social Check AND the Activity Qualifier, you are not eligible, regardless of your gas spend or beans.
Why am I not eligible for the Season 1 community airdrop? If the eligibility checker indicates you are not eligible, it is because your wallet did not meet the specific criteria captured during the **Jan 19th** **(00:00 UTC)** snapshot. Most commonly, ineligibility is due to missing [one of the Three Mandatory Pillars](#what-criteria-determine-my-airdrop-eligibility). Other Common Reasons: * **Wrong Wallet:** Ensure you are connected with the **primary wallet** linked to your Gasless Future Community account. * **Sybil / Bot Behavior:** Your address was flagged by our anti-sybil detection system for artificial patterns or bot-like activity. * **Late Participation:** You completed the quests after the snapshot date on Jan 19 (00:00 UTC). If you are certain you met **the core requirements** before our snapshot and would like to appeal, you may create a private ticket with your X username and primary wallet address. Jump into our Discord and head to [**#tickets channel under "SUPPORT"**](https://discord.com/channels/1202457552479195176/1369922540935581779)
Why can't I see my final $GWEI amount on January 20th? The checker will confirm ***if*** you are eligible. The final calculation of $GWEI—based on the conversion rate of Beans to tokens—will be revealed on **January 21st** when the Claim & Stake portal opens.
Will Discord “Engage Points”/Telegram “Raider Points” be considered for the upcoming airdrop? The upcoming community airdrop will be based on your Beans and here’s the timeline of our internal operations to convert “Points” to Beans - * **Jan 15 (00:00 UTC):** Snapshot of Engage Points/Raider Points taken. * **Before Jan 18:** Points converted to Beans and credited to your Community Account. * **Jan 19 (00:00 UTC):** Final snapshot of Beans and quest activity taken to calculate your airdrop eligibility and $GWEI allocation. To ensure we can add the converted Beans to your Community Account, you **MUST complete ALL** of the following **before Jan 15 (00:00 UTC) -** 1. Onboard and create your [Gasless Future Community Account](https://www.ethgas.com/community/overview/); AND 2. Complete the “Join ETHGas Discord server” / “Join ETHGas Telegram" quest on the Community Dashboard to link your discord/telegram credentials to the Community Account
Is the Airdrop geo-restricted? Yes. To comply with global regulatory frameworks, the Foundation website including the Tokens page for eligibility checker and claim are not accessible to users in the United States, Canada, China, OFAC-sanctioned countries, and other restricted jurisdictions. We utilize geoblocking on the claim interface. If you believe you are being blocked in error, please consult our [Terms of Service](https://ethgasfoundation.org/terms-of-service).
My X (Twitter) account was suspended. Did I lose my future allocation? Not if you previously generated your Gas ID. Rest assured, your progress is saved on-chain, not on social media. * **If you linked your wallet in Chapter 1.5:** You are safe. Your "Proof of Pain" and Gas ID are tied to your Primary Wallet, not your social handle. When the eligibility checker goes live, you will simply connect that wallet to verify your status. You do not need access to the suspended social account to check your eligibility. * **If you never linked a wallet:** Unfortunately, we cannot verify your activity. The Gas ID generation (linking a wallet) was the mandatory step to secure your spot. Without it, there is no on-chain record of your participation. **Why is this the policy?** We rely on X for initial Sybil resistance. According to[ X’s Enforcement Policy](https://help.x.com/en/managing-your-account/suspended-x-accounts), accounts are suspended for "severe violations of the X Rules," including platform manipulation and spam. We cannot override X’s internal security measures to verify a suspended user.
I have questions about the Community Program (Beans & Quests), where can I get help? Please refer to the community FAQ [here](https://docs.ethgas.com/community#community-faq).
#### Claiming & Auto-Stake
How do I claim my $GWEI? 1. Connect your wallet to the official Token Page (). 1. We strongly recommend you use Desktop to claim & auto-stake for a smoother UX. 2. You will see your eligibility and final allocation. Click \[Claim & Stake Airdrop] to proceed. 1. Your airdrop is distributed as a staked position to ensure immediate governance participation. By claiming, you accept the lock-up period and begin accruing boosted staking yield of the "Genesis Multiplier". 3. Adjust your "Unlock Date" and review the staking details before clicking \[Claim & Stake] 1. You must stake for a minimum of 30 days and your unlock date will be extended until end of your last active staking cycle. 2. Please note that the staking cycle resets every Thursday at 00:00 UTC so you may only choose an unlock date on Thursdays. 4. Check your wallet and sign the 2 transactions for Claim & Stake. 5. You will see the success page with "Tokens Secured!". Click \[Go to Staking Dashboard] to see your stake & governance and manage your staking term.
Why is my Airdrop automatically staked? We are building a community of builders. To ensure long-term alignment, your allocation allocation is **automatically staked as veGWEI upon airdrop claiming** to initiate your status as a **Protocol Guardian.** * **The Duration:** Your initial stake is locked for a **minimum of 30 days,** extending until the conclusion of the **last active** Weekly Staking Cycle. * **Immediate Governance:** You receive full voting power the moment you claim. * **Launch Boost:** During this initial phase, you automatically accrue Boosted Staking Incentives to reward your early commitment to the protocol.
Do I need ETH to claim? Yes. Claiming is an on-chain transaction on **Ethereum Mainnet**. You will need a small amount of ETH for gas **(\~0.001 ETH).**
Should I claim my Airdrop immediately? **Yes**. Time is a factor in your total reward calculation. The **Boosted Staking Incentives** are heavily weighted toward the first month of the TGE (Token Generation Event). Because your airdrop is automatically staked for a minimum of 30 days upon claiming, delaying your claim results in two negative outcomes: 1. **Missed Yield:** You miss the days with the highest APY, which occurs right at launch when the reward pool is freshest. 2. **Misaligned Cycles:** If you claim late, your 30-day auto-stake will extend beyond the initial "Boosted" period. You will be locked during a period of normalized (lower) rewards, rather than capitalizing on the launch incentives. To maximize your $GWEI allocation, claim on Day 1 to sync your staking term with the first month Boost window.
What happens after the minimum 30-day staking is up? Your initial lock-up concludes at the end of the specific Weekly Cycle that falls after your 30th day. Once this cycle finishes: * Your tokens remain **staked (locked)**, **BUT rewards will STOP.** * To keep earning yield, you must manually **extend** your staking term **before** your unlock date. * Extending your term increases your voting power and locks in your yield rate. Don't let your rewards flatline!
I missed the snapshot. Can I still participate? Yes. The ecosystem is just getting started. While the snapshot for the **initial Season 1** "Gasless Future Community Program" (Chapters 1-4) has concluded, there are two major ways to participate moving forward: 1. **Staking & Yield:** Post-TGE, you can **get $GWEI** on the open market and stake it in the Staking Dashboard for the first cycle of "Genesis Multiplier of 1M rewards". This allows new users to earn rewards alongside early adopters. 2. **Season 2 Community Program:** We are preparing to launch Season 2, featuring a fresh set of quests, partners, and rewards. Stay tuned to our socials @ETHGasOfficial for the kickoff announcement.
# $GWEI Bridge Instructions {% hint style="info" %} These instructions cover manual (contract-level) token bridging via Wormhole. While this provides zero bridge fee, full control, and transparency, it requires multiple steps and careful input handling. Most users may prefer UI-based bridge providers such as [https://portalbridge.com](https://portalbridge.com/), inputting the $GWEI contract address directly, automating this process, and offering a simpler, safer experience, but charging a fee for their service. {% endhint %} ### $GWEI Token Addresses * Ethereum Mainnet: [`0x2798b1cC5A993085E8A9D46e80499F1B63f42204`](https://etherscan.io/address/0x2798b1cC5A993085E8A9D46e80499F1B63f42204) * BSC: [`0x30117E4bC17d7B044194b76A38365C53b72F7D49`](https://bscscan.com/address/0x30117E4bC17d7B044194b76A38365C53b72F7D49) ### $GWEI Bridge Instructions
Bridging from BSC -> Ethereum 1. On BSC chain, approve GWEI token for wormhole tokebridge: [`0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7`](https://bscscan.com/address/0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7) 2. Call wormhole tokebridge [`0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7`](https://bscscan.com/address/0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7) `transferTokens()` according to[ https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/wtt-contracts/#transfer-tokens](https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/wtt-contracts/#transfer-tokens) 1. token is the GWEI address [`0x30117E4bC17d7B044194b76A38365C53b72F7D49`](https://bscscan.com/address/0x30117E4bC17d7B044194b76A38365C53b72F7D49) 2. recipientChain ID for ETH is 2 according to[ https://wormhole.com/docs/products/reference/chain-ids](https://wormhole.com/docs/products/reference/chain-ids/) 3. recipient must be in bytes32 format, for example if your address is `0xf1357d45671CB16dE055752809C8d2e3aB4AfE2e` then you should input `0x000000000000000000000000f1357d45671cb16de055752809c8d2e3ab4afe2e` 4. arbiterFee can be set to `0` 5. nonce can start with `0` 6. Example tx: 3. Search your tx hash on[ https://wormholescan.io](https://wormholescan.io/) and wait for around 1-2 min 4. On the Ethereum chain, call wormhole tokenbridge [`0x3ee18b2214aff97000d974cf647e7c347e8fa585`](https://etherscan.io/address/0x3ee18b2214aff97000d974cf647e7c347e8fa585) `completeTransfer` with input data from the below: 1. Get the VAA bytes from[ https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/fetch-signed-vaa](https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/fetch-signed-vaa/), remember to put 0x before the hex data 1. Or, open the terminal and run `echo "" | base64 --decode | xxd -p -c 9999` where `""` refers to the vaa data found in the advanced tab of the wormhole explorer page 2. Example tx:
Bridging from Ethereum -> BSC 1. On the Ethereum chain, approve GWEI token for wormhole tokebridge [`0x3ee18b2214aff97000d974cf647e7c347e8fa585`](https://etherscan.io/address/0x3ee18b2214aff97000d974cf647e7c347e8fa585) 2. Call wormhole tokebridge [`0x3ee18b2214aff97000d974cf647e7c347e8fa585`](https://etherscan.io/address/0x3ee18b2214aff97000d974cf647e7c347e8fa585) `transferTokens()` according to[ https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/wtt-contracts/#transfer-tokens](https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/wtt-contracts/#transfer-tokens) 1. token is the GWEI address [`0x2798b1cC5A993085E8A9D46e80499F1B63f42204`](https://etherscan.io/address/0x2798b1cC5A993085E8A9D46e80499F1B63f42204) 2. recipientChain ID for BSC is `4` according to[ https://wormhole.com/docs/products/reference/chain-ids/](https://wormhole.com/docs/products/reference/chain-ids/) 3. recipient must be in bytes32 format, for example if your address is `0xf1357d45671CB16dE055752809C8d2e3aB4AfE2e` then you should input `0x000000000000000000000000f1357d45671cb16de055752809c8d2e3ab4afe2e` 4. arbiterFee can be set to `0` 5. nonce can start with `0` 6. Example tx: 3. Search your tx hash on[ https://wormholescan.io](https://wormholescan.io/) and wait for around 18-20 min 4. On BSC chain, call wormhole tokenbridge [`0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7`](https://bscscan.com/address/0xb6f6d86a8f9879a9c87f643768d9efc38c1da6e7) `completeTransfer` with input data from the below 1. Get the VAA bytes from[ https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/fetch-signed-vaa](https://wormhole.com/docs/products/token-transfers/wrapped-token-transfers/guides/fetch-signed-vaa/), remember to put 0x before the hex data 1. Or, open the terminal and run `echo "" | base64 --decode | xxd -p -c 9999` where `""` refers to the vaa data found in the advanced tab of the wormhole explorer page 2. Example tx: