zash-cli

Official command-line interface for the ZASH Launchpad — milestone-gated token launches. Read-only, no API key needed.

Requires Node.js >= 18 (uses the built-in fetch).

Install (from npm)

npm i -g @zash-xyz/cli
zash projects

This puts the zash command on your PATH globally. (The package is published under the scoped name @zash-xyz/cli; the command it installs is still zash.)

Install (from the repo)

cd cli
npm install
npm run build
npm link        # puts `zash` on your PATH

Or run without linking: node dist/index.js <command>.

Commands

Every command accepts a project by ticker (ZGEN), uuid, or 0x TokenSale address (the canonical project key).

| Command | Description | |---|---| | zash projects [--status s] [--limit n] | Marketplace listing (--status: fundraising | live_trading | failed | all) | | zash project <p> | Full detail card: price, raise progress, milestones, contract addresses, links | | zash price <p> | One-line price + 24h change | | zash chart <p> [--tf 1h] [--last 40] | Braille price chart from OHLCV closes (--tf: 1s 5s 15s 30s 1m 5m 15m 30m 1h 4h 6h 24h 2D 1W all) | | zash holders <p> | Top token holders with share %, role and lock flags | | zash milestones <p> | Milestone tranches, deadlines, statuses and vote tallies | | zash activity <p> [--limit n] | Latest buys/sells and governance events |

Examples

$ zash projects
TICKER  NAME          STATUS              PRICE  RAISED
───────────────────────────────────────────────────────
ZGEN    ZASH Genesis  live_trading  $0.00007527    $500

$ zash price ZGEN
ZGEN  $0.00007309  ▼ -50.71% (24h)

$ zash chart ZGEN --tf 15m
ZASH Genesis (ZGEN)  ·  15m · 40 candles

$0.00009963 ┤ ⠀⠀⠀⠀⠀⠀⠀⣸⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
            ┤ ⠀⠀⠀⠀⠀⠀⠀⡇⢧⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
            ┤ ⠀⠀⣀⠀⢰⢦⠀⡇⠀⡇⠀⠀⣿⠀⠀⠀⠀⠀⡼⡇
            ┤ ⠀⠀⣿⠀⢸⢸⡀⡇⠀⡇⠀⠀⡿⣤⡄⣿⣀⡿⠇⠹
            ┤ ⠀⣀⣿⣀⢸⠀⡇⡇⠀⠛⣿⣿⠁⣿⠉⠙⠛⠃⠀⠀
$0.00005721 ┤ ⠉⠉⠙⠋⣿⠀⣧⠇⠀⠀⠉⠉⠀⠉⠀⠀⠀⠀⠀⠀
            └ 2026-08-23 23:00 → 2026-08-24 08:45 UTC

high $0.0001072   low $0.00005549   last $0.00007402   window +19.18%   vol $10,312

$ zash milestones ZGEN
ZASH Genesis (ZGEN) — milestones

#  NAME           STATUS          TRANCHE  DEADLINE    VOTES Y/N
────────────────────────────────────────────────────────────────
1  MVP            funds_released     $150  2026-10-22  —
2  Public launch  pending            $150  2026-12-21  —
3  Scale          pending            $125  2027-02-19  —

$ zash holders 0x9C5E09e487d0686A6C1C145aec12C6a8bb42beB1
ZASH Genesis (ZGEN) — top holders

#  ADDRESS       SHARE   TOKENS  ROLE            SINCE
─────────────────────────────────────────────────────────────────
1  0x6dee…f0fa  83.87%     650M  Team (Vesting)  Launch   locked
2  0x5f3a…7c9b  14.35%  111.27M  Community       Genesis  founder

Pointing at another API

The base URL resolves in this order:

1. --api <url> flag (works globally or per command)
2. ZASH_API_URL environment variable
3. https://launchpad.zash.xyz (default)

ZASH_API_URL=http://localhost:3001 zash projects
zash price ZGEN --api http://localhost:3001

--json — scripting and AI agents

Every command takes --json and prints the raw API payload (pretty-printed) to stdout with no colors or tables — ideal for piping into jq, scripts, or feeding to AI agents:

zash price ZGEN --json | jq .currentPrice
zash chart ZGEN --tf 1h --json | jq '.[-1].close'
zash projects --json | jq '.projects[].ticker'

Notes on units (matches the public API conventions):

• USDC amounts in raw JSON are 6-decimal integers serialized as strings (divide by 1e6).
• Vote weights are raw 18-decimal token votes (divide by 1e18).
• OHLCV time is unix seconds; other timestamps are ISO 8601.

Exit codes

0 on success, 1 on any failure (project not found, invalid flag, network/API error). Errors print to stderr; a wrong project reference suggests running zash projects.