viem 2.9.1 → 2.9.3

package/_esm/op-stack/actions/getL2Output.js

@@ -0,0 +1,62 @@
+import { readContract, } from '../../actions/public/readContract.js';
+import { l2OutputOracleAbi } from '../abis.js';
+import { getGame } from './getGame.js';
+import { getPortalVersion, } from './getPortalVersion.js';
+/**
+ * Retrieves the first L2 output proposal that occurred after a provided block number.
+ *
+ * - 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 { getL2Output } from 'viem/op-stack'
+ *
+ * const publicClientL1 = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const output = await getL2Output(publicClientL1, {
+ *   l2BlockNumber: 69420n,
+ *   targetChain: optimism
+ * })
+ */
+export async function getL2Output(client, parameters) {
+    const { chain = client.chain, l2BlockNumber, targetChain } = parameters;
+    const version = await getPortalVersion(client, parameters);
+    if (version.major >= 3) {
+        const game = await getGame(client, parameters);
+        return {
+            l2BlockNumber: game.l2BlockNumber,
+            outputIndex: game.index,
+            outputRoot: game.rootClaim,
+            timestamp: game.timestamp,
+        };
+    }
+    const l2OutputOracleAddress = (() => {
+        if (parameters.l2OutputOracleAddress)
+            return parameters.l2OutputOracleAddress;
+        if (chain)
+            return targetChain.contracts.l2OutputOracle[chain.id].address;
+        return Object.values(targetChain.contracts.l2OutputOracle)[0].address;
+    })();
+    const outputIndex = await readContract(client, {
+        address: l2OutputOracleAddress,
+        abi: l2OutputOracleAbi,
+        functionName: 'getL2OutputIndexAfter',
+        args: [l2BlockNumber],
+    });
+    const output = await readContract(client, {
+        address: l2OutputOracleAddress,
+        abi: l2OutputOracleAbi,
+        functionName: 'getL2Output',
+        args: [outputIndex],
+    });
+    return { outputIndex, ...output };
+}
+//# sourceMappingURL=getL2Output.js.map

package/_esm/op-stack/actions/getL2Output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getL2Output.js","sourceRoot":"","sources":["../../../op-stack/actions/getL2Output.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAY7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAG9C,OAAO,EAA0B,OAAO,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAEL,gBAAgB,GACjB,MAAM,uBAAuB,CAAA;AA8B9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAK/B,MAAyC,EACzC,UAAuD;IAEvD,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,UAAU,CAAA;IAEvE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC,MAAM,EACN,UAAwC,CACzC,CAAA;IAED,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,UAA+B,CAAC,CAAA;QACnE,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC;IAED,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE;QAClC,IAAI,UAAU,CAAC,qBAAqB;YAClC,OAAO,UAAU,CAAC,qBAAqB,CAAA;QACzC,IAAI,KAAK;YACP,OAAQ,WAAuC,CAAC,SAAS,CAAC,cAAc,CACtE,KAAK,CAAC,EAAE,CACT,CAAC,OAAO,CAAA;QACX,OACE,MAAM,CAAC,MAAM,CACV,WAAuC,CAAC,SAAS,CAAC,cAAc,CAEpE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACd,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QAC7C,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,iBAAiB;QACtB,YAAY,EAAE,uBAAuB;QACrC,IAAI,EAAE,CAAC,aAAa,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACxC,OAAO,EAAE,qBAAqB;QAC9B,GAAG,EAAE,iBAAiB;QACtB,YAAY,EAAE,aAAa;QAC3B,IAAI,EAAE,CAAC,WAAW,CAAC;KACpB,CAAC,CAAA;IAEF,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAA;AACnC,CAAC"}

package/_esm/op-stack/actions/getPortalVersion.js

