MAN Stonk Machine Documentation - v0.1
$STONKS · PRE-PRODUCTION SPECIFICATION

Mine tokenized stocks
with an active browser tab.

Stonk Machine is the first active-tab, balance-powered stock mining protocol on Solana. Hold STONKS, start the miner and keep the tab visible. Trading fees become tokenized stock rewards, and five-minute epochs allocate finalized stocks only among miners who were active during those epochs

Important: Stonk Machine and $STONKS are the finalized product branding. The token has not been launched and the contracts have not been deployed. This documentation describes the current canonical pre-production design, not an investment promise.
USE User Guide

Start mining in six steps

  1. Install and unlock a compatible wallet. Add Solana and keep enough native SOL for transaction gas.
  2. Hold at least 100,000 STONKS. Eligible balance is liquid wallet balance plus principal already placed in voluntary locks. Ordinary mining requires no deposit.
  3. Open the Dashboard and connect. Verify the wallet prompt shows Solana, Solana mainnet, and the intended site origin.
  4. Press Start Mining. Sign the login challenge and explicit START message. This authenticates the session; it does not transfer tokens.
  5. Keep the tab visible and online. The client sends a heartbeat every 10 seconds. Hiding, refreshing or closing the page stops the session, and it never resumes automatically.
  6. Claim when finalized stocks appears. Potential personal rewards are intentionally hidden. The claimable number appears only after epoch settlement and on-chain root publication. Claiming always withdraws the full available delta.
Ordinary mining is non-custodial: the website reads your token balance. It does not ask you to deposit the base balance. Tokens move only if you voluntarily create a lock or buy a paid boost.
CFG Canonical Parameters

Current fixed product settings

ParameterValueMeaning
NetworkSolana mainnetAll balances, purchases, rewards and claims use this chain.
Pair asset Native SOL$STONKS is manually launched against SOL.
Initial supply1,000,000,000Fixed after launch; no future minting. Supply can only fall through burns.
Reward assetTokenized stocksCanonical Stocks address is immutable for one protocol deployment.
Minimum mining balance100,000 tokensLiquid balance plus locked principal at session start.
Epoch5 minutesReward weight and purchases are settled into discrete windows.
Heartbeat bucket10 secondsActive sessions sample on-chain mining weight.
Heartbeat expiry20 secondsA missed connection quickly stops further sampling.
Fee purchase trigger$10+Trigger only: the complete committed SOL balance is used, even when above $10.
Permanent fee reserve0%Every SOL unit received by the collector remains committed to Stocks.
Claim minimum / expiryNone / noneUsers can accumulate indefinitely; user pays gas.
AdministrationSingle ADMINNo multisig; operational signer keys are separate and limited.

The current simulation baseline is 3% total trader fee and 2% project fee, but launch fees remain manual parameters. Reward accounting depends on the SOL actually received by the protocol collector, not on a hard-coded fee percentage

RUN Mining Sessions

What counts as active mining?

A wallet earns weight only after an explicit START and while its authenticated WebSocket session remains alive in a visible browser tab. Reloading, hiding the page, losing connectivity, switching wallet accounts or closing the computer stops mining. There is no background, offline or automatic mining

eligible balance = liquid wallet balance + locked principal
base weight = eligible balance × active sampled time
wallet bonus = 0
age bonus = 0

Why splitting wallets does not help

Weight is linear. One wallet holding 1,000,000 tokens has the same aggregate base weight as ten eligible wallets holding 100,000 each for the same active time. There is no free reward per wallet, no wallet-age multiplier and no base faucet

Balance changes

Purchasing more tokens is allowed and is reflected by later on-chain samples. Selling does not confiscate a wallet balance. Falling below the 100,000-token threshold prevents continued eligible sampling, and the user must restore eligibility and explicitly start a new session

FEE From Trading Fees to Stocks

The funding loop

  1. STONKS trades against native SOL on the PONS bonding curve and, after graduation, through the PONS V4 pool.
  2. Creator/project fees that actually reach the allowlisted collector are accounted as committed SOL. Fees retained elsewhere are not counted as miner backing.
  3. When committed SOL is worth at least $10, the keeper requests competing approved routes and uses the complete available committed SOL balance.
  4. The buyer verifies router and function selector allowlists, exact SOL input, deadline, max spend, minimum stocks output, oracle floor, freshness and Stocks pause state.
  5. Actual stocks received is recorded. A failed, stale or unsafe route leaves SOL committed and retries later; it cannot force a worse arbitrary route.
