Add deposit & withdraw for OP. by Mc01 · Pull Request #774 · celo-org/developer-tooling

Mc01 · 2026-04-20T12:33:44Z

Description

Adds bridge commands to the Celo CLI for moving CELO tokens between Ethereum (L1) and Celo (L2) via the OP Stack bridge. This PR extends CLI with:

bridge:deposit — Deposit CELO from Ethereum L1 to Celo L2 (~15 min)
bridge:withdraw-init — Initiate a withdrawal from Celo L2 to Ethereum L1
bridge:withdraw-prove — Build and submit withdrawal proof on L1 (~1hr after init)
bridge:withdraw-status — Check withdrawal status with human-readable output and next-step guidance
bridge:withdraw-finalize — Claim funds on L1 after 7-day challenge period

Tested

32 unit tests across 3 test suites (all passing):
- src/utils/bridge.test.ts — validates network config, contract addresses, chain IDs, status labels
- src/commands/bridge/deposit.test.ts — flag validation, address parsing, network rejection, signing requirements
- src/commands/bridge/withdraw.test.ts — flag validation for all 4 withdrawal commands (init, prove, status, finalize)
Manual testing

How to QA

Prerequisites:

Funded address with CELO on Ethereum Sepolia (for deposit) or Celo Sepolia (for withdrawal)
Ethereum Sepolia RPC URL (e.g., Alchemy/Infura)
Private key for the funded address

Test deposit (L1 → L2):

celocli bridge:deposit \
    --from 0xYOUR_ADDRESS \
    --value 1000000000000000000 \
    --network sepolia \
    --l1RpcUrl https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY \
    -k 0xYOUR_PRIVATE_KEY

Verify: CELO appears on Celo Sepolia within ~15 minutes.

Test withdrawal (L2 → L1):

# Step 1: Initiate
celocli bridge:withdraw-init \
    --from 0xYOUR_ADDRESS --value 1000000000000000000 \
    --network sepolia -n celo-sepolia -k 0xYOUR_PRIVATE_KEY

# Step 2: Check status (anytime)
celocli bridge:withdraw-status \
    --txHash 0xTX_HASH --network sepolia \
    --l1RpcUrl https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY -n celo-sepolia

# Step 3: Prove (~1hr later when status shows "Ready to Prove")
celocli bridge:withdraw-prove \
    --txHash 0xTX_HASH --from 0xYOUR_ADDRESS --network sepolia \
    --l1RpcUrl https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY -n celo-sepolia -k 0xYOUR_PRIVATE_KEY

# Step 4: Finalize (after 7-day challenge period)
  ./bin/run.js bridge:withdraw-finalize \
    --txHash 0xTX_HASH --from 0xYOUR_ADDRESS --network sepolia \
    --l1RpcUrl https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY -n celo-sepolia -k 0xYOUR_PRIVATE_KEY

Related issues

https://github.com/celo-org/celo-blockchain-planning/issues/1172

PR-Codex overview

This PR focuses on enhancing the bridge functionality within the CLI for managing CELO token transfers between Ethereum (L1) and Celo (L2). It introduces new commands, modifies existing ones, and adds tests for improved reliability and user guidance.

Detailed summary

Added bridge command with deposit and withdrawal functionalities.
Introduced BridgeDeposit, BridgeWithdrawInit, BridgeWithdrawProve, BridgeWithdrawFinalize, and BridgeWithdrawStatus classes.
Implemented tests for various command flags and validation.
Updated package.json to include bridge description.
Enhanced documentation for bridge commands.
Added network validation and error handling for user inputs.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

changeset-bot · 2026-04-20T12:36:41Z

⚠️ No Changeset found

Latest commit: 77131c7

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Mc01 · 2026-04-20T12:37:26Z

@copilot review

Copilot

Pull request overview

Adds OP Stack bridge support to the Celo CLI to move CELO between Ethereum L1 and Celo L2, including end-to-end withdraw lifecycle commands and supporting utilities/docs.

Changes:

Introduces new bridge:* CLI commands for deposit and multi-step withdrawals (init/prove/status/finalize).
Adds shared bridge network/config utilities (chain definitions, ABIs, status labels) plus unit tests.
Adds CLI topic metadata and end-user documentation for bridge workflows.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/cli/src/utils/bridge.ts	Adds bridge network config, OP Stack chain definitions, ABIs, and status labels used by commands.
packages/cli/src/utils/bridge.test.ts	Unit tests for network validation, config constants, chain selection, and status labels.
packages/cli/src/commands/bridge/deposit.ts	Implements L1→L2 CELO deposit flow (token lookup, approve, deposit).
packages/cli/src/commands/bridge/deposit.test.ts	Flag-validation tests for `bridge:deposit`.
packages/cli/src/commands/bridge/withdraw-init.ts	Implements L2 withdrawal initiation transaction.
packages/cli/src/commands/bridge/withdraw-prove.ts	Implements proof waiting/building and L1 prove submission.
packages/cli/src/commands/bridge/withdraw-status.ts	Implements human-readable withdrawal status + next-step guidance.
packages/cli/src/commands/bridge/withdraw-finalize.ts	Implements finalization/claim on L1 after challenge period.
packages/cli/src/commands/bridge/withdraw.test.ts	Flag-validation tests for all withdrawal commands.
packages/cli/package.json	Registers the `bridge` command topic in CLI metadata.
packages/cli/docs/bridge.md	Adds user documentation for deposit/withdraw workflows and status meanings.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c1f4a70ce9

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 59211d4e1b

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