@@ -0,0 +1,48 @@
+import { readContract, } from '../../actions/public/readContract.js';
+import { withCache } from '../../utils/promise/withCache.js';
+import { portal2Abi } from '../abis.js';
+/**
+ * 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'
+ * import { getPortalVersion } from 'viem/op-stack'
+ *
+ * const publicClientL1 = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const version = await getPortalVersion(publicClientL1, {
+ *   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')
+ */
+export async function getPortalVersion(client, parameters) {
+    const { chain = client.chain, 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;
+    })();
+    const version = await withCache(() => readContract(client, {
+        abi: portal2Abi,
+        address: portalAddress,
+        functionName: 'version',
+    }), { cacheKey: ['portalVersion', portalAddress].join('.'), cacheTime: 300 });
+    const [major, minor, patch] = version.split('.').map(Number);
+    return { major, minor, patch };
+}
+//# sourceMappingURL=getPortalVersion.js.map

package/_esm/op-stack/actions/getPortalVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPortalVersion.js","sourceRoot":"","sources":["../../../op-stack/actions/getPortalVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAS7C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAkBvC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAIpC,MAAgC,EAChC,UAA4D;IAE5D,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,CAAA;IAExD,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;QAC1B,IAAI,UAAU,CAAC,aAAa;YAAE,OAAO,UAAU,CAAC,aAAa,CAAA;QAC7D,IAAI,KAAK;YAAE,OAAO,WAAY,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;QACjE,OAAO,MAAM,CAAC,MAAM,CAAC,WAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAChE,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,OAAO,GAAG,MAAM,SAAS,CAC7B,GAAG,EAAE,CACH,YAAY,CAAC,MAAM,EAAE;QACnB,GAAG,EAAE,UAAU;QACf,OAAO,EAAE,aAAa;QACtB,YAAY,EAAE,SAAS;KACxB,CAAC,EACJ,EAAE,QAAQ,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CACzE,CAAA;IAED,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAE5D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAChC,CAAC"}

package/_esm/op-stack/actions/getTimeToFinalize.js

@@ -0,0 +1,104 @@
+import { multicall, } from '../../actions/public/multicall.js';
+import { readContract } from '../../actions/public/readContract.js';
+import { BaseError } from '../../errors/base.js';
+import { l2OutputOracleAbi, portal2Abi, portalAbi } from '../abis.js';
+import { getPortalVersion } from './getPortalVersion.js';
+const buffer = 10;
+/**
+ * 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 { getTimeToFinalize } from 'viem/op-stack'
+ *
+ * const publicClientL1 = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const publicClientL2 = createPublicClient({
+ *   chain: optimism,
+ *   transport: http(),
+ * })
+ *
+ * const receipt = await publicClientL2.getTransactionReceipt({
+ *   hash: '0x9a2f4283636ddeb9ac32382961b22c177c9e86dd3b283735c154f897b1a7ff4a',
+ * })
+ *
+ * const [withdrawal] = getWithdrawals(receipt)
+ *
+ * const { seconds } = await getTimeToFinalize(publicClientL1, {
+ *   withdrawalHash: withdrawal.withdrawalHash,
+ *   targetChain: optimism
+ * })
+ */
+export async function getTimeToFinalize(client, parameters) {
+    const { chain = client.chain, withdrawalHash, 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;
+    })();
+    const portalVersion = await getPortalVersion(client, { portalAddress });
+    // Legacy
+    if (portalVersion.major < 3) {
+        const l2OutputOracleAddress = (() => {
+            if (parameters.l2OutputOracleAddress)
+                return parameters.l2OutputOracleAddress;
+            if (chain)
+                return targetChain.contracts.l2OutputOracle[chain.id].address;
+            return Object.values(targetChain.contracts.l2OutputOracle)[0].address;
+        })();
+        const [[_outputRoot, proveTimestamp, _l2OutputIndex], period] = await multicall(client, {
+            allowFailure: false,
+            contracts: [
+                {
+                    abi: portalAbi,
+                    address: portalAddress,
+                    functionName: 'provenWithdrawals',
+                    args: [withdrawalHash],
+                },
+                {
+                    abi: l2OutputOracleAbi,
+                    address: l2OutputOracleAddress,
+                    functionName: 'FINALIZATION_PERIOD_SECONDS',
+                },
+            ],
+        });
+        const secondsSinceProven = Date.now() / 1000 - Number(proveTimestamp);
+        const secondsToFinalize = Number(period) - secondsSinceProven;
+        const seconds = Math.floor(secondsToFinalize < 0 ? 0 : secondsToFinalize + buffer);
+        const timestamp = Date.now() + seconds * 1000;
+        return { period: Number(period), seconds, timestamp };
+    }
+    const [[_disputeGameProxy, proveTimestamp], proofMaturityDelaySeconds] = await Promise.all([
+        readContract(client, {
+            abi: portal2Abi,
+            address: portalAddress,
+            functionName: 'provenWithdrawals',
+            args: [withdrawalHash],
+        }),
+        readContract(client, {
+            abi: portal2Abi,
+            address: portalAddress,
+            functionName: 'proofMaturityDelaySeconds',
+        }),
+    ]);
+    if (proveTimestamp === 0n)
+        throw new BaseError('Withdrawal has not been proven on L1.');
+    const secondsSinceProven = Date.now() / 1000 - Number(proveTimestamp);
+    const secondsToFinalize = Number(proofMaturityDelaySeconds) - secondsSinceProven;
+    const seconds = Math.floor(secondsToFinalize < 0n ? 0 : secondsToFinalize + buffer);
+    const timestamp = Date.now() + seconds * 1000;
+    return { period: Number(proofMaturityDelaySeconds), seconds, timestamp };
+}
+//# sourceMappingURL=getTimeToFinalize.js.map

