viem 2.9.2 → 2.9.4

package/_types/op-stack/chainConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.d.ts","sourceRoot":"","sources":["../../op-stack/chainConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAId,CAAA"}

package/_types/op-stack/chains.d.ts

@@ -0,0 +1,16 @@
+export { ancient8 } from '../chains/definitions/ancient8.js';
+export { ancient8Sepolia } from '../chains/definitions/ancient8Sepolia.js';
+export { base } from '../chains/definitions/base.js';
+export { baseGoerli } from '../chains/definitions/baseGoerli.js';
+export { baseSepolia } from '../chains/definitions/baseSepolia.js';
+export { fraxtal } from '../chains/definitions/fraxtal.js';
+export { fraxtalTestnet } from '../chains/definitions/fraxtalTestnet.js';
+export { optimism } from '../chains/definitions/optimism.js';
+export { optimismGoerli } from '../chains/definitions/optimismGoerli.js';
+export { optimismSepolia } from '../chains/definitions/optimismSepolia.js';
+export { pgn } from '../chains/definitions/pgn.js';
+export { pgnTestnet } from '../chains/definitions/pgnTestnet.js';
+export { zora } from '../chains/definitions/zora.js';
+export { zoraSepolia } from '../chains/definitions/zoraSepolia.js';
+export { zoraTestnet } from '../chains/definitions/zoraTestnet.js';
+//# sourceMappingURL=chains.d.ts.map

package/_types/op-stack/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../op-stack/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA"}

package/_types/op-stack/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../op-stack/contracts.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;CAWiB,CAAA"}

package/_types/op-stack/decorators/publicL1.d.ts

