@holochain/hc-spin 0.600.1-rc.0 → 0.600.3-rc.0

package/.envrc

@@ -0,0 +1 @@
+use flake

package/CHANGELOG.md

@@ -4,10 +4,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## \[Unreleased\]
 
-### Added
-### Fixed
+## 2026-02-13: v0.600.3-rc.0
+
 ### Changed
+- Holochain is now run with the iroh transport. The argument `--signaling-url` has been replaced with `--relay-url`.
 ### Removed
+- Removed CLI option `--transport` as holochain is run with `quic` iroh transport.
+
+## 2026-01-22: v0.600.2-rc.0
+
+### Changed
+- Added a CLI option `--transport` to choose between `quic` and `webrtc`. `quic` is used in combination with the iroh transport in Holochain, `webrtc` with tx5. The default transport in Holochain is iroh, so the default for hc-spin is `quic`. If no transport option is passed in on the command line, `quic` is used.
 
 ## 2026-01-22: v0.600.1-rc.0
 

package/README.md

@@ -50,7 +50,7 @@ Options:
   --network-seed <string>    Install the app with a specific network seed.
   --ui-path <path>           Path to the folder containing the index.html of the webhapp's UI.
   --ui-port <number>         Port pointing to a localhost dev server that serves your UI assets.
-  --signaling-url <url>      Url of the signaling server to use. By default, hc spin spins up a local development signaling server for you
+  --relay-url <url>          Url of the relay server to use. By default, hc spin spins up a local development relay server for you
                              but this argument allows you to specify a custom one.
   --open-devtools            Automatically open the devtools on startup.
   -h, --help                 display help for command

package/dist/main/index.js