package/_esm/op-stack/actions/getTimeToFinalize.js.map

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

package/_esm/op-stack/actions/getTimeToNextGame.js.map

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

package/_esm/op-stack/actions/getTimeToNextL2Output.js

@@ -0,0 +1,91 @@
+import { multicall, } from '../../actions/public/multicall.js';
+import { readContract, } from '../../actions/public/readContract.js';
+import { l2OutputOracleAbi } from '../abis.js';
+/**
+ * Returns the time until the next L2 output (after the 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 { getBlockNumber } from 'viem/actions'
+ * import { mainnet, optimism } from 'viem/chains'
+ * import { getTimeToNextL2Output } from 'viem/op-stack'
+ *
+ * const publicClientL1 = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const publicClientL2 = createPublicClient({
+ *   chain: optimism,
+ *   transport: http(),
+ * })
+ *
+ * const { seconds } = await getTimeToNextL2Output(publicClientL1, {
+ *   targetChain: optimism
+ * })
+ */
+export async function getTimeToNextL2Output(client, parameters) {
+    const { intervalBuffer = 1.1, chain = client.chain, l2BlockNumber, targetChain, } = parameters;
+    const l2OutputOracleAddress = (() => {
+        if (parameters.l2OutputOracleAddress)
+            return parameters.l2OutputOracleAddress;
+        if (chain)
+            return targetChain.contracts.l2OutputOracle[chain.id].address;
+        return Object.values(targetChain.contracts.l2OutputOracle)[0].address;
+    })();
+    const [latestOutputIndex, blockTime, blockInterval] = await multicall(client, {
+        allowFailure: false,
+        contracts: [
+            {
+                abi: l2OutputOracleAbi,
+                address: l2OutputOracleAddress,
+                functionName: 'latestOutputIndex',
+            },
+            {
+                abi: l2OutputOracleAbi,
+                address: l2OutputOracleAddress,
+                functionName: 'L2_BLOCK_TIME',
+            },
+            {
+                abi: l2OutputOracleAbi,
+                address: l2OutputOracleAddress,
+                functionName: 'SUBMISSION_INTERVAL',
+            },
+        ],
+    });
+    const latestOutput = await readContract(client, {
+        abi: l2OutputOracleAbi,
+        address: l2OutputOracleAddress,
+        functionName: 'getL2Output',
+        args: [latestOutputIndex],
+    });
+    const latestOutputTimestamp = Number(latestOutput.timestamp) * 1000;
+    const interval = Number(blockInterval * blockTime);
+    const intervalWithBuffer = Math.ceil(interval * intervalBuffer);
+    const now = Date.now();
+    const seconds = (() => {
+        // If the current timestamp is lesser than the latest L2 output timestamp,
+        // then we assume that the L2 output has already been submitted.
+        if (now < latestOutputTimestamp)
+            return 0;
+        // If the latest L2 output block is newer than the provided L2 block number,
+        // then we assume that the L2 output has already been submitted.
+        if (latestOutput.l2BlockNumber > l2BlockNumber)
+            return 0;
+        const elapsedBlocks = Number(l2BlockNumber - latestOutput.l2BlockNumber);
+        const elapsed = Math.ceil((now - latestOutputTimestamp) / 1000);
+        const secondsToNextOutput = intervalWithBuffer - (elapsed % intervalWithBuffer);
+        return elapsedBlocks < blockInterval
+            ? secondsToNextOutput
+            : Math.floor(elapsedBlocks / Number(blockInterval)) * intervalWithBuffer +
+                secondsToNextOutput;
+    })();
+    const timestamp = seconds > 0 ? now + seconds * 1000 : undefined;
+    return { interval, seconds, timestamp };
+}
+//# sourceMappingURL=getTimeToNextL2Output.js.map

