@parity/product-deploy 0.11.0 → 0.12.0-rc.2

package/dist/{chunk-O4I37F5K.js → chunk-S62H6TWE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SI2ZUOYD.js";
 import {
   isTestnetSpecName
-} from "./chunk-MRQPJLPS.js";
+} from "./chunk-XVQICFTB.js";
 import {
   captureWarning,
   markCodePath,
@@ -11,7 +11,7 @@ import {
   setDeploySentryTag,
   truncateAddress,
   withSpan
-} from "./chunk-53BU4X2R.js";
+} from "./chunk-LRJTODL2.js";
 import {
   validateContractAddresses
 } from "./chunk-JSYQ3JQS.js";
@@ -50,6 +50,11 @@ var CODE_PATHS = {
   // true  → automated mapping via EVM key derivation
   // false → standard check (already-mapped or manually register)
   DOTNS_AUTO_MAPPING: "dotns.auto-mapping",
+  // NOTE (issue #706): marked "exempt" in tools/check-code-path-coverage.py's
+  // CODE_PATHS mirror — it's a real fallback for external DotNS library
+  // callers, but Parity-internal telemetry never sees that population, so
+  // it always reads 0 hits here regardless of real-world usage. Confirmed
+  // non-dead in PR #756 and again for #706; keep the branch and the ID.
   DOTNS_MANUAL_MAPPING: "dotns.manual-mapping"
 };
 
@@ -126,7 +131,23 @@ var TX_WALL_CLOCK_CEILING_MS = 24e4;
 var TX_NO_PROGRESS_MS = 9e4;
 var WS_HEARTBEAT_TIMEOUT_MS = 3e5;
 var DOTNS_TX_MAX_ATTEMPTS = 3;
+var WatcherSilentNoEventError = class extends Error {
+  constructor(silentMs) {
+    super(`transaction watcher silent for ${Math.floor(silentMs / 1e3)}s \u2014 no response received (did you approve on your phone?)`);
+    this.name = "WatcherSilentNoEventError";
+  }
+};
 var VERIFY_EFFECT_CHAIN_SECONDS = 60;
