Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Zero CELO gas balance is reported as a contract revert: "gas required exceeds allowance (0)"

Đang mở
  • Có gì không ổn?
#790 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
50/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript
Lĩnh vực
cli

Hướng nghiên cứu

Bắt đầu với lệnh celocli multisig:approve và tái hiện lỗi bằng một sender đã được ủy quyền nhưng không có CELO, sau đó kiểm tra cách lỗi ước tính gas được bọc trước khi đến CLI. Công việc được xem là hoàn tất khi CLI xác định số dư gas không đủ thay vì báo cáo contract revert, đồng thời giữ lại lỗi lồng nhau để gỡ lỗi khi có thể.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug celocli
Package
  • @celo/celocli 9.0.1
  • viem 2.55.11 (dependency bundled by celocli)
Environment
  • Celo Mainnet via https://forno.celo.org
  • macOS on Apple Silicon
  • Ledger signer (the issue appears to be independent of the signer type)
Command
celocli multisig:approve \
  --for <multisig> \
  --tx <transaction-id> \
  --from <owner-with-zero-CELO-balance> \
  --useLedger \
  --node https://forno.celo.org
Describe the bug

When the sending account has a zero native CELO balance and therefore cannot pay gas, celocli reports the gas-estimation failure as a contract execution revert:

Sending Transaction: multisig: approving transaction ... failed:
Execution reverted with reason: gas required exceeds allowance (0).

ContractFunctionExecutionError: Execution reverted with reason:
gas required exceeds allowance (0).

This is misleading because the contract call itself does not revert. The account simply has no CELO with which to pay transaction fees.

In the observed case:

  • the sender's native CELO balance was exactly 0;
  • all celocli multisig checks passed;
  • confirmations(transactionId, sender) remained false, confirming that nothing was submitted;
  • a read-only trace of the same confirmTransaction call succeeded;
  • the trace estimated approximately 211,260 gas;
  • funding the sender is the required remedy.

The message led us to investigate the multisig transaction and contract logic, even though neither was the source of the failure.

Expected behavior

celocli should identify this as an insufficient gas-funds error and provide an actionable message, for example:

The sender does not have enough CELO to pay transaction fees.
Sender balance: 0 CELO.
Fund the sender or select a supported --gasCurrency with sufficient balance.

It should not describe this condition as an execution revert.

Actual behavior

The underlying RPC text:

gas required exceeds allowance (0)

is wrapped as EstimateGasExecutionError, ExecutionRevertedError, TransactionExecutionError, and finally ContractFunctionExecutionError, resulting in the incorrect user-facing statement that contract execution reverted.

Suggested fix

Before sending or estimating a transaction, celocli could:

  1. retrieve the sender's native balance (or selected gas-currency balance);
  2. compare it with the estimated/upfront fee requirement where possible; and
  3. fail with a dedicated insufficient-gas-funds message.

Alternatively, the transaction error handler could recognize node errors matching gas required exceeds allowance (<amount>) during gas estimation and translate them into an insufficient-funds error rather than an execution revert.

The exact string may originate from the RPC client and the incorrect classification may occur in viem, but celocli should still present an actionable CLI error. Preserving the original nested error for debugging would be useful.

Reproduction outline
  1. Use an account that is authorized to perform a transaction but has 0 CELO.
  2. Run a celocli write command using that account as --from.
  3. Observe Execution reverted with reason: gas required exceeds allowance (0) during gas estimation.
  4. Simulate/trace the contract call independently and observe that it succeeds.
  5. Fund the sender with enough CELO for gas and retry.
Ngôn ngữ chính
TypeScript
Star
43
Fork
36
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của celo-org/developer-tooling

Tất cả issue của celo-org/developer-tooling

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.