@synapseia-network/node 0.8.10 → 0.8.13

package/README.md

@@ -1,5 +1,3 @@
-<!-- TODO: Replace https://dashboard.synapseia.network, https://coord.synapseia.network, and Discord/Twitter links before public launch -->
-
 # @synapseia-network/node
 
 The Synapseia Network compute node — contribute CPU/GPU cycles to autonomous AI agents and earn SYN tokens on Solana.
@@ -35,10 +33,10 @@ synapseia start            # creates a wallet, prints the address, then waits
 # In another terminal — fund the wallet on devnet:
 solana airdrop 1 <YOUR_ADDRESS> --url devnet
 # Re-run:
-synapseia start --coordinator https://coord.synapseia.network
+synapseia start
 ```
 
-For the full walkthrough, keep reading.
+The node talks to the official Synapseia coordinator automatically — no URL flags needed. For the full walkthrough, keep reading.
 
 ---
 
@@ -108,22 +106,14 @@ SYN is the network's reward token. You can run a node without staking, but staki
 
 ### Step 5 — Start your node
 
-Point the node at the public coordinator:
-
-```bash
-synapseia start --coordinator https://coord.synapseia.network
-```
-
-Or set it once via environment variable:
-
 ```bash
-export COORDINATOR_URL=https://coord.synapseia.network
 synapseia start
 ```
 
 The node will:
 
-- Register with the coordinator on the first heartbeat.
+- Connect to the official Synapseia coordinator.
+- Register on the first heartbeat.
 - Heartbeat every ~30 seconds.
 - Wait for incoming work orders (training, inference, research).
 
@@ -144,7 +134,7 @@ Open `https://dashboard.synapseia.network/nodes` and search for your wallet addr
 
 Prefer a desktop app over the CLI? `node-ui` is a cross-platform Tauri app that wraps the same runtime, uses the same wallet (`~/.synapseia/wallet.json`), and points at the same coordinator.
 