@@ -12439,7 +12439,7 @@ function validateCliArgs(cliArgs, cliOpts, appDataRootDir) {
     networkSeed: cliOpts.networkSeed,
     targetArcFactor: cliOpts.targetArcFactor,
     uiSource: cliOpts.uiPath ? { type: "path", path: cliOpts.uiPath } : cliOpts.uiPort ? { type: "port", port: cliOpts.uiPort } : { type: "path", path: path.join(appDataRootDir, "apps", appId, "ui") },
-    singalingUrl: cliOpts.signalingUrl,
+    relayUrl: cliOpts.relayUrl,
     bootstrapUrl: cliOpts.bootstrapUrl,
     happOrWebhappPath: isHapp ? { type: "happ", path: happOrWebhappPath } : { type: "webhapp", path: happOrWebhappPath },
     openDevtools: cliOpts.openDevtools ? true : false
@@ -12563,7 +12563,7 @@ function setLinkOpenHandlers(browserWindow) {
 }
 const rustUtils = require("@holochain/hc-spin-rust-utils");
 const cli = new commander.Command();
-cli.name("hc-spin").description("CLI to run Holochain apps during development.").version(`${"0.600.0"} (built for holochain ${"0.6.0"})`).argument(
+cli.name("hc-spin").description("CLI to run Holochain apps during development.").version(`${"0.600.2-rc.0"} (built for holochain ${"0.6.1-rc.0"})`).argument(
   "<path>",
   "Path to .webhapp or .happ file to launch. If a .happ file is passed, either a UI path must be specified via --ui-path or a port pointing to a localhost server via --ui-port"
 ).option(
@@ -12585,8 +12585,8 @@ cli.name("hc-spin").description("CLI to run Holochain apps during development.")
   "--ui-port <number>",
   "Port pointing to a localhost dev server that serves your UI assets."
 ).option(
-  "--signaling-url <url>",
-  "Url of the signaling server to use. By default, hc spin spins up a local development signaling server for you but this argument allows you to specify a custom one."
+  "--relay-url <url>",
+  "Url of the relay server to use. By default, hc spin spins up a local development relay server for you but this argument allows you to specify a custom one."
 ).option("--open-devtools", "Automatically open the devtools on startup.");
 cli.parse();
 const rl = require("readline").createInterface({
@@ -12664,29 +12664,29 @@ async function startLocalServices() {
   const localServicesHandle = childProcess__namespace.spawn("kitsune2-bootstrap-srv");
   return new Promise((resolve) => {
     let bootStrapUrl;
-    let signalUrl;
+    let relayUrl;
     let bootstrapRunning = false;
-    let signalRunnig = false;
+    let relayRunning = false;
     localServicesHandle.stdout.pipe(split()).on("data", async (line) => {
       console.log(`[hc-spin] | [kitsune2-bootstrap-srv]: ${line}`);
       if (line.includes("#kitsune2_bootstrap_srv#listening#")) {
         const hostAndPort = line.split("#kitsune2_bootstrap_srv#listening#")[1].split("#")[0];
         bootStrapUrl = `http://${hostAndPort}`;
-        signalUrl = `ws://${hostAndPort}`;
+        relayUrl = `http://${hostAndPort}`;
       }
       if (line.includes("#kitsune2_bootstrap_srv#running#")) {
         bootstrapRunning = true;
-        signalRunnig = true;
+        relayRunning = true;
       }
-      if (bootstrapRunning && signalRunnig && bootStrapUrl && signalUrl)
-        resolve([bootStrapUrl, signalUrl]);
+      if (bootstrapRunning && relayRunning && bootStrapUrl && relayUrl)
+        resolve([bootStrapUrl, relayUrl]);
     });
     localServicesHandle.stderr.pipe(split()).on("data", async (line) => {
       console.log(`[hc-spin] | [hc run-local-services] ERROR: ${line}`);
     });
   });
 }
-async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId, networkSeed, targetArcFactor) {
+async function spawnSandboxes(nAgents, happPath, bootStrapUrl, relayUrl, appId, networkSeed, targetArcFactor) {
   const generateArgs = [
     "sandbox",
     "--piped",
@@ -12711,7 +12711,7 @@ async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId,
   if (targetArcFactor !== void 0) {
     generateArgs.push("--target-arc-factor", targetArcFactor.toString());
   }
-  generateArgs.push("--bootstrap", bootStrapUrl, "webrtc", signalUrl);
+  generateArgs.push("--bootstrap", bootStrapUrl, "quic", relayUrl);
   let readyConductors = 0;
   const portsInfo = {};
   const sandboxPaths = [];
@@ -12755,12 +12755,12 @@ electron.app.whenReady().then(async () => {
       happTargetDir
     );
   }
-  const [bootstrapUrl, signalingUrl] = await startLocalServices();
+  const [bootstrapUrl, relayUrl] = await startLocalServices();
   const [sandboxHandle, sandboxPaths, portsInfo] = await spawnSandboxes(
     CLI_OPTS.numAgents,
     happTargetDir ? happTargetDir : CLI_OPTS.happOrWebhappPath.path,
     CLI_OPTS.bootstrapUrl ? CLI_OPTS.bootstrapUrl : bootstrapUrl,
-    CLI_OPTS.singalingUrl ? CLI_OPTS.singalingUrl : signalingUrl,
+    CLI_OPTS.relayUrl ? CLI_OPTS.relayUrl : relayUrl,
     CLI_OPTS.appId,
     CLI_OPTS.networkSeed,
     CLI_OPTS.targetArcFactor

package/flake.lock

@@ -36,16 +36,16 @@
     "hc-scaffold": {
       "flake": false,
       "locked": {
-        "lastModified": 1764163563,
-        "narHash": "sha256-KigJ3h25yNJfeQunPm5QYFPtLSk6nU3IEEvZY8w01Vo=",
+        "lastModified": 1769104114,
+        "narHash": "sha256-Ebh8YW7J4VRAwhK9XQDf98nWAIvciddzdx7LbhZiwdI=",
         "owner": "holochain",
         "repo": "scaffolding",
-        "rev": "87e997a7361d4aa7c1bb96261483ebba50223bd0",
+        "rev": "6749c80d54306e4c1ad5831ce2dbdbb9a283ee0c",
         "type": "github"
       },
       "original": {
         "owner": "holochain",
-        "ref": "v0.600.1",
+        "ref": "v0.600.1-rc.0",
         "repo": "scaffolding",
         "type": "github"
       }
@@ -79,11 +79,11 @@
         "rust-overlay": "rust-overlay"
       },
       "locked": {
-        "lastModified": 1769045727,
-        "narHash": "sha256-sYGlDJ6pNt3n+Tu5F86Lsr8ki+TfGMRGeSrDz+MSv+w=",
+        "lastModified": 1769121828,
+        "narHash": "sha256-o1GUUg9FUADcTOU4gzDDtiuJo61PyrQHCn0e64HRJYU=",
         "owner": "holochain",
         "repo": "holonix",
-        "rev": "7b46630e1bd47b25d1f6385d8e921435f453c1a7",
+        "rev": "3e2a4b96b177aaaa233fd744ba82bfe308e85635",
         "type": "github"
       },
       "original": {
@@ -96,16 +96,16 @@
     "kitsune2": {
       "flake": false,
       "locked": {
-        "lastModified": 1767421208,
-        "narHash": "sha256-hPIesp4R8/8sA+Qqw1ECgsgCOKlyX5coGR+7QDoavWw=",
+        "lastModified": 1768402558,
+        "narHash": "sha256-v7uEmcVGC6tDjrkEZHMJa9DdXnqXwwVxJx9GkZq9P/U=",
         "owner": "holochain",
         "repo": "kitsune2",
-        "rev": "77471c1fb4b6f926609bf82152dc97e26457b4d9",
+        "rev": "2b809bcf0bff3d493cd5ba230677240432fff58a",
         "type": "github"
       },
       "original": {
         "owner": "holochain",
-        "ref": "v0.4.0-dev.2",
+        "ref": "2b809bcf0bff3d493cd5ba230677240432fff58a",
         "repo": "kitsune2",
         "type": "github"
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/hc-spin",
-  "version": "0.600.1-rc.0",
+  "version": "0.600.3-rc.0",
   "holochainVersion": "0.6.1-rc.0",
   "description": "CLI to run Holochain apps during development.",
   "author": "matthme",

package/src/main/index.ts

@@ -63,8 +63,8 @@ cli
     'Port pointing to a localhost dev server that serves your UI assets.',
   )
   .option(
-    '--signaling-url <url>',
-    'Url of the signaling server to use. By default, hc spin spins up a local development signaling server for you but this argument allows you to specify a custom one.',
+    '--relay-url <url>',
+    'Url of the relay server to use. By default, hc spin spins up a local development relay server for you but this argument allows you to specify a custom one.',
   )
   .option('--open-devtools', 'Automatically open the devtools on startup.');
 
@@ -175,22 +175,22 @@ async function startLocalServices(): Promise<[string, string]> {
   const localServicesHandle = childProcess.spawn('kitsune2-bootstrap-srv');
   return new Promise((resolve) => {
     let bootStrapUrl;
-    let signalUrl;
+    let relayUrl;
     let bootstrapRunning = false;
-    let signalRunnig = false;
+    let relayRunning = false;
     localServicesHandle.stdout.pipe(split()).on('data', async (line: string) => {
       console.log(`[hc-spin] | [kitsune2-bootstrap-srv]: ${line}`);
       if (line.includes('#kitsune2_bootstrap_srv#listening#')) {
         const hostAndPort = line.split('#kitsune2_bootstrap_srv#listening#')[1].split('#')[0];
         bootStrapUrl = `http://${hostAndPort}`;
-        signalUrl = `ws://${hostAndPort}`;
+        relayUrl = `http://${hostAndPort}`;
       }
       if (line.includes('#kitsune2_bootstrap_srv#running#')) {
         bootstrapRunning = true;
-        signalRunnig = true;
+        relayRunning = true;
       }
-      if (bootstrapRunning && signalRunnig && bootStrapUrl && signalUrl)
-        resolve([bootStrapUrl, signalUrl]);
+      if (bootstrapRunning && relayRunning && bootStrapUrl && relayUrl)
+        resolve([bootStrapUrl, relayUrl]);
     });
     localServicesHandle.stderr.pipe(split()).on('data', async (line: string) => {
       console.log(`[hc-spin] | [hc run-local-services] ERROR: ${line}`);
@@ -207,7 +207,7 @@ async function spawnSandboxes(
   nAgents: number,
   happPath: string,
   bootStrapUrl: string,
-  signalUrl: string,
+  relayUrl: string,
   appId: string,
   networkSeed?: string,
   targetArcFactor?: number,
@@ -239,8 +239,7 @@ async function spawnSandboxes(
   if (targetArcFactor !== undefined) {
     generateArgs.push('--target-arc-factor', targetArcFactor.toString());
   }
-  generateArgs.push('--bootstrap', bootStrapUrl, 'webrtc', signalUrl);
-  // console.log('GENERATE ARGS: ', generateArgs);
+  generateArgs.push('--bootstrap', bootStrapUrl, 'quic', relayUrl);
 
   let readyConductors = 0;
   const portsInfo: Record<number, PortsInfo> = {};
@@ -302,13 +301,13 @@ app.whenReady().then(async () => {
     );
   }
 
-  const [bootstrapUrl, signalingUrl] = await startLocalServices();
+  const [bootstrapUrl, relayUrl] = await startLocalServices();
 
   const [sandboxHandle, sandboxPaths, portsInfo] = await spawnSandboxes(
     CLI_OPTS.numAgents,
     happTargetDir ? happTargetDir : CLI_OPTS.happOrWebhappPath.path,
     CLI_OPTS.bootstrapUrl ? CLI_OPTS.bootstrapUrl : bootstrapUrl,
-    CLI_OPTS.singalingUrl ? CLI_OPTS.singalingUrl : signalingUrl,
+    CLI_OPTS.relayUrl ? CLI_OPTS.relayUrl : relayUrl,
     CLI_OPTS.appId,
     CLI_OPTS.networkSeed,
     CLI_OPTS.targetArcFactor,

package/src/main/validateArgs.ts

@@ -11,7 +11,7 @@ export type CliOpts = {
   targetArcFactor?: number;
   uiPath?: string;
   uiPort?: number;
-  signalingUrl?: string;
+  relayUrl?: string;
   bootstrapUrl?: string;
   openDevtools?: boolean;
 };
@@ -23,7 +23,7 @@ export type CliOptsValidated = {
   networkSeed: string | undefined;
   targetArcFactor: number | undefined;
   uiSource: UISource;
-  singalingUrl: string | undefined;
+  relayUrl: string | undefined;
   bootstrapUrl: string | undefined;
   happOrWebhappPath: HappOrWebhappPath;
   openDevtools: boolean;
@@ -98,7 +98,7 @@ export function validateCliArgs(
       : cliOpts.uiPort
         ? { type: 'port', port: cliOpts.uiPort }
         : { type: 'path', path: path.join(appDataRootDir, 'apps', appId, 'ui') },
-    singalingUrl: cliOpts.signalingUrl,
+    relayUrl: cliOpts.relayUrl,
     bootstrapUrl: cliOpts.bootstrapUrl,
     happOrWebhappPath: isHapp
       ? { type: 'happ', path: happOrWebhappPath }