package/_esm/op-stack/actions/getTimeToNextL2Output.js.map

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

package/_esm/op-stack/actions/getTimeToProve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTimeToProve.js","sourceRoot":"","sources":["../../../op-stack/actions/getTimeToProve.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,gBAAgB,GACjB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAIL,iBAAiB,GAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAIL,qBAAqB,GACtB,MAAM,4BAA4B,CAAA;AAkCnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAKlC,MAAyC,EACzC,UAA0D;IAE1D,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAE9B,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAC1C,MAAM,EACN,UAAwC,CACzC,CAAA;IAED,SAAS;IACT,IAAI,aAAa,CAAC,KAAK,GAAG,CAAC;QACzB,OAAO,qBAAqB,CAAC,MAAM,EAAE;YACnC,GAAG,UAAU;YACb,aAAa,EAAE,OAAO,CAAC,WAAW;SACA,CAAC,CAAA;IAEvC,OAAO,iBAAiB,CAAC,MAAM,EAAE;QAC/B,GAAG,UAAU;QACb,aAAa,EAAE,OAAO,CAAC,WAAW;KACJ,CAAC,CAAA;AACnC,CAAC"}

package/_esm/op-stack/actions/getWithdrawalStatus.js

@@ -0,0 +1,151 @@
+import { readContract, } from '../../actions/public/readContract.js';
+import { ContractFunctionRevertedError } from '../../errors/contract.js';
+import { portal2Abi, portalAbi } from '../abis.js';
+import { ReceiptContainsNoWithdrawalsError } from '../errors/withdrawal.js';
+import { getWithdrawals, } from '../utils/getWithdrawals.js';
+import { getGame, } from './getGame.js';
+import { getL2Output, } from './getL2Output.js';
+import { getPortalVersion, } from './getPortalVersion.js';
+import { getTimeToFinalize, } from './getTimeToFinalize.js';
+/**
+ * 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 { getWithdrawalStatus } from 'viem/op-stack'
+ *
+ * const publicClientL1 = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const publicClientL2 = createPublicClient({
+ *   chain: optimism,
+ *   transport: http(),
+ * })
+ *
+ * const receipt = await publicClientL2.getTransactionReceipt({ hash: '0x...' })
+ * const status = await getWithdrawalStatus(publicClientL1, {
+ *   receipt,
+ *   targetChain: optimism
+ * })
+ */
+export async function getWithdrawalStatus(client, parameters) {
+    const { chain = client.chain, gameLimit = 100, receipt, targetChain: targetChain_, } = parameters;
+    const targetChain = targetChain_;
+    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;
+    })();
+    const [withdrawal] = getWithdrawals(receipt);
+    if (!withdrawal)
+        throw new ReceiptContainsNoWithdrawalsError({
+            hash: receipt.transactionHash,
+        });
+    const portalVersion = await getPortalVersion(client, parameters);
+    // Legacy (Portal < v3)
+    if (portalVersion.major < 3) {
+        const [outputResult, proveResult, finalizedResult, timeToFinalizeResult] = await Promise.allSettled([
+            getL2Output(client, {
+                ...parameters,
+                l2BlockNumber: receipt.blockNumber,
+            }),
+            readContract(client, {
+                abi: portalAbi,
+                address: portalAddress,
+                functionName: 'provenWithdrawals',
+                args: [withdrawal.withdrawalHash],
+            }),
+            readContract(client, {
+                abi: portalAbi,
+                address: portalAddress,
+                functionName: 'finalizedWithdrawals',
+                args: [withdrawal.withdrawalHash],
+            }),
+            getTimeToFinalize(client, {
+                ...parameters,
+                withdrawalHash: withdrawal.withdrawalHash,
+            }),
+        ]);
+        // If the L2 Output is not processed yet (ie. the actions throws), this means
+        // that the withdrawal is not ready to prove.
+        if (outputResult.status === 'rejected') {
+            const error = outputResult.reason;
+            if (error.cause instanceof ContractFunctionRevertedError &&
+                error.cause.data?.args?.[0] ===
+                    'L2OutputOracle: cannot get output for a block that has not been proposed')
+                return 'waiting-to-prove';
+            throw error;
+        }
+        if (proveResult.status === 'rejected')
+            throw proveResult.reason;
+        if (finalizedResult.status === 'rejected')
+            throw finalizedResult.reason;
+        if (timeToFinalizeResult.status === 'rejected')
+            throw timeToFinalizeResult.reason;
+        const [_, proveTimestamp] = proveResult.value;
+        if (!proveTimestamp)
+            return 'ready-to-prove';
+        const finalized = finalizedResult.value;
+        if (finalized)
+            return 'finalized';
+        const { seconds } = timeToFinalizeResult.value;
+        return seconds > 0 ? 'waiting-to-finalize' : 'ready-to-finalize';
+    }
+    const [disputeGameResult, checkWithdrawalResult, finalizedResult] = await Promise.allSettled([
+        getGame(client, {
+            ...parameters,
+            l2BlockNumber: receipt.blockNumber,
+            limit: gameLimit,
+        }),
+        readContract(client, {
+            abi: portal2Abi,
+            address: portalAddress,
+            functionName: 'checkWithdrawal',
+            args: [withdrawal.withdrawalHash],
+        }),
+        readContract(client, {
+            abi: portal2Abi,
+            address: portalAddress,
+            functionName: 'finalizedWithdrawals',
+            args: [withdrawal.withdrawalHash],
+        }),
+    ]);
+    if (finalizedResult.status === 'fulfilled' && finalizedResult.value)
+        return 'finalized';
+    if (disputeGameResult.status === 'rejected') {
+        const error = disputeGameResult.reason;
+        if (error.name === 'GameNotFoundError')
+            return 'waiting-to-prove';
+        throw disputeGameResult.reason;
+    }
+    if (checkWithdrawalResult.status === 'rejected') {
+        const error = checkWithdrawalResult.reason;
+        if (error.cause instanceof ContractFunctionRevertedError) {
+            const errorMessage = error.cause.data?.args?.[0];
+            if (errorMessage === 'OptimismPortal: withdrawal has not been proven yet')
+                return 'ready-to-prove';
+            if (errorMessage ===
+                'OptimismPortal: proven withdrawal has not matured yet' ||
+                errorMessage ===
+                    'OptimismPortal: output proposal has not been finalized yet' ||
+                errorMessage === 'OptimismPortal: output proposal in air-gap')
+                return 'waiting-to-finalize';
+        }
+        throw checkWithdrawalResult.reason;
+    }
+    if (finalizedResult.status === 'rejected')
+        throw finalizedResult.reason;
+    return 'ready-to-finalize';
+}
+//# sourceMappingURL=getWithdrawalStatus.js.map

