Bank Precompile

Address: 0x0000000000000000000000000000000000001001

This page covers native SEI (usei) only. Do not use the Bank precompile as an IBC or tokenfactory integration path. IBC is disabled in both directions, and tokenfactory is not supported for new development. See IBC is disabled and Tokenfactory is not supported.

The Bank precompile exposes the Bank Module balance for native SEI and lets an EVM caller send SEI to a native sei1... address.

Functions

/// Returns an account's Bank Module balance for the requested denomination.
function balance(
    address account,
    string memory denom
) external view returns (uint256 amount);

/// Sends the attached native SEI to a native Sei address.
function sendNative(
    string memory toNativeAddress
) external payable returns (bool success);

The examples below use balance() with usei. They do not cover arbitrary Bank Module denominations.

Setup

npm install ethers @sei-js/precompiles

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

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

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

const writeBank = new ethers.Contract(
  BANK_PRECOMPILE_ADDRESS,
  BANK_PRECOMPILE_ABI,
  signer,
);

Query a native SEI balance

Bank Module queries return native SEI in usei, where 1 SEI equals 1,000,000 usei.

const account = '0x1234567890123456789012345678901234567890';
const balanceUsei = await readBank.balance(account, 'usei');

console.log(`${ethers.formatUnits(balanceUsei, 6)} SEI`);

You can make the same query from Solidity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

interface IBankPrecompile {
    function balance(
        address account,
        string memory denom
    ) external view returns (uint256 amount);
}

contract SeiBalanceReader {
    IBankPrecompile private constant BANK =
        IBankPrecompile(0x0000000000000000000000000000000000001001);

    function nativeSeiBalance(address account) external view returns (uint256) {
        return BANK.balance(account, "usei");
    }
}

Send native SEI to a native address

sendNative() accepts SEI through msg.value. Use an 18-decimal EVM value for the transaction.

const recipient = 'sei1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq6s8dpw';

const transaction = await writeBank.sendNative(recipient, {
  value: ethers.parseEther('0.1'),
});

await transaction.wait();

From Solidity, forward the attached value to the precompile:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

interface IBankPrecompile {
    function sendNative(
        string memory toNativeAddress
    ) external payable returns (bool success);
}

contract NativeSeiSender {
    IBankPrecompile private constant BANK =
        IBankPrecompile(0x0000000000000000000000000000000000001001);

    function sendToNativeAddress(
        string calldata recipient
    ) external payable {
        require(msg.value > 0, "No SEI attached");
        require(
            BANK.sendNative{value: msg.value}(recipient),
            "Transfer failed"
        );
    }
}

Validate the recipient before sending. A successful transaction cannot be reversed.

Overview

Essentials

seid CLI

Frontend Development

Smart Contracts

sei-js Library

Videos

Ecosystem Tutorials

Reference

Hardware Wallets

Functions

Setup

Query a native SEI balance

Send native SEI to a native address

​Functions

​Setup

​Query a native SEI balance

​Send native SEI to a native address

Functions

Setup

Query a native SEI balance

Send native SEI to a native address