xolosArmy Network Architecture

Integrating Tonalli Wallet with WalletConnect v2 in the eCash ecosystem

Introduction

The evolution of decentralized financial infrastructure has transformed blockchains from simple value-transfer protocols into complex digital ecosystems known as network states. Within this frontier, the xolosArmy Network emerges as an initiative that merges Mexican cultural identity, digital sovereignty and the high-performance infrastructure of the eCash blockchain (XEC). At the operational center of this ecosystem lies the integration between decentralized applications (dApps) and the Tonalli Wallet, formerly known as RMZWallet. This connection is implemented through WalletConnect v2, a protocol that enables encrypted communication between wallets and decentralized applications while preserving full user custody of private keys.

The eCash Infrastructure

To understand the significance of Tonalli Wallet within the xolosArmy ecosystem, one must first analyze the technological substrate on which it operates: the eCash blockchain. eCash is a Layer-1 network designed for fast digital cash transactions while preserving the security guarantees of Bitcoin's Proof-of-Work model.

Technical Attribute eCash Specification Impact on xolosArmy
Primary Consensus Nakamoto Proof-of-Work Immutable security and decentralized issuance
Secondary Consensus Avalanche pre-consensus Transaction finality in ~3 seconds
Indexer Chronik Fast blockchain queries for Tonalli Wallet
Token Layer eTokens / ALP Enables the $RMZ community token

This architecture allows the xolosArmy Network to operate not merely as a financial layer but as an emerging digital society built on sovereign infrastructure.

WalletConnect v2 Integration

WalletConnect v2 enables secure communication between decentralized applications and self-custody wallets through encrypted messaging relays. Unlike earlier browser-based integrations, WalletConnect establishes persistent sessions between applications and wallets. This allows Tonalli Wallet to interact seamlessly with dApps such as:

The communication layer uses JSON-RPC messaging routed through relay servers. Sessions are initiated through QR codes or deep links that allow users to securely connect their wallet without exposing private keys.

WalletConnect Component Function Role in Tonalli
Sign API Remote transaction signing Allows dApps to request transaction authorization
Auth API Wallet authentication Passwordless login into dApps
Relay Network Encrypted message routing Maintains persistent communication sessions
Namespaces Defines chain methods Restricts allowed wallet actions

Tonalli Wallet Architecture

Tonalli Wallet is primarily developed in TypeScript and operates as a self-custody wallet capable of interacting with the eCash network through Chronik APIs. Unlike browser-extension wallets, Tonalli is designed as an independent wallet environment that maintains its own encrypted key store.

When a dApp requests a transaction signature through WalletConnect, Tonalli performs the following validation flow:

Example WalletConnect Request

ecash_signAndBroadcastTransaction({ offerId: "12345", chain: "ecash:mainnet" })

This architecture ensures that private keys remain under user control while allowing decentralized applications to perform complex financial interactions.

Xolo Legend Integration

The Xolo Legend application represents the first large-scale implementation of Tonalli Wallet connectivity. Within this system, the WalletConnect bridge component manages the communication between the game interface and the user's wallet.

Through WalletConnect event subscriptions, Xolo Legend can update its interface dynamically when blockchain events occur.

Event Origin Action
xolos_offer_published Tonalli Wallet Updates marketplace offers
xolos_offer_consumed Tonalli Wallet Removes completed offers
session_delete WalletConnect Resets connection state

Flipstarter Integration

The integration of WalletConnect into Teyolia Flipstarter dramatically improves the donation process compared to legacy callback methods. Instead of redirecting users between browser tabs, WalletConnect allows Flipstarter to maintain a persistent session with Tonalli Wallet.

The resulting workflow becomes significantly more seamless:

  1. User connects Tonalli Wallet
  2. Flipstarter requests wallet address
  3. Backend generates pledge transaction
  4. Wallet prompts user for confirmation
  5. Transaction is signed and broadcast
  6. Flipstarter updates campaign progress instantly

The Network State Vision

The xolosArmy Network represents an implementation of the network state concept. Within this framework, digital communities organize themselves around shared infrastructure, culture and economic systems before achieving formal recognition.

The $RMZ token functions as the economic unit of this ecosystem, linking physical commerce — such as XolosArmy Naturals products — with blockchain-based digital utility.

Tonalli Wallet acts as the sovereign vault and identity layer of the network, enabling members to interact with decentralized applications while maintaining full custody of their digital assets.

Conclusion

The integration of Tonalli Wallet with WalletConnect v2 establishes the technological foundation for the xolosArmy Network. By combining the fast and scalable infrastructure of eCash with secure wallet-dApp communication, this architecture enables a new generation of decentralized applications centered around sovereignty, culture and community.

Tonalli Wallet serves not only as a financial tool but as the gateway to a new digital civilization built upon the symbolic continuity of the Xoloitzcuintle and the technological frontier of blockchain infrastructure.