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

package/dist/{chunk-V5N5EYNV.js → chunk-NJPBXF5Z.js}

@@ -6,7 +6,7 @@ import * as path from "path";
 // package.json
 var package_default = {
   name: "@parity/product-deploy",
-  version: "0.8.1",
+  version: "0.8.2-rc.1",
   private: false,
   repository: {
     type: "git",
@@ -35,6 +35,10 @@ var package_default = {
     "./manifest-roundtrip": {
       types: "./dist/manifest-roundtrip.d.ts",
       import: "./dist/manifest-roundtrip.js"
+    },
+    "./telemetry": {
+      types: "./dist/telemetry.d.ts",
+      import: "./dist/telemetry.js"
     }
   },
   files: [
@@ -47,9 +51,8 @@ var package_default = {
   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 src/environments.ts src/errors.ts src/manifest.ts src/chunk-probe.ts src/manifest-embed.ts src/manifest-fetch.ts src/manifest-roundtrip.ts src/incremental-stats.ts src/chunker.ts src/personhood/encoding.ts src/personhood/hashing.ts src/personhood/constants.ts src/personhood/member-key.ts src/personhood/people-client.ts src/personhood/proof-validity.ts src/personhood/reprove.ts src/personhood/bind-personal-id.ts src/personhood/claim-pgas.ts src/personhood/bind-paid-alias.ts src/personhood/bootstrap.ts src/personhood/chain-prereqs.ts src/manifest/types.ts src/manifest/schema.ts src/manifest/byte-budget.ts src/manifest/config-load.ts src/manifest/publish.ts --format esm --dts --clean --target node22",
     "refresh-environments": "node scripts/refresh-environments.mjs",
-    "check:watched-dependencies": "node tools/check-watched-dependencies.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/environments.test.js test/refresh-environments.test.js test/watched-dependencies.test.js test/chunk-sharing-report.test.js test/product-manifest.test.js test/cache-savings-totals.test.js test/error-pattern-signature.test.js test/exit-codes.test.js test/probe-env-health.test.js test/e2e-chain-calls.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/refresh-environments.test.js test/chunk-sharing-report.test.js test/product-manifest.test.js test/cache-savings-totals.test.js test/error-pattern-signature.test.js test/exit-codes.test.js test/probe-env-health.test.js test/e2e-chain-calls.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",

package/dist/{chunk-INVA3XGG.js → chunk-RIAMPAL2.js}

@@ -1,7 +1,7 @@
 import {
   package_default,
   writeRunState
-} from "./chunk-V5N5EYNV.js";
+} from "./chunk-NJPBXF5Z.js";
 
 // src/memory-report.ts
 import * as fs2 from "fs";
@@ -185,94 +185,104 @@ function resolveRunnerType() {
   if (process.env.RUNNER_NAME?.startsWith("parity-")) return "self-hosted";
   return "github-hosted";
 }
+var DEPLOY_SEED_OUTCOME = {
+  "deploy.sad": "false",
+  "deploy.expected": "false"
+};
+var DEPLOY_SEED_RPC = {
+  "deploy.rpc.failed_over": "false"
+};
+var DEPLOY_SEED_DOTNS = {
+  // Preflight balance gate. Seeded "false" so successful spans form the denominator
+  // for "% hitting the floor" and "% recovered via testnet auto-top-up". Flipped by gateOnFeeBalance.
+  "deploy.dotns.signer_below_floor": "false",
+  "deploy.dotns.toppedup": "false",
+  // Seeded "hash" so spans for non-DotNS deploys group cleanly in the "hash" bucket.
+  "deploy.dotns.tx_resolution_kind": "hash",
+  // Backend identity (module constants — stable across calls).
+  "deploy.dotns_backend": DOTNS_BACKEND,
+  "deploy.dotns_pop_source": DOTNS_POP_SOURCE
+};
+var DEPLOY_SEED_CONTENT = {
+  // Flipped by deploy.ts storage phase when content is encrypted.
+  "deploy.encrypted": "false",
+  // Flipped by deploy.ts after parseDomainName resolves isSubdomain.
+  "deploy.subdomain": "false",
+  // Flipped by deploy.ts after readPreviousContenthashSafe when a prior CID is found.
+  "deploy.incremental": "false"
+};
+var DEPLOY_SEED_STORAGE = {
+  // Seeded "false"; flipped by storeDirectoryV2 when Phase A root node is already on-chain.
+  "deploy.storage.phase_a.root_already_onchain": "false",
+  // Seeded 0; incremented per Phase B chunk confirmed on-chain (probe hit → skip re-upload).
+  "deploy.storage.phase_b.probe_hit_count": 0,
+  "deploy.phase_a.chunks_uploaded": 0,
+  // Manifest-aware Phase A trust: count of section-1 CIDs trusted from prev manifest.
+  "deploy.phase_a.chunks_trusted": 0
+};
+var DEPLOY_SEED_PROBE = {
+  "deploy.probe.finality_miss_count": 0,
+  "deploy.probe.finality_miss_reupload_count": 0
+};
+var DEPLOY_SEED_POOL = {
+  "deploy.pool.eligible_count": 0,
+  // Nonce-advance collision probe counters. Seeded 0 so every span carries them.
+  "deploy.pool.nonce_collision_count": 0,
+  "deploy.pool.nonce_collision_missing": 0,
+  "deploy.pool.nonce_collision_reupload_count": 0
+};
+var DEPLOY_SEED_MANIFEST = {
+  "deploy.manifest.fetch_source": "none",
+  "deploy.manifest.fetch_attempts": "0",
+  "deploy.manifest.bytes_downloaded": "0"
+};
+var DEPLOY_SEED_BULLETIN_UPLOAD = {
+  "bulletin.upload.tx_hash": "",
+  "bulletin.upload.block_hash": "",
+  "bulletin.upload.block_number": ""
+};
+var DEPLOY_SEED_RECEIPTS = {
+  "deploy.contenthash.tx": "",
+  "deploy.contenthash.block": "",
+  "deploy.contenthash.block_hash": "",
+  "deploy.register.tx": "",
+  "deploy.register.block": "",
+  "deploy.register.block_hash": "",
+  "deploy.subnode.tx": "",
+  "deploy.subnode.block": "",
+  "deploy.subnode.block_hash": ""
+};
+var DEPLOY_SEED_P2P = {
+  "deploy.p2p.retrievable": "false",
+  "deploy.p2p.check_ms": "0",
+  "deploy.p2p.error_variant": "none"
+};
 function getDeployAttributes(domain) {
   const hostApp = process.env.BULLETIN_DEPLOY_HOST_APP;
   const attrs = {
+    ...DEPLOY_SEED_OUTCOME,
+    ...DEPLOY_SEED_RPC,
+    ...DEPLOY_SEED_DOTNS,
+    ...DEPLOY_SEED_CONTENT,
+    ...DEPLOY_SEED_STORAGE,
+    ...DEPLOY_SEED_PROBE,
+    ...DEPLOY_SEED_POOL,
+    ...DEPLOY_SEED_MANIFEST,
+    ...DEPLOY_SEED_BULLETIN_UPLOAD,
+    ...DEPLOY_SEED_RECEIPTS,
+    ...DEPLOY_SEED_P2P,
+    // Computed at call time (depend on domain arg, env vars, or external process calls):
     "deploy.repo": sanitizeRepo(resolveRepo(domain)),
     "deploy.branch": sanitizeBranch(process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || tryGitBranch()),
     "deploy.source": process.env.CI ? "ci" : "local",
     "deploy.pr": process.env.GITHUB_PR_NUMBER || void 0,
     "deploy.tool_version": VERSION,
     "deploy.runner": resolveRunner(),
-    "deploy.runner_type": resolveRunnerType(),
-    // Seed "false" so successful spans form the %SAD denominator; the catch block and
-    // captureWarning flip it to "true" on friction.
-    "deploy.sad": "false",
-    // Same ratio-denominator reasoning as deploy.sad above, but for the
-    // %EXPECTED-refusal metric: catch block flips to "true" when the error
-    // matches isExpectedError (user-facing product rule, not tool friction).
-    "deploy.expected": "false",
-    // Seed "false" so every span carries the attribute (boolean-both-values rule).
-    // Flipped to "true" by getWsProvider's onStatusChanged when papi connects to a
-    // non-primary endpoint, and flushed again in deploy()'s finally block.
-    "deploy.rpc.failed_over": "false",
-    // DotNS preflight balance gate. Seeded "false" so successful spans form the
-    // denominator for "% of deploys hitting the floor" and "% recovered via
-    // testnet auto-top-up" metrics. Flipped by gateOnFeeBalance.
-    "deploy.dotns.signer_below_floor": "false",
-    "deploy.dotns.toppedup": "false",
-    // Seeded "false" so every span carries the attribute for ratio queries.
-    // Flipped to "true" by pool.ts ensureAuthorized / topUpBy when authorize_account
-    // actually submits (i.e. re-auth was needed, not short-circuited).
-    "deploy.unblock.bulletin_auth.fired": "false",
-    // Seeded "hash" so spans missing an explicit set (non-DotNS deploys) group
-    // cleanly in the "hash" bucket.
-    "deploy.dotns.tx_resolution_kind": "hash",
-    // Seeded "false" so every span carries the attribute for ratio queries.
-    // Flipped by deploy.ts storage phase when content is encrypted.
-    "deploy.encrypted": "false",
-    // Flipped by deploy.ts after parseDomainName resolves isSubdomain.
-    "deploy.subdomain": "false",
-    // Flipped by deploy.ts after readPreviousContenthashSafe when a prior CID is found.
-    "deploy.incremental": "false",
-    // Seeded "false" so every span carries the attribute for ratio queries.
-    // Flipped to "true" by storeDirectoryV2 when the Phase A root node is already on-chain.
-    "deploy.storage.phase_a.root_already_onchain": "false",
-    // Seeded 0 so every span carries the attribute; incremented by storeDirectoryV2
-    // for each Phase B chunk confirmed present on-chain (probe hit → skip re-upload).
-    "deploy.storage.phase_b.probe_hit_count": 0,
-    "deploy.phase_a.chunks_uploaded": 0,
-    "deploy.probe.finality_miss_count": 0,
-    "deploy.probe.finality_miss_reupload_count": 0,
-    "deploy.pool.eligible_count": 0,
-    // Nonce-advance collision probe counters. Seeded to 0 so every span carries
-    // the attribute for ratio queries even when no collision is detected.
-    "deploy.pool.nonce_collision_count": 0,
-    "deploy.pool.nonce_collision_missing": 0,
-    "deploy.pool.nonce_collision_reupload_count": 0,
-    // Manifest-aware Phase A trust: count of section-1 CIDs trusted from prev manifest.
-    "deploy.phase_a.chunks_trusted": 0,
-    // Manifest fetch outcome. Seeded so every span carries the attributes even when
-    // fetchPreviousManifest is never reached (first deploy, early error, non-incremental
-    // path). "none" + "0" form the denominator for ratio queries:
-    // count_if(deploy.manifest.fetch_source, "heuristic_fallback") / count().
-    // Both string-valued per @sentry/node EAP numeric-attribute caveat.
-    "deploy.manifest.fetch_source": "none",
-    "deploy.manifest.fetch_attempts": "0",
-    "deploy.manifest.bytes_downloaded": "0",
-    // Bulletin storage upload chain receipt (root-node tx, or last chunk when root skipped).
-    // Empty-string default so every span carries the attribute for filter queries.
-    "bulletin.upload.tx_hash": "",
-    "bulletin.upload.block_hash": "",
-    "bulletin.upload.block_number": 0,
-    // DotNS setContenthash chain receipt.
-    "deploy.contenthash.tx": "",
-    "deploy.contenthash.block": 0,
-    "deploy.contenthash.block_hash": "",
-    // DotNS register chain receipt (fresh registrations only).
-    "deploy.register.tx": "",
-    "deploy.register.block": 0,
-    "deploy.register.block_hash": "",
-    // DotNS setSubnodeOwner chain receipt (subdomain registrations only).
-    "deploy.subnode.tx": "",
-    "deploy.subnode.block": 0,
-    "deploy.subnode.block_hash": ""
+    "deploy.runner_type": resolveRunnerType()
   };
   if (hostApp) attrs["deploy.host_app"] = hostApp;
   const hostAppVersion = process.env.BULLETIN_DEPLOY_HOST_APP_VERSION;
   if (hostAppVersion) attrs["deploy.host_app_version"] = hostAppVersion;
-  attrs["deploy.dotns_backend"] = DOTNS_BACKEND;
-  attrs["deploy.dotns_pop_source"] = DOTNS_POP_SOURCE;
   return attrs;
 }
 function isExpectedError(msg) {
@@ -280,7 +290,7 @@ function isExpectedError(msg) {
 }
 function classifyDeployError(msg) {
   if (isExpectedError(msg)) return "user";
-  if (/chunk.*failed after.*retr|tx dropped from best chain|timed out after \d+s waiting for block|Contract reverted|Contract execution would revert|dotns register failed|All promises were rejected|"type"\s*:\s*"Invalid"|Commitment still too new|not finalised after \d+s|chain may have (dropped|evicted)|ReviveApi.*timed out|\b(?:commit|register|setSubnodeOwner|setResolver|setContenthash|setText|publish|unpublish|Revive\.call|Utility\.batch_all) timed out after \d+ms|transaction watcher silent for/i.test(msg)) return "environment";
+  if (/chunk.*failed after.*retr|tx dropped from best chain|timed out after \d+s waiting for block|Contract reverted|Contract execution would revert|dotns register failed|All promises were rejected|"type"\s*:\s*"Invalid"|Commitment still too new|not finalised after \d+s|chain may have (dropped|evicted)|ReviveApi.*timed out|ReviveApi.*returned empty result|\b(?:commit|register|setSubnodeOwner|setResolver|setContenthash|setText|publish|unpublish|Revive\.call|Utility\.batch_all) timed out after \d+ms|transaction watcher silent for/i.test(msg)) return "environment";
   if (/javascript heap out of memory|allocation failed.*heap|External signer mode is not supported with dotns-cli/i.test(msg)) return "internal";
   return "unknown";
 }
@@ -312,6 +322,7 @@ var ERROR_KIND_RULES = [
   [/Deploy verification failed:\s*DAG-PB root.+not finalised/i, "verify.dagpb_not_finalised"],
   [/Retry budget exhausted:.*recovery attempts/i, "network.recovery_exhausted"],
   [/ReviveApi\.\w+ timed out after \d+ms/i, "chain.api_timeout"],
+  [/ReviveApi\.\w+ returned empty result/i, "chain.api_timeout"],
   [/transaction watcher silent for \d+s/i, "chain.tx_silent"],
   [/^(?:commit|register|setSubnodeOwner|setResolver|setContenthash|setText|publish|unpublish|Revive\.call|Utility\.batch_all) timed out after \d+ms/i, "chain.tx_timeout"],
   [/^INVARIANT FAILED:/i, "tool.invariant"]

package/dist/{chunk-R2CJ5I5R.js → chunk-TQC3S6NP.js}

@@ -6,15 +6,15 @@ import {
   resolveDotnsConnectOptions,
   storeDirectory,
   storeFile
-} from "./chunk-WPJADKC7.js";
+} from "./chunk-HPPLVGGC.js";
 import {
   DotNS
-} from "./chunk-IRT4A7OO.js";
+} from "./chunk-2GBSYVK2.js";
 import {
   getPopSelfServeConfig,
   loadEnvironments,
   resolveEndpoints
-} from "./chunk-CNPB4VAM.js";
+} from "./chunk-5K3RI5C2.js";
 import {
   NonRetryableError
 } from "./chunk-ZOC4GITL.js";

package/dist/{chunk-KB3EII7F.js → chunk-WSBDIHFZ.js}

@@ -1,6 +1,6 @@
 import {
   captureWarning
-} from "./chunk-INVA3XGG.js";
+} from "./chunk-RIAMPAL2.js";
 
 // src/chunk-probe.ts
 import { Twox128, Blake2128Concat, decAnyMetadata, unifyMetadata } from "@polkadot-api/substrate-bindings";

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-WSBDIHFZ.js";
+import "./chunk-RIAMPAL2.js";
+import "./chunk-NJPBXF5Z.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-HPPLVGGC.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-H64ZLWW2.js";
+import "./chunk-EJWZGSHD.js";
+import "./chunk-WSBDIHFZ.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-2GBSYVK2.js";
+import "./chunk-JQ5X3VMP.js";
+import "./chunk-RIAMPAL2.js";
+import "./chunk-NJPBXF5Z.js";
+import "./chunk-5K3RI5C2.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-2GBSYVK2.js";
+import "./chunk-JQ5X3VMP.js";
+import "./chunk-RIAMPAL2.js";
+import "./chunk-NJPBXF5Z.js";
+import "./chunk-5K3RI5C2.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

@@ -2,8 +2,8 @@ declare const DEFAULT_ENV_ID = "paseo-next-v2";
 interface PopSelfServeConfig {
     /** The label users select in the sudo.personhood.dev env dropdown — e.g. "Next V2". */
     sudoEnvLabel: string;
-    /** Faucet URL for funding the service account on this env. */
-    faucetUrl: string;
+    /** Faucet URL for funding the service account on this env. Omit on envs with no public faucet (accounts funded by ops). */
+    faucetUrl?: string;
     /** Personhood recognition flow URL on the sudo app. */
     personhoodFaucetUrl: string;
     /** Asset-Hub alias-binding flow URL on the sudo app. */
@@ -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-5K3RI5C2.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';