bulletin-deploy 0.7.12 → 0.7.13

package/dist/{chunk-VQJLGE5J.js → chunk-KU6N5DD3.js}

@@ -6,7 +6,7 @@ import * as path from "path";
 // package.json
 var package_default = {
   name: "bulletin-deploy",
-  version: "0.7.12",
+  version: "0.7.13",
   private: false,
   repository: {
     type: "git",
@@ -32,12 +32,15 @@ var package_default = {
   files: [
     "dist",
     "bin",
-    "docs"
+    "docs",
+    "assets"
   ],
   scripts: {
-    build: "tsup src/index.ts src/deploy.ts src/dotns.ts src/pool.ts src/telemetry.ts src/memory-report.ts src/merkle.ts src/gh-pages-mirror.ts src/version-check.ts src/bug-report.ts src/run-state.ts --format esm --dts --clean --target node22",
+    prebuild: "node scripts/refresh-environments.mjs",
+    build: "tsup src/index.ts src/deploy.ts src/dotns.ts src/pool.ts src/telemetry.ts src/memory-report.ts src/merkle.ts src/gh-pages-mirror.ts src/version-check.ts src/bug-report.ts src/run-state.ts src/environments.ts src/errors.ts --format esm --dts --clean --target node22",
+    "refresh-environments": "node scripts/refresh-environments.mjs",
     prepare: "npm run build",
-    test: "npm run build && node --test test/test.js test/cli-help.test.js test/helpers/e2e-helpers.test.js",
+    test: "npm run build && node --test test/test.js test/cli-help.test.js test/helpers/e2e-helpers.test.js test/environments.test.js",
     "test:e2e": "npm run build && node --test test/e2e.test.js",
     "test:e2e:smoke": "bash scripts/e2e-pass.sh smoke",
     "test:e2e:pr": "bash scripts/e2e-pass.sh pr",
@@ -48,12 +51,12 @@ var package_default = {
     "@ipld/car": "^5.4.3",
     "@ipld/dag-pb": "^4.1.3",
     "@noble/hashes": "^1.7.2",
-    "@parity/dotns-cli": "^0.6.0",
+    "@parity/dotns-cli": "^0.6.1",
     "@polkadot-api/substrate-bindings": "^0.16.5",
     "@polkadot-labs/hdkd": "^0.0.25",
     "@polkadot-labs/hdkd-helpers": "^0.0.26",
-    "@polkadot/keyring": "^13.0.0",
-    "@polkadot/util-crypto": "^13.0.0",
+    "@polkadot/keyring": "^14.0.1",
+    "@polkadot/util-crypto": "^14.0.1",
     "@sentry/node": "^9.14.0",
     "ipfs-unixfs": "^11.2.0",
     "ipfs-unixfs-importer": "^16.1.4",

package/dist/{chunk-LOZ5PSD3.js → chunk-MRB5E7YM.js}

@@ -1,7 +1,7 @@
 import {
   package_default,
   writeRunState
-} from "./chunk-VQJLGE5J.js";
+} from "./chunk-KU6N5DD3.js";
 
 // src/memory-report.ts
 import * as fs2 from "fs";
@@ -277,10 +277,10 @@ function sampleMemory(stage) {
     console.error(`[sampleMemory] stage=${stage} active=${active ? active.description ?? active.name ?? "?" : "null"} rss=${toMb(m.rss)}MB`);
   }
   if (active) {
-    active.setAttribute(`mem.${stage}.rss_mb`, String(toMb(m.rss)));
-    active.setAttribute(`mem.${stage}.heap_used_mb`, String(toMb(m.heapUsed)));
-    active.setAttribute(`mem.${stage}.external_mb`, String(toMb(m.external)));
-    active.setAttribute(`mem.${stage}.array_buffers_mb`, String(toMb(m.arrayBuffers)));
+    active.setAttribute(`mem.${stage}.rss_bytes`, m.rss);
+    active.setAttribute(`mem.${stage}.heap_used_bytes`, m.heapUsed);
+    active.setAttribute(`mem.${stage}.external_bytes`, m.external);
+    active.setAttribute(`mem.${stage}.array_buffers_bytes`, m.arrayBuffers);
   }
   stageSamples[stage] = sampleFromBytes(m);
   if (memoryPeak) {
@@ -289,10 +289,10 @@ function sampleMemory(stage) {
     if (m.external > memoryPeak.external) memoryPeak.external = m.external;
     if (m.arrayBuffers > memoryPeak.arrayBuffers) memoryPeak.arrayBuffers = m.arrayBuffers;
     if (deployRootSpan) {
-      deployRootSpan.setAttribute("deploy.mem.peak_rss_mb", String(toMb(memoryPeak.rss)));
-      deployRootSpan.setAttribute("deploy.mem.peak_heap_used_mb", String(toMb(memoryPeak.heapUsed)));
-      deployRootSpan.setAttribute("deploy.mem.peak_external_mb", String(toMb(memoryPeak.external)));
-      deployRootSpan.setAttribute("deploy.mem.peak_array_buffers_mb", String(toMb(memoryPeak.arrayBuffers)));
+      deployRootSpan.setAttribute("deploy.mem.peak_rss_bytes", memoryPeak.rss);
+      deployRootSpan.setAttribute("deploy.mem.peak_heap_used_bytes", memoryPeak.heapUsed);
+      deployRootSpan.setAttribute("deploy.mem.peak_external_bytes", memoryPeak.external);
+      deployRootSpan.setAttribute("deploy.mem.peak_array_buffers_bytes", memoryPeak.arrayBuffers);
     }
   }
   if (runStateActive && memoryPeak) {

package/dist/{chunk-7WKHLBZA.js → chunk-RBFXJVAG.js}

@@ -1,11 +1,11 @@
+import {
+  isTestnetSpecName
+} from "./chunk-VOEFHED3.js";
 import {
   captureWarning,
   setDeployAttribute,
   withSpan
-} from "./chunk-LOZ5PSD3.js";
-import {
-  isTestnetSpecName
-} from "./chunk-VOEFHED3.js";
+} from "./chunk-MRB5E7YM.js";
 
 // src/dotns.ts
 import { spawn } from "child_process";
@@ -35,17 +35,56 @@ import {
 import { CID } from "multiformats/cid";
 import { createRequire } from "module";
 var _require = createRequire(import.meta.url);
-var _dotnsCliPath;
-var _dotnsCliVersion;
-try {
-  _dotnsCliPath = _require.resolve("@parity/dotns-cli");
-  const pkgDir = dirname(dirname(_dotnsCliPath));
+var DOTNS_CLI_ENV = "BULLETIN_DEPLOY_DOTNS_CLI";
+var DOTNS_CLI_HOST_VALUES = /* @__PURE__ */ new Set(["host", "host-dispatch"]);
+function resolveDotnsCliPackage() {
+  const cliPath = _require.resolve("@parity/dotns-cli");
+  const pkgDir = dirname(dirname(cliPath));
   const pkg = JSON.parse(readFileSync(join(pkgDir, "package.json"), "utf-8"));
-  _dotnsCliVersion = pkg.version;
-} catch (err) {
-  _dotnsCliVersion = "unknown";
-  _dotnsCliPath = "dotns";
-  console.warn(`[bulletin-deploy] @parity/dotns-cli not found in node_modules \u2014 falling back to "dotns" in PATH. Install with: npm install @parity/dotns-cli. Underlying: ${err.message}`);
+  return { path: cliPath, version: pkg.version };
+}
+function resolveDotnsCliInvocation(env = process.env, packageResolver = resolveDotnsCliPackage) {
+  const override = env[DOTNS_CLI_ENV]?.trim();
+  if (override) {
+    if (DOTNS_CLI_HOST_VALUES.has(override)) {
+      return { command: process.execPath, argsPrefix: ["dotns"], version: "host-dispatch", source: "host-dispatch" };
+    }
+    return { command: override, argsPrefix: [], version: "override", source: "command-override" };
+  }
+  try {
+    const pkg = packageResolver();
+    return { command: process.execPath, argsPrefix: [pkg.path], version: pkg.version, source: "package" };
+  } catch (err) {
+    return {
+      command: process.execPath,
+      argsPrefix: ["dotns"],
+      version: "unknown",
+      source: "host-dispatch-fallback",
+      resolutionError: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
+function describeDotnsCliInvocation(cli) {
+  if (cli.source === "package") return `${cli.command} ${cli.argsPrefix[0]}`;
+  if (cli.source === "command-override") return `${cli.command} (from ${DOTNS_CLI_ENV})`;
+  return `${cli.command} dotns`;
+}
+function dotnsCliFailureHint(cli) {
+  if (cli.source === "host-dispatch-fallback") {
+    return `@parity/dotns-cli was not resolvable from node_modules, so bulletin-deploy tried host binary dispatch (${process.execPath} dotns ...). Set ${DOTNS_CLI_ENV}=host to opt into that path explicitly, set ${DOTNS_CLI_ENV} to a dotns command/path, or install @parity/dotns-cli. Underlying resolution error: ${cli.resolutionError ?? "unknown"}`;
+  }
+  if (cli.source === "host-dispatch") {
+    return `${DOTNS_CLI_ENV}=host uses host binary dispatch (${process.execPath} dotns ...).`;
+  }
+  if (cli.source === "command-override") {
+    return `${DOTNS_CLI_ENV} uses a direct command/path (${cli.command}).`;
+  }
+  return null;
+}
+function withDotnsCliFailureHint(message, cli) {
+  const hint = dotnsCliFailureHint(cli);
+  return hint ? `${message}
+${hint}` : message;
 }
 var ONE_PAS = 10000000000n;
 var FEE_FLOOR_OWNED = ONE_PAS / 100n;
@@ -597,7 +636,13 @@ var ReviveClientWrapper = class _ReviveClientWrapper {
 };
 async function runDotnsCli(argv, env) {
   return new Promise((resolve, reject) => {
-    const proc = spawn(process.execPath, [_dotnsCliPath, ...argv], {
+    const cli = resolveDotnsCliInvocation();
+    try {
+      setDeployAttribute("deploy.dotns_cli.version", cli.version);
+      setDeployAttribute("deploy.dotns_cli.source", cli.source);
+    } catch {
+    }
+    const proc = spawn(cli.command, [...cli.argsPrefix, ...argv], {
       stdio: ["ignore", "pipe", "pipe"],
       env: { ...process.env, ...env }
     });
@@ -635,9 +680,9 @@ async function runDotnsCli(argv, env) {
       } else if (out) {
         errorMsg = out.slice(0, 500);
       }
-      reject(new Error(errorMsg));
+      reject(new Error(withDotnsCliFailureHint(errorMsg, cli)));
     });
-    proc.on("error", (err) => reject(new Error(`Failed to spawn dotns CLI: ${err.message}`)));
+    proc.on("error", (err) => reject(new Error(withDotnsCliFailureHint(`Failed to spawn DotNS CLI via ${describeDotnsCliInvocation(cli)}: ${err.message}`, cli))));
   });
 }
 function buildAuthEnv(opts) {
@@ -660,6 +705,10 @@ var DotNS = class {
   evmAddress;
   signer;
   connected;
+  // Per-instance failover list. Populated from options.assetHubEndpoints when
+  // bulletin-deploy resolves the asset-hub list via environments.json; falls
+  // back to the legacy paseo-only RPC_ENDPOINTS for direct library callers.
+  assetHubEndpoints;
   // Stored credentials for CLI subprocess calls. Never logged or exposed.
   _mnemonic = null;
   _keyUri = null;
@@ -672,9 +721,13 @@ var DotNS = class {
     this.evmAddress = null;
     this.signer = null;
     this.connected = false;
+    this.assetHubEndpoints = RPC_ENDPOINTS;
   }
   async connect(options = {}) {
-    const rpc = options.rpc || process.env.DOTNS_RPC || RPC_ENDPOINTS[0];
+    if (options.assetHubEndpoints && options.assetHubEndpoints.length > 0) {
+      this.assetHubEndpoints = options.assetHubEndpoints;
+    }
+    const rpc = options.rpc || process.env.DOTNS_RPC || this.assetHubEndpoints[0];
     this.rpc = rpc;
     this._usesExternalSigner = Boolean(options.signer && options.signerAddress);
     let authEnv = {};
@@ -740,10 +793,6 @@ var DotNS = class {
       }
     }
     console.log(`   Account: mapped`);
-    try {
-      setDeployAttribute("deploy.dotns_cli.version", _dotnsCliVersion);
-    } catch {
-    }
     this.connected = true;
     return this;
   }
@@ -914,7 +963,7 @@ var DotNS = class {
     this.ensureConnected();
     if (!this.clientWrapper) throw new Error("contractTransaction: polkadot-api client not available");
     const encodedCallData = encodeFunctionData({ abi: contractAbi, functionName, args });
-    const rpcs = this.rpc ? [this.rpc, ...RPC_ENDPOINTS.filter((ep) => ep !== this.rpc)] : RPC_ENDPOINTS;
+    const rpcs = this.rpc ? [this.rpc, ...this.assetHubEndpoints.filter((ep) => ep !== this.rpc)] : this.assetHubEndpoints;
     return await withTimeout(
       this.clientWrapper.submitTransaction(contractAddress, value, encodedCallData, this.substrateAddress, this.signer, statusCallback, { rpcs, useNoncePolling, functionName, args }),
       OPERATION_TIMEOUT_MS,
@@ -1574,6 +1623,7 @@ var DotNS = class {
 var dotns = new DotNS();
 
 export {
+  resolveDotnsCliInvocation,
   fmtPas,
   feeFloorFor,
   RPC_ENDPOINTS,

package/dist/{chunk-RVCY2VEY.js → chunk-TTSFL3JB.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-LOZ5PSD3.js";
+} from "./chunk-MRB5E7YM.js";
 
 // src/version-check.ts
 import { execSync, execFileSync } from "child_process";

package/dist/{chunk-N2OZLFJA.js → chunk-Y54W6NVZ.js}

@@ -2,11 +2,11 @@ import {
   classifyErrorArea,
   isInteractive,
   promptYesNo
-} from "./chunk-RVCY2VEY.js";
+} from "./chunk-TTSFL3JB.js";
 import {
   VERSION,
   getCurrentSentryTraceId
-} from "./chunk-LOZ5PSD3.js";
+} from "./chunk-MRB5E7YM.js";
 
 // src/bug-report.ts
 import { execSync, execFileSync } from "child_process";

package/dist/{chunk-WK2GKDMX.js → chunk-YX5USCHH.js}

@@ -1,6 +1,9 @@
+import {
+  merkleizeJS
+} from "./chunk-B7GUYYAN.js";
 import {
   setDeployContext
-} from "./chunk-N2OZLFJA.js";
+} from "./chunk-Y54W6NVZ.js";
 import {
   DotNS,
   TX_TIMEOUT_MS,
@@ -8,7 +11,23 @@ import {
   parseDomainName,
   popStatusName,
   verifyNonceAdvanced
-} from "./chunk-7WKHLBZA.js";
+} from "./chunk-RBFXJVAG.js";
+import {
+  derivePoolAccounts,
+  detectTestnet,
+  ensureAuthorized,
+  fetchPoolAuthorizations,
+  selectAccount,
+  topUpBy
+} from "./chunk-VOEFHED3.js";
+import {
+  DEFAULT_ENV_ID,
+  loadEnvironments,
+  resolveEndpoints
+} from "./chunk-2VYG7NXN.js";
+import {
+  NonRetryableError
+} from "./chunk-ZOC4GITL.js";
 import {
   MirrorSkipped,
   mirrorToGitHubPages,
@@ -27,18 +46,7 @@ import {
   truncateAddress,
   withDeploySpan,
   withSpan
-} from "./chunk-LOZ5PSD3.js";
-import {
-  merkleizeJS
-} from "./chunk-B7GUYYAN.js";
-import {
-  derivePoolAccounts,
-  detectTestnet,
-  ensureAuthorized,
-  fetchPoolAuthorizations,
-  selectAccount,
-  topUpBy
-} from "./chunk-VOEFHED3.js";
+} from "./chunk-MRB5E7YM.js";
 
 // src/deploy.ts
 import { Buffer } from "buffer";
@@ -61,13 +69,6 @@ import { cryptoWaitReady } from "@polkadot/util-crypto";
 import { getPolkadotSigner } from "polkadot-api/signer";
 import { sr25519CreateDerive } from "@polkadot-labs/hdkd";
 import { mnemonicToEntropy, entropyToMiniSecret, ss58Address } from "@polkadot-labs/hdkd-helpers";
-var NonRetryableError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "NonRetryableError";
-  }
-};
-var EXIT_CODE_NO_RETRY = 78;
 function friendlyChainError(msg) {
   if (/"type":\s*"Invalid"[\s\S]*?"type":\s*"Payment"/i.test(msg)) {
     return "Bulletin quota exhausted (signed extension rejected the tx \u2014 signer is out of allowed txs or bytes; grant quota on-chain)";
@@ -368,6 +369,7 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
       throw new Error(`Connection lost and max reconnections (${MAX_RECONNECTIONS}) exhausted`);
     }
     reconnectionsUsed++;
+    setDeployAttribute("deploy.reconnects", reconnectionsUsed);
     const delay = Math.min(RETRY_BASE_DELAY_MS * Math.pow(2, reconnectionsUsed - 1), RETRY_MAX_DELAY_MS);
     console.log(`
    Connection lost, reconnecting to Bulletin in ${(delay / 1e3).toFixed(0)}s (${reconnectionsUsed}/${MAX_RECONNECTIONS})...`);
@@ -639,7 +641,7 @@ async function storeDirectory(directoryPath, providerOrOptions = {}, password, j
     totalSize: `${(carContent.length / 1024 / 1024).toFixed(2)} MB`
   });
   const carMb = String(Math.round(carContent.length / 1024 / 1024 * 100) / 100);
-  const storageCid = await withSpan("deploy.chunk-upload", "1b. chunk-upload", { "deploy.chunks.total": String(carChunks.length), "deploy.car.bytes": String(carContent.length), "deploy.car.mb": carMb }, async () => {
+  const storageCid = await withSpan("deploy.chunk-upload", "1b. chunk-upload", { "deploy.chunks.total": carChunks.length, "deploy.car.bytes": carContent.length, "deploy.car.mb": carMb }, async () => {
     sampleMemory("chunk_upload_start");
     const r = await storeChunkedContent(carChunks, provider);
     sampleMemory("chunk_upload_end");
@@ -653,11 +655,12 @@ async function storeDirectory(directoryPath, providerOrOptions = {}, password, j
   }
   return { storageCid, ipfsCid, carBytes: carContent };
 }
-function resolveDotnsConnectOptions(options) {
+function resolveDotnsConnectOptions(options, assetHubEndpoints) {
+  const tail = assetHubEndpoints && assetHubEndpoints.length > 0 ? { assetHubEndpoints } : {};
   if (options.signer && options.signerAddress) {
-    return { signer: options.signer, signerAddress: options.signerAddress };
+    return { signer: options.signer, signerAddress: options.signerAddress, ...tail };
   }
-  return { mnemonic: options.mnemonic, derivationPath: options.derivationPath };
+  return { mnemonic: options.mnemonic, derivationPath: options.derivationPath, ...tail };
 }
 async function estimateUploadBytes(content) {
   try {
@@ -686,8 +689,29 @@ async function estimateUploadBytes(content) {
   }
 }
 async function deploy(content, domainName = null, options = {}) {
+  const envId = options.env ?? DEFAULT_ENV_ID;
+  let envBulletin = [DEFAULT_BULLETIN_RPC];
+  let envAssetHub;
+  let envSource;
+  let envNetwork;
+  if (options.bulletinEndpoints && options.bulletinEndpoints.length > 0) {
+    envBulletin = options.bulletinEndpoints;
+    envAssetHub = options.assetHubEndpoints;
+  } else {
+    try {
+      const { doc, source } = await loadEnvironments();
+      const resolved = resolveEndpoints(doc, envId);
+      envBulletin = resolved.bulletin;
+      envAssetHub = options.assetHubEndpoints ?? resolved.assetHub;
+      envSource = source;
+      envNetwork = resolved.network;
+    } catch (e) {
+      if (e instanceof NonRetryableError) throw e;
+      captureWarning(`environments load failed: ${e?.message ?? e}`);
+    }
+  }
   const userRpc = options.rpc ?? process.env.BULLETIN_RPC;
-  BULLETIN_ENDPOINTS = userRpc ? [userRpc, ...[DEFAULT_BULLETIN_RPC].filter((e) => e !== userRpc)] : [DEFAULT_BULLETIN_RPC];
+  BULLETIN_ENDPOINTS = userRpc ? [userRpc, ...envBulletin.filter((e) => e !== userRpc)] : envBulletin;
   _deployRpcFailedOver = false;
   POOL_SIZE = options.poolSize ?? parseInt(process.env.BULLETIN_POOL_SIZE ?? String(DEFAULT_POOL_SIZE), 10);
   initTelemetry();
@@ -700,6 +724,9 @@ async function deploy(content, domainName = null, options = {}) {
       setDeployAttribute("deploy.tag", deployTag);
       setDeploySentryTag("deploy.tag", deployTag);
     }
+    setDeployAttribute("deploy.env", envId);
+    if (envNetwork) setDeployAttribute("deploy.network", envNetwork);
+    if (envSource) setDeployAttribute("deploy.environments_source", envSource);
     let cid;
     let ipfsCid;
     let mirrorPromise = Promise.resolve(null);
@@ -719,7 +746,7 @@ async function deploy(content, domainName = null, options = {}) {
       console.log("Preflight");
       console.log("=".repeat(60));
       const preflight = new DotNS();
-      await preflight.connect(resolveDotnsConnectOptions(options));
+      await preflight.connect(resolveDotnsConnectOptions(options, envAssetHub));
       if (parsed?.isSubdomain) {
         try {
           const { owned: subOwned } = await preflight.checkSubdomainOwnership(parsed.sublabel, parsed.parentLabel);
@@ -868,7 +895,7 @@ async function deploy(content, domainName = null, options = {}) {
       console.log("=".repeat(60));
       await withSpan("deploy.dotns", "2. dotns", { "deploy.domain": name, "deploy.subdomain": String(parsed?.isSubdomain ?? false) }, async () => {
         const dotns = new DotNS();
-        await dotns.connect(resolveDotnsConnectOptions(options));
+        await dotns.connect(resolveDotnsConnectOptions(options, envAssetHub));
         if (parsed?.isSubdomain) {
           const { owned, owner } = await dotns.checkSubdomainOwnership(parsed.sublabel, parsed.parentLabel);
           if (owned) {
@@ -950,8 +977,6 @@ async function deploy(content, domainName = null, options = {}) {
 }
 
 export {
-  NonRetryableError,
-  EXIT_CODE_NO_RETRY,
   friendlyChainError,
   DEFAULT_BULLETIN_RPC,
   DEFAULT_POOL_SIZE,

package/dist/chunk-ZOC4GITL.js

@@ -0,0 +1,13 @@
+// src/errors.ts
+var NonRetryableError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "NonRetryableError";
+  }
+};
+var EXIT_CODE_NO_RETRY = 78;
+
+export {
+  NonRetryableError,
+  EXIT_CODE_NO_RETRY
+};

package/dist/deploy.d.ts

@@ -1,5 +1,6 @@
 import { CID } from 'multiformats/cid';
 import { PolkadotSigner } from 'polkadot-api';
+export { EXIT_CODE_NO_RETRY, NonRetryableError } from './errors.js';
 
 interface DeployResult {
     domainName: string;
@@ -8,10 +9,7 @@ interface DeployResult {
     ipfsCid?: string;
 }
 type DeployContent = string | Uint8Array | Uint8Array[];
-declare class NonRetryableError extends Error {
-    constructor(message: string);
-}
-declare const EXIT_CODE_NO_RETRY = 78;
+
 declare function friendlyChainError(msg: string): string;
 interface ProviderResult {
     client: any;
@@ -105,14 +103,30 @@ interface DeployOptions {
     name?: string;
     /** When set, writes the "description" text record. ≤100 chars recommended for host-app cards. */
     description?: string;
+    /**
+     * Environment id from environments.json (e.g. "paseo-next", "paseo-review").
+     * Drives both the bulletin RPC and the asset-hub RPC. Defaults to
+     * DEFAULT_ENV_ID. `--rpc` / BULLETIN_RPC still override the bulletin endpoint
+     * within the chosen env.
+     */
+    env?: string;
+    /**
+     * Pre-resolved bulletin endpoints (escape hatch for tests / library callers
+     * that want to skip environments.json loading). When provided, the loader
+     * is not called and `env` is ignored.
+     */
+    bulletinEndpoints?: string[];
+    /** Pre-resolved asset-hub endpoints. Same escape-hatch semantics. */
+    assetHubEndpoints?: string[];
 }
-declare function resolveDotnsConnectOptions(options: Pick<DeployOptions, "mnemonic" | "derivationPath" | "signer" | "signerAddress">): {
+declare function resolveDotnsConnectOptions(options: Pick<DeployOptions, "mnemonic" | "derivationPath" | "signer" | "signerAddress">, assetHubEndpoints?: string[]): {
     signer?: PolkadotSigner;
     signerAddress?: string;
     mnemonic?: string;
     derivationPath?: string;
+    assetHubEndpoints?: string[];
 };
 declare function estimateUploadBytes(content: DeployContent): Promise<number | null>;
 declare function deploy(content: DeployContent, domainName?: string | null, options?: DeployOptions): Promise<DeployResult>;
 
-export { CHUNK_MORTALITY_PERIOD, DEFAULT_BULLETIN_RPC, DEFAULT_POOL_SIZE, type DeployContent, type DeployOptions, type DeployResult, ENCRYPT_KEY_LEN, ENCRYPT_MAGIC, ENCRYPT_NONCE_LEN, ENCRYPT_PBKDF2_ITERATIONS, ENCRYPT_SALT_LEN, ENCRYPT_TAG_LEN, EXIT_CODE_NO_RETRY, NonRetryableError, type StoreDirectoryOptions, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, isConnectionError, merkleize, resolveDotnsConnectOptions, storeChunkedContent, storeDirectory, storeFile };
+export { CHUNK_MORTALITY_PERIOD, DEFAULT_BULLETIN_RPC, DEFAULT_POOL_SIZE, type DeployContent, type DeployOptions, type DeployResult, ENCRYPT_KEY_LEN, ENCRYPT_MAGIC, ENCRYPT_NONCE_LEN, ENCRYPT_PBKDF2_ITERATIONS, ENCRYPT_SALT_LEN, ENCRYPT_TAG_LEN, type StoreDirectoryOptions, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, isConnectionError, merkleize, resolveDotnsConnectOptions, storeChunkedContent, storeDirectory, storeFile };

package/dist/deploy.js

@@ -8,8 +8,6 @@ import {
   ENCRYPT_PBKDF2_ITERATIONS,
   ENCRYPT_SALT_LEN,
   ENCRYPT_TAG_LEN,
-  EXIT_CODE_NO_RETRY,
-  NonRetryableError,
   chunk,
   computeStorageCid,
   createCID,
@@ -26,15 +24,20 @@ import {
   storeChunkedContent,
   storeDirectory,
   storeFile
-} from "./chunk-WK2GKDMX.js";
-import "./chunk-N2OZLFJA.js";
-import "./chunk-RVCY2VEY.js";
-import "./chunk-7WKHLBZA.js";
-import "./chunk-HOTQDYHD.js";
-import "./chunk-LOZ5PSD3.js";
-import "./chunk-VQJLGE5J.js";
+} from "./chunk-YX5USCHH.js";
 import "./chunk-B7GUYYAN.js";
+import "./chunk-Y54W6NVZ.js";
+import "./chunk-TTSFL3JB.js";
+import "./chunk-RBFXJVAG.js";
 import "./chunk-VOEFHED3.js";
+import "./chunk-2VYG7NXN.js";
+import {
+  EXIT_CODE_NO_RETRY,
+  NonRetryableError
+} from "./chunk-ZOC4GITL.js";
+import "./chunk-HOTQDYHD.js";
+import "./chunk-MRB5E7YM.js";
+import "./chunk-KU6N5DD3.js";
 import "./chunk-QGM4M3NI.js";
 export {
   CHUNK_MORTALITY_PERIOD,

package/dist/dotns.d.ts

@@ -1,12 +1,33 @@
 import { PolkadotSigner } from 'polkadot-api';
 
+type DotnsCliInvocationSource = "package" | "host-dispatch" | "host-dispatch-fallback" | "command-override";
+interface DotnsCliInvocation {
+    command: string;
+    argsPrefix: string[];
+    version: string;
+    source: DotnsCliInvocationSource;
+    resolutionError?: string;
+}
+interface DotnsCliPackageResolution {
+    path: string;
+    version: string;
+}
+declare function resolveDotnsCliInvocation(env?: NodeJS.ProcessEnv | Record<string, string | undefined>, packageResolver?: () => DotnsCliPackageResolution): DotnsCliInvocation;
 interface DotNSConnectOptions {
     rpc?: string;
     keyUri?: string;
     mnemonic?: string;
     derivationPath?: string;
     signer?: PolkadotSigner;
-    signerAddress?: string;
+    signerAddress?: string; /**
+       * Optional override for the Asset Hub RPC failover list. When provided, the
+       * primary RPC (this.rpc) is followed by these endpoints for retries. When
+       * omitted, the legacy hardcoded RPC_ENDPOINTS list (paseo) is used —
+       * preserves backwards-compatibility for external library consumers. The
+       * bulletin-deploy CLI passes the list resolved from environments.json so
+       * `--env <id>` drives both bulletin and asset-hub endpoints.
+       */
+    assetHubEndpoints?: string[];
 }
 interface OwnershipResult {
     owned: boolean;
@@ -157,6 +178,7 @@ declare class DotNS {
     evmAddress: string | null;
     signer: PolkadotSigner | null;
     connected: boolean;
+    assetHubEndpoints: string[];
     private _mnemonic;
     private _keyUri;
     private _usesExternalSigner;
@@ -219,4 +241,4 @@ declare class DotNS {
 }
 declare const dotns: DotNS;
 
-export { CONNECTION_TIMEOUT_MS, CONTRACTS, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsPreflightResult, type DotnsSuccessAction, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, WS_HEARTBEAT_TIMEOUT_MS, canRegister, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertWeiToNative, countTrailingDigits, dotns, feeFloorFor, fetchNonce, fmtPas, isCommitmentMature, isExplicitCommitmentBuffer, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, runDotnsCli, sanitizeDomainLabel, simulateUserStatus, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };
+export { CONNECTION_TIMEOUT_MS, CONTRACTS, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsCliInvocation, type DotnsCliInvocationSource, type DotnsPreflightResult, type DotnsSuccessAction, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, WS_HEARTBEAT_TIMEOUT_MS, canRegister, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertWeiToNative, countTrailingDigits, dotns, feeFloorFor, fetchNonce, fmtPas, isCommitmentMature, isExplicitCommitmentBuffer, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, resolveDotnsCliInvocation, runDotnsCli, sanitizeDomainLabel, simulateUserStatus, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };

package/dist/dotns.js

@@ -29,16 +29,17 @@ import {
   parseDomainName,
   parseProofOfPersonhoodStatus,
   popStatusName,
+  resolveDotnsCliInvocation,
   runDotnsCli,
   sanitizeDomainLabel,
   simulateUserStatus,
   stripTrailingDigits,
   validateDomainLabel,
   verifyNonceAdvanced
-} from "./chunk-7WKHLBZA.js";
-import "./chunk-LOZ5PSD3.js";
-import "./chunk-VQJLGE5J.js";
+} from "./chunk-RBFXJVAG.js";
 import "./chunk-VOEFHED3.js";
+import "./chunk-MRB5E7YM.js";
+import "./chunk-KU6N5DD3.js";
 import "./chunk-QGM4M3NI.js";
 export {
   CONNECTION_TIMEOUT_MS,
@@ -71,6 +72,7 @@ export {
   parseDomainName,
   parseProofOfPersonhoodStatus,
   popStatusName,
+  resolveDotnsCliInvocation,
   runDotnsCli,
   sanitizeDomainLabel,
   simulateUserStatus,