bulletin-deploy 0.5.3 → 0.5.4

package/README.md

@@ -74,12 +74,33 @@ const result = await deploy("./dist", "my-app00.dot");
 console.log(result.cid, result.domainName);
 ```
 
+## Domain Names and Proof of Personhood
+
+DotNS domain names are classified by the PopOracle contract on Asset Hub. The classification determines what level of **Proof of Personhood (PoP)** is required to register:
+
+| Domain pattern | Example | Required PoP | 
+|---|---|---|
+| Name with trailing digits | `my-app00.dot` | **None** — open to all |
+| Base name (no trailing digits) | `my-app.dot` | **Full** — requires `ProofOfPersonhoodFull` |
+
+On **testnets** (Paseo, Westend, local devnets), bulletin-deploy automatically self-grants `ProofOfPersonhoodFull` before registration — no configuration needed. Both base names and names with trailing digits just work:
+
+```bash
+bulletin-deploy ./dist my-app.dot       # base name — auto-grants Full PoP
+bulletin-deploy ./dist my-app00.dot     # trailing digits — no PoP needed
+```
+
+On **mainnet** (Polkadot Hub, Kusama Hub), PoP cannot be self-granted. You must have a verified account. Set `DOTNS_STATUS=none` explicitly or leave it unset (mainnet defaults to `none`).
+
+If you see **"Requires Full Personhood verification"**, the deploy will fail early with an actionable error message before any gas is spent on commitment transactions.
+
 ## Environment Variables
 
 | Variable | Default | Description |
 |---|---|---|
 | `BULLETIN_RPC` | `wss://paseo-bulletin-rpc.polkadot.io` | Bulletin chain WebSocket RPC |
 | `BULLETIN_DEPLOY_TELEMETRY` | `1` (enabled) | Set to `0` to disable Sentry telemetry |
+| `DOTNS_STATUS` | `full` (testnet) / `none` (mainnet) | PoP level to self-grant before registration: `none`, `lite`, or `full` |
 | `IPFS_CID` | _(none)_ | Skip storage, use pre-existing CID |
 
 ## How It Works
@@ -128,6 +149,7 @@ Dashboard: https://polkadot-community-foundation.sentry.io/dashboards/92523/
 
 | Error | Solution |
 |---|---|
+| `Requires Full Personhood verification` | Auto-handled on testnets (v0.5.4+). On mainnet, your account needs verified PoP status. |
 | `Payment` or authorization error | Pool account needs storage authorization — auto-authorization should handle this |
 | `Stale` or dropped from best chain | Bulletin chain reorg. Automatic retry handles this. |
 | `IPFS CLI not installed` | Install Kubo: `brew install ipfs && ipfs init` |

package/dist/{chunk-W23LLCZF.js → chunk-K2KKLHWN.js}

@@ -611,11 +611,22 @@ var DotNS = class {
       const reverse = options.reverse ?? (process.env.DOTNS_REVERSE ?? "false").toLowerCase() === "true";
       if (!this.connected) await this.connect(options);
       label = validateDomainLabel(label);
-      await Promise.all([
+      const [classification] = await Promise.all([
         this.classifyName(label),
-        this.ensureNotRegistered(label),
-        this.setUserPopStatus(status)
+        this.ensureNotRegistered(label)
       ]);
+      await this.setUserPopStatus(status);
+      const userStatus = await this.getUserPopStatus();
+      const requiredStatus = classification.requiredStatus;
+      if (requiredStatus === ProofOfPersonhoodStatus.Reserved) {
+        throw new Error(classification.message);
+      }
+      if (requiredStatus === ProofOfPersonhoodStatus.ProofOfPersonhoodFull && userStatus !== ProofOfPersonhoodStatus.ProofOfPersonhoodFull) {
+        throw new Error("Requires Full Personhood verification. Set DOTNS_STATUS=full or use a domain with trailing digits (e.g. my-app00.dot)");
+      }
+      if (requiredStatus === ProofOfPersonhoodStatus.ProofOfPersonhoodLite && userStatus !== ProofOfPersonhoodStatus.ProofOfPersonhoodLite && userStatus !== ProofOfPersonhoodStatus.ProofOfPersonhoodFull) {
+        throw new Error("Requires Personhood Lite verification. Set DOTNS_STATUS=lite or DOTNS_STATUS=full");
+      }
       const { commitment, registration } = await this.generateCommitment(label, reverse);
       await withSpan("deploy.dotns.submit-commitment", "2a-i. submit-commitment", {}, () => this.submitCommitment(commitment));
       await withSpan("deploy.dotns.wait-commitment-age", "2a-ii. wait-commitment-age", {}, () => this.waitForCommitmentAge());

package/dist/{chunk-JF2UR7FV.js → chunk-OMZHBMOF.js}

@@ -3,7 +3,7 @@ import {
   DotNS,
   TX_TIMEOUT_MS,
   fetchNonce
-} from "./chunk-W23LLCZF.js";
+} from "./chunk-K2KKLHWN.js";
 import {
   derivePoolAccounts,
   ensureAuthorized,

package/dist/deploy.js

@@ -8,8 +8,8 @@ import {
   storeChunkedContent,
   storeDirectory,
   storeFile
-} from "./chunk-JF2UR7FV.js";
-import "./chunk-W23LLCZF.js";
+} from "./chunk-OMZHBMOF.js";
+import "./chunk-K2KKLHWN.js";
 import "./chunk-RV7XBIIO.js";
 import "./chunk-2RURGSQW.js";
 import "./chunk-QGM4M3NI.js";

package/dist/dotns.js

@@ -18,7 +18,7 @@ import {
   sanitizeDomainLabel,
   stripTrailingDigits,
   validateDomainLabel
-} from "./chunk-W23LLCZF.js";
+} from "./chunk-K2KKLHWN.js";
 import "./chunk-2RURGSQW.js";
 import "./chunk-QGM4M3NI.js";
 export {

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   deploy
-} from "./chunk-JF2UR7FV.js";
+} from "./chunk-OMZHBMOF.js";
 import {
   DotNS
-} from "./chunk-W23LLCZF.js";
+} from "./chunk-K2KKLHWN.js";
 import {
   bootstrapPool,
   derivePoolAccounts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bulletin-deploy",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "private": false,
   "repository": {
     "type": "git",