@origintrail-official/dkg-core 10.0.0 → 10.0.1

package/dist/ensure-dkg-node-config.d.ts

@@ -29,6 +29,24 @@
  * Logging: keeps the `[setup] ...` console.log prefix verbatim so
  * user-visible output is unchanged from pre-extraction.
  */
+/**
+ * Read the persisted `networkConfig` selector from a node's home directory,
+ * honoring BOTH `config.json` and `config.yaml`. A present, parseable
+ * `config.json` is authoritative (its `networkConfig`, or `undefined` if
+ * unset — `config.yaml` is not consulted); `config.yaml` is read only when
+ * `config.json` is absent. Returns `undefined` when no config exists or
+ * `networkConfig` is unset/blank.
+ *
+ * NOTE: on a CORRUPT `config.json` this falls through to `config.yaml`
+ * (best-effort), whereas the daemon's `loadConfig` re-throws and refuses to
+ * boot — harmless divergence since a corrupt config.json makes the node
+ * unbootable, so the resolved name is moot.
+ *
+ * Setup flows use this (not a json-only read) so a YAML-only node's network
+ * is correctly identified and not mis-resolved to the legacy testnet fallback
+ * (which would misfire the testnet faucet against a mainnet node).
+ */
+export declare function readPersistedNetworkConfigName(home: string): string | undefined;
 /**
  * The fields of `network/<env>.json` that `ensureDkgNodeConfig` actually
  * reads. Adapters can pass their full `NetworkConfig` shape — the helper
@@ -59,6 +77,15 @@ export interface EnsureDkgNodeConfigOptions {
     agentName: string;
     /** Loaded `network/<env>.json` slice. */
     network: DkgNodeNetworkConfig;
+    /**
+     * The network overlay name to persist as `config.networkConfig` (e.g.
+     * `'mainnet-gnosis'`). Callers resolve this via `resolveSetupNetworkName`
+     * and MUST load `network` from the SAME name so the persisted selector and
+     * the network slice agree. Persisting it explicitly is what makes setup
+     * default new nodes onto mainnet without relying on (or mutating) the
+     * `project.json#defaultNetwork` runtime fallback.
+     */
+    networkConfigName: string;
     /** Daemon API port to use when no existing config has one. */
     apiPort: number;
     /**

package/dist/ensure-dkg-node-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-dkg-node-config.d.ts","sourceRoot":"","sources":["../src/ensure-dkg-node-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAiBH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAuE1E"}
+{"version":3,"file":"ensure-dkg-node-config.d.ts","sourceRoot":"","sources":["../src/ensure-dkg-node-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB/E;AAUD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,oBAAoB,CAAC;IAC9B;;;;;;;OAOG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CA6E1E"}

package/dist/ensure-dkg-node-config.js

@@ -29,11 +29,58 @@
  * Logging: keeps the `[setup] ...` console.log prefix verbatim so
  * user-visible output is unchanged from pre-extraction.
  */
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import yaml from 'js-yaml';
 import { resolveDkgConfigHome } from './dkg-home.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Read the persisted `networkConfig` selector from a node's home directory,
+ * honoring BOTH `config.json` and `config.yaml`. A present, parseable
+ * `config.json` is authoritative (its `networkConfig`, or `undefined` if
+ * unset — `config.yaml` is not consulted); `config.yaml` is read only when
+ * `config.json` is absent. Returns `undefined` when no config exists or
+ * `networkConfig` is unset/blank.
+ *
+ * NOTE: on a CORRUPT `config.json` this falls through to `config.yaml`
+ * (best-effort), whereas the daemon's `loadConfig` re-throws and refuses to
+ * boot — harmless divergence since a corrupt config.json makes the node
+ * unbootable, so the resolved name is moot.
+ *
+ * Setup flows use this (not a json-only read) so a YAML-only node's network
+ * is correctly identified and not mis-resolved to the legacy testnet fallback
+ * (which would misfire the testnet faucet against a mainnet node).
+ */
+export function readPersistedNetworkConfigName(home) {
+    const pick = (obj) => {
+        if (obj && typeof obj === 'object') {
+            const nc = obj.networkConfig;
+            if (typeof nc === 'string' && nc.trim())
+                return nc.trim();
+        }
+        return undefined;
+    };
+    const jsonPath = join(home, 'config.json');
+    if (existsSync(jsonPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(jsonPath, 'utf-8'));
+            if (raw && typeof raw === 'object')
+                return pick(raw);
+        }
+        catch { /* corrupt JSON — fall through to YAML */ }
+    }
+    const yamlPath = join(home, 'config.yaml');
+    if (existsSync(yamlPath)) {
+        try {
+            const raw = yaml.load(readFileSync(yamlPath, 'utf-8'));
+            if (raw && typeof raw === 'object')
+                return pick(raw);
+        }
+        catch { /* corrupt YAML */ }
+    }
+    return undefined;
+}
 function log(msg) {
     console.log(`[setup] ${msg}`);
 }
