> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://v3.viem.sh/api/mcp` to find what you need.

# TransactionReceipt

:::info
`TransactionReceipt` is a re-export of ox's [`TransactionReceipt`](https://oxlib.sh/api/TransactionReceipt). Refer to the ox documentation for the full reference.
:::

Utilities & types for working with **Transaction Receipts** as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/receipt.yaml)

## Examples

### Converting from RPC Format

Receipts can be converted from RPC format using [`TransactionReceipt.fromRpc`](/docs/utilities/transactionreceipt/fromRpc):

```ts twoslash
// @noErrors
import 'ox/window'
import { TransactionReceipt } from 'viem/utils'

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: }
```

## Functions

| Name                | Description                         |
| ------------------- | ----------------------------------- |
| [`TransactionReceipt.fromRpc`](/docs/utilities/transactionreceipt/fromRpc) | Converts a [`TransactionReceipt.Rpc`](/docs/utilities/transactionreceipt/types#rpc) to an [`TransactionReceipt.TransactionReceipt`](/docs/utilities/transactionreceipt/types#transactionreceipt). |
| [`TransactionReceipt.toRpc`](/docs/utilities/transactionreceipt/toRpc) | Converts a [`TransactionReceipt.TransactionReceipt`](/docs/utilities/transactionreceipt/types#transactionreceipt) to a [`TransactionReceipt.Rpc`](/docs/utilities/transactionreceipt/types#rpc). |

## Types

| Name                | Description                         |
| ------------------- | ----------------------------------- |
| [`TransactionReceipt.Rpc`](/docs/utilities/transactionreceipt/types#transactionreceiptrpc) | An RPC Transaction Receipt as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/receipt.yaml). |
| [`TransactionReceipt.RpcStatus`](/docs/utilities/transactionreceipt/types#transactionreceiptrpcstatus) | Union of RPC Transaction Receipt statuses. |
| [`TransactionReceipt.RpcType`](/docs/utilities/transactionreceipt/types#transactionreceiptrpctype) | Union of RPC Transaction Receipt types. |
| [`TransactionReceipt.Status`](/docs/utilities/transactionreceipt/types#transactionreceiptstatus) | Union of Transaction Receipt statuses. |
| [`TransactionReceipt.TransactionReceipt`](/docs/utilities/transactionreceipt/types#transactionreceipttransactionreceipt) | An Transaction Receipt as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/receipt.yaml). |
| [`TransactionReceipt.Type`](/docs/utilities/transactionreceipt/types#transactionreceipttype) | Union of Transaction Receipt types. |