Community realm. Read the code first. Community realm, deployed by its author. Read the code before you interact or send coins.
ActivateGnomePass purchases a Gnome Pass for the caller. GNOT payment must be attached to the call (send field of MsgCall). The caller sends GNOT along with the transaction; this function verifies the amount. The GNOT stays in the realm and can be withdrawn by admin via WithdrawFunds(). Admin-only calls skip the payment check for testing.
BanAddress bans a player address. durationSecs=0 means permanent.
BatchClaimAchievements claims multiple achievements in a single transaction. idsJson format: ["ach1","ach2",...] — already-claimed IDs are silently skipped. One tx instead of N txs — 10× cheaper for Claim All.
BlacklistStatus returns the ban status of an address as a JSON string.
ClaimAndMint records mined coins AND immediately credits them to balances. The caller pays their own gas (~0.03 GNOT). No treasury involvement. Replaces the two-step ClaimMine → mintPending flow for new players. Phase 6: treasury burn-rate fix — at 100 players using ClaimAndMint, the treasury pays ~0 GNOT/day (down from ~12 GNOT/day with the old two-step flow).
ClaimMine records mined coins into pending mints for the caller. coinsJson format: [["coinId","amount"],...]
ClaimPvpTimeout allows a lobby participant to claim a timeout win. Only the creator or challenger may call this. Phase 6: refunds the escrowed wager to all parties who contributed.
ClearPendingMints is called by the treasury server after successful GRC20 minting. Removes pending balance and credits the player's spendable balances tree.
CreatePvpLobby creates a new PvP lobby and escrows the creator's wager from balances. Phase 6: wager > 0 deducts from balances and records the escrow in pvpWagers.
CreateTask registers a new task on-chain.
GnomePassCount returns the total number of addresses with an active pass (admin-only).
GnomePassExpiry returns the unix timestamp when the pass expires (0 = no pass).
HasActivePass returns true if the address has an active (non-expired) pass.
JoinPvpLobby joins an existing PvP lobby and escrows the challenger's matching wager. Phase 6: deducts challenger's matching wager from balances and updates pvpWagers.
RevealPvpMove requires both players to have committed before either can reveal. Phase 6: when both players have revealed, determines the RPS winner and pays out 2× wager minus 2% rake to the winner. Draw = full refund to both players. pvpWagers.Remove is called after payout to prevent double-payouts.
SetMinter registers the authorized minter realm address so it can call ClearPendingMints. Called once after minter5 is deployed.
Transfer sends coinId coins from the caller to toAddr directly on-chain. Both addresses must have interacted with the game realm at least once.
UnbanAddress removes a ban.
WithdrawFunds is a no-op on Onyx testnet — chain/banker is unavailable. The realm's GNOT balance is managed directly via the deployer wallet. On mainnet: re-enable with banker.NewBanker(banker.BankerTypeRealmSend, cur).
