LunoKit: Developer-friendly Web3 account connection infrastructure
Beneficiary:I. Project Overview
LunoKit is the core product developed by Lunolab, dedicated to building an open-source, customizable, and developer-friendly Web3 account connection infrastructure for the Polkadot ecosystem. It encapsulates connection state management, account abstraction, chain switching, and session restoration, significantly lowering integration barriers.
For developers building DApps on Polkadot SDK-based chains—especially on the upcoming Polkadot Hub—it takes only 10 minutes to integrate comprehensive wallet login functionality with a polished UI experience.
II. Core Pain Points
- High Integration Barrier for Multiple Wallets
- The ecosystem includes various wallets (polkadot.js, Talisman, SubWallet, NovaWallet, etc.), each with different integration methods, scattered documentation, and lacking type hints, leading to long development cycles and high error rates.
- LunoKit Advantage: Unified TypeScript-first SDK and React Hooks enable standardized integration with mainstream wallets in under 10 minutes, greatly reducing development cost.
- Fragmented Account State Management
- Account formats differ across wallets, and logic for chain switching, session restoration, and authorization status is scattered, requiring developers to manually maintain multiple state management setups.
- LunoKit Advantage: Unified account model and state management abstraction (
useLunoAccount,useSwitchChain,useSessionRestore) allow global reuse with a single integration.
- Repetitive UI Component Development
- From connect modals and asset panels to network switchers, DApps often have to custom build UI components, making it difficult to ensure accessibility and consistency.
- LunoKit Advantage: Offers a ready-to-use, fully customizable UI component suite including connect buttons, account modals, asset panels, and network switchers.
- Complex On-Chain Data Subscription and Caching
- Polkadot's subscription interfaces (derive, RPC, storage queries) are diverse; developers need to build their own caching and retry logic, which can lead to performance bottlenecks.
- LunoKit Advantage: Built-in TanStack Query support with universal subscription hook (
useSubscription) provides efficient, secure data subscription with no extra configuration.
- Lack of Comprehensive Documentation and Examples
- Official examples are often limited to isolated use cases, with incomplete type hints, resulting in a steep learning curve.
- LunoKit Advantage: Full API documentation, multi-framework integration examples, and complete TypeScript type support help developers get started quickly.
- Polkadot Hub Compatibility
- With the launch of Polkadot Hub, more DApps will need to simultaneously handle wallet connections for both Substrate and EVM addresses—a critical yet highly repetitive task for developers.
- LunoKit Advantage: Will support EVM chains post-Polkadot Hub launch, enabling developers to focus on core logic while LunoKit handles account connectivity.
III. Technical Architecture & Design
1. @luno-kit/core Core Abstraction Layer
- Unified connector interface and type system
- Chain configuration, account management, signer abstraction
- Standardized integration with multiple wallet connectors
2. @luno-kit/react React Integration Layer
- Built with React 18+ and TypeScript
- Lightweight reactive state management via Zustand
- Integrated TanStack Query for data caching and synchronization
- Integrated Dedot for blockchain interaction, with 20+ essential hooks and smart reconnection logic
3. @luno-kit/ui UI Component Layer
- Built with React 18+ and TypeScript
- Tailwind CSS 4.x for modern styling
- Integrated with Radix UI for accessibility
- Plug-and-play wallet connection components
- Fully customizable theming system
IV. Core Functional Features
4.1 Connection Management
useConnect: Manage multi-wallet connectionsuseDisconnect: Secure disconnectionuseActiveConnector: Track current active connectoruseConnectors: List of available connectorsuseStatus: Monitor connection status
4.2 Account Management
useAccount: Info on the active accountuseAccounts: List of all connected accountsuseBalance: Balance queries
4.3 Chain Information Queries
useChain: Current chain infouseChains: List of supported chainsuseSwitchChain: Switch chainsuseRuntimeVersion: Runtime versionuseBlockNumber: Real-time block height subscriptionuseSs58Format: SS58 address format
4.4 API Management
useApi: Dedot API instance managementuseConfig: Configuration management
4.5 General Subscription System
useSubscription: Subscribe to any Dedot API, support custom data transformation and intelligent retries
4.6 Transaction Operations
useSendTransaction: Manage transaction lifecycle and receipt parsinguseSignMessage: Sign messagesuseSigner: Manage signers
4.7 State Management
- Built-in caching and retry via TanStack Query
- Smart loading state and error handling
V. Team Background
Lunolab is composed of two experienced developers with over 5 years of dedicated expertise in blockchain technology, and a long-standing focus on the Substrate and Polkadot ecosystems. Our past experience includes contributing to the development of a BTC Layer 2 public blockchain based on Substrate, incorporating modules such as EVM compatibility, cross-chain bridges, and blockchain explorers.
We also led the development of the comprehensive DeFi solution OmniBTC, which includes OmniSwap, a cross-chain trading aggregator supporting over 40 public chains and more than 20 cross-chain bridges, achieving a cumulative trading volume exceeding $2 billion. Additionally, we developed OmniLending, a cross-chain lending platform with a total value locked (TVL) surpassing $10 million.
Moreover, our team participated in the technical development of ComingChat, a Web3 social application that has surpassed 10 million registered users.
Currently, our team is primarily focused on infrastructure development within the Substrate and Polkadot ecosystems, equipped with robust multi-chain expertise and extensive experience in frontend infrastructure design.
-
Cris (github.com/Gintma): Product lead, responsible for project planning and frontend development.
-
Brian (github.com/wbh1328551759): Core developer, responsible for core technical implementation.
VI. Budget
| Module | Estimated Hours | Cost |
|---|---|---|
| Wallet integration (polkadot.js, Talisman, SubWallet, Nova, PolkaGate) | 100 hrs | $6,000 |
Core abstraction layer (@luno-kit/core) | 140 hrs | $8,400 |
React Hooks (20+ hooks like useLunoConnect) | 160 hrs | $9,600 |
| UI Component Library (v1) | 100 hrs | $6,000 |
| Theme system (light/dark mode support) | 40 hrs | $2,400 |
| State management & session persistence | 80 hrs | $4,800 |
| Network switching & chain management | 40 hrs | $2,400 |
| Documentation | 20 hrs | $1,200 |
| Demo preview & site deployment | 60 hrs | $3,600 |
| UI design drafts | 40 hrs | $2,400 |
| Project management & testing | 40 hrs | $2,400 |
| Total | 820 hrs | $49,200 |
The budget is based on two full-time developers over a 3-month development cycle.
VII. UI Preview
The following screenshots and mockups demonstrate key modules such as wallet connection entry, asset panels, and account modals, reflecting the LunoKit design system and UX principles.
UI Preview
Preview Demo: https://demo.lunolab.xyz/
This is a temporary demo and not the final delivery version.
VIII. Future Roadmap
- LunoKit will support Web2 login methods (Google, GitHub, email, etc.) to automatically generate Substrate wallets secured with MPC (Multi-Party Computation), providing users with a secure and frictionless on-chain experience.
- LunoKit will natively support both Substrate and EVM chains, aligning with Polkadot Hub's EVM compatibility. Developers can save time and focus on core business logic while LunoKit handles account connectivity.
- LunoKit will develop an interactive Playground page that provides a visual configuration interface, allowing developers to choose login methods, customize UI appearance, and configure component behaviors in real time. It will support live wallet connection previews and exportable code snippets, greatly improving integration speed and developer experience.
IX. Contact Us
Comments (2)
good
OG Tracker Rating 2/3
Clear display of deliverables✅
Clear display of a valid direct point of contact❌
Clear display of proposal’s duration✅
OGT Rating aims to help voters make better informed decisions and direct proposers towards certain common-good practices. We are providing feedback based on 3 simple yet crucial criteria which we believe should be included in every OpenGov referenda.