github-actions · 2026-04-20T12:46:35Z

size-limit report 📦

Path	Size
require('@celo/actions') (cjs)	98.85 KB (0%)
import * from '@celo/actions' (esm)	23.55 KB (0%)
import { resolveAddress } from '@celo/actions' (esm)	23.49 KB (0%)
import { getGasPriceOnCelo } from '@celo/actions' (esm)	73 B (0%)
import { getAccountsContract } from '@celo/actions/contracts/accounts' (esm)	46.11 KB (0%)
import * from '@celo/actions/staking' (esm)	50.66 KB (0%)

codecov · 2026-04-20T12:47:01Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.61%. Comparing base (9ff437d) to head (77131c7).

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #774   +/-   ##
=======================================
  Coverage   69.61%   69.61%           
=======================================
  Files         150      150           
  Lines        7075     7075           
  Branches     1163     1138   -25     
=======================================
  Hits         4925     4925           
+ Misses       2080     2076    -4     
- Partials       70       74    +4

Components	Coverage Δ
celocli	`∅ <ø> (∅)`
sdk	`69.12% <ø> (ø)`
wallets	`73.14% <ø> (ø)`
viem-sdks	`94.15% <ø> (ø)`

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Mc01 · 2026-04-20T13:07:02Z

@copilot review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bbd643bcde

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 709a92eadd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6017ecd28f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9cde87409c

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 77131c7050

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector · 2026-05-25T13:07:23Z

+    const l2NodeUrl = await this.getNodeUrl()
+    const l2Client = createPublicClient({
+      chain: l2Chain,
+      transport: http(l2NodeUrl),


Preserve --node transport scheme in withdraw status

Use the same scheme-aware transport selection as BaseCommand instead of forcing http(...) here. With --node ws://... or an IPC path, this wraps the endpoint in an HTTP transport and the command fails before any status checks, even though global CLI node handling explicitly supports http, ws, and .ipc; this is a regression in bridge:withdraw-status for users relying on non-HTTP endpoints.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-05-25T13:07:23Z

+    const l2NodeUrl = await this.getNodeUrl()
+    const l2Client = createPublicClient({
+      chain: l2Chain,
+      transport: http(l2NodeUrl),


Preserve --node transport scheme in withdraw finalize

This command also hardcodes http(l2NodeUrl) for the L2 client, so --node values like ws://... or .../.ipc cannot work here even though the CLI’s base transport logic supports them. In practice, bridge:withdraw-finalize will fail for those valid node configurations before finalization logic runs, breaking expected global flag behavior.

Useful? React with 👍 / 👎.

Add deposit & withdraw for OP.

c1f4a70

Copilot AI review requested due to automatic review settings April 20, 2026 12:33

Mc01 requested a review from a team as a code owner April 20, 2026 12:33

Formatting.

9b65126

Copilot AI reviewed Apr 20, 2026

View reviewed changes

Update packages/cli/docs/bridge.md

59211d4

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/deposit.ts

Comment thread packages/cli/src/commands/bridge/deposit.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/withdraw-prove.ts Outdated

Comment thread packages/cli/src/commands/bridge/withdraw-finalize.ts Outdated

Mc01 added 2 commits April 20, 2026 15:05

Copilot CR.

8bddf04

Formatting.

bbd643b

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/deposit.ts

Comment thread packages/cli/src/commands/bridge/withdraw-init.ts Outdated

Mc01 added 2 commits April 20, 2026 15:20

Add as any to unblock CI.

d8864d0

Formatting.

709a92e

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/withdraw-init.ts

Comment thread packages/cli/src/commands/bridge/withdraw-prove.ts

Mc01 added 2 commits April 20, 2026 16:18

Copilot CR.

a7a9dd2

Formatting.

df95bed

This comment was marked as outdated.

Sign in to view

Mc01 added 2 commits April 20, 2026 16:58

Fix CI.

1463195

Formatting.

6017ecd

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/withdraw-prove.ts

Mc01 added 2 commits April 21, 2026 10:21

Linting.

768a93c

Formatting.

9cde874

chatgpt-codex-connector Bot reviewed Apr 21, 2026

View reviewed changes

Comment thread packages/cli/src/commands/bridge/withdraw-prove.ts

Mc01 added 2 commits April 21, 2026 10:38

Handle edge case. Increase coverage.

031c7c0

Formatting.

33d7414

Merge branch 'master' into mc01/bridge-cli

77131c7

chatgpt-codex-connector Bot reviewed May 25, 2026

View reviewed changes

Conversation

Mc01 commented Apr 20, 2026 • edited by pr-codex Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Tested

How to QA

PR-Codex overview

Detailed summary

Uh oh!

changeset-bot Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

Mc01 commented Apr 20, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

codecov Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Mc01 commented Apr 20, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot May 25, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot May 25, 2026

Choose a reason for hiding this comment

Mc01 commented Apr 20, 2026 •

edited by pr-codex Bot

Loading

changeset-bot Bot commented Apr 20, 2026 •

edited

Loading

github-actions Bot commented Apr 20, 2026 •

edited

Loading

codecov Bot commented Apr 20, 2026 •

edited

Loading