avalanche_flutter_sdk

Phase 2 started: C-Chain read operations available.

What's New

• CChainClient - JSON-RPC client for Avalanche C-Chain
  • Balance, nonce, block number, transaction receipt
  • Avalanche-specific: eth_baseFee, eth_suggestPriceOptions
• GasEstimator - EIP-1559 gas estimation
  • slow/normal/fast price options
  • Transfer fee estimation

Live Example (Fuji Testnet)

final client = CChainClient(network: NetworkConfig.fuji);
final balance = await client.getBalance('0x71C7...');
final estimator = GasEstimator(client);
final options = await estimator.getPriceOptions();
print(options.normal.maxFeePerGas); // in Wei

Tests

278/278 passing · 24 new tests

Next

v0.1.2-dev: AvaxTransferTransaction (EIP-1559 signing + broadcast)

Phase 1 complete: the first native Flutter/Dart SDK for Avalanche
can now derive wallets and addresses for all three chains.

What's New

• Seed - BIP-39 seed derivation (PBKDF2-HMAC-SHA512)
• HDWallet - BIP-32/BIP-44 HD key derivation
  • C-Chain: m/44'/60'/0'/0/n
  • X/P-Chain: m/44'/9000'/0'/0/n
• EvmAddress - C-Chain EVM address (keccak256 + EIP-55)
• XPAddress - X-Chain and P-Chain Bech32 addresses

Full Wallet Cycle

final mnemonic = Mnemonic.generate(wordlist: WordlistEs.instance);
final wallet   = HDWallet.fromMnemonic(mnemonic);
final cAddr    = EvmAddress.fromPublicKey(
                   wallet.derivePublicKeyForCChain());
final xpAddr   = XPAddress.fromPublicKey(
                   wallet.derivePublicKeyForXPChain());

Tests

254/254 passing · 46 new tests this release

Next

M2: C-Chain JSON-RPC client (EIP-1559 AVAX transfers, ERC-20)

BIP-39 mnemonics EN + ES complete and verified.

• MnemonicStrength, Entropy, Wordlist, WordlistEn, WordlistEs, Mnemonic
• Spanish wordlist: NFKD encoding, accent-insensitive, HashMap lookup
• 192/192 tests passing, CI green
• Official Trezor test vectors verified

Ready to publish v0.0.3-dev to pub.dev.
Next: HD key derivation (BIP-44) + address derivation (develop)

Phase 1 in progress: secp256k1 cryptography implemented and verified.

Added

• PrivateKey: secp256k1 private key generation, import, and export
  • PrivateKey.generate() using FortunaRandom (cryptographically secure pseudo-random number generator)
  • PrivateKey.fromHex() with strict range validation against the curve order n (rejects d <= 0 and d >= n)
  • toHex(), toBytes(): 32-byte big-endian export
  • publicKey getter: derives Q = d * G per secp256k1
  • toString() returns PrivateKey[REDACTED] - key material is never exposed via logs, error messages, or debug output
• PublicKey: secp256k1 public key derivation, import, and encoding
  • PublicKey.fromEcPoint(), PublicKey.fromHex() (accepts both compressed and uncompressed SEC1 encodings)
  • toCompressed(): 33-byte SEC1 encoding - required input for X-Chain/P-Chain address derivation (sha256 + ripemd160)
  • toUncompressed() / toRawUncompressed(): 65-byte and 64-byte encodings - required input for C-Chain/EVM address derivation (keccak256)
  • Value equality (==, hashCode) based on the underlying elliptic curve point
• pointycastle: ^4.0.0 and meta: ^1.15.0 added as dependencies
• 60 new unit tests (18/18 -> 78/78 total passing)

Verified

• secp256k1 curve order n confirmed directly from pointycastle's ECDomainParameters('secp256k1') at runtime: fffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141
• Private key range validation tested at all boundaries: d=0 (rejected), d=1 (accepted), d=n-1 (accepted), d=n (rejected), d=n+1 (rejected)
• Compressed/uncompressed public key encodings verified to decode to the same elliptic curve point (round-trip equality)

Status

Phase 1 in progress: secp256k1 PrivateKey/PublicKey complete and tested.
Not ready for production use.
Next: CB58 encoding, then EVM and X/P-Chain address derivation.

Initial SDK scaffold - Phase 1 in progress.

What's Included

SDK Core

• AvalancheClient: main entry point with Mainnet and Fuji Testnet support
• NetworkConfig: official Avalanche RPC endpoints (C-Chain, P-Chain,
  X-Chain, Glacier API) sourced from docs.avax.network
• NetworkId: enum for Mainnet (1) and Fuji Testnet (5)
• AvalancheException: base exception class

Quality Infrastructure

• very_good_analysis linter: zero warnings enforced
• scripts/pre_commit.ps1: local gate (format + analyze + test)
• .github/workflows/ci.yml: GitHub Actions CI pipeline
  (format, analyze, test, coverage 85%+, pub dry-run)
• .github/pull_request_template.md: PR checklist

Documentation

• CONTRIBUTING.md: branch strategy, commit conventions, testing standards
• SECURITY.md: vulnerability reporting and key handling policy
• CHANGELOG.md: v0.0.1-dev initial entry
• example/phase1/: networkConfigExamples() with Fuji + Mainnet output

Tests

• 18/18 passing
• Coverage: 100% on all skeleton classes (above 85% CI threshold)

Checklist

• pre_commit.ps1 passes green locally
• 18/18 tests passing
• dartdoc on all public API elements
• No private key material anywhere
• CHANGELOG.md updated
• CI green on develop

Next Steps

After merging and publishing v0.0.1-dev on pub.dev:
Phase 1 (M1): secp256k1 key generation, BIP-39 mnemonics (EN + ES),
HD key derivation (BIP-44), EVM address derivation from public key

Phase 1 in progress: SDK skeleton and project architecture.

Added

• AvalancheClient: main entry point for the SDK
  • accepts NetworkConfig for Mainnet or Fuji Testnet
• NetworkConfig: official Avalanche RPC endpoint configurations
  • NetworkConfig.mainnet: Avalanche Mainnet (C-Chain, P-Chain, X-Chain, Glacier API)
  • NetworkConfig.fuji: Avalanche Fuji Testnet (C-Chain, P-Chain, X-Chain, Glacier API)
  • endpoint URLs sourced from docs.avax.network
• NetworkId: enum for Mainnet (1) and Fuji Testnet (5)
• AvalancheException: base exception class for all SDK errors
• analysis_options.yaml with very_good_analysis linter (zero warnings enforced)
• scripts/pre_commit.ps1: local quality gate (format + analyze + test)
• .github/workflows/ci.yml: GitHub Actions CI pipeline
  • format check, static analysis, test suite, coverage threshold (85%), pub publish dry-run
  • daily integration test job against Fuji Testnet (on develop push)
• .github/pull_request_template.md: PR checklist
• CONTRIBUTING.md: branch strategy, commit conventions, code and testing standards
• SECURITY.md: vulnerability reporting policy and key handling rules
• 6 initial unit tests (6/6 passing)

Status

Phase 1 in progress: SDK skeleton, project architecture, and CI infrastructure complete.
Not ready for production use.
Next: secp256k1 key generation, BIP-39 mnemonics (EN + ES), HD key derivation (BIP-44).