Menu

The Off-Chain Infrastructure

Ludopoly's core gameplay mechanics depend on a set of off-chain services that complement the on-chain smart contracts. These services handle computationally intensive or privacy-sensitive operations that cannot or should not be performed on a public blockchain.

The Treasure Oracle

The Treasure Oracle is the most security-critical off-chain component. It holds the hidden treasure location for each active game session, derived from a combination of a server-held secret and a verifiable random on-chain seed. The oracle serves as the sole authority capable of confirming that a player's claimed position matches the treasure location. When a match is confirmed, the oracle generates a signed authorisation that the player's smart contract submission requires to execute the reward.

The oracle's private signing key never exists on an application server. It lives inside a hardware security module, which accepts the data to be signed and returns the signature without exposing the key. This design ensures that even an attacker with full administrative access to the server infrastructure cannot forge a treasure claim.

The Card Location Service

Hidden cards — WorldFeatureCards placed within the game map by the protocol — are tracked by the Card Location Service, which operates independently from the Treasure Oracle. This separation limits the impact of any hypothetical service compromise: a breach of the Card Location Service reveals card positions but cannot expose the treasure location, and vice versa. Card discovery claims are verified through the same zero-knowledge proof mechanism used for movement, adapted to confirm a player's presence at a card's location.

Real-Time Communication

In-game chat and social notifications are handled through a real-time messaging infrastructure that monitors on-chain events and reflects their consequences in the communication layer. When a player is muted by a community moderation vote, the result is immediately visible to the chat service, which enforces the restriction without requiring any manual intervention. The messaging layer provides the responsiveness of a conventional application while remaining anchored to the authoritative on-chain state.