How HologramFi works

HologramFi is an interface. It does not issue, wrap, custody or price stock tokens. It reads public data and helps your wallet build a swap.

Where every number comes from

If a source is unreachable the interface shows a dash or an error line. It never substitutes a made-up value.

Smart contracts

External contracts the app calls

Each address was checked on-chain: code exists, and SwapRouter02.factory() and SwapRouter02.WETH9() return the factory and WETH listed above.

HoloRouter

chain/contracts/HoloRouter.sol is HologramFi's own contract. It forwards exact-input swaps to SwapRouter02, takes a protocol fee from the input amount, and sends the output straight to the trader.

• Fee is set in basis points and hard-capped at 1% in code. The default deployment uses 0.15%.
• Four entry points: token to token through one pool, multi-hop path, buy with native ETH, sell to native ETH.
• Every swap enforces a deadline and a minimum output. If the pool pays less, the whole transaction reverts.
• Two-step ownership, pausable, reentrancy guarded, fee-on-transfer safe. It holds no funds between transactions, and approvals to Uniswap are reset to zero after each swap.
• Until it is deployed, the app swaps directly on SwapRouter02 with no protocol fee. After deployment the deploy script records the address in js/deployments.js and the app routes through it automatically.

Test and deploy

cd chain
npm install
npm test            # 10 unit tests against mocks
npm run test:fork   # 6 integration tests on a live fork of Robinhood Chain:
                    # buys and sells the real TSLA token through real Uniswap pools

The guided deploy asks for the deployer's private key with hidden input and keeps it in memory only. It shows the deployer, balance, settings and estimated cost, and sends nothing until you type DEPLOY. The deployer needs a little ETH on Robinhood Chain for gas.

npm run deploy:guided    # deploys HoloRouter, writes chain/deployments/4663.json and js/deployments.js
npm run verify:mainnet   # publishes the source on Blockscout

For automated pipelines, npm run deploy:mainnet reads the same settings from chain/.env instead.

Use a multisig as OWNER. Keep the private key out of version control. The included .gitignore already excludes chain/.env.

Run the site

python tools/sync_assets.py     # refresh the token registry snapshot
python -m http.server 5188      # then open http://localhost:5188

The site is static. Any web host works. For production traffic replace the public RPC in js/config.js with a dedicated endpoint, since the public one is rate limited.

Risks and limits

• Stock tokens are issued by Robinhood. They track a security's price and carry no shareholder rights. Robinhood does not offer them to persons in the United States, Canada, the United Kingdom, Switzerland or the UAE.
• DEX prices can differ from the stock's exchange price, especially outside market hours or in thin pools. The order form shows your cost against the indexed market price before you sign.
• The app routes through single Uniswap v3 pools. Liquidity on other venues, including Uniswap v4, is not used, so a better price may exist elsewhere.
• HoloRouter has a test suite but has not had a third-party audit. Get one before routing meaningful volume through it.
• HologramFi is independent and is not affiliated with Robinhood, Uniswap Labs or Offchain Labs. Nothing here is investment advice.