bulletin-deploy 0.7.6 → 0.7.7

package/bin/bulletin-deploy

@@ -24,6 +24,8 @@ for (let i = 0; i < args.length; i++) {
   else if (args[i] === "--password") { flags.password = args[++i]; }
   else if (args[i] === "--js-merkle") { flags.jsMerkle = true; }
   else if (args[i] === "--tag") { flags.tag = args[++i]; }
+  else if (args[i] === "--name") { flags.name = args[++i]; }
+  else if (args[i] === "--description") { flags.description = args[++i]; }
   else if (args[i] === "--gh-pages-mirror") { flags.ghPagesMirror = true; }
   else if (args[i] === "--version" || args[i] === "-V") { flags.version = true; }
   else if (args[i] === "--help" || args[i] === "-h") { flags.help = true; }
@@ -54,6 +56,8 @@ Options:
   --password "..."    Encrypt SPA content (users will be prompted to decrypt)
   --js-merkle         Use pure-JS merkleization (no IPFS Kubo binary required)
   --tag "..."         Label deploy in telemetry (or set DEPLOY_TAG env var); see Telemetry in README
+  --name "..."             Optional. Sets the "name" text record on the domain.
+  --description "..."      Optional. Sets the "description" text record (≤100 chars recommended).
   --gh-pages-mirror   After deploy, push the CAR to the current repo's gh-pages branch
                       at bulletin/<domain>.dot.car (opt-in; also set GH_PAGES_MIRROR=1)
   --version           Show version
@@ -185,6 +189,8 @@ try {
     jsMerkle: flags.jsMerkle,
     tag: flags.tag,
     ghPagesMirror: flags.ghPagesMirror,
+    name: flags.name,
+    description: flags.description,
   });
 
   const output = process.env.GITHUB_OUTPUT;

package/dist/bug-report.js

@@ -9,10 +9,10 @@ import {
   offerBugReport,
   scrubSecrets,
   setDeployContext
-} from "./chunk-YX62STIA.js";
-import "./chunk-EECNTEAE.js";
-import "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
+} from "./chunk-D3SJZTE2.js";
+import "./chunk-BEAOHOTJ.js";
+import "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
 import "./chunk-QGM4M3NI.js";
 export {
   buildCliFlagsSummary,

package/dist/{chunk-A2J6R5PD.js → chunk-77SWQOPW.js}

@@ -1,6 +1,6 @@
 import {
   setDeployContext
-} from "./chunk-YX62STIA.js";
+} from "./chunk-D3SJZTE2.js";
 import {
   DotNS,
   TX_TIMEOUT_MS,
@@ -8,12 +8,12 @@ import {
   parseDomainName,
   popStatusName,
   verifyNonceAdvanced
-} from "./chunk-G6CVI6U2.js";
+} from "./chunk-EOCLCWCS.js";
 import {
   MirrorSkipped,
   mirrorToGitHubPages,
   pollMirrorFreshness
-} from "./chunk-2Q2WSKFD.js";
+} from "./chunk-HOTQDYHD.js";
 import {
   VERSION,
   captureWarning,
@@ -27,7 +27,7 @@ import {
   truncateAddress,
   withDeploySpan,
   withSpan
-} from "./chunk-Y6CTPQS2.js";
+} from "./chunk-LNFD7QP6.js";
 import {
   merkleizeJS
 } from "./chunk-B7GUYYAN.js";
@@ -38,7 +38,7 @@ import {
   fetchPoolAuthorizations,
   selectAccount,
   topUpBy
-} from "./chunk-WIBZPZSY.js";
+} from "./chunk-RP4YJYNB.js";
 
 // src/deploy.ts
 import { Buffer } from "buffer";
@@ -648,6 +648,12 @@ async function storeDirectory(directoryPath, providerOrOptions = {}, password, j
   }
   return { storageCid, ipfsCid, carBytes: carContent };
 }
