@synapseia-network/node 0.8.5

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Synapseia Network
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -0,0 +1,232 @@
+<!-- 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.
+
+**🟡 Status: Closed Beta — Devnet only**
+
+> ⚠️ **Beta capacity is capped.** New node registrations may be rejected with a `[BETA_LIMIT_REACHED]` message when the network is full. If that happens, your node exits cleanly — try again later, or wait for mainnet launch.
+
+---
+
+## What is Synapseia?
+
+Synapseia is a peer-to-peer compute layer for autonomous AI agents. Operators run nodes that contribute training, inference, and research workloads to a decentralized coordinator. In exchange, nodes earn SYN — an SPL token on Solana.
+
+This package is the operator-side runtime: a CLI you install globally and run as a long-lived process.
+
+---
+
+## Requirements
+
+- **Node.js ≥ 20** (`node --version` to check).
+- **~2 GB RAM** free, stable internet.
+- **Ollama** (only if you plan to run inference workloads) — install from [ollama.com](https://ollama.com).
+- **Solana wallet with devnet SOL** — the node generates one for you on first run; you fund it from a faucet.
+
+---
+
+## Quick start (TL;DR)
+
+```bash
+npm i -g @synapseia-network/node
+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
+```
+
+For the full walkthrough, keep reading.
+
+---
+
+## Step-by-step beta onboarding
+
+### Step 1 — Install
+
+```bash
+npm i -g @synapseia-network/node
+synapseia --version
+```
+
+You can use `synapseia` or its short alias `syn` interchangeably.
+
+### Step 2 — Initialize your node (creates a wallet)
+
+The first run prompts you for a node name and a wallet password. The password encrypts your wallet at rest — **there is no recovery if you forget it**.
+
+```bash
+synapseia start
+```
+
+Output looks like:
+
+```text
+Wallet created at ~/.synapseia/wallet.json
+Wallet address: 3xK...nQ8
+⚠️  Save this address — you'll need it for funding.
+```
+
+**Copy the wallet address now.** You'll paste it into two faucets in the next steps.
+
+### Step 3 — Fund with devnet SOL (gas)
+
+Your node needs a small amount of SOL on Solana **devnet** to pay for on-chain operations (registration, staking transactions). This is test SOL — it has no real value.
+
+**Option A — Solana CLI (recommended if installed):**
+
+```bash
+solana airdrop 1 <YOUR_ADDRESS> --url devnet
+```
+
+**Option B — Web faucet:**
+
+1. Open [https://faucet.solana.com](https://faucet.solana.com).
+2. Select **Devnet** from the network dropdown.
+3. Paste your wallet address.
+4. Click **Confirm Airdrop**.
+
+Verify the balance arrived:
+
+```bash
+solana balance <YOUR_ADDRESS> --url devnet
+```
+
+You should see `1 SOL` within a few seconds.
+
+### Step 4 — Request SYN tokens (optional, for staking)
+
+SYN is the network's reward token. You can run a node without staking, but staking unlocks higher reward tiers.
+
+1. Open `https://dashboard.synapseia.network/faucet`.
+2. Paste your wallet address.
+3. Click **Request 10 SYN**.
+
+**Limits:** 10 SYN per request, 1 request per 24 h per wallet.
+
+### 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.
+- Heartbeat every ~30 seconds.
+- Wait for incoming work orders (training, inference, research).
+
+You should see logs like:
+
+```text
+[heartbeat] registered as <peerId>
+[heartbeat] tier=0 caps=cpu_inference,research
+```
+
+### Step 6 — Verify on the dashboard
+
+Open `https://dashboard.synapseia.network/nodes` and search for your wallet address. Your node should appear in the list within ~1 minute. If it doesn't, check the **Troubleshooting** table below.
+
+---
+
+## Optional — node-ui (desktop GUI)
+
+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):
+
+- **macOS:** `synapseia-node-ui_<version>_aarch64.dmg` (Apple Silicon) or `_x64.dmg` (Intel).
+- **Windows:** `synapseia-node-ui_<version>_x64.msi`.
+- **Linux:** `synapseia-node-ui_<version>_amd64.AppImage`.
+
+Run the installer, follow the prompts, and on first launch the app will create or import the same `~/.synapseia/wallet.json` used by the CLI. Click **Start** to bring the node online — the GUI shows live logs and status.
+
+---
+
+## Troubleshooting
+
+| Message / Symptom | What it means | Fix |
+|---|---|---|
+| `[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. |
+| `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.** |
+
+---
+
+## CLI command reference
+
+### `synapseia start [options]`
+
+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 | — |
+| `--llm-key <key>` | External LLM API key (optional) | — |
+| `--inference` | Enable inference workloads | off |
+| `--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.
+
+Run any command with `--help` for the full option list.
+
+---
+
+## Configuration & data location
+
+- **Wallet:** `~/.synapseia/wallet.json` (encrypted with your password).
+- **Config:** `~/.synapseia/config.json`.
+- **Logs:** stdout / stderr. Redirect to file with:
+  ```bash
+  synapseia start 2>&1 | tee node.log
+  ```
+- **Override home dir:** set `SYNAPSEIA_HOME=/path/to/dir`.
+
+---
+
+## License
+
+This software is licensed under the **Functional Source License v1.1 with Apache-2.0 future grant (FSL-1.1-Apache-2.0)**.
+
+- **You can:** use it personally, modify it, run nodes for your own use, fork it for non-competing internal purposes.
+- **You cannot (until 2028-05-07):** operate a service or distributed network that competes with Synapseia.
+- **After 2028-05-07** the license auto-converts to **Apache-2.0** — anyone can use it for any purpose, including competing networks.
+
+Full text: see the [`LICENSE`](./LICENSE) file in this directory.
+
+---
+
+## Links
+
+- **Network dashboard:** `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)
+
+---
+
+## 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.

