Onchain index baskets of tokenized stocks on Robinhood Chain, minted and redeemed against real Stock Tokens and priced live by Chainlink feeds.
Live Demo · Quick Start · Local Development · Chain Cheat Sheet · Report a Bug

• Creates index baskets of Robinhood Chain Stock Tokens through a permissionless BasketFactory, where anyone defines a composition like 0.4 TSLA + 0.3 AMZN + 0.3 NFLX per share
• Mints basket shares by depositing the underlying Stock Tokens, so every share is fully collateralized onchain at all times
• Redeems shares back into the underlying tokens at any time, with rounding that always favors the basket reserves
• Prices baskets in USD live by summing Chainlink price feeds for each component, the same feeds Robinhood Chain publishes for every Stock Token
• Demonstrates ERC-8056, the Scaled UI Amount extension Stock Tokens use to handle stock splits without rebasing balances
• Ships a full frontend in the Robinhood Chain design language: a five step interactive walkthrough with a live onchain console, plus a developer deep dive with hand drawn diagrams, replayable deploy terminals, and code tours
• Keeps docs honest automatically: every code snippet on the deep dive page is extracted from the contracts before each build with exact GitHub line links, and a sync workflow refreshes them on every contract change

git clone --recurse-submodules https://github.com/hummusonrails/robinhood-chain-dapp-example.git
cd robinhood-chain-dapp-example
pnpm install                # install workspace dependencies
anvil                       # terminal 1: local chain
pnpm run deploy:local       # terminal 2: deploy factory, mocks, and demo basket
pnpm run smoke              # verify mint, price, redeem end to end
pnpm run dev                # start the frontend on localhost:3000

anvil

pnpm run deploy:local

This deploys mock Stock Tokens (with the ERC-8056 surface), mock Chainlink feeds, the BasketFactory, and a demo "Tech Trio" basket. It also writes apps/frontend/.env.local with the deployed addresses.

Import the anvil default account to have funds and mock Stock Tokens ready to mint with:

pnpm run dev

Get testnet ETH and testnet Stock Tokens from the official faucet, then:

PRIVATE_KEY=$YOUR_TESTNET_KEY pnpm run deploy:testnet

The testnet deploy composes the demo basket from the real faucet Stock Tokens (TSLA, AMZN, NFLX) but deploys mock Chainlink feeds, because Chainlink feeds exist on Robinhood Chain mainnet only. Contracts are verified on the testnet Blockscout automatically.

A reference deployment backs the live demo:

PRIVATE_KEY=$YOUR_MAINNET_KEY scripts/deploy.sh mainnet

On mainnet the demo basket uses the real TSLA, NVDA, and AAPL Stock Tokens and their real Chainlink feeds. The mainnet fork tests exercise this exact configuration without spending anything:

pnpm run test:fork

pnpm run build:contracts

pnpm run test:contracts     # 37 unit tests against mocks
pnpm run test:fork          # 5 fork tests against live mainnet tokens and feeds

pnpm run deploy:local       # anvil with mock tokens and feeds
pnpm run deploy:testnet     # real faucet Stock Tokens, mock feeds, Blockscout verify

pnpm run dev                # dev server
pnpm run build:frontend     # production build
pnpm run lint:frontend      # eslint

robinhood-chain-dapp-example/
├── contracts/
│   ├── src/
│   │   ├── BasketFactory.sol          # permissionless basket deployment and registry
│   │   ├── BasketToken.sol            # erc-20 basket with mint, redeem, and usd pricing
│   │   ├── interfaces/
│   │   │   ├── AggregatorV3Interface.sol   # canonical chainlink feed interface
│   │   │   └── IScaledUIAmount.sol         # erc-8056 stock token extension
│   │   └── mocks/
│   │       ├── MockStockToken.sol     # erc-20 + erc-8056 test double
│   │       └── MockPriceFeed.sol      # chainlink compatible settable feed
│   ├── test/
│   │   ├── BasketToken.t.sol          # unit tests with mocks
│   │   ├── BasketFactory.t.sol        # factory tests
│   │   └── fork/
│   │       └── BasketMainnetFork.t.sol     # tests against live mainnet
│   └── script/
│       └── Deploy.s.sol               # network aware deploy script
├── apps/frontend/                     # next.js app in the robinhood chain aesthetic
│   └── src/
│       ├── abi/                       # hand typed abis
│       ├── components/                # ui components
│       ├── config/                    # chains, wagmi, contract addresses
│       └── hooks/                     # one hook per contract interaction
├── scripts/
│   ├── deploy.sh                      # deploy + verify + write frontend env
│   └── smoke.sh                       # end to end cast assertions
└── .github/workflows/ci.yml           # contracts, frontend, and shellcheck jobs

Everything below is sourced from the official docs and verified against the live RPCs.

underlying shares = raw balance * uiMultiplier() / 1e18

Issues and pull requests are welcome. Open an issue to discuss larger changes first.

MIT