@parity/product-deploy 0.8.1 → 0.8.2-rc.0

package/dist/{chunk-WPJADKC7.js → chunk-RRYHCOOJ.js}

@@ -11,7 +11,7 @@ import {
   extractManifestFromCar,
   fetchPreviousManifest,
   writePersistentLocalManifest
-} from "./chunk-L2SKSKB6.js";
+} from "./chunk-J3NIXHZZ.js";
 import {
   MANIFEST_PATH,
   MANIFEST_VERSION,
@@ -20,10 +20,10 @@ import {
 } from "./chunk-S7EM5VMW.js";
 import {
   setDeployContext
-} from "./chunk-MXMVZU2Q.js";
+} from "./chunk-CSDXTU3G.js";
 import {
   probeChunks
-} from "./chunk-KB3EII7F.js";
+} from "./chunk-4Y4ZBN45.js";
 import {
   packSection
 } from "./chunk-C2TS5MER.js";
@@ -35,15 +35,15 @@ import {
   parseDomainName,
   popStatusName,
   verifyNonceAdvanced
-} from "./chunk-IRT4A7OO.js";
+} from "./chunk-7GYCJPFI.js";
 import {
   derivePoolAccounts,
   detectTestnet,
   ensureAuthorized,
   fetchPoolAuthorizations,
-  selectAccount,
-  topUpBy
-} from "./chunk-RW3GWDGI.js";
+  isAuthorizationSufficient,
+  selectAccount
+} from "./chunk-JQ5X3VMP.js";
 import {
   VERSION,
   captureWarning,
@@ -57,13 +57,13 @@ import {
   truncateAddress,
   withDeploySpan,
   withSpan
-} from "./chunk-INVA3XGG.js";
+} from "./chunk-5EJ247OO.js";
 import {
   DEFAULT_ENV_ID,
   getPopSelfServeConfig,
   loadEnvironments,
   resolveEndpoints
-} from "./chunk-CNPB4VAM.js";
+} from "./chunk-XFX4VODU.js";
 import {
   NonRetryableError
 } from "./chunk-ZOC4GITL.js";
