Smart Contracts

All Chisino smart contracts are deployed on MegaETH. Contracts are verified and open source.

Mainnet Launch

Contract addresses will be published here upon mainnet launch. All contracts will be verified on MegaETH's block explorer for full transparency.

Contract Overview

All deployed contracts with their roles and addresses.

pUSDComing Soon

ERC-20 receipt token, 1:1 backed by stablecoins

RoleUsed for gameplay; holding in wallet earns 70% of fee distributions

HOUSEComing Soon

ERC-20 governance token

RoleStake HOUSE to receive sHOUSE and earn 30% of protocol fees

sHOUSEComing Soon

ERC-20 staking receipt token

RoleReceived when staking HOUSE; earns 30% of Fee Pool distributions pro-rata

ScratchGameComing Soon

Main game contract with VRF integration

RoleHandles card purchases, VRF requests, and prize payouts

PrizePoolComing Soon

Prize fund custodian

RoleHolds pUSD for instant prize payouts

TicketClaimVaultComing Soon

Lost ticket recovery system (TCV)

RoleHolds ticket deposits and distributes yield for recovery

TicketNFTComing Soon

ERC-721 ticket NFTs

RoleMints and manages tradable ticket NFTs

FeeDistributorComing Soon

Wallet holder rewards

RoleDistributes 70% of fees to pUSD wallet holders

FeePoolComing Soon

Fee accumulator

RoleCollects fees before distribution

HouseStakingRewardsComing Soon

Staking rewards contract

RoleDistributes 30% of fees to sHOUSE stakers

ReceiptVaultComing Soon

Stablecoin deposit vault

RoleCustodian of stablecoins backing pUSD

ScratchControllerComing Soon

Yield orchestrator

RoleHarvests and routes yield between pools

GameSessionFactoryComing Soon

Session key factory

RoleCreates session contracts for gasless gameplay

Contract Architecture

How the protocol contracts interact with each other.

Core Protocol

ScratchGame ↔ PrizePool ↔ TicketClaimVault ↔ TicketNFT

Token Layer

pUSD ↔ HOUSE ↔ sHOUSE ↔ ReceiptVault

Rewards

FeePool → FeeDistributor (70% pUSD holders) + HouseStakingRewards (30% sHOUSE stakers)

Orchestration

ScratchController: Yield harvesting and routing between Prize Pool and TCV

Sessions

GameSessionFactory: Creates session key contracts for gasless gameplay

Access Control

Role-based permissions that govern who can do what.

All contracts use OpenZeppelin AccessControl (v5.4.0) for role-based permissions:

Role Permissions

Role	Purpose
GOVERNOR_ROLE	Configuration and parameter updates
CONTROLLER_ROLE	Yield harvesting and distribution
GAME_ROLE	Protocol interactions (reward payouts, ticket minting)
VAULT_ROLE	Token minting and burning

Governance will progressively transfer control to $HOUSE token holders as the protocol matures.