How to Fix a Failed Gnosis Safe Transaction in a DAO
A failed Gnosis Safe transaction in a DAO usually means the underlying on-chain governance proposal execution was rejected by the Ethereum network, or the Safe itself prevented execution due to signature or configuration issues. To fix it, you must identify why it failed, then resubmit a corrected transaction through the DAO's governance process.
Understand why the transaction failed
Before attempting a fix, determine the failure cause. Common reasons include:
- Out-of-gas limit: The transaction required more gas than allocated. Ethereum transactions have a gas limit; if the execution logic (e.g., calling a smart contract) uses more gas than the limit set, the transaction reverts.
- Revert in the target contract: The action the Safe tried to execute (e.g., a token transfer, a protocol interaction) was rejected by the external contract. This can happen if the contract's state changed between proposal creation and execution (e.g., a token balance became insufficient, or a deadline expired).
- Signature mismatch or threshold not met: The Gnosis Safe requires a minimum number of owner signatures (the threshold) to execute a transaction. If the wrong number of signatures or incorrect signing keys were used, the Safe rejects the transaction.
- Timelock or delay constraints: If your DAO uses a timelock (see the site's article on timelock execution delays) and the proposal was executed before or after the allowed window, the transaction fails.
Check the transaction hash on a block explorer (e.g., Etherscan) for the exact error message. Look for "revert reason" in the transaction logs.
Step-by-Step Fix Process
1. Diagnose the Failure Using the Block Explorer
- Copy the failed transaction hash from your DAO's governance interface or from the Safe app.
- Paste it into a block explorer. Under "Status," it will show "Fail" with an error string. Common strings include:
"execution reverted"- the target contract rejected the call."GS013"- a Gnosis Safe-specific error indicating a signature problem (often threshold not met or invalid owner)."out of gas"- the gas limit was too low.
2. Determine Whether the Failure Is Recoverable
Most failures are recoverable if the underlying conditions have not permanently changed. For example:
- Out of gas: Increase the gas limit and resubmit. This is the simplest fix.
- Revert due to expired deadline or changed state: You may need to create a new proposal with updated parameters (e.g., a new token price, a later execution window).
- Signature issue: Re-sign the transaction with correct owners and threshold.
- Timelock violation: Wait until the next available execution window, or create a new proposal if the timelock period has fully passed.
Permanent failures (unrecoverable): - The target contract has been destroyed or upgraded in a breaking way. - The DAO's Safe has been compromised and the owners changed. In this case, the DAO likely needs a separate recovery process (outside the scope of this article).
3. For Gas or Signature Failures: Resubmit Directly
If the failure is due to gas or signature issues, you can often resubmit the same transaction without a new governance proposal.
- In the Gnosis Safe app, locate the failed transaction in the "Transactions" queue. It may still appear as "pending" or "failed."
- Click "Edit" and increase the gas limit (for gas failures) or re-add the required signatures (for signature failures).
- Submit the transaction again. The Safe will re-execute the same call data.
Important: Ensure the DAO's governance module (e.g., Zodiac) still considers the proposal active. If the proposal has expired due to its own timelock or voting period, you cannot resubmit - you must create a new proposal.
4. For Revert Failures: Create a New Proposal
If the target contract reverted, the original proposal's call data is invalid for the current state. You must:
- Identify the new correct call data. For example, if a token swap failed because the exchange rate changed, get the current rate and recalculate the amounts.
- Draft a new proposal following your DAO's governance process (as covered in "How to Write a DAO Proposal That Passes").
- Include the updated call data and explain in the proposal description why the original failed and what changed.
- Pass the proposal through voting (on-chain or off-chain, depending on your DAO's setup).
- Execute the new proposal via the Gnosis Safe once approved.
5. Update the DAO's Transaction Queue
After resubmitting or creating a new proposal, remove or cancel the failed transaction from the Safe's queue to avoid confusion. In the Safe app, you can mark it as "Rejected" (if the DAO's governance module allows) or simply ignore it. Some modules automatically clear expired proposals.
Special case: the safe itself has a bug
If the error message is cryptic or the Safe's internal logic fails (e.g., the Zodiac module misreports quorum), check the Safe's contract version. Outdated Safe contracts (pre-1.4.0) had known issues with certain call patterns. Upgrading the Safe to the latest version may fix persistent failures. This requires a separate governance proposal and a Safe upgrade transaction.
Prevent Future Failures
- Set adequate gas limits when creating proposals. Use a gas estimator like the one in the Gnosis Safe app or a tool like Tenderly.
- Test proposals on a testnet before submitting on mainnet. This catches revert issues early.
- Monitor the target contract's state before execution. If the contract changes frequently, include a "freshness" check in the proposal (e.g., a deadline parameter).
- Use a timelock with a buffer to allow time to cancel a proposal if the external conditions change before execution.
A failed Gnosis Safe transaction is not a dead end. Most failures are fixable by understanding the root cause and either resubmitting or creating a corrected proposal. The key is to diagnose promptly and adjust the execution parameters or call data accordingly.
Not financial advice. teslaai2023.site publishes market data and general information about digital assets. Crypto assets are volatile and you can lose everything you put in. Nothing here is a recommendation to buy, sell or hold, and we make no price predictions.
Prices are sourced from third parties and may be delayed or wrong. Verify anything you intend to act on against a primary source.