GTAMINER Docs

Deployment Status

GTAMINER is in pre-mainnet integration. The public documentation describes the intended protocol and the current contract implementation, but it does not imply that production contracts, staking, or real-value play are live.

Stable Network

Stable is an EVM-compatible Layer 1 where USDT0 is the native gas and value-transfer asset. GTAMINER uses native USDT0 for mining stakes and prize claims.

The 30-Tile Mining Loop

A player selects one or more tiles, assigns an equal native USDT0 amount to every selected tile, and submits a single wallet transaction. Settlement uses verifiable randomness for the tile result and a separate jackpot roll.

Normal prize mathematics

Let n be the selected tile count and a the equal stake assigned to each selected tile. Total stake is S = n * a. One of 30 tiles wins with equal probability. A normal hit pays 18x the amount assigned to one tile.

P(hit) = n / 30
R(hit) = 18a
E[R] = (n / 30) * 18a = 0.60S

Selecting more tiles increases hit frequency but does not change the expected normal-prize return as a percentage of total stake.

Liability reservation

Before accepting a mine, the game reserves the worst-case normal-prize shortfall for the pending request. If available prize liquidity cannot cover all reserved liabilities, the transaction reverts before accepting the player's USDT0.

Stale round recovery

A randomness request that remains unresolved for 24 hours can be refunded. Refunded rounds receive no points or token emission and release their reserved liabilities.

VI Progressive Jackpot

The jackpot is a separate roll from the normal tile result. Every valid paid ticket contributes to the pool and receives a jackpot roll, whether or not the selected tile wins the normal prize.

chancePerTicket = min(baseChance + pressure, 1.00%)
effectiveChance = min(chancePerTicket * ticketUnits, 25.00%)

Treasury Routing

Every settled USDT0 unit has one accounting destination. Prize and jackpot funds remain separate from treasury-controlled balances.

Rewards and Wallet Claims

Settlement credits balances instead of forcing transfers during the randomness callback. This pull-payment model isolates receiver behavior and lets a wallet claim later.

Private reward-code delivery

Full codes must remain offchain and outside frontend bundles, contract storage, public feeds, and analytics logs. The claim service verifies wallet ownership and eligible protocol state before atomically assigning one available code.

GTAMINER Tokenomics

GTAMINER is designed as a fixed-supply ERC-20 token with EIP-2612 permit support. The full supply is minted once at deployment. There is no owner mint function and no transfer tax.

Mining emission seasons

Liquidity and Buybacks

The initial GTAMINER/USDT0 market is designed for Stable's canonical Uniswap V3 infrastructure. A one-time launcher initializes the pool and transfers the LP NFT directly to a disclosed recipient.

Launch constraints

• One pool initialization at the selected fee tier.
• Public initial price, tick range, minimum amounts, deadline, and LP recipient.
• Unused launch inventory is refunded and approvals are cleared.
• The LP recipient should be a timelock or policy-controlled multisig.

Buyback policy

Buybacks should execute in transparent batches. Each execution should publish the source transaction, USDT0 input, route, average price, purchased amount, and destination. A reference destination policy is 50% supply reduction and 50% protocol-owned liquidity, subject to audit, market review, and applicable law.

Staking

The proposed staking system creates non-transferable, wallet-owned lock positions. Longer terms receive higher reward weight while the principal remains held until the recorded unlock time.

stakingPower = lockedAmount * termWeight
walletReward = fundedRewards * walletPower / totalPower

Normal-prize, jackpot, reward-code, pending-round, and player-claim funds can never fund staking. Staking must not increase mining odds or alter jackpot randomness.

Contract Interfaces

These contracts exist in the current implementation but have no published production address. Interfaces and parameters remain subject to audit.

function mine(uint32 tileMask, bytes32 clientSeed)
    external
    payable
    returns (uint256 roundId);

function claimUsdt0() external;
function claimToken() external;
function requestGiftCard() external returns (uint256 claimId);
function refundStaleRound(uint256 roundId) external;

function fundPrizePool() external payable;
function fundJackpotPool() external payable;
function fundGiftCardPool() external payable;

Protocol Architecture

The game isolates user interaction, randomness, contract accounting, market infrastructure, and private reward inventory.

EVM wallet on Stable
  -> GTAMinerGame.mine(tileMask, clientSeed, native USDT0)
  -> independently verifiable randomness request
  -> GTAMinerGame.fulfillRandomness(roundId, randomWord)
  -> onchain points + claimable USDT0 + claimable GTAMINER
  -> wallet claims rewards

Randomness boundary

IRandomnessProvider isolates game accounting from one randomness vendor. A mock provider may be used for testing only. Mainnet must never use server-selected winners, blockhash-only randomness, or an owner-only settlement oracle.

Private inventory boundary

Gift-card and reward codes stay server-side. A wallet-authenticated claim service verifies eligible onchain state and assigns one code atomically without publishing the inventory.

Security and Launch Gate

Real-value play remains disabled until every public launch requirement is satisfied.

• Complete independent audits of the token, allocation vaults, game, launcher, and production randomness adapter.
• Verify deployed source code and constructor parameters on StableScan.
• Publish game, token, treasury, liquidity, randomness, and LP custody addresses.
• Move protocol ownership and treasury roles to disclosed multisigs with appropriate timelocks.
• Seed native USDT0 prize liquidity and the pre-funded GTAMINER reward reserve.
• Rehearse mining, settlement, claims, stale refunds, pause states, and randomness rotation.
• Complete legal review, age and geography controls, official rules, and responsible-play limits.
• Publish incident response, monitoring, inventory, and support procedures.

References

• Stable Mainnet Information
• Stable: USDT0 as Gas
• Stable Architecture: Key Features
• GTAMINER Protocol Whitepaper
• GTAMINER Whitepaper PDF

Production contract addresses, audit reports, verified source links, official rules, and Stable-specific public API schemas will be added as they become available.