⛓️Account Linking & On-Chain Balance Loading
SolidX Accounts not only manages user aliases, Telegram integration, and balances, but also establishes a secure linking chain that ensures correct on-chain balances are always loaded during gameplay.
This linking chain is: 👉 Wallet → Unique SolidX Account → Unique Telegram Link
This design enforces one-to-one mapping between wallet, SolidX Account, and Telegram account.
🧩 Core Linking Rules
One SolidX Account per Wallet
Each SolidX Account is tied to exactly one cryptocurrency wallet.
This wallet is the user’s on-chain identity, holding funds and transaction history.
One Telegram Account per SolidX Account
Each SolidX Account can only link to one Telegram profile.
Prevents multiple wallets or accounts from sharing the same Telegram user.
Resulting Chain
The full chain ensures uniqueness: Wallet → SolidX Account → Telegram Account
Guarantees every Telegram user is mapped to a single wallet via their SolidX Account.
⚙️ How On-Chain Balance Loading Works
User starts in Telegram
User opens an xgame.io game via the XGame Bot mini app.
The bot checks the Telegram → SolidX Account link.
Wallet resolution
The SolidX Account resolves to the exact wallet linked to it.
No confusion even if the user owns multiple wallets.
On-chain balance retrieval
The platform queries the blockchain for the wallet’s balance.
This becomes the in-game balance, shared across all xgame.io games.
Deposits/withdrawals managed via the Account Frontend directly update this on-chain balance.
⚠️ Withdrawals require the original wallet connection. They cannot be executed inside Telegram.
Seamless gameplay
The verified balance is loaded.
User can play, chat with their alias, and interact in games.
On-chain actions (deposits/withdrawals) remain wallet-only for security.
🌟 Benefits for Users
Security & Simplicity – Prevents unauthorized access or wallet mix-ups.
Consistency – Alias is the same across affiliates, chats, and games.
Accessibility – After linking once, games launched from Telegram auto-load the correct user state.
🔄 Linking & Unlinking Behavior
On Linking (frontend → backend flow)
Backend verifies ownership of the Telegram account.
Stores the mapping: Telegram Account → SolidX Account → Wallet.
On Unlinking (via frontend)
The database entry is deleted, removing the Telegram ↔ SolidX connection.
Telegram itself may still show as “connected,” but the link no longer exists on our side.
Result: Mini apps cannot be played until re-linked.
Last updated