Receipt

Transaction receipt with execution details

Overview

Receipt is a branded type containing the results and metadata from executing a transaction on Ethereum. Receipts include gas usage, logs, status, and contract addresses.

import * as Receipt from '@tevm/primitives/Receipt'

const receipt = Receipt.from({
  transactionHash,
  transactionIndex: 0,
  blockHash,
  blockNumber: 19000000n,
  from: senderAddress,
  to: recipientAddress,
  cumulativeGasUsed: 42000n,
  gasUsed: 21000n,
  contractAddress: null,
  logs: [],
  logsBloom: new Uint8Array(256),
  status: TransactionStatus.success(21000n),
  effectiveGasPrice: 20000000000n,
  type: 'legacy'
})

Type Definition

type ReceiptType = {
  readonly transactionHash: TransactionHashType;
  readonly transactionIndex: TransactionIndexType;
  readonly blockHash: BlockHashType;
  readonly blockNumber: BlockNumberType;
  readonly from: AddressType;
  readonly to: AddressType | null;
  readonly cumulativeGasUsed: Uint256Type;
  readonly gasUsed: Uint256Type;
  readonly contractAddress: AddressType | null;
  readonly logs: readonly EventLogType[];
  readonly logsBloom: Uint8Array;
  readonly status: TransactionStatusType;
  readonly effectiveGasPrice: Uint256Type;
  readonly type: "legacy" | "eip2930" | "eip1559" | "eip4844" | "eip7702";
  readonly blobGasUsed?: Uint256Type;
  readonly blobGasPrice?: Uint256Type;
} & { readonly [brand]: "Receipt" }

Creating Receipts

from

Create receipt from fields.

import * as Receipt from '@tevm/primitives/Receipt'
import * as TransactionHash from '@tevm/primitives/TransactionHash'
import * as TransactionIndex from '@tevm/primitives/TransactionIndex'
import * as BlockHash from '@tevm/primitives/BlockHash'
import * as BlockNumber from '@tevm/primitives/BlockNumber'
import * as TransactionStatus from '@tevm/primitives/TransactionStatus'
import * as Address from '@tevm/primitives/Address'

const receipt = Receipt.from({
  transactionHash: TransactionHash.fromHex('0x1234...'),
  transactionIndex: TransactionIndex.from(0),
  blockHash: BlockHash.fromHex('0xabcd...'),
  blockNumber: BlockNumber.from(19000000n),
  from: Address.fromHex('0xa0cf...'),
  to: Address.fromHex('0xdac1...'),
  cumulativeGasUsed: 42000n as Uint256Type,
  gasUsed: 21000n as Uint256Type,
  contractAddress: null,
  logs: [],
  logsBloom: new Uint8Array(256),
  status: TransactionStatus.success(21000n as Uint256Type),
  effectiveGasPrice: 20000000000n as Uint256Type,
  type: 'legacy'
})

Validation: All required fields must be provided. logsBloom must be 256 bytes.

Receipt Fields

Transaction Identifiers

• transactionHash: Transaction hash
• transactionIndex: Position in block (0-based)
• blockHash: Block hash
• blockNumber: Block height

Addresses

• from: Sender address
• to: Recipient address (null for contract creation)
• contractAddress: Deployed contract address (null for non-creation)

Gas Usage

• gasUsed: Gas consumed by this transaction
• cumulativeGasUsed: Total gas used in block up to this transaction
• effectiveGasPrice: Actual gas price paid (wei per gas)

Execution Results

• status: Execution status (pending, success, failed)
• logs: Event logs emitted
• logsBloom: Bloom filter for log topics (256 bytes)

Transaction Type

• type: Transaction type
  • "legacy" - Pre-EIP-2930
  • "eip2930" - Access list transactions
  • "eip1559" - Fee market transactions
  • "eip4844" - Blob transactions
  • "eip7702" - Account abstraction

EIP-4844 (Blob Transactions)

• blobGasUsed: Gas used for blobs (optional)
• blobGasPrice: Price per blob gas (optional)

Common Patterns

Contract Creation

const creationReceipt = Receipt.from({
  // ... standard fields
  to: null,  // null indicates contract creation
  contractAddress: Address.fromHex('0x1234...'),
  // ...
})

if (creationReceipt.contractAddress) {
  console.log('Contract deployed at:',
    creationReceipt.contractAddress.toHex())
}

Processing Logs

import * as EventLog from '@tevm/primitives/EventLog'

for (const log of receipt.logs) {
  console.log('Event from:', log.address.toHex())
  console.log('Topics:', log.topics.map(t => t.toHex()))
}

Gas Analysis

const totalGasUsed = receipt.gasUsed
const totalCost = totalGasUsed * receipt.effectiveGasPrice

console.log('Gas used:', totalGasUsed)
console.log('Cost (wei):', totalCost)

Status Checking

import * as TransactionStatus from '@tevm/primitives/TransactionStatus'

if (TransactionStatus.isSuccess(receipt.status)) {
  console.log('Transaction succeeded')
} else if (TransactionStatus.isFailed(receipt.status)) {
  console.error('Transaction failed:', receipt.status.revertReason)
}

EIP-4844 Blob Transactions

if (receipt.type === 'eip4844' && receipt.blobGasUsed) {
  console.log('Blob gas used:', receipt.blobGasUsed)
  console.log('Blob gas price:', receipt.blobGasPrice)
}

Type Alias

TransactionReceiptType - Alias for ReceiptType.

import type { TransactionReceiptType } from '@tevm/primitives/Receipt'

Errors

InvalidReceiptError: Missing required field or invalid value.

See Also

• Receipt (Effect) - Effect.ts integration with Schema validation
• TransactionHash - Transaction identifier
• TransactionIndex - Transaction position
• TransactionStatus - Execution status
• BlockHash - Block identifier
• BlockNumber - Block height
• LogIndex - Log position
• EventLog - Event logs
• Address - Ethereum addresses