package/_esm/op-stack/actions/getWithdrawalStatus.js.map

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

package/_esm/op-stack/actions/initiateWithdrawal.js

@@ -0,0 +1,76 @@
+import { writeContract, } from '../../actions/wallet/writeContract.js';
+import { l2ToL1MessagePasserAbi } from '../abis.js';
+import { contracts } from '../contracts.js';
+import { estimateInitiateWithdrawalGas, } from './estimateInitiateWithdrawalGas.js';
+/**
+ * Initiates a [withdrawal](https://community.optimism.io/docs/protocol/withdrawal-flow/#withdrawal-initiating-transaction) on an L2 to the L1.
+ *
+ * Internally performs a contract write to the [`initiateWithdrawal` function](https://github.com/ethereum-optimism/optimism/blob/283f0aa2e3358ced30ff7cbd4028c0c0c3faa140/packages/contracts-bedrock/src/L2/L2ToL1MessagePasser.sol#L73)
+ * on the [Optimism L2ToL1MessagePasser predeploy contract](https://github.com/ethereum-optimism/optimism/blob/283f0aa2e3358ced30ff7cbd4028c0c0c3faa140/packages/contracts-bedrock/src/L2/L2ToL1MessagePasser.sol).
+ *
+ * - Docs: https://viem.sh/op-stack/actions/initiateWithdrawal
+ *
+ * @param client - Client to use
+ * @param parameters - {@link InitiateWithdrawalParameters}
+ * @returns The L2 transaction hash. {@link InitiateWithdrawalReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom, parseEther } from 'viem'
+ * import { base, mainnet } from 'viem/chains'
+ * import { initiateWithdrawal } from 'viem/op-stack'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ *
+ * const hash = await initiateWithdrawal(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   args: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { base, mainnet } from 'viem/chains'
+ * import { initiateWithdrawal } from 'viem/op-stack'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const hash = await initiateWithdrawal(client, {
+ *   request: {
+ *     gas: 21_000n,
+ *     to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *     value: parseEther('1'),
+ *   },
+ * })
+ */
+export async function initiateWithdrawal(client, parameters) {
+    const { account, chain = client.chain, gas, maxFeePerGas, maxPriorityFeePerGas, nonce, request: { data = '0x', gas: l1Gas, to, value }, } = parameters;
+    const gas_ = typeof gas !== 'number' && gas !== null
+        ? await estimateInitiateWithdrawalGas(client, parameters)
+        : undefined;
+    return writeContract(client, {
+        account: account,
+        abi: l2ToL1MessagePasserAbi,
+        address: contracts.l2ToL1MessagePasser.address,
+        chain,
+        functionName: 'initiateWithdrawal',
+        args: [to, l1Gas, data],
+        gas: gas_,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce,
+        value,
+    });
+}
+//# sourceMappingURL=initiateWithdrawal.js.map

