Coverage audit (tech refresh)

Checklist of Harbor repos / branches / open PRs vs what this tech-docs tree covers. Product docs on this branch include the merged docs/nontech-refresh updates. Re-run when new markets or oracles ship.

How to add new deployments

1. Markets → group by haToken under markets/<hatoken>/ (e.g. hausd/), add a collateral page (steth.md, fxusd.md, …) using the shared layout (incl. zap rows), update the haToken index.md, and wire the sidebar category in sidebars-tech.ts
2. Oracles → add under contracts/price-oracles/<chain>/<hatoken>/ (same haToken grouping as markets) → update haToken index.md + chain inventory → wire sidebar
3. Zaps → wire addresses on the market page + row on Zap contracts
4. Proxy keys → keep markets/generic.md in sync with harbor_v1.state.json

---

Market pages (mainnet app marketIds)

App / proxy family	Doc page	Status in docs
eth-fxusd / ETH::fxUSD	haETH / fxUSD	✅
btc-fxusd / BTC::fxUSD	haBTC / fxUSD	✅
btc-steth / BTC::stETH	haBTC / stETH	✅
fxusd-eur / EUR::fxUSD	haEUR / fxUSD	✅ (was “coming soon”)
steth-eur / EUR::stETH	haEUR / stETH	✅ added
fxusd-gold / GOLD::fxUSD	haGOLD / fxUSD	✅ (was “coming soon”)
steth-gold / GOLD::stETH	haGOLD / stETH	✅ added
fxusd-silver / SILVER::fxUSD	haSILVER / fxUSD	✅ added
steth-silver / SILVER::stETH	haSILVER / stETH	✅ added
fxusd-mcap / MCAP::fxUSD	haMCAP / fxUSD	✅ added
steth-mcap / MCAP::stETH	haMCAP / stETH	✅ added
steth-usd / USD::stETH	haUSD / stETH	✅ mainnet USD stack
paxg-usd / USD::PAXG	haUSD / PAXG	✅ shared haUSD
wbtc-usd / USD::wBTC	haUSD / wBTC	✅ shared haUSD
tbtc-usd / USD::tBTC	haUSD / tBTC	✅ shared haUSD
MegaETH steth-usd	haUSD MegaETH / stETH	✅ (not mainnet)
Generic CREATE3 registry	generic	✅ incl. USD::*

Still thin on market pages: some minterFeeReceiver rows (stETH / SILVER / MCAP / USD families missing from generic table), app flags (anchorActive / sailActive). Genesis windows + startBlock filled from harbor-app (contracts.mainnetUsd.ts for USD; placeholders noted where app still has startBlock: 0).

---

Price oracle inventories

Chain	Page	Notes
Mainnet	mainnet	Primary lookup; GOLD/SILVER preferred over XAU/XAG aliases
Arbitrum	arbitrum	✅
Base	base	✅
MegaETH	megaeth	✅

Oracle gaps to watch

Gap	Source	Docs action
Harbor Yield peg / vault oracles	harbor-price-aggregators #4 harbor-yield	ETH/ETH, Peg/ETH, stETH/ETH (+ peg→ETH wrappers) — add inventory rows when merged
Missing hs* MCAP leverage feeds in inventory	app / aggregators	Confirm deploy; add to leveraged table if live
Market page ↔ inventory drift	historical docs	Market pages should cite inventory address (fixed for ETH/BTC/EUR/GOLD in this refresh)

---

Core contracts (bao-factory / harbor)

Area	Docs	Gap
Minter, SPs, genesis, reserve, fee, rewards	Contracts	✅ baseline
BaoFactory / CREATE3	bao-factory + generic	✅
Harbor Yield (SP v3 / hyTOKENS)	harbor-yield	✅ tech page (tracks #33; vaults pre-prod)
Harbor Swap	harbor-swap	✅ tech page (tracks #3 Velora + merged hardening)
Process flows	process-flows	✅
Integrators (Phase 1)	Build on Harbor	✅ cookbooks + docs-hosted ABI/address JSON; @harbor/sdk on GitHub (npm pending); no REST/WebSocket API

---

Supporting repos

Repo	Open PR / branch (re-checked)	Docs coverage
harbor	#33 harbor-yield	Core markets ✅; Yield ✅
harbor-swap	#3 velora-swap (open); #2/#4 merged on main	Swap ✅
harbor-zap-contracts	—	✅ Zap contracts
harbor-tide	no open PRs	❌ cross-chain / token tech TBD
harbor-price-aggregators	#4 harbor-yield	Inventories ✅; Yield ETH-peg feeds pending merge → rows
harbor-app	no open PRs (yield-share branch exists)	Use markets.ts for marketId / flags
bao-factory	covered via harbor deploy docs	✅

---

Page layout (no separate Templates nav)

Kind	How to extend
Market	Match sections on haETH / fxUSD (includes zaps)
Price aggregator	Match sections on any pair page under contracts/price-oracles/<chain>/<hatoken>/ (not chain index pages)
Zap overview	contracts/zap.md
Integrators	Match tone/structure of Build on Harbor; do not duplicate market address tables