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

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

import { ThorId } from '@vechain/sdk-core';
import {
    JSONRPCInternalError,
    JSONRPCInvalidParams,
    stringifyData
} from '@vechain/sdk-errors';
import {
    type ExpandedBlockDetail,
    type ThorClient
} from '../../../../../thor-client';
import { RPC_DOCUMENTATION_URL } from '../../../../../utils/const/rpc/rpc';
import {
    type TransactionReceiptRPC,
    transactionsFormatter
} from '../../../formatter';
import { ethChainId } from '../eth_chainId';

/**
 * RPC Method eth_getTransactionReceipt implementation
 *
 * @link [eth_getTransactionReceipt](https://ethereum.github.io/execution-apis/api-documentation/)
 *
 * @param thorClient - The thor client instance to use.
 *
 * @param params - The standard array of rpc call parameters.
 *                 * params[0]: The transaction hash to get as a hex string.
 *
 * @throws {ProviderRpcError} - Will throw an error if the retrieval of the transaction fails.
 */
const ethGetTransactionReceipt = async (
    thorClient: ThorClient,
    params: unknown[]
): Promise<TransactionReceiptRPC | null> => {
    // Input validation
    if (params.length !== 1 || typeof params[0] !== 'string')
        throw new JSONRPCInvalidParams(
            'eth_getTransactionReceipt',
            `Invalid input params for "eth_getTransactionReceipt" method. See ${RPC_DOCUMENTATION_URL} for details.`,
            { params }
        );

    // Invalid transaction ID
    if (!ThorId.isValid(params[0])) {
        throw new JSONRPCInvalidParams(
            'eth_getTransactionReceipt',
            'Invalid transaction ID given as input. Input must be an hex string of length 64.',
            { params }
        );
    }

    try {
        // Get hash by params
        const [hash] = params as [string];

        // Get transaction receipt
        const receipt =
            await thorClient.transactions.getTransactionReceipt(hash);

        // Receipt is not null (transaction exists. This implies: Block exists and Transaction details exists)
        if (receipt !== null) {
            // Get the block containing the transaction. @note: It cannot be null!. If some error occurs, it will be thrown.
            const blockContainsTransaction =
                (await thorClient.blocks.getBlockExpanded(
                    receipt.meta.blockID
                )) as ExpandedBlockDetail;

            // Get transaction detail. @note: It cannot be null!. If some error occurs, it will be thrown.
            const transactionDetail =
                await thorClient.transactions.getTransaction(hash);

            // Get the chain id
            const chainId = await ethChainId(thorClient);

            // Initialize the result
            if (transactionDetail !== null)
                return transactionsFormatter.formatTransactionReceiptToRPCStandard(
                    hash,
                    receipt,
                    transactionDetail,
                    blockContainsTransaction,
                    chainId
                );
            else return null;
        } else {
            return null;
        }
    } catch (e) {
        throw new JSONRPCInternalError(
            'eth_getTransactionReceipt()',
            'Method "eth_getTransactionReceipt" failed.',
            {
                params: stringifyData(params),
                url: thorClient.httpClient.baseURL,
                innerError: stringifyData(e)
            }
        );
    }
};

export { ethGetTransactionReceipt };