gmgn-cli 1.2.2 → 1.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -16,7 +16,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
16
16
 
17
17
  ## Core Concepts
18
18
 
19
- - **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific, requires private key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific, API Key only). Never substitute one for another.
19
+ - **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific; the follow list is resolved from the GMGN user account bound to the API Key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific). Never substitute one for another.
20
20
 
21
21
  - **KOL (Key Opinion Leader)** — Wallets publicly identified as influencers or well-known traders on GMGN. Tagged as `renowned` in the platform's wallet label system. Their trades carry social/marketing signal, not necessarily alpha.
22
22
 
@@ -60,8 +60,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
60
60
  ## Prerequisites
61
61
 
62
62
  - `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`
63
- - `GMGN_API_KEY` configured in `~/.config/gmgn/.env`
64
- - `GMGN_PRIVATE_KEY` required only for `track follow-wallet`; not needed for `track kol` / `track smartmoney`
63
+ - `GMGN_API_KEY` configured in `~/.config/gmgn/.env` — required for all sub-commands; no private key needed
65
64
 
66
65
  ## Rate Limit Handling
67
66
 
@@ -95,10 +94,6 @@ When a request returns `429`:
95
94
  echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
96
95
  chmod 600 ~/.config/gmgn/.env
97
96
  ```
98
- If the user also needs `track follow-wallet`, append the private key:
99
- ```bash
100
- echo 'GMGN_PRIVATE_KEY="<pem_content_from_step_1>"' >> ~/.config/gmgn/.env
101
- ```
102
97
 
103
98
  ## Usage Examples
104
99
 
@@ -308,13 +303,12 @@ To research any token surfaced by smart money activity, follow [`docs/workflow-t
308
303
 
309
304
  ## Safety Constraints
310
305
 
311
- - **`track follow-wallet` requires `GMGN_PRIVATE_KEY`** — this signing key is linked to your GMGN account. It is used for authentication only (no on-chain access), but must be protected like any credential. Never expose it in logs or command output.
312
306
  - **`follow-wallet` reveals your following list** — results expose which wallets you have followed on GMGN. Do not share raw output in public channels.
313
307
  - **`track kol` / `track smartmoney` expose no personal data** — these use API Key auth only and return platform-tagged public wallet activity. Safe to share raw output.
314
308
 
315
309
  ## Notes
316
310
 
317
- - `track kol` / `track smartmoney` use normal auth (API Key only, no signature required)
318
- - `track follow-wallet` requires `GMGN_PRIVATE_KEY` for signature auth and wallets must be followed via the GMGN platform first
311
+ - All sub-commands use normal auth (API Key only, no signature required)
312
+ - `track follow-wallet` returns trades from wallets followed on the GMGN platform; the follow list is resolved automatically from the GMGN user account bound to the API Key — `--wallet` is optional
319
313
  - Use `--raw` to get single-line JSON for further processing
320
314
  - `track kol` / `track smartmoney` `--side` is a **client-side filter** — the CLI fetches all results then filters locally; it is NOT sent to the API