@parity/product-deploy 0.9.0 → 0.10.0-rc.1

package/dist/commands/login.js

@@ -1,17 +1,23 @@
+import {
+  startSpinner
+} from "../chunk-J7CYVTAW.js";
 import "../chunk-JQKKMUCT.js";
-import "../chunk-DHY2ZXVZ.js";
+import {
+  BULLETIN_RESOURCE,
+  DEFAULT_RESOURCES,
+  createSlotAccountSigner,
+  requestResourceAllocation,
+  summarizeOutcomes
+} from "../chunk-5OKB3TEB.js";
 import {
   renderLoginStatus
 } from "../chunk-RIRDBSBG.js";
-import {
-  startSpinner
-} from "../chunk-J7CYVTAW.js";
 import {
   waitForBulletinAuthorization
-} from "../chunk-WAKSNE7F.js";
+} from "../chunk-ZF2SEY7S.js";
 import {
   preflightSssAllowance
-} from "../chunk-5UE2IWNB.js";
+} from "../chunk-HEUKYXEZ.js";
 import {
   statementSigningAccount
 } from "../chunk-GRPLHUYC.js";
@@ -25,18 +31,19 @@ import {
   getAuthClient,
   getPeopleChainEndpoints,
   resolveBulletinEndpoints
-} from "../chunk-56QBW25C.js";
-import "../chunk-FNCBSJ6R.js";
-import "../chunk-UC2AYO2P.js";
-import "../chunk-D7KZZDU7.js";
+} from "../chunk-2GDPXSW3.js";
+import "../chunk-S42FFXAR.js";
+import "../chunk-HOO5NKN3.js";
+import "../chunk-HA7BNUK3.js";
 import "../chunk-C2TS5MER.js";
-import "../chunk-GCKWJS2T.js";
+import "../chunk-4ADUQDYJ.js";
+import "../chunk-SI2ZUOYD.js";
 import "../chunk-4PVJ2JBZ.js";
-import "../chunk-C7UJ6WZR.js";
-import "../chunk-A3O7TLCS.js";
+import "../chunk-64RSUZN4.js";
+import "../chunk-RX3ZUVVS.js";
 import {
   loadEnvironments
-} from "../chunk-GL3U7K2B.js";
+} from "../chunk-QRKI6MMK.js";
 import "../chunk-ZOC4GITL.js";
 
 // src/commands/login.ts
@@ -56,6 +63,37 @@ function allocationErrorMessage(reason) {
       return `Allocation failed (${reason}).`;
   }
 }