@@ -449,7 +449,7 @@ var __assignDenseNoncesForTest = assignDenseNonces;
 async function storeChunkedContent(chunks, { client: existingClient, unsafeApi: existingApi, signer: existingSigner, ss58: existingSS58, reconnect, fetchNonce: fetchNonceOverride, skipCids, probeFailedCids, gateway: providerGateway, trustedCids, skipRootStore } = {}) {
   const _fetchNonce = fetchNonceOverride ?? fetchNonce;
   console.log(`
-   Chunks: ${chunks.length}`);
+   Data chunks: ${chunks.length}`);
   const totalBytes = chunks.reduce((s, c) => s + c.length, 0);
   console.log(`   Total: ${(totalBytes / 1024).toFixed(2)} KB`);
   let client, unsafeApi, signer, ss58;
@@ -508,17 +508,14 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
       throw e;
     }
   }
-  const txsRemaining = uploadAuth ? BigInt(uploadAuth.extent.transactions_allowance) - BigInt(uploadAuth.extent.transactions) : 0n;
-  const bytesRemaining = uploadAuth ? BigInt(uploadAuth.extent.bytes_allowance) - BigInt(uploadAuth.extent.bytes) : 0n;
-  const isAuthorized = uploadAuth !== void 0 && Number(uploadAuth.expiration ?? 0) > currentBlockNum;
-  if (!isAuthorized || txsRemaining < requiredTxs || bytesRemaining < requiredBytes) {
-    const txsRemainingDisplay = txsRemaining < 0n ? 0n : txsRemaining;
-    const bytesRemainingDisplay = bytesRemaining < 0n ? 0n : bytesRemaining;
+  const needs = { txs: requiredTxs, bytes: requiredBytes };
+  const sufficient = await isAuthorizationSufficient(unsafeApi, ss58, uploadAuth, currentBlockNum, needs);
+  if (!sufficient) {
     console.log(`
-   Account needs re-authorization (authorized=${isAuthorized}, need ${requiredTxs} txs / ${(totalBytes / 1e6).toFixed(1)}MB, have ${txsRemainingDisplay} txs / ${(Number(bytesRemainingDisplay) / 1e6).toFixed(2)}MB)`);
+   Account needs re-authorization (need ${requiredTxs} txs / ${(totalBytes / 1e6).toFixed(1)}MB)`);
     console.log(`   Attempting to re-authorize with Alice...`);
     try {
-      await ensureAuthorized(unsafeApi, ss58, void 0, { txs: requiredTxs, bytes: requiredBytes });
+      await ensureAuthorized(unsafeApi, ss58, void 0, needs);
       console.log(`   Re-authorization successful`);
     } catch (e) {
       throw new NonRetryableError(`Account ${ss58} has insufficient Bulletin authorization and auto-authorization via Alice failed (${e.message}). Authorize the account on-chain.`);
@@ -583,7 +580,7 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
     const MAX_CHUNK_RETRIES = 3;
     const MAX_REPROBE_RETRIES = 3;
     console.log(`
-   Submitting ${chunks.length} chunks in batches of up to ${BATCH_SIZE_INITIAL}...`);
+   Submitting ${chunks.length} data chunks in batches of up to ${BATCH_SIZE_INITIAL}...`);
     const stored = new Array(chunks.length).fill(null);
     let tier2Verified = 0;
     let tier2Inconclusive = 0;
@@ -875,7 +872,7 @@ async function storeChunkedContent(chunks, { client: existingClient, unsafeApi:
     if (uploadReceipt) {
       setDeployAttribute("bulletin.upload.tx_hash", uploadReceipt.txHash);
       setDeployAttribute("bulletin.upload.block_hash", uploadReceipt.blockHash);
-      setDeployAttribute("bulletin.upload.block_number", uploadReceipt.blockNumber);
+      setDeployAttribute("bulletin.upload.block_number", String(uploadReceipt.blockNumber));
       console.log(`   Storage upload finalised @ block ${uploadReceipt.blockNumber} (tx ${uploadReceipt.txHash})`);
     }
     if (wsHaltDetected && reconnect && reconnectionsUsed < MAX_RECONNECTIONS) {
@@ -1109,7 +1106,8 @@ async function storeDirectoryV2(directoryPath, opts = {}) {
   sampleMemory("storage_start");
   const fetched = await fetchPreviousManifest(prevContenthash, {
     gateway,
-    domain: opts.domain
+    domain: opts.domain,
+    chainClient: opts.provider?.client
   });
   const prevManifest = fetched.source === "embedded" ? fetched.manifest : null;
   console.log(`   Manifest fetch: ${fetched.source}${fetched.source !== "none" ? ` (${fetched.attempts} attempt${fetched.attempts === 1 ? "" : "s"})` : ""}`);
@@ -1577,6 +1575,45 @@ async function unpublish(domainName, options = {}) {
     }
   }
 }
+function browserUrlFor(name, envId) {
+  const base = `https://${name}.dot.li`;
+  return envId === "preview" ? `${base}?network=previewnet` : base;
+}
+function interpretBitswapResult(outcome) {
+  if (outcome.ok) {
+    return { retrievable: true, errorVariant: "none" };
+  }
+  const err = outcome.error;
+  if (err != null && typeof err === "object" && "code" in err && err.code === -32810) {
+    return { retrievable: false, errorVariant: "not_found" };
+  }
+  if (err instanceof Error && err.message === "p2p_probe_timeout") {
+    return { retrievable: false, errorVariant: "timeout" };
+  }
+  return { retrievable: false, errorVariant: "error" };
+}
+async function probeP2pRetrieval(client, cid, timeoutMs = 3e3) {
+  const t0 = Date.now();
+  let outcome;
+  try {
+    const timeoutError = new Error("p2p_probe_timeout");
+    const response = await Promise.race([
+      client._request("bitswap_v1_get", [cid]),
+      new Promise((_, reject) => {
+        const t = setTimeout(() => reject(timeoutError), timeoutMs);
+        if (typeof t === "object" && t !== null && typeof t.unref === "function") {
+          t.unref();
+        }
+      })
+    ]);
+    outcome = { ok: true, response };
+  } catch (err) {
+    outcome = { ok: false, error: err };
+  }
+  const durationMs = Date.now() - t0;
+  const { retrievable, errorVariant } = interpretBitswapResult(outcome);
+  return { retrievable, errorVariant, durationMs };
+}
 async function deploy(content, domainName = null, options = {}) {
   if (options.signer && options.signerAddress && options.mnemonic) {
     throw new NonRetryableError("Pass either a mnemonic or an external signer, not both \u2014 they identify the signing account and only one can win.");
@@ -1708,17 +1745,8 @@ async function deploy(content, domainName = null, options = {}) {
       }
       provider = await reconnect();
       const providerWithReconnect = { ...provider, reconnect };
-      const [isTestnet, estimated] = await Promise.all([
-        detectTestnet(provider.unsafeApi),
-        estimateUploadBytes(content)
-      ]);
+      const isTestnet = await detectTestnet(provider.unsafeApi);
       setDeployAttribute("deploy.is_testnet", isTestnet ? "true" : "false");
-      if (isTestnet && estimated != null) {
-        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.unsafeApi, provider.ss58, needs, "uploader");
-      }
       console.log("\n" + "=".repeat(60));
       console.log("Storage");
       console.log("=".repeat(60));
@@ -1928,6 +1956,17 @@ async function deploy(content, domainName = null, options = {}) {
         }
         dotns.disconnect();
       });
