@vechain/sdk-network/src/provider/utils/rpc-mapper/methods/eth_getBalance/eth_getBalance.ts

This module serves as the standard interface connecting decentralized applications (dApps) and users to the VeChainThor blockchain

import { type ThorClient } from '../../../../../thor-client';
import {
    JSONRPCInternalError,
    JSONRPCInvalidParams,
    stringifyData
} from '@vechain/sdk-errors';
import { type DefaultBlock, DefaultBlockToRevision } from '../../../const';
import { RPC_DOCUMENTATION_URL } from '../../../../../utils';
import { Address } from '@vechain/sdk-core';

/**
 * RPC Method eth_getBalance implementation
 *
 * @link [eth_getBalance](https://ethereum.github.io/execution-apis/api-documentation/)
 *
 * @note Only 'latest' and 'finalized' block numbers are supported.
 *
 * @param thorClient - ThorClient instance.
 * @param params - The standard array of rpc call parameters.
 *                * params[0]: The address to get the balance for as a hex string.
 *                * params[1]: The block number to get the balance at as a hex string or "latest".
 * @returns the balance of the account at the given address formatted to the RPC standard.
 * @throws {JSONRPCInvalidParams, JSONRPCInternalError}
 */
const ethGetBalance = async (
    thorClient: ThorClient,
    params: unknown[]
): Promise<string> => {
    // Input validation
    if (
        params.length !== 2 ||
        typeof params[0] !== 'string' ||
        (typeof params[1] !== 'object' && typeof params[1] !== 'string')
    )
        throw new JSONRPCInvalidParams(
            'eth_getBalance',
            `Invalid input params for "eth_getBalance" method. See ${RPC_DOCUMENTATION_URL} for details.`,
            { params }
        );

    try {
        const [address, block] = params as [string, DefaultBlock];

        // Get the account details
        const accountDetails = await thorClient.accounts.getAccount(
            Address.of(address),
            {
                revision: DefaultBlockToRevision(block)
            }
        );

        return accountDetails.balance;
    } catch (e) {
        throw new JSONRPCInternalError(
            'eth_getBalance()',
            'Method "eth_getBalance" failed.',
            {
                params: stringifyData(params),
                url: thorClient.httpClient.baseURL,
                innerError: stringifyData(e)
            }
        );
    }
};

export { ethGetBalance };