package/dist/bid-responder-Q725ZIUC.js

@@ -0,0 +1,86 @@
+import { fileURLToPath as __synFup } from "url";import { dirname as __synDn } from "path";const __filename = __synFup(import.meta.url);const __dirname = __synDn(__filename);
+import {
+  computeQueryPriceUsd
+} from "./chunk-NEHR6XY7.js";
+import {
+  TOPICS,
+  canonicalPayload,
+  init_identity,
+  sign
+} from "./chunk-3BHRQWSM.js";
+import {
+  init_logger,
+  logger_default
+} from "./chunk-V2L5SXTL.js";
+import {
+  __name
+} from "./chunk-D7ADMHK2.js";
+
+// src/modules/inference/bid-responder.ts
+init_logger();
+init_identity();
+var DEFAULT_MIN = 0.1;
+var DEFAULT_MAX = 1;
+var BidResponder = class {
+  static {
+    __name(this, "BidResponder");
+  }
+  p2p;
+  config;
+  constructor(p2p, config) {
+    this.p2p = p2p;
+    this.config = config;
+  }
+  start() {
+    if (!this.config.capabilities.includes("inference") && !this.config.capabilities.includes("cpu_inference") && !this.config.capabilities.includes("gpu_inference")) {
+      logger_default.log("[BidResponder] node has no inference capability \u2014 not listening for auctions");
+      return;
+    }
+    this.p2p.onMessage(TOPICS.CHAT_AUCTION, (data) => {
+      void this.handleAuction(data);
+    });
+    logger_default.log("[BidResponder] listening on /synapseia/chat-auction/1.0.0");
+  }
+  async handleAuction(msg) {
+    const quoteId = typeof msg.quoteId === "string" ? msg.quoteId : null;
+    const query = typeof msg.query === "string" ? msg.query : null;
+    const deadline = typeof msg.deadline === "number" ? msg.deadline : 0;
+    if (!quoteId || !query) return;
+    if (deadline && deadline < Date.now()) {
+      return;
+    }
+    const minPriceUsd = parseFloat(process.env.QUERY_MIN_PRICE ?? String(DEFAULT_MIN));
+    const maxPriceUsd = parseFloat(process.env.QUERY_MAX_PRICE ?? String(DEFAULT_MAX));
+    const priceUsd = computeQueryPriceUsd(query, {
+      minPriceUsd,
+      maxPriceUsd
+    });
+    const modelVersion = this.config.synapseiaClient?.getActiveVersion() ?? void 0;
+    const canonical = canonicalPayload({
+      quoteId,
+      peerId: this.config.identity.peerId,
+      priceUsd,
+      modelVersion: modelVersion ?? ""
+    });
+    const signature = await sign(canonical, this.config.identity.privateKey);
+    try {
+      const libp2pPeerId = this.p2p.getPeerId();
+      await this.p2p.publish(TOPICS.CHAT_BID, {
+        version: 1,
+        quoteId,
+        peerId: this.config.identity.peerId,
+        libp2pPeerId,
+        priceUsd,
+        modelVersion,
+        publicKey: this.config.identity.publicKey,
+        signature
+      });
+      logger_default.log(`[BidResponder] bid $${priceUsd} for quote ${quoteId.slice(0, 8)}\u2026 libp2p=${libp2pPeerId.slice(0, 12)}\u2026` + (modelVersion ? ` mv=${modelVersion}` : ""));
+    } catch (err) {
+      logger_default.warn(`[BidResponder] publish failed for quote ${quoteId.slice(0, 8)}\u2026: ${err.message}`);
+    }
+  }
+};
+export {
+  BidResponder
+};

package/dist/bootstrap.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { fileURLToPath as __synFup } from "url";import { dirname as __synDn } from "path";const __filename = __synFup(import.meta.url);const __dirname = __synDn(__filename);
+import {
+  __name
+} from "./chunk-D7ADMHK2.js";
+
+// src/cli/bootstrap.ts
+(/* @__PURE__ */ __name((function muteBigintBindingWarning() {
+  const originalWrite = process.stderr.write.bind(process.stderr);
+  process.stderr.write = /* @__PURE__ */ __name(function patched(chunk, ...rest) {
+    const s = typeof chunk === "string" ? chunk : chunk?.toString?.() ?? "";
+    if (s.includes("bigint: Failed to load bindings, pure JS will be used")) {
+      return true;
+    }
+    return originalWrite(chunk, ...rest);
+  }, "patched");
+}), "muteBigintBindingWarning"))();
+import("./index.js").catch((err) => {
+  process.stderr.write(`[bootstrap] Failed to load CLI: ${err.message}
+`);
+  process.exit(1);
+});