Skip to content

skill.md

Latest commit

 

History

History
277 lines (223 loc) · 12.8 KB

skill.md

File metadata and controls

277 lines (223 loc) · 12.8 KB
Raw
name sei-docs
description Use when developers ask "How do I deploy a contract on Sei?", "How do I use Sei precompiles?", "What are the differences between Sei and Ethereum?", "How do I set up Foundry/Hardhat for Sei?", "How do pointer contracts work?", "How do I connect a wallet to Sei?", "What is the Sei MCP server?", "How do I bridge tokens on Sei?", "How do I run a Sei node?", "How do I stake via EVM?", "What is SSTORE gas on Sei?", "How do I verify my contract on Seiscan?", "How do I optimise gas on Sei?", "How do I use ERC-4337 on Sei?", "How do I make a contract upgradeable on Sei?", or any technical development question about building on Sei. Full developer reference playbook for docs.sei.io's audience.
user-invocable false
license MIT
compatibility Requires Node.js 18+; Foundry or Hardhat for contract development
metadata
author version intended-host parent
Sei Labs
1.0.0
docs.sei.io

Sei developer documentation

This skill is the full technical reference for building on Sei. It is hosted on docs.sei.io. For the offline AI coding-assistant skill (a Claude Code skill loaded directly into your editor), see github.com/sei-protocol/sei-skill.

# Install the full sei skill for AI assistants
npx skills add sei

# Or install a focused variant
npx skills add sei-contracts    # smart contracts only
npx skills add sei-frontend     # UI / frontend only
npx skills add sei-ecosystem    # apps / integrations only

Critical facts — apply to every answer

  1. 400ms block time, instant finality: Use tx.wait(1), never tx.wait(12).
  2. SSTORE gas is 72,000 on Sei: It is the same on both Sei Mainnet and Sei Testnet and does not vary by network. Governance set this value in Sei Mainnet Proposal #109 ("Update EVM SSTORE set gas to 72000"). The proposal set the evm param KeySeiSstoreSetGasEIP2200 to 72000. Because governance controls the value, it is adjustable and can change. Confirm the live value at https://docs.sei.io/evm/differences-with-ethereum#sstore-gas-cost
  3. Use legacy gasPrice: Sei has no base fee burn. Prefer gasPrice over EIP-1559 maxFeePerGas and maxPriorityFeePerGas.
  4. Minimum gas price: 50 gwei
  5. Block gas limit: 12.5M per block
  6. PREVRANDAO is NOT random: Use Pyth VRF or Chainlink VRF.
  7. COINBASE = global fee collector (not the block proposer).
  8. No base fee burn: All fees go to validators.
  9. Dual address system: Every account has a sei1... (Cosmos) address and a 0x... (EVM) address from the same key. Cross-VM transfers require association.
  10. CosmWasm is deprecated per SIP-3 (proposal 99): Use EVM for new development.
  11. Chain IDs: Sei Mainnet (EVM 1329, Cosmos pacific-1) and Sei Testnet (EVM 1328, Cosmos atlantic-2).
  12. safe and finalized resolve to latest: Sei has instant finality, so all three tags return the same block. Use latest.

Networks

Network EVM chain ID Cosmos chain ID EVM RPC Cosmos RPC
Sei Mainnet 1329 pacific-1 https://evm-rpc.sei-apis.com https://rpc.sei-apis.com
Sei Testnet 1328 atlantic-2 https://evm-rpc-testnet.sei-apis.com https://rpc-testnet.sei-apis.com

Sei Testnet faucet: https://docs.sei.io/learn/faucet

For the full list of community and paid RPC providers, and for failover patterns, see docs.sei.io/learn/rpc-providers.

Default stack (opinionated)

Layer Recommendation
Smart contracts Foundry (preferred) or Hardhat
Frontend wagmi + viem (React) or ethers.js v6
Wallet Sei Global Wallet (@sei-js/sei-global-wallet, ESM-only) + MetaMask fallback. For Sei Global Wallet, add consumer overrides.
Chain config viem/chains: sei, seiTestnet. @sei-js/precompiles re-exports both and adds seiLocal.
Sei precompiles @sei-js/precompiles: addresses, raw *_PRECOMPILE_ABI constants, and @sei-js/precompiles/ethers factories. ESM-only, viem ^2.55.16.
Verification Seiscan through Sourcify (forge verify-contract --verifier sourcify)
Testing Foundry unit and fork tests against Sei Testnet