+      await withSpan("deploy.p2p-check", "3. p2p-check", { "deploy.domain": name }, async () => {
+        const probe = await probeP2pRetrieval(provider.client, cid);
+        setDeployAttribute("deploy.p2p.retrievable", probe.retrievable ? "true" : "false");
+        setDeployAttribute("deploy.p2p.check_ms", String(probe.durationMs));
+        setDeployAttribute("deploy.p2p.error_variant", probe.errorVariant);
+        if (probe.retrievable) {
+          console.log(`   P2P retrieval: \u2713 (${probe.durationMs}ms)`);
+        } else {
+          console.log(`   P2P retrieval: \u26A0 not yet retrievable (${probe.errorVariant}, ${probe.durationMs}ms)`);
+        }
+      });
       if (options.ghPagesMirror) {
         console.log("\n" + "=".repeat(60));
         console.log("Final checks");
@@ -1967,7 +2006,7 @@ async function deploy(content, domainName = null, options = {}) {
       console.log("=".repeat(60));
       console.log("\n\u{1F53A} Polkadot Triangle");
       console.log(`   - Polkadot Desktop: ${name}.dot`);
-      console.log(`   - Polkadot Browser: https://${name}.dot.li`);
+      console.log(`   - Polkadot Browser: ${browserUrlFor(name, envId)}`);
       console.log("\n" + "=".repeat(60) + "\n");
       return { domainName: name, fullDomain: `${name}.dot`, cid, ipfsCid };
     } finally {
@@ -2289,7 +2328,7 @@ async function buildOrderedCar(options) {
   const s1Bytes = section1Chunks.reduce((s, b) => s + b.length, 0);
   const s2Bytes = section2Chunks.reduce((s, b) => s + b.length, 0);
   console.log(
-    `   CAR (3-section): ${(carBytes.length / 1024 / 1024).toFixed(2)} MB (s0=${section0Bytes.length}B s1=${s1Bytes}B s2=${s2Bytes}B), ${allChunks.length} chunks (${section0Chunks.length}+${section1Chunks.length}+${section2Chunks.length})`
+    `   CAR (3-section): ${(carBytes.length / 1024 / 1024).toFixed(2)} MB (s0=${section0Bytes.length}B s1=${s1Bytes}B s2=${s2Bytes}B), ${allChunks.length} frames (${section0Chunks.length} header + ${section1Chunks.length} data + ${section2Chunks.length} manifest)`
   );
   return {
     carBytes,
@@ -2407,5 +2446,8 @@ export {
   estimateUploadBytes,
   assertSubdomainOwnerMatchesSigner,
   unpublish,
+  browserUrlFor,
+  interpretBitswapResult,
+  probeP2pRetrieval,
   deploy
 };

package/dist/{chunk-CNPB4VAM.js → chunk-XFX4VODU.js}

@@ -453,6 +453,34 @@ function isValidDoc(value) {
   const v = value;
   return Array.isArray(v.environments) && Array.isArray(v.chains);
 }
+function deepMergeEnvironments(base, override) {
+  const mergedEnvironments = mergeById(base.environments, override.environments ?? []);
+  const mergedChains = mergeById(base.chains, override.chains ?? []);
+  return { environments: mergedEnvironments, chains: mergedChains };
+}
+function mergeById(base, overrides) {
+  const result = base.map((b) => {
+    const ov = overrides.find((o) => o.id === b.id);
+    return ov ? mergeObjects(b, ov) : b;
+  });
+  for (const ov of overrides) {
+    if (!base.find((b) => b.id === ov.id)) result.push(ov);
+  }
+  return result;
+}
+function mergeObjects(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const ov = override[key];
+    const bs = base[key];
+    if (ov !== null && typeof ov === "object" && !Array.isArray(ov) && bs !== null && typeof bs === "object" && !Array.isArray(bs)) {
+      result[key] = { ...bs, ...ov };
+    } else {
+      result[key] = ov;
+    }
+  }
+  return result;
+}
 async function readBundled(bundledPath, capture) {
   try {
     const raw = await fs.readFile(bundledPath, "utf8");
@@ -468,6 +496,42 @@ async function loadEnvironments(opts = {}) {
   const warn = opts.warn ?? ((msg) => console.error(msg));
   const capture = opts.capture ?? (() => {
   });
+  const userFilePath = opts.userFilePath ?? process.env.BULLETIN_DEPLOY_ENV_FILE;
+  if (userFilePath) {
+    let raw;
+    try {
+      raw = await fs.readFile(userFilePath, "utf8");
+    } catch (err) {
+      throw new NonRetryableError(
+        `--environment-file: cannot read "${userFilePath}": ${err?.message ?? err}`
+      );
+    }
+    let userDoc;
+    try {
+      userDoc = JSON.parse(raw);
+    } catch (err) {
+      throw new NonRetryableError(
+        `--environment-file: "${userFilePath}" is not valid JSON: ${err?.message ?? err}`
+      );
+    }
+    const base = await readBundled(bundledPath, capture);
+    const baseDoc = base ?? (isValidDoc(environments_default) ? environments_default : HARDCODED_FALLBACK);
+    const partial = userDoc && typeof userDoc === "object" && !Array.isArray(userDoc) ? userDoc : {};
+    const merged = deepMergeEnvironments(baseDoc, partial);
+    warn(
+      `bulletin-deploy: Using user-supplied environment file "${userFilePath}" \u2014 values are NOT validated against chain; you own correctness.`
+    );
+    for (const env of merged.environments) {
+      if (env.contracts && Object.keys(env.contracts).length > 0) {
+        try {
+          validateContractAddresses(env.contracts, env.id);
+        } catch (err) {
+          warn(`bulletin-deploy: Warning: ${err?.message ?? err}`);
+        }
+      }
+    }
+    return { doc: merged, source: "file" };
+  }
   const bundled = await readBundled(bundledPath, capture);
   if (bundled) return { doc: bundled, source: "bundled" };
   if (isValidDoc(environments_default)) {
@@ -584,6 +648,7 @@ export {
   defaultBundledPath,
   isValidContractAddress,
   validateContractAddresses,
+  deepMergeEnvironments,
   loadEnvironments,
   resolveEndpoints,
   getPopSelfServeConfig,

package/dist/chunk-probe.js

@@ -5,9 +5,9 @@ import {
   _decodeStorageValue,
   _resetProbeSession,
   probeChunks
-} from "./chunk-KB3EII7F.js";
-import "./chunk-INVA3XGG.js";
-import "./chunk-V5N5EYNV.js";
+} from "./chunk-4Y4ZBN45.js";
+import "./chunk-5EJ247OO.js";
+import "./chunk-N27JUWU2.js";
 export {
   ChainProbeCrossValidationError,
   ChainProbeMetadataError,

package/dist/deploy.d.ts

@@ -303,6 +303,43 @@ declare function unpublish(domainName: string, options?: {
     status: "unpublished" | "already-unpublished";
     txHash?: string;
 }>;
+/**
+ * Returns the dot.li browser URL for the given domain name, optionally
+ * suffixed with a network query parameter so the SPA opens the right chain.
+ * Currently only the "preview" env needs a suffix — the SPA defaults to
+ * paseo-next-v2 which would show "no content" for preview deployments.
+ * @param name - the DotNS label (e.g. "myapp")
+ * @param envId - the environment id from options.env ?? DEFAULT_ENV_ID
+ */
+declare function browserUrlFor(name: string, envId: string | undefined): string;
+type BitswapErrorVariant = "none" | "not_found" | "timeout" | "error";
+interface BitswapProbeResult {
+    retrievable: boolean;
+    errorVariant: BitswapErrorVariant;
+    durationMs: number;
+}
+/**
+ * Pure classifier — maps a raw response or thrown error to {retrievable, errorVariant}.
+ * Exported for unit tests; does NOT touch telemetry or console.
+ */
+declare function interpretBitswapResult(outcome: {
+    ok: true;
+    response: unknown;
+} | {
+    ok: false;
+    error: unknown;
+}): {
+    retrievable: boolean;
+    errorVariant: BitswapErrorVariant;
+};
+/**
+ * Calls bitswap_v1_get on the bulletin RPC client for the given base32 CIDv1 string.
+ * Never throws — wraps every outcome in BitswapProbeResult.
+ * @param client - polkadot-api client (ProviderResult.client)
+ * @param cid    - base32 CIDv1 string (e.g. "bafyrei...")
+ * @param timeoutMs - safety ceiling; the RPC typically responds in ~600ms
+ */
+declare function probeP2pRetrieval(client: any, cid: string, timeoutMs?: number): Promise<BitswapProbeResult>;
 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, type SizeDecision, type StoreDirectoryOptions, __assignDenseNoncesForTest, __selectStorageProviderModeForTest, applyManifestFetchAttributes, assertSubdomainOwnerMatchesSigner, buildFilesMap, checkDeploySize, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, detectFramework, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, isConnectionError, merkleize, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };
+export { 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, type SizeDecision, type StoreDirectoryOptions, __assignDenseNoncesForTest, __selectStorageProviderModeForTest, applyManifestFetchAttributes, assertSubdomainOwnerMatchesSigner, browserUrlFor, buildFilesMap, checkDeploySize, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, detectFramework, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, interpretBitswapResult, isConnectionError, merkleize, probeP2pRetrieval, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };

package/dist/deploy.js

@@ -12,6 +12,7 @@ import {
   __selectStorageProviderModeForTest,
   applyManifestFetchAttributes,
   assertSubdomainOwnerMatchesSigner,
+  browserUrlFor,
   buildFilesMap,
   checkDeploySize,
   chunk,
@@ -25,8 +26,10 @@ import {
   estimateUploadBytes,
   friendlyChainError,
   hasIPFS,
+  interpretBitswapResult,
   isConnectionError,
   merkleize,
+  probeP2pRetrieval,
   resolveDotnsConnectOptions,
   resolveReproducibleTimestamp,
   retryBudgetExhausted,
@@ -36,20 +39,20 @@ import {
   storeDirectoryV2,
   storeFile,
   unpublish
-} from "./chunk-WPJADKC7.js";
+} from "./chunk-RRYHCOOJ.js";
 import "./chunk-IW3X2MJF.js";
 import "./chunk-KOSF5FDO.js";
-import "./chunk-L2SKSKB6.js";
+import "./chunk-J3NIXHZZ.js";
 import "./chunk-S7EM5VMW.js";
-import "./chunk-MXMVZU2Q.js";
-import "./chunk-O2BFXY3Y.js";
-import "./chunk-KB3EII7F.js";
+import "./chunk-CSDXTU3G.js";
+import "./chunk-R2ORPNZC.js";
+import "./chunk-4Y4ZBN45.js";
 import "./chunk-C2TS5MER.js";
-import "./chunk-IRT4A7OO.js";
-import "./chunk-RW3GWDGI.js";
-import "./chunk-INVA3XGG.js";
-import "./chunk-V5N5EYNV.js";
-import "./chunk-CNPB4VAM.js";
+import "./chunk-7GYCJPFI.js";
+import "./chunk-JQ5X3VMP.js";
+import "./chunk-5EJ247OO.js";
+import "./chunk-N27JUWU2.js";
+import "./chunk-XFX4VODU.js";
 import {
   EXIT_CODE_NO_RETRY,
   NonRetryableError
@@ -71,6 +74,7 @@ export {
   __selectStorageProviderModeForTest,
   applyManifestFetchAttributes,
   assertSubdomainOwnerMatchesSigner,
+  browserUrlFor,
   buildFilesMap,
   checkDeploySize,
   chunk,
@@ -84,8 +88,10 @@ export {
   estimateUploadBytes,
   friendlyChainError,
   hasIPFS,
+  interpretBitswapResult,
   isConnectionError,
   merkleize,
+  probeP2pRetrieval,
   resolveDotnsConnectOptions,
   resolveReproducibleTimestamp,
   retryBudgetExhausted,

package/dist/dotns.d.ts

@@ -94,7 +94,7 @@ interface DotnsPreflightResult {
 declare const MINIMUM_REGISTER_STORAGE_DEPOSIT = 2000000000000n;
 declare function fmtPas(plancks: bigint): string;
 type DotnsSuccessAction = Exclude<DotnsPreflightResult["plannedAction"], "abort">;
-declare function feeFloorFor(plannedAction: DotnsSuccessAction, storageDeposit?: bigint): bigint;
+declare function feeFloorFor(plannedAction: DotnsSuccessAction, storageDeposit?: bigint, rentPriceNative?: bigint): bigint;
 declare const RPC_ENDPOINTS: string[];
 declare const CONTRACTS: {
     readonly DOTNS_REGISTRAR: "0x329aAA5b6bEa94E750b2dacBa74Bf41291E6c2BD";
@@ -117,6 +117,25 @@ declare const TX_NO_PROGRESS_MS: number;
 declare const WS_HEARTBEAT_TIMEOUT_MS: number;
 declare const DOTNS_TX_MAX_ATTEMPTS: number;
 declare function classifyTxRetryDecision(err: unknown): "retry" | "abort";
+declare function dotnsRetryBackoffMs(attempt: number, rand?: () => number): number;
+/** Wraps `sink` so that "failed" status events are buffered and only forwarded
+ *  when `flush()` is called (i.e. on final abort). All other statuses pass
+ *  through immediately. Call `reset()` at the top of each retry attempt to
+ *  discard a buffered "failed" from the previous attempt.
+ *
+ *  Closes two leak paths (issue #704):
+ *  1. Retry-recovered: attempt N emits "failed" before throwing; a later attempt
+ *     succeeds → reset() at the top of the next iteration discards the buffer,
+ *     and flush() is never called on the success return → sink never sees it.
+ *  2. Late watcher event: papi can emit a delayed drop/reorg after
+ *     signAndSubmitExtrinsic has already resolved with "finalized"; the buffer
+ *     is never flushed on the success path → silently dropped.
+ */
+declare function makeRetryStatusFilter(sink: (status: string) => void): {
+    callback: (status: string) => void;
+    flush: () => void;
+    reset: () => void;
+};
 declare const DEFAULT_MNEMONIC: string;
 declare function fetchNonce(rpc: string | string[], ss58Address: string): Promise<number>;
 declare function verifyNonceAdvanced(endpoints: string[], ss58Address: string, originalNonce: number): Promise<{
@@ -257,6 +276,7 @@ declare class ReviveClientWrapper {
     getEvmAddress(substrateAddress: string): Promise<string>;
     performDryRunCall(originSubstrateAddress: string, contractAddress: string, value: bigint, encodedData: string): Promise<any>;
     estimateGasForCall(originSubstrateAddress: string, contractAddress: string, value: bigint, encodedData: string): Promise<any>;
+    hasContractCode(address: string): Promise<boolean | null>;
     checkIfAccountMapped(substrateAddress: string): Promise<boolean>;
     ensureAccountMapped(substrateAddress: string, signer: PolkadotSigner): Promise<void>;
     signAndSubmitExtrinsic(extrinsic: any, signer: PolkadotSigner, statusCallback: (status: string) => void, opts?: {
@@ -392,6 +412,17 @@ declare class DotNS {
     ensureMappedAccountReady(autoAccountMapping?: boolean): Promise<void>;
     ensureAutoMappedAccountReady(): Promise<void>;
     ensureConnected(): void;
+    /**
+     * Resolve the authoritative nativeToEthRatio for this session.
+     *
+     * Priority: chain constant (Revive.NativeToEthRatio) > options.nativeToEthRatio > default.
+     * On mismatch between the env-configured value and the chain value, logs a WARNING naming
+     * both values and proceeds with the chain value (it is the source of truth).
+     * On query failure, falls back to the configured/default value without throwing.
+     *
+     * Must be called after clientWrapper is established (i.e. inside connect()).
+     */
+    resolveNativeToEthRatio(options: DotNSConnectOptions): Promise<void>;
     private _testnetCache;
     isTestnet(): Promise<boolean>;
     /**
@@ -529,4 +560,4 @@ declare class DotNS {
 }
 declare const dotns: DotNS;
 
-export { ATTR_TX_RESOLUTION_KIND, type AliasAccountClassification, type AliasAccountState, CONNECTION_TIMEOUT_MS, CONTRACTS, ContractDryRunRevertError, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsPreflightResult, type DotnsSuccessAction, MINIMUM_REGISTER_STORAGE_DEPOSIT, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, PUBLISHER_ABI, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, PublisherNotSupportedError, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_KIND_HASH, TX_KIND_NONCE_ADVANCED, TX_NO_PROGRESS_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, type TxResolution, WS_HEARTBEAT_TIMEOUT_MS, __formatContractDryRunFailureForTest, canRegister, classifyAliasAccountRow, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertToHexString, convertWeiToNative, countTrailingDigits, decodePublisherRevert, dotns, feeFloorFor, fetchNonce, fmtPas, formatDispatchError, formatPersonhoodRemediation, formatPopShortfallReason, isCommitmentMature, isCommitmentTimingBarerevert, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, sanitizeDomainLabel, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };
+export { ATTR_TX_RESOLUTION_KIND, type AliasAccountClassification, type AliasAccountState, CONNECTION_TIMEOUT_MS, CONTRACTS, ContractDryRunRevertError, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsPreflightResult, type DotnsSuccessAction, MINIMUM_REGISTER_STORAGE_DEPOSIT, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, PUBLISHER_ABI, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, PublisherNotSupportedError, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_KIND_HASH, TX_KIND_NONCE_ADVANCED, TX_NO_PROGRESS_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, type TxResolution, WS_HEARTBEAT_TIMEOUT_MS, __formatContractDryRunFailureForTest, canRegister, classifyAliasAccountRow, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertToHexString, convertWeiToNative, countTrailingDigits, decodePublisherRevert, dotns, dotnsRetryBackoffMs, feeFloorFor, fetchNonce, fmtPas, formatDispatchError, formatPersonhoodRemediation, formatPopShortfallReason, isCommitmentMature, isCommitmentTimingBarerevert, makeRetryStatusFilter, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, sanitizeDomainLabel, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };

package/dist/dotns.js

@@ -33,6 +33,7 @@ import {
   countTrailingDigits,
   decodePublisherRevert,
   dotns,
+  dotnsRetryBackoffMs,
   feeFloorFor,
   fetchNonce,
   fmtPas,
@@ -41,6 +42,7 @@ import {
   formatPopShortfallReason,
   isCommitmentMature,
   isCommitmentTimingBarerevert,
+  makeRetryStatusFilter,
   parseDomainName,
   parseProofOfPersonhoodStatus,
   popStatusName,
@@ -48,11 +50,11 @@ import {
   stripTrailingDigits,
   validateDomainLabel,
   verifyNonceAdvanced
-} from "./chunk-IRT4A7OO.js";
-import "./chunk-RW3GWDGI.js";
-import "./chunk-INVA3XGG.js";
-import "./chunk-V5N5EYNV.js";
-import "./chunk-CNPB4VAM.js";
+} from "./chunk-7GYCJPFI.js";
+import "./chunk-JQ5X3VMP.js";
+import "./chunk-5EJ247OO.js";
+import "./chunk-N27JUWU2.js";
+import "./chunk-XFX4VODU.js";
 import "./chunk-ZOC4GITL.js";
 export {
   ATTR_TX_RESOLUTION_KIND,
@@ -89,6 +91,7 @@ export {
   countTrailingDigits,
   decodePublisherRevert,
   dotns,
+  dotnsRetryBackoffMs,
   feeFloorFor,
   fetchNonce,
   fmtPas,
@@ -97,6 +100,7 @@ export {
   formatPopShortfallReason,
   isCommitmentMature,
   isCommitmentTimingBarerevert,
+  makeRetryStatusFilter,
   parseDomainName,
   parseProofOfPersonhoodStatus,
   popStatusName,

package/dist/environments.d.ts

@@ -44,13 +44,15 @@ interface EnvironmentsDoc {
     environments: Environment[];
     chains: Chain[];
 }
-type EnvironmentsSource = "bundled" | "hardcoded-fallback";
+type EnvironmentsSource = "bundled" | "hardcoded-fallback" | "file";
 interface LoadResult {
     doc: EnvironmentsDoc;
     source: EnvironmentsSource;
 }
 interface LoadOptions {
     bundledPath?: string;
+    /** Explicit path to a user-supplied environments JSON file (deep-merged over bundled). */
+    userFilePath?: string;
     warn?: (msg: string) => void;
     capture?: (err: unknown) => void;
 }
@@ -86,6 +88,17 @@ declare function isValidContractAddress(addr: unknown): boolean;
  * @param envId      The environment ID, used in the error message.
  */
 declare function validateContractAddresses(contracts: Record<string, string>, envId: string): void;
+/**
+ * Deep-merges a user-supplied partial EnvironmentsDoc over a base doc.
+ *
+ * - `environments` and `chains` arrays are merged by `id`: a user entry with a
+ *   matching id is recursively merged into the base entry; unmatched user entries
+ *   are appended.
+ * - Within each entry, nested plain objects (e.g. `contracts`, `endpoints`) are
+ *   merged key-by-key; scalars and arrays (e.g. `wss`) replace wholesale.
+ * - Top-level fields not present in the user doc are kept from base.
+ */
+declare function deepMergeEnvironments(base: EnvironmentsDoc, override: Partial<EnvironmentsDoc>): EnvironmentsDoc;
 declare function loadEnvironments(opts?: LoadOptions): Promise<LoadResult>;
 declare function resolveEndpoints(doc: EnvironmentsDoc, envId: string): ResolvedEndpoints;
 declare function getPopSelfServeConfig(doc: EnvironmentsDoc, envId: string): PopSelfServeConfig | null;
@@ -99,4 +112,4 @@ interface EnvironmentListing {
 declare function listEnvironments(doc: EnvironmentsDoc): EnvironmentListing[];
 declare function formatEnvironmentTable(rows: EnvironmentListing[]): string;
 
-export { type Chain, type ChainEndpoint, DEFAULT_ENV_ID, type Environment, type EnvironmentListing, type EnvironmentsDoc, type EnvironmentsSource, type LoadOptions, type LoadResult, type PopSelfServeConfig, type ResolvedEndpoints, defaultBundledPath, formatEnvironmentTable, getPopSelfServeConfig, isValidContractAddress, listEnvironments, loadEnvironments, resolveEndpoints, validateContractAddresses };
+export { type Chain, type ChainEndpoint, DEFAULT_ENV_ID, type Environment, type EnvironmentListing, type EnvironmentsDoc, type EnvironmentsSource, type LoadOptions, type LoadResult, type PopSelfServeConfig, type ResolvedEndpoints, deepMergeEnvironments, defaultBundledPath, formatEnvironmentTable, getPopSelfServeConfig, isValidContractAddress, listEnvironments, loadEnvironments, resolveEndpoints, validateContractAddresses };

package/dist/environments.js

@@ -1,5 +1,6 @@
 import {
   DEFAULT_ENV_ID,
+  deepMergeEnvironments,
   defaultBundledPath,
   formatEnvironmentTable,
   getPopSelfServeConfig,
@@ -8,10 +9,11 @@ import {
   loadEnvironments,
   resolveEndpoints,
   validateContractAddresses
-} from "./chunk-CNPB4VAM.js";
+} from "./chunk-XFX4VODU.js";
 import "./chunk-ZOC4GITL.js";
 export {
   DEFAULT_ENV_ID,
+  deepMergeEnvironments,
   defaultBundledPath,
   formatEnvironmentTable,
   getPopSelfServeConfig,

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { ChainProbeOptions, ChunkProbeResult, probeChunks } from './chunk-probe.
 export { finaliseEmbeddedManifest, writeEmbeddedManifestPlaceholder } from './manifest-embed.js';
 export { FetchOptions, FetchOutcome, fetchPreviousManifest } from './manifest-fetch.js';
 export { ComputeStatsInput, IncrementalStats, computeStats, renderSummary, telemetryAttributes } from './incremental-stats.js';
-export { Chain, ChainEndpoint, DEFAULT_ENV_ID, Environment, EnvironmentListing, EnvironmentsDoc, EnvironmentsSource, LoadOptions, LoadResult, ResolvedEndpoints, defaultBundledPath, formatEnvironmentTable, isValidContractAddress, listEnvironments, loadEnvironments, resolveEndpoints, validateContractAddresses } from './environments.js';
+export { Chain, ChainEndpoint, DEFAULT_ENV_ID, Environment, EnvironmentListing, EnvironmentsDoc, EnvironmentsSource, LoadOptions, LoadResult, ResolvedEndpoints, deepMergeEnvironments, defaultBundledPath, formatEnvironmentTable, isValidContractAddress, listEnvironments, loadEnvironments, resolveEndpoints, validateContractAddresses } from './environments.js';
 export { RunState, RunStatus, VERSION, loadRunState, probablyOomRssMb, resolveStateDir, shouldShowOomHint, shouldSkipStaleWarning, stateFilePath, writeRunState } from './run-state.js';
 export { AppExecutableConfig, AppManifest, AppVersion, ExecutableConfig, ExecutableKind, ExecutableManifest, Icon, IconConfig, IconFormat, ProductConfig, RootManifest, WidgetDimensions, WidgetExecutableConfig, WidgetManifest, WorkerExecutableConfig, WorkerIncludes, WorkerManifest, defineConfig } from './manifest/types.js';
 export { ValidationErr, ValidationOk, ValidationResult, validateExecutableManifest, validateProductConfig, validateRootManifest } from './manifest/schema.js';