viem 2.0.0-beta.5 → 2.0.0-beta.8

package/chains/opStack/actions/depositTransaction.ts

@@ -0,0 +1,171 @@
+import type { Address } from 'abitype'
+import {
+  type WriteContractErrorType,
+  writeContract,
+} from '../../../actions/wallet/writeContract.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 { Hash, 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 DepositTransactionParameters<
+  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'> & {
+    /** 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
+        }
+    )
+  }
+export type DepositTransactionReturnType = Hash
+export type DepositTransactionErrorType = 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.
+ *
+ * Internally performs a contract write to the [`depositTransaction` function](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L1/OptimismPortal.sol#L378)
+ * on the [Optimism Portal contract](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L1/OptimismPortal.sol).
+ *
+ * - Docs: https://viem.sh/op-stack/actions/depositTransaction.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link DepositTransactionParameters}
+ * @returns The L1 transaction hash. {@link DepositTransactionReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { walletActionsL1 } from 'viem/op-stack'
+ * import { depositTransaction } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * }).extend(walletActionsL1())
+ *
+ * const hash = await depositTransaction(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   args: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ *   targetChain: base,
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * 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'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * }).extend(walletActionsL1())
+ *
+ * const hash = await depositTransaction(client, {
+ *   args: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ *   targetChain: base,
+ * })
+ */
+export 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>,
+) {
+  const {
+    account,
+    args: { data = '0x', gas, isCreation = false, mint, to = '0x', value },
+    chain = client.chain,
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    targetChain,
+  } = args
+
+  const portalAddress = (() => {
+    if (args.portalAddress) return args.portalAddress
+    if (chain) return targetChain!.contracts.portal[chain.id].address
+    return Object.values(targetChain!.contracts.portal)[0].address
+  })()
+
+  return writeContract(client, {
+    account,
+    abi: portalAbi,
+    address: portalAddress,
+    chain,
+    functionName: 'depositTransaction',
+    args: [
+      isCreation ? zeroAddress : to,
+      value ?? mint ?? 0n,
+      gas,
+      isCreation,
+      data,
+    ],
+    maxFeePerGas,
+    maxPriorityFeePerGas,
+    nonce,
+    value: mint,
+  } as any)
+}

package/chains/opStack/actions/estimateL1Fee.ts

@@ -15,7 +15,7 @@ import type { Transport } from '../../../clients/transports/createTransport.js'
 import { maxInt256 } from '../../../constants/number.js'
 import type { ErrorType } from '../../../errors/utils.js'
 import type { Account, GetAccountParameter } from '../../../types/account.js'
-import { type Chain, type GetChain } from '../../../types/chain.js'
+import { type Chain, type GetChainParameter } from '../../../types/chain.js'
 import type { Signature } from '../../../types/misc.js'
 import type { TransactionRequestEIP1559 } from '../../../types/transaction.js'
 import type { RequestErrorType } from '../../../utils/buildRequest.js'
@@ -39,7 +39,7 @@ export type EstimateL1FeeParameters<
   TChainOverride extends Chain | undefined = undefined,
 > = Omit<TransactionRequestEIP1559, 'from'> &
   GetAccountParameter<TAccount> &
-  GetChain<TChain, TChainOverride> & {
+  GetChainParameter<TChain, TChainOverride> & {
     /** Gas price oracle address. */
     gasPriceOracleAddress?: Address
   }
@@ -62,7 +62,7 @@ const stubSignature = {
 } as const satisfies Signature
 
 /**
- * Estimates the L1 fee required to execute an L2 transaction.
+ * Estimates the L1 data fee required to execute an L2 transaction.
  *
  * @param client - Client to use
  * @param parameters - {@link EstimateL1FeeParameters}

package/chains/opStack/actions/estimateL1Gas.ts

@@ -15,7 +15,7 @@ import type { Transport } from '../../../clients/transports/createTransport.js'
 import { maxInt256 } from '../../../constants/number.js'
 import type { ErrorType } from '../../../errors/utils.js'
 import type { Account, GetAccountParameter } from '../../../types/account.js'
-import { type Chain, type GetChain } from '../../../types/chain.js'
+import { type Chain, type GetChainParameter } from '../../../types/chain.js'
 import type { Signature } from '../../../types/misc.js'
 import type { TransactionRequestEIP1559 } from '../../../types/transaction.js'
 import type { RequestErrorType } from '../../../utils/buildRequest.js'
@@ -39,7 +39,7 @@ export type EstimateL1GasParameters<
   TChainOverride extends Chain | undefined = Chain | undefined,
 > = Omit<TransactionRequestEIP1559, 'from'> &
   GetAccountParameter<TAccount> &
-  GetChain<TChain, TChainOverride> & {
+  GetChainParameter<TChain, TChainOverride> & {
     /** Gas price oracle address. */
     gasPriceOracleAddress?: Address
   }

