viem 2.0.0-beta.8 → 2.0.0-rc.0

package/chains/opStack/actions/depositTransaction.ts

@@ -1,6 +1,7 @@
 import type { Address } from 'abitype'
 import {
   type WriteContractErrorType,
+  type WriteContractParameters,
   writeContract,
 } from '../../../actions/wallet/writeContract.js'
 import type { Client } from '../../../clients/createClient.js'
@@ -13,11 +14,17 @@ import type {
   DeriveChain,
   GetChainParameter,
 } from '../../../types/chain.js'
-import type { Hash, Hex } from '../../../types/misc.js'
+import type { Hash } from '../../../types/misc.js'
 import type { UnionEvaluate, UnionOmit } from '../../../types/utils.js'
 import type { FormattedTransactionRequest } from '../../../utils/formatters/transactionRequest.js'
 import { portalAbi } from '../abis.js'
 import type { GetContractAddressParameter } from '../types/contract.js'
+import type { DepositRequest } from '../types/deposit.js'
+import {
+  type EstimateDepositTransactionGasErrorType,
+  type EstimateDepositTransactionGasParameters,
+  estimateDepositTransactionGas,
+} from './estimateDepositTransactionGas.js'
 
 export type DepositTransactionParameters<
   chain extends Chain | undefined = Chain | undefined,
@@ -40,35 +47,19 @@ export type DepositTransactionParameters<
   GetAccountParameter<account, Account | Address> &
   GetChainParameter<chain, chainOverride> &
   GetContractAddressParameter<_derivedChain, 'portal'> & {
-    /** Arguments supplied to the L2 transaction. */
-    args: {
-      /** Gas limit for transaction execution on the L2. */
-      gas: bigint
-      /** Value in wei to mint (deposit) on the L2. Debited from the caller's L1 balance. */
-      mint?: bigint
-      /** Value in wei sent with this transaction on the L2. Debited from the caller's L2 balance. */
-      value?: bigint
-    } & (
-      | {
-          /** Encoded contract method & arguments. */
-          data?: Hex
-          /** Whether or not this is a contract deployment transaction. */
-          isCreation?: false
-          /** L2 Transaction recipient. */
-          to?: Address
-        }
-      | {
-          /** Contract deployment bytecode. Required for contract deployment transactions. */
-          data: Hex
-          /** Whether or not this is a contract deployment transaction. */
-          isCreation: true
-          /** L2 Transaction recipient. Cannot exist for contract deployment transactions. */
-          to?: never
-        }
-    )
+    /** L2 transaction request. */
+    request: DepositRequest
+    /**
+     * Gas limit for transaction execution on the L1.
+     * `null` to skip gas estimation & defer calculation to signer.
+     */
+    gas?: bigint | null
   }
 export type DepositTransactionReturnType = Hash
-export type DepositTransactionErrorType = WriteContractErrorType | ErrorType
+export type DepositTransactionErrorType =
+  | EstimateDepositTransactionGasErrorType
+  | WriteContractErrorType
+  | ErrorType
 
 /**
  * Initiates a [deposit transaction](https://github.com/ethereum-optimism/optimism/blob/develop/specs/deposits.md) on an L1, which executes a transaction on L2.
@@ -85,17 +76,16 @@ export type DepositTransactionErrorType = WriteContractErrorType | ErrorType
  * @example
  * import { createWalletClient, custom, parseEther } from 'viem'
  * import { base, mainnet } from 'viem/chains'
- * import { walletActionsL1 } from 'viem/op-stack'
- * import { depositTransaction } from 'viem/wallet'
+ * import { depositTransaction } from 'viem/op-stack'
  *
  * const client = createWalletClient({
  *   chain: mainnet,
  *   transport: custom(window.ethereum),
- * }).extend(walletActionsL1())
+ * })
  *
  * const hash = await depositTransaction(client, {
  *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
- *   args: {
+ *   request: {
  *     gas: 21_000n,
  *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
  *     value: parseEther('1'),
@@ -108,17 +98,16 @@ export type DepositTransactionErrorType = WriteContractErrorType | ErrorType
  * import { createWalletClient, http } from 'viem'
  * import { privateKeyToAccount } from 'viem/accounts'
  * import { base, mainnet } from 'viem/chains'
- * import { walletActionsL1 } from 'viem/op-stack'
- * import { depositTransaction } from 'viem/wallet'
+ * import { depositTransaction } from 'viem/op-stack'
  *
  * const client = createWalletClient({
  *   account: privateKeyToAccount('0x…'),
  *   chain: mainnet,
  *   transport: http(),
- * }).extend(walletActionsL1())
+ * })
  *
  * const hash = await depositTransaction(client, {
- *   args: {
+ *   request: {
  *     gas: 21_000n,
  *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
  *     value: parseEther('1'),
@@ -126,32 +115,48 @@ export type DepositTransactionErrorType = WriteContractErrorType | ErrorType
  *   targetChain: base,
  * })
  */