-Download from [https://github.com/synapseia-network/node/releases](https://github.com/synapseia-network/node/releases):
+Download from [https://github.com/erscoder/synapseia-node-ui/releases](https://github.com/erscoder/synapseia-node-ui/releases):
 
 - **macOS:** `synapseia-node-ui_<version>_aarch64.dmg` (Apple Silicon) or `_x64.dmg` (Intel).
 - **Windows:** `synapseia-node-ui_<version>_x64.msi`.
@@ -160,7 +150,7 @@ Run the installer, follow the prompts, and on first launch the app will create o
 |---|---|---|
 | `[BETA_LIMIT_REACHED] Beta tester limit reached.` | Coordinator beta cap is full. CLI exits with code 0. | Wait for the next slot bump or for mainnet. Re-run `synapseia start` later. |
 | `Wallet not funded` / `insufficient SOL` | Wallet has 0 SOL on devnet. | Re-do Step 3 (devnet SOL faucet). |
-| `Coordinator unreachable` / `ECONNREFUSED` | Wrong coord URL or coordinator is down. | Check the `--coordinator` flag or `COORDINATOR_URL` env var. |
+| `Coordinator unreachable` / `ECONNREFUSED` | Network problem reaching the official coordinator. | Check your internet connection. Status: [status.synapseia.network](https://status.synapseia.network). |
 | `Cannot find module 'X'` | Global npm install was incomplete. | `npm i -g --force @synapseia-network/node`. |
 | Modal **"Beta tester limit reached"** in node-ui | Same as the CLI message above. | Same fix — re-try later. |
 | Wallet password forgotten | The wallet is encrypted; there is no recovery path. | Delete `~/.synapseia/wallet.json` and re-run `synapseia start`. **You'll lose the old address — fund the new one.** |
@@ -175,19 +165,26 @@ Main loop — registers the node, heartbeats, executes work orders.
 
 | Flag | Description | Default |
 |---|---|---|
-| `--coordinator <url>` | Coordinator URL | `http://localhost:3701` |
-| `--model <name>` | Ollama model for inference workloads | — |
+| `--model <name>` | Ollama model for inference workloads | recommended for hardware |
 | `--llm-key <key>` | External LLM API key (optional) | — |
-| `--inference` | Enable inference workloads | off |
+| `--max-iterations <n>` | Maximum work order iterations | infinite |
+| `--inference` | Enable inference mode (expose GPU as AI inference provider) | off |
+| `--inference-models <models>` | Comma-separated list of models to serve (e.g. `ollama/qwen2.5:7b,ollama/llama3:8b`) | — |
 | `--lat <n> --lng <n>` | Geolocation override (else IP-based) | — |
 | `--set-name <name>` | Node display name | — |
 
 ### Other commands
 
 - `synapseia status` — current runtime status of your node.
-- `synapseia wallet` — wallet info, address, balance.
-- `synapseia config` — show / edit local config.
-- `synapseia staking` — stake / unstake SYN.
+- `synapseia balance` — wallet SOL + SYN balance.
+- `synapseia config --show` — print current config. `--set-name`, `--set-model`, `--set-llm-key` to edit.
+- `synapseia stake` / `unstake` / `stake-info` — stake / unstake SYN, view tier multiplier.
+- `synapseia claim-rewards` / `claim-wo-rewards` — claim accrued rewards.
+- `synapseia deposit-sol` / `deposit-syn` / `withdraw-sol` / `withdraw-syn` — wallet transfers.
+- `synapseia system-info` — hardware detection report.
+- `synapseia export-key` — export the wallet private key (prompts for password).
+- `synapseia wallet-create` / `wallet-verify` — wallet provisioning helpers.
+- `synapseia stop` — stop a running node.
 
 Run any command with `--help` for the full option list.
 
@@ -203,6 +200,18 @@ Run any command with `--help` for the full option list.
   ```
 - **Override home dir:** set `SYNAPSEIA_HOME=/path/to/dir`.
 
+### Advanced: point at a non-default coordinator
+
+The official coordinator is hardcoded and used automatically. Operators running their own coordinator (self-hosted clusters, dev networks) can override via environment variables:
+
+```bash
+export COORDINATOR_URL=https://my-coord.example.com
+export COORDINATOR_WS_URL=https://my-coord.example.com
+synapseia start
+```
+
+The CLI has no `--coordinator` flag any more; env-var override is the only supported mechanism.
+
 ---
 
 ## License
@@ -219,14 +228,14 @@ Full text: see the [`LICENSE`](./LICENSE) file in this directory.
 
 ## Links
 
-- **Network dashboard:** `https://dashboard.synapseia.network`
+- **Network dashboard:** [https://dashboard.synapseia.network](https://dashboard.synapseia.network)
 - **Solana devnet faucet:** [https://faucet.solana.com](https://faucet.solana.com)
 - **Solana CLI install:** [https://docs.solana.com/cli/install](https://docs.solana.com/cli/install)
 - **Ollama install:** [https://ollama.com](https://ollama.com)
-- **Issues:** [https://github.com/synapseia-network/node/issues](https://github.com/synapseia-network/node/issues)
+- **Issues:** [https://github.com/erscoder/synapseia-node/issues](https://github.com/erscoder/synapseia-node/issues)
 
 ---
 
 ## Contributing & support
 
-Found a bug? Have a feature request? File an issue on GitHub. For real-time support and beta-tester discussion, join us on Discord (`<TBD>`) or follow updates on Twitter (`<TBD>`). PRs welcome — please open an issue first to discuss non-trivial changes.
+Found a bug? Have a feature request? File an issue on GitHub. PRs welcome — please open an issue first to discuss non-trivial changes.

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@synapseia-network/node",
-  "version": "0.8.10",
+  "version": "0.8.13",
   "description": "Synapseia Network node CLI — P2P compute for autonomous AI agents on Solana.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
-  "homepage": "https://github.com/synapseia-network/node#readme",
+  "homepage": "https://github.com/erscoder/synapseia-node#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/synapseia-network/node.git"
+    "url": "git+https://github.com/erscoder/synapseia-node.git"
   },
   "bugs": {
-    "url": "https://github.com/synapseia-network/node/issues"
+    "url": "https://github.com/erscoder/synapseia-node/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -24,6 +24,7 @@
   },
   "files": [
     "dist",
+    "patches",
     "scripts",
     "LICENSE",
     "README.md"
@@ -32,6 +33,7 @@
     "dev": "tsup index.ts --watch --onSuccess \"node dist/bootstrap.js --help\"",
     "build": "tsup",
     "prepare": "npm run build",
+    "postinstall": "patch-package",
     "start": "node dist/bootstrap.js",
     "test": "jest",
     "test:mutation": "NODE_OPTIONS=--experimental-vm-modules stryker run",
@@ -70,6 +72,7 @@
     "dotenv": "^17.3.1",
     "libp2p": "^3.2.2",
     "ollama": "^0.5.0",
+    "patch-package": "^8.0.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
     "semver": "^7.7.2",

package/patches/@libp2p+utils+7.1.0.patch

@@ -0,0 +1,48 @@
+diff --git a/node_modules/@libp2p/utils/dist/src/queue/job.js b/node_modules/@libp2p/utils/dist/src/queue/job.js
+index 8aef8c4..13e49d3 100644
+--- a/node_modules/@libp2p/utils/dist/src/queue/job.js
++++ b/node_modules/@libp2p/utils/dist/src/queue/job.js
+@@ -2,6 +2,11 @@ import { AbortError } from '@libp2p/interface';
+ import { setMaxListeners } from 'main-event';
+ import { raceSignal } from 'race-signal';
+ import { JobRecipient } from "./recipient.js";
++// synapseia-network patch: WeakMap-backed re-entrance guard for the
++// per-Job onProgress lambda. See the lambda body for the full
++// rationale; the map is module-scoped so the flag never appears as
++// an enumerable property on Job instances and is GC'd with them.
++const PROPAGATING = new WeakMap();
+ /**
+  * Returns a random string
+  */
+@@ -57,9 +62,28 @@ export class Job {
+                 ...(this.options ?? {}),
+                 signal: this.controller.signal,
+                 onProgress: (evt) => {
+-                    this.recipients.forEach(recipient => {
+-                        recipient.onProgress?.(evt);
+-                    });
++                    // synapseia-network patch: any synchronous re-entry
++                    // of this lambda on the same Job no-ops. Primary
++                    // motivation is the A<->B cross-Job cycle (each
++                    // Job's run() lambda registered as the other's
++                    // recipient.onProgress -> propagation ping-pongs
++                    // until RangeError). Side effect: legitimate
++                    // synchronous nested onProgress emissions on the
++                    // same Job are also swallowed. libp2p does not
++                    // re-enter its own Job synchronously today, so
++                    // acceptable. WeakMap keeps the flag off the Job
++                    // instance (no Object.keys / JSON noise; auto GC).
++                    if (PROPAGATING.get(this) === true) {
++                        return;
++                    }
++                    PROPAGATING.set(this, true);
++                    try {
++                        this.recipients.forEach(recipient => {
++                            recipient.onProgress?.(evt);
++                        });
++                    } finally {
++                        PROPAGATING.set(this, false);
++                    }
+                 }
+             }), this.controller.signal);
+             this.recipients.forEach(recipient => {