Xsolla ZK Gateway + Web3 Portal

Xsolla ZK Gateway + Web3 Portal

Seamless Web3 integration for traditional games using XsollaZK — empowering both players and developers with blockchain-native ownership.

Short Description

A two-part infrastructure for games on XsollaZK:

• Xsolla ZK Gateway — a scalable middleware that syncs in-game actions and blockchain state.
• Xsolla ZK Web3 Portal — a player-facing Web3 frontend to claim and manage NFTs representing in-game assets.

Detailed Description

🎯 Problem

Traditional game developers struggle to integrate blockchain without sacrificing UX or rebuilding their backend logic.

Players unfamiliar with crypto are forced into Web3 flows they didn’t ask for, breaking immersion and accessibility.

🧠 Our Solution

We built Xsolla ZK Gateway, a middleware layer that acts as a bridge between the game world and the blockchain, and Xsolla ZK Web3 Portal, a ready-to-use frontend interface for players to participate in the Web3 economy.

Together, they allow games to:

• Track ownership of in-game items on-chain
• Mint NFTs post-factum based on in-game actions
• React to NFT transfers by syncing ownership inside the game
• Let players opt into Web3 at their own pace

🏗️ Architecture

• Xsolla ZK Gateway listens to both game events (via API/Webhooks) and blockchain events (via event logs).
• It matches player UIDs to wallet addresses and manages NFT state.
• Built for extensibility, the gateway is designed to scale horizontally into a full oracle service for future cross-game and DeFi/GameFi integrations.
• Xsolla ZK Web3 Portal is built with the official Xsolla ZK UI Kit and serves as a unified interface for:
  • wallet connection and UID binding;
  • viewing & managing NFTs;
  • claiming asset ownership based on gameplay.

In the future, this portal could become the universal entry point for all games using Xsolla ZK Gateway — a player’s Web3 dashboard across titles.

Use Case Demo

We are showcasing this integration via a Minecraft mod:

1. A player builds a house and claims territory — no blockchain involved yet.
2. The server informs Xsolla ZK Gateway, which registers the ownership (UID1 → region X1).
3. The player visits the Web3 Portal, links a wallet, and mints an NFT representing that region.
4. If the NFT is later sold or transferred, the middleware tracks it and updates ownership in-game.
5. The new owner can instantly claim their new asset in Minecraft by logging in and verifying their UID.

Why It Matters

• Developers can easily plug in Web3 functionality without rewriting game logic.
• Players can choose if/when to enter Web3, preserving gameplay integrity.
• Xsolla ZK becomes the backbone for true digital ownership and economy across games.

This project directly supports Xsolla’s vision of bridging traditional gaming with blockchain, and lays the groundwork for a broader platform play — the “Pay Station” of on-chain item ownership.

Tech Stack

• Smart Contracts: custom ERC721 on Xsolla ZK Sepolia Testnet
• Backend: Node.js + Express + Viem
• Frontend: React (used Next.js template https://github.com/Xsolla-ZK/app-starter-kit) + Xsolla ZK UI Kit + Wagmi
• Game Integration: Minecraft mod via server plugin (Java)
• Storage: Prisma + PostgreSQL (UID ↔ wallet mapping)

See more in the presentation. 

Repo & Links

• Video Demo (another one, please watch, it's the 2nd part as we didn't have much time to edit): https://drive.google.com/file/d/1ecJy1JWub2R0Nk0xHD8Nw5Jx9PGA8t3E/view?usp=sharing
• 🔗 GitHub: https://github.com/GLITCHBRIX/ETH-Belgrade-2025-Xsolla-Track
• 📄 Contract xsolla sepolia: 0xef1F201957049c2Fb57bA48692b7AfAe9709A125
• 🔑 Contract signer pvk (for tests):
  0xf98f7e4a5f35859e5c65f95dd307636f935b43f107804b31c470e5fa668881ec0xA94a23E3d
  A4d494AbC6D356b5a95dcA03696898F
• Figma: https://www.figma.com/design/wGTNFpD5yBm1oslVNgExCj/Xsolla?node-id=0-1&p=f&t=Y3Or9QpkX7CEmONn-0
• 🌍 Live Portal: https://www.eth-belgrade-2025-xsolla-track.glitchbrix.com/ *may be unavailable
• 📖 Presentation: https://drive.google.com/file/d/1n8aPMiXGfhTkn6NXxR3WtvYfRmD1ULkG/view?usp=sharing

Team Members

• Alexey @Alexey Modin — Founder & Full-stack Dev: Idea, Architecture, Frontend
• Eldar @janibek6119 — Full-stack & Blockchain Dev: Backend, Contracts
• Dimitry @kassa — Full-stack Dev: Frontend, Minecraft server
• Anna @moromoon — Product Manager: Design, Administration