+function resolveDotnsConnectOptions(options) {
+  if (options.signer && options.signerAddress) {
+    return { signer: options.signer, signerAddress: options.signerAddress };
+  }
+  return { mnemonic: options.mnemonic, derivationPath: options.derivationPath };
+}
 async function estimateUploadBytes(content) {
   try {
     if (Array.isArray(content)) {
@@ -702,14 +708,13 @@ async function deploy(content, domainName = null, options = {}) {
     if (options.password) console.log(`   Encrypted: yes`);
     let provider;
     const reconnect = options.mnemonic ? () => getDirectProvider(options.mnemonic, options.derivationPath) : () => getProvider();
+    let dotnsPreflight = null;
     try {
       console.log("\n" + "=".repeat(60));
       console.log("Preflight");
       console.log("=".repeat(60));
       const preflight = new DotNS();
-      await preflight.connect(
-        options.signer && options.signerAddress ? { signer: options.signer, signerAddress: options.signerAddress } : options.mnemonic ? { mnemonic: options.mnemonic, derivationPath: options.derivationPath } : {}
-      );
+      await preflight.connect(resolveDotnsConnectOptions(options));
       if (parsed?.isSubdomain) {
         try {
           const { owned: subOwned } = await preflight.checkSubdomainOwnership(parsed.sublabel, parsed.parentLabel);
@@ -726,7 +731,6 @@ async function deploy(content, domainName = null, options = {}) {
         }
         console.log(`   Mode: subdomain (parent ${parsed.parentLabel}.dot owned by signer)`);
       } else {
-        let dotnsPreflight;
         try {
           dotnsPreflight = await preflight.preflight(name);
         } finally {
@@ -859,9 +863,7 @@ async function deploy(content, domainName = null, options = {}) {
       console.log("=".repeat(60));
       await withSpan("deploy.dotns", "2. dotns", { "deploy.domain": name, "deploy.subdomain": String(parsed?.isSubdomain ?? false) }, async () => {
         const dotns = new DotNS();
-        await dotns.connect(
-          options.signer && options.signerAddress ? { signer: options.signer, signerAddress: options.signerAddress } : options.mnemonic ? { mnemonic: options.mnemonic, derivationPath: options.derivationPath } : {}
-        );
+        await dotns.connect(resolveDotnsConnectOptions(options));
         if (parsed?.isSubdomain) {
           const { owned, owner } = await dotns.checkSubdomainOwnership(parsed.sublabel, parsed.parentLabel);
           if (owned) {
@@ -879,12 +881,18 @@ async function deploy(content, domainName = null, options = {}) {
           if (owned) {
             console.log(`   Status: Already owned`);
           } else {
+            if (dotnsPreflight !== null && dotnsPreflight.needsPopUpgrade && dotnsPreflight.targetPopStatus !== void 0 && dotnsPreflight.isTestnet) {
+              await dotns.setUserPopStatus(dotnsPreflight.targetPopStatus);
+            }
             console.log(`   Status: Registering...`);
             await dotns.register(name);
           }
         }
         const contenthashHex = `0x${encodeContenthash(cid)}`;
         await dotns.setContenthash(name, contenthashHex);
+        const textRecordTarget = parsed?.isSubdomain && parsed.sublabel && parsed.parentLabel ? `${parsed.sublabel}.${parsed.parentLabel}` : name;
+        if (options.name !== void 0) await dotns.setTextRecord(textRecordTarget, "name", options.name);
+        if (options.description !== void 0) await dotns.setTextRecord(textRecordTarget, "description", options.description);
         dotns.disconnect();
       });
       if (options.ghPagesMirror) {
@@ -961,6 +969,7 @@ export {
   merkleize,
   computeStorageCid,
   storeDirectory,
+  resolveDotnsConnectOptions,
   estimateUploadBytes,
   deploy
 };

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

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

package/dist/{chunk-YX62STIA.js → chunk-D3SJZTE2.js}

@@ -2,11 +2,11 @@ import {
   classifyErrorArea,
   isInteractive,
   promptYesNo
-} from "./chunk-EECNTEAE.js";
+} from "./chunk-BEAOHOTJ.js";
 import {
   VERSION,
   getCurrentSentryTraceId
-} from "./chunk-Y6CTPQS2.js";
+} from "./chunk-LNFD7QP6.js";
 
 // src/bug-report.ts
 import { execSync, execFileSync } from "child_process";

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

@@ -2,16 +2,16 @@ import {
   captureWarning,
   setDeployAttribute,
   withSpan
-} from "./chunk-Y6CTPQS2.js";
+} from "./chunk-LNFD7QP6.js";
 import {
   isTestnetSpecName
-} from "./chunk-WIBZPZSY.js";
+} from "./chunk-RP4YJYNB.js";
 
 // src/dotns.ts
 import { spawn } from "child_process";
 import { readFileSync } from "fs";
 import { dirname, join } from "path";
-import { createClient } from "polkadot-api";
+import { createClient, Enum } from "polkadot-api";
 import { getPolkadotSigner } from "polkadot-api/signer";
 import { getWsProvider } from "polkadot-api/ws-provider";
 import { Keyring } from "@polkadot/keyring";
@@ -45,6 +45,19 @@ try {
   _dotnsCliPath = "dotns";
   console.warn(`[bulletin-deploy] @parity/dotns-cli not found in node_modules \u2014 falling back to "dotns" in PATH. Install with: npm install @parity/dotns-cli. Underlying: ${err.message}`);
 }
+var ONE_PAS = 10000000000n;
+var FEE_FLOOR_OWNED = ONE_PAS / 100n;
+var FEE_FLOOR_REGISTER = ONE_PAS / 10n;
+var TOP_UP_TARGET = ONE_PAS / 2n;
+var SOURCE_BUFFER = ONE_PAS;
+var TOP_UP_TRANSFER_TIMEOUT_MS = 6e4;
+var PASEO_FAUCET_URL = "https://faucet.polkadot.io";
+function fmtPas(plancks) {
+  return (Number(plancks) / Number(ONE_PAS)).toFixed(4);
+}
+function feeFloorFor(plannedAction) {
+  return plannedAction === "already-owned-by-us" ? FEE_FLOOR_OWNED : FEE_FLOOR_REGISTER;
+}
 var RPC_ENDPOINTS = [
   "wss://asset-hub-paseo.dotters.network",
   "wss://sys.ibp.network/asset-hub-paseo",
@@ -282,12 +295,13 @@ function canRegister(requiredStatus, userStatus, trailingDigits) {
 function simulateUserStatus(currentStatus, requiredStatus, options) {
   const max = (a, b) => a > b ? a : b;
   if (options.explicitStatus !== void 0) {
-    return max(currentStatus, options.explicitStatus);
+    if (options.isTestnet) return max(currentStatus, options.explicitStatus);
+    return currentStatus;
   }
   if (requiredStatus === ProofOfPersonhoodStatus.NoStatus && currentStatus === ProofOfPersonhoodStatus.ProofOfPersonhoodLite && options.isTestnet) {
     return ProofOfPersonhoodStatus.ProofOfPersonhoodFull;
   }
-  if (requiredStatus !== ProofOfPersonhoodStatus.NoStatus) {
+  if (requiredStatus !== ProofOfPersonhoodStatus.NoStatus && options.isTestnet) {
     return max(currentStatus, requiredStatus);
   }
   return currentStatus;
@@ -520,6 +534,129 @@ var DotNS = class {
     this._testnetCache = isTestnetSpecName(rpc) || rpc.includes("paseo") || rpc.includes("westend") || rpc.includes("rococo");
     return this._testnetCache;
   }
+  // Free PAS balance for a substrate address on the connected DotNS chain.
+  // Used by preflight to gate the deploy on whether the signer can pay tx
+  // fees before the chunk upload runs. Returns 0n if the account doesn't
+  // exist on chain.
+  async readFreeBalance(ss58) {
+    this.ensureConnected();
+    if (!this.clientWrapper) throw new Error("readFreeBalance: polkadot-api client not available");
+    const acc = await this.clientWrapper.client.query.System.Account.getValue(ss58);
+    return BigInt(acc?.data?.free ?? 0n);
+  }
+  // Testnet-only: try to top the deploy signer up from the well-known dev
+  // phrase's Alice (root) or Bob (//Bob) account. Each candidate is read,
+  // skipped if it can't spare the transfer, and otherwise used to send
+  // `targetAmount` to `recipientSs58`. Returns the source label + amount on
+  // success, or null if neither candidate had the funds. The dev phrase is
+  // hardcoded on purpose — this only fires on testnet (gated by caller) and
+  // runs against accounts every Substrate-Polkadot tester can fund.
+  async attemptTestnetTopUp(recipientSs58, targetAmount) {
+    this.ensureConnected();
+    if (!this.clientWrapper) throw new Error("attemptTestnetTopUp: polkadot-api client not available");
+    await cryptoWaitReady();
+    const keyring = new Keyring({ type: "sr25519" });
+    const sources = [
+      { label: "Alice", uri: DEFAULT_MNEMONIC },
+      { label: "Bob", uri: `${DEFAULT_MNEMONIC}//Bob` }
+    ];
+    for (const src of sources) {
+      const account = keyring.addFromUri(src.uri);
+      if (account.address === recipientSs58) continue;
+      const sourceBalance = await this.readFreeBalance(account.address);
+      if (sourceBalance < targetAmount + SOURCE_BUFFER) {
+        console.log(`   ${src.label} (${account.address.slice(0, 8)}...) low: ${fmtPas(sourceBalance)} PAS \u2014 skipping`);
+        captureWarning(`DotNS auto-top-up: ${src.label} insufficient`, {
+          source: src.label,
+          sourceAddress: account.address,
+          free: sourceBalance.toString(),
+          required: (targetAmount + SOURCE_BUFFER).toString()
+        });
+        continue;
+      }
+      const signer = getPolkadotSigner(
+        account.publicKey,
+        "Sr25519",
+        async (input) => account.sign(input)
+      );
+      console.log(`   Trying ${src.label} (${account.address.slice(0, 8)}...): transferring ${fmtPas(targetAmount)} PAS to ${recipientSs58.slice(0, 8)}...`);
+      try {
+        await withTimeout(
+          this.submitTransfer(signer, recipientSs58, targetAmount),
+          TOP_UP_TRANSFER_TIMEOUT_MS,
+          `Balances.transfer_allow_death from ${src.label}`
+        );
+        return { source: src.label, transferred: targetAmount };
+      } catch (e) {
+        console.log(`   Top-up via ${src.label} failed: ${e.message?.slice(0, 200)}`);
+      }
+    }
+    return null;
+  }
+  // Helper: submit a Balances.transfer_allow_death tx and resolve only after
+  // GRANDPA finalization (not best-block inclusion). Auto-top-up writes to
+  // the deploy signer's balance; if a re-org rolls back a best-block credit
+  // before the deploy's next tx, preflight reports success but setContenthash
+  // / register fail with Insufficient funds again. Waiting for finalization
+  // adds ~18s on Asset Hub Paseo but eliminates the re-org window.
+  // Logs a per-block-progress line so the operator sees the wait isn't a hang.
+  // Note: Enum("Id", ss58) is required to decode the SS58 to AccountId32;
+  // the structural literal { type: "Id", value } encodes wrong.
+  // Companion in tools/setup-e2e-derivation-signers.mjs uses best-block only;
+  // that's a one-time setup script, not a runtime gate, so the trade-off there
+  // is different.
+  submitTransfer(signer, destSubstrate, valueRaw) {
+    const api = this.clientWrapper.client;
+    const tx = api.tx.Balances.transfer_allow_death({
+      dest: Enum("Id", destSubstrate),
+      value: valueRaw
+    });
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      let bestBlockSeen = false;
+      const sub = tx.signSubmitAndWatch(signer).subscribe({
+        next: (event) => {
+          if (settled) return;
+          if (event.type === "txBestBlocksState" && event.found && !bestBlockSeen) {
+            bestBlockSeen = true;
+            if (!event.ok) {
+              settled = true;
+              try {
+                sub.unsubscribe();
+              } catch {
+              }
+              reject(new Error("Balances.transfer_allow_death dispatch error"));
+              return;
+            }
+            console.log(`   Tx in best block \u2014 waiting for finalization...`);
+            return;
+          }
+          if (event.type === "finalized") {
+            settled = true;
+            try {
+              sub.unsubscribe();
+            } catch {
+            }
+            if (event.ok === false) reject(new Error("Balances.transfer_allow_death finalization error"));
+            else resolve();
+          }
+        },
+        error: (e) => {
+          if (settled) return;
+          settled = true;
+          reject(e instanceof Error ? e : new Error(String(e)));
+        },
+        // Defensive: papi can complete the stream after a network drop without
+        // emitting finalized. Without this, the promise hangs forever and
+        // preflight stalls. Reject so the caller falls back to Bob.
+        complete: () => {
+          if (settled) return;
+          settled = true;
+          reject(new Error("transfer subscription closed without finalization"));
+        }
+      });
+    });
+  }
   async contractCall(contractAddress, contractAbi, functionName, args = []) {
     this.ensureConnected();
     if (!this.clientWrapper) throw new Error("contractCall: polkadot-api client not available");
@@ -650,6 +787,30 @@ var DotNS = class {
       return { node };
     });
   }
+  async setTextRecord(domainName, key, value, _cli = runDotnsCli) {
+    return withSpan("deploy.dotns.set-text", `2c. set-text ${key}`, {}, async () => {
+      this.ensureConnected();
+      console.log(`   Setting text[${key}]: ${value}`);
+      const authEnv = buildAuthEnv({ mnemonic: this._mnemonic ?? void 0, keyUri: this._keyUri ?? void 0 });
+      const setResult = await _cli(
+        ["text", "set", domainName, key, value, "--json", ...rpcFlag(this.rpc)],
+        authEnv
+      );
+      console.log(`   Tx: ${setResult.txHash}`);
+      const viewResult = await _cli(
+        ["text", "view", domainName, key, "--json", ...rpcFlag(this.rpc)]
+      );
+      const onChain = viewResult.value ?? "";
+      if (onChain !== value) {
+        throw new Error(
+          `Post-set verification failed for text[${key}] on ${domainName}.dot: on-chain value is ${JSON.stringify(onChain)}, not ${JSON.stringify(value)} we just wrote. The setText tx may have silently failed, or another writer overwrote the record.`
+        );
+      }
+      console.log(`   Verified text[${key}]: ${onChain}
+`);
+      return { value, txHash: setResult.txHash };
+    });
+  }
   async getContenthash(domainName) {
     this.ensureConnected();
     const result = await runDotnsCli(
@@ -687,11 +848,12 @@ var DotNS = class {
         };
       }
       const baseName = stripTrailingDigits(validated);
-      const [userStatus, baseReservation, ownership, isTestnet] = await Promise.all([
+      const [userStatus, baseReservation, ownership, isTestnet, signerFreeBalance] = await Promise.all([
         this.getUserPopStatus(),
         withTimeout(this.contractCall(CONTRACTS.POP_RULES, POP_RULES_ABI, "isBaseNameReserved", [baseName]), 3e4, "isBaseNameReserved"),
         this.checkOwnership(validated),
-        this.isTestnet()
+        this.isTestnet(),
+        this.readFreeBalance(this.substrateAddress)
       ]);
       const [isReserved, reservationOwnerRaw] = baseReservation;
       const reservationOwner = isReserved ? reservationOwnerRaw.toLowerCase() : null;
@@ -713,11 +875,12 @@ var DotNS = class {
           canProceed: false,
           reason: `Domain ${validated}.dot is already owned by ${existingOwner}.`,
           plannedAction: "abort",
-          needsPopUpgrade: false
+          needsPopUpgrade: false,
+          signerFreeBalance
         };
       }
       if (existingOwner !== null && existingOwner === selfAddress) {
-        return {
+        return await this.gateOnFeeBalance({
           label: validated,
           classification,
           userStatus,
@@ -731,7 +894,7 @@ var DotNS = class {
           canProceed: true,
           plannedAction: "already-owned-by-us",
           needsPopUpgrade: false
-        };
+        }, signerFreeBalance, isTestnet);
       }
       if (isReserved && reservationOwner !== selfAddress) {
         return {
@@ -748,7 +911,8 @@ var DotNS = class {
           canProceed: false,
           reason: `Base name ${baseName} is reserved for ${reservationOwner}.`,
           plannedAction: "abort",
-          needsPopUpgrade: false
+          needsPopUpgrade: false,
+          signerFreeBalance
         };
       }
       const explicitStatus = explicitStatusOverride ?? process.env.DOTNS_STATUS;
@@ -771,10 +935,11 @@ var DotNS = class {
           reason: `${validated}.dot classifies as ${className}; this signer cannot register it (PopRules.priceWithCheck gate). Remediations: use a signer with Full PoP, or pick a base name of 6-8 chars + trailing 00 (which classifies as PopLite).`,
           plannedAction: "abort",
           needsPopUpgrade: false,
-          targetPopStatus
+          targetPopStatus,
+          signerFreeBalance
         };
       }
-      return {
+      return await this.gateOnFeeBalance({
         label: validated,
         classification,
         userStatus,
@@ -789,9 +954,55 @@ var DotNS = class {
         plannedAction: "register",
         needsPopUpgrade: targetPopStatus !== userStatus,
         targetPopStatus
-      };
+      }, signerFreeBalance, isTestnet);
     });
   }
+  // Final preflight stage: check the DotNS signer can pay tx fees on the
+  // connected fee chain (Asset Hub Paseo for testnet, Asset Hub Polkadot for
+  // mainnet). On testnet, attempts a one-shot auto-top-up from the dev
+  // phrase's Alice or Bob if the signer is short. Replaces the original
+  // canProceed:true result with an actionable canProceed:false when even the
+  // top-up can't get the signer above the threshold.
+  async gateOnFeeBalance(candidate, signerFreeBalance, isTestnet) {
+    const feeFloor = feeFloorFor(candidate.plannedAction);
+    let effectiveBalance = signerFreeBalance;
+    let toppedUp;
+    if (effectiveBalance < feeFloor && isTestnet) {
+      setDeployAttribute("deploy.dotns.signer_below_floor", "true");
+      console.log(`   DotNS signer ${this.substrateAddress?.slice(0, 8)}... balance ${fmtPas(effectiveBalance)} PAS < ${fmtPas(feeFloor)} PAS floor \u2014 attempting testnet auto top-up...`);
+      const result = await this.attemptTestnetTopUp(this.substrateAddress, TOP_UP_TARGET);
+      if (result) {
+        console.log(`   Topped up ${fmtPas(result.transferred)} PAS from ${result.source}`);
+        effectiveBalance += result.transferred;
+        toppedUp = result;
+        setDeployAttribute("deploy.dotns.toppedup", "true");
+        setDeployAttribute("deploy.dotns.toppedup_source", result.source);
+      }
+    } else if (effectiveBalance < feeFloor) {
+      setDeployAttribute("deploy.dotns.signer_below_floor", "true");
+    }
+    if (effectiveBalance < feeFloor) {
+      const op = candidate.plannedAction === "already-owned-by-us" ? "setContenthash" : "register";
+      const tail = isTestnet ? ` Testnet auto-top-up via Alice/Bob failed (both also low). Top up at ${PASEO_FAUCET_URL}.` : ` Top up the signer's balance and re-deploy.`;
+      captureWarning("DotNS preflight balance gate: signer cannot pay fees", {
+        signer: this.substrateAddress,
+        free: effectiveBalance.toString(),
+        floor: feeFloor.toString(),
+        plannedAction: candidate.plannedAction,
+        isTestnet: String(isTestnet),
+        autoTopUpAttempted: String(isTestnet)
+      });
+      return {
+        ...candidate,
+        canProceed: false,
+        plannedAction: "abort",
+        reason: `DotNS signer ${this.substrateAddress} has ${fmtPas(effectiveBalance)} PAS free; needs \u2265${fmtPas(feeFloor)} PAS for ${op}.${tail}`,
+        signerFreeBalance: effectiveBalance,
+        feeFloor
+      };
+    }
+    return { ...candidate, signerFreeBalance: effectiveBalance, feeFloor, toppedUp };
+  }
   async register(label, options = {}) {
     return withSpan("deploy.dotns.register", `2a. register ${label}.dot`, {}, async () => {
       if (!this.connected) await this.connect(options);
@@ -859,6 +1070,8 @@ var DotNS = class {
 var dotns = new DotNS();
 
 export {
+  fmtPas,
+  feeFloorFor,
   RPC_ENDPOINTS,
   CONTRACTS,
   DECIMALS,

package/dist/{chunk-2Q2WSKFD.js → chunk-HOTQDYHD.js}

@@ -108,6 +108,14 @@ function runGit(args, cwd, extraEnv = {}) {
     env: { ...process.env, ...extraEnv }
   }).trim();
 }
+var MIRROR_BOT_GIT_OVERRIDES = [
+  "-c",
+  "user.email=bulletin-deploy@noreply.github.com",
+  "-c",
+  "user.name=bulletin-deploy",
+  "-c",
+  "commit.gpgsign=false"
+];
 function pushRemoteUrl(owner, repo, token) {
   const authedOwner = token ? `x-access-token:${token}@github.com` : "github.com";
   return `https://${authedOwner}/${owner}/${repo}.git`;
@@ -154,7 +162,7 @@ async function mirrorToGitHubPages(input) {
     const manifestPath = path.join(mirrorDir, `${domainFilename}.json`);
     fs.writeFileSync(carPath, input.carBytes);
     fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
-    runGit(["-c", `user.email=bulletin-deploy@noreply.github.com`, "-c", "user.name=bulletin-deploy", "add", GH_PAGES_MIRROR_DIR], workTree);
+    runGit([...MIRROR_BOT_GIT_OVERRIDES, "add", GH_PAGES_MIRROR_DIR], workTree);
     const status = runGit(["status", "--porcelain"], workTree);
     if (status.length === 0) {
       return {
@@ -167,10 +175,7 @@ async function mirrorToGitHubPages(input) {
     }
     runGit(
       [
-        "-c",
-        "user.email=bulletin-deploy@noreply.github.com",
-        "-c",
-        "user.name=bulletin-deploy",
+        ...MIRROR_BOT_GIT_OVERRIDES,
         "commit",
         "-m",
         `"mirror(bulletin): ${domainFilename} @ ${input.cid.slice(0, 12)}"`
@@ -209,5 +214,6 @@ export {
   normalizeDomainFilename,
   mirrorUrl,
   buildManifest,
+  MIRROR_BOT_GIT_OVERRIDES,
   mirrorToGitHubPages
 };

package/dist/{chunk-Y6CTPQS2.js → chunk-LNFD7QP6.js}

@@ -1,7 +1,7 @@
 import {
   package_default,
   writeRunState
-} from "./chunk-HHY32NGJ.js";
+} from "./chunk-VKADME5F.js";
 
 // src/memory-report.ts
 import * as fs2 from "fs";
@@ -203,7 +203,12 @@ function getDeployAttributes(domain) {
     // 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"
+    "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"
   };
   if (hostApp) attrs["deploy.host_app"] = hostApp;
   return attrs;

package/dist/{chunk-WIBZPZSY.js → chunk-RP4YJYNB.js}

@@ -7,6 +7,10 @@ import { getWsProvider } from "polkadot-api/ws-provider";
 import { withPolkadotSdkCompat } from "polkadot-api/polkadot-sdk-compat";
 import { Keyring } from "@polkadot/keyring";
 import { cryptoWaitReady } from "@polkadot/util-crypto";
+var PAS_DECIMALS_DIVISOR = 1e10;
+function formatPasBalance(plancks) {
+  return (Number(plancks) / PAS_DECIMALS_DIVISOR).toFixed(4);
+}
 var DEPLOY_PATH_PREFIX = "//deploy";
 var TOPUP_TRANSACTIONS = 1e3;
 var TOPUP_BYTES = 100000000n;
@@ -198,7 +202,7 @@ async function bootstrapPool(bulletinRpc, poolSize = 10, mnemonic) {
   const aliceSigner = getPolkadotSigner(alice.publicKey, "Sr25519", (data) => alice.sign(data));
   const aliceAccount = await api.query.System.Account.getValue(alice.address);
   const aliceBalance = BigInt(aliceAccount.data.free);
-  console.log(`Alice balance: ${(Number(aliceBalance) / 1e12).toFixed(4)} PAS
+  console.log(`Alice balance: ${formatPasBalance(aliceBalance)} PAS
 `);
   for (const account of accounts) {
     console.log(`Account ${account.index}: ${account.address}`);
@@ -239,6 +243,7 @@ async function bootstrapPool(bulletinRpc, poolSize = 10, mnemonic) {
 }
 
 export {
+  formatPasBalance,
   derivePoolAccounts,
   selectAccount,
   fetchPoolAuthorizations,

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

@@ -6,7 +6,7 @@ import * as path from "path";
 // package.json
 var package_default = {
   name: "bulletin-deploy",
-  version: "0.7.6",
+  version: "0.7.7",
   private: false,
   repository: {
     type: "git",
@@ -48,7 +48,7 @@ var package_default = {
     "@ipld/car": "^5.4.3",
     "@ipld/dag-pb": "^4.1.3",
     "@noble/hashes": "^1.7.2",
-    "@parity/dotns-cli": "0.5.6",
+    "@parity/dotns-cli": "^0.6.0",
     "@polkadot-api/substrate-bindings": "^0.16.5",
     "@polkadot-labs/hdkd": "^0.0.25",
     "@polkadot-labs/hdkd-helpers": "^0.0.26",

package/dist/deploy.d.ts

@@ -101,8 +101,18 @@ interface DeployOptions {
      * caveat.
      */
     ghPagesMirror?: boolean;
+    /** When set, writes the "name" text record on the domain after contenthash. */
+    name?: string;
+    /** When set, writes the "description" text record. ≤100 chars recommended for host-app cards. */
+    description?: string;
 }
+declare function resolveDotnsConnectOptions(options: Pick<DeployOptions, "mnemonic" | "derivationPath" | "signer" | "signerAddress">): {
+    signer?: PolkadotSigner;
+    signerAddress?: string;
+    mnemonic?: string;
+    derivationPath?: string;
+};
 declare function estimateUploadBytes(content: DeployContent): Promise<number | null>;
 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, EXIT_CODE_NO_RETRY, NonRetryableError, type StoreDirectoryOptions, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, isConnectionError, merkleize, storeChunkedContent, storeDirectory, storeFile };
+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, EXIT_CODE_NO_RETRY, NonRetryableError, type StoreDirectoryOptions, chunk, computeStorageCid, createCID, deploy, deriveRootSigner, encodeContenthash, encryptContent, estimateUploadBytes, friendlyChainError, hasIPFS, isConnectionError, merkleize, resolveDotnsConnectOptions, storeChunkedContent, storeDirectory, storeFile };

package/dist/deploy.js

@@ -22,18 +22,19 @@ import {
   hasIPFS,
   isConnectionError,
   merkleize,
+  resolveDotnsConnectOptions,
   storeChunkedContent,
   storeDirectory,
   storeFile
-} from "./chunk-A2J6R5PD.js";
-import "./chunk-YX62STIA.js";
-import "./chunk-EECNTEAE.js";
-import "./chunk-G6CVI6U2.js";
-import "./chunk-2Q2WSKFD.js";
-import "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
+} from "./chunk-77SWQOPW.js";
+import "./chunk-D3SJZTE2.js";
+import "./chunk-BEAOHOTJ.js";
+import "./chunk-EOCLCWCS.js";
+import "./chunk-HOTQDYHD.js";
+import "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
 import "./chunk-B7GUYYAN.js";
-import "./chunk-WIBZPZSY.js";
+import "./chunk-RP4YJYNB.js";
 import "./chunk-QGM4M3NI.js";
 export {
   CHUNK_MORTALITY_PERIOD,
@@ -59,6 +60,7 @@ export {
   hasIPFS,
   isConnectionError,
   merkleize,
+  resolveDotnsConnectOptions,
   storeChunkedContent,
   storeDirectory,
   storeFile

package/dist/dotns.d.ts

@@ -44,7 +44,19 @@ interface DotnsPreflightResult {
     plannedAction: "register" | "already-owned-by-us" | "abort";
     needsPopUpgrade: boolean;
     targetPopStatus?: number;
+    /** Free PAS balance of the DotNS signer at preflight time, in plancks (10 decimals). */
+    signerFreeBalance?: bigint;
+    /** Threshold the signer must clear; depends on plannedAction. */
+    feeFloor?: bigint;
+    /** Set when an auto-top-up was attempted on testnet; describes the source and amount. */
+    toppedUp?: {
+        source: "Alice" | "Bob";
+        transferred: bigint;
+    };
 }
+declare function fmtPas(plancks: bigint): string;
+type DotnsSuccessAction = Exclude<DotnsPreflightResult["plannedAction"], "abort">;
+declare function feeFloorFor(plannedAction: DotnsSuccessAction): bigint;
 declare const RPC_ENDPOINTS: string[];
 declare const CONTRACTS: {
     readonly DOTNS_REGISTRAR: "0x329aAA5b6bEa94E750b2dacBa74Bf41291E6c2BD";
@@ -130,6 +142,12 @@ declare class DotNS {
     ensureConnected(): void;
     private _testnetCache;
     isTestnet(): Promise<boolean>;
+    readFreeBalance(ss58: string): Promise<bigint>;
+    attemptTestnetTopUp(recipientSs58: string, targetAmount: bigint): Promise<{
+        source: "Alice" | "Bob";
+        transferred: bigint;
+    } | null>;
+    private submitTransfer;
     contractCall(contractAddress: string, contractAbi: readonly any[], functionName: string, args?: any[]): Promise<any>;
     checkOwnership(label: string, ownerAddress?: string | null): Promise<OwnershipResult>;
     getUserPopStatus(ownerAddress?: string | null): Promise<number>;
@@ -143,8 +161,13 @@ declare class DotNS {
     setContenthash(domainName: string, contenthashHex: string): Promise<{
         node: string;
     }>;
+    setTextRecord(domainName: string, key: string, value: string, _cli?: (argv: string[], env?: Record<string, string>) => Promise<unknown>): Promise<{
+        value: string;
+        txHash: string;
+    }>;
     getContenthash(domainName: string): Promise<string>;
     preflight(label: string, explicitStatusOverride?: string): Promise<DotnsPreflightResult>;
+    private gateOnFeeBalance;
     register(label: string, options?: DotNSConnectOptions & {
         status?: string;
         reverse?: boolean;
@@ -156,4 +179,4 @@ declare class DotNS {
 }
 declare const dotns: DotNS;
 
-export { CONNECTION_TIMEOUT_MS, CONTRACTS, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsPreflightResult, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, WS_HEARTBEAT_TIMEOUT_MS, canRegister, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertWeiToNative, countTrailingDigits, dotns, fetchNonce, isCommitmentMature, isExplicitCommitmentBuffer, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, runDotnsCli, sanitizeDomainLabel, simulateUserStatus, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };
+export { CONNECTION_TIMEOUT_MS, CONTRACTS, DECIMALS, DEFAULT_MNEMONIC, DOTNS_TX_MAX_ATTEMPTS, DOT_NODE, DotNS, type DotNSConnectOptions, type DotnsPreflightResult, type DotnsSuccessAction, NATIVE_TO_ETH_RATIO, OPERATION_TIMEOUT_MS, type OwnershipResult, type ParsedDomainName, type PriceValidationResult, ProofOfPersonhoodStatus, RPC_ENDPOINTS, TX_CHAIN_TIME_BUDGET_MS, TX_TIMEOUT_MS, TX_WALL_CLOCK_CEILING_MS, WS_HEARTBEAT_TIMEOUT_MS, canRegister, classifyDotnsLabel, classifyTxRetryDecision, computeDomainTokenId, convertWeiToNative, countTrailingDigits, dotns, feeFloorFor, fetchNonce, fmtPas, isCommitmentMature, isExplicitCommitmentBuffer, parseDomainName, parseProofOfPersonhoodStatus, popStatusName, runDotnsCli, sanitizeDomainLabel, simulateUserStatus, stripTrailingDigits, validateDomainLabel, verifyNonceAdvanced };

package/dist/dotns.js

@@ -21,7 +21,9 @@ import {
   convertWeiToNative,
   countTrailingDigits,
   dotns,
+  feeFloorFor,
   fetchNonce,
+  fmtPas,
   isCommitmentMature,
   isExplicitCommitmentBuffer,
   parseDomainName,
@@ -33,10 +35,10 @@ import {
   stripTrailingDigits,
   validateDomainLabel,
   verifyNonceAdvanced
-} from "./chunk-G6CVI6U2.js";
-import "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
-import "./chunk-WIBZPZSY.js";
+} from "./chunk-EOCLCWCS.js";
+import "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
+import "./chunk-RP4YJYNB.js";
 import "./chunk-QGM4M3NI.js";
 export {
   CONNECTION_TIMEOUT_MS,
@@ -61,7 +63,9 @@ export {
   convertWeiToNative,
   countTrailingDigits,
   dotns,
+  feeFloorFor,
   fetchNonce,
+  fmtPas,
   isCommitmentMature,
   isExplicitCommitmentBuffer,
   parseDomainName,

package/dist/gh-pages-mirror.d.ts

@@ -70,6 +70,7 @@ declare function resolveSourceCommit(repoPath: string): string | undefined;
 declare function normalizeDomainFilename(domain: string): string;
 declare function mirrorUrl(owner: string, repo: string, domainFilename: string): string;
 declare function buildManifest(input: Omit<MirrorInput, "carBytes" | "repoPath" | "githubToken">): MirrorManifest;
+declare const MIRROR_BOT_GIT_OVERRIDES: readonly string[];
 declare function mirrorToGitHubPages(input: MirrorInput): Promise<MirrorResult>;
 
-export { type FreshnessPollResult, GH_PAGES_MIRROR_BRANCH, GH_PAGES_MIRROR_DIR, GH_PAGES_MIRROR_MAX_BYTES, type MirrorInput, type MirrorManifest, type MirrorResult, MirrorSkipped, buildManifest, mirrorToGitHubPages, mirrorUrl, normalizeDomainFilename, parseGitRemoteUrl, pollMirrorFreshness, resolveOwnerRepo, resolveSourceCommit };
+export { type FreshnessPollResult, GH_PAGES_MIRROR_BRANCH, GH_PAGES_MIRROR_DIR, GH_PAGES_MIRROR_MAX_BYTES, MIRROR_BOT_GIT_OVERRIDES, type MirrorInput, type MirrorManifest, type MirrorResult, MirrorSkipped, buildManifest, mirrorToGitHubPages, mirrorUrl, normalizeDomainFilename, parseGitRemoteUrl, pollMirrorFreshness, resolveOwnerRepo, resolveSourceCommit };

package/dist/gh-pages-mirror.js

@@ -2,6 +2,7 @@ import {
   GH_PAGES_MIRROR_BRANCH,
   GH_PAGES_MIRROR_DIR,
   GH_PAGES_MIRROR_MAX_BYTES,
+  MIRROR_BOT_GIT_OVERRIDES,
   MirrorSkipped,
   buildManifest,
   mirrorToGitHubPages,
@@ -11,12 +12,13 @@ import {
   pollMirrorFreshness,
   resolveOwnerRepo,
   resolveSourceCommit
-} from "./chunk-2Q2WSKFD.js";
+} from "./chunk-HOTQDYHD.js";
 import "./chunk-QGM4M3NI.js";
 export {
   GH_PAGES_MIRROR_BRANCH,
   GH_PAGES_MIRROR_DIR,
   GH_PAGES_MIRROR_MAX_BYTES,
+  MIRROR_BOT_GIT_OVERRIDES,
   MirrorSkipped,
   buildManifest,
   mirrorToGitHubPages,

package/dist/index.js

@@ -1,14 +1,14 @@
 import {
   deploy
-} from "./chunk-A2J6R5PD.js";
-import "./chunk-YX62STIA.js";
-import "./chunk-EECNTEAE.js";
+} from "./chunk-77SWQOPW.js";
+import "./chunk-D3SJZTE2.js";
+import "./chunk-BEAOHOTJ.js";
 import {
   DotNS,
   parseDomainName
-} from "./chunk-G6CVI6U2.js";
-import "./chunk-2Q2WSKFD.js";
-import "./chunk-Y6CTPQS2.js";
+} from "./chunk-EOCLCWCS.js";
+import "./chunk-HOTQDYHD.js";
+import "./chunk-LNFD7QP6.js";
 import {
   VERSION,
   loadRunState,
@@ -18,7 +18,7 @@ import {
   shouldSkipStaleWarning,
   stateFilePath,
   writeRunState
-} from "./chunk-HHY32NGJ.js";
+} from "./chunk-VKADME5F.js";
 import {
   merkleizeJS
 } from "./chunk-B7GUYYAN.js";
@@ -28,7 +28,7 @@ import {
   ensureAuthorized,
   fetchPoolAuthorizations,
   selectAccount
-} from "./chunk-WIBZPZSY.js";
+} from "./chunk-RP4YJYNB.js";
 import "./chunk-QGM4M3NI.js";
 export {
   DotNS,

package/dist/memory-report.js

@@ -5,8 +5,8 @@ import {
   maybeWriteMemoryReport,
   safeHeap,
   sampleFromBytes
-} from "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
+} from "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
 import "./chunk-QGM4M3NI.js";
 export {
   DEFAULT_THRESHOLD_MB,

package/dist/pool.d.ts

@@ -1,5 +1,6 @@
 import { PolkadotSigner } from 'polkadot-api';
 
+declare function formatPasBalance(plancks: bigint): string;
 interface PoolAccount {
     index: number;
     path: string;
@@ -34,4 +35,4 @@ declare function ensureAuthorized(api: any, address: string, label?: string, min
 declare function topUpBy(api: any, address: string, needs: AuthorizationNeeds, label?: string): Promise<void>;
 declare function bootstrapPool(bulletinRpc: string, poolSize?: number, mnemonic?: string): Promise<void>;
 
-export { type AuthorizationNeeds, type PoolAccount, type PoolAuthorization, type TxRetryDecision, _resetTestnetCacheForTests, bootstrapPool, classifyAliceTxError, computeTopUpTarget, derivePoolAccounts, detectTestnet, ensureAuthorized, fetchPoolAuthorizations, isTestnetSpecName, selectAccount, topUpBy };
+export { type AuthorizationNeeds, type PoolAccount, type PoolAuthorization, type TxRetryDecision, _resetTestnetCacheForTests, bootstrapPool, classifyAliceTxError, computeTopUpTarget, derivePoolAccounts, detectTestnet, ensureAuthorized, fetchPoolAuthorizations, formatPasBalance, isTestnetSpecName, selectAccount, topUpBy };

package/dist/pool.js

@@ -7,10 +7,11 @@ import {
   detectTestnet,
   ensureAuthorized,
   fetchPoolAuthorizations,
+  formatPasBalance,
   isTestnetSpecName,
   selectAccount,
   topUpBy
-} from "./chunk-WIBZPZSY.js";
+} from "./chunk-RP4YJYNB.js";
 import "./chunk-QGM4M3NI.js";
 export {
   _resetTestnetCacheForTests,
@@ -21,6 +22,7 @@ export {
   detectTestnet,
   ensureAuthorized,
   fetchPoolAuthorizations,
+  formatPasBalance,
   isTestnetSpecName,
   selectAccount,
   topUpBy

package/dist/run-state.js

@@ -7,7 +7,7 @@ import {
   shouldSkipStaleWarning,
   stateFilePath,
   writeRunState
-} from "./chunk-HHY32NGJ.js";
+} from "./chunk-VKADME5F.js";
 import "./chunk-QGM4M3NI.js";
 export {
   VERSION,

package/dist/telemetry.js

@@ -24,8 +24,8 @@ import {
   truncateAddress,
   withDeploySpan,
   withSpan
-} from "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
+} from "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
 import "./chunk-QGM4M3NI.js";
 export {
   VERSION,

package/dist/version-check.js

@@ -8,9 +8,9 @@ import {
   isPreReleaseVersion,
   preReleaseWarning,
   promptYesNo
-} from "./chunk-EECNTEAE.js";
-import "./chunk-Y6CTPQS2.js";
-import "./chunk-HHY32NGJ.js";
+} from "./chunk-BEAOHOTJ.js";
+import "./chunk-LNFD7QP6.js";
+import "./chunk-VKADME5F.js";
 import "./chunk-QGM4M3NI.js";
 export {
   assessVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bulletin-deploy",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "private": false,
   "repository": {
     "type": "git",
@@ -42,7 +42,7 @@
     "@ipld/car": "^5.4.3",
     "@ipld/dag-pb": "^4.1.3",
     "@noble/hashes": "^1.7.2",
-    "@parity/dotns-cli": "0.5.6",
+    "@parity/dotns-cli": "^0.6.0",
     "@polkadot-api/substrate-bindings": "^0.16.5",
     "@polkadot-labs/hdkd": "^0.0.25",
     "@polkadot-labs/hdkd-helpers": "^0.0.26",