Measure the exit before the jump.
A browser and local CLI for inspecting Pons V2 exit liquidity on Robinhood Chain.
Website · Terminal · Docs · X / Twitter
Start locally · Holder Check · Live inspection · Commands · Methodology · Architecture
A wallet multiplies your bag by the last traded price. A pool prices the entire sale. Those two numbers can be very different.
HOP OUT takes a token and position, then measures th 8000 e difference at 10%, 25%, 50%, and 100% of the bag. The frog is the meme; the exit receipt is the product.
A styled documentation view of an actual CLI result. The capture time is printed inside the image; it is a historical estimate, not a current quote. Full captured data →
| Surface | What works |
|---|---|
| Browser terminal | Amount or public wallet → four exit estimates → receipt |
| Holder Check | Optional EVM address connection → official $HOPOUT balance → current sellable amount → holder receipt |
| Local CLI | inspect, demo, doctor; no web server required |
| Offline walkthrough | Synthetic POND example, labelled DEMO, no provider requests |
| Exports | JSON for scripts, Markdown for a readable receipt |
| Curve engine | Block-pinned reserve and fee reads; separate on-chain fee rounding |
| Graduated pool | Canonical published depth with an explicit approximation label |
| Verification | Provider fixtures, input checks, CLI tests, Node 22/24 CI configuration |
HOP OUT is available at hopout.xyz with the browser terminal, documentation, offline demo and local CLI ready to use.
Official $HOPOUT contract: 0x78F13072B0F6EBC7fD0B5359c9B4E09C6160cff8 · View on Pons
Open /holders to request an account from an injected EVM wallet. The browser sends only the selected public address to HOP OUT; there is no signature, approval, network switch or transaction request.
The holder receipt reads the official token balance, shows how much is currently sellable, and calculates four independent exit sizes. If real curve reserves cannot absorb the whole wallet, the receipt caps its exit rows at the current sellable amount and labels that limit. Estimated exit P&L is shown only after the holder enters a cost basis in the displayed currency (USD when available, otherwise the market quote asset such as ETH). Cost basis is never inferred.
View example receipt remains available as a visibly labelled synthetic walkthrough. Its wallet, balance, price, depth and P&L are invented solely to demonstrate the interface.
Install Node.js 22.13+ and pnpm 11.19.0, then:
git clone https://github.com/insomnia-vip/hop-out.git
cd hop-out
pnpm install --frozen-lockfile
pnpm demodemo compiles the CLI and prints a reproducible, synthetic exit receipt. It does not fetch live data.
A static terminal-style study using the offline demo's reserves and calculation engine. The 24 rows are independent hypothetical sale sizes, not trades or a live feed. Lime shows estimated proceeds relative to spot; orange shows the difference. The selected 500,000 POND bag reproduces pnpm demo. This dense layout is documentation artwork, not an additional interactive CLI mode.
Open the web terminal with:
pnpm devVisit http://localhost:5173 for the project landing page, then open /terminal to run the exit-liquidity tool or /holders for the optional holder flow. Use OFFLINE DEMO or enter a real contract and position.
COPY is a supported example, not the HOP OUT contract:
pnpm hop inspect --token 0xac79255f6f404eba14f316e8669d76573a2d7b1e --amount 1000000The receipt near the top shows a captured run of this command. Run it again for a fresh snapshot; live prices, depth and fees can change.
To inspect a public balance instead of a manually entered amount:
pnpm hop inspect --token <TOKEN_ADDRESS> --wallet <PUBLIC_WALLET>The doctor checks public provider responses and the RPC chain ID. These are measured results from the printed capture time, not a continuous uptime monitor. Captured checks →
pnpm doctorThe same report can be read in a terminal, consumed as JSON, or shared as Markdown. The picture shows an excerpt of the real demo schema; the complete export includes all four sale sizes.
pnpm hop inspect --token <TOKEN_ADDRESS> --amount 1000000 --format json --output receipt.json
pnpm hop demo --format markdown --output demo.mdExports refuse to overwrite existing files. Full command reference →
flowchart LR
A[Token + position] --> B[Pons launch metadata]
B --> C{Launch phase}
C -->|Curve| D[Pinned RPC reserves and fees]
C -->|Pool| E[Canonical published market depth]
D --> F[10 / 25 / 50 / 100 percent exits]
E --> F
F --> G[Timestamped receipt]
G --> H[Browser / CLI / JSON / Markdown]
On the curve, Pons' sell formula uses virtual-plus-real pricing reserves. HOP OUT checks real trading reserves and subtracts separately rounded base and creator fees. Contract reads share one block number.
After graduation, the engine approximates execution using the Pons-designated pool's published depth. It does not reconstruct Uniswap v4 ticks. The receipt discloses a 1% platform-fee assumption plus reported creator and LP fees. Missing canonical depth produces an explicit error.
The haircut is the difference between spot value and estimated proceeds, including modeled fees. Formulas, sources, limitations →
bin/hop-out.mjs CLI commands and exclusive exports
lib/hopout/
quote.ts Shared live engine and provider reads
math.mjs Integer curve / published-depth math
input.ts Shared validation and error mapping
project-token.ts Official $HOPOUT contract with an optional runtime override
demo.ts Isolated synthetic example
receipt.ts Plain-text and Markdown rendering
app/ Browser terminal, Holder Check and API
assets/ Wordmark, terminal illustrations and source captures
public/ Pixel frog mascot
docs/ Methodology, commands, testing and launch kit
test/ Deterministic fixtures and CLI tests
.github/workflows/ Cross-version CI
POST /api/quote accepts { "token": "0x…", "amount": "1000000" } or wallet instead of amount. GET /api/holder reports the official $HOPOUT contract; POST /api/holder accepts only a public wallet address. Responses include the holder balance, current sellable amount, method, source URLs, observation time and available block/pool identifiers. GET /api/health checks Pons availability.
pnpm checkSee testing, contributing, changelog, and security. WebMCP registration is included for compatible browsers; the core UI and CLI do not depend on it.
The terminal images are documentation illustrations of existing outputs, not separate dashboard modes. Reproduce or refresh the images →
HOP OUT holds no keys and has no transaction path. The optional Holder Check requests only a public EVM address. Estimates exclude gas, MEV and future state changes. It is not an executable quote, tax record, or proof that a token is safe.
Built against public Pons Portal data, Pons V2 contracts, Robinhood Chain and DexScreener. Independent of these services. MIT — see LICENSE.