@@ -0,0 +1,530 @@
+import type { 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';
+import type { Chain } from '../../types/chain.js';
+import { type BuildInitiateWithdrawalParameters, type BuildInitiateWithdrawalReturnType } from '../actions/buildInitiateWithdrawal.js';
+import { type EstimateDepositTransactionGasParameters, type EstimateDepositTransactionGasReturnType } from '../actions/estimateDepositTransactionGas.js';
+import { type EstimateFinalizeWithdrawalGasParameters, type EstimateFinalizeWithdrawalGasReturnType } from '../actions/estimateFinalizeWithdrawalGas.js';
+import { type EstimateProveWithdrawalGasParameters, type EstimateProveWithdrawalGasReturnType } from '../actions/estimateProveWithdrawalGas.js';
+import { type GetGameParameters, type GetGameReturnType } from '../actions/getGame.js';
+import { type GetGamesParameters, type GetGamesReturnType } from '../actions/getGames.js';
+import { type GetL2OutputParameters, type GetL2OutputReturnType } from '../actions/getL2Output.js';
+import { type GetPortalVersionParameters, type GetPortalVersionReturnType } from '../actions/getPortalVersion.js';
+import { type GetTimeToFinalizeParameters, type GetTimeToFinalizeReturnType } from '../actions/getTimeToFinalize.js';
+import { type GetTimeToNextGameParameters, type GetTimeToNextGameReturnType } from '../actions/getTimeToNextGame.js';
+import { type GetTimeToNextL2OutputParameters, type GetTimeToNextL2OutputReturnType } from '../actions/getTimeToNextL2Output.js';
+import { type GetTimeToProveParameters, type GetTimeToProveReturnType } from '../actions/getTimeToProve.js';
+import { type GetWithdrawalStatusParameters, type GetWithdrawalStatusReturnType } from '../actions/getWithdrawalStatus.js';
+import { type WaitForNextGameParameters, type WaitForNextGameReturnType } from '../actions/waitForNextGame.js';
+import { type WaitForNextL2OutputParameters, type WaitForNextL2OutputReturnType } from '../actions/waitForNextL2Output.js';
+import { type WaitToFinalizeParameters, type WaitToFinalizeReturnType } from '../actions/waitToFinalize.js';
+import { type WaitToProveParameters, type WaitToProveReturnType } from '../actions/waitToProve.js';
+export type PublicActionsL1<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = {
+    /**
+     * 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/buildInitiateWithdrawal
+     *
+     * @param client - Client to use
+     * @param parameters - {@link BuildInitiateWithdrawalParameters}
+     * @returns Parameters for `depositTransaction`. {@link DepositTransactionReturnType}
+     *
+     * @example
+     * import { createWalletClient, http, parseEther } from 'viem'
+     * import { base } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const client = createWalletClient({
+     *   chain: base,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     *
+     * const args = await client.buildInitiateWithdrawal({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+     *   value: parseEther('1'),
+     * })
+     */
+    buildInitiateWithdrawal: <chainOverride extends Chain | undefined = undefined, accountOverride extends Account | Address | undefined = undefined>(parameters: BuildInitiateWithdrawalParameters<chain, account, chainOverride, accountOverride>) => Promise<BuildInitiateWithdrawalReturnType<account, accountOverride>>;
+    /**
+     * 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
+     *
+     * @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 { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const client = createPublicClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * }).extend(publicActionsL1())
+     *
+     * const gas = await client.estimateDepositTransactionGas({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   args: {
+     *     gas: 21_000n,
+     *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+     *     value: parseEther('1'),
+     *   },
+     *   targetChain: base,
+     * })
+     */
+    estimateDepositTransactionGas: <chainOverride extends Chain | undefined = undefined>(parameters: EstimateDepositTransactionGasParameters<chain, account, chainOverride>) => Promise<EstimateDepositTransactionGasReturnType>;
+    /**
+     * Estimates gas required to prove a withdrawal that occurred on an L2.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/estimateProveWithdrawalGas
+     *
+     * @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 { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const client = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     *
+     * const gas = await client.estimateProveWithdrawalGas({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   l2OutputIndex: 4529n,
+     *   outputRootProof: { ... },
+     *   targetChain: optimism,
+     *   withdrawalProof: [ ... ],
+     *   withdrawal: { ... },
+     * })
+     */
+    estimateProveWithdrawalGas: <chainOverride extends Chain | undefined = undefined>(parameters: EstimateProveWithdrawalGasParameters<chain, account, chainOverride>) => Promise<EstimateProveWithdrawalGasReturnType>;
+    /**
+     * Estimates gas required to finalize a withdrawal that occurred on an L2.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/estimateFinalizeWithdrawalGas
+     *
+     * @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 { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const client = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     *
+     * const gas = await client.estimateFinalizeWithdrawalGas({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   targetChain: optimism,
+     *   withdrawal: { ... },
+     * })
+     */
+    estimateFinalizeWithdrawalGas: <chainOverride extends Chain | undefined = undefined>(parameters: EstimateFinalizeWithdrawalGasParameters<chain, account, chainOverride>) => Promise<EstimateFinalizeWithdrawalGasReturnType>;
+    /**
+     * Retrieves a valid dispute game on an L2 that occurred after a provided L2 block number.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getGame
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetGameParameters}
+     * @returns A valid dispute game. {@link GetGameReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     *
+     * const game = await publicClientL1.getGame({
+     *   l2BlockNumber: 69420n,
+     *   targetChain: optimism
+     * })
+     */
+    getGame: <chainOverride extends Chain | undefined = undefined>(parameters: GetGameParameters<chain, chainOverride>) => Promise<GetGameReturnType>;
+    /**
+     * Retrieves dispute games for an L2.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getGame
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetGameParameters}
+     * @returns Dispute games. {@link GetGameReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     *
+     * const games = await publicClientL1.getGames({
+     *   targetChain: optimism
+     * })
+     */
+    getGames: <chainOverride extends Chain | undefined = undefined>(parameters: GetGamesParameters<chain, chainOverride>) => Promise<GetGamesReturnType>;
+    /**
+     * Retrieves the first L2 output proposal that occurred after a provided block number. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getL2Output
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetL2OutputParameters}
+     * @returns The L2 output. {@link GetL2OutputReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     *
+     * const output = await publicClientL1.getL2Output({
+     *   l2BlockNumber: 69420n,
+     *   targetChain: optimism
+     * })
+     */
+    getL2Output: <chainOverride extends Chain | undefined = undefined>(parameters: GetL2OutputParameters<chain, chainOverride>) => Promise<GetL2OutputReturnType>;
+    /**
+     * Retrieves the current version of the Portal contract.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getPortalVersion
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetPortalVersionParameters}
+     * @returns The version object.
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     *
+     * const version = await publicClientL1.getPortalVersion({
+     *   targetChain: optimism,
+     * })
+     *
+     * if (version.major > 3)
+     *   console.log('Fault proofs are enabled on this version of optimism')
+     * console.log('Fault proofs are not enabled on this version of optimism')
+     */
+    getPortalVersion: <chainOverride extends Chain | undefined = undefined>(parameters: GetPortalVersionParameters<chain, chainOverride>) => Promise<GetPortalVersionReturnType>;
+    /**
+     * Returns the time until the withdrawal transaction can be finalized. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getTimeToFinalize
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetTimeToFinalizeParameters}
+     * @returns Time until finalize. {@link GetTimeToFinalizeReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const receipt = await publicClientL2.getTransactionReceipt({
+     *   hash: '0x9a2f4283636ddeb9ac32382961b22c177c9e86dd3b283735c154f897b1a7ff4a',
+     * })
+     *
+     * const [withdrawal] = getWithdrawals(receipt)
+     *
+     * const { seconds } = await publicClientL1.getTimeToFinalize({
+     *   withdrawalHash: withdrawal.withdrawalHash,
+     *   targetChain: optimism
+     * })
+     */
+    getTimeToFinalize: <chainOverride extends Chain | undefined = undefined>(parameters: GetTimeToFinalizeParameters<chain, chainOverride>) => Promise<GetTimeToFinalizeReturnType>;
+    /**
+     * Returns the time until the next L2 dispute game (after the provided block number) is submitted.
+     * Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getTimeToNextGame
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetTimeToNextGameParameters}
+     * @returns The L2 transaction hash. {@link GetTimeToNextGameReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     *
+     * const { seconds } = await publicClientL1.getTimeToNextGame({
+     *   l2BlockNumber: 113405763n,
+     *   targetChain: optimism
+     * })
+     */
+    getTimeToNextGame: <chainOverride extends Chain | undefined = undefined>(parameters: GetTimeToNextGameParameters<chain, chainOverride>) => Promise<GetTimeToNextGameReturnType>;
+    /**
+     * Returns the time until the next L2 output (after a provided block number) is submitted. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getTimeToNextL2Output
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetTimeToNextL2OutputParameters}
+     * @returns The L2 transaction hash. {@link GetTimeToNextL2OutputReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const l2BlockNumber = await publicClientL2.getBlockNumber()
+     * const { seconds } = await publicClientL1.getTimeToNextL2Output({
+     *   l2BlockNumber,
+     *   targetChain: optimism
+     * })
+     */
+    getTimeToNextL2Output: <chainOverride extends Chain | undefined = undefined>(parameters: GetTimeToNextL2OutputParameters<chain, chainOverride>) => Promise<GetTimeToNextL2OutputReturnType>;
+    /**
+     * Returns the time until the withdrawal transaction can be finalized. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getTimeToFinalize
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetTimeToFinalizeParameters}
+     * @returns Time until finalize. {@link GetTimeToFinalizeReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const receipt = await publicClientL2.getTransactionReceipt({
+     *   hash: '0x9a2f4283636ddeb9ac32382961b22c177c9e86dd3b283735c154f897b1a7ff4a',
+     * })
+     *
+     * const [withdrawal] = getWithdrawals(receipt)
+     *
+     * const { seconds } = await publicClientL1.getTimeToFinalize({
+     *   withdrawalHash: withdrawal.withdrawalHash,
+     *   targetChain: optimism
+     * })
+     */
+    getTimeToProve: <chainOverride extends Chain | undefined = undefined>(parameters: GetTimeToProveParameters<chain, chainOverride>) => Promise<GetTimeToProveReturnType>;
+    /**
+     * Returns the current status of a withdrawal. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/getWithdrawalStatus
+     *
+     * @param client - Client to use
+     * @param parameters - {@link GetWithdrawalStatusParameters}
+     * @returns Status of the withdrawal. {@link GetWithdrawalStatusReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const receipt = await publicClientL2.getTransactionReceipt({ hash: '0x...' })
+     * const status = await publicClientL1.getWithdrawalStatus({
+     *   receipt,
+     *   targetChain: optimism
+     * })
+     */
+    getWithdrawalStatus: <chainOverride extends Chain | undefined = undefined>(parameters: GetWithdrawalStatusParameters<chain, chainOverride>) => Promise<GetWithdrawalStatusReturnType>;
+    /**
+     * Waits for the next L2 output (after the provided block number) to be submitted.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/waitForNextGame
+     *
+     * @param client - Client to use
+     * @param parameters - {@link WaitForNextGameParameters}
+     * @returns The L2 transaction hash. {@link WaitForNextGameReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { optimism } from 'viem/chains'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     *
+     * await publicClientL1.waitForNextGame({
+     *   l2BlockNumber: 69420n,
+     *   targetChain: optimism
+     * })
+     */
+    waitForNextGame: <chainOverride extends Chain | undefined = undefined>(parameters: WaitForNextGameParameters<chain, chainOverride>) => Promise<WaitForNextGameReturnType>;
+    /**
+     * Waits for the next L2 output (after the provided block number) to be submitted.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/waitForNextL2Output
+     *
+     * @param client - Client to use
+     * @param parameters - {@link WaitForNextL2OutputParameters}
+     * @returns The L2 transaction hash. {@link WaitForNextL2OutputReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1())
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const l2BlockNumber = await getBlockNumber(publicClientL2)
+     * await waitForNextL2Output(publicClientL1, {
+     *   l2BlockNumber,
+     *   targetChain: optimism
+     * })
+     */
+    waitForNextL2Output: <chainOverride extends Chain | undefined = undefined>(parameters: WaitForNextL2OutputParameters<chain, chainOverride>) => Promise<WaitForNextL2OutputReturnType>;
+    /**
+     * Waits until the withdrawal transaction can be finalized. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/waitToFinalize
+     *
+     * @param client - Client to use
+     * @param parameters - {@link WaitToFinalizeParameters}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1)
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const receipt = await publicClientL2.getTransactionReceipt({
+     *   hash: '0x9a2f4283636ddeb9ac32382961b22c177c9e86dd3b283735c154f897b1a7ff4a',
+     * })
+     *
+     * const [withdrawal] = getWithdrawals(receipt)
+     *
+     * await publicClientL1.waitToFinalize({
+     *   withdrawalHash: withdrawal.withdrawalHash,
+     *   targetChain: optimism
+     * })
+     */
+    waitToFinalize: <chainOverride extends Chain | undefined = undefined>(parameters: WaitToFinalizeParameters<chain, chainOverride>) => Promise<WaitToFinalizeReturnType>;
+    /**
+     * Waits until the L2 withdrawal transaction is provable. Used for the [Withdrawal](/op-stack/guides/withdrawals) flow.
+     *
+     * - Docs: https://viem.sh/op-stack/actions/waitToProve
+     *
+     * @param client - Client to use
+     * @param parameters - {@link WaitToProveParameters}
+     * @returns The L2 output and withdrawal message. {@link WaitToProveReturnType}
+     *
+     * @example
+     * import { createPublicClient, http } from 'viem'
+     * import { getBlockNumber } from 'viem/actions'
+     * import { mainnet, optimism } from 'viem/chains'
+     * import { publicActionsL1 } from 'viem/op-stack'
+     *
+     * const publicClientL1 = createPublicClient({
+     *   chain: mainnet,
+     *   transport: http(),
+     * }).extend(publicActionsL1)
+     * const publicClientL2 = createPublicClient({
+     *   chain: optimism,
+     *   transport: http(),
+     * })
+     *
+     * const receipt = await publicClientL2.getTransactionReceipt({ hash: '0x...' })
+     * await publicClientL1.waitToProve({
+     *   receipt,
+     *   targetChain: optimism
+     * })
+     */
+    waitToProve: <chainOverride extends Chain | undefined = undefined>(parameters: WaitToProveParameters<chain, chainOverride>) => Promise<WaitToProveReturnType>;
+};
+/**
+ * A suite of Public Actions for suited for development with Layer 2 (OP Stack) chains.
+ *
+ * - Docs: https://viem.sh/op-stack/client
+ *
+ * @example
+ * import { publicActionsL1 } from 'viem/op-stack'
+ * import { mainnet } from 'viem/chains'
+ * import { buildDepositTransaction } from 'viem/wallet'
+ *
+ * export const opStackPublicClientL1 = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * }).extend(publicActionsL1())
+ */
+export declare function publicActionsL1(): <TTransport extends Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined>(client: Client<TTransport, TChain, TAccount>) => PublicActionsL1<TChain, TAccount>;
+//# sourceMappingURL=publicL1.d.ts.map

package/_types/op-stack/decorators/publicL1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicL1.d.ts","sourceRoot":"","sources":["../../../op-stack/decorators/publicL1.ts"],"names":[],"mappings":"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"}