$10 is not an order size. If the collector contains $57 when the trigger runs, the intended purchase uses the full $57 subject to safety limits.
No reserve: the product policy commits 100% of collected project fees to Stocks. Gas and operational infrastructure therefore need separate team funding.
WGT Rewards, Epochs and Claims

How rewards become claimable

Each five-minute epoch closes with sampled mining weights and finalized stocks funding. The reward engine allocates actual stocks output proportionally, carries empty-miner funding and rounding dust forward, and builds a cumulative Merkle entitlement root

wallet reward = epoch stocks × wallet active weight ÷ total active weight
claimable delta = cumulative entitlement − amount already claimed

An independent verifier rebuilds the candidate from append-only evidence. The publisher may sign only an exact manifest digest whose epoch, root, allocation and observed vault backing agree. Personal pending estimates are not shown because they can change before finalization

Claim rules

  • No minimum amount and no expiry while the project remains operational.
  • The user pays SOL gas.
  • A claim withdraws all currently available Stocks; partial claims are not offered.
  • Unallocated dust remains in accounting and carries forward.
  • An underpayment can be raised in a later cumulative correction root. A published overpayment is never clawed back from a user.
LCK Voluntary Locks

Trade liquidity for predictable power

Locks are optional deposits into the lock vault. Locked principal remains part of the 100,000-token eligibility calculation. The multiplier is fixed when the position is created

DurationMining multiplierInitial early-exit penalty
1 day1.09x3.70%
3 days1.20x6.30%
7 days1.36x9.70%
14 days1.59x13.70%
30 days2.00x20.00%

Early withdrawal is always possible. The displayed penalty declines linearly from its maximum to zero at unlock. The penalty is burned, and the remaining principal returns to the wallet. Partial withdrawal conserves the position’s accounting and does not create extra boosted weight

current penalty rate = maximum penalty × remaining time ÷ original duration
burned amount = withdrawn principal × current penalty rate
PWR Paid Boosts

Temporary power paid in STONKS

ProductDurationActivation
1.10x1 hour / 12 epochsNext epoch
1.25x6 hours / 72 epochsNext epoch
1.50x24 hours / 288 epochsNext epoch

Boost payment is burned. Price captures 70% of the modelled incremental reward value and is bounded between 0.001% and 1.00% of eligible balance. Quotes expire after 60 seconds. No more than 20% of system base weight may be simultaneously boosted

combined multiplier = 1 + lock uplift + paid uplift
example: 2.00x lock + 1.50x paid product = 2.50x, not 3.00x
maximum combined multiplier = 2.50x

Boosts are intentionally additive, start in a future epoch and cannot overlap. This blocks last-second reward capture, multiplicative stacking and quote replay

NET Public Dashboard Metrics

What everyone can see

  • Rewards Ready: USD value of Stocks available for future allocation.
  • Total Stocks Mined: current USD value of finalized stocks allocated across all miners.
  • Active Miners: currently alive mining sessions, not registered wallets.
  • Tokens Burned: aggregate STONKS destroyed through approved mechanisms.
  • Current Epoch / countdown: the active five-minute settlement window.
  • Stocks Purchased: lifetime protocol spend and cumulative Stocks acquired.

Aggregate figures create a shared public view without disclosing each miner’s pending allocation. A connected wallet sees only finalized, currently claimable personal stocks

VFY Safety and Anti-Abuse

Fail-closed by design

  • No wallet-age check, free wallet weight or base reward per address.
  • Signed challenge/START authentication and single-use session replacement.
  • 10-second samples are backed by RPC quorum and append-only audit evidence.
  • Independent finalized-chain and weight RPC quorums reject stale or disagreeing endpoints.
  • Purchase jobs are idempotent, re-quoted and guarded against duplicate execution.
  • Reward roots require independent verification and exact vault-backing conservation.
  • Purchase, root, boost and verifier keys are separate; ADMIN is not loaded into application containers.
  • Critical readiness failures keep operational signers disabled.
Single ADMIN: the team intentionally rejected multisig for the initial design. This simplifies administration but concentrates authority. The production key must be isolated, operations documented and every privileged action independently reviewed.
IDX Protocol Architecture

Main components