-export function depositTransaction<
+export async function depositTransaction<
   chain extends Chain | undefined,
   account extends Account | undefined,
   chainOverride extends Chain | undefined = undefined,
 >(
   client: Client<Transport, chain, account>,
-  args: DepositTransactionParameters<chain, account, chainOverride>,
+  parameters: DepositTransactionParameters<chain, account, chainOverride>,
 ) {
   const {
     account,
-    args: { data = '0x', gas, isCreation = false, mint, to = '0x', value },
     chain = client.chain,
+    gas,
     maxFeePerGas,
     maxPriorityFeePerGas,
     nonce,
+    request: {
+      data = '0x',
+      gas: l2Gas,
+      isCreation = false,
+      mint,
+      to = '0x',
+      value,
+    },
     targetChain,
-  } = args
+  } = parameters
 
   const portalAddress = (() => {
-    if (args.portalAddress) return args.portalAddress
+    if (parameters.portalAddress) return parameters.portalAddress
     if (chain) return targetChain!.contracts.portal[chain.id].address
     return Object.values(targetChain!.contracts.portal)[0].address
   })()
 
+  const gas_ =
+    typeof gas !== 'number' && gas !== null
+      ? await estimateDepositTransactionGas(
+          client,
+          parameters as EstimateDepositTransactionGasParameters,
+        )
+      : undefined
+
   return writeContract(client, {
-    account,
+    account: account!,
     abi: portalAbi,
     address: portalAddress,
     chain,
@@ -159,7 +164,7 @@ export function depositTransaction<
     args: [
       isCreation ? zeroAddress : to,
       value ?? mint ?? 0n,
-      gas,
+      l2Gas,
       isCreation,
       data,
     ],
@@ -167,5 +172,6 @@ export function depositTransaction<
     maxPriorityFeePerGas,
     nonce,
     value: mint,
-  } as any)
+    gas: gas_,
+  } satisfies WriteContractParameters as any)
 }

package/chains/opStack/actions/estimateDepositTransactionGas.ts

@@ -0,0 +1,138 @@
+import type { Address } from 'abitype'
+import {
+  type EstimateContractGasErrorType,
+  type EstimateContractGasParameters,
+  estimateContractGas,
+} from '../../../actions/public/estimateContractGas.js'
+import type { Client } from '../../../clients/createClient.js'
+import type { Transport } from '../../../clients/transports/createTransport.js'
+import { zeroAddress } from '../../../constants/address.js'
+import type { ErrorType } from '../../../errors/utils.js'
+import type { Account, GetAccountParameter } from '../../../types/account.js'
+import type {
+  Chain,
+  DeriveChain,
+  GetChainParameter,
+} from '../../../types/chain.js'
+import type { UnionEvaluate, UnionOmit } from '../../../types/utils.js'
+import type { FormattedTransactionRequest } from '../../../utils/formatters/transactionRequest.js'
+import { portalAbi } from '../abis.js'
+import type { GetContractAddressParameter } from '../types/contract.js'
+import type { DepositRequest } from '../types/deposit.js'
+
+export type EstimateDepositTransactionGasParameters<
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  chainOverride extends Chain | undefined = Chain | undefined,
+  _derivedChain extends Chain | undefined = DeriveChain<chain, chainOverride>,
+> = UnionEvaluate<
+  UnionOmit<
+    FormattedTransactionRequest<_derivedChain>,
+    | 'accessList'
+    | 'data'
+    | 'from'
+    | 'gas'
+    | 'gasPrice'
+    | 'to'
+    | 'type'
+    | 'value'
+  >
+> &
+  GetAccountParameter<account, Account | Address> &
+  GetChainParameter<chain, chainOverride> &
+  GetContractAddressParameter<_derivedChain, 'portal'> & {
+    /** L2 transaction request. */
+    request: DepositRequest
+    /** Gas limit for transaction execution on the L1. */
+    gas?: bigint | null
+  }
+export type EstimateDepositTransactionGasReturnType = bigint
+export type EstimateDepositTransactionGasErrorType =
+  | EstimateContractGasErrorType
+  | ErrorType
+
+/**
+ * Estimates gas required to initiate a [deposit transaction](https://github.com/ethereum-optimism/optimism/blob/develop/specs/deposits.md) on an L1, which executes a transaction on L2.
+ *
+ * - Docs: https://viem.sh/op-stack/actions/estimateDepositTransactionGas.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateDepositTransactionGasParameters}
+ * @returns The L1 transaction hash. {@link EstimateDepositTransactionGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, custom, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { estimateDepositTransactionGas } from 'viem/op-stack'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ *
+ * const gas = await estimateDepositTransactionGas(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   args: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ *   targetChain: base,
+ * })
+ */
+export async function estimateDepositTransactionGas<
+  chain extends Chain | undefined,
+  account extends Account | undefined,
+  chainOverride extends Chain | undefined = undefined,
+>(
+  client: Client<Transport, chain, account>,
+  parameters: EstimateDepositTransactionGasParameters<
+    chain,
+    account,
+    chainOverride
+  >,
+) {
+  const {
+    account,
+    chain = client.chain,
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    request: {
+      data = '0x',
+      gas: l2Gas,
+      isCreation = false,
+      mint,
+      to = '0x',
+      value,
+    },
+    targetChain,
+  } = parameters
+
+  const portalAddress = (() => {
+    if (parameters.portalAddress) return parameters.portalAddress
+    if (chain) return targetChain!.contracts.portal[chain.id].address
+    return Object.values(targetChain!.contracts.portal)[0].address
+  })()
+
+  return estimateContractGas(client, {
+    account,
+    abi: portalAbi,
+    address: portalAddress,
+    chain,
+    functionName: 'depositTransaction',
+    args: [
+      isCreation ? zeroAddress : to,
+      value ?? mint ?? 0n,
+      l2Gas,
+      isCreation,
+      data,
+    ],
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    value: mint,
+  } as EstimateContractGasParameters)
+}

