ox

import type * as Address from './Address.js'; import type * as Errors from './Errors.js'; import * as Hex from './Hex.js'; import type { Compute } from './internal/types.js'; import * as Log from './Log.js'; /** An Transaction Receipt as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/receipt.yaml). */ export type TransactionReceipt<status = Status, type = Type, bigintType = bigint, numberType = number> = Compute<{ /** The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844. */ blobGasPrice?: bigintType | undefined; /** The amount of blob gas used. Only specified for blob transactions as defined by EIP-4844. */ blobGasUsed?: bigintType | undefined; /** Hash of block containing this transaction */ blockHash: Hex.Hex; /** Number of block containing this transaction */ blockNumber: bigintType; /** Address of new contract or `null` if no contract was created */ contractAddress?: Address.Address | null | undefined; /** Gas used by this and all preceding transactions in this block */ cumulativeGasUsed: bigintType; /** Pre-London, it is equal to the transaction's gasPrice. Post-London, it is equal to the actual gas price paid for inclusion. */ effectiveGasPrice: bigintType; /** Transaction sender */ from: Address.Address; /** Gas used by this transaction */ gasUsed: bigintType; /** List of log objects generated by this transaction */ logs: Log.Log<false, bigintType, numberType>[]; /** Logs bloom filter */ logsBloom: Hex.Hex; /** The post-transaction state root. Only specified for transactions included before the Byzantium upgrade. */ root?: Hex.Hex | undefined; /** `success` if this transaction was successful or `reverted` if it failed */ status: status; /** Transaction recipient or `null` if deploying a contract */ to: Address.Address | null; /** Hash of this transaction */ transactionHash: Hex.Hex; /** Index of this transaction in the block */ transactionIndex: numberType; /** Transaction type */ type: type; }>; /** An RPC Transaction Receipt as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/receipt.yaml). */ export type Rpc = TransactionReceipt<RpcStatus, RpcType, Hex.Hex, Hex.Hex>; /** * Union of Transaction Receipt statuses. * * - `success` * - `reverted` */ export type Status = 'success' | 'reverted'; /** * Union of RPC Transaction Receipt statuses. * * - `0x0` * - `0x1` */ export type RpcStatus = '0x0' | '0x1'; /** * Union of Transaction Receipt types. * * - `legacy` * - `eip1559` * - `eip2930` * - `eip4844` * - `eip7702` * - any other string */ export type Type = 'legacy' | 'eip1559' | 'eip2930' | 'eip4844' | 'eip7702' | (string & {}); /** * Union of RPC Transaction Receipt types. * * - `0x0`: legacy transactions * - `0x1`: EIP-1559 transactions * - `0x2`: EIP-2930 transactions * - `0x3`: EIP-4844 transactions * - `0x4`: EIP-7702 transactions * - any other string */ export type RpcType = '0x0' | '0x1' | '0x2' | '0x3' | '0x4' | (string & {}); /** RPC status to status mapping. */ export declare const fromRpcStatus: { readonly '0x0': "reverted"; readonly '0x1': "success"; }; /** Status to RPC status mapping. */ export declare const toRpcStatus: { readonly reverted: "0x0"; readonly success: "0x1"; }; /** RPC type to type mapping. */ export declare const fromRpcType: { readonly '0x0': "legacy"; readonly '0x1': "eip2930"; readonly '0x2': "eip1559"; readonly '0x3': "eip4844"; readonly '0x4': "eip7702"; }; /** Type to RPC type mapping. */ export declare const toRpcType: { readonly legacy: "0x0"; readonly eip2930: "0x1"; readonly eip1559: "0x2"; readonly eip4844: "0x3"; readonly eip7702: "0x4"; }; /** * Converts a {@link ox#TransactionReceipt.Rpc} to an {@link ox#TransactionReceipt.TransactionReceipt}. * * @example * ```ts twoslash * import { TransactionReceipt } from 'ox' * * const receipt = TransactionReceipt.fromRpc({ * blobGasPrice: '0x42069', * blobGasUsed: '0x1337', * blockHash: * '0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b', * blockNumber: '0x12f296f', * contractAddress: null, * cumulativeGasUsed: '0x82515', * effectiveGasPrice: '0x21c2f6c09', * from: '0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6', * gasUsed: '0x2abba', * logs: [], * logsBloom: * '0x00200000000000000000008080000000000000000040000000000000000000000000000000000000000000000000000022000000080000000000000000000000000000080000000000000008000000200000000000000000000200008020400000000000000000280000000000100000000000000000000000000010000000000000000000020000000000000020000000000001000000080000004000000000000000000000000000000000000000000000400000000000001000000000000000000002000000000000000020000000000000000000001000000000000000000000200000000000000000000000000000001000000000c00000000000000000', * status: '0x1', * to: '0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad', * transactionHash: * '0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0', * transactionIndex: '0x2', * type: '0x2' * }) * // @log: { * // @log: blobGasPrice: 270441n, * // @log: blobGasUsed: 4919n, * // @log: blockHash: "0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b", * // @log: blockNumber: 19868015n, * // @log: contractAddress: null, * // @log: cumulativeGasUsed: 533781n, * // @log: effectiveGasPrice: 9062804489n, * // @log: from: "0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6", * // @log: gasUsed: 175034n, * // @log: logs: [], * // @log: logsBloom: "0x00200000000000000000008080000000000000000040000000000000000000000000000000000000000000000000000022000000080000000000000000000000000000080000000000000008000000200000000000000000000200008020400000000000000000280000000000100000000000000000000000000010000000000000000000020000000000000020000000000001000000080000004000000000000000000000000000000000000000000000400000000000001000000000000000000002000000000000000020000000000000000000001000000000000000000000200000000000000000000000000000001000000000c00000000000000000", * // @log: root: undefined, * // @log: status: "success", * // @log: to: "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", * // @log: transactionHash: "0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0", * // @log: transactionIndex: 2, * // @log: type: "eip1559", * // @log: } * ``` * * @example * ### End-to-end * * Below is an example of how to use the `TransactionReceipt.fromRpc` method to convert an RPC transaction receipt to a {@link ox#TransactionReceipt.TransactionReceipt} object. * * ```ts twoslash * import 'ox/window' * import { TransactionReceipt } from 'ox' * * const receipt = await window * .ethereum!.request({ * method: 'eth_getTransactionReceipt', * params: [ * '0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0' * ] * }) * .then(TransactionReceipt.fromRpc) // [!code hl] * // @log: { * // @log: blobGasPrice: 270441n, * // @log: blobGasUsed: 4919n, * // @log: blockHash: "0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b", * // @log: blockNumber: 19868015n, * // @log: contractAddress: null, * // @log: cumulativeGasUsed: 533781n, * // @log: effectiveGasPrice: 9062804489n, * // @log: from: "0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6", * // @log: gasUsed: 175034n, * // @log: logs: [], * // @log: logsBloom: "0x00200000000000000000008080000000000000000040000000000000000000000000000000000000000000000000000022000000080000000000000000000000000000080000000000000008000000200000000000000000000200008020400000000000000000280000000000100000000000000000000000000010000000000000000000020000000000000020000000000001000000080000004000000000000000000000000000000000000000000000400000000000001000000000000000000002000000000000000020000000000000000000001000000000000000000000200000000000000000000000000000001000000000c00000000000000000", * // @log: root: undefined, * // @log: status: "success", * // @log: to: "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", * // @log: transactionHash: "0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0", * // @log: transactionIndex: 2, * // @log: type: "eip1559", * // @log: } * ``` * * :::note * * For simplicity, the above example uses `window.ethereum.request`, but you can use any * type of JSON-RPC interface. * * ::: * * @param receipt - The RPC receipt to convert. * @returns An instantiated {@link ox#TransactionReceipt.TransactionReceipt}. */ export declare function fromRpc<const receipt extends Rpc | null>(receipt: receipt | Rpc | null): receipt extends Rpc ? TransactionReceipt : null; export declare namespace fromRpc { type ErrorType = Log.fromRpc.ErrorType | Errors.GlobalErrorType; } /** * Converts a {@link ox#TransactionReceipt.TransactionReceipt} to a {@link ox#TransactionReceipt.Rpc}. * * @example * ```ts twoslash * import { TransactionReceipt } from 'ox' * * const receipt = TransactionReceipt.toRpc({ * blobGasPrice: 270441n, * blobGasUsed: 4919n, * blockHash: * '0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b', * blockNumber: 19868015n, * contractAddress: null, * cumulativeGasUsed: 533781n, * effectiveGasPrice: 9062804489n, * from: '0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6', * gasUsed: 175034n, * logs: [], * logsBloom: * '0x00200000000000000000008080000000000000000040000000000000000000000000000000000000000000000000000022000000080000000000000000000000000000080000000000000008000000200000000000000000000200008020400000000000000000280000000000100000000000000000000000000010000000000000000000020000000000000020000000000001000000080000004000000000000000000000000000000000000000000000400000000000001000000000000000000002000000000000000020000000000000000000001000000000000000000000200000000000000000000000000000001000000000c00000000000000000', * root: undefined, * status: 'success', * to: '0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad', * transactionHash: * '0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0', * transactionIndex: 2, * type: 'eip1559' * }) * // @log: { * // @log: blobGasPrice: "0x042069", * // @log: blobGasUsed: "0x1337", * // @log: blockHash: "0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b", * // @log: blockNumber: "0x012f296f", * // @log: contractAddress: null, * // @log: cumulativeGasUsed: "0x082515", * // @log: effectiveGasPrice: "0x021c2f6c09", * // @log: from: "0x814e5e0e31016b9a7f138c76b7e7b2bb5c1ab6a6", * // @log: gasUsed: "0x02abba", * // @log: logs: [], * // @log: logsBloom: "0x00200000000000000000008080000000000000000040000000000000000000000000000000000000000000000000000022000000080000000000000000000000000000080000000000000008000000200000000000000000000200008020400000000000000000280000000000100000000000000000000000000010000000000000000000020000000000000020000000000001000000080000004000000000000000000000000000000000000000000000400000000000001000000000000000000002000000000000000020000000000000000000001000000000000000000000200000000000000000000000000000001000000000c00000000000000000", * // @log: root: undefined, * // @log: status: "0x1", * // @log: to: "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", * // @log: transactionHash: "0x353fdfc38a2f26115daadee9f5b8392ce62b84f410957967e2ed56b35338cdd0", * // @log: transactionIndex: "0x02", * // @log: type: "eip1559", * // @log: } * ``` * * @param receipt - The receipt to convert. * @returns An RPC receipt. */ export declare function toRpc(receipt: toRpc.Input): Rpc; export declare namespace toRpc { /** Numberish input accepted by {@link ox#TransactionReceipt.(toRpc:function)}. */ type Input = TransactionReceipt<Status, Type, Hex.Hex | bigint | number, Hex.Hex | number>; type ErrorType = Hex.fromNumber.ErrorType | Errors.GlobalErrorType; } //# sourceMappingURL=TransactionReceipt.d.ts.map