Protocol Documentation

Stock Wars Launch Notes

A practical overview for deploying, verifying, configuring, and operating Stock Wars on Robinhood Chain. This document is written for launch operators, frontend integrators, and early protocol reviewers.

1. Network Configuration

Stock Wars is designed for Robinhood Chain mainnet. The frontend should request the correct chain before allowing users to approve or stake SW tokens.

RPC: https://rpc.mainnet.chain.robinhood.com
Explorer: https://robinhoodchain.blockscout.com
Chain ID: 4663
Currency: Robinhood Chain native gas asset

2. Contract Deployment

Deploy the Stock Wars contract after the SW token address is finalized. The constructor receives the SW token address and the maximum feed staleness window.

Constructor

tokenAddress: SW token minted through Noxa launchpad.
staleAfter: 90000 seconds.

Blockscout Verification

Compiler: Solidity 0.8.24
Optimizer: Enabled
Optimizer runs: 200
viaIR: Enabled
Constructor args: tokenAddress, 90000

3. Round Model

Each round compares two tokenized equities by percentage movement. Users stake SW on the side they believe will outperform. When the round closes, verified feeds determine the winner.

Winner: the side with the higher percentage move.
Distribution: winning side shares the available pool proportionally.
Burn: 3% protocol fee routes to the burn address.
Resolver reward: 0.2% rewards the caller who resolves the round.

4. Void Conditions

A void result should be treated as a clean user-protection path. In that case, users receive their stake back rather than entering a forced settlement.

Tie between both percentage moves.
One side has no valid stake.
Required Chainlink feed is stale or unavailable.
Owner manually voids a round before resolution when necessary.

5. Feed Registry

These feed addresses are configured for Robinhood Chain mainnet and should be mirrored in the frontend configuration.

NVDA/USD: 0x379EC4f7C378F34a1B47E4F3cbeBCbAC3E8E9F15
AAPL/USD: 0x6B22A786bAa607d76728168703a39Ea9C99f2cD0
TSLA/USD: 0x4A1166a659A55625345e9515b32adECea5547C38

6. First Round Recommendation

US equity feeds should be treated with US Eastern market timing in mind. Avoid ending rounds over the weekend because stale feeds may cause a void outcome.

Pair: NVDA vs TSLA
Close: Friday, July 10, 2026, 3:55 PM ET
UTC: Friday, July 10, 2026, 19:55 UTC
Unix: 1783713300

7. Frontend Configuration

The landing page can remain static, while the app interface should reference deployed contract addresses and enforce the Robinhood Chain network before user actions.

Set chainId to 4663.
Set stockWars after contract deployment.
Set token after Noxa mint.
Use config.js as the single frontend address source.
Display feed health and round status before allowing a stake.

8. Launch Checklist

Mint SW token and confirm token address.
Deploy Stock Wars with tokenAddress, 90000.
Verify contract on Blockscout.
Configure frontend contract, token, and feed addresses.
Create first weekday round using US Eastern timing.
Test stake, resolve, claim, and void flows with small values.