package/chains/opStack/actions/estimateFinalizeWithdrawalGas.ts

@@ -0,0 +1,118 @@
+import type { Address } from 'abitype'
+import {
+  type EstimateContractGasErrorType,
+  type EstimateContractGasParameters,
+  estimateContractGas,
+} from '../../../actions/public/estimateContractGas.js'
+import type { Client } from '../../../clients/createClient.js'
+import type { Transport } from '../../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../../errors/utils.js'
+import type { Account, GetAccountParameter } from '../../../types/account.js'
+import type {
+  Chain,
+  DeriveChain,
+  GetChainParameter,
+} from '../../../types/chain.js'
+import type { UnionEvaluate, UnionOmit } from '../../../types/utils.js'
+import type { FormattedTransactionRequest } from '../../../utils/formatters/transactionRequest.js'
+import { portalAbi } from '../abis.js'
+import type { GetContractAddressParameter } from '../types/contract.js'
+import type { Withdrawal } from '../types/withdrawal.js'
+
+export type EstimateFinalizeWithdrawalGasParameters<
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  chainOverride extends Chain | undefined = Chain | undefined,
+  _derivedChain extends Chain | undefined = DeriveChain<chain, chainOverride>,
+> = UnionEvaluate<
+  UnionOmit<
+    FormattedTransactionRequest<_derivedChain>,
+    | 'accessList'
+    | 'data'
+    | 'from'
+    | 'gas'
+    | 'gasPrice'
+    | 'to'
+    | 'type'
+    | 'value'
+  >
+> &
+  GetAccountParameter<account, Account | Address> &
+  GetChainParameter<chain, chainOverride> &
+  GetContractAddressParameter<_derivedChain, 'portal'> & {
+    /** Gas limit for transaction execution on the L2. */
+    gas?: bigint | null
+    withdrawal: Withdrawal
+  }
+export type EstimateFinalizeWithdrawalGasReturnType = bigint
+export type EstimateFinalizeWithdrawalGasErrorType =
+  | EstimateContractGasErrorType
+  | ErrorType
+
+/**
+ * Estimates gas required to finalize a withdrawal that occurred on an L2.
+ *
+ * - Docs: https://viem.sh/op-stack/actions/estimateFinalizeWithdrawalGas.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateFinalizeWithdrawalGasParameters}
+ * @returns Estimated gas. {@link EstimateFinalizeWithdrawalGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { estimateFinalizeWithdrawalGas } from 'viem/op-stack'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const gas = await estimateFinalizeWithdrawalGas(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   targetChain: optimism,
+ *   withdrawal: { ... },
+ * })
+ */
+export async function estimateFinalizeWithdrawalGas<
+  chain extends Chain | undefined,
+  account extends Account | undefined,
+  chainOverride extends Chain | undefined = undefined,
+>(
+  client: Client<Transport, chain, account>,
+  parameters: EstimateFinalizeWithdrawalGasParameters<
+    chain,
+    account,
+    chainOverride
+  >,
+) {
+  const {
+    account,
+    chain = client.chain,
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    targetChain,
+    withdrawal,
+  } = parameters
+
+  const portalAddress = (() => {
+    if (parameters.portalAddress) return parameters.portalAddress
+    if (chain) return targetChain!.contracts.portal[chain.id].address
+    return Object.values(targetChain!.contracts.portal)[0].address
+  })()
+
+  return estimateContractGas(client, {
+    account,
+    abi: portalAbi,
+    address: portalAddress,
+    chain,
+    functionName: 'finalizeWithdrawalTransaction',
+    args: [withdrawal],
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+  } as EstimateContractGasParameters)
+}

