# NUKE / Reactor Intelligence

Standalone, read-only NUKE analytics for Robinhood Chain **4663**. Local project; not publicly deployed and no services or transactions are changed.

## Review

```bash
python3 server.py --port 40663
```

Open **http://127.0.0.1:40663/** on the host. The server binds to loopback only. A loopback link is not a public or remote-device launch link.

The application uses local fonts and no frontend packages/CDNs. It makes one same-origin snapshot request, never connects a wallet and never submits transactions. All charts use actual acquired measurements or explicitly labeled documented allocations.

## What's included

- Pinned supply, economic staking, spot-price and treasury summary.
- NUKE holder census, search, asset filtering, numeric sorting and filtered CSV export; known protocol contracts labeled separately.
- Treasury token units, Genesis raise and an explicitly unpinned official OTC API report.
- Rebase/epoch/distributor state without fabricated APY or investment profit.
- Two bond markets and team activation, capacity, recipient and vesting parameters.
- Six concentrated-liquidity NFTs, ranges, current ownership and principal inventory estimates.
- Treasury Safe, timelock delay, checked role membership and deployment ownership.
- Historical Transfer/Swap evidence where acquired, plus snapshot/raw evidence JSON.
- Light/dark theme, desktop/mobile layouts, keyboard-operable controls, persistent theme and export buttons.

## Evidence and methodology

Genesis `0xE92fF9C905A0f92cD5f4D6Ac4F4C33E135C63D2B` is the first-party discovery root. `release()`, `safe()`, `timelock()`, `coordinator()` and factory getters identify deployment contracts. ABI fragments were recovered from the [official manual/application](https://nukes.fun/manual); the workspace evidence file is `protocol-breakdown-kit/outputs/nukes/evidence/manual-app-20260908.js`.

RPC: `https://rpc.mainnet.chain.robinhood.com`. Read calls use the immutable block in `data/snapshot.json`. Source responses and unsuccessful optional getter probes are retained under `data/raw/`. Unknown getter responses are **null**, not proof that a permission is absent.

NUKE has **9 decimals**; USDG has **6**. Raw integer values are retained. The UI uses floating-point normalization for presentation only. Ledger/supply reconciliation uses `BigInt`, not floating point.

NUKE holder balances are reconstructed from Transfer logs starting at a pre-launch block, with initial mint observed, every block interval accounted for, zero negative balances and exact raw total-supply conservation required. A wallet is an address, not a verified individual. Protocol labels mean matched deployment addresses, while unclassified addresses can still be contracts, bots or exchange accounts.

**sNUKE gross totalSupply is not economic stake.** Most is inventory held by the staking contract. The main stake metric uses `totalStaked()`. Rebase-aware holder balances require pinned current `balanceOf` calls rather than adding Transfer values across changing index epochs.

Spot price and capitalization come from the team-bond onchain getter. They are quotes in USDG units, not independently verified USD prices or executable liquidation quotes. Treasury token units are not NAV or legally redeemable backing. The documented 50% backing / 45% NNE / 5% liquidity split is explicitly presented as a design allocation, not observed current allocation.

LP amounts use standard concentrated-liquidity sqrt-price/tick/liquidity formulas with token decimals. They represent position principal only, **exclude uncollected fee growth**, and do not assert exit capacity. Pool-wide token balances can include external LPs and cannot be added to the protocol's positions without double counting.

The official OTC endpoint is offchain and not pinned to the chain block. An empty response is not proof of no private/offchain purchase agreement. No merchant spending, personal identity, actual profit or company equity ownership is inferred.

Main state and NUKE history use block57,301,864 at2026-09-08 01:35:02UTC. sNUKE balances use a separately identified later block57,309,216 at01:47:23UTC because the public RPC prunes historical state rapidly. This is explicitly disclosed in the holder view and exports. The sNUKE sum has a250raw-unit (0.000000250sNUKE) residual; it is not claimed as exact reconciliation.

## Reacquisition

The collector scripts use the workspace's **already-installed** ethers library. No package installation was performed. Execute from this directory:

```bash
bash scripts/collect-all.sh
```

The wrapper collects in a separate candidate directory, runs the accounting tests, then promotes the completed directory while preserving the previous evidence. Failure before promotion leaves the current dataset untouched. The wrapper has been syntax-checked; the individual acquisition stages produced this delivery. Acquisition is read-only and subject to public RPC throttling. This is a finite snapshot package: **no auto-refresh service, cron, watcher or recurring acquisition is enabled**.

## Validation

```bash
node scripts/test.cjs
node scripts/qa.cjs
```

The browser QA expects the local server on port40663 and uses installed Playwright. Reports and screenshots are under `reports/`. Tests independently verify decimals, economic stake, Genesis accounting, capitalization, team gating, bond capacity, LP inventory formulas, Safe thresholds and chain identity. Browser checks cover9tabs ×2themes ×2device sizes, filters, exports and absence of page overflow/errors.

## Coverage limitations

See `data/snapshot.json`'s `gaps`, `historyCoverage`, and relevant holder/market-history coverage. Contract ownership/role checks are not a full source-code audit. Unchecked mint/upgrade/permission paths, redemption enforceability, offchain NNE custody and uncollected LP fees must not be represented as verified.

## Fonts

Locally copied existing workspace Manrope and DM Mono WOFF2 assets from `giga-viz/public/assets/fonts/`; no runtime font-host dependency.
