Frontend Issue: Improve Web3 Transaction Error Handling

[godwinameh]

Summary:

Web3 transaction errors currently show generic messages. Add user-friendly error handling for common wallet and blockchain transaction failures in the Next.js frontend.

Errors to Handle
4001 → User rejected transaction
-32603 → Internal JSON-RPC error
INSUFFICIENT_FUNDS → Not enough ETH for gas
UNPREDICTABLE_GAS_LIMIT → Transaction will fail
NETWORK_ERROR → RPC connection failed

Requirements
Create a reusable error handler utility
Show clear toast or alert messages
Prevent raw blockchain errors from appearing in the UI
Add fallback handling for unknown errors

Acceptance Criteria
Users see friendly error messages
Unknown errors show a generic fallback message
Error handling works across all transaction flows
Fully reusable and typed with TypeScript

Tech Stack
Next.js
TypeScript
Web3 / Ethers.js / Viem

[jerrybarry]

@jerrybarry has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi, I'd love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jerrybarry to this issue.

[Killerjunior]

@Killerjunior has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

I am a fullstack web3 developer with expertise on typescript and next js. I am therefore the best bet for this task.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Killerjunior to this issue.

[drips-wave]

Congratulations, @Killerjunior! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @Killerjunior: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