package/chains/opStack/actions/estimateInitiateWithdrawalGas.ts

@@ -0,0 +1,118 @@
+import type { Address } from 'abitype'
+import {
+  type EstimateContractGasErrorType,
+  type EstimateContractGasParameters,
+  estimateContractGas,
+} from '../../../actions/public/estimateContractGas.js'
+import type { Client } from '../../../clients/createClient.js'
+import type { Transport } from '../../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../../errors/utils.js'
+import type { Account, GetAccountParameter } from '../../../types/account.js'
+import type {
+  Chain,
+  DeriveChain,
+  GetChainParameter,
+} from '../../../types/chain.js'
+import type { UnionEvaluate, UnionOmit } from '../../../types/utils.js'
+import type { FormattedTransactionRequest } from '../../../utils/formatters/transactionRequest.js'
+import { l2ToL1MessagePasserAbi } from '../abis.js'
+import { contracts } from '../contracts.js'
+import type { WithdrawalRequest } from '../types/withdrawal.js'
+
+export type EstimateInitiateWithdrawalGasParameters<
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  chainOverride extends Chain | undefined = Chain | undefined,
+  _derivedChain extends Chain | undefined = DeriveChain<chain, chainOverride>,
+> = UnionEvaluate<
+  UnionOmit<
+    FormattedTransactionRequest<_derivedChain>,
+    | 'accessList'
+    | 'data'
+    | 'from'
+    | 'gas'
+    | 'gasPrice'
+    | 'to'
+    | 'type'
+    | 'value'
+  >
+> &
+  GetAccountParameter<account, Account | Address> &
+  GetChainParameter<chain, chainOverride> & {
+    /** Gas limit for transaction execution on the L2. */
+    gas?: bigint | null
+    /**
+     * Withdrawal request.
+     * Supplied to the L2ToL1MessagePasser `initiateWithdrawal` method.
+     */
+    request: WithdrawalRequest
+  }
+export type EstimateInitiateWithdrawalGasReturnType = bigint
+export type EstimateInitiateWithdrawalGasErrorType =
+  | EstimateContractGasErrorType
+  | ErrorType
+
+/**
+ * Estimates gas required to initiate a [withdrawal](https://community.optimism.io/docs/protocol/withdrawal-flow/#withdrawal-initiating-transaction) on an L2 to the L1.
+ *
+ * - Docs: https://viem.sh/op-stack/actions/estimateInitiateWithdrawalGas.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateInitiateWithdrawalGasParameters}
+ * @returns Estimated gas. {@link EstimateInitiateWithdrawalGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { estimateInitiateWithdrawalGas } from 'viem/op-stack'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const gas = await estimateInitiateWithdrawalGas(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   request: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ * })
+ */
+export async function estimateInitiateWithdrawalGas<
+  chain extends Chain | undefined,
+  account extends Account | undefined,
+  chainOverride extends Chain | undefined = undefined,
+>(
+  client: Client<Transport, chain, account>,
+  parameters: EstimateInitiateWithdrawalGasParameters<
+    chain,
+    account,
+    chainOverride
+  >,
+) {
+  const {
+    account,
+    chain = client.chain,
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    request: { data = '0x', gas: l1Gas, to, value },
+  } = parameters
+
+  return estimateContractGas(client, {
+    account,
+    abi: l2ToL1MessagePasserAbi,
+    address: contracts.l2ToL1MessagePasser.address,
+    chain,
+    functionName: 'initiateWithdrawal',
+    args: [to, l1Gas, data],
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    value,
+  } as EstimateContractGasParameters)
+}

