Operations
The runbook: deploying the Sorter, launch day, environment variables, monitoring and manual interventions.
The runbook for whoever operates HOOZ.
Site environment
| Variable | Public | Meaning |
|---|---|---|
| NEXT_PUBLIC_PRIVY_APP_ID | yes | Privy app id, wallet login only |
| NEXT_PUBLIC_X_URL, NEXT_PUBLIC_X_HANDLE | yes | the X account in the header |
| NEXT_PUBLIC_HOOZ_SORTER | yes | Sorter address; empty means Launch soon |
| NEXT_PUBLIC_WHOZ_TOKEN | yes | $WHOZ address; empty means Launch soon |
| NEXT_PUBLIC_ROBINHOOD_RPC | yes | optional RPC override |
| ONECLICK_JWT | no | NEAR Intents partner key |
| RELAYER_URL | no | courier URL for the fallback road |
From empty to live
- Fund a deployer with ETH on Robinhood Chain.
- Deploy the Sorter and
PonsMarket, verify on Blockscout. - Set
NEXT_PUBLIC_HOOZ_SORTERand redeploy. Deliveries still go straight to users until the token exists. - Launch $WHOZ on Pons, then
setTokenandlockToken. See Token. - Set
NEXT_PUBLIC_WHOZ_TOKEN, redeploy. New orders now pay envelopes. - Start the courier with
HOOZ_SORTERso it sweeps envelopes as ETH lands.
Monitoring
- The Ledger shows rail availability and Sorter totals.
- The courier's
GET /healthreturns the tick count and open orders. - Watch the courier's gas balance on both chains.
Manual interventions
| Symptom | Action |
|---|---|
| direct rail closed for hours | set RELAYER_URL so orders ride the fallback |
| envelope holds ETH, no sweep | call sweep(beneficiary, 0) from any wallet |
| Sorter paused | ETH waits in envelopes; users can still withdraw |
| wrong token set before lock | setToken again, then lockToken |