package/chains/opStack/chainConfig.ts

@@ -1,7 +1,9 @@
 import { contracts } from './contracts.js'
 import { formatters } from './formatters.js'
+import { serializers } from './serializers.js'
 
 export const chainConfig = {
   contracts,
   formatters,
+  serializers,
 } as const

package/chains/opStack/chains.ts

@@ -0,0 +1,9 @@
+export { base } from '../definitions/base.js'
+export { baseGoerli } from '../definitions/baseGoerli.js'
+export { baseSepolia } from '../definitions/baseSepolia.js'
+export { optimism } from '../definitions/optimism.js'
+export { optimismGoerli } from '../definitions/optimismGoerli.js'
+export { optimismSepolia } from '../definitions/optimismSepolia.js'
+export { zora } from '../definitions/zora.js'
+export { zoraSepolia } from '../definitions/zoraSepolia.js'
+export { zoraTestnet } from '../definitions/zoraTestnet.js'

package/chains/opStack/decorators/{public.ts → publicL2.ts}

@@ -1,4 +1,4 @@
-import type { Abi } from 'abitype'
+import type { Abi, Address } from 'abitype'
 import type { Client } from '../../../clients/createClient.js'
 import type { Transport } from '../../../clients/transports/createTransport.js'
 import type { Account } from '../../../types/account.js'
@@ -7,6 +7,11 @@ import type {
   ContractFunctionArgs,
   ContractFunctionName,
 } from '../../../types/contract.js'
