@gonkfun/cli 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# Gonk CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read public Solana data from [gonk.fun](https://gonk.fun). Requires Node.js 22 or later. No account, wallet, or API key is needed. The CLI cannot submit transactions.
+
+```sh
+npx @gonkfun/cli status
+npx @gonkfun/cli coins
+npx @gonkfun/cli coin <mint>
+npx @gonkfun/cli balance <wallet> <mint>
+npx @gonkfun/cli quotes
+```
+
+`quotes` lists supported quote tokens; it does not request an executable trade quote. Use `So11111111111111111111111111111111111111112` as the mint for a native SOL balance. Successful commands print JSON. Invalid commands exit with code 2; API and network failures exit with code 1.
+
+See the [Gonk API guide](https://gonk.fun/api-guide.md) for the data schema and limits.

package/gonk-cli.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+const base = 'https://api.gonk.fun/api/solana/v1';
+const routes = { status: '/status', quotes: '/quotes', coins: '/coins' };
+const address = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+const [command, a, b, ...rest] = process.argv.slice(2);
+if (!command || ['-h', '--help'].includes(command)) {
+  console.log('Usage: node gonk-cli.mjs status | quotes | coins | coin <mint> | balance <wallet> <mint>\nPublic Solana data only. Native SOL mint: So11111111111111111111111111111111111111112');
+} else {
+  const path = rest.length ? null : Object.hasOwn(routes, command) && !a ? routes[command]
+    : command === 'coin' && address.test(a ?? '') && !b ? '/coins/' + a
+    : command === 'balance' && address.test(a ?? '') && address.test(b ?? '') ? '/holdings/' + a + '/' + b : null;
+  if (!path) {
+    console.error('Invalid command or address. Use --help.');
+    process.exitCode = 2;
+  } else {
+    try {
+      const response = await fetch(base + path, { headers: { Accept: 'application/json' }, signal: AbortSignal.timeout(15000) });
+      const data = await response.json();
+      if (!response.ok) {
+        console.error(JSON.stringify(data, null, 2));
+        const retry = response.headers.get('Retry-After');
+        if (retry) console.error('Retry-After:', retry);
+        process.exitCode = 1;
+      } else console.log(JSON.stringify(data, null, 2));
+    } catch {
+      console.error('Could not reach the Gonk public API.');
+      process.exitCode = 1;
+    }
+  }
+}

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "@gonkfun/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Read public Solana launchpad and coin data from gonk.fun",
+  "bin": { "gonk": "./gonk-cli.mjs" },
+  "files": ["gonk-cli.mjs", "README.md"],
+  "scripts": { "prepack": "node prepare-package.mjs" },
+  "engines": { "node": ">=22" },
+  "license": "UNLICENSED",
+  "homepage": "https://gonk.fun/docs",
+  "author": "gonk.fun <contact@gonk.fun>",
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" }
+}