package/chains/opStack/actions/estimateProveWithdrawalGas.ts

@@ -0,0 +1,139 @@
+import type { Address } from 'abitype'
+import {
+  type EstimateContractGasErrorType,
+  type EstimateContractGasParameters,
+  estimateContractGas,
+} from '../../../actions/public/estimateContractGas.js'
+import type { Client } from '../../../clients/createClient.js'
+import type { Transport } from '../../../clients/transports/createTransport.js'
+import type { ErrorType } from '../../../errors/utils.js'
+import type { Account, GetAccountParameter } from '../../../types/account.js'
+import type {
+  Chain,
+  DeriveChain,
+  GetChainParameter,
+} from '../../../types/chain.js'
+import type { Hex } from '../../../types/misc.js'
+import type { UnionEvaluate, UnionOmit } from '../../../types/utils.js'
+import type { FormattedTransactionRequest } from '../../../utils/formatters/transactionRequest.js'
+import { portalAbi } from '../abis.js'
+import type { GetContractAddressParameter } from '../types/contract.js'
+
+export type EstimateProveWithdrawalGasParameters<
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+  chainOverride extends Chain | undefined = Chain | undefined,
+  _derivedChain extends Chain | undefined = DeriveChain<chain, chainOverride>,
+> = UnionEvaluate<
+  UnionOmit<
+    FormattedTransactionRequest<_derivedChain>,
+    | 'accessList'
+    | 'data'
+    | 'from'
+    | 'gas'
+    | 'gasPrice'
+    | 'to'
+    | 'type'
+    | 'value'
+  >
+> &
+  GetAccountParameter<account, Account | Address> &
+  GetChainParameter<chain, chainOverride> &
+  GetContractAddressParameter<_derivedChain, 'portal'> & {
+    /** Gas limit for transaction execution on the L2. */
+    gas?: bigint | null
+    l2OutputIndex: bigint
+    outputRootProof: {
+      version: Hex
+      stateRoot: Hex
+      messagePasserStorageRoot: Hex
+      latestBlockhash: Hex
+    }
+    withdrawalProof: readonly Hex[]
+    withdrawal: {
+      data: Hex
+      gasLimit: bigint
+      nonce: bigint
+      sender: Address
+      target: Address
+      value: bigint
+    }
+  }
+export type EstimateProveWithdrawalGasReturnType = bigint
+export type EstimateProveWithdrawalGasErrorType =
+  | EstimateContractGasErrorType
+  | ErrorType
+
+/**
+ * Estimates gas required to prove a withdrawal that occurred on an L2.
+ *
+ * - Docs: https://viem.sh/op-stack/actions/estimateProveWithdrawalGas.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateProveWithdrawalGasParameters}
+ * @returns Estimated gas. {@link EstimateProveWithdrawalGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { estimateProveWithdrawalGas } from 'viem/op-stack'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const gas = await estimateProveWithdrawalGas(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   l2OutputIndex: 4529n,
+ *   outputRootProof: { ... },
+ *   targetChain: optimism,
+ *   withdrawalProof: [ ... ],
+ *   withdrawal: { ... },
+ * })
+ */
+export async function estimateProveWithdrawalGas<
+  chain extends Chain | undefined,
+  account extends Account | undefined,
+  chainOverride extends Chain | undefined = undefined,
+>(
+  client: Client<Transport, chain, account>,
+  parameters: EstimateProveWithdrawalGasParameters<
+    chain,
+    account,
+    chainOverride
+  >,
+) {
+  const {
+    account,
+    chain = client.chain,
+    gas,
+    l2OutputIndex,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    outputRootProof,
+    targetChain,
+    withdrawalProof,
+    withdrawal,
+  } = parameters
+
+  const portalAddress = (() => {
+    if (parameters.portalAddress) return parameters.portalAddress
+    if (chain) return targetChain!.contracts.portal[chain.id].address
+    return Object.values(targetChain!.contracts.portal)[0].address
+  })()
+
+  return estimateContractGas(client, {
+    account,
+    abi: portalAbi,
+    address: portalAddress,
+    chain,
+    functionName: 'proveWithdrawalTransaction',
+    args: [withdrawal, l2OutputIndex, outputRootProof, withdrawalProof],
+    gas,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+  } as EstimateContractGasParameters)
+}