Ensure waitForTransactionReceipt supports Safe{Wallet}

[Sharqiewicz]

Check existing issues

• I checked there isn't already an issue for the bug I encountered.

Describe the bug

The issue: When using Safe Wallet, the initial transaction hash returned is a safeTxHash which differs from the final on-chain transaction hash. This is because Safe uses a multi-signature approach where:

1. The initial safeTxHash is generated when a transaction is proposed
2. This transaction needs to be confirmed by the required number of owners (based on the threshold)
3. Only after sufficient confirmations and execution will there be an actual on-chain transaction with a different hash

This creates challenges when tracking transaction status using standard wagmi hooks, as they look for the initial safeTxHash on-chain which doesn't exist.

wagmi doesn't account for safe's safeTxHash

---

The temporary solution I created is the wagmi-adapter-safe-wallet library.
It provides a wrapper around waitForTransactionReceipt, called waitForTransactionConfirmationReceipt, which checks whether the provided hash is an on-chain transaction hash or a Safe{Wallet} API transaction hash.

---

Is there a built-in solution for this in Wagmi or Viem, or does it fall outside the scope of these libraries?

Link to Minimal Reproducible Example

No response

Steps To Reproduce

No response

What Wagmi package(s) are you using?

@wagmi/core, wagmi

Wagmi Package(s) Version(s)

2.14.11

Viem Version

2.23.2

TypeScript Version

5.7.3

Anything else?

No response