ComponentResponsibility
PonsFeeCollectorClaims/receives allowlisted launchpad or trading fees and commits SOL to rewards.
SolToStocksBuyerExecutes only allowlisted SOL→Stocks routes under oracle, freshness, pause, max-spend and min-out guards.
StocksRewardVaultHolds Stocks backing and pays cumulative Merkle claims.
MinerLockVaultCustodies optional lock principal, snapshots multipliers and burns linearly decaying exit penalties.
PaidBoostBurnerVerifies bounded future-epoch boost quotes and burns payment.
Mining backendAuthenticates active tabs, samples quorum-backed weight and keeps append-only evidence.
Reward engineConserves finalized stocks across epochs and cumulative entitlements.
Independent verifierRebuilds candidate roots with a separate signer and attestation database.

The backend, verifier, market observations and operational signers are centralized at launch. User claims remain on-chain and user-paid, but new mining samples and settlements depend on those services

SYS Risks and Limitations

Read before participating

  • Token risk: $STONKS can lose most or all of its market value.
  • Stocks token risk: tokenized stock availability, redemption, restrictions, liquidity or issuer rules may change.
  • Smart-contract risk: tests and audits reduce risk but cannot prove the absence of every defect.
  • Centralization risk: sampling, settlement and operational signers depend on team-run infrastructure at launch.
  • Oracle and route risk: stale prices, paused assets or thin liquidity can delay purchases.
  • Regulatory risk: tokenized-stock rewards may be restricted by jurisdiction or wallet eligibility.
  • Browser availability: sleeping devices, hidden tabs and network loss stop mining immediately.
  • No guaranteed yield: rewards depend on actual fees, stocks purchases, active weight and protocol uptime.
This website is a product interface and technical explanation, not financial, legal or tax advice. Final jurisdictional eligibility and legal disclosures require independent counsel before launch.
FIX Troubleshooting

Common problems

SymptomWhat to check
Connect button does nothingUnlock the wallet, allow this site and confirm a compatible EVM provider is installed.
Wrong networkSwitch to Solana, Solana mainnet. Reject prompts showing another chain.
Not eligibleConfirm liquid balance plus locked principal is at least 100,000 STONKS.
Mining stoppedReturn to the visible tab, restore connectivity and press Start again. Sessions never auto-resume.
Reward remains zeroOnly finalized rewards appear. Check epoch completion, public manifest state and whether you were actively sampled.
Claim unavailableConnect the entitled wallet, confirm a finalized positive delta and keep enough SOL for gas.
Lock withdrawal shows penaltyReview the countdown and quoted burn. Wait until unlock for penalty-free withdrawal.
Boost unavailableMining must be active, pricing signer healthy, capacity available and the quote younger than 60 seconds.
Economic status says UNSAFEThis is a warning, not an automatic pause. Review liquidity, volume and fee-capture figures.
Protocol data unavailableDo not repeatedly sign. Wait for health recovery and use Retry; stale UI values are never a reason to force a transaction.
FAQ Frequently Asked Questions

FAQ

Do I deposit tokens to mine?

No. Base mining reads the wallet’s liquid balance and locked principal. Only optional locks move principal into the vault

Can I mine with the browser minimized?

No. Hidden, refreshed, closed, offline or sleeping sessions stop earning new samples

Can I see estimated personal rewards?

No. You see personal stocks only after finalization. Global rewards ready and total stocks mined remain public

What happens if I sell tokens?

There is no confiscation penalty on liquid wallet sales. If eligible balance falls below 100,000, active reward sampling stops

Are lock and paid boosts multiplicative?

No. Uplifts are additive and total power is capped at 2.50x

Why does a purchase not happen at exactly $10?

$10 is the minimum trigger. The actual transaction waits for a safe route and uses the full committed balance

Can I claim part of my Stocks?

No. The claim action withdraws the entire currently available cumulative delta

Is the project live?

No. This is a pre-production implementation. External audits, legal review, real infrastructure, launchpad verification and team authorization remain required

REF Glossary

Key terms

Eligible balanceLiquid project-token balance plus locked principal.
EpochFive-minute reward accounting window.
HeartbeatAuthenticated active-tab message used to sample mining weight.
Committed SOLCreator-fee SOL actually received and reserved for Stocks purchase.
Cumulative rootMerkle commitment to each wallet’s lifetime finalized entitlement.
Claimable deltaCumulative entitlement minus Stocks already claimed.
Lock upliftExtra mining weight from voluntarily locked principal.
Paid upliftTemporary extra weight purchased by burning STONKS.

For the source-of-truth engineering policy, teams should use config/product-policy.json and CANONICAL_PRODUCT_POLICY_v0.1.md in the handoff package