bulletin-deploy 0.5.3 → 0.5.5

package/README.md

@@ -43,6 +43,9 @@ bulletin-deploy ./dist my-app00.dot
 
 # Custom RPC endpoint
 bulletin-deploy --rpc wss://custom-bulletin.example.com ./dist my-app00.dot
+
+# Deploy and publish to the Playground remix registry
+bulletin-deploy --playground ./dist my-app00.dot
 ```
 
 ### All options
@@ -50,9 +53,24 @@ bulletin-deploy --rpc wss://custom-bulletin.example.com ./dist my-app00.dot
 ```
 Options:
   --rpc wss://...     Bulletin RPC (or set BULLETIN_RPC env var)
+  --mnemonic "..."    DotNS owner mnemonic (or set MNEMONIC env var)
+  --playground        Publish to the Playground remix registry
+  --pool-size N       Number of pool accounts (default: 10)
   --help              Show help
 ```
 
+### Playground registry
+
+By default, deploys only upload to Bulletin storage and register the DotNS domain. The **Playground remix registry** is an on-chain app directory that makes your deploy visible in [Polkadot Playground](https://playground.polkadot.cloud).
+
+To publish to it, pass `--playground`:
+
+```bash
+bulletin-deploy --playground ./dist my-app.dot
+```
+
+This requires `cdm.json` in your project root (shipped with bulletin-deploy) and a git remote origin.
+
 ## GitHub Actions
 
 1. Copy `workflows/deploy-on-pr.yml` to your repo's `.github/workflows/` directory
@@ -74,12 +92,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 +167,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/bin/bulletin-deploy

@@ -13,6 +13,7 @@ for (let i = 0; i < args.length; i++) {
   else if (args[i] === "--pool-size") { flags.poolSize = parseInt(args[++i], 10); }
   else if (args[i] === "--mnemonic") { flags.mnemonic = args[++i]; }
   else if (args[i] === "--rpc") { flags.rpc = args[++i]; }
+  else if (args[i] === "--playground") { flags.playground = true; }
   else if (args[i] === "--help" || args[i] === "-h") { flags.help = true; }
   else { positional.push(args[i]); }
 }
@@ -26,6 +27,7 @@ Options:
   --mnemonic "..."    DotNS owner mnemonic (or set MNEMONIC env var)
   --rpc wss://...     Bulletin RPC (or set BULLETIN_RPC env var)
   --pool-size N       Number of pool accounts (default: 10)
+  --playground        Publish to the playground remix registry
   --help              Show this help`);
   process.exit(0);
 }
