Skip to content

ContractTransaction

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/contract/types.d.ts:41

When populating a transaction this type is returned.

optional accessList: AccessList;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:230

The [[link-eip-2930]] access list. Storage slots included in the access list are //warmed// by pre-loading them, so their initial cost to fetch is guaranteed, but then each additional access is cheaper.

PreparedTransactionRequest.accessList


optional authorizationList: Authorization[];

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:234

The [[link-eip-7702]] authorizations (if any).

PreparedTransactionRequest.authorizationList


optional blockTag: BlockTag;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:245

When using call or estimateGas, this allows a specific block to be queried. Many backends do not support this and when unsupported errors are silently squelched and "latest" is used.

PreparedTransactionRequest.blockTag


optional chainId: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:224

The chain ID for the network this transaction is valid on.

PreparedTransactionRequest.chainId


optional customData: any;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:239

A custom object, which can be passed along for network-specific values.

PreparedTransactionRequest.customData


data: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/contract/types.d.ts:49

The transaction data.

PreparedTransactionRequest.data


optional enableCcipRead: boolean;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:255

When using call, this enables CCIP-read, which permits the provider to be redirected to web-based content during execution, which is then further validated by the contract.

There are potential security implications allowing CCIP-read, as it could be used to expose the IP address or user activity during the fetch to unexpected parties.

PreparedTransactionRequest.enableCcipRead


optional from: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/contract/types.d.ts:53

The from address, if any.

PreparedTransactionRequest.from


optional gasLimit: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:196

The maximum amount of gas to allow this transaction to consume.

PreparedTransactionRequest.gasLimit


optional gasPrice: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:203

The gas price to use for legacy transactions or transactions on legacy networks.

Most of the time the max*FeePerGas is preferred.

PreparedTransactionRequest.gasPrice


optional maxFeePerGas: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:212

The [[link-eip-1559]] maximum total fee to pay per gas. The actual value used is protocol enforced to be the block’s base fee.

PreparedTransactionRequest.maxFeePerGas


optional maxPriorityFeePerGas: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:207

The [[link-eip-1559]] maximum priority fee to pay per gas.

PreparedTransactionRequest.maxPriorityFeePerGas


optional nonce: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:192

The nonce of the transaction, used to prevent replay attacks.

PreparedTransactionRequest.nonce


to: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/contract/types.d.ts:45

The target address.

PreparedTransactionRequest.to


optional type: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:180

The transaction type.

PreparedTransactionRequest.type


optional value: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:220

The transaction value (in wei).

PreparedTransactionRequest.value