bulletin-deploy 0.7.4 → 0.7.6

package/bin/bulletin-deploy

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 
 import { deploy, DEFAULT_BULLETIN_RPC, DEFAULT_POOL_SIZE, NonRetryableError, EXIT_CODE_NO_RETRY } from "../dist/deploy.js";
-import { bootstrapPool } from "../dist/pool.js";
 import { VERSION, setDeployAttribute, captureWarning, closeTelemetry, setRunStateActive, markRelaunchOomHintShown } from "../dist/telemetry.js";
 import { handleFailedDeploy, preReleaseWarning } from "../dist/version-check.js";
 import { setDeployContext, installLogCapture, buildCliFlagsSummary } from "../dist/bug-report.js";
@@ -17,7 +16,7 @@ const args = process.argv.slice(2);
 const flags = {};
 const positional = [];
 for (let i = 0; i < args.length; i++) {
-  if (args[i] === "--bootstrap") { flags.bootstrap = true; }
+  if (args[i] === "--bootstrap") { flags.removedBootstrap = true; }
   else if (args[i] === "--pool-size") { flags.poolSize = parseInt(args[++i], 10); }
   else if (args[i] === "--mnemonic") { flags.mnemonic = args[++i]; }
   else if (args[i] === "--derivation-path") { flags.derivationPath = args[++i]; }
@@ -36,12 +35,16 @@ if (flags.version) {
   process.exit(0);
 }
 
-if (flags.help || (positional.length === 0 && !flags.bootstrap)) {
+if (flags.removedBootstrap) {
+  console.error("Error: --bootstrap was removed from bulletin-deploy. Use bulletin-bootstrap instead.");
+  process.exit(1);
+}
+
+if (flags.help || positional.length === 0) {
   console.log(`bulletin-deploy v${VERSION}
 
 Usage:
   bulletin-deploy <build-dir> <domain.dot>  Deploy an app
-  bulletin-deploy --bootstrap               Initialize pool accounts
 
 Options:
   --mnemonic "..."         DotNS owner mnemonic (or set MNEMONIC env var)
@@ -62,10 +65,9 @@ const rcWarning = preReleaseWarning(VERSION);
 if (rcWarning) console.error(rcWarning);
 
 // ── Crash capture (issue #154) ───────────────────────────────────
-// Only wire crash capture for actual deploy / bootstrap runs — skip for
-// --help / --version (which exit above) and --bootstrap (one-off ops op,
-// no background work worth hinting OOM for).
-if (!flags.help && !flags.version && !flags.bootstrap) {
+// Only wire crash capture for actual deploy runs — skip for --help / --version
+// (which exit above).
+if (!flags.help && !flags.version) {
   // Sanitised argv — positional args + presence-only flag summary. Never
   // puts a mnemonic/password/RPC/derivation-path on disk, even if the user
   // passes one on the command line.
@@ -148,58 +150,52 @@ if (!flags.help && !flags.version && !flags.bootstrap) {
 }
 
 try {
-  if (flags.bootstrap) {
-    const rpc = flags.rpc ?? process.env.BULLETIN_RPC ?? DEFAULT_BULLETIN_RPC;
-    const poolSize = flags.poolSize ?? parseInt(process.env.BULLETIN_POOL_SIZE ?? String(DEFAULT_POOL_SIZE), 10);
-    await bootstrapPool(rpc, poolSize, flags.mnemonic);
-  } else {
-    const [buildDir, domain] = positional;
-    if (!buildDir) { console.error("Error: build directory required"); process.exit(1); }
-    if (!domain) { console.error("Error: domain required (e.g. my-app.dot)"); process.exit(1); }
-    if (!fs.existsSync(buildDir)) { console.error(`Error: ${buildDir} does not exist`); process.exit(1); }
-
-    const effectiveRpc = flags.rpc ?? process.env.BULLETIN_RPC ?? DEFAULT_BULLETIN_RPC;
-    const deployTag = flags.tag ?? process.env.DEPLOY_TAG;
-    const ci = process.env.GITHUB_ACTIONS === "true" ? {
-      runUrl: process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY && process.env.GITHUB_RUN_ID
-        ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}${process.env.GITHUB_RUN_ATTEMPT ? `/attempts/${process.env.GITHUB_RUN_ATTEMPT}` : ""}`
-        : undefined,
-      workflow: process.env.GITHUB_WORKFLOW,
-      job: process.env.GITHUB_JOB,
-      sha: process.env.GITHUB_SHA,
-    } : undefined;
-    setDeployContext({
-      domain,
-      rpc: effectiveRpc,
-      repo: process.env.GITHUB_REPOSITORY,
-      branch: process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME,
-      signerMode: flags.mnemonic ? "direct" : "pool",
-      deployTag,
-      cliFlags: buildCliFlagsSummary(flags),
-      ci,
-    });
-
-    const result = await deploy(buildDir, domain, {
-      mnemonic: flags.mnemonic,
-      derivationPath: flags.derivationPath,
-      rpc: flags.rpc,
-      poolSize: flags.poolSize,
-      password: flags.password,
-      jsMerkle: flags.jsMerkle,
-      tag: flags.tag,
-      ghPagesMirror: flags.ghPagesMirror,
-    });
-
-    const output = process.env.GITHUB_OUTPUT;
-    if (output) {
-      fs.appendFileSync(output, `cid=${result.cid}\n`);
-      fs.appendFileSync(output, `domain=${result.domainName}\n`);
-    }
+  const [buildDir, domain] = positional;
+  if (!buildDir) { console.error("Error: build directory required"); process.exit(1); }
+  if (!domain) { console.error("Error: domain required (e.g. my-app.dot)"); process.exit(1); }
+  if (!fs.existsSync(buildDir)) { console.error(`Error: ${buildDir} does not exist`); process.exit(1); }
+
+  const effectiveRpc = flags.rpc ?? process.env.BULLETIN_RPC ?? DEFAULT_BULLETIN_RPC;
+  const deployTag = flags.tag ?? process.env.DEPLOY_TAG;
+  const ci = process.env.GITHUB_ACTIONS === "true" ? {
+    runUrl: process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY && process.env.GITHUB_RUN_ID
+      ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}${process.env.GITHUB_RUN_ATTEMPT ? `/attempts/${process.env.GITHUB_RUN_ATTEMPT}` : ""}`
+      : undefined,
+    workflow: process.env.GITHUB_WORKFLOW,
+    job: process.env.GITHUB_JOB,
+    sha: process.env.GITHUB_SHA,
+  } : undefined;
+  setDeployContext({
+    domain,
+    rpc: effectiveRpc,
+    repo: process.env.GITHUB_REPOSITORY,
+    branch: process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME,
+    signerMode: flags.mnemonic ? "direct" : "pool",
+    deployTag,
+    cliFlags: buildCliFlagsSummary(flags),
+    ci,
+  });
 
-    console.log(`CID: ${result.cid}`);
-    console.log(`Domain: ${result.domainName}`);
+  const result = await deploy(buildDir, domain, {
+    mnemonic: flags.mnemonic,
+    derivationPath: flags.derivationPath,
+    rpc: flags.rpc,
+    poolSize: flags.poolSize,
+    password: flags.password,
+    jsMerkle: flags.jsMerkle,
+    tag: flags.tag,
+    ghPagesMirror: flags.ghPagesMirror,
+  });
+
+  const output = process.env.GITHUB_OUTPUT;
+  if (output) {
+    fs.appendFileSync(output, `cid=${result.cid}\n`);
+    fs.appendFileSync(output, `domain=${result.domainName}\n`);
   }
-  if (!flags.help && !flags.version && !flags.bootstrap) {
+
+  console.log(`CID: ${result.cid}`);
+  console.log(`Domain: ${result.domainName}`);
+  if (!flags.help && !flags.version) {
     try { writeRunState({ status: "succeeded", endedAt: Date.now() }); } catch {}
   }
   process.exit(0);
@@ -207,7 +203,7 @@ try {
   const noRetry = error instanceof NonRetryableError;
   console.error(`Deployment failed${noRetry ? " (not retryable)" : ""}:`, error.message);
   await handleFailedDeploy(error);
-  if (!flags.help && !flags.version && !flags.bootstrap) {
+  if (!flags.help && !flags.version) {
     try { writeRunState({ status: "failed", endedAt: Date.now(), reason: (error?.message ?? String(error)).slice(0, 200) }); } catch {}
   }
   process.exit(noRetry ? EXIT_CODE_NO_RETRY : 1);

package/dist/bug-report.js

@@ -9,10 +9,10 @@ import {
   offerBugReport,
   scrubSecrets,
   setDeployContext
-} from "./chunk-YYULF2JX.js";
-import "./chunk-CQ753LDA.js";
-import "./chunk-DHQ3JGF4.js";
-import "./chunk-UJP2PZGU.js";
+} from "./chunk-YX62STIA.js";
+import "./chunk-EECNTEAE.js";
+import "./chunk-Y6CTPQS2.js";
+import "./chunk-HHY32NGJ.js";
 import "./chunk-QGM4M3NI.js";
 export {
   buildCliFlagsSummary,

package/dist/{chunk-SVKCVNXD.js → chunk-A2J6R5PD.js}

@@ -1,6 +1,6 @@
 import {
   setDeployContext
-} from "./chunk-YYULF2JX.js";
+} from "./chunk-YX62STIA.js";
 import {
   DotNS,
   TX_TIMEOUT_MS,
@@ -8,7 +8,7 @@ import {
   parseDomainName,
   popStatusName,
   verifyNonceAdvanced
-} from "./chunk-YREZFNCC.js";
+} from "./chunk-G6CVI6U2.js";
 import {
   MirrorSkipped,
   mirrorToGitHubPages,
@@ -27,7 +27,7 @@ import {
   truncateAddress,
   withDeploySpan,
   withSpan
-} from "./chunk-DHQ3JGF4.js";
+} from "./chunk-Y6CTPQS2.js";
 import {
   merkleizeJS
 } from "./chunk-B7GUYYAN.js";
@@ -38,7 +38,7 @@ import {
   fetchPoolAuthorizations,
   selectAccount,
   topUpBy
-} from "./chunk-JHNW2EKY.js";
+} from "./chunk-WIBZPZSY.js";
 
 // src/deploy.ts
 import { Buffer } from "buffer";
@@ -175,10 +175,10 @@ async function getProvider() {
     if (!selected) {
       const best = authorizations.reduce((a, b) => a.transactions > b.transactions ? a : b);
       console.log(`   All pool accounts low on capacity, auto-authorizing account ${best.index}...`);
-      await ensureAuthorized(unsafeApi, best.address, BULLETIN_ENDPOINTS[0], `pool account ${best.index}`);
+      await ensureAuthorized(unsafeApi, best.address, `pool account ${best.index}`);
       selected = best;
     } else {
-      await ensureAuthorized(unsafeApi, selected.address, BULLETIN_ENDPOINTS[0], `pool account ${selected.index}`);
+      await ensureAuthorized(unsafeApi, selected.address, `pool account ${selected.index}`);
     }
     console.log(`   Using pool account ${selected.index}: ${selected.address}`);
     setDeployAttribute("deploy.signer.mode", "pool");
@@ -214,14 +214,12 @@ async function getDirectProvider(mnemonic, derivationPath = "") {
   setDeployAttribute("deploy.signer.address", truncateAddress(ss58));
   return { client, unsafeApi, signer, ss58 };
 }
-var MAX_BEST_CHAIN_DROPS = 5;
 function watchTransaction(tx, signer, txOpts, onSuccess, { label = "transaction", rpc, senderSS58, expectedNonce, timeoutMs, fetchNonce: fetchNonceOverride } = {}) {
   const timeout = timeoutMs ?? TX_TIMEOUT_MS;
   const _fetchNonce = fetchNonceOverride ?? fetchNonce;
   return new Promise((resolve2, reject) => {
     let settled = false;
     let sub;
-    let dropCount = 0;
     const settle = (fn) => (...args) => {
       if (settled) return;
       settled = true;
@@ -232,7 +230,7 @@ function watchTransaction(tx, signer, txOpts, onSuccess, { label = "transaction"
       }
       fn(...args);
     };
-    const tryNonceFallback = async (subscriptionErrored) => {
+    const tryNonceFallback = async () => {
       if (!rpc || !senderSS58 || expectedNonce == null) return false;
       try {
         const endpoints = Array.isArray(rpc) ? rpc : [rpc];
@@ -240,7 +238,7 @@ function watchTransaction(tx, signer, txOpts, onSuccess, { label = "transaction"
         if (settled) return true;
         if (verified.advanced) {
           console.log(`      ${label}: nonce advanced past ${expectedNonce} (witnessed by ${verified.witnessRpc}), tx was included`);
-          settle(resolve2)({ value: onSuccess(), viaFallback: true, subscriptionError: subscriptionErrored });
+          settle(resolve2)({ value: onSuccess(), viaFallback: true });
           return true;
         }
       } catch (e) {
@@ -251,28 +249,21 @@ function watchTransaction(tx, signer, txOpts, onSuccess, { label = "transaction"
     };
     const timer = setTimeout(async () => {
       if (settled) return;
-      if (await tryNonceFallback(false)) return;
+      if (await tryNonceFallback()) return;
       settle(reject)(new Error(`${label} timed out after ${timeout / 1e3}s waiting for block confirmation`));
     }, timeout);
     sub = tx.signSubmitAndWatch(signer, txOpts).subscribe({
       next: async (event) => {
-        if (event.type === "txBestBlocksState") {
-          if (event.found) {
-            if (event.ok) {
-              settle(resolve2)({ value: onSuccess(event), viaFallback: false, subscriptionError: false });
-            } else {
-              settle(reject)(new Error(`${label} dispatch error`));
-            }
-          } else {
-            dropCount++;
-            if (dropCount >= MAX_BEST_CHAIN_DROPS) {
-              console.log(`      ${label}: tx dropped ${dropCount} times, checking nonce...`);
-              if (await tryNonceFallback(true)) return;
-              settle(reject)(new Error(`${label} tx dropped from best chain ${dropCount} times`));
-            } else {
-              console.log(`      ${label}: tx dropped from best chain (${dropCount}/${MAX_BEST_CHAIN_DROPS}), waiting...`);
-            }
-          }
+        if (event.type !== "txBestBlocksState") return;
+        if (event.found) {
+          if (event.ok) settle(resolve2)({ value: onSuccess(event), viaFallback: false });
+          else settle(reject)(new Error(`${label} dispatch error`));
+          return;
+        }
+        if (event.isValid === false) {
+          console.log(`      ${label}: tx rejected by pool (isValid:false), checking nonce fallback...`);
+          if (await tryNonceFallback()) return;
+          settle(reject)(new Error(`${label} tx rejected by pool (isValid:false)`));
         }
       },
       error: (e) => {
@@ -287,11 +278,11 @@ async function storeChunk(unsafeApi, signer, chunkBytes, nonce, ss58, opts = {})
   const cid = createCID(chunkBytes, CID_CONFIG.codec, hashCode);
   const tx = unsafeApi.tx.TransactionStorage.store_with_cid_config({ cid: { codec: BigInt(CID_CONFIG.codec), hashing: toHashingEnum(hashCode) }, data: Binary.fromBytes(chunkBytes) });
   const txOpts = { mortality: { mortal: true, period: CHUNK_MORTALITY_PERIOD }, nonce };
-  const { value, viaFallback, subscriptionError } = await watchTransaction(tx, signer, txOpts, () => {
+  const { value, viaFallback } = await watchTransaction(tx, signer, txOpts, () => {
     console.log(`      CID: ${cid.toString()}`);
     return { cid, len: chunkBytes.length };
   }, { label: `chunk(nonce:${nonce})`, rpc: BULLETIN_ENDPOINTS, senderSS58: ss58, expectedNonce: nonce, timeoutMs: CHUNK_TIMEOUT_MS, fetchNonce: opts.fetchNonce });
-  return { ...value, viaFallback, subscriptionError };
+  return { ...value, viaFallback };
 }
 async function storeFile(contentBytes, { client: existingClient, unsafeApi: existingApi, signer: existingSigner } = {}) {
   console.log(`
@@ -360,7 +351,7 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
    Account has insufficient authorization for this upload (need ${requiredTxs} txs / ${(totalBytes / 1e6).toFixed(1)}MB, have ${txsRemaining} txs / ${Number(bytesRemaining) / 1e6}MB)`);
     console.log(`   Attempting to re-authorize with Alice...`);
     try {
-      await ensureAuthorized(unsafeApi, ss58, BULLETIN_ENDPOINTS[0], void 0, { txs: requiredTxs, bytes: requiredBytes });
+      await ensureAuthorized(unsafeApi, ss58, void 0, { txs: requiredTxs, bytes: requiredBytes });
       console.log(`   Re-authorization successful`);
     } catch (e) {
       throw new NonRetryableError(`Account ${ss58} has insufficient Bulletin authorization quota and auto-authorization via Alice failed (${e.message}). Authorize the account on-chain.`);
@@ -427,8 +418,7 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
         }
       });
       const failures = results.map((r, j) => r.status === "rejected" ? { index: batchIndices[j], chunkData: batchChunks[j], error: r.reason } : null).filter(Boolean);
-      const subscriptionErrored = results.some((r) => r.status === "fulfilled" && r.value.subscriptionError);
-      const needsReconnect = failures.some((f) => isConnectionError(f.error)) || subscriptionErrored;
+      const needsReconnect = failures.some((f) => isConnectionError(f.error));
       if (needsReconnect && reconnect && reconnectionsUsed < MAX_RECONNECTIONS) {
         await doReconnect();
         const currentNonce = await _fetchNonce(BULLETIN_ENDPOINTS, ss58);
@@ -529,9 +519,6 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
           return rootCid.toString();
         }, { label: "root-node", rpc: BULLETIN_ENDPOINTS, senderSS58: ss58, expectedNonce: rootNonce, timeoutMs: CHUNK_TIMEOUT_MS, fetchNonce: fetchNonceOverride });
         result = watchResult.value;
-        if (watchResult.subscriptionError && reconnect && reconnectionsUsed < MAX_RECONNECTIONS) {
-          await doReconnect();
-        }
         break;
       } catch (e) {
         if (reconnect && reconnectionsUsed < MAX_RECONNECTIONS) {
@@ -723,22 +710,6 @@ async function deploy(content, domainName = null, options = {}) {
       await preflight.connect(
         options.signer && options.signerAddress ? { signer: options.signer, signerAddress: options.signerAddress } : options.mnemonic ? { mnemonic: options.mnemonic, derivationPath: options.derivationPath } : {}
       );
-      const mappingDeadline = Date.now() + 15e3;
-      let mappingConfirmed = false;
-      while (Date.now() < mappingDeadline) {
-        if (await preflight.clientWrapper.checkIfAccountMapped(preflight.substrateAddress)) {
-          mappingConfirmed = true;
-          break;
-        }
-        await new Promise((r) => setTimeout(r, 1500));
-      }
-      if (!mappingConfirmed) {
-        preflight.disconnect();
-        throw new NonRetryableError(
-          `Account mapping did not take effect on-chain for ${preflight.substrateAddress}. The map_account tx may have been dropped or hit a dispatch error \u2014 check the signer's balance for existential deposit + fees.`
-        );
-      }
-      console.log(`   Account: mapped`);
       if (parsed?.isSubdomain) {
         try {
           const { owned: subOwned } = await preflight.checkSubdomainOwnership(parsed.sublabel, parsed.parentLabel);
@@ -787,7 +758,7 @@ async function deploy(content, domainName = null, options = {}) {
         const uploadBytes = Math.ceil(estimated * 1.2);
         const chunksNeeded = Math.max(1, Math.ceil(uploadBytes / CHUNK_SIZE));
         const needs = { txs: BigInt(chunksNeeded + 2), bytes: BigInt(uploadBytes) };
-        await topUpBy(provider.ss58, BULLETIN_ENDPOINTS[0], needs, "uploader");
+        await topUpBy(provider.unsafeApi, provider.ss58, needs, "uploader");
       }
       console.log("\n" + "=".repeat(60));
       console.log("Storage");
@@ -942,16 +913,11 @@ async function deploy(content, domainName = null, options = {}) {
           const freshness = await pollMirrorFreshness(mirror.url, cid, { timeoutMs: 3 * 60 * 1e3, intervalMs: 1e4 });
           if (freshness.verified) {
             console.log(`ok (${freshness.attempts} attempt${freshness.attempts === 1 ? "" : "s"}, ${(freshness.durationMs / 1e3).toFixed(0)}s).`);
+            setDeployAttribute("deploy.gh_pages_freshness_verified", "true");
           } else {
             console.log(`timed out.`);
             console.log(`   GitHub Pages last served cid=${freshness.lastCid ?? "n/a"} (expected ${cid}); it should catch up shortly. Non-fatal.`);
-            captureWarning("gh-pages mirror freshness poll timed out", {
-              url: mirror.url,
-              expectedCid: cid,
-              lastCid: freshness.lastCid ?? "n/a",
-              durationMs: freshness.durationMs,
-              attempts: freshness.attempts
-            });
+            setDeployAttribute("deploy.gh_pages_freshness_verified", "false");
           }
         });
       }

package/dist/{chunk-CQ753LDA.js → chunk-EECNTEAE.js}

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

package/dist/{chunk-YREZFNCC.js → chunk-G6CVI6U2.js}

@@ -2,10 +2,10 @@ import {
   captureWarning,
   setDeployAttribute,
   withSpan
-} from "./chunk-DHQ3JGF4.js";
+} from "./chunk-Y6CTPQS2.js";
 import {
   isTestnetSpecName
-} from "./chunk-JHNW2EKY.js";
+} from "./chunk-WIBZPZSY.js";
 
 // src/dotns.ts
 import { spawn } from "child_process";