@@ -47,7 +94,7 @@ function dkgDir() {
  * extraction output).
  */
 export function ensureDkgNodeConfig(opts) {
-    const { agentName, network, apiPort, existing, overrides } = opts;
+    const { agentName, network, networkConfigName, apiPort, existing, overrides } = opts;
     const dir = dkgDir();
     const configPath = join(dir, 'config.json');
     // A pre-existing config gates the store-default seeding below (issue #960):
@@ -73,6 +120,12 @@ export function ensureDkgNodeConfig(opts) {
     const config = {
         ...existing,
         name: overrides?.nameExplicit ? agentName : (existing.name ?? agentName),
+        // Persist the selected network EXPLICITLY. Unlike `chain`/`autoUpdate`
+        // (deliberately left to the runtime resolver above), the network
+        // selector is pinned so a node never silently follows a change to the
+        // `project.json#defaultNetwork` runtime fallback — switching networks is
+        // a deliberate, money-bearing act, not an implicit default drift.
+        networkConfig: networkConfigName,
         apiPort: overrides?.portExplicit ? apiPort : (existing.apiPort ?? apiPort),
         nodeRole: existing.nodeRole ?? network.defaultNodeRole,
         contextGraphs: existing.contextGraphs ?? network.defaultContextGraphs,

package/dist/ensure-dkg-node-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-dkg-node-config.js","sourceRoot":"","sources":["../src/ensure-dkg-node-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,MAAM;IACb,OAAO,oBAAoB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACvD,CAAC;AAoDD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgC;IAClE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAElE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,8EAA8E;IAC9E,mEAAmE;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IACrF,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,wEAAwE;IACxE,sEAAsE;IACtE,WAAW;IACX,EAAE;IACF,+DAA+D;IAC/D,oEAAoE;IACpE,6DAA6D;IAC7D,yEAAyE;IACzE,uEAAuE;IACvE,+DAA+D;IAC/D,uEAAuE;IACvE,qEAAqE;IACrE,aAAa;IACb,MAAM,MAAM,GAAwB;QAClC,GAAG,QAAQ;QACX,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC;QACxE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC;QAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAK,OAAO,CAAC,eAAmC;QAC3E,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,oBAAoB;QACrE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACzC,CAAC;IAEF,oEAAoE;IACpE,sEAAsE;IACtE,sEAAsE;IACtE,qBAAqB;IACrB,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,wEAAwE;IACxE,sEAAsE;IACtE,8DAA8D;IAC9D,+DAA+D;IAC/D,wEAAwE;IACxE,iEAAiE;IACjE,kEAAkE;IAClE,wEAAwE;IACxE,WAAW;IACX,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,UAAU,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,wEAAwE;IACxE,6EAA6E;IAC7E,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,gEAAgE;IAChE,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,GAAG,CAAC,SAAS,UAAU,KAAK,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"ensure-dkg-node-config.js","sourceRoot":"","sources":["../src/ensure-dkg-node-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,IAAI,GAAG,CAAC,GAAY,EAAsB,EAAE;QAChD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,GAAI,GAA+B,CAAC,aAAa,CAAC;YAC1D,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACxD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,MAAM;IACb,OAAO,oBAAoB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACvD,CAAC;AA6DD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgC;IAClE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAErF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,8EAA8E;IAC9E,mEAAmE;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IACrF,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,wEAAwE;IACxE,sEAAsE;IACtE,WAAW;IACX,EAAE;IACF,+DAA+D;IAC/D,oEAAoE;IACpE,6DAA6D;IAC7D,yEAAyE;IACzE,uEAAuE;IACvE,+DAA+D;IAC/D,uEAAuE;IACvE,qEAAqE;IACrE,aAAa;IACb,MAAM,MAAM,GAAwB;QAClC,GAAG,QAAQ;QACX,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC;QACxE,uEAAuE;QACvE,iEAAiE;QACjE,sEAAsE;QACtE,yEAAyE;QACzE,kEAAkE;QAClE,aAAa,EAAE,iBAAiB;QAChC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC;QAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAK,OAAO,CAAC,eAAmC;QAC3E,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,oBAAoB;QACrE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACzC,CAAC;IAEF,oEAAoE;IACpE,sEAAsE;IACtE,sEAAsE;IACtE,qBAAqB;IACrB,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,wEAAwE;IACxE,sEAAsE;IACtE,8DAA8D;IAC9D,+DAA+D;IAC/D,wEAAwE;IACxE,iEAAiE;IACjE,kEAAkE;IAClE,wEAAwE;IACxE,WAAW;IACX,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,UAAU,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,wEAAwE;IACxE,6EAA6E;IAC7E,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,gEAAgE;IAChE,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,GAAG,CAAC,SAAS,UAAU,KAAK,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;AAClG,CAAC"}

package/dist/errors.d.ts

@@ -9,6 +9,24 @@
 export declare class DKGError extends Error {
     constructor(message: string);
 }
+/**
+ * Funded operational-wallet selection — cross-package error contract.
+ *
+ * Defined in this UI-safe shared package so every consumer references one
+ * source: the chain adapter (which throws the error + builds the message), the
+ * daemon route/lifecycle handlers, the publisher async-job classifier, and
+ * node-ui. dkg-chain re-exports NO_FUNDED_PUBLISHER_WALLET_CODE for chain-side
+ * imports.
+ */
+export declare const NO_FUNDED_PUBLISHER_WALLET_CODE = "NO_FUNDED_PUBLISHER_WALLET";
+/** The literal prefix every InsufficientPublisherFundsError message starts with.
+ *  The chain formatter builds the message from this; consumers that only have a
+ *  (possibly re-wrapped, code-stripped) message string match on it via
+ *  {@link messageIndicatesNoFundedPublisherWallet}. */
+export declare const NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX = "No operational wallet has enough funds";
+/** True iff a message string indicates a no-funded-wallet publish failure — the
+ *  fallback used when the structured `.code` was lost to a re-wrap. */
+export declare function messageIndicatesNoFundedPublisherWallet(message: unknown): boolean;
 /**
  * An error caused by invalid user input or a pre-condition that the user
  * can fix. CLI handlers can show these messages directly without a stack trace.

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4CAA4C;AAC5C,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;aACC,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,iDAAiD;AACjD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,SAAsB;CAW5E;AAED,kEAAkE;AAClE,qBAAa,6BAA8B,SAAQ,oBAAoB;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd;CAOF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAInD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4CAA4C;AAC5C,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;uDAGuD;AACvD,eAAO,MAAM,yCAAyC,2CACZ,CAAC;AAO3C;uEACuE;AACvE,wBAAgB,uCAAuC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;aACC,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,iDAAiD;AACjD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,SAAsB;CAW5E;AAED,kEAAkE;AAClE,qBAAa,6BAA8B,SAAQ,oBAAoB;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd;CAOF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAInD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE"}

package/dist/errors.js

@@ -12,6 +12,27 @@ export class DKGError extends Error {
         this.name = 'DKGError';
     }
 }
+/**
+ * Funded operational-wallet selection — cross-package error contract.
+ *
+ * Defined in this UI-safe shared package so every consumer references one
+ * source: the chain adapter (which throws the error + builds the message), the
+ * daemon route/lifecycle handlers, the publisher async-job classifier, and
+ * node-ui. dkg-chain re-exports NO_FUNDED_PUBLISHER_WALLET_CODE for chain-side
+ * imports.
+ */
+export const NO_FUNDED_PUBLISHER_WALLET_CODE = 'NO_FUNDED_PUBLISHER_WALLET';
+/** The literal prefix every InsufficientPublisherFundsError message starts with.
+ *  The chain formatter builds the message from this; consumers that only have a
+ *  (possibly re-wrapped, code-stripped) message string match on it via
+ *  {@link messageIndicatesNoFundedPublisherWallet}. */
+export const NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX = 'No operational wallet has enough funds';
+const NO_FUNDED_PUBLISHER_WALLET_MARKER = new RegExp(NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, 'i');
+/** True iff a message string indicates a no-funded-wallet publish failure — the
+ *  fallback used when the structured `.code` was lost to a re-wrap. */
+export function messageIndicatesNoFundedPublisherWallet(message) {
+    return typeof message === 'string' && NO_FUNDED_PUBLISHER_WALLET_MARKER.test(message);
+}
 /**
  * An error caused by invalid user input or a pre-condition that the user
  * can fix. CLI handlers can show these messages directly without a stack trace.

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4CAA4C;AAC5C,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACC;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,iDAAiD;AACjD,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAC3C,IAAI,CAAS;IACb,QAAQ,CAAU;IAE3B,YAAY,QAAiB,EAAE,OAAgB,EAAE,IAAI,GAAG,mBAAmB;QACzE,KAAK,CACH,OAAO;YACP,CAAC,QAAQ,IAAI,IAAI;gBACf,CAAC,CAAC,4BAA4B,QAAQ,SAAS;gBAC/C,CAAC,CAAC,mBAAmB,CAAC,CACzB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,6BAA8B,SAAQ,oBAAoB;IAC5D,WAAW,CAAS;IACpB,IAAI,CAAS;IACb,SAAS,CAAsB;IAExC,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAY;IACrD,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,MAAM,IAAI,GAAG;QACZ,GAA6B,CAAC,IAAI,KAAK,IAAI,CAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4CAA4C;AAC5C,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAE5E;;;uDAGuD;AACvD,MAAM,CAAC,MAAM,yCAAyC,GACpD,wCAAwC,CAAC;AAE3C,MAAM,iCAAiC,GAAG,IAAI,MAAM,CAClD,yCAAyC,EACzC,GAAG,CACJ,CAAC;AAEF;uEACuE;AACvE,MAAM,UAAU,uCAAuC,CAAC,OAAgB;IACtE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACC;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,iDAAiD;AACjD,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAC3C,IAAI,CAAS;IACb,QAAQ,CAAU;IAE3B,YAAY,QAAiB,EAAE,OAAgB,EAAE,IAAI,GAAG,mBAAmB;QACzE,KAAK,CACH,OAAO;YACP,CAAC,QAAQ,IAAI,IAAI;gBACf,CAAC,CAAC,4BAA4B,QAAQ,SAAS;gBAC/C,CAAC,CAAC,mBAAmB,CAAC,CACzB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,6BAA8B,SAAQ,oBAAoB;IAC5D,WAAW,CAAS;IACpB,IAAI,CAAS;IACb,SAAS,CAAsB;IAExC,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAY;IACrD,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,MAAM,IAAI,GAAG;QACZ,GAA6B,CAAC,IAAI,KAAK,IAAI,CAC7C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -27,12 +27,14 @@ export { ProtocolOutbox, type ProtocolOutboxOptions, DEFAULT_PROTOCOL_OUTBOX_BAC
 export { findPackageRepoDir, blueGreenSlotEntryPoint, blueGreenSlotReady, } from './blue-green.js';
 export { FAUCET_WALLETS_PER_REQUEST, getFundableWalletAddresses, requestFaucetFunding, type FaucetResult, type FundableWalletConfigLike, type FundableWalletEntryLike, type FundableWalletSource, } from './faucet.js';
 export { fundWalletsBestEffort, logManualFundingInstructions, readWallets, readWalletsWithRetry, type FundWalletsBestEffortOptions, type FundWalletsNetworkConfig, } from './faucet-orchestration.js';
-export { ensureDkgNodeConfig, type DkgNodeConfigOverrides, type DkgNodeNetworkConfig, type EnsureDkgNodeConfigOptions, } from './ensure-dkg-node-config.js';
+export { ensureDkgNodeConfig, readPersistedNetworkConfigName, type DkgNodeConfigOverrides, type DkgNodeNetworkConfig, type EnsureDkgNodeConfigOptions, } from './ensure-dkg-node-config.js';
+export { DEFAULT_SETUP_NETWORK, LEGACY_FALLBACK_NETWORK, SELECTABLE_SETUP_NETWORKS, resolveSetupNetworkName, type ResolveSetupNetworkNameOptions, } from './setup-network.js';
 export { resolveCliPackageDir } from './resolve-cli-package-dir.js';
 export { resolveDkgCli, type ResolvedDkgCli } from './resolve-dkg-cli.js';
 export { startDaemon } from './daemon-lifecycle.js';
 export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, } from './sparql-safe.js';
-export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, } from './errors.js';
+export { JAVA_WRITE_UTF_MAX_BYTES, DKG_RDF_LITERAL_SAFE_MUTF8_BYTES, OVERSIZED_RDF_LITERAL_ERROR_CODE, OversizedRdfLiteralError, javaModifiedUtf8ByteLength, rdfLiteralTermMutf8ByteLength, isOversizedRdfLiteralError, assertRdfLiteralMutf8Safe, assertQuadLiteralsMutf8Safe, type RdfLiteralSizeContext, type QuadLiteralLike, } from './rdf-literal-size.js';
+export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, messageIndicatesNoFundedPublisherWallet, } from './errors.js';
 export { dkgHomeDir, resolveDkgConfigHome, dkgAuthTokenPath, isDkgMonorepoRoot, findDkgMonorepoRoot, resolveDkgHome, readDaemonPid, isProcessAlive, readDkgApiPort, loadAuthTokenSync, loadAuthToken, toEip55Checksum, } from './dkg-home.js';
 export { type Quad as ExtractionQuad, type ExtractionInput, type ConverterOutput, type ExtractionOutput, type ExtractionPipeline, ExtractionPipelineRegistry, } from './extraction-pipeline.js';
 export * from './transducers.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -45,12 +45,14 @@ export { ProtocolOutbox, DEFAULT_PROTOCOL_OUTBOX_BACKOFFS_MS, DEFAULT_PROTOCOL_O
 export { findPackageRepoDir, blueGreenSlotEntryPoint, blueGreenSlotReady, } from './blue-green.js';
 export { FAUCET_WALLETS_PER_REQUEST, getFundableWalletAddresses, requestFaucetFunding, } from './faucet.js';
 export { fundWalletsBestEffort, logManualFundingInstructions, readWallets, readWalletsWithRetry, } from './faucet-orchestration.js';
-export { ensureDkgNodeConfig, } from './ensure-dkg-node-config.js';
+export { ensureDkgNodeConfig, readPersistedNetworkConfigName, } from './ensure-dkg-node-config.js';
+export { DEFAULT_SETUP_NETWORK, LEGACY_FALLBACK_NETWORK, SELECTABLE_SETUP_NETWORKS, resolveSetupNetworkName, } from './setup-network.js';
 export { resolveCliPackageDir } from './resolve-cli-package-dir.js';
 export { resolveDkgCli } from './resolve-dkg-cli.js';
 export { startDaemon } from './daemon-lifecycle.js';
 export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, } from './sparql-safe.js';
-export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, } from './errors.js';
+export { JAVA_WRITE_UTF_MAX_BYTES, DKG_RDF_LITERAL_SAFE_MUTF8_BYTES, OVERSIZED_RDF_LITERAL_ERROR_CODE, OversizedRdfLiteralError, javaModifiedUtf8ByteLength, rdfLiteralTermMutf8ByteLength, isOversizedRdfLiteralError, assertRdfLiteralMutf8Safe, assertQuadLiteralsMutf8Safe, } from './rdf-literal-size.js';
+export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, messageIndicatesNoFundedPublisherWallet, } from './errors.js';
 export { dkgHomeDir, resolveDkgConfigHome, dkgAuthTokenPath, isDkgMonorepoRoot, findDkgMonorepoRoot, resolveDkgHome, readDaemonPid, isProcessAlive, readDkgApiPort, loadAuthTokenSync, loadAuthToken, toEip55Checksum, } from './dkg-home.js';
 export { ExtractionPipelineRegistry, } from './extraction-pipeline.js';
 export * from './transducers.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/rdf-literal-size.d.ts

@@ -0,0 +1,49 @@
+import { DKGUserError } from './errors.js';
+export declare const JAVA_WRITE_UTF_MAX_BYTES = 65535;
+export declare const DKG_RDF_LITERAL_SAFE_MUTF8_BYTES = 60000;
+export declare const OVERSIZED_RDF_LITERAL_ERROR_CODE = "OVERSIZED_RDF_LITERAL";
+export interface RdfLiteralSizeContext {
+    readonly label?: string;
+    readonly subject?: string;
+    readonly predicate?: string;
+    readonly graph?: string;
+    readonly maxBytes?: number;
+}
+export interface QuadLiteralLike {
+    readonly subject: string;
+    readonly predicate: string;
+    readonly object: string;
+    readonly graph?: string;
+}
+export declare class OversizedRdfLiteralError extends DKGUserError {
+    readonly code = "OVERSIZED_RDF_LITERAL";
+    readonly actualBytes: number;
+    readonly maxBytes: number;
+    readonly subject?: string;
+    readonly predicate?: string;
+    readonly graph?: string;
+    readonly label?: string;
+    constructor(args: {
+        actualBytes: number;
+        maxBytes: number;
+        label?: string;
+        subject?: string;
+        predicate?: string;
+        graph?: string;
+    });
+}
+/**
+ * Java Modified UTF-8 byte length using Java's UTF-16 code-unit rules.
+ *
+ * This intentionally differs from standard UTF-8:
+ * - U+0000 is 2 bytes.
+ * - U+0001 through U+007F are 1 byte.
+ * - U+0080 through U+07FF are 2 bytes.
+ * - All other UTF-16 code units, including surrogate halves, are 3 bytes.
+ */
+export declare function javaModifiedUtf8ByteLength(value: string): number;
+export declare function rdfLiteralTermMutf8ByteLength(term: string): number | undefined;
+export declare function isOversizedRdfLiteralError(err: unknown): err is OversizedRdfLiteralError;
+export declare function assertRdfLiteralMutf8Safe(term: string, options?: RdfLiteralSizeContext): void;
+export declare function assertQuadLiteralsMutf8Safe(quads: readonly QuadLiteralLike[], options?: Pick<RdfLiteralSizeContext, 'label' | 'maxBytes'>): void;
+//# sourceMappingURL=rdf-literal-size.d.ts.map

package/dist/rdf-literal-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rdf-literal-size.d.ts","sourceRoot":"","sources":["../src/rdf-literal-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,gCAAgC,0BAA0B,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,QAAQ,CAAC,IAAI,2BAAoC;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CAgBF;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAehE;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,wBAAwB,CAIxF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAaN;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,UAAU,CAAM,GAC9D,IAAI,CAWN"}

package/dist/rdf-literal-size.js

@@ -0,0 +1,111 @@
+import { DKGUserError } from './errors.js';
+export const JAVA_WRITE_UTF_MAX_BYTES = 65_535;
+export const DKG_RDF_LITERAL_SAFE_MUTF8_BYTES = 60_000;
+export const OVERSIZED_RDF_LITERAL_ERROR_CODE = 'OVERSIZED_RDF_LITERAL';
+export class OversizedRdfLiteralError extends DKGUserError {
+    code = OVERSIZED_RDF_LITERAL_ERROR_CODE;
+    actualBytes;
+    maxBytes;
+    subject;
+    predicate;
+    graph;
+    label;
+    constructor(args) {
+        const location = describeLiteralLocation(args);
+        super(`RDF literal${location} is ${args.actualBytes} Java MUTF-8 bytes, ` +
+            `which exceeds the Blazegraph-compatible safe limit of ${args.maxBytes} bytes. ` +
+            `Split large text into ordered chunks below the limit, or store the body externally ` +
+            `and publish only its URI, hash, summary, and metadata.`);
+        this.name = 'OversizedRdfLiteralError';
+        this.actualBytes = args.actualBytes;
+        this.maxBytes = args.maxBytes;
+        this.label = args.label;
+        this.subject = args.subject;
+        this.predicate = args.predicate;
+        this.graph = args.graph;
+    }
+}
+function describeLiteralLocation(args) {
+    const parts = [];
+    if (args.label)
+        parts.push(args.label);
+    if (args.subject)
+        parts.push(`subject=${truncateForMessage(args.subject)}`);
+    if (args.predicate)
+        parts.push(`predicate=${truncateForMessage(args.predicate)}`);
+    if (args.graph)
+        parts.push(`graph=${truncateForMessage(args.graph)}`);
+    return parts.length > 0 ? ` (${parts.join(', ')})` : '';
+}
+function truncateForMessage(value) {
+    return value.length <= 120 ? value : `${value.slice(0, 117)}...`;
+}
+/**
+ * Java Modified UTF-8 byte length using Java's UTF-16 code-unit rules.
+ *
+ * This intentionally differs from standard UTF-8:
+ * - U+0000 is 2 bytes.
+ * - U+0001 through U+007F are 1 byte.
+ * - U+0080 through U+07FF are 2 bytes.
+ * - All other UTF-16 code units, including surrogate halves, are 3 bytes.
+ */
+export function javaModifiedUtf8ByteLength(value) {
+    let bytes = 0;
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code === 0) {
+            bytes += 2;
+        }
+        else if (code <= 0x7f) {
+            bytes += 1;
+        }
+        else if (code <= 0x07ff) {
+            bytes += 2;
+        }
+        else {
+            bytes += 3;
+        }
+    }
+    return bytes;
+}
+export function rdfLiteralTermMutf8ByteLength(term) {
+    if (!term.startsWith('"'))
+        return undefined;
+    return javaModifiedUtf8ByteLength(term);
+}
+export function isOversizedRdfLiteralError(err) {
+    if (err instanceof OversizedRdfLiteralError)
+        return true;
+    if (!err || typeof err !== 'object')
+        return false;
+    return err.code === OVERSIZED_RDF_LITERAL_ERROR_CODE;
+}
+export function assertRdfLiteralMutf8Safe(term, options = {}) {
+    const actualBytes = rdfLiteralTermMutf8ByteLength(term);
+    if (actualBytes === undefined)
+        return;
+    const maxBytes = options.maxBytes ?? DKG_RDF_LITERAL_SAFE_MUTF8_BYTES;
+    if (actualBytes <= maxBytes)
+        return;
+    throw new OversizedRdfLiteralError({
+        actualBytes,
+        maxBytes,
+        label: options.label,
+        subject: options.subject,
+        predicate: options.predicate,
+        graph: options.graph,
+    });
+}
+export function assertQuadLiteralsMutf8Safe(quads, options = {}) {
+    for (let i = 0; i < quads.length; i++) {
+        const q = quads[i];
+        assertRdfLiteralMutf8Safe(q.object, {
+            maxBytes: options.maxBytes,
+            label: options.label ? `${options.label}[${i}].object` : `quads[${i}].object`,
+            subject: q.subject,
+            predicate: q.predicate,
+            graph: q.graph,
+        });
+    }
+}
+//# sourceMappingURL=rdf-literal-size.js.map

package/dist/rdf-literal-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rdf-literal-size.js","sourceRoot":"","sources":["../src/rdf-literal-size.ts"],"names":[],"mappings":"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"}

package/dist/setup-network.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared "which network should a freshly set-up node use?" policy.
+ *
+ * Used by every config-writing entry point — `dkg init`, and the
+ * OpenClaw / Hermes / MCP `setup` flows (via {@link ensureDkgNodeConfig}) —
+ * so they agree on the default and on how to treat legacy nodes.
+ *
+ * Background: nothing historically wrote `config.networkConfig`, so every
+ * node relied on the runtime fallback `project.json#defaultNetwork`
+ * (= `testnet`). To make new nodes default to mainnet WITHOUT silently
+ * retargeting existing testnet nodes, setup now *persists* the selected
+ * network explicitly while the runtime fallback stays `testnet`. The rule
+ * below encodes that split:
+ *
+ *   - a genuinely fresh node    → {@link DEFAULT_SETUP_NETWORK} (mainnet-gnosis)
+ *   - a legacy node (config on
+ *     disk but no networkConfig) → {@link LEGACY_FALLBACK_NETWORK} (testnet),
+ *     preserving its current behaviour — no flip to a real-money chain
+ *   - a node that already chose  → keep its choice
+ *   - an explicit `--network` /
+ *     interactive answer         → wins outright
+ */
+/** The network a brand-new node is set up on when the operator doesn't choose. */
+export declare const DEFAULT_SETUP_NETWORK = "mainnet-gnosis";
+/**
+ * The network a pre-existing config WITHOUT an explicit `networkConfig`
+ * resolves to. Matches the runtime fallback (`project.json#defaultNetwork`)
+ * so a legacy node keeps running exactly where it was.
+ */
+export declare const LEGACY_FALLBACK_NETWORK = "testnet";
+/**
+ * Networks offered in the interactive `dkg init` prompt, in display order.
+ * `mainnet-neuroweb` is intentionally omitted until its network config is
+ * deployment-ready (its bundled config is still pre-deployment gated). The
+ * `--network` flag accepts any bundled, readiness-passing network name, so
+ * this list governs the menu only, not what is selectable.
+ */
+export declare const SELECTABLE_SETUP_NETWORKS: readonly ["mainnet-gnosis", "mainnet-base", "testnet"];
+export interface ResolveSetupNetworkNameOptions {
+    /**
+     * Operator's explicit choice — the `--network <name>` flag value or the
+     * interactive answer. When non-empty it wins over everything else.
+     */
+    explicit?: string | null;
+    /** The `networkConfig` already present in the existing config, if any. */
+    existingNetworkConfig?: string | null;
+    /**
+     * Whether a config file already existed on disk before this setup run.
+     * Distinguishes a fresh install (→ default mainnet) from a legacy node
+     * that never set a network (→ testnet, preserved).
+     *
+     * Fail-safe: only an explicit `false` (proven-fresh) selects the mainnet
+     * default; `true` OR `undefined` (the signal was not provided) resolves to
+     * the legacy testnet network, so a forgotten/ambiguous signal can never
+     * silently flip a node onto a real-money chain.
+     */
+    configExisted?: boolean;
+}
+/**
+ * Resolve the network name a setup flow should write into `config.networkConfig`.
+ * Pure + total — see the module docstring for the precedence rationale.
+ */
+export declare function resolveSetupNetworkName(opts: ResolveSetupNetworkNameOptions): string;
+//# sourceMappingURL=setup-network.d.ts.map

package/dist/setup-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-network.d.ts","sourceRoot":"","sources":["../src/setup-network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,wDAI5B,CAAC;AAEX,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,8BAA8B,GAAG,MAAM,CAUpF"}

package/dist/setup-network.js

@@ -0,0 +1,58 @@
+/**
+ * Shared "which network should a freshly set-up node use?" policy.
+ *
+ * Used by every config-writing entry point — `dkg init`, and the
+ * OpenClaw / Hermes / MCP `setup` flows (via {@link ensureDkgNodeConfig}) —
+ * so they agree on the default and on how to treat legacy nodes.
+ *
+ * Background: nothing historically wrote `config.networkConfig`, so every
+ * node relied on the runtime fallback `project.json#defaultNetwork`
+ * (= `testnet`). To make new nodes default to mainnet WITHOUT silently
+ * retargeting existing testnet nodes, setup now *persists* the selected
+ * network explicitly while the runtime fallback stays `testnet`. The rule
+ * below encodes that split:
+ *
+ *   - a genuinely fresh node    → {@link DEFAULT_SETUP_NETWORK} (mainnet-gnosis)
+ *   - a legacy node (config on
+ *     disk but no networkConfig) → {@link LEGACY_FALLBACK_NETWORK} (testnet),
+ *     preserving its current behaviour — no flip to a real-money chain
+ *   - a node that already chose  → keep its choice
+ *   - an explicit `--network` /
+ *     interactive answer         → wins outright
+ */
+/** The network a brand-new node is set up on when the operator doesn't choose. */
+export const DEFAULT_SETUP_NETWORK = 'mainnet-gnosis';
+/**
+ * The network a pre-existing config WITHOUT an explicit `networkConfig`
+ * resolves to. Matches the runtime fallback (`project.json#defaultNetwork`)
+ * so a legacy node keeps running exactly where it was.
+ */
+export const LEGACY_FALLBACK_NETWORK = 'testnet';
+/**
+ * Networks offered in the interactive `dkg init` prompt, in display order.
+ * `mainnet-neuroweb` is intentionally omitted until its network config is
+ * deployment-ready (its bundled config is still pre-deployment gated). The
+ * `--network` flag accepts any bundled, readiness-passing network name, so
+ * this list governs the menu only, not what is selectable.
+ */
+export const SELECTABLE_SETUP_NETWORKS = [
+    'mainnet-gnosis',
+    'mainnet-base',
+    'testnet',
+];
+/**
+ * Resolve the network name a setup flow should write into `config.networkConfig`.
+ * Pure + total — see the module docstring for the precedence rationale.
+ */
+export function resolveSetupNetworkName(opts) {
+    const explicit = opts.explicit?.trim();
+    if (explicit)
+        return explicit;
+    const existing = opts.existingNetworkConfig?.trim();
+    if (existing)
+        return existing;
+    // Fail-safe: only a proven-fresh node (configExisted === false) gets the
+    // mainnet default. true OR undefined stays on the legacy testnet network.
+    return opts.configExisted === false ? DEFAULT_SETUP_NETWORK : LEGACY_FALLBACK_NETWORK;
+}
+//# sourceMappingURL=setup-network.js.map

package/dist/setup-network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-network.js","sourceRoot":"","sources":["../src/setup-network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,gBAAgB;IAChB,cAAc;IACd,SAAS;CACD,CAAC;AAuBX;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAoC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IACpD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,yEAAyE;IACzE,0EAA0E;IAC1E,OAAO,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,uBAAuB,CAAC;AACxF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origintrail-official/dkg-core",
-  "version": "10.0.0",
+  "version": "10.0.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,11 +24,13 @@
     "@multiformats/multiaddr": "^13.0.3",
     "@noble/ed25519": "^3.1.0",
     "@noble/hashes": "^2.2.0",
+    "js-yaml": "^4.1.1",
     "libp2p": "^3.3.1",
     "protobufjs": "^8.3.0",
     "rdf-canonize": "^5.0.0"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@vitest/coverage-v8": "^4.0.18",
     "vitest": "^4.0.18"
   },