@holochain/hc-spin 0.700.0-dev.0 → 0.700.0-dev.1

package/.envrc

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

package/CHANGELOG.md

@@ -4,10 +4,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## \[Unreleased\]
 
-### Added
-### Fixed
+## 2026-02-13: v0.700.0-dev.1
+
 ### Changed
-### Removed
+- Holochain is now run with the iroh transport. The argument `--signaling-url` has been replaced with `--relay-url`.
 
 ## 2026-01-13: v0.700.0-dev.0
 ### Changed

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

@@ -12432,18 +12432,6 @@ function validateCliArgs(cliArgs, cliOpts, appDataRootDir) {
   const appId = cliOpts.appId ? cliOpts.appId : path.parse(path.basename(cliArgs[0])).name;
   const holochainPath = cliOpts.holochainPath;
   const numAgents = cliOpts.numAgents ? cliOpts.numAgents : 2;
-  let forceAdminPorts;
-  if (cliOpts.forceAdminPorts !== void 0) {
-    forceAdminPorts = cliOpts.forceAdminPorts.split(",").map((portStr) => {
-      const portInt = parseInt(portStr);
-      if (Number.isNaN(portInt)) {
-        throw new Error(
-          `The --force-admin-ports must be a comma-separated list of valid port numbers, but got: ${cliOpts.forceAdminPorts}`
-        );
-      }
-      return portInt;
-    });
-  }
   return {
     appId,
     holochainPath,
@@ -12451,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,
-    forceAdminPorts
+    openDevtools: cliOpts.openDevtools ? true : false
   };
 }
 async function createHappWindow(uiSource, appId, agentNum, appPort, appAuthToken, appDataRootDir) {
@@ -12576,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.700.0-dev.0"} (built for holochain ${"0.7.0-dev.7"})`).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(
@@ -12598,11 +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."
-).option(
-  "--force-admin-ports <ports>",
-  "A comma-separated list of port numbers for the holochain conductors to bind to their admin interfaces. By default, hc spin picks any available ports."
+  "--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({
@@ -12680,34 +12664,31 @@ 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, forceAdminPorts) {
-  const generateArgs = ["sandbox"];
-  if (forceAdminPorts !== void 0 && forceAdminPorts.length > 0) {
-    generateArgs.push("--force-admin-ports", forceAdminPorts.join(","));
-  }
-  generateArgs.push(
+async function spawnSandboxes(nAgents, happPath, bootStrapUrl, relayUrl, appId, networkSeed, targetArcFactor) {
+  const generateArgs = [
+    "sandbox",
     "--piped",
     "generate",
     "--num-sandboxes",
@@ -12715,7 +12696,7 @@ async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId,
     "--app-id",
     appId,
     "--run"
-  );
+  ];
   let appPorts = "";
   for (let i = 1; i <= nAgents; i++) {
     const appPort = await getPorts();
@@ -12730,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 = [];
@@ -12767,23 +12748,22 @@ electron.app.whenReady().then(async () => {
   if (CLI_OPTS.happOrWebhappPath.type === "webhapp") {
     happTargetDir = path.join(DATA_ROOT_DIR, "apps", CLI_OPTS.appId);
     const uiTargetDir = path.join(happTargetDir, "ui");
-    await rustUtils.unpackAndSaveWebhapp(
+    await rustUtils.saveHappOrWebhapp(
       CLI_OPTS.happOrWebhappPath.path,
       CLI_OPTS.appId,
       uiTargetDir,
       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,
-    CLI_OPTS.forceAdminPorts
+    CLI_OPTS.targetArcFactor
   );
   const lairUrls = [];
   sandboxPaths.forEach((sandbox) => {

package/flake.lock

@@ -2,11 +2,11 @@
   "nodes": {
     "crane": {
       "locked": {
-        "lastModified": 1763511871,
-        "narHash": "sha256-KKZWi+ij7oT0Ag8yC6MQkzfHGcytyjMJDD+47ZV1YNU=",
+        "lastModified": 1766194365,
+        "narHash": "sha256-4AFsUZ0kl6MXSm4BaQgItD0VGlEKR3iq7gIaL7TjBvc=",
         "owner": "ipetkov",
         "repo": "crane",
-        "rev": "099f9014bc8d0cd6e445470ea1df0fd691d5a548",
+        "rev": "7d8ec2c71771937ab99790b45e6d9b93d15d9379",
         "type": "github"
       },
       "original": {
@@ -20,11 +20,11 @@
         "nixpkgs-lib": "nixpkgs-lib"
       },
       "locked": {
-        "lastModified": 1762980239,
-        "narHash": "sha256-8oNVE8TrD19ulHinjaqONf9QWCKK+w4url56cdStMpM=",
+        "lastModified": 1765835352,
+        "narHash": "sha256-XswHlK/Qtjasvhd1nOa1e8MgZ8GS//jBoTqWtrS1Giw=",
         "owner": "hercules-ci",
         "repo": "flake-parts",
-        "rev": "52a2caecc898d0b46b2b905f058ccc5081f842da",
+        "rev": "a34fae9c08a15ad73f295041fec82323541400a9",
         "type": "github"
       },
       "original": {
@@ -53,16 +53,16 @@
     "holochain": {
       "flake": false,
       "locked": {
-        "lastModified": 1768178786,
-        "narHash": "sha256-JsYqXKZMkt4v0hd7dA3GCs8ELuLEoiectSY4Zw9pWJw=",
+        "lastModified": 1769992510,
+        "narHash": "sha256-hYq8p1BiPR+AdiOgeOPV+Gz+aTs2t5yu3V8lBGctBkE=",
         "owner": "holochain",
         "repo": "holochain",
-        "rev": "6594a0ed6a038113bc55e0c1545310736189d88b",
+        "rev": "5194f7af4f71db22dd22dc37cf8c1e68d0b6d628",
         "type": "github"
       },
       "original": {
         "owner": "holochain",
-        "ref": "holochain-0.7.0-dev.7",
+        "ref": "holochain-0.7.0-dev.10",
         "repo": "holochain",
         "type": "github"
       }
@@ -80,11 +80,11 @@
         "rust-overlay": "rust-overlay"
       },
       "locked": {
-        "lastModified": 1768299200,
-        "narHash": "sha256-wg7yUc/n6iYf5/qgV2tosZimJu0iTLVZOouko95TuiM=",
+        "lastModified": 1770384077,
+        "narHash": "sha256-9llOslhUNN0VN1EM57NDB5AByRgztxChw3DaytgcGjU=",
         "owner": "holochain",
         "repo": "holonix",
-        "rev": "70c034a9eedfd3d48450432f938b86dc11202361",
+        "rev": "b6587f0dbbb68de2d69d526e35a3efe7d311f2c4",
         "type": "github"
       },
       "original": {
@@ -97,16 +97,16 @@
     "kitsune2": {
       "flake": false,
       "locked": {
-        "lastModified": 1763403287,
-        "narHash": "sha256-dqQJMoDbcD0ekttrv5+8ph5Yf25EdXwKktsxNjV57Iw=",
+        "lastModified": 1770115587,
+        "narHash": "sha256-bF/7ERAfd41zEfzoUBKKyxuQU3c0QUi2Fc8MpM+hnEs=",
         "owner": "holochain",
         "repo": "kitsune2",
-        "rev": "22de6e42100aa960d05f5f30427a236ad922bd80",
+        "rev": "31b84100151a1eccaf7ed3e0037d27f77b5d7cdb",
         "type": "github"
       },
       "original": {
         "owner": "holochain",
-        "ref": "v0.3.2",
+        "ref": "main",
         "repo": "kitsune2",
         "type": "github"
       }
@@ -130,27 +130,27 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1763622513,
-        "narHash": "sha256-1jQnuyu82FpiSxowrF/iFK6Toh9BYprfDqfs4BB+19M=",
+        "lastModified": 1766201043,
+        "narHash": "sha256-eplAP+rorKKd0gNjV3rA6+0WMzb1X1i16F5m5pASnjA=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "c58bc7f5459328e4afac201c5c4feb7c818d604b",
+        "rev": "b3aad468604d3e488d627c0b43984eb60e75e782",
         "type": "github"
       },
       "original": {
         "owner": "nixos",
-        "ref": "nixos-25.05",
+        "ref": "nixos-25.11",
         "repo": "nixpkgs",
         "type": "github"
       }
     },
     "nixpkgs-lib": {
       "locked": {
-        "lastModified": 1761765539,
-        "narHash": "sha256-b0yj6kfvO8ApcSE+QmA6mUfu8IYG6/uU28OFn4PaC8M=",
+        "lastModified": 1765674936,
+        "narHash": "sha256-k00uTP4JNfmejrCLJOwdObYC9jHRrr/5M/a/8L2EIdo=",
         "owner": "nix-community",
         "repo": "nixpkgs.lib",
-        "rev": "719359f4562934ae99f5443f20aa06c2ffff91fc",
+        "rev": "2075416fcb47225d9b68ac469a5c4801a9c4dd85",
         "type": "github"
       },
       "original": {
@@ -197,11 +197,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1763692705,
-        "narHash": "sha256-tCKCyMYU0Vy+ph/xswlNsYXXjnFVweWBV+ew/5FS9tA=",
+        "lastModified": 1766371695,
+        "narHash": "sha256-W7CX9vy7H2Jj3E8NI4djHyF8iHSxKpb2c/7uNQ/vGFU=",
         "owner": "oxalica",
         "repo": "rust-overlay",
-        "rev": "6fbf5d328dce1828d887b8ee7d44a785196a34e7",
+        "rev": "d81285ba8199b00dc31847258cae3c655b605e8c",
         "type": "github"
       },
       "original": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/hc-spin",
-  "version": "0.700.0-dev.0",
+  "version": "0.700.0-dev.1",
   "holochainVersion": "0.7.0-dev.7",
   "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(
     '--force-admin-ports <ports>',
@@ -179,22 +179,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}`);
@@ -211,7 +211,7 @@ async function spawnSandboxes(
   nAgents: number,
   happPath: string,
   bootStrapUrl: string,
-  signalUrl: string,
+  relayUrl: string,
   appId: string,
   networkSeed?: string,
   targetArcFactor?: number,
@@ -250,7 +250,7 @@ async function spawnSandboxes(
   if (targetArcFactor !== undefined) {
     generateArgs.push('--target-arc-factor', targetArcFactor.toString());
   }
-  generateArgs.push('--bootstrap', bootStrapUrl, 'webrtc', signalUrl);
+  generateArgs.push('--bootstrap', bootStrapUrl, 'quic', relayUrl);
   // console.log('GENERATE ARGS: ', generateArgs);
 
   let readyConductors = 0;
@@ -313,13 +313,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;
   forceAdminPorts?: string;
@@ -24,7 +24,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;
@@ -114,7 +114,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 }