@@ -227,11 +227,25 @@ function sanitizeDomainLabel(label) {
 function validateDomainLabel(label) {
   if (!/^[a-z0-9-]{3,}$/.test(label)) throw new Error("Invalid domain label: must contain only lowercase letters, digits, and hyphens, min 3 chars");
   if (label.startsWith("-") || label.endsWith("-")) throw new Error("Invalid domain label: cannot start or end with hyphen");
-  return sanitizeDomainLabel(label);
+  const sanitized = sanitizeDomainLabel(label);
+  if (/-\d+$/.test(sanitized)) {
+    const baseWithHyphen = sanitized.replace(/\d+$/, "");
+    const dropHyphen = sanitized.replace(/-(\d+)$/, "$1");
+    const insertSegment = sanitized.replace(/-(\d+)$/, "-pr$1");
+    throw new Error(
+      `Invalid domain label: "${sanitized}" \u2014 dotns base-name extraction leaves a trailing hyphen ("${baseWithHyphen}"), which the registry rejects with PopError("Name must be lowercase ASCII DNS label"). Drop the hyphen before the digits (e.g. "${dropHyphen}") or add a non-digit segment between (e.g. "${insertSegment}").`
+    );
+  }
+  return sanitized;
 }
 function isCommitmentMature(chainNowSeconds, commitTimestampSeconds, minimumAgeSeconds) {
   return chainNowSeconds > commitTimestampSeconds + minimumAgeSeconds;
 }
+function isExplicitCommitmentBuffer(envValue) {
+  if (envValue === void 0 || envValue === "") return false;
+  const parsed = Number(envValue);
+  return Number.isFinite(parsed) && parsed > 0;
+}
 function classifyDotnsLabel(label) {
   const totalLength = label.length;
   const trailingDigits = countTrailingDigits(label);
@@ -435,34 +449,46 @@ var DotNS = class {
       this._mnemonic = null;
     }
     const authEnv = buildAuthEnv({ mnemonic: this._mnemonic ?? void 0, keyUri: this._keyUri ?? void 0 });
-    const popInfo = await withTimeout(
-      runDotnsCli(["pop", "info", "--json", ...rpcFlag(rpc)], authEnv),
-      CONNECTION_TIMEOUT_MS,
-      "pop info (connect)"
-    );
-    this.substrateAddress = popInfo.substrate;
-    this.evmAddress = popInfo.evm;
+    await cryptoWaitReady();
+    const keyring = new Keyring({ type: "sr25519" });
+    const account = this._keyUri ? keyring.addFromUri(this._keyUri) : keyring.addFromMnemonic(source);
+    this.signer = getPolkadotSigner(account.publicKey, "Sr25519", async (input) => account.sign(input));
+    this.substrateAddress = account.address;
     console.log(`   SS58 Address: ${this.substrateAddress}`);
-    console.log(`   H160 Address: ${this.evmAddress}`);
     try {
-      await cryptoWaitReady();
-      const keyring = new Keyring({ type: "sr25519" });
-      const account = isKeyUri || this._keyUri ? keyring.addFromUri(this._keyUri ?? source) : keyring.addFromMnemonic(source);
-      this.signer = getPolkadotSigner(account.publicKey, "Sr25519", async (input) => account.sign(input));
       this.client = createClient(getWsProvider(rpc, { heartbeatTimeout: WS_HEARTBEAT_TIMEOUT_MS }));
       const unsafeApi = this.client.getUnsafeApi();
       this.clientWrapper = new ReviveClientWrapper(unsafeApi);
+      this.evmAddress = await withTimeout(
+        this.clientWrapper.getEvmAddress(this.substrateAddress),
+        CONNECTION_TIMEOUT_MS,
+        "ReviveApi.address"
+      );
+      console.log(`   H160 Address: ${this.evmAddress}`);
     } catch (e) {
-      captureWarning("DotNS polkadot-api client setup failed (contractCall / checkIfAccountMapped unavailable)", { error: e.message?.slice(0, 200) });
+      throw new Error(`DotNS connect: failed to resolve EVM address from ${this.substrateAddress} via ReviveApi.address (${e.message?.slice(0, 200)})`);
     }
-    try {
-      await runDotnsCli(["account", "map", ...rpcFlag(rpc)], authEnv);
-    } catch (e) {
-      const msg = e.message?.toLowerCase() ?? "";
-      if (!msg.includes("already") && !msg.includes("mapped")) {
-        captureWarning("account map failed during connect", { error: e.message?.slice(0, 200) });
+    if (!await this.clientWrapper.checkIfAccountMapped(this.substrateAddress)) {
+      console.log(`   Mapping account on Asset Hub Revive...`);
+      try {
+        await runDotnsCli(["account", "map", ...rpcFlag(rpc)], authEnv);
+      } catch (e) {
+        captureWarning("account map failed during connect (will rely on chain confirmation)", { error: e.message?.slice(0, 200) });
+      }
+      const mappingDeadline = Date.now() + 15e3;
+      let mappingConfirmed = false;
+      while (Date.now() < mappingDeadline) {
+        if (await this.clientWrapper.checkIfAccountMapped(this.substrateAddress)) {
+          mappingConfirmed = true;
+          break;
+        }
+        await new Promise((r) => setTimeout(r, 1500));
+      }
+      if (!mappingConfirmed) {
+        throw new Error(`Account mapping did not take effect on-chain for ${this.substrateAddress}. The map_account tx may have been dropped or hit a dispatch error \u2014 check the signer's balance for existential deposit + fees.`);
       }
     }
+    console.log(`   Account: mapped`);
     try {
       setDeployAttribute("deploy.dotns_cli.version", _dotnsCliVersion);
     } catch {
@@ -785,7 +811,7 @@ var DotNS = class {
       console.log(`
    Registering ${label}.dot via dotns CLI...`);
       const authEnv = buildAuthEnv({ mnemonic: this._mnemonic ?? void 0, keyUri: this._keyUri ?? void 0 });
-      const userSetBuffer = !!process.env.DOTNS_COMMITMENT_BUFFER;
+      const userSetBuffer = isExplicitCommitmentBuffer(process.env.DOTNS_COMMITMENT_BUFFER);
       if (!userSetBuffer) {
         authEnv.DOTNS_COMMITMENT_BUFFER = "30";
       }
@@ -857,6 +883,7 @@ export {
   sanitizeDomainLabel,
   validateDomainLabel,
   isCommitmentMature,
+  isExplicitCommitmentBuffer,
   classifyDotnsLabel,
   canRegister,
   simulateUserStatus,

package/dist/{chunk-UJP2PZGU.js → chunk-HHY32NGJ.js}

@@ -6,7 +6,7 @@ import * as path from "path";
 // package.json
 var package_default = {
   name: "bulletin-deploy",
-  version: "0.7.4",
+  version: "0.7.6",
   private: false,
   repository: {
     type: "git",
@@ -20,7 +20,8 @@ var package_default = {
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
   bin: {
-    "bulletin-deploy": "./bin/bulletin-deploy"
+    "bulletin-deploy": "./bin/bulletin-deploy",
+    "bulletin-bootstrap": "./bin/bulletin-bootstrap"
   },
   exports: {
     ".": {
@@ -30,12 +31,13 @@ var package_default = {
   },
   files: [
     "dist",
-    "bin"
+    "bin",
+    "docs"
   ],
   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",
     prepare: "npm run build",
-    test: "npm run build && node --test test/test.js test/pool.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: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",