@@ -44,7 +46,7 @@ try {
     if (!domain) { console.error("Error: domain required (e.g. my-app.dot)"); process.exit(1); }
     if (!fs.existsSync(buildDir)) { console.error(`Error: ${buildDir} does not exist`); process.exit(1); }
 
-    const result = await deploy(buildDir, domain);
+    const result = await deploy(buildDir, domain, { playground: flags.playground });
 
     const output = process.env.GITHUB_OUTPUT;
     if (output) {

package/cdm.json

@@ -13,8 +13,8 @@
   "contracts": {
     "acc2c3b5e912b762": {
       "@example/playground-registry": {
-        "version": 2,
-        "address": "0x7D97a3E87c0C2fe921E471D076b95975886CEAA8",
+        "version": 3,
+        "address": "0xF8304E5C17769A53E012f39c6990cC8a7AaBC6A5",
         "abi": [
           {
             "type": "constructor",
@@ -39,35 +39,58 @@
           },
           {
             "type": "function",
-            "name": "getMetadataUri",
+            "name": "getAppCount",
+            "inputs": [],
+            "outputs": [
+              {
+                "name": "",
+                "type": "uint32"
+              }
+            ],
+            "stateMutability": "view"
+          },
+          {
+            "type": "function",
+            "name": "getDomainAt",
             "inputs": [
               {
-                "name": "domain",
+                "name": "index",
+                "type": "uint32"
+              }
+            ],
+            "outputs": [
+              {
+                "name": "",
                 "type": "string"
               }
             ],
+            "stateMutability": "view"
+          },
+          {
+            "type": "function",
+            "name": "getOwnerAppCount",
+            "inputs": [
+              {
+                "name": "owner",
+                "type": "address"
+              }
+            ],
             "outputs": [
               {
                 "name": "",
-                "type": "tuple",
-                "components": [
-                  {
-                    "name": "isSome",
-                    "type": "bool"
-                  },
-                  {
-                    "name": "value",
-                    "type": "string"
-                  }
-                ]
+                "type": "uint32"
               }
             ],
             "stateMutability": "view"
           },
           {
             "type": "function",
-            "name": "getDomainAt",
+            "name": "getOwnerDomainAt",
             "inputs": [
+              {
+                "name": "owner",
+                "type": "address"
+              },
               {
                 "name": "index",
                 "type": "uint32"
@@ -83,7 +106,7 @@
           },
           {
             "type": "function",
-            "name": "getOwner",
+            "name": "getMetadataUri",
             "inputs": [
               {
                 "name": "domain",
@@ -93,25 +116,40 @@
             "outputs": [
               {
                 "name": "",
-                "type": "address"
+                "type": "tuple",
+                "components": [
+                  {
+                    "name": "isSome",
+                    "type": "bool"
+                  },
+                  {
+                    "name": "value",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "stateMutability": "view"
           },
           {
             "type": "function",
-            "name": "getAppCount",
-            "inputs": [],
+            "name": "getOwner",
+            "inputs": [
+              {
+                "name": "domain",
+                "type": "string"
+              }
+            ],
             "outputs": [
               {
                 "name": "",
-                "type": "uint32"
+                "type": "address"
               }
             ],
             "stateMutability": "view"
           }
         ],
-        "metadataCid": "bafk2bzacecrjrmrgumcww7oc23rllfscbxpd2lxc6p2svb26c6e5tjvmr565s"
+        "metadataCid": "bafk2bzacebkch7cuoi77j5vkrkoplax4urywwga7ijamtd3pntv7xjgabhtgs"
       }
     }
   }

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

@@ -3,7 +3,7 @@ import {
   DotNS,
   TX_TIMEOUT_MS,
   fetchNonce
-} from "./chunk-W23LLCZF.js";
+} from "./chunk-WQ74BM5S.js";
 import {
   derivePoolAccounts,
   ensureAuthorized,
@@ -360,7 +360,7 @@ async function storeDirectory(directoryPath) {
   });
   return { storageCid, ipfsCid };
 }
-async function deploy(content, domainName = null) {
+async function deploy(content, domainName = null, options = {}) {
   initTelemetry();
   const randomSuffix = Math.floor(Math.random() * 100).toString().padStart(2, "0");
   const name = domainName ? domainName.replace(".dot", "") : `test-domain-${Date.now().toString(36)}${randomSuffix}`;
@@ -441,53 +441,52 @@ async function deploy(content, domainName = null) {
       await dotns.setContenthash(name, contenthashHex);
       dotns.disconnect();
     });
-    console.log("\n" + "=".repeat(60));
-    console.log("Registry");
-    console.log("=".repeat(60));
-    await withSpan("deploy.registry", "3. registry", { "deploy.domain": name }, async () => {
-      const repoUrl = getGitRemoteUrl();
-      if (!repoUrl) {
-        console.log("\n   Skipping registry: not a git repository (no remote origin found)");
-        return;
-      }
-      if (!fs.existsSync(CDM_JSON_PATH)) {
-        console.log("\n   Skipping registry: cdm.json not found");
-        return;
-      }
-      console.log(`
-   Repository: ${repoUrl}`);
-      const metadata = JSON.stringify({ repository: repoUrl });
-      const metadataBytes = new Uint8Array(Buffer.from(metadata, "utf-8"));
-      console.log(`   Uploading metadata to Bulletin...`);
-      const metadataCid = await storeFile(metadataBytes);
-      console.log(`   Metadata CID: ${metadataCid}`);
-      const cdmJson = JSON.parse(fs.readFileSync(CDM_JSON_PATH, "utf-8"));
-      const { signer, origin } = getRegistrySigner();
-      console.log(`   Publishing to registry as ${origin}...`);
-      const MAX_REGISTRY_RETRIES = 3;
-      for (let attempt = 1; attempt <= MAX_REGISTRY_RETRIES; attempt++) {
-        const cdm = createCdm(cdmJson, { defaultSigner: signer, defaultOrigin: origin });
-        try {
-          const registry = cdm.getContract("@example/playground-registry");
-          const result = await registry.publish.tx(`${name}.dot`, metadataCid);
-          if (!result.ok) throw new Error("Registry publish transaction failed");
-          console.log(`   Tx: ${result.txHash}`);
-          console.log(`   Registered ${name}.dot in app registry!`);
-          break;
-        } catch (e) {
-          if (attempt < MAX_REGISTRY_RETRIES) {
-            captureWarning("Registry publish failed, retrying", { attempt, maxRetries: MAX_REGISTRY_RETRIES, error: e.message?.slice(0, 200) });
-            console.log(`   Attempt ${attempt} failed: ${e.message?.slice(0, 80)}`);
-            console.log(`   Retrying in 6s...`);
-            await new Promise((r) => setTimeout(r, 6e3));
-            continue;
+    if (options.playground) {
+      console.log("\n" + "=".repeat(60));
+      console.log("Playground Registry");
+      console.log("=".repeat(60));
+      await withSpan("deploy.registry", "3. registry", { "deploy.domain": name }, async () => {
+        const repoUrl = getGitRemoteUrl();
+        if (!fs.existsSync(CDM_JSON_PATH)) {
+          console.log("\n   Skipping registry: cdm.json not found");
+          return;
+        }
+        const metadata = {};
+        if (repoUrl) metadata.repository = repoUrl;
+        console.log(`
+   Metadata: ${JSON.stringify(metadata)}`);
+        const metadataBytes = new Uint8Array(Buffer.from(JSON.stringify(metadata), "utf-8"));
+        console.log(`   Uploading metadata to Bulletin...`);
+        const metadataCid = await storeFile(metadataBytes);
+        console.log(`   Metadata CID: ${metadataCid}`);
+        const cdmJson = JSON.parse(fs.readFileSync(CDM_JSON_PATH, "utf-8"));
+        const { signer, origin } = getRegistrySigner();
+        console.log(`   Publishing to registry as ${origin}...`);
+        const MAX_REGISTRY_RETRIES = 3;
+        for (let attempt = 1; attempt <= MAX_REGISTRY_RETRIES; attempt++) {
+          const cdm = createCdm(cdmJson, { defaultSigner: signer, defaultOrigin: origin });
+          try {
+            const registry = cdm.getContract("@example/playground-registry");
+            const result = await registry.publish.tx(`${name}.dot`, metadataCid);
+            if (!result.ok) throw new Error("Registry publish transaction failed");
+            console.log(`   Tx: ${result.txHash}`);
+            console.log(`   Registered ${name}.dot in playground registry!`);
+            break;
+          } catch (e) {
+            if (attempt < MAX_REGISTRY_RETRIES) {
+              captureWarning("Registry publish failed, retrying", { attempt, maxRetries: MAX_REGISTRY_RETRIES, error: e.message?.slice(0, 200) });
+              console.log(`   Attempt ${attempt} failed: ${e.message?.slice(0, 80)}`);
+              console.log(`   Retrying in 6s...`);
+              await new Promise((r) => setTimeout(r, 6e3));
+              continue;
+            }
+            throw e;
+          } finally {
+            cdm.destroy();
           }
-          throw e;
-        } finally {
-          cdm.destroy();
         }
-      }
-    });
+      });
+    }
     console.log("\n" + "=".repeat(60));
     console.log("DEPLOYMENT COMPLETE!");
     console.log("=".repeat(60));

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

@@ -607,15 +607,29 @@ var DotNS = class {
   }
   async register(label, options = {}) {
     return withSpan("deploy.dotns.register", `2a. register ${label}.dot`, {}, async () => {
-      const status = parseProofOfPersonhoodStatus(options.status || process.env.DOTNS_STATUS);
+      const MAINNET_RPC_PATTERNS = ["polkadot-asset-hub-rpc.polkadot.io", "kusama-asset-hub-rpc.polkadot.io", "polkadothub-rpc.com/mainnet"];
+      const isMainnet = this.rpc && MAINNET_RPC_PATTERNS.some((p) => this.rpc.includes(p));
+      const statusDefault = isMainnet ? "none" : "full";
+      const status = parseProofOfPersonhoodStatus(options.status || process.env.DOTNS_STATUS || statusDefault);
       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/deploy.d.ts

@@ -28,6 +28,9 @@ declare function storeDirectory(directoryPath: string): Promise<{
     storageCid: string;
     ipfsCid: string;
 }>;
-declare function deploy(content: DeployContent, domainName?: string | null): Promise<DeployResult>;
+interface DeployOptions {
+    playground?: boolean;
+}
+declare function deploy(content: DeployContent, domainName?: string | null, options?: DeployOptions): Promise<DeployResult>;
 
-export { type DeployContent, type DeployResult, chunk, createCID, deploy, encodeContenthash, hasIPFS, merkleize, storeChunkedContent, storeDirectory, storeFile };
+export { type DeployContent, type DeployOptions, type DeployResult, chunk, createCID, deploy, encodeContenthash, hasIPFS, merkleize, storeChunkedContent, storeDirectory, storeFile };

package/dist/deploy.js

@@ -8,8 +8,8 @@ import {
   storeChunkedContent,
   storeDirectory,
   storeFile
-} from "./chunk-JF2UR7FV.js";
-import "./chunk-W23LLCZF.js";
+} from "./chunk-RS62TJNH.js";
+import "./chunk-WQ74BM5S.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-WQ74BM5S.js";
 import "./chunk-2RURGSQW.js";
 import "./chunk-QGM4M3NI.js";
 export {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { DeployContent, DeployResult, deploy } from './deploy.js';
+export { DeployContent, DeployOptions, DeployResult, deploy } from './deploy.js';
 export { PoolAccount, PoolAuthorization, bootstrapPool, derivePoolAccounts, ensureAuthorized, fetchPoolAuthorizations, selectAccount } from './pool.js';
 export { DotNS, DotNSConnectOptions, OwnershipResult, PriceValidationResult } from './dotns.js';
 import 'multiformats/cid';

package/dist/index.js

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

package/package.json

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