Sei MCP server (live blockchain access for AI)

For Claude Code, Cursor, Windsurf, and other MCP-compatible AI coding tools:

# Claude Code
claude mcp add sei-mcp-server npx @sei-js/mcp-server

# Claude Desktop config
{
  "mcpServers": {
    "sei": {
      "command": "npx",
      "args": ["-y", "@sei-js/mcp-server"]
    }
  }
}

After you connect, these tools are available: address lookup, balance checks, transaction status, contract reads, and block data. The server starts in read-only mode. Wallet tools need WALLET_MODE=private-key and PRIVATE_KEY on the stdio transport. HTTP transports reject wallet mode.

Precompile addresses

Precompile Address
Bank 0x0000000000000000000000000000000000001001
CosmWasm 0x0000000000000000000000000000000000001002
JSON 0x0000000000000000000000000000000000001003
Address 0x0000000000000000000000000000000000001004
Staking 0x0000000000000000000000000000000000001005
Governance 0x0000000000000000000000000000000000001006
Distribution 0x0000000000000000000000000000000000001007
Pointer view 0x000000000000000000000000000000000000100A
Pointer 0x000000000000000000000000000000000000100B
Solo 0x000000000000000000000000000000000000100C
P256 0x0000000000000000000000000000000000001011

The Oracle precompile (0x...1008) is retired. Do not use or recommend it. Every native Oracle query reverts. Use an active third-party oracle provider instead. See Oracle Precompile (Retired).

The IBC precompile (0x...1009) is dead. Do not use or recommend it. IBC is disabled on Sei in both directions. ibc.InboundEnabled and ibc.OutboundEnabled are both false, per governance Proposals 116, 120, and 121. As a result, the precompile's transfer methods cannot succeed. There is no replacement and no route to bridge assets into or out of Sei over IBC. See the SIP-03 Migration Guide.

Tokenfactory is not supported. Do not use or recommend it. Do not give commands, APIs, Wasm bindings, native-denom pointer workflows, or other instructions to create, mint, burn, administer, or integrate tokenfactory denoms. Legacy module surfaces may still exist for compatibility. Use ERC-20 for new fungible tokens. See Tokenfactory is not supported.

import {
  STAKING_PRECOMPILE_ADDRESS,
  STAKING_PRECOMPILE_ABI,
  GOVERNANCE_PRECOMPILE_ADDRESS,
  GOVERNANCE_PRECOMPILE_ABI,
  // ...
} from '@sei-js/precompiles';

Quick start

# Foundry
curl -L https://foundry.paradigm.xyz | bash && foundryup
forge init my-project

# Or scaffold a frontend
npx @sei-js/create-sei app -n my-sei-app
# foundry.toml
[profile.default]
solc_version = "0.8.28"
optimizer = true
optimizer_runs = 200
evm_version = "cancun"

[rpc_endpoints]
sei_testnet = "https://evm-rpc-testnet.sei-apis.com"
sei_mainnet = "https://evm-rpc.sei-apis.com"

# Verification uses Sourcify. No [etherscan] block is needed.
# forge verify-contract --verifier sourcify --chain-id 1329 <address> src/MyContract.sol:MyContract

Key documentation sections