package/_esm/op-stack/actions/initiateWithdrawal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiateWithdrawal.js","sourceRoot":"","sources":["../../../op-stack/actions/initiateWithdrawal.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,GACd,MAAM,uCAAuC,CAAA;AAa9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAGL,6BAA6B,GAC9B,MAAM,oCAAoC,CAAA;AAoC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAKtC,MAAyC,EACzC,UAAuE;IAEvE,MAAM,EACJ,OAAO,EACP,KAAK,GAAG,MAAM,CAAC,KAAK,EACpB,GAAG,EACH,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,OAAO,EAAE,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAChD,GAAG,UAAU,CAAA;IAEd,MAAM,IAAI,GACR,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QACrC,CAAC,CAAC,MAAM,6BAA6B,CACjC,MAAM,EACN,UAAqD,CACtD;QACH,CAAC,CAAC,SAAS,CAAA;IAEf,OAAO,aAAa,CAAC,MAAM,EAAE;QAC3B,OAAO,EAAE,OAAQ;QACjB,GAAG,EAAE,sBAAsB;QAC3B,OAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,OAAO;QAC9C,KAAK;QACL,YAAY,EAAE,oBAAoB;QAClC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC;QACvB,GAAG,EAAE,IAAI;QACT,YAAY;QACZ,oBAAoB;QACpB,KAAK;QACL,KAAK;KACmC,CAAC,CAAA;AAC7C,CAAC"}

