Refresh Sei skill: SIP-3 bridges/IBC, Mintlify docs, gas & oracle accuracy

[alexander-sei]

What & why

A correctness pass over the skill references, bringing them in line with the
current state of Sei. Every factual claim below was verified against an
authoritative source — the live Sei docs (docs.sei.io), on-chain governance
data (Cosmos gov REST API, both pacific-1 and atlantic-2), and the
sei-chain source — not from memory.

Highlights

Bridges & IBC (SIP-3) — bridges.md rewritten; ibc-bridging.md reframed legacy/exit-only.

• Inbound IBC is disabled (pacific-1 #116 / atlantic-2 #247). IBC is now exit-only.
• Documented EVM bridges are LayerZero V2 (EIDs: mainnet 30280, testnet 40455) and Circle CCTP v2 (native USDC, Sei domain 16).
• Wormhole reframed as verify-first (SeiEVM supported per Wormhole, not documented by Sei). Axelar removed (no SeiEVM deployment).

Governance proposal numbers — all confirmed on-chain:

Network	Prop	Title
pacific-1	#99 / #115 / #116	Deprecating CosmWasm / Disable CosmWasm Uploads / Disable IBC Inbound
pacific-1	#109	Update EVM SSTORE set gas to 72000
pacific-1	#112	Update EVM minimum fee (→50 gwei)
atlantic-2	#244 / #246 / #247	EVM min fee / Disable CosmWasm Uploads / Disable IBC Inbound

The old #240 SSTORE attribution was wrong (proposal doesn't exist) → corrected to #109.

Gas — SSTORE stays 72k on both networks (now sourced to #109); min gas price reframed as the governance-set, adjustable ~50 gwei floor (#112/#244, history 100→10→50); eth_gasPrice for the live value. Noted that forge --fork-url reports revm's ~22,100, not Sei's cost.

Native Oracle precompile (0x…1008) is shut off (~July 2026) — reframed everywhere from "deprecated" to no-op/returns-no-data; legacy interface+example removed; validator oracle-duty entry dropped. Use Pyth/Chainlink/API3/RedStone.

Docs platform — docs-contributing.md / sites-map.md updated for the Nextra → Mintlify migration (docs.json, mint CLI, snippets, Vale/lychee CI, root skill.md).

Frontend / sei-js — sei/seiTestnet now imported from wagmi/chains / viem/chains (@sei-js/precompiles ships only seiLocal); getSeiAddr documented as reverting (not returning "") for unassociated addresses; create-sei app --name scaffold + current template stack.

Contracts — OZ v5 UUPSUpgradeable stateless note; Hardhat 3 caveat (stable plugin targets HH2, HH3 is alpha); EIP-6780 SELFDESTRUCT section; staking validator allowlist over brittle bech32 prefix check.

New — payments.md (USDC + x402): native USDC addresses/6-decimals, the @sei-js/x402-* packages, the 402 challenge/verify flow with replay protection.

Node ops — auto-genesis + "never start from genesis" warning, 0.02usei floor, SeiDB SC/SS + RocksDB + Giga (evm-ss-split, sc-write-mode) section.

Verification

• Proposal numbers: Cosmos gov v1beta1 REST on pacific-1 and atlantic-2.
• USDC addresses / x402 / LayerZero EIDs / CCTP domain: docs.sei.io + vendor docs.
• SeiDB sc-write-mode enum: confirmed against local sei-chain source.

🤖 Generated with Claude Code

[cursor]

PR Summary

Low Risk
Changes are markdown reference updates only—no executable code or deployment paths. Residual risk is agents acting on newly stated facts (bridge/oracle/gas) if those facts drift from chain reality over time.

Overview
This PR is a documentation-only correctness pass across the Sei skill (SKILL*.md and references/**) so agents stop giving outdated guidance on bridges, gas, oracles, and tooling.

SIP-3 bridging & IBC — bridges.md is rewritten around LayerZero V2 and Circle CCTP v2 as the Sei-documented EVM paths; Axelar integration content is dropped; Wormhole is verify-first (not Sei-documented). Inbound IBC is disabled — ibc-bridging.md is reframed as legacy / exit-only, with governance proposal citations (e.g. pacific-1 #116, atlantic-2 #247). Skill entry points and apps-directory.md mirror the same bridge matrix.

Gas & governance facts — Fixed wrong SSTORE attribution (#240 → #109); 72k cold writes on both networks; min gasPrice described as a governance-adjustable ~50 gwei floor (#112 / #244) with eth_gasPrice for live values; notes that forge --gas-report --fork-url reflects revm (~22,100), not Sei storage costs. safe / finalized / latest are documented as equivalent on instant-finality Sei.

Native Oracle (0x…1008) — Marked retired (shut off ~July 2026) with reverting queries; native precompile examples removed from oracles.md; security/migration/best-practices point to Pyth / Chainlink / API3 / RedStone.

Frontend & docs platform — Chain config guidance switches sei / seiTestnet imports to wagmi/chains / viem/chains (precompiles package for ABIs/seiLocal only); getSeiAddr documented as reverting when unassociated; docs-contributing.md and sites-map.md updated for Nextra → Mintlify (docs.json, mint dev, CI). payments.md added for USDC (6 decimals) + x402; linked from ecosystem skills and ai-tooling.md.

Contracts & node ops — Security/upgradeability tweaks (validator allowlist, OZ v5 UUPS init, oracle retirement); Ethereum migration adds EIP-6780 SELFDESTRUCT note; node-operations.md expands genesis/state-sync warnings, minimum-gas-prices, and SeiDB / Giga config =sc-write-mode / evm-ss-split**. Many docs.sei.io URLs move from /evm/reference/... to current paths (e.g. /evm/usdc-on-sei).

^{Reviewed by Cursor Bugbot for commit 75f8478. Bugbot is set up for automated code reviews on this repo. Configure here.}

[monty-sei]

Approving with a non-blocker comment:

I believe Hardhat 3 @openzeppelin/hardhat-upgrades is now stable and released so the comment on it being alpha might be inaccurate. Latest is here: https://github.com/OpenZeppelin/openzeppelin-upgrades/releases/tag/%40openzeppelin%2Fhardhat-upgrades%404.0.2

Again not a blocker and we can update later if needed