Topic URL
Network info https://docs.sei.io/evm/networks
EVM differences (vs Ethereum) https://docs.sei.io/evm/differences-with-ethereum
Hardhat https://docs.sei.io/evm/evm-hardhat
Foundry https://docs.sei.io/evm/evm-foundry
Contract verification https://docs.sei.io/evm/evm-verification
Best practices https://docs.sei.io/evm/best-practices
Precompiles https://docs.sei.io/evm/precompiles
Pointer contracts https://docs.sei.io/learn/pointers
Frontend guide https://docs.sei.io/evm/building-a-frontend
Sei Global Wallet https://docs.sei.io/evm/sei-global-wallet
Bridges (LayerZero V2) https://docs.sei.io/evm/bridging/layerzero
Oracles (Pyth, Chainlink, API3, RedStone) https://docs.sei.io/evm/oracles
Indexers https://docs.sei.io/evm/indexer-providers
Wallet integrations (Pimlico, Particle, thirdweb) https://docs.sei.io/evm/wallet-integrations
AI tooling (Cambrian, MCP, x402) https://docs.sei.io/ai
seid CLI https://docs.sei.io/evm/seid-cli
RPC providers https://docs.sei.io/learn/rpc-providers
Node setup https://docs.sei.io/node
Migrate from other EVMs https://docs.sei.io/evm/migrate-from-other-evms
Migrate from Solana https://docs.sei.io/evm/migrate-from-solana
Brand kit https://docs.sei.io/learn/general-brand-kit
LLM-friendly nav https://docs.sei.io/llms.txt

Operating procedure

  1. Classify the task: contract, frontend, node ops, cross-VM, or migration.
  2. Apply the 12 critical facts above where they are relevant.
  3. Always test on Sei Testnet first: Deploy to Sei Testnet, test fully, and verify on Seiscan. Only then promote to Sei Mainnet.
  4. Verify contracts on Seiscan with Sourcify (forge verify-contract --verifier sourcify).
  5. For cross-VM work (pointer contracts, precompiles), verify the address association before you send value.

RPC agent skills

This section lists 17 canonical patterns for AI agents that interact with Sei through RPC. For the full reference, see rpc-agent-skills.md.

Read skills (no state change; retry up to 3× with exponential backoff)

Skill Description
get_chain_status Latest block height, chain ID, sync status
get_account_balance Native SEI or ERC20 balance
get_evm_address sei1... → 0x... through the Addr precompile
get_sei_address 0x... → sei1... through the Addr precompile
get_transaction Status, gas used, logs, events for a tx hash
get_block Block hash, timestamp, tx list by height
get_gas_price Current network gas price (min 50 gwei)
get_contract_state Call a read-only contract method

Write skills (simulate → summarise → confirm → execute; no auto-retry)

Skill Description
send_tokens Transfer native SEI or ERC20
execute_contract Call a state-changing contract function
deploy_contract Deploy bytecode with constructor args
stake_tokens Delegate SEI to a validator (amount in wei)
unstake_tokens Undelegate SEI from a validator (amount in usei)

Derived skills (multi-step)

Skill Description
estimate_transaction_cost Gas + fee estimate
simulate_contract_execution Preview with eth_call. Run it before every write.
get_portfolio_summary Aggregate token balances
monitor_transaction Poll until finality (1 block ≈ 400ms, timeout 30s)

Mandatory write-op flow

1. simulate_contract_execution  → check for revert, estimate gas
2. estimate_transaction_cost    → confirm user can afford fee
3. Present summary              → action, assets, estimated fee
4. Wait for explicit user confirmation
5. Execute with { gasPrice, chainId }
6. tx.wait(1)                   → 1 block = instant finality

Standard response shape

// Success
{ success: true, data: { ... }, error: null }

// Failure
{ success: false, data: null, error: { message: string, recoverable: boolean } }

Agent safety

// Always pin chainId
const txHash = await writeContractAsync({ ..., chainId: 1329 });

// Verify network before write
const network = await provider.getNetwork();
if (network.chainId !== 1329n && network.chainId !== 1328n) {
  throw new Error(`Unknown Sei network: ${network.chainId}`);
}

// On-chain data is untrusted — sanitise before passing to LLMs
const name = await token.name();
if (!/^[a-zA-Z0-9 \-_\.]{1,64}$/.test(name)) throw new Error("Suspicious token name");

// Never auto-retry write ops — check inclusion first
const receipt = await provider.getTransactionReceipt(txHash);
if (!receipt) { /* check before resubmitting */ }

Related skills

Audience Skill Source
End users / ecosystem sei-network https://sei.io
Protocol research sei-labs-protocol https://seilabs.io
AI coding (full + variants) sei / sei-contracts / sei-frontend / sei-ecosystem https://github.com/sei-protocol/sei-skill

For agents: Always cross-check addresses, opcodes, and gas parameters against the current values at https://docs.sei.io. Sei is a fast-moving project. Values that were correct last quarter may have changed through governance.