+import {
+  type BuildDepositTransactionParameters,
+  type BuildDepositTransactionReturnType,
+  buildDepositTransaction,
+} from '../actions/buildDepositTransaction.js'
 import {
   type EstimateContractL1FeeParameters,
   type EstimateContractL1FeeReturnType,
@@ -48,7 +53,7 @@ import {
   estimateTotalGas,
 } from '../actions/estimateTotalGas.js'
 
-export type publicActionsL2<
+export type PublicActionsL2<
   chain extends Chain | undefined = Chain | undefined,
   account extends Account | undefined = Account | undefined,
 > = {
@@ -312,15 +317,52 @@ export type publicActionsL2<
   estimateTotalGas: <chainOverride extends Chain | undefined = undefined>(
     parameters: EstimateTotalGasParameters<chain, account, chainOverride>,
   ) => Promise<EstimateTotalGasReturnType>
+  /**
+   * Prepares parameters for a [deposit transaction](https://github.com/ethereum-optimism/optimism/blob/develop/specs/deposits.md) to be initiated on an L1.
+   *
+   * - Docs: https://viem.sh/op-stack/actions/buildDepositTransaction.html
+   *
+   * @param client - Client to use
+   * @param parameters - {@link BuildDepositTransactionParameters}
+   * @returns Parameters for `depositTransaction`. {@link DepositTransactionReturnType}
+   *
+   * @example
+   * import { createWalletClient, http, parseEther } from 'viem'
+   * import { base } from 'viem/chains'
+   * import { publicActionsL2 } from 'viem/op-stack'
+   *
+   * const client = createWalletClient({
+   *   chain: base,
+   *   transport: http(),
+   * }).extend(publicActionsL2())
+   *
+   * const request = await client.buildDepositTransaction({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *   value: parseEther('1'),
+   * })
+   */
+  buildDepositTransaction: <
+    chainOverride extends Chain | undefined = undefined,
+    accountOverride extends Account | Address | undefined = undefined,
+  >(
+    parameters: BuildDepositTransactionParameters<
+      chain,
+      account,
+      chainOverride,
+      accountOverride
+    >,
+  ) => Promise<BuildDepositTransactionReturnType<account, accountOverride>>
 }
 
 export function publicActionsL2() {
   return <
+    TTransport extends Transport,
     TChain extends Chain | undefined = Chain | undefined,
     TAccount extends Account | undefined = Account | undefined,
   >(
-    client: Client<Transport, TChain, TAccount>,
-  ): publicActionsL2<TChain, TAccount> => {
+    client: Client<TTransport, TChain, TAccount>,
+  ): PublicActionsL2<TChain, TAccount> => {
     return {
       estimateContractL1Fee: (args) => estimateContractL1Fee(client, args),
       estimateContractL1Gas: (args) => estimateContractL1Gas(client, args),
@@ -332,6 +374,7 @@ export function publicActionsL2() {
       estimateL1Gas: (args) => estimateL1Gas(client, args),
       estimateTotalFee: (args) => estimateTotalFee(client, args),
       estimateTotalGas: (args) => estimateTotalGas(client, args),
+      buildDepositTransaction: (args) => buildDepositTransaction(client, args),
     }
   }
 }

package/chains/opStack/decorators/walletL1.ts

@@ -0,0 +1,86 @@
+import type { Client } from '../../../clients/createClient.js'
+import type { Transport } from '../../../clients/transports/createTransport.js'
+import type { Account } from '../../../types/account.js'
+import type { Chain } from '../../../types/chain.js'
+import {
+  type DepositTransactionParameters,
+  type DepositTransactionReturnType,
+  depositTransaction,
+} from '../actions/depositTransaction.js'
+
+export type WalletActionsL1<
+  chain extends Chain | undefined = Chain | undefined,
+  account extends Account | undefined = Account | undefined,
+> = {
+  /**
+   * Initiates a [deposit transaction](https://github.com/ethereum-optimism/optimism/blob/develop/specs/deposits.md) on an L1, which executes a transaction on L2.
+   *
+   * Internally performs a contract write to the [`depositTransaction` function](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L1/OptimismPortal.sol#L378)
+   * on the [Optimism Portal contract](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L1/OptimismPortal.sol).
+   *
+   * - Docs: https://viem.sh/op-stack/actions/depositTransaction.html
+   *
+   * @param client - Client to use
+   * @param parameters - {@link DepositTransactionParameters}
+   * @returns The L1 transaction hash. {@link DepositTransactionReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom, parseEther } from 'viem'
+   * import { base, mainnet } from 'viem/chains'
+   * import { walletActionsL1 } from 'viem/op-stack'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * }).extend(walletActionsL1())
+   *
+   * const hash = await client.depositTransaction({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   args: {
+   *     gas: 21_000n,
+   *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *     value: parseEther('1'),
+   *   },
+   *   targetChain: base,
+   * })
+   *
+   * @example
+   * // Account Hoisting
+   * import { createWalletClient, http } from 'viem'
+   * import { privateKeyToAccount } from 'viem/accounts'
+   * import { base, mainnet } from 'viem/chains'
+   * import { walletActionsL1 } from 'viem/op-stack'
+   *
+   * const client = createWalletClient({
+   *   account: privateKeyToAccount('0x…'),
+   *   chain: mainnet,
+   *   transport: http(),
+   * }).extend(walletActionsL1())
+   *
+   * const hash = await client.depositTransaction({
+   *   args: {
+   *     gas: 21_000n,
+   *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+   *     value: parseEther('1'),
+   *   },
+   *   targetChain: base,
+   * })
+   */
+  depositTransaction: <chainOverride extends Chain | undefined = undefined>(
+    parameters: DepositTransactionParameters<chain, account, chainOverride>,
+  ) => Promise<DepositTransactionReturnType>
+}
+
+export function walletActionsL1() {
+  return <
+    TTransport extends Transport,
+    TChain extends Chain | undefined = Chain | undefined,
+    TAccount extends Account | undefined = Account | undefined,
+  >(
+    client: Client<TTransport, TChain, TAccount>,
+  ): WalletActionsL1<TChain, TAccount> => {
+    return {
+      depositTransaction: (args) => depositTransaction(client, args),
+    }
+  }
+}

package/chains/opStack/formatters.ts

@@ -11,11 +11,13 @@ import { defineTransactionReceipt } from '../../utils/formatters/transactionRece
 import type {
   OpStackBlockOverrides,
   OpStackRpcBlockOverrides,
+} from './types/block.js'
+import type {
   OpStackRpcTransaction,
   OpStackRpcTransactionReceiptOverrides,
   OpStackTransaction,
   OpStackTransactionReceiptOverrides,
-} from './types.js'
+} from './types/transaction.js'
 
 export const formatters = {
   block: /*#__PURE__*/ defineBlock({

package/chains/opStack/index.ts

@@ -1,3 +1,9 @@
+export {
+  depositTransaction,
+  type DepositTransactionErrorType,
+  type DepositTransactionParameters,
+  type DepositTransactionReturnType,
+} from './actions/depositTransaction.js'
 export {
   estimateContractL1Fee,
   type EstimateContractL1FeeErrorType,
@@ -46,27 +52,51 @@ export {
   type EstimateTotalGasParameters,
   type EstimateTotalGasReturnType,
 } from './actions/estimateTotalGas.js'
+export {
+  buildDepositTransaction,
+  type BuildDepositTransactionErrorType,
+  type BuildDepositTransactionParameters,
+  type BuildDepositTransactionReturnType,
+} from './actions/buildDepositTransaction.js'
 
 export { chainConfig } from './chainConfig.js'
 
-export { publicActionsL2 } from './decorators/public.js'
+export {
+  base,
+  baseGoerli,
+  baseSepolia,
+  optimism,
+  optimismGoerli,
+  optimismSepolia,
+  zora,
+  zoraSepolia,
+  zoraTestnet,
+} from './chains.js'
+
+export { publicActionsL2, type PublicActionsL2 } from './decorators/publicL2.js'
+export { walletActionsL1, type WalletActionsL1 } from './decorators/walletL1.js'
+
+export {
+  parseTransaction,
+  type ParseTransactionErrorType,
+  type ParseTransactionReturnType,
+} from './parsers.js'
 
-export { base } from '../definitions/base.js'
-export { baseGoerli } from '../definitions/baseGoerli.js'
-export { baseSepolia } from '../definitions/baseSepolia.js'
-export { optimism } from '../definitions/optimism.js'
-export { optimismGoerli } from '../definitions/optimismGoerli.js'
-export { optimismSepolia } from '../definitions/optimismSepolia.js'
-export { zora } from '../definitions/zora.js'
-export { zoraSepolia } from '../definitions/zoraSepolia.js'
-export { zoraTestnet } from '../definitions/zoraTestnet.js'
+export {
+  serializeTransaction,
+  serializers,
+  type SerializeTransactionErrorType,
+  type SerializeTransactionReturnType,
+} from './serializers.js'
 
 export type {
   OpStackBlock,
   OpStackBlockOverrides,
-  OpStackDepositTransaction,
   OpStackRpcBlock,
   OpStackRpcBlockOverrides,
+} from './types/block.js'
+export type {
+  OpStackDepositTransaction,
   OpStackRpcDepositTransaction,
   OpStackRpcTransaction,
   OpStackRpcTransactionReceipt,
@@ -74,4 +104,39 @@ export type {
   OpStackTransaction,
   OpStackTransactionReceipt,
   OpStackTransactionReceiptOverrides,
-} from './types.js'
+} from './types/transaction.js'
+
+export {
+  extractTransactionDepositedLogs,
+  type ExtractTransactionDepositedLogsErrorType,
+  type ExtractTransactionDepositedLogsParameters,
+  type ExtractTransactionDepositedLogsReturnType,
+} from './utils/extractTransactionDepositedLogs.js'
+
+export {
+  fromOpaqueData,
+  type FromOpaqueDataErrorType,
+  type FromOpaqueDataParameters,
+  type FromOpaqueDataReturnType,
+} from './utils/fromOpaqueData.js'
+
+export {
+  getL2TransactionHash,
+  type GetL2TransactionHashErrorType,
+  type GetL2TransactionHashParameters,
+  type GetL2TransactionHashReturnType,
+} from './utils/getL2TransactionHash.js'
+
+export {
+  getL2TransactionHashes,
+  type GetL2TransactionHashesErrorType,
+  type GetL2TransactionHashesParameters,
+  type GetL2TransactionHashesReturnType,
+} from './utils/getL2TransactionHashes.js'
+
+export {
+  getSourceHash,
+  type GetSourceHashErrorType,
+  type GetSourceHashParameters,
+  type GetSourceHashReturnType,
+} from './utils/getSourceHash.js'

package/chains/opStack/parsers.ts

@@ -0,0 +1,88 @@
+import { InvalidSerializedTransactionError } from '../../errors/transaction.js'
+import type { ErrorType } from '../../errors/utils.js'
+import { isHex } from '../../utils/data/isHex.js'
+import { sliceHex } from '../../utils/data/slice.js'
+import { hexToBigInt, hexToBool } from '../../utils/encoding/fromHex.js'
+import type { GetSerializedTransactionType } from '../../utils/transaction/getSerializedTransactionType.js'
+import {
+  type ParseTransactionErrorType as ParseTransactionErrorType_,
+  type ParseTransactionReturnType as ParseTransactionReturnType_,
+  parseTransaction as parseTransaction_,
+  toTransactionArray,
+} from '../../utils/transaction/parseTransaction.js'
+import { assertTransactionDeposit } from './serializers.js'
+import type {
+  OpStackTransactionSerialized,
+  OpStackTransactionType,
+  TransactionSerializableDeposit,
+  TransactionSerializedDeposit,
+} from './types/transaction.js'
+
+export type ParseTransactionReturnType<
+  TSerialized extends
+    OpStackTransactionSerialized = OpStackTransactionSerialized,
+  TType extends
+    OpStackTransactionType = GetSerializedTransactionType<TSerialized>,
+> = TSerialized extends TransactionSerializedDeposit
+  ? TransactionSerializableDeposit
+  : ParseTransactionReturnType_<TSerialized, TType>
+
+export type ParseTransactionErrorType = ParseTransactionErrorType_ | ErrorType
+
+export function parseTransaction<
+  TSerialized extends OpStackTransactionSerialized,
+>(serializedTransaction: TSerialized): ParseTransactionReturnType<TSerialized> {
+  const serializedType = sliceHex(serializedTransaction, 0, 1)
+
+  if (serializedType === '0x7e')
+    return parseTransactionDeposit(
+      serializedTransaction as TransactionSerializedDeposit,
+    ) as ParseTransactionReturnType<TSerialized>
+
+  return parseTransaction_(
+    serializedTransaction,
+  ) as ParseTransactionReturnType<TSerialized>
+}
+
+function parseTransactionDeposit(
+  serializedTransaction: TransactionSerializedDeposit,
+): ParseTransactionReturnType<TransactionSerializedDeposit> {
+  const transactionArray = toTransactionArray(serializedTransaction)
+
+  const [sourceHash, from, to, mint, value, gas, isSystemTx, data] =
+    transactionArray
+
+  if (transactionArray.length !== 8 || !isHex(sourceHash) || !isHex(from))
+    throw new InvalidSerializedTransactionError({
+      attributes: {
+        sourceHash,
+        from,
+        gas,
+        to,
+        mint,
+        value,
+        isSystemTx,
+        data,
+      },
+      serializedTransaction,
+      type: 'deposit',
+    })
+
+  const transaction: TransactionSerializableDeposit = {
+    sourceHash,
+    from,
+    type: 'deposit',
+  }
+
+  if (isHex(gas) && gas !== '0x') transaction.gas = hexToBigInt(gas)
+  if (isHex(to) && to !== '0x') transaction.to = to
+  if (isHex(mint) && mint !== '0x') transaction.mint = hexToBigInt(mint)
+  if (isHex(value) && value !== '0x') transaction.value = hexToBigInt(value)
+  if (isHex(isSystemTx) && isSystemTx !== '0x')
+    transaction.isSystemTx = hexToBool(isSystemTx)
+  if (isHex(data) && data !== '0x') transaction.data = data
+
+  assertTransactionDeposit(transaction)
+
+  return transaction
+}