package/_esm/op-stack/actions/proveWithdrawal.js

@@ -0,0 +1,57 @@
+import { writeContract, } from '../../actions/wallet/writeContract.js';
+import { portalAbi } from '../abis.js';
+import { estimateProveWithdrawalGas, } from './estimateProveWithdrawalGas.js';
+/**
+ * Proves a withdrawal that occurred on an L2. Used in the Withdrawal flow.
+ *
+ * - Docs: https://viem.sh/op-stack/actions/proveWithdrawal
+ *
+ * @param client - Client to use
+ * @param parameters - {@link ProveWithdrawalParameters}
+ * @returns The prove transaction hash. {@link ProveWithdrawalReturnType}
+ *
+ * @example
+ * import { createWalletClient, http } from 'viem'
+ * import { mainnet, optimism } from 'viem/chains'
+ * import { proveWithdrawal } from 'viem/op-stack'
+ *
+ * const walletClientL1 = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const request = await proveWithdrawal(walletClientL1, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   l2OutputIndex: 4529n,
+ *   outputRootProof: { ... },
+ *   targetChain: optimism,
+ *   withdrawalProof: [ ... ],
+ *   withdrawal: { ... },
+ * })
+ */
+export async function proveWithdrawal(client, parameters) {
+    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;
+    })();
+    const gas_ = typeof gas !== 'bigint' && gas !== null
+        ? await estimateProveWithdrawalGas(client, parameters)
+        : gas ?? undefined;
+    return writeContract(client, {
+        account: account,
+        abi: portalAbi,
+        address: portalAddress,
+        chain,
+        functionName: 'proveWithdrawalTransaction',
+        args: [withdrawal, l2OutputIndex, outputRootProof, withdrawalProof],
+        gas: gas_,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce,
+    });
+}
+//# sourceMappingURL=proveWithdrawal.js.map

package/_esm/op-stack/actions/proveWithdrawal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveWithdrawal.js","sourceRoot":"","sources":["../../../op-stack/actions/proveWithdrawal.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,GACd,MAAM,uCAAuC,CAAA;AAa9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAGL,0BAA0B,GAC3B,MAAM,iCAAiC,CAAA;AAqDxC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAKnC,MAAyC,EACzC,UAAoE;IAEpE,MAAM,EACJ,OAAO,EACP,KAAK,GAAG,MAAM,CAAC,KAAK,EACpB,GAAG,EACH,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,GACX,GAAG,UAAU,CAAA;IAEd,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;QAC1B,IAAI,UAAU,CAAC,aAAa;YAAE,OAAO,UAAU,CAAC,aAAa,CAAA;QAC7D,IAAI,KAAK;YAAE,OAAO,WAAY,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;QACjE,OAAO,MAAM,CAAC,MAAM,CAAC,WAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAChE,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,IAAI,GACR,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QACrC,CAAC,CAAC,MAAM,0BAA0B,CAC9B,MAAM,EACN,UAAkD,CACnD;QACH,CAAC,CAAC,GAAG,IAAI,SAAS,CAAA;IAEtB,OAAO,aAAa,CAAC,MAAM,EAAE;QAC3B,OAAO,EAAE,OAAQ;QACjB,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,aAAa;QACtB,KAAK;QACL,YAAY,EAAE,4BAA4B;QAC1C,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,CAAC;QACnE,GAAG,EAAE,IAAI;QACT,YAAY;QACZ,oBAAoB;QACpB,KAAK;KACmC,CAAC,CAAA;AAC7C,CAAC"}