Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
  • 何か問題がありますか？
#790 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
50/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
静か
技術スタック
typescript
領域
cli

調査の方向性

celocli multisig:approve コマンドから始め、CELO がゼロの認証済み送信者を使って失敗を再現し、その後、CLI に到達する前に gas-estimation error がどのようにラップされるかを調べます。CLI が contract revert を報告するのではなく、gas funds の不足を特定し、可能な場合はデバッグ用にネストされたエラーを保持できれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
TypeScript
スター
43
フォーク
36
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

celo-org/developer-tooling のほかの issue

celo-org/developer-tooling の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。