UNPKG

viem

Version:

TypeScript Interface for Ethereum

59 lines 2.31 kB
import type { Address } from 'abitype'; import type { Client } from '../../clients/createClient.js'; import type { Transport } from '../../clients/transports/createTransport.js'; import type { ErrorType } from '../../errors/utils.js'; import type { BlockTag } from '../../types/block.js'; import type { Chain } from '../../types/chain.js'; import type { RequestErrorType } from '../../utils/buildRequest.js'; import { type NumberToHexErrorType } from '../../utils/encoding/toHex.js'; export type GetBalanceParameters = { /** The address of the account. */ address: Address; } & ({ /** The balance of the account at a block number. */ blockNumber?: bigint | undefined; blockTag?: undefined; } | { blockNumber?: undefined; /** The balance of the account at a block tag. */ blockTag?: BlockTag | undefined; }); export type GetBalanceReturnType = bigint; export type GetBalanceErrorType = NumberToHexErrorType | RequestErrorType | ErrorType; /** * Returns the balance of an address in wei. * * - Docs: https://viem.sh/docs/actions/public/getBalance * - JSON-RPC Methods: [`eth_getBalance`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance) * * You can convert the balance to ether units with [`formatEther`](https://viem.sh/docs/utilities/formatEther). * * ```ts * const balance = await getBalance(client, { * address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e', * blockTag: 'safe' * }) * const balanceAsEther = formatEther(balance) * // "6.942" * ``` * * @param client - Client to use * @param parameters - {@link GetBalanceParameters} * @returns The balance of the address in wei. {@link GetBalanceReturnType} * * @example * import { createPublicClient, http } from 'viem' * import { mainnet } from 'viem/chains' * import { getBalance } from 'viem/public' * * const client = createPublicClient({ * chain: mainnet, * transport: http(), * }) * const balance = await getBalance(client, { * address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e', * }) * // 10000000000000000000000n (wei) */ export declare function getBalance<chain extends Chain | undefined>(client: Client<Transport, chain>, { address, blockNumber, blockTag }: GetBalanceParameters): Promise<GetBalanceReturnType>; //# sourceMappingURL=getBalance.d.ts.map