8000 GitHub - insomnia-vip/hop-out: Your bag grew. The exit didn't — a read-only exit-liquidity terminal for Pons V2 tokens on Robinhood Chain. · GitHub
[go: up one dir, main page]

Skip to content
insomnia-vipPublic

About

Your bag grew. The exit didn't — a read-only exit-liquidity terminal for Pons V2 tokens on Robinhood Chain.

Resources

Contributing

Security policy

Stars

15 stars

Watchers

0 watching

Forks

Open more actions menu

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HOP OUT pixel frog

HOP OUT — Big bag. Small door.

CI status Node 22.13 or newer Robinhood Chain 4663 No signing MIT license

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

Why HOP OUT

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.

Read the pool, not the post

HOP OUT compact console receipt: captured COPY liquidity, position, estimated proceeds and haircut

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 →

Available in the current source

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

Holder Check

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.

Start in one minute

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 demo

demo compiles the CLI and prints a reproducible, synthetic exit receipt. It does not fetch live data.

Same bag. Four different jumps.

HOP OUT dense terminal study: 24 independent synthetic sale scenarios with a selected position and four exit sizes

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 dev

Visit 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.

Live inspection

COPY is a supported example, not the HOP OUT contract:

pnpm hop inspect --token 0xac79255f6f404eba14f316e8669d76573a2d7b1e --amount 1000000

The 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>

Check the sources

HOP OUT doctor: captured Robinhood RPC, Pons API and DexScreener checks, with measured latency and safety boundaries

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 doctor

Receipts that travel

HOP OUT JSON export: a synthetic receipt excerpt with provenance, position and the 100 percent exit row

The 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.md

Exports refuse to overwrite existing files. Full command reference →

How it works

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]
Loading

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 →

Project map

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

API and development

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 check

See 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 →

Boundaries and sources

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.

About

Your bag grew. The exit didn't — a read-only exit-liquidity terminal for Pons V2 tokens on Robinhood Chain.

Resources

Contributing

Security policy

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0