EVM standard parity

.github/ISSUE_TEMPLATE/evm_compatibility.md

@@ -0,0 +1,40 @@
+---
+name: EVM compatibility
+about: Report behavior that differs from expected EVM tooling or RPC compatibility
+title: "[EVM-COMPAT] "
+labels: evm-compat, linear
+assignees: ''
+
+---
+
+**Library or tool**
+Which library, connector, RPC method, template, or docs page is involved?
+
+**SeiJS package and version**
+Check your `package.json` for the package name and version.
+
+**Network**
+Mainnet, testnet, devnet, local, or unknown.
+
+**Expected EVM behavior**
+What behavior did you expect from standard EVM tooling?
+
+**Observed Sei behavior**
+What happened instead?
+
+**Minimal reproduction**
+Provide the smallest code sample, command, RPC payload, or repository link that reproduces the issue.
+
+**Error output or transaction hash**
+Paste the relevant error, RPC response, transaction hash, or receipt.
+
+**Classification**
+If known, choose one:
+- SDK gap
+- Network issue
+- Upstream issue
+- Docs issue
+- Intentional divergence
+
+**Additional context**
+Add any other context that may help with triage.

.gitignore

@@ -4,6 +4,7 @@
 packages/*/coverage
 
 examples/
+.internal/
 
 # compiled output
 dist

docs/docs.json

@@ -81,6 +81,12 @@
 					}
 				]
 			},
+			{
+				"dropdown": "EVM Parity",
+				"description": "Compatibility matrix",
+				"icon": "table",
+				"pages": ["evm-parity/matrix"]
+			},
 			{
 				"dropdown": "@sei-js/sei-global-wallet",
 				"description": "User friendly wallet connect",

docs/evm-parity/matrix.mdx

@@ -0,0 +1,56 @@
+---
+title: 'Parity Matrix'
+description: 'EVM feature support matrix for Sei across viem, wagmi, and ethers'
+icon: 'table'
+---
+
+# Parity Matrix
+
+This matrix summarizes EVM workflow support on Sei across the JavaScript libraries developers already use: viem, wagmi, and ethers. Standard EVM workflows should work through standard tooling, while Sei-specific workflows are exposed through `@sei-js` packages where they add value.
+
+## Status Legend
+
+| Status | Meaning |
+| --- | --- |
+| Supported | Supported through standard EVM tooling on Sei. |
+| Supported via `@sei-js` | Supported by a Sei-specific `@sei-js` package layered on standard EVM tooling. |
+| Wallet-dependent | Supported when the connected wallet or account exposes the capability. |
+| Documented difference | Available, but Sei intentionally differs from Ethereum behavior. |
+| Not applicable | Not part of Sei's EVM support surface. |
+
+## Feature Support
+
+| Workflow | viem | wagmi | ethers | Sei support |
+| --- | --- | --- | --- | --- |
+| Chain metadata and HTTP transport | Supported | Supported | Supported | Supported |
+| WebSocket subscriptions and watchers | Supported | Supported | Supported | Supported |
+| Wallet discovery | Supported | Supported | Supported | Supported via `@sei-js` |
+| Connect and disconnect | Supported | Supported | Supported | Supported |
+| Switch and add chain | Supported | Supported | Supported | Supported |
+| Native SEI balance | Supported | Supported | Supported | Supported |
+| Blocks | Supported | Supported | Supported | Supported |
+| Transactions and receipts | Supported | Supported | Supported | Supported |
+| Logs and events | Supported | Supported | Supported | Supported |
+| Contract reads | Supported | Supported | Supported | Supported |
+| Contract writes | Supported | Supported | Supported | Supported |
+| Contract deploy | Supported | Supported | Supported | Supported |
+| Simulation and gas estimate | Supported | Supported | Supported | Supported |
+| Message signing | Wallet-dependent | Wallet-dependent | Wallet-dependent | Wallet-dependent |
+| Typed-data signing | Wallet-dependent | Wallet-dependent | Wallet-dependent | Wallet-dependent |
+| Transaction signing | Wallet-dependent | Wallet-dependent | Wallet-dependent | Wallet-dependent |
+| ERC-20 reads and transfers | Supported | Supported | Supported | Supported |
+| ERC-721 reads and transfers | Supported | Supported | Supported | Supported |
+| ERC-1155 reads and transfers | Supported | Supported | Supported | Supported |
+| Sei precompiles | Supported via `@sei-js` | Supported via `@sei-js` | Supported via `@sei-js` | Supported via `@sei-js` |
+| Pointer and address helper flows | Supported via `@sei-js` | Supported via `@sei-js` | Supported via `@sei-js` | Supported via `@sei-js` |
+| `eth_getProof` | Documented difference | Documented difference | Documented difference | Documented difference |
+| Blob transactions | Not applicable | Not applicable | Not applicable | Not applicable |
+| ENS | Not applicable | Not applicable | Not applicable | Not applicable |
+
+## Compatibility Notes
+
+- Sei supports standard EVM JSON-RPC workflows used by viem, wagmi, and ethers.
+- Sei-specific precompile, pointer, and address-association workflows are exposed through `@sei-js/precompiles`.
+- Wallet signing support depends on the connected wallet or account, as it does on other EVM networks.
+- `eth_getProof` is available with Sei's documented proof format, which differs from Ethereum's Merkle Patricia Trie proof format.
+- Blob transactions and ENS are not part of Sei's EVM support surface.