Overview
Welcome to the StockPackz documentation — a premium pack-opening experience for real tokenized equities on Robinhood Chain.
Every StockPack holds real tokenized stocks. Users connect an EVM wallet, choose a curated pack, and receive a real ERC-20 stock token settled on-chain via Uniswap v4.
| Document | Description |
|---|---|
| Overview | Product vision, page structure, and design principles |
| Tokenized Stocks | Real Robinhood Chain ERC-20 tokens, contracts, logos, pricing |
| Packs | Pack types, rarity system, odds, and the pack explorer |
| Architecture | Frontend structure, components, and data flow |
| Opening Flow | The pack opening sequence, phase by phase |
| Collections | Portfolio collections and badges |
| Backend Integration | Connecting to Robinhood Chain, Chainlink, and your API |
| How to Play | Connect wallet and open packs |
Key Facts
- Product: StockPackz
- Chain: Robinhood Chain (chain ID
4663) - Tokens: ERC-20 stock tokens with Chainlink price feeds
- Settlement: Uniswap v4 swap into the user's own wallet
- Contract:
0xe2244f8bb2a6a9f24f224d93c0fae1cf01ce4b5b
Tokenized Stocks
StockPackz pulls from real tokenized equities on Robinhood Chain. Logos are served from local assets in this offline clone.
- NVDA, AMD, INTC, MU — semiconductors & AI
- AAPL, MSFT, AMZN, META, TSLA, GOOGL — mega-cap tech
- COIN, SPCX — crypto & space
- SPY, QQQ — broad market ETFs
Prices are designed to be read from Uniswap v4 pools. Stocks without sufficient pool liquidity show as “no pool” until depth is available.
Packs
Five curated portfolios:
- AI Pack — $9.99 · NVDA, AMD, MU
- Magnificent Seven — $14.99 · AAPL, MSFT, AMZN, META, TSLA, GOOGL, NVDA
- Dividend Kings — $7.99 · JNJ, PG, KO, PEP
- Healthcare — $8.99 · JNJ, PG, PEP
- Future Tech — $11.99 · NVDA, AMD, SPCX, MU
Rarity is weighted: Legendary (SpaceX, NVIDIA), Epic (AMD, Tesla), Rare (Apple, Alphabet), Common (Micron, Amazon).
Opening Flow
- USDG payment enters the pack contract
- Verifiable randomness selects the stock fair on-chain
- Uniswap v4 swap converts USDG into the tokenized equity
- Settlement delivers the ERC-20 stock to the user’s wallet
No inventory. No IOUs. Self-custody always.
Architecture
This offline clone is a static frontend repository:
stockpackz-clone/ index.html # Landing page docs.html # Documentation token.html # $PACKZ utility page css/styles.css # Full UI styles js/config.js # Contract, socials, pack/stock data js/wallet.js # EIP-1193 wallet connection js/app.js # Homepage rendering assets/graphics/ # Local brand & capsule art assets/stocks/ # Local stock logos assets/fonts/ # Geist fonts
All image assets load from the local assets/ folder so the site works offline.
Collections
Complete themed portfolios to earn bonus stock value and free packs. Progress is wallet-bound once the backend is wired. This frontend shows collection structure and 0% progress until connected on-chain data is available.
Backend Integration
Production integration points:
- Robinhood Chain RPC for reads/writes
- Pack contract at
0xe2244f8bb2a6a9f24f224d93c0fae1cf01ce4b5b - Chainlink feeds for equity pricing references
- Uniswap v4 pools for settlement liquidity
This clone focuses on frontend + wallet connection. Opening transactions are not broadcast until a live contract is deployed to the TBA address.
How to Play
- Install MetaMask (or any EIP-1193 wallet)
- Click Connect Wallet — Robinhood Chain is requested automatically
- Browse packs on the home page
- Open a live pack when the contract is active