+var NONCE_ADVANCE_VERIFY_RETRIES = 3;
+var NONCE_ADVANCE_VERIFY_RETRY_INTERVAL_MS = 2e3;
+async function verifyEffectWithGrace(verifyEffect, { retries = NONCE_ADVANCE_VERIFY_RETRIES, intervalMs = NONCE_ADVANCE_VERIFY_RETRY_INTERVAL_MS } = {}) {
+  if (await verifyEffect()) return true;
+  for (let attempt = 0; attempt < retries; attempt++) {
+    await new Promise((r) => setTimeout(r, intervalMs));
+    if (await verifyEffect()) return true;
+  }
+  return false;
+}
 function classifyTxRetryDecision(err) {
   const msg = err instanceof Error ? err.message : String(err);
   const lower = msg.toLowerCase();
@@ -138,6 +159,12 @@ function classifyTxRetryDecision(err) {
   if (lower.includes("transaction watcher silent")) return "retry";
   return "abort";
 }
+function classifyWatcherSilentFastFail(err, isPhoneSigner) {
+  if (err instanceof WatcherSilentNoEventError && isPhoneSigner === true) {
+    return new NonRetryableError("No signature received from the phone \u2014 re-run when you can approve on your phone.");
+  }
+  return null;
+}
 var DOTNS_RETRY_BASE_MS = 400;
 var DOTNS_RETRY_MAX_MS = 6e3;
 function dotnsRetryBackoffMs(attempt, rand = Math.random) {
@@ -696,7 +723,7 @@ var ReviveClientWrapper = class _ReviveClientWrapper {
             if (nonce.advanced) {
               if (opts.verifyEffect) {
                 statusCallback("verifying");
-                const observed = await opts.verifyEffect();
+                const observed = await verifyEffectWithGrace(opts.verifyEffect);
                 if (!observed) {
                   statusCallback("failed");
                   finish(reject)(new Error(`nonce-advance fallback: nonce moved past ${opts.nonceFallback.expectedNonce} but expected on-chain effect not observable (likely a different tx of ours consumed the nonce, or our tx was reorged out)`));
@@ -724,7 +751,11 @@ var ReviveClientWrapper = class _ReviveClientWrapper {
           const silentMs = Date.now() - lastEventAt;
           if (silentMs > TX_NO_PROGRESS_MS) {
             statusCallback("failed");
-            finish(reject)(new Error(`transaction watcher silent for ${Math.floor(silentMs / 1e3)}s after ${lastEventType}`));
+            if (lastEventType === "(none)") {
+              finish(reject)(new WatcherSilentNoEventError(silentMs));
+            } else {
+              finish(reject)(new Error(`transaction watcher silent for ${Math.floor(silentMs / 1e3)}s after ${lastEventType}`));
+            }
             return;
           }
         } catch {
@@ -794,6 +825,11 @@ var ReviveClientWrapper = class _ReviveClientWrapper {
         return await this.signAndSubmitExtrinsic(buildExtrinsic(), signer, filter.callback, opts);
       } catch (e) {
         lastError = e;
+        const fastFail = classifyWatcherSilentFastFail(e, opts.isPhoneSigner);
+        if (fastFail) {
+          filter.flush();
+          throw fastFail;
+        }
         const decision = classifyTxRetryDecision(e);
         const msg = e?.message ?? String(e);
         if (!shouldRetryTxAttempt(attempt, DOTNS_TX_MAX_ATTEMPTS, decision)) {
@@ -1430,18 +1466,19 @@ var DotNS = class {
     if (rawData.length <= 2) {
       const hasCode = await this.clientWrapper.hasContractCode(contractAddress);
       const name = dotnsContractName(contractAddress, this._contracts);
+      const env = this._environmentId ?? "(unset)";
       if (hasCode === false) {
         throw new Error(
-          `No contract deployed at ${contractAddress} (${name}) \u2014 the dry-run call to ${functionName} returned empty success data, which on pallet-revive means the target address has no contract code. Check environments.json / --contract config for this network.`
+          `No contract deployed at ${contractAddress} (${name}) env=${env} \u2014 the dry-run call to ${functionName} returned empty success data, which on pallet-revive means the target address has no contract code. Check environments.json / --contract config for this network.`
         );
       }
       if (hasCode === null) {
         throw new Error(
-          `Contract call returned empty data \u2014 contract=${name} (${contractAddress}) functionName=${functionName}. Could not verify whether contract code exists at this address (runtime code-presence query failed); investigate the contract/ABI or the configured address.`
+          `Contract call returned empty data \u2014 contract=${name} (${contractAddress}) env=${env} functionName=${functionName}. Could not verify whether contract code exists at this address (runtime code-presence query failed); investigate the contract/ABI or the configured address.`
         );
       }
       throw new Error(
-        `Contract call returned empty data \u2014 contract=${name} (${contractAddress}) functionName=${functionName}. The address has contract code but the call returned no bytes, which is unexpected for this read. Investigate the contract/ABI rather than masking it with a default.`
+        `Contract call returned empty data \u2014 contract=${name} (${contractAddress}) env=${env} functionName=${functionName}. The address has contract code but the call returned no bytes, which is unexpected for this read. Investigate the contract/ABI rather than masking it with a default.`
       );
     }
     return decodeFunctionResult({ abi: contractAbi, functionName, data: rawData });
@@ -1819,7 +1856,7 @@ var DotNS = class {
     const target = this._contracts.DOTNS_CONTENT_RESOLVER;
     let current = null;
     try {
-      current = await this.contractCall(this._contracts.DOTNS_REGISTRY, DOTNS_REGISTRY_ABI, "resolver", [node]);
+      current = await this.contractCallNullable(this._contracts.DOTNS_REGISTRY, DOTNS_REGISTRY_ABI, "resolver", [node]);
     } catch {
     }
     if (typeof current === "string" && current.toLowerCase() === target.toLowerCase()) {
@@ -1833,7 +1870,7 @@ var DotNS = class {
   async getTextRecord(domainName, key) {
     this.ensureConnected();
     const node = namehash(`${domainName}.dot`);
-    const result = await this.contractCall(
+    const result = await this.contractCallNullable(
       this._contracts.DOTNS_CONTENT_RESOLVER,
       DOTNS_TEXT_RESOLVER_ABI,
       "text",
@@ -1880,7 +1917,7 @@ var DotNS = class {
       let onChainValue = "";
       let lastPrintedElapsed = -1;
       while (true) {
-        const onChain = await withTimeout(this.contractCall(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_TEXT_RESOLVER_ABI, "text", [node, key]), 3e4, "text");
+        const onChain = await withTimeout(this.contractCallNullable(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_TEXT_RESOLVER_ABI, "text", [node, key]), 3e4, "text");
         onChainValue = onChain ?? "";
         if (onChainValue === value) break;
         const nowChainMs = Number(await this.clientWrapper.client.query.Timestamp.Now.getValue());
@@ -1937,7 +1974,7 @@ var DotNS = class {
       const startChainMs = Number(await this.clientWrapper.client.query.Timestamp.Now.getValue());
       let lastResults = [];
       while (true) {
-        lastResults = await Promise.all(entries.map((e) => withTimeout(this.contractCall(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_TEXT_RESOLVER_ABI, "text", [node, e.key]), 3e4, "text").then((onChain) => ({ key: e.key, expected: e.value, onChain: onChain ?? "" }))));
+        lastResults = await Promise.all(entries.map((e) => withTimeout(this.contractCallNullable(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_TEXT_RESOLVER_ABI, "text", [node, e.key]), 3e4, "text").then((onChain) => ({ key: e.key, expected: e.value, onChain: onChain ?? "" }))));
         if (lastResults.every((v) => v.onChain === v.expected)) break;
         const nowChainMs = Number(await this.clientWrapper.client.query.Timestamp.Now.getValue());
         const chainElapsed = (nowChainMs - startChainMs) / 1e3;
@@ -2102,10 +2139,11 @@ var DotNS = class {
     this.ensureConnected();
     const node = namehash(`${domainName}.dot`);
     const result = await withTimeout(
-      this.contractCall(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_CONTENT_RESOLVER_ABI, "contenthash", [node]),
+      this.contractCallNullable(this._contracts.DOTNS_CONTENT_RESOLVER, DOTNS_CONTENT_RESOLVER_ABI, "contenthash", [node]),
       3e4,
       "contenthash"
     );
+    if (result === null) return "0x";
     return typeof result === "string" ? result : result?.toString?.() ?? String(result);
   }
   async classifyName(label) {
@@ -2759,8 +2797,13 @@ export {
   TX_NO_PROGRESS_MS,
   WS_HEARTBEAT_TIMEOUT_MS,
   DOTNS_TX_MAX_ATTEMPTS,
+  WatcherSilentNoEventError,
   VERIFY_EFFECT_CHAIN_SECONDS,
+  NONCE_ADVANCE_VERIFY_RETRIES,
+  NONCE_ADVANCE_VERIFY_RETRY_INTERVAL_MS,
+  verifyEffectWithGrace,
   classifyTxRetryDecision,
+  classifyWatcherSilentFastFail,
   dotnsRetryBackoffMs,
   shouldRetryTxAttempt,
   shouldRegateBeforeResign,

package/dist/{chunk-7E33R3OQ.js → chunk-UPA5PEQA.js}

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

package/dist/{chunk-QDHLTSEO.js → chunk-WVVRMGKN.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-5FLTDWWP.js";
 import {
   DOT_PRODUCT_ID
-} from "./chunk-JWMHCW74.js";
+} from "./chunk-NRSIBGBP.js";
 import {
   DEFAULT_MNEMONIC
-} from "./chunk-O4I37F5K.js";
+} from "./chunk-S62H6TWE.js";
 
 // src/deploy-actors.ts
 var DEFAULT_WORKER_SURI = DEFAULT_MNEMONIC;

package/dist/{chunk-MRQPJLPS.js → chunk-XVQICFTB.js}

@@ -37,6 +37,15 @@ function isAuthorizationSufficient(auth, currentBlock) {
 function accountsNeedingAuthorization(auths, currentBlock) {
   return auths.filter((a) => !isAuthorizationSufficient(a, currentBlock));
 }
+var BULLETIN_BLOCK_TIME_SECS = 6;
+var BULLETIN_BLOCKS_PER_DAY = Math.floor(86400 / BULLETIN_BLOCK_TIME_SECS);
+function accountsNeedingReauthorization(auths, currentBlock, bufferBlocks = BULLETIN_BLOCKS_PER_DAY) {
+  const deadline = currentBlock + bufferBlocks;
+  return auths.filter((a) => !isAuthorizationSufficient(a, deadline));
+}
+function isAutoReauthorizeAllowed(env) {
+  return env?.network !== "mainnet" && env?.bulletinAutoAuthorize === true;
+}
 function selectAccount(authorizations, random = Math.random, pinnedIndex) {
   if (pinnedIndex != null) {
     const pinned = authorizations.find((a) => a.index === pinnedIndex);
@@ -164,13 +173,21 @@ async function bootstrapPool(bulletinRpc, poolSize = 10, mnemonic, opts = {}) {
       printAuthStatus(a, currentBlock);
     }
     console.log("");
-    const needsAuth = accountsNeedingAuthorization(auths, currentBlock);
+    const reauthBufferBlocks = opts.reauthBufferBlocks ?? 0;
+    const needsAuth = accountsNeedingReauthorization(auths, currentBlock, reauthBufferBlocks);
     if (needsAuth.length === 0) {
       console.log("All pool accounts are authorized. Nothing to do.");
       return;
     }
     console.log(`${needsAuth.length} account(s) need authorization.
 `);
+    if (reauthBufferBlocks > 0 && !opts.allowAutoReauthorize) {
+      const details = needsAuth.map((a) => `  [${a.index}] ${a.address} \u2014 expires @${a.expiration} (current block ${currentBlock})`).join("\n");
+      throw new Error(
+        `Auto-reauthorize is testnet-only (see isAutoReauthorizeAllowed / environments.json bulletinAutoAuthorize) and this call was not cleared to write. ${needsAuth.length} account(s) need reauthorization within the ${reauthBufferBlocks}-block buffer:
+${details}`
+      );
+    }
     let authorizerSigner;
     const keyring = new Keyring({ type: "sr25519" });
     if (opts.authorizerMnemonic) {
@@ -228,6 +245,10 @@ export {
   derivePoolAccounts,
   isAuthorizationSufficient,
   accountsNeedingAuthorization,
+  BULLETIN_BLOCK_TIME_SECS,
+  BULLETIN_BLOCKS_PER_DAY,
+  accountsNeedingReauthorization,
+  isAutoReauthorizeAllowed,
   selectAccount,
   fetchPoolAuthorizations,
   isTestnetSpecName,

package/dist/chunk-probe.d.ts

@@ -29,9 +29,51 @@ declare function _decodeStorageValue(hex: string | null | undefined): {
     index: number;
 } | null;
 declare function probeChunks(cids: string[], options: ChainProbeOptions): Promise<ChunkProbeResult[]>;
+/**
+ * Splits cids that are missing at finalised head into two buckets, using a
+ * best-block probe result for each cid:
+ *   - `lagging`: present at best-block. GRANDPA just hasn't caught up yet
+ *     (#1049) — these were never lost and must NEVER be re-uploaded.
+ *   - `reallyMissing`: absent at best-block too (or the best-block probe
+ *     itself failed, `present === null`) — genuinely dropped, or we
+ *     couldn't determine presence at all. Either way, re-upload is the
+ *     safe default: treating an indeterminate result as "lagging" risks
+ *     silently skipping a chunk that's actually gone.
+ *
+ * Pure function — no chain I/O — so it's directly unit-testable against a
+ * mocked ChunkProbeResult array without a client.
+ */
+declare function classifyFinalityGap(missingAtFinalized: string[], bestBlockResults: ChunkProbeResult[]): {
+    reallyMissing: string[];
+    lagging: string[];
+};
+/**
+ * Composite, chain-touching version of classifyFinalityGap (#1049): probes
+ * `missingAtFinalized` at best-block, retries once on an indeterminate
+ * result (present === null), then classifies. Any caller that finds cids
+ * missing at finalised head should route through this — not re-implement
+ * the probe/retry/classify sequence inline — so the "finalised-head absence
+ * is not proof of loss" policy stays consistent everywhere it's checked
+ * (the GRANDPA finality-check phase and the pre-setContenthash root
+ * re-check both use it).
+ */
+declare function probeFinalityGap(missingAtFinalized: string[], options: ChainProbeOptions): Promise<{
+    reallyMissing: string[];
+    lagging: string[];
+}>;
+/**
+ * Best (non-finalised) block height, via `chain_getHeader`. Used by the
+ * initial chunk-upload retry loop (#1051) to detect a frozen chain — no new
+ * blocks since the last check — so it can wait instead of resubmitting into
+ * a stall (which just manufactures same-nonce collisions once the chain
+ * resumes). Returns `null` on any RPC failure or malformed response; callers
+ * must treat `null` as "can't tell" and fail open (proceed as if live)
+ * rather than blocking forever on a single bad peer.
+ */
+declare function getBestBlockNumber(client: any): Promise<number | null>;
 /** Reset session-level caches. Used in tests only. */
 declare function _resetProbeSession(): void;
 /** Pre-set metadataChecked so tests don't need a real metadata RPC mock. Used in tests only. */
 declare function _bypassMetadataCheckForTest(): void;
 
-export { ChainProbeCrossValidationError, ChainProbeMetadataError, type ChainProbeOptions, type ChunkProbeFailureReason, type ChunkProbeResult, _bypassMetadataCheckForTest, _decodeStorageValue, _resetProbeSession, probeChunks };
+export { ChainProbeCrossValidationError, ChainProbeMetadataError, type ChainProbeOptions, type ChunkProbeFailureReason, type ChunkProbeResult, _bypassMetadataCheckForTest, _decodeStorageValue, _resetProbeSession, classifyFinalityGap, getBestBlockNumber, probeChunks, probeFinalityGap };

package/dist/chunk-probe.js

@@ -4,15 +4,21 @@ import {
   _bypassMetadataCheckForTest,
   _decodeStorageValue,
   _resetProbeSession,
-  probeChunks
-} from "./chunk-HLXRVFKL.js";
-import "./chunk-53BU4X2R.js";
-import "./chunk-SES7CGNY.js";
+  classifyFinalityGap,
+  getBestBlockNumber,
+  probeChunks,
+  probeFinalityGap
+} from "./chunk-FGCBIUMT.js";
+import "./chunk-LRJTODL2.js";
+import "./chunk-DDC6NKE3.js";
 export {
   ChainProbeCrossValidationError,
   ChainProbeMetadataError,
   _bypassMetadataCheckForTest,
   _decodeStorageValue,
   _resetProbeSession,
-  probeChunks
+  classifyFinalityGap,
+  getBestBlockNumber,
+  probeChunks,
+  probeFinalityGap
 };

package/dist/commands/login.js

@@ -3,10 +3,10 @@ import {
 } from "../chunk-J7CYVTAW.js";
 import {
   waitForBulletinAuthorization
-} from "../chunk-UUJFLJKY.js";
+} from "../chunk-N7KXNIH4.js";
 import {
   preflightSssAllowance
-} from "../chunk-7RYEYWYO.js";
+} from "../chunk-JGS6QR5X.js";
 import {
   statementSigningAccount
 } from "../chunk-GRPLHUYC.js";
@@ -15,11 +15,11 @@ import "../chunk-IW3X2MJF.js";
 import "../chunk-KOSF5FDO.js";
 import "../chunk-J3NIXHZZ.js";
 import "../chunk-S7EM5VMW.js";
-import "../chunk-HTZGBUZA.js";
-import "../chunk-7E33R3OQ.js";
-import "../chunk-HLXRVFKL.js";
+import "../chunk-IR5BHZ2S.js";
+import "../chunk-UPA5PEQA.js";
+import "../chunk-FGCBIUMT.js";
 import "../chunk-C2TS5MER.js";
-import "../chunk-QDHLTSEO.js";
+import "../chunk-WVVRMGKN.js";
 import "../chunk-JQKKMUCT.js";
 import {
   BULLETIN_RESOURCE,
@@ -36,15 +36,15 @@ import {
   getAuthClient,
   getPeopleChainEndpoints,
   resolveBulletinEndpoints
-} from "../chunk-JWMHCW74.js";
+} from "../chunk-NRSIBGBP.js";
 import {
   CLI_NAME
 } from "../chunk-TSPERKUS.js";
-import "../chunk-O4I37F5K.js";
+import "../chunk-S62H6TWE.js";
 import "../chunk-SI2ZUOYD.js";
-import "../chunk-MRQPJLPS.js";
-import "../chunk-53BU4X2R.js";
-import "../chunk-SES7CGNY.js";
+import "../chunk-XVQICFTB.js";
+import "../chunk-LRJTODL2.js";
+import "../chunk-DDC6NKE3.js";
 import {
   loadEnvironments
 } from "../chunk-JSYQ3JQS.js";

package/dist/commands/logout.js

@@ -1,6 +1,6 @@
 import {
   clearSssAllowanceCache
-} from "../chunk-7RYEYWYO.js";
+} from "../chunk-JGS6QR5X.js";
 import "../chunk-GRPLHUYC.js";
 import "../chunk-JQKKMUCT.js";
 import "../chunk-5FLTDWWP.js";
@@ -9,10 +9,10 @@ import {
 } from "../chunk-RIRDBSBG.js";
 import {
   getAuthClient
-} from "../chunk-JWMHCW74.js";
+} from "../chunk-NRSIBGBP.js";
 import "../chunk-TSPERKUS.js";
-import "../chunk-53BU4X2R.js";
-import "../chunk-SES7CGNY.js";
+import "../chunk-LRJTODL2.js";
+import "../chunk-DDC6NKE3.js";
 import "../chunk-JSYQ3JQS.js";
 import "../chunk-ZOC4GITL.js";
 

package/dist/commands/transfer.js

@@ -4,11 +4,11 @@ import {
 import {
   DEFAULT_MNEMONIC,
   DotNS
-} from "../chunk-O4I37F5K.js";
+} from "../chunk-S62H6TWE.js";
 import "../chunk-SI2ZUOYD.js";
-import "../chunk-MRQPJLPS.js";
-import "../chunk-53BU4X2R.js";
-import "../chunk-SES7CGNY.js";
+import "../chunk-XVQICFTB.js";
+import "../chunk-LRJTODL2.js";
+import "../chunk-DDC6NKE3.js";
 import {
   getPopSelfServeConfig,
   loadEnvironments,

package/dist/commands/whoami.js

@@ -2,12 +2,12 @@ import {
   STALE_SESSION_MESSAGE,
   getAuthClient,
   hasPersistedSession
-} from "../chunk-JWMHCW74.js";
+} from "../chunk-NRSIBGBP.js";
 import {
   CLI_NAME
 } from "../chunk-TSPERKUS.js";
-import "../chunk-53BU4X2R.js";
-import "../chunk-SES7CGNY.js";
+import "../chunk-LRJTODL2.js";
+import "../chunk-DDC6NKE3.js";
 import "../chunk-JSYQ3JQS.js";
 import "../chunk-ZOC4GITL.js";
 

package/dist/deploy-actors.js

@@ -2,17 +2,17 @@ import {
   MainnetDefaultWorkerError,
   resolveDeployActors,
   resolveStorageSigner
-} from "./chunk-QDHLTSEO.js";
+} from "./chunk-WVVRMGKN.js";
 import "./chunk-JQKKMUCT.js";
 import "./chunk-5FLTDWWP.js";
 import "./chunk-RIRDBSBG.js";
-import "./chunk-JWMHCW74.js";
+import "./chunk-NRSIBGBP.js";
 import "./chunk-TSPERKUS.js";
-import "./chunk-O4I37F5K.js";
+import "./chunk-S62H6TWE.js";
 import "./chunk-SI2ZUOYD.js";
-import "./chunk-MRQPJLPS.js";
-import "./chunk-53BU4X2R.js";
-import "./chunk-SES7CGNY.js";
+import "./chunk-XVQICFTB.js";
+import "./chunk-LRJTODL2.js";
+import "./chunk-DDC6NKE3.js";
 import "./chunk-JSYQ3JQS.js";
 import "./chunk-ZOC4GITL.js";
 export {

package/dist/deploy.d.ts

@@ -164,6 +164,50 @@ declare function formatTransferModeStorageSignerLine(workerAddress: string): str
  * Exported for unit testing.
  */
 declare function formatTransferModeDotnsLine(alreadyOwned: boolean, dotName: string, recipient: string): string;
+/**
+ * Produce an actionable reason string for the pool-fallback warning + telemetry
+ * attribute. BulletinSlotAuthError carries a typed reason; other errors
+ * (WS/connection, still possible after withTransientRetry's bounded retries
+ * are exhausted — see storage-signer.ts) use their message. Extracted from
+ * selectStorageReconnect so it's unit-testable without a real WS connection
+ * (#1058: pool fallbacks must always carry an explicit, visible reason).
+ */
+declare function describeSlotFallbackReason(e: unknown): string;
+/**
+ * Reconcile-before-resubmit (#1051). Pure decision function — no chain I/O —
+ * so it's directly unit-testable. Decides whether a timed-out chunk tx
+ * should be treated as already included (skip the resubmit, avoid a
+ * duplicate content write) based on two independent signals:
+ *   - nonce advance: the account's nonce moved past the chunk's assigned
+ *     nonce. Only meaningful when `nonceHeuristicValid` — false after a pool
+ *     account rotation, where the old nonce baseline belongs to a different
+ *     account (#951).
+ *   - CID presence at best-block: a direct probe of the chunk's own content
+ *     hash, independent of account/nonce bookkeeping entirely. Catches
+ *     inclusion the nonce heuristic can miss (e.g. the endpoint used for the
+ *     nonce fetch is briefly behind a peer that already saw the tx land).
+ * Either signal alone is sufficient.
+ */
+declare function reconcileTimedOutChunk(opts: {
+    originalNonce: number | undefined;
+    currentNonce: number;
+    nonceHeuristicValid: boolean;
+    cidPresentAtBest: boolean | null;
+}): boolean;
+/**
+ * Chain-liveness gate (#1051). Polls `getBestBlockNumber` every
+ * CHUNK_LIVENESS_POLL_MS until height advances past `lastHeight`, or until
+ * `timeoutMs` elapses. Returns the last-observed height either way — never
+ * throws. `lastHeight === null` (couldn't determine a baseline) returns
+ * immediately without waiting: there's nothing to compare against, so
+ * waiting would just delay a resubmit decision for no benefit. A `null`
+ * result from `getBestBlockNumber` mid-wait (RPC failure) also returns
+ * immediately — fail open toward resubmitting rather than hanging on a dead
+ * peer.
+ */
+declare function waitForChainLiveness(client: any, lastHeight: number | null, timeoutMs: number, pollMs?: number): Promise<number | null>;
+/** Test-only alias — exported for unit tests that inject a short timeout/poll. */
+declare const __waitForChainLivenessForTest: typeof waitForChainLiveness;
 declare function storeFile(contentBytes: Uint8Array, { client: existingClient, unsafeApi: existingApi, signer: existingSigner, hashCode, }?: ExistingProvider & {
     hashCode?: number;
 }): Promise<string>;
@@ -474,4 +518,4 @@ declare function computePhoneSigningSteps(dotnsPreflight: {
     needsPopUpgrade: boolean;
 } | null, publishNeeded: boolean): string[];
 
-export { BLAKE2B_256_MULTIHASH_CODE, BULLETIN_ENDPOINTS, type BitswapErrorVariant, type BitswapProbeResult, 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, PhoneSignatureStep, SHA256_MULTIHASH_CODE, type SizeDecision, type StoreDirectoryOptions, WS_HEARTBEAT_TIMEOUT_MS, __assignDenseNoncesForTest, __selectStorageProviderModeForTest, applyManifestFetchAttributes, assertSubdomainOwnerMatchesSigner, browserUrlFor, buildFilesMap, checkDeploySize, chooseSignerInput, chunk, computePhoneSigningSteps, computeStorageCid, createCID, deploy, deriveRootSigner, detectFramework, encodeContenthash, encryptContent, estimateUploadBytes, formatStorageSignerLine, formatTransferModeDotnsLine, formatTransferModeStorageSignerLine, friendlyChainError, hasIPFS, interpretBitswapResult, isBenignTeardownError, isConnectionError, isPhoneSignerActive, makeBulletinStatusHandler, merkleize, probeP2pRetrieval, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, shouldHandoverName, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };
+export { BLAKE2B_256_MULTIHASH_CODE, BULLETIN_ENDPOINTS, type BitswapErrorVariant, type BitswapProbeResult, 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, PhoneSignatureStep, SHA256_MULTIHASH_CODE, type SizeDecision, type StoreDirectoryOptions, WS_HEARTBEAT_TIMEOUT_MS, __assignDenseNoncesForTest, __selectStorageProviderModeForTest, __waitForChainLivenessForTest, applyManifestFetchAttributes, assertSubdomainOwnerMatchesSigner, browserUrlFor, buildFilesMap, checkDeploySize, chooseSignerInput, chunk, computePhoneSigningSteps, computeStorageCid, createCID, deploy, deriveRootSigner, describeSlotFallbackReason, detectFramework, encodeContenthash, encryptContent, estimateUploadBytes, formatStorageSignerLine, formatTransferModeDotnsLine, formatTransferModeStorageSignerLine, friendlyChainError, hasIPFS, interpretBitswapResult, isBenignTeardownError, isConnectionError, isPhoneSignerActive, makeBulletinStatusHandler, merkleize, probeP2pRetrieval, reconcileTimedOutChunk, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, shouldHandoverName, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };

package/dist/deploy.js

@@ -14,6 +14,7 @@ import {
   WS_HEARTBEAT_TIMEOUT_MS,
   __assignDenseNoncesForTest,
   __selectStorageProviderModeForTest,
+  __waitForChainLivenessForTest,
   applyManifestFetchAttributes,
   assertSubdomainOwnerMatchesSigner,
   browserUrlFor,
@@ -26,6 +27,7 @@ import {
   createCID,
   deploy,
   deriveRootSigner,
+  describeSlotFallbackReason,
   detectFramework,
   encodeContenthash,
   encryptContent,
@@ -42,6 +44,7 @@ import {
   makeBulletinStatusHandler,
   merkleize,
   probeP2pRetrieval,
+  reconcileTimedOutChunk,
   resolveDotnsConnectOptions,
   resolveReproducibleTimestamp,
   retryBudgetExhausted,
@@ -52,29 +55,29 @@ import {
   storeDirectoryV2,
   storeFile,
   unpublish
-} from "./chunk-UUJFLJKY.js";
-import "./chunk-7RYEYWYO.js";
+} from "./chunk-N7KXNIH4.js";
+import "./chunk-JGS6QR5X.js";
 import "./chunk-GRPLHUYC.js";
 import "./chunk-HOTQDYHD.js";
 import "./chunk-IW3X2MJF.js";
 import "./chunk-KOSF5FDO.js";
 import "./chunk-J3NIXHZZ.js";
 import "./chunk-S7EM5VMW.js";
-import "./chunk-HTZGBUZA.js";
-import "./chunk-7E33R3OQ.js";
-import "./chunk-HLXRVFKL.js";
+import "./chunk-IR5BHZ2S.js";
+import "./chunk-UPA5PEQA.js";
+import "./chunk-FGCBIUMT.js";
 import "./chunk-C2TS5MER.js";
-import "./chunk-QDHLTSEO.js";
+import "./chunk-WVVRMGKN.js";
 import "./chunk-JQKKMUCT.js";
 import "./chunk-5FLTDWWP.js";
 import "./chunk-RIRDBSBG.js";
-import "./chunk-JWMHCW74.js";
+import "./chunk-NRSIBGBP.js";
 import "./chunk-TSPERKUS.js";
-import "./chunk-O4I37F5K.js";
+import "./chunk-S62H6TWE.js";
 import "./chunk-SI2ZUOYD.js";
-import "./chunk-MRQPJLPS.js";
-import "./chunk-53BU4X2R.js";
-import "./chunk-SES7CGNY.js";
+import "./chunk-XVQICFTB.js";
+import "./chunk-LRJTODL2.js";
+import "./chunk-DDC6NKE3.js";
 import "./chunk-JSYQ3JQS.js";
 import {
   EXIT_CODE_NO_RETRY,
@@ -98,6 +101,7 @@ export {
   WS_HEARTBEAT_TIMEOUT_MS,
   __assignDenseNoncesForTest,
   __selectStorageProviderModeForTest,
+  __waitForChainLivenessForTest,
   applyManifestFetchAttributes,
   assertSubdomainOwnerMatchesSigner,
   browserUrlFor,
@@ -110,6 +114,7 @@ export {
   createCID,
   deploy,
   deriveRootSigner,
+  describeSlotFallbackReason,
   detectFramework,
   encodeContenthash,
   encryptContent,
@@ -126,6 +131,7 @@ export {
   makeBulletinStatusHandler,
   merkleize,
   probeP2pRetrieval,
+  reconcileTimedOutChunk,
   resolveDotnsConnectOptions,
   resolveReproducibleTimestamp,
   retryBudgetExhausted,