English | Español

flare_flutter_sdk

The first native Flutter/Dart SDK for the Flare Network.

Status: Early Development - API is not stable.
M1 (Foundation & Wallet) in progress. See CHANGELOG.md for details.

Why flare_flutter_sdk

Flare's official developer tooling covers TypeScript (the official flare-tx-sdk), plus language guides for Python, Go, and Rust. Dart, the language behind Flutter, has no coverage today. flare_flutter_sdk closes that gap with a pure Dart implementation, no platform channels, for iOS, Android, macOS, Windows, Linux, and Web.

Planned Features (v1.0.0)

Network foundation: multi-network support (Flare, Songbird, Coston2, Coston) via the FlareContractRegistry directory pattern
Wallet abstraction: WalletConnect/EIP-1193 and local key wallets, with C-Chain and P-Chain address derivation
Core transactions: native and ERC-20 transfers, contract calls
FTSO: live price feed consumption via FTSOv2 (getFeedById, getFeedsById), with a feed ID helper so you never hand-encode a feed ID
FAssets: end-to-end FXRP mint and redeem flow, backed by the FDC attestation types the flow requires (AddressValidity, Payment, EVMTransaction)

Documentation & Knowledge Base

This SDK is built on top of the Flare Knowledge Base, an in-depth guide to the Flare Network covering consensus, architecture, flare data connector, development ecosystem, use cases, etc. Recommended reading before diving into the SDK internals.

Every implementation decision behind this SDK - library choices, encoding standards, verification against official specs - is documented in docs-sdk/.

Installation

# pubspec.yaml
dependencies:
  flare_flutter_sdk: ^0.0.3-dev

flutter pub get

Quick Start

import 'package:flare_flutter_sdk/flare_flutter_sdk.dart';

Future<void> main() async {
  // Resolve network configuration (works today)
  final config = NetworkConfig.forNetwork(FlareNetwork.coston2);
  print('Connected to chain ID ${config.chainId} via ${config.rpcUrl}');

  // Resolve an official contract address via the Contract Registry
  // (works today, makes a real RPC call)
  final registry = ContractRegistryClient(config);
  final wNatAddress = await registry.getContractAddress('WNat');
  print('WNat address on Coston2: $wNatAddress');
}

The example above runs today against Coston2. Wallets, transactions, FTSO, and FAssets are still in progress.

Roadmap

Milestone	Scope	Status
M1	Network foundation, Contract Registry, wallet abstraction	🔄 In Progress
M2	Core transactions (native + ERC-20, contract calls)	⏳ Planned
M3	FTSO price feed client	⏳ Planned
M4	FAssets (FXRP) mint/redeem + minimum FDC support	⏳ Planned
M5	Tests, docs, examples, v1.0.0 release on pub.flutter-io.cn	⏳ Planned

Contributing

Contributions are welcome once the core architecture from M4 lands. See CONTRIBUTING.md for development setup, branch strategy, and code standards.

License

Licensed under the Apache License 2.0.

For LATAM developers

This SDK is being developed with native support for the region in mind:

Bilingual documentation (English / Spanish) from the very first module.
Part of Nemorix Group's SDK ecosystem for financial infrastructure in LATAM (Hedera, Avalanche, XRPL, Flare).
Developed by Nemorix Group, Ohio, USA.

Support This Project

If this SDK is useful to you or your team, consider supporting its development. Every contribution helps cover infrastructure, documentation, and the time invested in building and maintaining this open source tool for the Flare Network and Flutter community. Thank you!