Skip to content

docs: add EVM reference section and sei-js examples#2

Open
monty-sei wants to merge 2 commits into
mainfrom
docs/evm-reference-and-sei-js-examples
Open

docs: add EVM reference section and sei-js examples#2
monty-sei wants to merge 2 commits into
mainfrom
docs/evm-reference-and-sei-js-examples

Conversation

@monty-sei
Copy link
Copy Markdown
Collaborator

Summary

  • EVM Compatibility page — replaces matrix.mdx; includes feature support table and unsupported RPC methods (blob methods, pending state, eth_accounts)
  • Behavior reference sub-pages — finality, gas & fees, transaction types, state proofs, WebSocket subscriptions, signing (all nested under EVM Compatibility as a dropdown in the sidebar)
  • 12 sei-js example pages — viem quickstart, ethers v6 quickstart, wagmi + React, ERC-20, ERC-721, ERC-1155, multicall, pointer contracts, precompile redirect, deploy & verify, transaction lifecycle, error handling (under Ecosystem Tutorials → sei-js Examples)
  • @sei-js/registry page — new dedicated docs for CHAIN_IDS, NETWORKS, TOKEN_LIST, GAS_INFO, CHAIN_INFO, WALLETS
  • Precompiles example-usage rewrite — viem + ethers CodeGroups throughout; Bank, Staking, Distribution, Governance sections; oracle content removed (retired per sei-infra#1001)
  • sei-js examples precompiles page — converted to lightweight redirect pointing to the precompiles section
  • Navigationdocs.json updated: EVM Compatibility dropdown under Overview, sei-js Examples group under Ecosystem Tutorials; home page and sei-js index updated with new cards

Test plan

  • mint dev builds without errors
  • EVM Compatibility page renders with dropdown sub-pages in sidebar
  • sei-js Examples group appears under Ecosystem Tutorials
  • All internal links resolve (no 404s in preview)
  • Precompile example-usage page shows viem and ethers tabs
  • sei-precompiles example page redirects cleanly to precompiles section
  • @sei-js/registry page appears under sei-js Library in sidebar

- Add EVM Compatibility page (replaces matrix.mdx) with unsupported RPC methods
- Add behavior reference sub-pages: finality, gas & fees, transaction types, state proofs, WebSocket, signing
- Add 12 sei-js example pages: viem/ethers quickstarts, wagmi-react, ERC-20/721/1155, multicall, pointer contracts, precompiles redirect, deploy & verify, transaction lifecycle, error handling
- Add @sei-js/registry documentation page
- Rewrite precompiles example-usage.mdx: viem + ethers CodeGroups, Bank/Staking/Distribution/Governance sections, remove oracle (retired)
- Update docs.json navigation: EVM Compatibility dropdown under Overview, sei-js Examples group under Ecosystem Tutorials
- Update sei-js index and home page to surface new pages
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 18, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
sei-docs 🟢 Ready View Preview May 18, 2026, 4:03 AM

@cursor
Copy link
Copy Markdown

cursor Bot commented May 18, 2026

PR Summary

Low Risk
Low risk documentation-only change that adds new EVM compatibility/reference pages and example guides; main risk is broken navigation or links in the sidebar/homepage.

Overview
Adds a new EVM Compatibility reference section, including a compatibility matrix plus sub-pages for Sei-specific behavior (finality, gas/fees, transaction types, state proofs, WebSocket, signing) and calls out unsupported RPC methods.

Introduces a sei-js Examples tutorial set (viem/ethers/wagmi quickstarts, ERC-20/721/1155 interactions, multicall, pointer contracts, deploy/verify, transaction lifecycle, error handling) and documents the new @sei-js/registry package.

Reworks evm/precompiles/example-usage to use viem+ethers CodeGroups and updated precompile coverage, and updates navigation (docs.json), evm/sei-js/index.mdx, and the homepage cards to surface the new content.

Reviewed by Cursor Bugbot for commit a0b1828. Bugbot is set up for automated code reviews on this repo. Configure here.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit a0b1828. Configure here.

err?.code === 'CALL_EXCEPTION'
) {
throw err;
}
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Retry function silently retries viem contract reverts

Medium Severity

The withRetry function's comment says "Don't retry user rejections or contract reverts," but the guard only catches ethers-style reverts (err?.code === 'CALL_EXCEPTION'). In viem, contract reverts surface as ContractFunctionRevertedError wrapped inside a BaseError — none of the three checks (UserRejectedRequestError, code 4001, code CALL_EXCEPTION) match that. The classifyError utility earlier in the same file demonstrates the correct viem pattern using BaseError.walk(), but withRetry omits it. Developers copying this utility for viem would needlessly retry deterministic failures.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit a0b1828. Configure here.

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