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
Documentation-only changes to agent skill markdown; no runtime code or auth paths. Wrong guidance could mislead builders until caught in review.

Overview
This PR refreshes the Sei agent skill and reference docs so guidance matches current Sei policy and docs, not stale Ethereum assumptions.

Bridges & SIP-3: bridges.md is rewritten around LayerZero V2 and Circle CCTP v2; inbound IBC is disabled and ibc-bridging.md is legacy/exit-only. Wormhole is verify-first; Axelar and broad IBC-as-inbound paths are de-emphasized or removed. Skill entry points and the apps directory align with that framing.

Gas & oracles: SSTORE (72k) is tied to pacific-1 Proposal #109 (replacing incorrect #240); min gasPrice is described as a governance-adjustable ~50 gwei floor (#112/#244) with eth_gasPrice. Docs warn that forge --gas-report --fork-url reflects revm (~22k), not Sei. The native Oracle precompile (0x…1008) is marked shut off (~July 2026) everywhere; third-party oracles replace prior native-oracle examples.

Frontend & docs platform: Chain config moves from @sei-js/precompiles to wagmi/chains / viem/chains; getSeiAddr is documented as reverting when unassociated. docs.sei.io contribution flow switches Nextra → Mintlify (docs.json, mint dev, CI). docs.sei.io URL paths are updated (e.g. evm/usdc-on-sei).

Contracts & ops: Security/upgradeability notes (OZ v5 UUPS, Hardhat 3 caveat, validator allowlist, EIP-6780 SELFDESTRUCT). New payments.md for USDC + x402. Node ops adds genesis/state-sync warnings, minimum-gas-prices, and SeiDB/Giga config.

^{Reviewed by Cursor Bugbot for commit 05ad2f8. 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