Typescript library containing helper functions for interacting with the EVM on Sei.

yarn add @sei-js/evm

This package provides exports for easily interacting with wagmi, viem, and ethers.js. You can interact with the Sei EVM using all the same hooks and helper functions these tools offer. Read the Wagmi, viem, and ethers v6 documentation for more information on how to use these tools.

Ensure that your EVM wallet has the Sei network enabled. Learn more on how to set up your wallet.

The WagmiProvider is a React context provider that allows you to easily interact with the EVM. It provides many useful hooks for reading and writing on Sei via the EVM JSON-RPC.

import { ReactNode } from 'react';
import { WagmiProvider } from 'wagmi';
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
import { ARCTIC_1_VIEM_CHAIN, createWagmiConfig } from '@sei-js/evm';

const queryClient = new QueryClient();

export const WalletProvider = ({ children }: { children: ReactNode }) => {
 return (
   <WagmiProvider config={createWagmiConfig([ARCTIC_1_VIEM_CHAIN])}>
     <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
   </WagmiProvider>
 );
};

The 'ethers' package is a popular library for interacting with the Ethereum blockchain. This package provides a helper function for creating an ethers provider that is connected to the Sei EVM.

import { ADDRESS_PRECOMPILE_ADDRESS } from '@sei-js/evm';
import { ethers } from 'ethers';

const provider = new ethers.BrowserProvider(window.ethereum); // or any other provider
const signer = await provider.getSigner();

const accounts = await provider.send('eth_requestAccounts', []);

const contract = getAddressPrecompileEthersV6Contract(ADDRESS_PRECOMPILE_ADDRESS, signer);

const cosmosAddress = await contract.getSeiAddr(accounts[0]);

This package exports viem Chains and precompile ABI's for Sei. The ABI used in the ethers example above is a viem ABI instance and the ARCTIC_1_VIEM_CHAIN is a viem Chain instance.

This package also exports a set of utility functions for interacting with the EVM on Sei.

Parses an amount of Sei to the smallest unit of Sei (uSei).

import { parseSei } from '@sei-js/evm';

const amount = parseSei('1000000');
console.log(amount); // 1000000000000000000

Sei v2 supports both EVM JSON-RPC and Cosmos RPC interfaces. In order to easily interact with certain Cosmos modules, Sei v2 has a set of precompiled contracts that can be called from the EVM.

Each precompile has contract exports a typed 'ethers' contracts and provides the ABI and contract addresses for each precompile for usage with Wagmi and viem.

The Address precompile contract enables the retrieval of associated EVM addresses for given Cosmos addresses and vice versa.

0x0000000000000000000000000000000000001004

The Bank precompile contract provides functionalities for managing balances, supply, symbols, and more.

0x0000000000000000000000000000000000001001

The Distribution precompile contract facilitates operations related to rewards withdrawal and distribution.

0x0000000000000000000000000000000000001007

The Governance precompile contract supports actions to deposit funds into proposals and vote on them.

0x0000000000000000000000000000000000001006

The JSON precompile contract facilitates interoperability between the EVM and Cosmos by providing functions to extract data in various formats.

• arctic-1

The Staking precompile contract provides functions for delegation, re-delegation, and un-delegation staking operations.

0x0000000000000000000000000000000000001005

The WASM precompile contract facilitates execution, instantiation, and querying of WebAssembly (WASM) contracts on the Sei platform.

0x0000000000000000000000000000000000001002

The IBC precompile contract facilitates messages exchange between Sei and other IBC compatible blockchains.

0x0000000000000000000000000000000000001009