Mantra Wallet
This proposal outlines an official Mantra Wallet, a non-custodial crypto wallet tailored for the Mantra ecosystem. This wallet will provide a secure, user-friendly way for users to store and manage digital assets, participate in governance, and access Mantra’s DeFi and RWA products seamlessly. It is designed to integrate natively with Mantra Chain’s unique features (compliance modules, multi-VM support, cross-chain interoperability) while introducing innovative capabilities not available in popular wallets today. By adopting the Mantra Wallet, community members will enjoy a one-stop solution to interact with Mantra Chain and its dApps without relying on third-party wallets or fragmented tools.
Goals: Enhance the user experience and security for all Mantra users by offering an official wallet that: (1) supports Mantra Chain’s full feature set (EVM & CosmWasm smart contracts, on-chain governance, staking, etc.), (2) integrates identity and compliance features for frictionless access to regulated assets, and (3) provides cross-chain functionality (bridging and IBC transfers) for a truly interoperable experience.
Background
At present, Mantra community members use external wallets to interact with Mantra Chain and its ecosystem. For example, users might connect general-purpose wallets to manage OM tokens, stake assets, or vote on proposals. While this approach works, it poses several challenges:
- Fragmented Experience: Mantra’s ecosystem spans multiple technologies (an EVM-compatible chain and a CosmWasm environment, plus bridges to other networks). Users often juggle different wallet apps (or browser extensions) to cover all functionalities – e.g., one wallet for EVM transactions and another for Cosmos/IBC interactions. This complexity can deter newcomers and hinder broad adoption.
- Limited Integration: Third-party wallets are not tailored to Mantra’s unique modules (such as the on-chain Compliance/DID system or the Guard access control module). Users must manually navigate compliance steps (e.g. off-chain KYC portals) and use separate interfaces to invest in RWA tokens or verify their identities. Popular wallets do not natively assist with these processes, potentially leading to confusion or failed transactions when interacting with permissioned assets.
- Missed Opportunities: Without an official wallet, Mantra cannot fully optimize the user journey or introduce custom features. We rely on external wallet providers’ feature sets, which may lag behind the needs of our ecosystem (for instance, emerging standards like account abstraction or multi-network governance support). An official wallet controlled by the Mantra community can be updated in tandem with our platform’s evolution.
Many successful blockchain ecosystems eventually introduce native wallets to streamline user engagement. Given Mantra’s growth (expanding RWA offerings, upcoming dApps, governance initiatives) and focus on compliance-ready infrastructure, a dedicated wallet is a logical next step. It will ensure that both everyday users and institutional participants have a trusted, first-party application to securely access all of Mantra’s features. Moreover, by designing it in-house, we can directly address pain points specific to Mantra (e.g. one-time KYC integration, combined EVM/Cosmos support) that generic wallets currently do not solve.
Motivation
The primary motivation behind Mantra Wallet is to significantly improve user experience, security, and accessibility in the Mantra ecosystem. Below are key reasons and objectives motivating this proposal:
- Unified Access to Ecosystem: Mantra Wallet will serve as a single gateway to all of Mantra’s services – from basic asset management to advanced DeFi features. Users will no longer need to switch between different wallet apps or websites to stake OM, vote on proposals, invest in tokenized assets, or use upcoming Mantra dApps. A unified wallet increases convenience and encourages deeper engagement in our ecosystem.
- Leverage Unique Chain Features: Mantra Chain offers capabilities not found on other chains, such as the on-chain Decentralized Identity (DID) and Compliance module (for one-time KYC) and a Guard module for permissioned access control. Popular wallets today do not integrate these features, forcing clunky workarounds for users. By building Mantra Wallet with native support for these modules, we introduce a new functionality not present in current mainstream wallets: seamless identity verification and compliance gating. For example, once a user completes KYC via the wallet, their DID credential is stored on-chain and the wallet can automatically unlock access to regulated products (like RWA investments) without further user hassle – a level of built-in compliance convenience unmatched by existing wallets.
- Enhanced Governance Participation: Active community governance is central to Mantra. However, participating in on-chain votes or Snapshot proposals currently requires external tools and knowledge of where to find proposals. The Mantra Wallet will embed governance features (proposal browsing, voting interfaces, notification of new votes) directly into the app. This lowers the barrier for token holders to exercise their voting rights and stay informed. A more informed and engaged voter base strengthens decentralization and aligns with Mantra’s community-driven vision.
- Security & Trust: An official wallet can be optimized for security in ways generic wallets cannot. We will implement Mantra-specific safeguards – for instance, recognizing native tokens and contracts to warn users of potential scams, integrating our Guard module to prevent unauthorized transactions, and supporting hardware wallet compatibility for secure key storage. Users may feel greater confidence using a wallet endorsed by the Mantra team, especially new investors coming for regulated RWA offerings who expect a polished, secure app. Establishing this trust is key for broad adoption of Mantra’s financial services.
In summary, the motivation is clear: to empower users with a superior wallet that unlocks Mantra Chain’s full potential. By addressing current shortcomings and introducing new capabilities, Mantra Wallet will make the ecosystem more accessible, compliant, and user-centric than ever.
Proposed Solution
Mantra Wallet will be a comprehensive, feature-rich crypto wallet application developed and maintained by the Mantra community (with core contributors driving initial development). It will be available on multiple platforms (initially as a mobile app for iOS/Android, with a web or browser extension version considered in future phases) to cater to a wide user base. Below is an overview of the wallet’s design and key features:
Key Features and Capabilities
- Multi-Chain & Multi-VM Compatibility:
The Mantra Wallet will natively support multiple blockchain networks and virtual machines, focusing especially on Mantra’s own environments. Users can manage assets on Mantra Chain (Layer-1) seamlessly alongside other popular chains (such as Ethereum or BNB Chain for OM tokens, and Cosmos IBC zones for asset transfers). On Mantra Chain itself, the wallet handles both EVM smart contracts and CosmWasm contracts in one interface – a unique capability. Users will be able to interact with EVM dApps and CosmWasm modules without switching wallets or accounts. This cross-environment support ensures frictionless interaction across Mantra’s interoperable ecosystem. - Integrated Compliance & DID System:
A standout feature of Mantra Wallet is built-in support for Mantra Chain’s Compliance module and Decentralized Identity (DID) framework. Users can complete a one-time KYC/identity verification process securely within the wallet app. Upon verification, the wallet will assist in minting the user’s on-chain DID credential (binding their verified status to their wallet address). Going forward, the wallet recognizes this credential and transparently facilitates access to any permissioned dApp or token on Mantra Chain. For example, if a user wants to purchase a regulated RWA token, the wallet will: check their DID, inform them of any requirements, and allow the transaction only if compliance conditions are met – providing an explanatory prompt if not. This streamlined compliance integration is something not offered by mainstream wallets, and it eliminates repetitive KYC submissions. Users maintain control of their identity data (stored as a DID token) and enjoy hassle-free access to Mantra’s regulated products in a secure, privacy-preserving manner. - Cross-Chain Asset Transfers and Bridging:
Mantra Wallet will greatly simplify moving assets into and out of Mantra Chain. It will feature a user-friendly bridge interface for swapping assets between Ethereum (and other chains) and Mantra Chain – for instance, converting ERC-20 OM into native OM on Mantra Chain (and vice versa) with clear step-by-step prompts. Additionally, for Cosmos-based interactions, the wallet will support IBC transfers natively. Users will be able to transfer tokens from Mantra Chain to other IBC-connected chains (and back) through a visual interface, rather than dealing with command-line or third-party relayers. By abstracting the complexity of cross-chain operations, the wallet encourages more users to utilize Mantra Chain and hop liquidity between ecosystems easily. This feature positions Mantra Wallet as a cross-chain hub for users, a functionality few popular wallets currently provide out-of-the-box. - DeFi and DApp Integration:
The wallet will come pre-loaded with integration to Mantra’s core dApps and protocols. Key examples:- Staking & Lending: Users can stake OM or other supported assets directly in-app to earn rewards, or participate in lending/borrowing markets, via intuitive modules rather than visiting an external site. The wallet will display staking yields, allow one-click stake/unstake, and show lending rates, thus embedding Mantra’s DeFi services natively.
- RWA Investment Portal: Mantra’s flagship RWA offerings (e.g. tokenized real estate, bonds, etc.) will have a dedicated section in the wallet. Verified users can browse available RWA investment opportunities, view details (expected yield, duration, etc.), and invest with a few taps. The wallet handles all necessary smart contract interactions behind the scenes. This direct integration of an investment marketplace into a wallet is novel – it provides an experience closer to a fintech app than a generic crypto wallet, making participation in complex products much more approachable.
- dApp Browser & Catalog: For broader ecosystem access, the mobile app will include a Web3 browser and a curated list of Mantra ecosystem dApps (and popular external DeFi dApps on connected networks). Users can select a dApp from a “Mantra Ecosystem” list (for instance, a DEX or NFT marketplace on Mantra Chain) and the wallet will automatically connect to it, ready for use. The built-in browser will support both EVM and CosmWasm connections, leveraging the wallet’s multi-chain keys. This eliminates the need to copy-paste URLs or use separate wallets for different dApps, enhancing ease of exploration.
- Governance & Voting:
Mantra Wallet will double as a governance portal for the Mantra DAO. A dedicated Governance section will let users: review active proposals (Mantra Improvement Proposals, on-chain referenda, Snapshot polls, etc.), see proposal details and discussion summaries, and cast votes directly from the wallet using their staked/locked OM. The app can send optional push notifications for important governance events – e.g., “New proposal MIP-XX is now live for voting” or “24 hours left to vote on Proposal Y”. By integrating governance, the wallet fosters greater community participation. Token holders can remain active stewards of the ecosystem without needing to visit external forums or interfaces. This feature ensures decentralized decision-making is at users’ fingertips. - Security & User Control:
Security is paramount for a wallet. Mantra Wallet will follow best-in-class security practices: local private keys (seed phrases) are encrypted and stored only on the user’s device (in a secure enclave where available), and not shared with Mantra or any server. The wallet will be open-source, allowing community auditing and transparency. Key security features include:- Biometric and PIN protection for app access and transaction signing (so even if someone has the phone, they cannot send transactions without fingerprint/face or PIN).
- Hardware Wallet Support: Users who prefer extra security can connect hardware wallets (e.g., via Bluetooth or USB) to sign transactions through Mantra Wallet, combining convenience with cold-storage security.
- Transaction Risk Warnings: The wallet will have an integrated knowledge base of known scam addresses and malicious contract patterns on Mantra Chain, warning users if they are about to interact with a potentially dangerous contract. It will also clearly show human-readable info for transactions (like decoding contract calls to show what permissions or transfers the user is approving) to prevent accidental loss of funds.
- Social Recovery & Account Abstraction (Future): As a stretch goal, the wallet may implement smart-contract based accounts on Mantra Chain using account abstraction, allowing features like social recovery (trusted contacts or a backup method to restore access if a user loses their keys) and paying transaction fees in different tokens. This is an emerging innovation that, if deployed, would set Mantra Wallet apart by making self-custody more forgiving and user-friendly than the status quo.
- User Experience Focus:
The design of Mantra Wallet will prioritize simplicity and clarity, especially given the potentially complex features (identity, multi-chain, etc.). The interface will guide users step-by-step through tasks like setting up their wallet, doing KYC, bridging assets, etc., with tooltips and help prompts. We will incorporate multilingual support (leveraging Mantra’s global community) and accessible design for inclusivity. By providing an excellent user experience, the wallet lowers barriers for new entrants into crypto and Mantra’s ecosystem. Our aim is to make actions like “buy a tokenized treasury bond on Mantra Chain” as straightforward as using a neobanking app – a differentiator versus the often convoluted processes in DeFi currently.
Overall, these features converge to make Mantra Wallet a full-spectrum solution: it’s not just a wallet for holding coins, but a control center for all things Mantra – from finance to governance – with robust security and unique compliance capabilities embedded.
Architecture
The Mantra Wallet is designed as a cross-chain, mobile-first gateway into the Mantra ecosystem. It combines secure key management, dual-VM support (EVM + CosmWasm), and integrated compliance tooling within a unified client stack.
1. Core Structure
1.1 Wallet Core
- Purpose: Generate, derive, and manage user keys and accounts.
- Functions:
- Generate or import BIP-39 mnemonics.
- Derive both EVM (Ethereum/Mantra EVM-L1) and Cosmos (Bech32) addresses from one seed via BIP-44 paths.
- Handle transaction signing for both environments.
- Implementation:
- Built on vetted crypto libraries (e.g.,
ethers.js,@cosmjs/stargate). - Keys stored in secure OS-level enclaves (Android Keystore / iOS Secure Enclave).
- Built on vetted crypto libraries (e.g.,
Why: A single deterministic seed simplifies UX while maintaining cryptographic separation between networks.
1.2 Network Layer
- Purpose: Enable connectivity to Mantra Chain and external networks.
- Components:
- EVM RPC Module: JSON-RPC interface for read/write calls.
- Cosmos gRPC/REST Module: Query, broadcast, and IBC operations.
- Bridge Adapters: SDK integration for cross-chain transfers between Mantra, Ethereum, and other chains.
Why: A modular network layer supports both direct node connections and delegated APIs, ensuring flexibility in mainnet and testnet environments.
1.3 Compliance & Identity Module
- Purpose: Provide on-chain verification and KYC status for users.
- Workflow:
- User submits documents through in-app form or external KYC SDK.
- Upon approval, a soulbound DID NFT or attestation token is minted to the verified address.
- Wallet displays verification status and exposes it to compliant dApps.
Why: Integrates Mantra’s regulatory layer directly into the wallet, enabling permissioned DeFi or DAO participation when required.
1.4 User Interface Layer
- Design: Modular React Native / Flutter components.
- Feature Sections:
- Assets: Token balances across EVM + Cosmos.
- Transfer / Bridge: Cross-chain send and receive.
- Staking: Delegate / undelegate OM or IBC assets.
- Governance: Browse proposals, vote on-chain.
- RWA Portal: Access Mantra Finance offerings.
Why: A modular UI allows independent updates per feature and simplifies contribution from open-source developers.
1.5 Security Layer
- Controls:
- Memory-safe key storage (no plain-text exposure).
- Hardware entropy and biometric unlock.
- Transaction preview + phishing protection.
- Root/jailbreak detection.
- Processes:
- External audits focused on signing / encryption logic.
Why: As a first-party wallet, trust depends entirely on provable security.
1.6 Integration Modules
- Node Access: Option to connect to official Mantra endpoints or custom RPCs.
- Mantra dApp APIs:
- RWA offers via Mantra Finance API.
- Governance proposals via chain indexers.
- Caching & Notifications: Local caching, transaction receipts, push updates via Firebase / APNs.
Why: These integrations extend the wallet beyond pure storage into an active participation layer.
Workflow and Example
Wallet Creation: A new user installs the Mantra Wallet and generates a BIP-39 mnemonic or imports an existing one. From this seed, the app deterministically derives both an EVM address (0xabc...) and a Cosmos address (mantra1xyz...). The keys are encrypted and stored securely in the device’s enclave. The wallet connects to both RPC endpoints, synchronizes balances, and displays the unified portfolio.
Example Scenario:
Alice installs the Mantra Wallet and imports her seed phrase. She sees two linked addresses under her profile.
- She completes the KYC process and receives a Mantra DID NFT.
- She bridges 100 OM from Ethereum to Mantra using the wallet’s built-in bridge module.
- The wallet signs both sides of the operation — the EVM approval/lock and the Cosmos mint.
- Once confirmed, her Cosmos balance updates automatically.
- She delegates OM to a validator via the staking tab, and her rewards appear as pending in the dashboard.
Governance Participation: When a new proposal is available, the wallet fetches it via the governance API. Alice casts her vote directly from the app using her DID-verified address. Her vote is signed and broadcast via Cosmos gRPC, with real-time status updates until finalization.
Benefits and Impact
The Mantra Wallet strengthens both user experience and ecosystem resilience through unified access, compliance integration, and security-first design.
- Simplified User Experience:
Combines all Mantra functions-staking, governance, RWAs, and compliance-into a single, intuitive app. Users can manage everything from KYC to staking rewards with minimal friction, increasing accessibility and retention. - Higher Participation:
Integrated staking, lending, and voting directly within the wallet drive stronger engagement and governance turnout, creating a more active and loyal community. - Enhanced Security:
Built-in safety checks, transaction previews, and phishing protections reduce user error and fund loss, reinforcing trust in the Mantra ecosystem. - Ecosystem Independence:
Eliminates reliance on third-party wallets that may limit features or compatibility, ensuring continuous access to all Mantra services. - Sustainability Potential:
Future optional revenue streams (e.g., small bridge or swap fees, fiat on-ramps) could fund ongoing development and feed into the DAO treasury.
Conclusion
The proposal aims to establish an official, feature-rich wallet that becomes an integral part of the Mantra ecosystem. By offering unified access to assets, governance, DeFi, and RWA investments – all underpinned by robust security and compliance features – the Mantra Wallet will greatly enhance how users interact with our platform. It embodies Mantra’s ethos of innovation and user empowerment, delivering capabilities that set our ecosystem apart from others.
This proposal has outlined the rationale, design, and implementation plan in detail, mirroring the depth and structure of previous improvement proposals . We have demonstrated that the Mantra Wallet is not just a nice-to-have, but a strategic necessity to support Mantra’s growth into a fully integrated, user-friendly DeFi and RWA ecosystem.
We invite the community to provide feedback on this proposal. Key questions include: Are the proposed features aligned with your needs and expectations? Which features should be prioritized? How should we measure the success of the wallet after launch? Your input will help refine the plan and ensure the Mantra Wallet truly serves its users.