QF Network Asset Manager

A modern React 19 application for managing assets on the QF Network testnet. Built with TypeScript, polkadot-api, and Shadcn UI.

Features

• Wallet Connection: Seamless integration with Polkadot-compatible wallets (Talisman, SubWallet).
• Asset Management: Create, mint, transfer, and destroy fungible assets.
• Real-time Tracking: Live updates for asset balances and transaction statuses.
• Robust Transactions: Full lifecycle tracking (Signing → Finalized) with toast notifications.
• Type Safety: End-to-end type safety with TypeScript and Polkadot API descriptors.

Tech Stack

• Framework: React 19, Vite
• Language: TypeScript
• Blockchain: polkadot-api (PAPI)
• State: TanStack Query (Server), Context API (Client)
• Styling: Tailwind CSS, shadcn/ui
• Testing: Vitest, Playwright

Quick Start

Prerequisites

• Node.js 18+ and pnpm
• Browser wallet extension (Talisman or SubWallet)

Installation

pnpm install  # Automatically generates Polkadot API descriptors via postinstall
pnpm dev      # Start development server at http://localhost:5173

Documentation

• Development Guide: Coding standards, detailed scripts, and testing guide.
• Architecture Guide: State management, transaction flows, and system design.

Network Information

• Network: QF Network Testnet
• Endpoint: wss://test.qfnetwork.xyz
• Faucet: faucet.qfnetwork.xyz
• Native Token: QF (18 decimals)

License

MIT