poly-whales 0.0.1

package/README.md

@@ -0,0 +1,77 @@
+# Polymarket Whale Tracker TUI
+
+A terminal UI that shows large BUY trades on Polymarket in real time.
+
+![poly-whale-tracker TUI](./assets/tui.png)
+
+## What It Does
+
+- Streams Polymarket `OrderFilled` events from HyperSync
+- Shows only BUY trades above your threshold
+- Optionally filters by buyer/wallet addresses
+- Lets you open a selected trade for detailed view
+
+## Requirements
+
+- Bun
+- `ENVIO_API_TOKEN` in your environment
+
+## Install
+
+```bash
+cd TUI
+bun install
+```
+
+## Run
+
+On first run, the TUI will prompt you for your HyperSync API key. Enter it and it will be saved to `~/.hypersync/.env` for future runs.
+
+```bash
+# First run (interactive - asks for API key)
+bun index.ts
+
+# Subsequent runs (uses saved API key)
+bun index.ts
+
+# Custom threshold (still prompted for API key)
+bun index.ts -t 500
+
+# Threshold + address filter
+bun index.ts -t 500 -a "0xabc...,0xdef...,0x123..."
+```
+
+You can also pre-set the API key in environment or the config file:
+
+```bash
+# Via environment variable
+ENVIO_API_TOKEN=your_key_here bun index.ts
+
+# Via config file (manually create ~/.hypersync/.env)
+echo "ENVIO_API_TOKEN=your_key_here" > ~/.hypersync/.env
+bun index.ts
+```
+
+## CLI Flags
+
+- `-t <number>`: USD threshold for BUY trades (default: `100`)
+- `-a <addr1,addr2,...>`: Optional comma-separated addresses to filter trades
+
+## Keyboard Controls
+
+- `↑` / `↓` (or `k` / `j`): Move selection
+- `Enter`: Open selected trade details
+- `T`: Open threshold popup and apply a new USD threshold
+- `A` / `a`: Open address popup and apply a new address filter
+- `Esc` / `Backspace`: Return from details view
+- `C`: Clear current trade list
+- `Q` or `Ctrl+C`: Quit
+
+## Notes
+
+- If `-a` is not provided, all BUY trades above threshold are shown.
+- Address filter matches buyer/maker/taker fields from decoded trade events.
+
+## Publishing Package
+
+First use the command `bun run build` then `npm publish` command to convert `.ts` file to `.js`.

package/bun.lock

@@ -0,0 +1,47 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "whale-tracker-tui",
+      "dependencies": {
+        "@envio-dev/hypersync-client": "^1.1.0",
+        "blessed": "^0.1.81",
+      },
+      "devDependencies": {
+        "@types/blessed": "^0.1.25",
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@envio-dev/hypersync-client": ["@envio-dev/hypersync-client@1.1.0", "", { "optionalDependencies": { "@envio-dev/hypersync-client-darwin-arm64": "1.1.0", "@envio-dev/hypersync-client-darwin-x64": "1.1.0", "@envio-dev/hypersync-client-linux-arm64-gnu": "1.1.0", "@envio-dev/hypersync-client-linux-x64-gnu": "1.1.0", "@envio-dev/hypersync-client-linux-x64-musl": "1.1.0" } }, "sha512-tTCW/fvYPFYIcL6SLcWd5Fe6uPCcXQbLgZaYL3NSvkhvrpw5VSx3M2QbHdpIrhmzoDkZdpIYyFD+pdZhC6Y75g=="],
+
+    "@envio-dev/hypersync-client-darwin-arm64": ["@envio-dev/hypersync-client-darwin-arm64@1.1.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-WO/yxYiN9nz7pHw7xLs/4hnEHQM5OVcTwvtxZTZHox7It3n7aeBzsJfrGYYqYW1bPxDwSYwb6x9l0/fQc59xeA=="],
+
+    "@envio-dev/hypersync-client-darwin-x64": ["@envio-dev/hypersync-client-darwin-x64@1.1.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-BOD4gaZ6NAyLDDVgfIhpD25ikjEQpTXNBqbIYuTjWS1D0NiQD5mmyZCFcSMmaJJ0j4iobBQV1LMiNX8nDLahPA=="],
+
+    "@envio-dev/hypersync-client-linux-arm64-gnu": ["@envio-dev/hypersync-client-linux-arm64-gnu@1.1.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-TDRpAGbfuI4u83Swy50IkGZSMaWXZw/SNC8BiMqLBmYVt1GqFDB1VGrkecf4AhQBPlQk8iDTOxxIKNuOCsY//A=="],
+
+    "@envio-dev/hypersync-client-linux-x64-gnu": ["@envio-dev/hypersync-client-linux-x64-gnu@1.1.0", "", { "os": "linux", "cpu": "x64" }, "sha512-ooOdLfrhq8W3J76pcJDWuXIpu9cTBjZR86XkkHaheDNkYQlBZ7h5oG3IhNTLnooFkih+6+9dfcfOdG4NMmylGA=="],
+
+    "@envio-dev/hypersync-client-linux-x64-musl": ["@envio-dev/hypersync-client-linux-x64-musl@1.1.0", "", { "os": "linux", "cpu": "x64" }, "sha512-WS717WyRyTZPRMfYmscRslRIhxWNKzdQR3SLugqQs0z1W7wo58WMufhr5EpzID5/GR10zexz+Y3a4HWMAGiu+Q=="],
+
+    "@types/blessed": ["@types/blessed@0.1.27", "", { "dependencies": { "@types/node": "*" } }, "sha512-ZOQGjLvWDclAXp0rW5iuUBXeD6Gr1PkitN7tj7/G8FCoSzTsij6OhXusOzMKhwrZ9YlL2Pmu0d6xJ9zVvk+Hsg=="],
+
+    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
+
+    "@types/node": ["@types/node@25.4.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw=="],
+
+    "blessed": ["blessed@0.1.81", "", { "bin": { "blessed": "./bin/tput.js" } }, "sha512-LoF5gae+hlmfORcG1M5+5XZi4LBmvlXTzwJWzUlPryN/SJdSflZvROM2TwkT0GMpq7oqT48NRd4GS7BiVBc5OQ=="],
+
+    "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}