Precompile Example Usage

Sei precompiles are special smart contracts deployed at fixed addresses. They expose native Sei functionality to EVM applications. You can call them like any standard smart contract, with viem, ethers, or wagmi.

Available precompiles:

Precompile	Address	Description
Bank	`0x0000000000000000000000000000000000001001`	Query the native SEI bank balance
CosmWasm	`0x0000000000000000000000000000000000001002`	Query or execute existing CosmWasm contracts. `instantiate()` reverts (Proposal 115).
JSON	`0x0000000000000000000000000000000000001003`	Parse JSON data within contracts
Address	`0x0000000000000000000000000000000000001004`	Convert and associate EVM and Sei addresses
Staking	`0x0000000000000000000000000000000000001005`	Delegation and staking operations
Governance	`0x0000000000000000000000000000000000001006`	Proposal voting
Distribution	`0x0000000000000000000000000000000000001007`	Claim staking rewards
Pointer view	`0x000000000000000000000000000000000000100A`	Look up pointer contract addresses
Pointer	`0x000000000000000000000000000000000000100B`	Register pointer contracts
Solo	`0x000000000000000000000000000000000000100C`	Claim Solo migration payloads
Auth	`0x000000000000000000000000000000000000100D`	Query accounts, auth parameters, and the next account number
Authz	`0x000000000000000000000000000000000000100E`	Query authz grants
Evidence	`0x000000000000000000000000000000000000100F`	Query evidence of validator misbehavior
P256	`0x0000000000000000000000000000000000001011`	Verify P-256 elliptic curve signatures
Mint	`0x0000000000000000000000000000000000001012`	Query mint parameters and the minter state
Params	`0x0000000000000000000000000000000000001013`	Query module parameters by subspace and key
Slashing	`0x0000000000000000000000000000000000001014`	Query slashing parameters and signing info, and unjail validators
Upgrade	`0x0000000000000000000000000000000000001015`	Query upgrade plans and module versions

This page shows Bank, Staking, Governance, Distribution, JSON, and Solo. The other precompiles have their own pages: CosmWasm, Address, Pointer contracts for both pointer precompiles, P256, Auth, Authz, Evidence, Mint, Params, Slashing, and Upgrade.

The @sei-js/precompiles package does not export the IBC and Oracle precompiles. IBC is disabled in both directions, and native Oracle queries are retired. Calls to either precompile cannot succeed on live Sei. See IBC is disabled and Oracle Precompile (Retired).

@sei-js/precompiles@3 is ESM-only and matches the Sei Chain v6.6.1 ABIs. It does not include the Auth, Authz, Evidence, Mint, Params, Slashing, and Upgrade precompiles. It also does not include the methods that v6.7 added to Bank, Distribution, Governance, and Staking. For those ABIs, use the abi.json files in the sei-chain precompiles directory. Import raw *_PRECOMPILE_ABI constants from the package root, @sei-js/precompiles/precompiles, or @sei-js/precompiles/viem. Import the ethers factories from @sei-js/precompiles/ethers. The package does not expose VIEM_*_PRECOMPILE_ABI aliases. It re-exports the viem sei and seiTestnet definitions and also exports seiLocal (chain ID 713714, http://localhost:8545). The package requires viem 2.55.16 or newer.

import { getStakingPrecompileEthersV6Contract } from '@sei-js/precompiles/ethers';

Setup

npm install viem ethers @sei-js/precompiles@^3

import { createPublicClient, createWalletClient, http, custom } from 'viem';
import { sei } from 'viem/chains';

// Read-only
const client = createPublicClient({ chain: sei, transport: http() });

// Browser wallet (write)
const walletClient = createWalletClient({ chain: sei, transport: custom(window.ethereum) });
const [account] = await walletClient.getAddresses();

import { ethers } from 'ethers';

// Browser environment
const provider = new ethers.BrowserProvider(window.ethereum);
const signer = await provider.getSigner();

// Node.js / scripts
// const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');
// const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider);

Bank precompile

eth_getBalance returns only the EVM-side SEI balance. The Bank precompile lets you query the native SEI (usei) bank balance for an address:

import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

// Query a specific denom balance
const balance = await client.readContract({
  address: BANK_PRECOMPILE_ADDRESS,
  abi: BANK_PRECOMPILE_ABI,
  functionName: 'balance',
  args: ['0xYourAddress', 'usei'],
});

import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const bank = new ethers.Contract(BANK_PRECOMPILE_ADDRESS, BANK_PRECOMPILE_ABI, provider);

const balance = await bank.balance('0xYourAddress', 'usei');

Staking precompile

Delegate, undelegate, and query staking state:

import { parseEther } from 'viem';
import { STAKING_PRECOMPILE_ABI, STAKING_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

// Delegate SEI to a validator
const delegateHash = await walletClient.writeContract({
  address: STAKING_PRECOMPILE_ADDRESS,
  abi: STAKING_PRECOMPILE_ABI,
  functionName: 'delegate',
  args: ['seivaloper1...'],
  value: parseEther('10'),
});

// Query delegation
const delegation = await client.readContract({
  address: STAKING_PRECOMPILE_ADDRESS,
  abi: STAKING_PRECOMPILE_ABI,
  functionName: 'delegation',
  args: [account, 'seivaloper1...'],
});

// Undelegate 5 SEI. The amount uses 6-decimal usei (1 SEI = 1_000_000 usei), not wei.
const undelegateHash = await walletClient.writeContract({
  address: STAKING_PRECOMPILE_ADDRESS,
  abi: STAKING_PRECOMPILE_ABI,
  functionName: 'undelegate',
  args: ['seivaloper1...', 5_000_000n],
});

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

const staking = new ethers.Contract(STAKING_PRECOMPILE_ADDRESS, STAKING_PRECOMPILE_ABI, signer);
const readStaking = new ethers.Contract(STAKING_PRECOMPILE_ADDRESS, STAKING_PRECOMPILE_ABI, provider);

// Delegate 10 SEI
const tx = await staking.delegate('seivaloper1...', { value: ethers.parseEther('10') });
await tx.wait();

// Query delegation
const delegation = await readStaking.delegation(await signer.getAddress(), 'seivaloper1...');
console.log('Delegated:', delegation.balance.amount.toString());

// Undelegate 5 SEI. The amount uses 6-decimal usei (1 SEI = 1_000_000 usei), not wei.
const undelegateTx = await staking.undelegate('seivaloper1...', ethers.parseUnits('5', 6));
await undelegateTx.wait();

Governance precompile

Vote on an active governance proposal:

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

// Vote options: 1 = Yes, 2 = Abstain, 3 = No, 4 = NoWithVeto
const hash = await walletClient.writeContract({
  address: GOVERNANCE_PRECOMPILE_ADDRESS,
  abi: GOVERNANCE_PRECOMPILE_ABI,
  functionName: 'vote',
  args: [99n, 1],
});

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

const governance = new ethers.Contract(GOVERNANCE_PRECOMPILE_ADDRESS, GOVERNANCE_PRECOMPILE_ABI, signer);

// 1 = Yes, 2 = Abstain, 3 = No, 4 = NoWithVeto
const tx = await governance.vote(99n, 1);
await tx.wait();

Distribution precompile

Claim staking rewards from a validator:

import { DISTRIBUTION_PRECOMPILE_ABI, DISTRIBUTION_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const hash = await walletClient.writeContract({
  address: DISTRIBUTION_PRECOMPILE_ADDRESS,
  abi: DISTRIBUTION_PRECOMPILE_ABI,
  functionName: 'withdrawDelegationRewards',
  args: ['seivaloper1...'],
});

import { DISTRIBUTION_PRECOMPILE_ABI, DISTRIBUTION_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const distribution = new ethers.Contract(
  DISTRIBUTION_PRECOMPILE_ADDRESS,
  DISTRIBUTION_PRECOMPILE_ABI,
  signer,
);

const tx = await distribution.withdrawDelegationRewards('seivaloper1...');
await tx.wait();

JSON precompile

Parse JSON data in EVM contracts or dApps. This is useful for oracle responses, NFT metadata, and structured payloads:

import { toHex, toBytes } from 'viem';
import { JSON_PRECOMPILE_ABI, JSON_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const data = { price: 100, symbol: 'SEI' };
const inputBytes = toBytes(JSON.stringify(data));

// Extract a string value
const symbolBytes = await client.readContract({
  address: JSON_PRECOMPILE_ADDRESS,
  abi: JSON_PRECOMPILE_ABI,
  functionName: 'extractAsBytes',
  args: [inputBytes, 'symbol'],
});

// Extract a numeric value
const price = await client.readContract({
  address: JSON_PRECOMPILE_ADDRESS,
  abi: JSON_PRECOMPILE_ABI,
  functionName: 'extractAsUint256',
  args: [inputBytes, 'price'],
});

import { JSON_PRECOMPILE_ABI, JSON_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const jsonPrecompile = new ethers.Contract(JSON_PRECOMPILE_ADDRESS, JSON_PRECOMPILE_ABI, provider);

const data = { price: 100, symbol: 'SEI' };
const inputData = ethers.toUtf8Bytes(JSON.stringify(data));

// Extract a string value
const symbolBytes = await jsonPrecompile.extractAsBytes(inputData, 'symbol');
const symbol = ethers.toUtf8String(symbolBytes);

// Extract a numeric value
const price = await jsonPrecompile.extractAsUint256(inputData, 'price');

console.log(`${symbol}: ${price}`);

Solo precompile

Claim a Solo migration payload. Both functions take the signed payload as bytes and return a boolean:

import { SOLO_PRECOMPILE_ABI, SOLO_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';

const hash = await walletClient.writeContract({
  address: SOLO_PRECOMPILE_ADDRESS,
  abi: SOLO_PRECOMPILE_ABI,
  functionName: 'claim',
  args: ['0xYourPayloadBytes'],
});

import { getSoloPrecompileEthersV6Contract } from '@sei-js/precompiles/ethers';

const solo = getSoloPrecompileEthersV6Contract(signer);

const tx = await solo.claim('0xYourPayloadBytes');
await tx.wait();

To claim a single payload instead of everything available to the address, use claimSpecific with the same argument shape.

Common patterns

Error handling

Wrap precompile calls in try/catch and check for specific error codes:

try {
  const tx = await staking.delegate('seivaloper1...', { value: ethers.parseEther('10') });
  const receipt = await tx.wait();
  console.log('Success:', receipt.hash);
} catch (err: any) {
  if (err.code === 'INSUFFICIENT_FUNDS') {
    console.error('Not enough SEI');
  } else if (err.code === 4001 || err.code === 'ACTION_REJECTED') {
    console.log('User rejected');
  } else {
    console.error('Transaction failed:', err.message);
  }
}

Batch read operations

Fetch multiple precompile values in parallel:

const [delegation1, delegation2, rewards] = await Promise.all([
  readStaking.delegation(address, validator1),
  readStaking.delegation(address, validator2),
  distribution.rewards(address),
]);

Gas limits

Precompile calls that write state need enough gas. Use estimateContractGas instead of a hard-coded value:

viem

const gas = await client.estimateContractGas({
  account,
  address: STAKING_PRECOMPILE_ADDRESS,
  abi: STAKING_PRECOMPILE_ABI,
  functionName: 'delegate',
  args: ['seivaloper1...'],
  value: parseEther('10'),
});

Full working example

This Node.js script delegates SEI and then casts a governance vote:

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

async function main() {
  const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');
  const wallet = new ethers.Wallet(process.env.PRIVATE_KEY!, provider);

  const staking = new ethers.Contract(STAKING_PRECOMPILE_ADDRESS, STAKING_PRECOMPILE_ABI, wallet);
  const governance = new ethers.Contract(GOVERNANCE_PRECOMPILE_ADDRESS, GOVERNANCE_PRECOMPILE_ABI, wallet);

  // Check current delegation
  const readStaking = staking.connect(provider) as typeof staking;
  const delegation = await readStaking.delegation(wallet.address, 'seivaloper1...');
  console.log('Current delegation:', delegation.balance.amount.toString());

  // Delegate 1 SEI
  const delegateTx = await staking.delegate('seivaloper1...', { value: ethers.parseEther('1') });
  await delegateTx.wait();
  console.log('Delegated 1 SEI');

  // Vote Yes on proposal 99
  const voteTx = await governance.vote(99n, 1);
  await voteTx.wait();
  console.log('Vote cast');
}

main().catch(console.error);

Run the script:

PRIVATE_KEY=your_key npx tsx script.ts

Next steps

For the full ABI reference and all available functions of each precompile, see these pages:

Overview

Essentials

seid CLI

Frontend Development

Smart Contracts

sei-js Library

Ecosystem Tutorials

Reference

Hardware Wallets

Precompile Example Usage

Setup

Bank precompile

Staking precompile

Governance precompile

Distribution precompile

JSON precompile

Solo precompile

Common patterns

Error handling

Batch read operations

Gas limits

Full working example

Next steps

​Setup

​Bank precompile

​Staking precompile

​Governance precompile

​Distribution precompile

​JSON precompile

​Solo precompile

​Common patterns

​Error handling

​Batch read operations

​Gas limits

​Full working example

​Next steps

Setup

Bank precompile

Staking precompile

Governance precompile

Distribution precompile

JSON precompile

Solo precompile

Common patterns

Error handling

Batch read operations

Gas limits

Full working example

Next steps