flare-dapp-pitfalls

Identify and mitigate common pitfalls in Flark dApp wallets, RPCs, testing, and deployment workflows.

1|1|Updated May 6, 2026
One-click install
npx skills add https://github.com/Thanasimos/Thanas-flare-builders-toolkit --skill flare-dapp-pitfalls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flare-dapp-pitfalls
Source: https://github.com/Thanasimos/Thanas-flare-builders-toolkit/tree/main/flare-dapp-pitfalls
Command: npx skills add https://github.com/Thanasimos/Thanas-flare-builders-toolkit --skill flare-dapp-pitfalls

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hard-won, cross-project lessons from building, deploying, and operating Flare-family (Flare / Songbird / Coston2) dApps. Use this skill whenever the user is: deploying or interacting with a Flare/Songbird/Coston2 contract, building a frontend with RainbowKit + Wagmi for Flare chains, writing Foundry fork tests against Flare-family state, claiming or rotating FTSO reward redistributors, debugging a stuck or silently-failing transaction, choosing RPC endpoints for browser vs server use, or troubleshooting MetaMask / wallet connection on Flare. Trigger on any mention of: Flare RPC, Songbird canary, Coston2 testnet, FTSO reward claim, WNAT vote-power, FlareDrops, FtsoRewardRedistributor, FlaresRewardsRedistributorForNft, Enosys redistributor, RainbowKit MetaMask hang, Ankr origin locked, Multicall3 on Flare, EIP-150 63/64 gas, eth_getLogs 30-block cap, "why is my Flare contract test failing in CI", "why did my claim transaction return zero", "Wrap SGB to WSGB", or any question about gotchas specific to Flare-family chains.

Core Features & Use Cases

  • Wallet integration and RainbowKit/Wagmi pitfalls
  • RPC endpoint guidance for browser vs server usage
  • Foundry fork-test patterns and CI gating
  • Redistributor rotation cautions and ABI compatibility
  • Frontend UX guidance for WNAT wrapping and 1:1 wrappers
  • Deployment determinism and Ledger handoff patterns
  • Frontend CI pitfalls and tests gating info

Quick Start

Review your Flare dApp workflow against this pitfall checklist and implement the recommended mitigations before deployment.

Frequently Asked Questions about flare-dapp-pitfalls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Flare dApp transaction silently fail or return zero when claiming FTSO rewards?

Flare FTSO reward claims silently fail due to redistributor ABI variations and improper gas estimation. Mitigate these silent failures by verifying ABI compatibility and applying outer gas pinning for Flare-family chains to ensure transaction execution.

How do I fix MetaMask hanging during RainbowKit wallet connection on Flare?

MetaMask hangs on Flare because of incorrect RainbowKit and Wagmi integration patterns. Fix the wallet connection by applying correct Wagmi configurations specific to Flare-family chains to prevent frontend UX freezes and restore normal dApp interaction.

What are the best RPC endpoint practices for Flare browser versus server applications?

Flare RPC endpoints require different selection strategies for browser versus server usage. Avoid issues like Ankr origin locks and the 30-block eth_getLogs cap by choosing appropriate RPC providers based on your execution environment and query volume.

How do I configure Foundry fork tests for Coston2 and Songbird state without CI failures?

Configure Foundry fork tests for Coston2 and Songbird by properly setting fork URLs and implementing CI gating. This prevents Flare contract test failures in CI pipelines by ensuring tests run against correct chain state and network configurations.

Does EIP-150 63/64 gas behavior affect gas estimation on Flare chains?

EIP-150 63/64 gas behavior impacts gas estimation on Flare-family chains, requiring outer gas pinning to avoid stuck transactions. Apply specific gas management techniques during deployment and interactions to mitigate these limitations and ensure reliable execution.

What should I check before rotating FtsoRewardRedistributor contracts on Songbird?

Before rotating FtsoRewardRedistributor contracts on Songbird, check for ABI variations and compatibility issues. Redistributor rotation cautions are critical because incompatible ABIs cause silent failures during FTSO reward claims and disrupt WNAT vote-power operations.