@leofcoin/launch-chain 0.4.23 → 0.4.25

package/README.md

@@ -19,6 +19,35 @@ const { chain, endpoints, mode } = await launch(
 
 ## command line
 
+Requires Node.js 24.15.0 or newer. The default native WebRTC backend is
+`@vandeurenglenn/wrtc` 0.7.2 or newer.
+
+### automatic peer transports
+
+Launch-chain 0.4.25 requires chain 1.10.17 and lib 1.3.15, using published
+peernet 3 / swarm 0.10. Peers discover an available WebTransport relay through
+their configured star; clients do not need a relay URL, shared secret or TLS
+configuration. WebRTC and circuit fallback remain available when no relay is
+advertised. HTTP/3 needs reachable UDP and a correctly configured public star.
+Node's HTTP/3 backend also needs the optional native QUIC package's installation
+hook. This repository approves its exact reviewed version in `allowScripts`.
+Standalone installations using npm's script-blocking policy must review/approve
+that native package as well; the launcher never bypasses that policy.
+
+The star operator must also deploy swarm 0.10. Its `npm start` starts the star
+and relay together, creates the private relay secret, and discovers an existing
+matching Let's Encrypt certificate. Multiple certificate names require a one-time
+hostname selection. This does not issue certificates or change DNS/firewalls.
+See the [relay operator guide](https://github.com/netpeer/swarm/blob/main/docs/webtransport-relay.md).
+
+This dependency update does not change the Peach genesis, protocol version,
+account identities, passwords or data directory. Do not delete existing stores.
+Stop the existing process before upgrading and restart using the same data root.
+
+For development, after building, `npm run test:package -w @leofcoin/launch-chain`
+checks a clean tarball install, npm CLI entry and real-genesis offline startup
+using temporary storage. It is not proof of public peer sync or validator finality.
+
 No monorepo checkout or global install is required:
 
 ```sh
@@ -122,13 +151,14 @@ no prebuild are provided since the esm switch, everything is written with the br
 ### rollup
 
 ```js
-external: ['@koush/wrtc', '@leofcoin/endpoints/ws', '@leofcoin/endpoints/http']
+external: ['@vandeurenglenn/wrtc', '@koush/wrtc', '@leofcoin/endpoints/ws', '@leofcoin/endpoints/http']
 ```
 
 ### webpack
 
 ```js
 externals: {
+  '@vandeurenglenn/wrtc': false,
   '@koush/wrtc': false,
   '@leofcoin/endpoints/ws': false,
   '@leofcoin/endpoints/http': false

package/exports/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { readFile } from 'node:fs/promises';
+import { realpathSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve, isAbsolute, relative } from 'node:path';
 import { pathToFileURL } from 'node:url';
@@ -177,7 +178,18 @@ const runCli = async (args = process.argv.slice(2)) => {
     // explicitly closed interactive shell terminate predictably.
     setTimeout(() => process.exit(0), 100);
 };
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+// npm's bin entry and macOS temporary directories can both be symlinks. Node
+// canonicalizes import.meta.url, so compare it with the canonical argv path too.
+const isCliEntry = () => {
+    try {
+        return Boolean(process.argv[1]) && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;
+    }
+    catch {
+        // Imported from an eval/embedding process whose argv is not a file path.
+        return false;
+    }
+};
+if (isCliEntry()) {
     runCli().catch((error) => {
         process.stderr.write(`leofcoin: ${error?.message ?? error}\n`);
         process.exitCode = 1;

package/exports/index.js

@@ -111,7 +111,7 @@ const launch = async (input = {}, password) => {
     else if (options.mode === 'direct') {
         const node = new Node({ network: options.network, stars: options.stars, networkVersion: options.networkVersion, root: options.root }, password);
         await node.ready;
-        await nodeConfig({ network: options.network, networkVersion: options.networkVersion });
+        await nodeConfig({ network: options.network, networkVersion: options.networkVersion, root: options.root });
         chain = new Chain({ network: options.network, stars: options.stars, networkVersion: options.networkVersion });
         await chain.ready;
         if (options.ws) {
@@ -140,7 +140,7 @@ const launch = async (input = {}, password) => {
     else {
         const node = new Node({ network: options.network, stars: options.stars, networkVersion: options.networkVersion, root: options.root }, password);
         await node.ready;
-        await nodeConfig({ network: options.network, networkVersion: options.networkVersion });
+        await nodeConfig({ network: options.network, networkVersion: options.networkVersion, root: options.root });
         chain = new Chain({ network: options.network, stars: options.stars, networkVersion: options.networkVersion });
         await chain.ready;
         if (options.ws) {

package/exports/validator-cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { runCli } from './cli.js';
 import 'node:fs/promises';
+import 'node:fs';
 import 'node:os';
 import 'node:path';
 import 'node:url';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leofcoin/launch-chain",
-  "version": "0.4.23",
+  "version": "0.4.25",
   "description": "",
   "exports": {
     ".": {
@@ -26,7 +26,8 @@
   "type": "module",
   "scripts": {
     "build": "rollup -c",
-    "test": "node --test test/*.test.js"
+    "test": "node --test test/*.test.js",
+    "test:package": "node test/standalone-install.js"
   },
   "repository": {
     "type": "git",
@@ -41,13 +42,16 @@
   },
   "homepage": "https://github.com/leofcoin/monorepo/tree/main/packages/launch-chain#readme",
   "dependencies": {
-    "@leofcoin/addresses": "^1.0.62",
-    "@leofcoin/chain": "^1.10.12",
+    "@leofcoin/addresses": "^1.0.64",
+    "@leofcoin/chain": "^1.10.17",
     "@leofcoin/endpoint-clients": "^0.3.16",
     "@leofcoin/endpoints": "^0.4.9",
-    "@leofcoin/lib": "^1.3.10",
+    "@leofcoin/lib": "^1.3.15",
     "@leofcoin/networks": "^1.1.30",
-    "@vandeurenglenn/wrtc": "^0.5.5"
+    "@vandeurenglenn/wrtc": "^0.7.2"
+  },
+  "engines": {
+    "node": ">=24.15.0"
   },
   "devDependencies": {
     "@rollup/plugin-typescript": "^12.3.0",