Skip to content

docs: document fixed gas price and per-operation gas costs - #240

Draft
claude[bot] wants to merge 3 commits into
mainfrom
docs/gas-costs
Draft

docs: document fixed gas price and per-operation gas costs#240
claude[bot] wants to merge 3 commits into
mainfrom
docs/gas-costs

Conversation

@claude

@claude claude Bot commented Jul 13, 2026

Copy link
Copy Markdown

Requested by Shresth Agrawal · Slack thread

Before

The docs never state the gas price, and no precompile page says what its calls cost in gas.

After

  • Getting Started has a Gas section: the gas price is a fixed constant of 1 gwei (variable pricing may come later — links Gas Pricing Without Consensus); clients can keep fetching it via the usual base-fee RPCs (eth_gasPrice, baseFeePerGas in blocks and eth_feeHistory); eth_estimateGas works as-is; there is no priority fee or tip (eth_maxPriorityFeePerGas is always 0); gas is charged per operation — simple transfers cost 21,000 gas, with per-operation costs listed under Precompiles.
  • Each precompile page lists its per-operation gas costs (gas units only — pricing lives on the Getting Started page):
    • OrderbooksubmitOrder/submitTrigger 40,000; update/updateTrigger 30,000; cancel/cancelTrigger 25,000; deposit, withdraw, and any other call 21,000. submitBatch costs the sum of its inner intents' costs (minimum 21,000); delegated stays gas-exempt.
    • Bridgewithdraw 50,000; any other call 21,000; deposits are credited by the network and cost the user nothing on Pod.
    • Optimistic AuctionssubmitBid 25,000.
    • Recoveryrecover 100,000, plus 21,000 gas per intermediate account when funds already moved through earlier recoveries.
  • The Precompiles index notes that each precompile page lists its per-operation gas costs.

Note: the per-operation costs reflect an upcoming network upgrade — this PR should merge once that rolls out.

Files touched

  • doc/api-reference/README.md
  • doc/api-reference/applications-precompiles/README.md
  • doc/api-reference/applications-precompiles/orderbook.md
  • doc/api-reference/applications-precompiles/bridge.md
  • doc/api-reference/applications-precompiles/recovery.md
  • doc/api-reference/applications-precompiles/wip-optimistic-auctions.md

🤖 Generated with Claude Code

https://claude.ai/code/session_01LFS56yZWWCu1wSa3jjzFjZ


Generated by Claude Code

claude added 3 commits July 13, 2026 10:40
Precompile pages now state only gas costs in gas units; the fixed
1 gwei price and fee RPC details live solely in the Getting Started
Gas section.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LFS56yZWWCu1wSa3jjzFjZ
Gas is no longer documented as a flat 21,000 per transaction: simple
transfers stay at 21,000 gas, and each precompile page now lists its
per-operation costs (orderbook 40k/30k/25k, bridge withdraw 50k,
auction submitBid 25k, recovery recover 100k). Pricing (1 gwei, fee
RPCs) is unchanged and stays on the Getting Started page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LFS56yZWWCu1wSa3jjzFjZ
@claude claude Bot changed the title docs: document fixed gas price and per-precompile gas costs docs: document fixed gas price and per-operation gas costs Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant