@sei-js/precompiles

TypeScript utilities and helpers for interacting with Sei's precompile contracts. Provides seamless integration with popular Ethereum development tools like Viem and Ethers.js, offering typed interfaces, contract factories, ABI's, contract addresses, and utilities specifically designed for Sei's precompile ecosystem.

📦 Installation

npm install @sei-js/precompiles
Copy

yarn add @sei-js/precompiles
Copy

pnpm add @sei-js/precompiles
Copy

Peer Dependencies

This package requires either ethers (v6+) or viem (v2+) as peer dependencies:

# For Ethers.js users
npm install ethers@^6.0.0

# For Viem users  
npm install viem@^2.0.0
Copy

🚀 Quick Start

With Viem

import { createPublicClient, http } from 'viem'
import { seiMainnet } from '@sei-js/precompiles/viem'
import { BANK_PRECOMPILE_ADDRESS, bankPrecompileAbi } from '@sei-js/precompiles'

const client = createPublicClient({
  chain: seiMainnet,
  transport: http()
})

// Read token balance
const balance = await client.readContract({
  address: BANK_PRECOMPILE_ADDRESS,
  abi: bankPrecompileAbi,
  functionName: 'balance',
  args: ['0x...', 'usei']
})
Copy

With Ethers.js

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

const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com')
const bankContract = getBankPrecompileEthersV6Contract(provider)

// Read token balance
const balance = await bankContract.balance('0x...', 'usei')
Copy

📋 Available Precompiles

📖 Documentation

For comprehensive guides, examples, and API reference, visit our documentation:

📚 Complete Documentation →

Quick Links

• Quick Start Guide - Get up and running in 5 minutes
• Viem Integration - Type-safe precompile interactions with Viem
• Ethers.js Integration - Use precompile contract factories with Ethers.js

🏗️ Usage Examples

Bank Precompile - Token Operations

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

// Send tokens
await writeContract({
  address: BANK_PRECOMPILE_ADDRESS,
  abi: bankPrecompileAbi,
  functionName: 'send',
  args: [fromAddress, toAddress, 'usei', amount]
})
Copy

Oracle Precompile - Price Data

import { ORACLE_PRECOMPILE_ADDRESS, oraclePrecompileAbi } from '@sei-js/precompiles'

// Get exchange rate
const rate = await readContract({
  address: ORACLE_PRECOMPILE_ADDRESS,
  abi: oraclePrecompileAbi,
  functionName: 'getExchangeRate',
  args: ['ATOM']
})
Copy

Staking Precompile - Validator Operations

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

// Delegate to validator
await writeContract({
  address: STAKING_PRECOMPILE_ADDRESS,
  abi: stakingPrecompileAbi,
  functionName: 'delegate',
  args: [validatorAddress, amount]
})
Copy

🆘 Support

• Documentation: https://seilabs.mintlify.app
• Discord: Sei Discord
• GitHub Issues: Report a bug