@holochain/hc-spin 0.600.2-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,11 +12439,10 @@ 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,
-    transport: cliOpts.transport || "quic"
+    openDevtools: cliOpts.openDevtools ? true : false
   };
 }
 async function createHappWindow(uiSource, appId, agentNum, appPort, appAuthToken, appDataRootDir) {
@@ -12586,12 +12585,9 @@ 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."
-).option("--open-devtools", "Automatically open the devtools on startup.").option(
-  "--transport <quic|webrtc>",
-  "Configure network transport. Defaults to quic, compatible with the iroh transport used in in Holochain by default. Set to `webrtc` for tx5 transport."
-);
+  "--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({
   input: process.stdin,
@@ -12664,33 +12660,33 @@ const handleSignZomeCall = async (e, request) => {
   };
   return signedZomeCall;
 };
-async function startLocalServices(transport) {
+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 = transport === "quic" ? `http://${hostAndPort}` : `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, transport, networkSeed, targetArcFactor) {
+async function spawnSandboxes(nAgents, happPath, bootStrapUrl, relayUrl, appId, networkSeed, targetArcFactor) {
   const generateArgs = [
     "sandbox",
     "--piped",
@@ -12715,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, transport, signalUrl);
+  generateArgs.push("--bootstrap", bootStrapUrl, "quic", relayUrl);
   let readyConductors = 0;
   const portsInfo = {};
   const sandboxPaths = [];
@@ -12759,14 +12755,13 @@ electron.app.whenReady().then(async () => {
       happTargetDir
     );
   }
-  const [bootstrapUrl, signalingUrl] = await startLocalServices(CLI_OPTS.transport);
+  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.transport,
     CLI_OPTS.networkSeed,
     CLI_OPTS.targetArcFactor
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/hc-spin",
-  "version": "0.600.2-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

@@ -21,7 +21,7 @@ import path from 'path';
 import split from 'split';
 
 import { menu } from './menu';
-import { Transport, validateCliArgs } from './validateArgs';
+import { validateCliArgs } from './validateArgs';
 import { createHappWindow, loadHappWindow } from './windows';
 
 const rustUtils = require('@holochain/hc-spin-rust-utils');
@@ -63,14 +63,10 @@ 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.')
-  .option(
-    '--transport <quic|webrtc>',
-    'Configure network transport. Defaults to quic, compatible with the iroh transport used in in Holochain by default. Set to `webrtc` for tx5 transport.',
-  );
+  .option('--open-devtools', 'Automatically open the devtools on startup.');
 
 cli.parse();
 // console.log('Got CLI opts: ', cli.opts());
@@ -175,26 +171,26 @@ const handleSignZomeCall = async (
   return signedZomeCall;
 };
 
-async function startLocalServices(transport: Transport): Promise<[string, string]> {
+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 = transport === 'quic' ? `http://${hostAndPort}` : `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}`);
@@ -211,9 +207,8 @@ async function spawnSandboxes(
   nAgents: number,
   happPath: string,
   bootStrapUrl: string,
-  signalUrl: string,
+  relayUrl: string,
   appId: string,
-  transport: Transport,
   networkSeed?: string,
   targetArcFactor?: number,
 ): Promise<
@@ -244,7 +239,7 @@ async function spawnSandboxes(
   if (targetArcFactor !== undefined) {
     generateArgs.push('--target-arc-factor', targetArcFactor.toString());
   }
-  generateArgs.push('--bootstrap', bootStrapUrl, transport, signalUrl);
+  generateArgs.push('--bootstrap', bootStrapUrl, 'quic', relayUrl);
 
   let readyConductors = 0;
   const portsInfo: Record<number, PortsInfo> = {};
@@ -306,15 +301,14 @@ app.whenReady().then(async () => {
     );
   }
 
-  const [bootstrapUrl, signalingUrl] = await startLocalServices(CLI_OPTS.transport);
+  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.transport,
     CLI_OPTS.networkSeed,
     CLI_OPTS.targetArcFactor,
   );

package/src/main/validateArgs.ts

@@ -11,10 +11,9 @@ export type CliOpts = {
   targetArcFactor?: number;
   uiPath?: string;
   uiPort?: number;
-  signalingUrl?: string;
+  relayUrl?: string;
   bootstrapUrl?: string;
   openDevtools?: boolean;
-  transport?: Transport;
 };
 
 export type CliOptsValidated = {
@@ -24,15 +23,12 @@ export type CliOptsValidated = {
   networkSeed: string | undefined;
   targetArcFactor: number | undefined;
   uiSource: UISource;
-  singalingUrl: string | undefined;
+  relayUrl: string | undefined;
   bootstrapUrl: string | undefined;
   happOrWebhappPath: HappOrWebhappPath;
   openDevtools: boolean;
-  transport: Transport;
 };
 
-export type Transport = 'quic' | 'webrtc';
-
 export type HappOrWebhappPath = {
   type: 'happ' | 'webhapp';
   path: string;
@@ -102,12 +98,11 @@ 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 }
       : { type: 'webhapp', path: happOrWebhappPath },
     openDevtools: cliOpts.openDevtools ? true : false,
-    transport: cliOpts.transport || 'quic',
   };
 }