Skip to content

docs(evm): fix chain-id hex, delegation cap, block.max_gas, TBDs, and formatting#179

Merged
a-ok123 merged 2 commits into
masterfrom
docs/evm-doc-corrections
Jun 26, 2026
Merged

docs(evm): fix chain-id hex, delegation cap, block.max_gas, TBDs, and formatting#179
a-ok123 merged 2 commits into
masterfrom
docs/evm-doc-corrections

Conversation

@akobrin1

Copy link
Copy Markdown
Contributor

Documentation-only corrections to the EVM integration guides, each verified against the code.

Changes

# Issue Fix Canonical source
1 Wrong EVM chain-id hex in rollout 0x494b3290x494c1a9 hex(76857769); matches metamask-configuration.md, bugs.md, openrpc.json
2 max_validator_delegations cap said 2000 2500 in main.md DefaultMaxValidatorDelegations = 2500 (x/evmigration/types/params.go:51)
3 block.max_gas conflict (migration.md -1 vs rollout.md 25M) rollout.md clarified see note below
4 tune-guide TBD economic params annotated with shipped code defaults minimum_stake 0 ulume; base_action_fee 0.01 LUME / fee_per_kbyte 0.00001 LUME/kB; supernode_fee_share 200 bps (2%)
5 Supernode guide missing spaces around inline code/links 16 spacing fixes
6 Stale guide-index cap text covered by #2

On block.max_gas (#3)

ChainDefaultConsensusMaxGas = 25_000_000 (config/evm.go) is applied only at fresh genesis init (lumerad init/testnet). The in-place v1.20.0 upgrade's EnsurePresent only seeds consensus params when missing (else preserves the existing value), so it never overwrites an existing chain's max_gas — live lumera-mainnet-1 and the running EVM devnet run -1. migration.md's -1 was correct; rollout.md's framing of 25M as the upgraded-mainnet value was the bug, now reconciled.

Notes

  • Item 4 values are the current shipped code defaults, not final mainnet decisions — the "Action" column still flags each for review.
  • The corresponding Notion pages (Rollout, User-facing-guides hub, tune-guide) were updated in parallel to match.
  • Docs-only; no code changes.

🤖 Generated with Claude Code

…matting

Corrections surfaced while reviewing the EVM rollout/user guides:

- rollout.md: correct EVM chain-id hex `0x494b329` -> `0x494c1a9`
  (hex(76857769); matches metamask guide, bugs.md, openrpc.json).
- rollout.md: reconcile `block.max_gas`. `25,000,000`
  (ChainDefaultConsensusMaxGas) is the fresh-genesis default only; the
  in-place v1.20.0 upgrade does not change it (EnsurePresent preserves the
  existing value), so live mainnet/devnet run `-1`. Removes the conflict
  with migration.md.
- main.md: `max_validator_delegations` default 2000 -> 2500
  (DefaultMaxValidatorDelegations in x/evmigration/types/params.go).
- tune-guide.md: replace bare TBD economic params with shipped code
  defaults (minimum_stake 0 ulume; base_action_fee 0.01 LUME /
  fee_per_kbyte 0.00001 LUME/kB; supernode_fee_share 2%/200 bps), keeping
  the "review for mainnet" action flags.
- supernode-migration.md: add missing spaces around inline code/links
  (e.g. add`evm_key_name` -> add `evm_key_name`).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ce00661bf0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/evm-integration/user-guides/tune-guide.md Outdated
The tune-guide row maps to x/action `SuperNodeFeeShare` (decimal, default
`1.0` = 100% per x/action/v1/types/params.go), not the x/supernode
`RegistrationFeeShareBps` (200 bps) used in the previous commit. Fix the
value to `1.0` (100%) so operators tune the correct parameter.

Also drop a stray blank line after a heading in rollout.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@a-ok123 a-ok123 self-requested a review June 26, 2026 02:47
@a-ok123 a-ok123 merged commit 8e63741 into master Jun 26, 2026
13 checks passed
@a-ok123 a-ok123 deleted the docs/evm-doc-corrections branch June 26, 2026 02:51
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.

2 participants