+function allocationFailedMessage(reason) {
+  return `Allowance pre-warm failed: ${reason}
+   Likely cause: personhood or alias not yet established for this account.
+   Storage will fall back to the pool for now.
+   Run: bulletin-deploy logout, then bulletin-deploy login,
+   to retry once your wallet's personhood/alias is in place.`;
+}
+function formatAllocationSummary(summary) {
+  const parts = [];
+  for (const r of summary.granted) {
+    parts.push(`  \u2713 ${r.tag}`);
+  }
+  for (const r of summary.rejected) {
+    parts.push(`  \u2717 ${r.tag} (declined on phone \u2014 deploys will fall back)`);
+  }
+  for (const r of summary.unavailable) {
+    parts.push(`  ~ ${r.tag} (not available \u2014 re-pair if this persists)`);
+  }
+  return parts.join("\n");
+}
+async function withTimeout(promise, ms, message) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => reject(new Error(message)), ms);
+  });
+  try {
+    return await Promise.race([promise, timeout]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
 function summarizeLogin(address, slotAddress) {
   const lines = [`Signed in as: ${address}`];
   if (slotAddress) {
@@ -147,22 +185,31 @@ to re-establish your allowance.`
     return;
   }
   try {
-    console.log("\nRequesting Bulletin storage allowance \u2014 check your phone to approve.");
-    const bulletinSignerPromise = handle.adapter.allowance.getBulletinSigner(
-      handle.userSession.id,
-      DOT_PRODUCT_ID
-    );
-    const timeoutPromise = new Promise(
-      (_, reject) => setTimeout(
-        () => reject(new Error(
-          `Allocation request timed out after ${Math.round(ALLOCATION_TIMEOUT_MS / 1e3)}s \u2014 ensure your phone is unlocked and the Polkadot mobile app is open, then try logging in again.`
-        )),
-        ALLOCATION_TIMEOUT_MS
-      )
+    console.log("\nAllocating deploy resources \u2014 check your phone to approve.");
+    const resources = DEFAULT_RESOURCES;
+    const outcomes = await withTimeout(
+      requestResourceAllocation(handle.userSession, handle.adapter, resources),
+      ALLOCATION_TIMEOUT_MS,
+      `Allocation request timed out after ${Math.round(ALLOCATION_TIMEOUT_MS / 1e3)}s \u2014 the wallet did not respond to the approval request.`
     );
-    const signerResult = await Promise.race([bulletinSignerPromise, timeoutPromise]);
-    if (signerResult.isOk()) {
-      const slotSigner = signerResult.value;
+    const summary = summarizeOutcomes(outcomes, resources);
+    const summaryText = formatAllocationSummary(summary);
+    if (summaryText) console.log(summaryText);
+    if (summary.rejected.length > 0 || summary.unavailable.length > 0) {
+      console.warn(
+        "   Some allowances were not granted \u2014 Bulletin storage falls back to a pool account;\n   PGAS/contract gaps surface at deploy time. Run: bulletin-deploy logout && bulletin-deploy login  to retry."
+      );
+    }
+    let slotSigner = await createSlotAccountSigner(handle.adapter, BULLETIN_RESOURCE);
+    if (!slotSigner) {
+      const fallbackResult = await withTimeout(
+        handle.adapter.allowance.getBulletinSigner(handle.userSession.id, DOT_PRODUCT_ID),
+        ALLOCATION_TIMEOUT_MS,
+        `Bulletin slot read timed out after ${Math.round(ALLOCATION_TIMEOUT_MS / 1e3)}s \u2014 the wallet did not respond.`
+      );
+      if (fallbackResult.isOk()) slotSigner = fallbackResult.value;
+    }
+    if (slotSigner) {
       const slotAddress = ss58Encode(slotSigner.publicKey);
       const { doc } = await loadEnvironments();
       const bulletinEndpoints = resolveBulletinEndpoints(doc, envId) ?? void 0;
@@ -189,24 +236,26 @@ to re-establish your allowance.`
         spinner.stop();
         process.removeListener("SIGINT", onSigint);
       }
-      const summary = bulletinAuthSummary(
+      const authSummary = bulletinAuthSummary(
         authResult.authorized,
         authResult.authorized ? authResult.expiration : void 0
       );
-      console.log(summary.message);
+      console.log(authSummary.message);
       console.log("\n" + summarizeLogin(handle.address, slotAddress));
     } else {
-      const err = signerResult.error;
       console.log("\n" + summarizeLogin(handle.address, null));
-      console.warn(`   ${allocationErrorMessage(err.reason)}`);
+      console.warn(
+        "   Bulletin storage slot not available \u2014 storage will fall back to a pool account.\n   Run: bulletin-deploy logout && bulletin-deploy login  to retry."
+      );
     }
   } catch (err) {
     await Promise.resolve(handle.userSession.abortPendingRequests()).catch(() => {
     });
     tearingDown = true;
-    console.error(`
-Allocation failed: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
+    console.log(
+      "\n" + allocationFailedMessage(err instanceof Error ? err.message : String(err))
+    );
+    console.log("\n" + summarizeLogin(handle.address, null));
   } finally {
     tearingDown = true;
     handle.destroy();
@@ -215,7 +264,10 @@ Allocation failed: ${err instanceof Error ? err.message : String(err)}`);
 }
 export {
   allocationErrorMessage,
+  allocationFailedMessage,
   bulletinAuthSummary,
+  formatAllocationSummary,
   runLogin,
-  summarizeLogin
+  summarizeLogin,
+  withTimeout
 };

package/dist/commands/logout.d.ts

@@ -1,6 +1,7 @@
-import { g as LogoutStatus } from '../auth-C-Pel0AT.js';
+import { d as LogoutStatus } from '../auth-CA_YKtM2.js';
 import '@parity/product-sdk-terminal';
 import 'polkadot-api';
+import '../allocations-CEPeZr6T.js';
 
 /**
  * logout — sign out the current session.

package/dist/commands/logout.js

@@ -1,18 +1,18 @@
 import "../chunk-JQKKMUCT.js";
-import "../chunk-DHY2ZXVZ.js";
+import "../chunk-5OKB3TEB.js";
 import {
   renderLogoutStatus
 } from "../chunk-RIRDBSBG.js";
 import {
   clearSssAllowanceCache
-} from "../chunk-5UE2IWNB.js";
+} from "../chunk-HEUKYXEZ.js";
 import "../chunk-GRPLHUYC.js";
 import {
   getAuthClient
-} from "../chunk-56QBW25C.js";
-import "../chunk-C7UJ6WZR.js";
-import "../chunk-A3O7TLCS.js";
-import "../chunk-GL3U7K2B.js";
+} from "../chunk-2GDPXSW3.js";
+import "../chunk-64RSUZN4.js";
+import "../chunk-RX3ZUVVS.js";
+import "../chunk-QRKI6MMK.js";
 import "../chunk-ZOC4GITL.js";
 
 // src/commands/logout.ts

package/dist/commands/transfer.d.ts

@@ -0,0 +1,14 @@
+interface TransferRecipientContext {
+    sessionH160?: string;
+}
+/** Pure: pick the recipient H160 from --to (0x) or the signed-in session.
+ *  Label/SS58 recipient resolution is intentionally out of scope for the
+ *  recovery command — it takes an explicit 0x address or the live session. */
+declare function resolveTransferRecipient(to: string | undefined, ctx: TransferRecipientContext): Promise<string>;
+declare function runTransfer(envId: string, opts: {
+    label?: string;
+    to?: string;
+    mnemonic?: string;
+}): Promise<void>;
+
+export { type TransferRecipientContext, resolveTransferRecipient, runTransfer };

package/dist/commands/transfer.js

@@ -0,0 +1,67 @@
+import {
+  DEFAULT_MNEMONIC,
+  DotNS
+} from "../chunk-4ADUQDYJ.js";
+import "../chunk-SI2ZUOYD.js";
+import "../chunk-4PVJ2JBZ.js";
+import "../chunk-64RSUZN4.js";
+import "../chunk-RX3ZUVVS.js";
+import {
+  getPopSelfServeConfig,
+  loadEnvironments,
+  resolveEndpoints
+} from "../chunk-QRKI6MMK.js";
+import "../chunk-ZOC4GITL.js";
+
+// src/commands/transfer.ts
+async function resolveTransferRecipient(to, ctx) {
+  if (to && to.startsWith("0x") && to.length === 42) return to;
+  if (to) throw new Error(`--to must be a 0x H160 address (got "${to}").`);
+  if (ctx.sessionH160) return ctx.sessionH160;
+  throw new Error("No recipient: pass --to <0xH160> or sign in first (no session found).");
+}
+async function runTransfer(envId, opts) {
+  const label = (opts.label ?? "").replace(/\.dot$/, "");
+  if (!label) {
+    throw new Error("Usage: bulletin-deploy transfer <label> [--to <0xH160>] [--mnemonic <key>]");
+  }
+  let sessionH160;
+  if (!opts.to) {
+    const { getAuthClient } = await import("../auth-config.js");
+    const authClient = await getAuthClient(envId);
+    const handle = await authClient.getSessionSigner();
+    if (handle) {
+      sessionH160 = handle.addresses.productH160;
+      handle.destroy();
+    }
+  }
+  const recipient = await resolveTransferRecipient(opts.to, { sessionH160 });
+  const { doc } = await loadEnvironments();
+  const resolved = resolveEndpoints(doc, envId);
+  const dotns = new DotNS();
+  await dotns.connect({
+    mnemonic: opts.mnemonic ?? DEFAULT_MNEMONIC,
+    rpc: resolved.assetHub[0],
+    assetHubEndpoints: resolved.assetHub,
+    autoAccountMapping: resolved.autoAccountMapping,
+    environmentId: envId,
+    contracts: Object.keys(resolved.contracts).length > 0 ? resolved.contracts : void 0,
+    nativeToEthRatio: resolved.nativeToEthRatio,
+    popSelfServe: getPopSelfServeConfig(doc, envId),
+    registerStorageDeposit: resolved.registerStorageDeposit
+  });
+  try {
+    const result = await dotns.transferName(label, recipient, (s) => console.log(`   ${s}`));
+    if (result.status === "skipped-already-owned") {
+      console.log(`\u2713 ${label}.dot is already owned by ${recipient}. Nothing to do.`);
+    } else {
+      console.log(`\u2713 Transferred ${label}.dot to ${recipient}${result.txHash ? ` (tx ${result.txHash})` : ""}.`);
+    }
+  } finally {
+    dotns.disconnect();
+  }
+}
+export {
+  resolveTransferRecipient,
+  runTransfer
+};

package/dist/commands/whoami.d.ts

@@ -1,6 +1,7 @@
-import { S as SessionAddresses } from '../auth-C-Pel0AT.js';
+import { S as SessionAddresses } from '../auth-CA_YKtM2.js';
 import '@parity/product-sdk-terminal';
 import 'polkadot-api';
+import '../allocations-CEPeZr6T.js';
 
 /**
  * whoami — show the currently logged-in session account, or "not logged in".

package/dist/commands/whoami.js

@@ -2,10 +2,10 @@ import {
   STALE_SESSION_MESSAGE,
   getAuthClient,
   hasPersistedSession
-} from "../chunk-56QBW25C.js";
-import "../chunk-C7UJ6WZR.js";
-import "../chunk-A3O7TLCS.js";
-import "../chunk-GL3U7K2B.js";
+} from "../chunk-2GDPXSW3.js";
+import "../chunk-64RSUZN4.js";
+import "../chunk-RX3ZUVVS.js";
+import "../chunk-QRKI6MMK.js";
 import "../chunk-ZOC4GITL.js";
 
 // src/commands/whoami.ts

package/dist/deploy-actors.d.ts

@@ -0,0 +1,24 @@
+import { A as AuthClient } from './auth-CA_YKtM2.js';
+import { R as ResolvedSigner } from './signer-Duup0hgQ.js';
+import '@parity/product-sdk-terminal';
+import 'polkadot-api';
+import './allocations-CEPeZr6T.js';
+import '@parity/product-sdk-tx';
+
+declare class MainnetDefaultWorkerError extends Error {
+    constructor();
+}
+interface DeployActors {
+    worker: ResolvedSigner;
+    /** Set ⇔ transfer-mode is active (signed in && transfer enabled). */
+    recipientH160?: string;
+}
+interface ResolveDeployActorsOptions {
+    suri?: string;
+    transferEnabled: boolean;
+    isTestnet: boolean;
+    sessionPresent: boolean;
+}
+declare function resolveDeployActors(authClient: AuthClient, { suri, transferEnabled, isTestnet, sessionPresent }: ResolveDeployActorsOptions): Promise<DeployActors>;
+
+export { type DeployActors, MainnetDefaultWorkerError, type ResolveDeployActorsOptions, resolveDeployActors };

package/dist/deploy-actors.js

@@ -0,0 +1,44 @@
+import "./chunk-JQKKMUCT.js";
+import {
+  resolveSigner
+} from "./chunk-5OKB3TEB.js";
+import "./chunk-RIRDBSBG.js";
+import {
+  DEFAULT_MNEMONIC
+} from "./chunk-4ADUQDYJ.js";
+import "./chunk-SI2ZUOYD.js";
+import "./chunk-4PVJ2JBZ.js";
+import "./chunk-64RSUZN4.js";
+import "./chunk-RX3ZUVVS.js";
+import "./chunk-QRKI6MMK.js";
+import "./chunk-ZOC4GITL.js";
+
+// src/deploy-actors.ts
+var DEFAULT_WORKER_SURI = DEFAULT_MNEMONIC;
+var MainnetDefaultWorkerError = class extends Error {
+  constructor() {
+    super(
+      "Refusing to default the deploy worker to Alice on a non-testnet environment. Pass --mnemonic <a funded, sufficiently-verified key> to do the transfer flow, or --no-transfer-to-signedin-user to sign directly with your mobile session."
+    );
+    this.name = "MainnetDefaultWorkerError";
+  }
+};
+async function resolveDeployActors(authClient, { suri, transferEnabled, isTestnet, sessionPresent }) {
+  if (sessionPresent && transferEnabled) {
+    if (!suri && !isTestnet) throw new MainnetDefaultWorkerError();
+    const worker2 = await resolveSigner(authClient, { suri: suri ?? DEFAULT_WORKER_SURI });
+    const handle = await authClient.getSessionSigner();
+    if (!handle) throw new Error("transfer mode active but no session resolved; pass --no-transfer-to-signedin-user.");
+    try {
+      return { worker: worker2, recipientH160: handle.addresses.productH160 };
+    } finally {
+      handle.destroy();
+    }
+  }
+  const worker = await resolveSigner(authClient, { suri });
+  return { worker };
+}
+export {
+  MainnetDefaultWorkerError,
+  resolveDeployActors
+};

package/dist/deploy.d.ts

@@ -69,6 +69,17 @@ declare const CHUNK_MORTALITY_PERIOD: number;
 declare const WS_HEARTBEAT_TIMEOUT_MS: number;
 declare function retryBudgetExhausted(history: number[], maxEvents: number, windowMs: number, now?: number): boolean;
 declare function isConnectionError(error: any): boolean;
+/**
+ * True for benign teardown noise that must NOT fail a deploy/command. Covers:
+ *  - connection errors (recoverable via the storage reconnect path), and
+ *  - "DestroyedError: Client destroyed" — orphaned pending-response promises the
+ *    SSO/papi client rejects while a session adapter is torn down AFTER the work
+ *    is done (e.g. the owner-signs update path destroying its re-acquired session).
+ * The CLI's crash handlers use this so a successful deploy isn't marked killed
+ * (exit 2) by late teardown noise. Checks name+message so DestroyedError matches
+ * even when its message differs.
+ */
+declare function isBenignTeardownError(error: any): boolean;
 declare function deriveRootSigner(mnemonic: string, path?: string): {
     signer: PolkadotSigner;
     ss58: string;
@@ -106,6 +117,7 @@ declare function chooseSignerInput(opts: {
     hasInjectedSigner: boolean;
     hasSession?: boolean;
 }): "mnemonic" | "injected" | "resolve" | "pool";
+declare function isPhoneSignerActive(options: Pick<DeployOptions, "signer" | "signerAddress" | "transferTo">): boolean;
 /**
  * Produce the one-line storage-signer status printed at resolution time. Exported for unit testing.
  *   Success: "   Storage signer: allowance slot <ss58>"
@@ -231,6 +243,13 @@ interface DeployOptions {
     storageSignerAddress?: string;
     /** Secret URI for dev signers (e.g. "//Alice" or a BIP-39 mnemonic). Passed to resolveSigner. */
     suri?: string;
+    /** When signed in, deploy with a local worker signer and transfer the finished
+     *  name to the signed-in account (zero mobile signatures). Default true.
+     *  CLI: --no-transfer-to-signedin-user sets this false. */
+    transferToSignedInUser?: boolean;
+    /** Internal: recipient H160 for the post-deploy handover. Set by the resolve
+     *  branch; callers normally let it be derived. */
+    transferTo?: string;
     rpc?: string;
     poolSize?: number;
     password?: string;
@@ -394,4 +413,4 @@ declare function computePhoneSigningSteps(dotnsPreflight: {
     needsPopUpgrade: boolean;
 } | null, publishNeeded: boolean): string[];
 
-export { 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, 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, friendlyChainError, hasIPFS, interpretBitswapResult, isConnectionError, makeBulletinStatusHandler, merkleize, probeP2pRetrieval, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };
+export { 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, 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, friendlyChainError, hasIPFS, interpretBitswapResult, isBenignTeardownError, isConnectionError, isPhoneSignerActive, makeBulletinStatusHandler, merkleize, probeP2pRetrieval, resolveDotnsConnectOptions, resolveReproducibleTimestamp, retryBudgetExhausted, setWsHaltCallback, storeChunkedContent, storeDirectory, storeDirectoryV2, storeFile, unpublish };

package/dist/deploy.js

@@ -32,7 +32,9 @@ import {
   friendlyChainError,
   hasIPFS,
   interpretBitswapResult,
+  isBenignTeardownError,
   isConnectionError,
+  isPhoneSignerActive,
   makeBulletinStatusHandler,
   merkleize,
   probeP2pRetrieval,
@@ -45,24 +47,25 @@ import {
   storeDirectoryV2,
   storeFile,
   unpublish
-} from "./chunk-WAKSNE7F.js";
-import "./chunk-5UE2IWNB.js";
+} from "./chunk-ZF2SEY7S.js";
+import "./chunk-HEUKYXEZ.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-56QBW25C.js";
-import "./chunk-FNCBSJ6R.js";
-import "./chunk-UC2AYO2P.js";
-import "./chunk-D7KZZDU7.js";
+import "./chunk-2GDPXSW3.js";
+import "./chunk-S42FFXAR.js";
+import "./chunk-HOO5NKN3.js";
+import "./chunk-HA7BNUK3.js";
 import "./chunk-C2TS5MER.js";
-import "./chunk-GCKWJS2T.js";
+import "./chunk-4ADUQDYJ.js";
+import "./chunk-SI2ZUOYD.js";
 import "./chunk-4PVJ2JBZ.js";
-import "./chunk-C7UJ6WZR.js";
-import "./chunk-A3O7TLCS.js";
-import "./chunk-GL3U7K2B.js";
+import "./chunk-64RSUZN4.js";
+import "./chunk-RX3ZUVVS.js";
+import "./chunk-QRKI6MMK.js";
 import {
   EXIT_CODE_NO_RETRY,
   NonRetryableError
@@ -103,7 +106,9 @@ export {
   friendlyChainError,
   hasIPFS,
   interpretBitswapResult,
+  isBenignTeardownError,
   isConnectionError,
+  isPhoneSignerActive,
   makeBulletinStatusHandler,
   merkleize,
   probeP2pRetrieval,

package/dist/dotns.d.ts

@@ -84,7 +84,7 @@ interface DotnsPreflightResult {
     isTestnet: boolean;
     canProceed: boolean;
     reason?: string;
-    plannedAction: "register" | "already-owned-by-us" | "abort";
+    plannedAction: "register" | "already-owned-by-us" | "already-owned-by-recipient" | "abort";
     needsPopUpgrade: boolean;
     targetPopStatus?: number;
     /** Free PAS balance of the DotNS signer at preflight time, in plancks (10 decimals). */
@@ -98,9 +98,12 @@ interface DotnsPreflightResult {
     };
 }
 declare const MINIMUM_REGISTER_STORAGE_DEPOSIT = 2000000000000n;
+declare function registerDepositWei(userStatus: number, startingPriceWei: bigint): bigint;
+declare function bufferedWeiToNative(weiValue: bigint, nativeToEthRatio: bigint): bigint;
+declare function weiToNative(feeWei: bigint, nativeToEthRatio: bigint): bigint;
 declare function fmtPas(plancks: bigint): string;
 type DotnsSuccessAction = Exclude<DotnsPreflightResult["plannedAction"], "abort">;
-declare function feeFloorFor(plannedAction: DotnsSuccessAction, storageDeposit?: bigint, rentPriceNative?: bigint): bigint;
+declare function feeFloorFor(plannedAction: DotnsSuccessAction, storageDeposit?: bigint, rentPriceNative?: bigint, transferFeeNative?: bigint): bigint;
 declare const RPC_ENDPOINTS: string[];
 declare const CONTRACTS: {
     readonly DOTNS_REGISTRAR: "0x329aAA5b6bEa94E750b2dacBa74Bf41291E6c2BD";
@@ -124,6 +127,15 @@ 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;
+/**
+ * Whether a failed attempt should be retried: only when the error is
+ * retry-eligible AND there's a later attempt left in the budget. Extracted so
+ * the loop logs EVERY failed attempt consistently (`attempt N/MAX failed`) and
+ * the final/aborted attempt is announced rather than breaking silently — the
+ * old loop only printed the line when a retry followed, so the last attempt was
+ * invisible and the count appeared to stop one short.
+ */
+declare function shouldRetryTxAttempt(attempt: number, maxAttempts: number, decision: "retry" | "abort"): boolean;
 /** 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
@@ -292,6 +304,7 @@ declare class ReviveClientWrapper {
             expectedNonce: number;
         };
         verifyEffect?: () => Promise<boolean>;
+        feeAsset?: "pgas";
     }): Promise<TxResolution>;
     signAndSubmitWithRetry(buildExtrinsic: () => any, signer: PolkadotSigner, statusCallback: (status: string) => void, label: string, opts?: {
         nonceFallback?: {
@@ -300,15 +313,17 @@ declare class ReviveClientWrapper {
             expectedNonce: number;
         };
         verifyEffect?: () => Promise<boolean>;
+        feeAsset?: "pgas";
     }): Promise<TxResolution>;
     private dryRunReviveCall;
-    submitTransaction(contractAddress: string, value: bigint, encodedData: string, signerSubstrateAddress: string, signer: PolkadotSigner, statusCallback: (status: string) => void, { rpcs, useNoncePolling, functionName, args, contracts, verifyEffect }: {
+    submitTransaction(contractAddress: string, value: bigint, encodedData: string, signerSubstrateAddress: string, signer: PolkadotSigner, statusCallback: (status: string) => void, { rpcs, useNoncePolling, functionName, args, contracts, verifyEffect, feeAsset }: {
         rpcs: string[];
         useNoncePolling?: boolean;
         functionName?: string;
         args?: unknown[];
         contracts?: Record<string, string>;
         verifyEffect?: () => Promise<boolean>;
+        feeAsset?: "pgas";
     }): Promise<TxResolution>;
     submitBatchedTransactions(calls: {
         contractAddress: string;
@@ -453,11 +468,27 @@ declare class DotNS {
      * for read paths that must always return a value.
      */
     contractCallNullable(contractAddress: string, contractAbi: readonly any[], functionName: string, args?: any[]): Promise<any | null>;
-    contractTransaction(contractAddress: string, value: bigint, contractAbi: readonly any[], functionName: string, args?: any[], statusCallback?: (status: string) => void, { useNoncePolling, verifyEffect }?: {
+    contractTransaction(contractAddress: string, value: bigint, contractAbi: readonly any[], functionName: string, args?: any[], statusCallback?: (status: string) => void, { useNoncePolling, verifyEffect, feeAsset }?: {
         useNoncePolling?: boolean;
         verifyEffect?: () => Promise<boolean>;
+        feeAsset?: "pgas";
     }): Promise<TxResolution>;
     checkOwnership(label: string, ownerAddress?: string | null): Promise<OwnershipResult>;
+    /** Live transfer-fee quote. transferFloor is a pure PopRules view — it
+     *  classifies the label and reads both tiers, so it works BEFORE the name is
+     *  registered (unlike quoteTransferFee, which reverts on an unregistered token). */
+    quoteTransferFloorNative(label: string, fromH160: string, toH160: string): Promise<{
+        feeWei: bigint;
+        feeNative: bigint;
+    }>;
+    /** Hand `label`.dot from the connected signer (the worker, current owner) to
+     *  `toH160`, paying the transferFloor friction fee. Idempotent: a no-op if the
+     *  recipient already owns it; errors if a third party does. */
+    transferName(label: string, toH160: string, statusCallback?: (status: string) => void): Promise<{
+        status: "ok" | "skipped-already-owned";
+        txHash?: string;
+        feeWei?: bigint;
+    }>;
     getUserPopStatus(ownerAddress?: string | null): Promise<number>;
     checkSubdomainOwnership(sublabel: string, parentLabel: string): Promise<OwnershipResult>;
     registerSubdomain(sublabel: string, parentLabel: string): Promise<{
@@ -477,7 +508,9 @@ declare class DotNS {
      * registry/resolver writes are similarly sized.
      */
     private submitBatchedContractCalls;
-    setContenthash(domainName: string, contenthashHex: string): Promise<{
+    setContenthash(domainName: string, contenthashHex: string, opts?: {
+        feeAsset?: "pgas";
+    }): Promise<{
         node: string;
     }>;
     /**
@@ -531,7 +564,9 @@ declare class DotNS {
     getPriceAndValidate(label: string): Promise<PriceValidationResult>;
     finalizeRegistration(registration: any, priceWei: bigint): Promise<void>;
     verifyOwnership(label: string): Promise<void>;
-    preflight(label: string): Promise<DotnsPreflightResult>;
+    preflight(label: string, opts?: {
+        transferRecipientH160?: string;
+    }): Promise<DotnsPreflightResult>;
     private _preflightInternal;
     private gateOnFeeBalance;
     register(label: string, options?: DotNSConnectOptions & {
@@ -567,4 +602,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, dotnsRetryBackoffMs, feeFloorFor, fetchNonce, fmtPas, formatDispatchError, formatPersonhoodRemediation, formatPopShortfallReason, isCommitmentMature, isCommitmentTimingBarerevert, makeRetryStatusFilter, 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, bufferedWeiToNative, canRegister, classifyAliasAccountRow, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertToHexString, convertWeiToNative, countTrailingDigits, decodePublisherRevert, dotns, dotnsRetryBackoffMs, feeFloorFor, fetchNonce, fmtPas, formatDispatchError, formatPersonhoodRemediation, formatPopShortfallReason, isCommitmentMature, isCommitmentTimingBarerevert, makeRetryStatusFilter, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, registerDepositWei, sanitizeDomainLabel, shouldRetryTxAttempt, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced, weiToNative };