@parity/product-sdk 0.29.0 → 0.31.0

package/dist/address/index.d.ts

@@ -6,4 +6,5 @@ import '@parity/product-sdk-crypto';
 import '@parity/product-sdk-host';
 import '@parity/product-sdk-individuality';
 import '@parity/product-sdk-local-storage';
+import '@parity/product-sdk-renderer';
 import '@parity/product-sdk-signer';

package/dist/{chunk-KXJT2BNL.js → chunk-VWD6HK2C.js}

@@ -7,17 +7,34 @@ import { CloudStorageClient, createLazySigner, calculateCid, ProductCloudStorage
 import { err, ok } from '@parity/result';
 import { isConnected, getClient, createChainClient, destroyAll } from '@parity/product-sdk-chain-client';
 import { accountIdBytes } from '@parity/product-sdk-address';
-import { getAccountsProvider } from '@parity/product-sdk-host';
+import { getTruApi, HostUnavailableError, HostCallFailedError, getAccountsProvider } from '@parity/product-sdk-host';
 
 var log = createLogger("app");
-async function createApp(config) {
+async function createApp(config = {}) {
   if (config.logLevel) {
     configure({ level: config.logLevel });
   }
-  log.info("Creating Product SDK app", { name: config.name });
-  const localKvStore = await createLocalKvStore({ prefix: config.name });
+  if (config.name !== void 0) {
+    log.warn(
+      "createApp: name is deprecated and ignored. Remove the name option. The SDK resolves the app name from system.getProductContext(), dropping the product ID's final domain suffix (my-app.dot -> my-app). Local development IDs stay unchanged."
+    );
+  }
+  const truApi = await getTruApi();
+  if (!truApi) {
+    throw new HostUnavailableError("createApp requires a host product context");
+  }
+  const { productId } = await truApi.system.getProductContext().match(
+    (context) => context,
+    (error) => {
+      throw new HostCallFailedError("system.getProductContext", error);
+    }
+  );
+  const isLocalHost = /^(?:localhost|127\.0\.0\.1|[^:]+\.localhost)(?::\d+)?$/i.test(productId);
+  const name = isLocalHost ? productId : productId.replace(/\.[^.]+$/, "");
+  log.info("Creating Product SDK app", { name });
+  const localKvStore = await createLocalKvStore({ prefix: name });
   const signerManager = new SignerManager({
-    dappName: config.name
+    dappName: productId
   });
   const cloudStorageEnabled = config.cloudStorage !== false;
   const cloudStorageEnvironment = typeof config.cloudStorage === "object" ? config.cloudStorage.environment : "paseo";
@@ -82,7 +99,7 @@ async function createApp(config) {
     }
   } : null;
   log.info("Product SDK app created", {
-    name: config.name,
+    name,
     cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : "disabled"
   });
   return {
@@ -90,7 +107,7 @@ async function createApp(config) {
     localStorage: localStorageApi,
     chain: chainApi,
     cloudStorage: cloudStorageApi,
-    getAppInfo: () => ({ ...config })
+    getAppInfo: () => ({ ...config, name })
   };
 }
 function createWalletApi(signerManager) {
@@ -228,5 +245,5 @@ async function getPrimaryUsername(accountsProvider) {
 }
 
 export { createApp };
-//# sourceMappingURL=chunk-KXJT2BNL.js.map
-//# sourceMappingURL=chunk-KXJT2BNL.js.map
+//# sourceMappingURL=chunk-VWD6HK2C.js.map
+//# sourceMappingURL=chunk-VWD6HK2C.js.map

package/dist/chunk-VWD6HK2C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/createApp.ts"],"names":["err"],"mappings":";;;;;;;;;;;AAgDA,IAAM,GAAA,GAAM,aAAa,KAAK,CAAA;AAuC9B,eAAsB,SAAA,CAAU,MAAA,GAAoB,EAAC,EAAiB;AAElE,EAAA,IAAI,OAAO,QAAA,EAAU;AACjB,IAAA,SAAA,CAAU,EAAE,KAAA,EAAO,MAAA,CAAO,QAAA,EAAU,CAAA;AAAA,EACxC;AAEA,EAAA,IAAI,MAAA,CAAO,SAAS,MAAA,EAAW;AAC3B,IAAA,GAAA,CAAI,IAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,EAAA,IAAI,CAAC,MAAA,EAAQ;AACT,IAAA,MAAM,IAAI,qBAAqB,2CAA2C,CAAA;AAAA,EAC9E;AACA,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,MAAA,CAAO,MAAA,CAAO,mBAAkB,CAAE,KAAA;AAAA,IAC1D,CAAC,OAAA,KAAY,OAAA;AAAA,IACb,CAAC,KAAA,KAAU;AACP,MAAA,MAAM,IAAI,mBAAA,CAAoB,0BAAA,EAA4B,KAAK,CAAA;AAAA,IACnE;AAAA,GACJ;AAEA,EAAA,MAAM,WAAA,GAAc,yDAAA,CAA0D,IAAA,CAAK,SAAS,CAAA;AAC5F,EAAA,MAAM,OAAO,WAAA,GAAc,SAAA,GAAY,SAAA,CAAU,OAAA,CAAQ,YAAY,EAAE,CAAA;AAEvE,EAAA,GAAA,CAAI,IAAA,CAAK,0BAAA,EAA4B,EAAE,IAAA,EAAM,CAAA;AAG7C,EAAA,MAAM,eAAe,MAAM,kBAAA,CAAmB,EAAE,MAAA,EAAQ,MAAM,CAAA;AAG9D,EAAA,MAAM,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,IACpC,QAAA,EAAU;AAAA,GACb,CAAA;AAUD,EAAA,MAAM,mBAAA,GAAsB,OAAO,YAAA,KAAiB,KAAA;AACpD,EAAA,MAAM,0BACF,OAAO,MAAA,CAAO,iBAAiB,QAAA,GAAW,MAAA,CAAO,aAAa,WAAA,GAAc,OAAA;AAChF,EAAA,MAAM,kBAAA,GAAqB,mBAAA,GACrB,MAAM,kBAAA,CAAmB,MAAA,CAAO;AAAA,IAC5B,WAAA,EAAa,uBAAA;AAAA,IACb,MAAA,EAAQ,gBAAA,CAAiB,MAAM,aAAA,CAAc,WAAW;AAAA,GAC3D,CAAA,GACD,IAAA;AAEN,EAAA,IAAI,mBAAA,EAAqB;AACrB,IAAA,GAAA,CAAI,MAAM,6CAAA,EAA+C;AAAA,MACrD,WAAA,EAAa;AAAA,KAChB,CAAA;AAAA,EACL,CAAA,MAAO;AACH,IAAA,GAAA,CAAI,MAAM,+BAA+B,CAAA;AAAA,EAC7C;AAGA,EAAA,MAAM,eAAA,GAAmC,sBAAsB,YAAY,CAAA;AAG3E,EAAA,MAAM,SAAA,GAAY,gBAAgB,aAAa,CAAA;AAG/C,EAAA,MAAM,QAAA,GAAqB;AAAA,IACvB,UAAU,UAAA,EAAY;AAClB,MAAA,GAAA,CAAI,MAAM,kBAAA,EAAoB,EAAE,OAAA,EAAS,UAAA,CAAW,SAAS,CAAA;AAC7D,MAAA,MAAM,MAAA,GAAS,UAAU,UAAU,CAAA;AACnC,MAAA,OAAO,MAAA,CAAO,YAAY,UAAU,CAAA;AAAA,IACxC,CAAA;AAAA,IAEA,aAAa,UAAA,EAAY;AACrB,MAAA,GAAA,CAAI,MAAM,qBAAA,EAAuB,EAAE,OAAA,EAAS,UAAA,CAAW,SAAS,CAAA;AAChE,MAAA,OAAO,UAAU,UAAU,CAAA;AAAA,IAC/B,CAAA;AAAA,IAEA,MAAM,QAAmD,MAAA,EAAW;AAChE,MAAA,GAAA,CAAI,KAAA,CAAM,kBAAkB,EAAE,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAM,GAAG,CAAA;AAC3D,MAAA,OAAO,iBAAA,CAAkB,EAAE,MAAA,EAAQ,CAAA;AAAA,IACvC,CAAA;AAAA,IAEA,YAAY,UAAA,EAAY;AACpB,MAAA,OAAO,YAAY,UAAU,CAAA;AAAA,IACjC,CAAA;AAAA,IAEA,UAAA,GAAa;AACT,MAAA,GAAA,CAAI,MAAM,mBAAmB,CAAA;AAC7B,MAAA,UAAA,EAAW;AAAA,IACf;AAAA,GACJ;AAGA,EAAA,MAAM,kBAA0C,kBAAA,GAC1C;AAAA,IACI,MAAA,EAAQ,OAAO,IAAA,KAAS;AACpB,MAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,KAAS,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA,GAAI,IAAA;AAC1E,MAAA,IAAI;AAMA,QAAA,MAAM,QAAA,GAAW,MAAM,kBAAA,CAClB,KAAA,CAAM,KAAK,CAAA,CACX,YAAA,CAAa,IAAI,CAAA,CACjB,IAAA,EAAK;AACV,QAAA,IAAI,CAAC,SAAS,GAAA,EAAK;AACf,UAAA,OAAO,GAAA;AAAA,YACH,IAAI,wBAAA;AAAA,cACA;AAAA;AACJ,WACJ;AAAA,QACJ;AACA,QAAA,OAAO,EAAA,CAAG,QAAA,CAAS,GAAA,CAAI,QAAA,EAAU,CAAA;AAAA,MACrC,SAAS,KAAA,EAAO;AACZ,QAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AACrE,QAAA,OAAO,IAAI,IAAI,wBAAA,CAAyB,SAAS,EAAE,KAAA,EAAO,CAAC,CAAA;AAAA,MAC/D;AAAA,IACJ,CAAA;AAAA,IACA,KAAA,EAAO,CAAC,GAAA,KAAQ,kBAAA,CAAmB,WAAW,GAAG,CAAA;AAAA,IACjD,UAAA,EAAY,OAAO,IAAA,KAAS;AACxB,MAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,KAAS,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA,GAAI,IAAA;AAC1E,MAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAAa,KAAK,CAAA;AACpC,MAAA,OAAO,IAAI,QAAA,EAAS;AAAA,IACxB;AAAA,GACJ,GACA,IAAA;AAEN,EAAA,GAAA,CAAI,KAAK,yBAAA,EAA2B;AAAA,IAChC,IAAA;AAAA,IACA,YAAA,EAAc,sBAAsB,uBAAA,GAA0B;AAAA,GACjE,CAAA;AAED,EAAA,OAAO;AAAA,IACH,MAAA,EAAQ,SAAA;AAAA,IACR,YAAA,EAAc,eAAA;AAAA,IACd,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,eAAA;AAAA,IACd,UAAA,EAAY,OAAO,EAAE,GAAG,QAAQ,IAAA,EAAK;AAAA,GACzC;AACJ;AAKA,SAAS,gBAAgB,aAAA,EAAyC;AAE9D,EAAA,MAAM,wBAAA,uBAA+B,GAAA,EAAuC;AAG5E,EAAA,aAAA,CAAc,SAAA,CAAU,CAAC,KAAA,KAAU;AAC/B,IAAA,MAAM,OAAA,GAAU,MAAM,eAAA,GAChB;AAAA,MACI,OAAA,EAAS,MAAM,eAAA,CAAgB,OAAA;AAAA,MAC/B,IAAA,EAAM,KAAA,CAAM,eAAA,CAAgB,IAAA,IAAQ,MAAA;AAAA,MACpC,MAAA,EAAQ,MAAM,eAAA,CAAgB;AAAA,KAClC,GACA,IAAA;AACN,IAAA,KAAA,MAAW,YAAY,wBAAA,EAA0B;AAC7C,MAAA,IAAI;AACA,QAAA,QAAA,CAAS,OAAO,CAAA;AAAA,MACpB,SAAS,CAAA,EAAG;AACR,QAAA,GAAA,CAAI,IAAA,CAAK,+BAAA,EAAiC,EAAE,KAAA,EAAO,GAAG,CAAA;AAAA,MAC1D;AAAA,IACJ;AAAA,EACJ,CAAC,CAAA;AAED,EAAA,OAAO;AAAA,IACH,MAAM,OAAA,GAA4C;AAC9C,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,OAAA,EAAQ;AAC3C,MAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA;AAAA,MACxC;AACA,MAAA,OAAO;AAAA,QACH,QAAA,EAAU,MAAA,CAAO,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,UAC/B,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,IAAA,EAAM,EAAE,IAAA,IAAQ,MAAA;AAAA,UAChB,QAAQ,CAAA,CAAE;AAAA,SACd,CAAE;AAAA,OACN;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,UAAA,GAA4B;AAC9B,MAAA,aAAA,CAAc,UAAA,EAAW;AAAA,IAC7B,CAAA;AAAA,IAEA,WAAA,GAAyB;AACrB,MAAA,OAAO,cAAc,QAAA,EAAS,CAAE,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QACjD,SAAS,CAAA,CAAE,OAAA;AAAA,QACX,IAAA,EAAM,EAAE,IAAA,IAAQ,MAAA;AAAA,QAChB,QAAQ,CAAA,CAAE;AAAA,OACd,CAAE,CAAA;AAAA,IACN,CAAA;AAAA,IAEA,kBAAA,GAAqC;AACjC,MAAA,MAAM,QAAA,GAAW,aAAA,CAAc,QAAA,EAAS,CAAE,eAAA;AAC1C,MAAA,IAAI,CAAC,UAAU,OAAO,IAAA;AACtB,MAAA,OAAO;AAAA,QACH,SAAS,QAAA,CAAS,OAAA;AAAA,QAClB,IAAA,EAAM,SAAS,IAAA,IAAQ,MAAA;AAAA,QACvB,QAAQ,QAAA,CAAS;AAAA,OACrB;AAAA,IACJ,CAAA;AAAA,IAEA,cAAc,OAAA,EAAuB;AACjC,MAAA,aAAA,CAAc,cAAc,OAAO,CAAA;AAAA,IACvC,CAAA;AAAA,IAEA,MAAM,YAAY,OAAA,EAAmD;AACjE,MAAA,MAAM,KAAA,GAAQ,OAAO,OAAA,KAAY,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,OAAO,CAAA,GAAI,OAAA;AAChF,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,OAAA,CAAQ,KAAK,CAAA;AAChD,MAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA;AAAA,MACxC;AACA,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAClB,CAAA;AAAA,IAEA,MAAM,6BAA6B,IAAA,EAAM;AACrC,MAAA,MAAM,OAAA,GACF,OAAO,IAAA,CAAK,OAAA,KAAY,QAAA,GAClB,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,GACrC,IAAA,CAAK,OAAA;AACf,MAAA,MAAM,gBAAA,GAAmB,MAAM,uBAAA,EAAwB;AACvD,MAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAa,MAAM,mBAAmB,gBAAgB,CAAA;AAS5E,MAAA,MAAM,eAAe,WAAA,CAAY,IAAA,CAAK,WAAW,CAAA,GAC3C,SAAA,CAAU,KAAK,WAAW,CAAA,GAC1B,MAAM,iBAAA,CAAkB,EAAE,QAAQ,EAAE,MAAA,EAAQ,KAAK,WAAA,EAAY,EAAG,CAAA,CAAE,IAAA;AAAA,QAC9D,CAAC,CAAA,KAAM,CAAA,CAAE,GAAA,CAAI;AAAA,OACjB;AAMN,MAAA,MAAM,YAAY,YAAA,CAAa,WAAA;AAAA,QAC3B,IAAA,CAAK;AAAA,OACT;AACA,MAAA,MAAM,KAAA,GAAQ,MAAM,0BAAA,CAA2B,QAAA,EAAU,SAAS,CAAA;AAClE,MAAA,IAAI,CAAC,KAAA,EAAO;AACR,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gCAAA,EAAmC,QAAQ,CAAA,CAAA,CAAG,CAAA;AAAA,MAClE;AAEA,MAAA,MAAM,SAAA,GAAY,eAAe,KAAK,CAAA;AAItC,MAAA,MAAM,SAAA,GAAY,oBAAoB,SAAS,CAAA;AAC/C,MAAA,MAAM,SAAS,gBAAA,CAAiB,sBAAA,CAAuB,EAAE,SAAA,EAAW,IAAA,EAAM,UAAU,CAAA;AAEpF,MAAA,IAAI;AACA,QAAA,OAAO;AAAA,UACH,QAAA;AAAA,UACA,SAAA;AAAA,UACA,SAAA,EAAW,MAAM,MAAA,CAAO,SAAA,CAAU,OAAO;AAAA,SAC7C;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,MAAM,IAAI,KAAA;AAAA,UACN,CAAA,oCAAA,EAAuC,QAAQ,CAAA,GAAA,EAC3C,KAAA,YAAiB,QAAQ,KAAA,CAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CACzD,CAAA,CAAA;AAAA,UACA,EAAE,KAAA;AAAM,SACZ;AAAA,MACJ;AAAA,IACJ,CAAA;AAAA,IAEA,gBAAgB,QAAA,EAAyD;AACrE,MAAA,wBAAA,CAAyB,IAAI,QAAQ,CAAA;AACrC,MAAA,OAAO,MAAM,wBAAA,CAAyB,MAAA,CAAO,QAAQ,CAAA;AAAA,IACzD,CAAA;AAAA,IAEA,iBAAA,GAAoC;AAGhC,MAAA,GAAA,CAAI,IAAA;AAAA,QACA;AAAA,OACJ;AACA,MAAA,OAAO,IAAA;AAAA,IACX,CAAA;AAAA,IAEA,iBAAA,GAAmC;AAG/B,MAAA,GAAA,CAAI,IAAA;AAAA,QACA;AAAA,OACJ;AACA,MAAA,OAAO,IAAA;AAAA,IACX,CAAA;AAAA,IAEA,MAAM,YAAY,QAAA,EAA2C;AAEzD,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OAEJ;AAAA,IACJ;AAAA,GACJ;AACJ;AAIA,eAAe,uBAAA,GAAyD;AACpE,EAAA,MAAM,QAAA,GAAW,MAAM,mBAAA,EAAoB;AAC3C,EAAA,IAAI,CAAC,QAAA,EAAU;AACX,IAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,QAAA;AACX;AAEA,eAAe,mBAAmB,gBAAA,EAAyD;AACvF,EAAA,MAAM,MAAA,GAAS,MAAM,gBAAA,CAAiB,SAAA,EAAU,CAAE,KAAA;AAAA,IAC9C,CAAC,KAAA,KAAU,KAAA;AAAA,IACX,CAACA,IAAAA,KAAQ;AACL,MAAA,MAAMA,IAAAA;AAAA,IACV;AAAA,GACJ;AACA,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,eAAA,CAAgB,IAAA,EAAK;AAC7C,EAAA,IAAI,CAAC,QAAA,EAAU;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC5E;AACA,EAAA,OAAO,QAAA;AACX","file":"chunk-VWD6HK2C.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and cloud storage APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    ChainApi,\n    Account,\n    CloudStorageApi,\n    LocalStorageApi,\n} from \"./types.js\";\nimport { createLocalStorageApi } from \"./local-storage-api.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createLocalKvStore } from \"@parity/product-sdk-local-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport {\n    CloudStorageClient,\n    ProductCloudStorageError,\n    calculateCid,\n    createLazySigner,\n} from \"@parity/product-sdk-cloud-storage\";\nimport { err, ok } from \"@parity/result\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\nimport { accountIdBytes } from \"@parity/product-sdk-address\";\nimport {\n    getAccountsProvider,\n    getTruApi,\n    HostCallFailedError,\n    HostUnavailableError,\n} from \"@parity/product-sdk-host\";\nimport {\n    accountIdBytesToHex,\n    type PeopleUsernameQueryApi,\n    resolvePeopleUsernameOwner,\n} from \"../identity/dotns.js\";\n\nconst log = createLogger(\"app\");\n\n/**\n * Create a new Product SDK app instance\n *\n * @param config - Application configuration\n * @returns App instance with all APIs\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * // Default: cloud storage enabled with paseo environment\n * const app = await createApp({\n *   logLevel: 'info',\n * });\n *\n * // Custom cloud storage environment\n * const prodApp = await createApp({\n *   cloudStorage: { environment: 'polkadot' },\n * });\n *\n * // Disable cloud storage entirely\n * const noCloudStorageApp = await createApp({\n *   cloudStorage: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.localStorage.set('key', 'value');\n *\n * // Use cloud storage (check for null if it might be disabled)\n * if (app.cloudStorage) {\n *   const cid = await app.cloudStorage.upload('hello world');\n * }\n * ```\n */\nexport async function createApp(config: AppConfig = {}): Promise<App> {\n    // Set log level if specified\n    if (config.logLevel) {\n        configure({ level: config.logLevel });\n    }\n\n    if (config.name !== undefined) {\n        log.warn(\n            \"createApp: name is deprecated and ignored. Remove the name option. The SDK resolves the app name from system.getProductContext(), dropping the product ID's final domain suffix (my-app.dot -> my-app). Local development IDs stay unchanged.\",\n        );\n    }\n\n    const truApi = await getTruApi();\n    if (!truApi) {\n        throw new HostUnavailableError(\"createApp requires a host product context\");\n    }\n    const { productId } = await truApi.system.getProductContext().match(\n        (context) => context,\n        (error) => {\n            throw new HostCallFailedError(\"system.getProductContext\", error);\n        },\n    );\n\n    const isLocalHost = /^(?:localhost|127\\.0\\.0\\.1|[^:]+\\.localhost)(?::\\d+)?$/i.test(productId);\n    const name = isLocalHost ? productId : productId.replace(/\\.[^.]+$/, \"\");\n\n    log.info(\"Creating Product SDK app\", { name });\n\n    // Initialize storage (container-only - will throw if not in container)\n    const localKvStore = await createLocalKvStore({ prefix: name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: productId,\n    });\n\n    // Initialize cloud storage client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the cloud storage client can be built before\n    // an account is selected. Uploads will throw a clear error if no signer\n    // is available at submission time. Reads (fetch / fetchJson) don't need\n    // a signer, so they work regardless of whether an account is selected --\n    // but they are container-only and throw CloudStorageHostUnavailableError\n    // outside a host container (no IPFS-gateway fallback).\n    const cloudStorageEnabled = config.cloudStorage !== false;\n    const cloudStorageEnvironment =\n        typeof config.cloudStorage === \"object\" ? config.cloudStorage.environment : \"paseo\";\n    const cloudStorageClient = cloudStorageEnabled\n        ? await CloudStorageClient.create({\n              environment: cloudStorageEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (cloudStorageEnabled) {\n        log.debug(\"Cloud Storage client (Bulletin) initialized\", {\n            environment: cloudStorageEnvironment,\n        });\n    } else {\n        log.debug(\"Cloud Storage client disabled\");\n    }\n\n    // Storage API adapter — shared with `createFakeApp` so the two cannot drift.\n    const localStorageApi: LocalStorageApi = createLocalStorageApi(localKvStore);\n\n    // Create wallet API adapter\n    const walletApi = createWalletApi(signerManager);\n\n    // Create chain API\n    const chainApi: ChainApi = {\n        getClient(descriptor) {\n            log.debug(\"getClient called\", { genesis: descriptor.genesis });\n            const client = getClient(descriptor);\n            return client.getTypedApi(descriptor);\n        },\n\n        getRawClient(descriptor) {\n            log.debug(\"getRawClient called\", { genesis: descriptor.genesis });\n            return getClient(descriptor);\n        },\n\n        async connect<T extends Record<string, ChainDefinition>>(chains: T) {\n            log.debug(\"connect called\", { chains: Object.keys(chains) });\n            return createChainClient({ chains });\n        },\n\n        isConnected(descriptor) {\n            return isConnected(descriptor);\n        },\n\n        destroyAll() {\n            log.debug(\"destroyAll called\");\n            destroyAll();\n        },\n    };\n\n    // Create Cloud Storage API adapter (null if disabled)\n    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  try {\n                      // Explicitly request a DAG-PB manifest so chunked uploads always\n                      // resolve to a single root CID. Without this, AsyncBulletinClient\n                      // can return `result.cid: undefined` for chunked-without-manifest\n                      // uploads — but app consumers expect a CID they can hand to\n                      // `fetch(cid)`, so treat a missing CID as an error.\n                      const uploaded = await cloudStorageClient\n                          .store(bytes)\n                          .withManifest(true)\n                          .send();\n                      if (!uploaded.cid) {\n                          return err(\n                              new ProductCloudStorageError(\n                                  \"Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                              ),\n                          );\n                      }\n                      return ok(uploaded.cid.toString());\n                  } catch (cause) {\n                      const message = cause instanceof Error ? cause.message : String(cause);\n                      return err(new ProductCloudStorageError(message, { cause }));\n                  }\n              },\n              fetch: (cid) => cloudStorageClient.fetchBytes(cid),\n              computeCid: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  const cid = await calculateCid(bytes);\n                  return cid.toString();\n              },\n          }\n        : null;\n\n    log.info(\"Product SDK app created\", {\n        name,\n        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        localStorage: localStorageApi,\n        chain: chainApi,\n        cloudStorage: cloudStorageApi,\n        getAppInfo: () => ({ ...config, name }),\n    };\n}\n\n/**\n * Create wallet API adapter using SignerManager from leaf package\n */\nfunction createWalletApi(signerManager: SignerManager): WalletApi {\n    // Track account change subscribers\n    const accountChangeSubscribers = new Set<(account: Account | null) => void>();\n\n    // Subscribe to signer manager state changes\n    signerManager.subscribe((state) => {\n        const account = state.selectedAccount\n            ? {\n                  address: state.selectedAccount.address,\n                  name: state.selectedAccount.name ?? undefined,\n                  source: state.selectedAccount.source,\n              }\n            : null;\n        for (const callback of accountChangeSubscribers) {\n            try {\n                callback(account);\n            } catch (e) {\n                log.warn(\"Account change callback threw\", { error: e });\n            }\n        }\n    });\n\n    return {\n        async connect(): Promise<{ accounts: Account[] }> {\n            const result = await signerManager.connect();\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return {\n                accounts: result.value.map((a) => ({\n                    address: a.address,\n                    name: a.name ?? undefined,\n                    source: a.source,\n                })),\n            };\n        },\n\n        async disconnect(): Promise<void> {\n            signerManager.disconnect();\n        },\n\n        getAccounts(): Account[] {\n            return signerManager.getState().accounts.map((a) => ({\n                address: a.address,\n                name: a.name ?? undefined,\n                source: a.source,\n            }));\n        },\n\n        getSelectedAccount(): Account | null {\n            const selected = signerManager.getState().selectedAccount;\n            if (!selected) return null;\n            return {\n                address: selected.address,\n                name: selected.name ?? undefined,\n                source: selected.source,\n            };\n        },\n\n        selectAccount(address: string): void {\n            signerManager.selectAccount(address);\n        },\n\n        async signMessage(message: string | Uint8Array): Promise<Uint8Array> {\n            const bytes = typeof message === \"string\" ? new TextEncoder().encode(message) : message;\n            const result = await signerManager.signRaw(bytes);\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return result.value;\n        },\n\n        async signMessageWithDotNsIdentity(args) {\n            const message =\n                typeof args.message === \"string\"\n                    ? new TextEncoder().encode(args.message)\n                    : args.message;\n            const accountsProvider = await getHostAccountsProvider();\n            const username = args.username ?? (await getPrimaryUsername(accountsProvider));\n\n            // Reuse an already-connected People chain when the caller has\n            // wired one up via `app.chain.connect({ ..., <name>: peopleChain })`.\n            // Fall back to opening a transient connection so first-time users\n            // don't have to think about chain lifecycles. The chain-client\n            // module caches by genesis fingerprint, so subsequent\n            // signMessageWithDotNsIdentity calls share whichever connection\n            // got established first.\n            const peopleClient = isConnected(args.peopleChain)\n                ? getClient(args.peopleChain)\n                : await createChainClient({ chains: { people: args.peopleChain } }).then(\n                      (c) => c.raw.people,\n                  );\n            // PAPI's `TypedApi.query.X.Y.getValue` is variadic\n            // (`...args: [...WithCallOptions<Args>]`) so it's not assignable\n            // to our deliberately-narrow `(key) => Promise<...>` shape. The\n            // resolver only ever passes the storage key; the cast adapts the\n            // wider PAPI surface to the minimum we depend on.\n            const peopleApi = peopleClient.getTypedApi(\n                args.peopleChain,\n            ) as unknown as PeopleUsernameQueryApi;\n            const owner = await resolvePeopleUsernameOwner(username, peopleApi);\n            if (!owner) {\n                throw new Error(`No account owns DotNS username \"${username}\"`);\n            }\n\n            const publicKey = accountIdBytes(owner);\n            // This field is hex, not the SS58 the resolver now returns. Converted\n            // here and not in the try, so an address failure is not reported as a\n            // signing failure.\n            const accountId = accountIdBytesToHex(publicKey);\n            const signer = accountsProvider.getLegacyAccountSigner({ publicKey, name: username });\n\n            try {\n                return {\n                    username,\n                    accountId,\n                    signature: await signer.signBytes(message),\n                };\n            } catch (cause) {\n                throw new Error(\n                    `Failed to sign with DotNS username \"${username}\": ${\n                        cause instanceof Error ? cause.message : String(cause)\n                    }`,\n                    { cause },\n                );\n            }\n        },\n\n        onAccountChange(callback: (account: Account | null) => void): () => void {\n            accountChangeSubscribers.add(callback);\n            return () => accountChangeSubscribers.delete(callback);\n        },\n\n        getProductAccount(): Account | null {\n            // Product accounts require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccount() directly\n            log.warn(\n                \"getProductAccount() is deprecated - use SignerManager.getProductAccount() directly\",\n            );\n            return null;\n        },\n\n        getAnonymousAlias(): string | null {\n            // Anonymous aliases require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccountAlias() directly\n            log.warn(\n                \"getAnonymousAlias() is deprecated - use SignerManager.getProductAccountAlias() directly\",\n            );\n            return null;\n        },\n\n        async createProof(_message: Uint8Array): Promise<Uint8Array> {\n            // Ring VRF proofs require SignerManager.createRingVRFProof() directly\n            throw new Error(\n                \"createProof() is not implemented in the App API. \" +\n                    \"Use SignerManager.createRingVRFProof() directly.\",\n            );\n        },\n    };\n}\n\ntype HostAccountsProvider = NonNullable<Awaited<ReturnType<typeof getAccountsProvider>>>;\n\nasync function getHostAccountsProvider(): Promise<HostAccountsProvider> {\n    const provider = await getAccountsProvider();\n    if (!provider) {\n        throw new Error(\"Host accounts provider is not available\");\n    }\n    return provider;\n}\n\nasync function getPrimaryUsername(accountsProvider: HostAccountsProvider): Promise<string> {\n    const result = await accountsProvider.getUserId().match(\n        (value) => value,\n        (err) => {\n            throw err;\n        },\n    );\n    const username = result.primaryUsername.trim();\n    if (!username) {\n        throw new Error(\"Host identity did not provide a primary DotNS username\");\n    }\n    return username;\n}\n"]}

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
 export { createApp } from '../index.js';
 export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
-export { A as Account, b as App, c as AppConfig, C as ChainApi, a as CloudStorageApi, d as CloudStorageConfig, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from '../types-C676_6Fp.js';
+export { A as Account, b as App, c as AppConfig, d as AppInfo, C as ChainApi, a as CloudStorageApi, e as CloudStorageConfig, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from '../types-BpWw-OJl.js';
 export { ChainClient } from '@parity/product-sdk-chain-client';
 export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
 import '@parity/result';

package/dist/core/index.js

@@ -1,5 +1,5 @@
 export { configure, createLogger } from '../chunk-JVJ552RU.js';
-export { createApp } from '../chunk-KXJT2BNL.js';
+export { createApp } from '../chunk-VWD6HK2C.js';
 import '../chunk-7GM3HUZF.js';
 import '../chunk-TUXU2VPS.js';
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
-import { c as AppConfig, b as App } from './types-C676_6Fp.js';
-export { A as Account, C as ChainApi, a as CloudStorageApi, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from './types-C676_6Fp.js';
+import { c as AppConfig, b as App } from './types-BpWw-OJl.js';
+export { A as Account, d as AppInfo, C as ChainApi, a as CloudStorageApi, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from './types-BpWw-OJl.js';
 export { Result, err, isErrorOf, ok } from '@parity/result';
 export { SdkError, isSdkError } from '@parity/product-sdk-errors';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
@@ -29,19 +29,16 @@ import './dotns-CtmOwVQW.js';
  *
  * // Default: cloud storage enabled with paseo environment
  * const app = await createApp({
- *   name: 'my-app',
  *   logLevel: 'info',
  * });
  *
  * // Custom cloud storage environment
  * const prodApp = await createApp({
- *   name: 'my-app',
  *   cloudStorage: { environment: 'polkadot' },
  * });
  *
  * // Disable cloud storage entirely
  * const noCloudStorageApp = await createApp({
- *   name: 'my-app',
  *   cloudStorage: false,
  * });
  *
@@ -57,6 +54,6 @@ import './dotns-CtmOwVQW.js';
  * }
  * ```
  */
-declare function createApp(config: AppConfig): Promise<App>;
+declare function createApp(config?: AppConfig): Promise<App>;
 
 export { App, AppConfig, createApp };

package/dist/index.js

@@ -1,5 +1,5 @@
 export { configure, createLogger } from './chunk-JVJ552RU.js';
-export { createApp } from './chunk-KXJT2BNL.js';
+export { createApp } from './chunk-VWD6HK2C.js';
 import './chunk-7GM3HUZF.js';
 import './chunk-TUXU2VPS.js';
 export { err, isErrorOf, ok } from '@parity/result';

package/dist/react/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { LogLevel } from '@parity/product-sdk-logger';
-import { b as App, S as SignMessageWithDotNsIdentityArgs, D as DotNsIdentitySignature, A as Account } from '../types-C676_6Fp.js';
+import { b as App, S as SignMessageWithDotNsIdentityArgs, D as DotNsIdentitySignature, A as Account } from '../types-BpWw-OJl.js';
 import { ChainDefinition, TypedApi } from 'polkadot-api';
 import '@parity/product-sdk-cloud-storage';
 import '@parity/result';
@@ -11,8 +11,8 @@ import '../dotns-CtmOwVQW.js';
 
 /** Props for ProductSDKProvider */
 interface ProductSDKProviderProps {
-    /** Application name - used for storage namespacing and product account derivation */
-    name: string;
+    /** @deprecated Ignored with a warning. The host product ID supplies the app name. */
+    name?: string;
     /** Log level (default: 'info') */
     logLevel?: LogLevel;
     /** Child components */
@@ -29,7 +29,7 @@ interface ProductSDKProviderProps {
  *
  * function App() {
  *   return (
- *     <ProductSDKProvider name="my-app" fallback={<Loading />}>
+ *     <ProductSDKProvider fallback={<Loading />}>
  *       <MyApp />
  *     </ProductSDKProvider>
  *   );

package/dist/react/index.js

@@ -1,4 +1,4 @@
-import { createApp } from '../chunk-KXJT2BNL.js';
+import { createApp } from '../chunk-VWD6HK2C.js';
 import '../chunk-7GM3HUZF.js';
 import '../chunk-TUXU2VPS.js';
 import { createContext, useContext, useState, useEffect, useCallback, useMemo } from 'react';
@@ -9,7 +9,7 @@ function useProductSDK() {
   const app = useContext(ProductSDKContext);
   if (!app) {
     throw new Error(
-      'useProductSDK must be used within a ProductSDKProvider. Wrap your app with <ProductSDKProvider name="your-app">.'
+      "useProductSDK must be used within a ProductSDKProvider. Wrap your app with <ProductSDKProvider>."
     );
   }
   return app;

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/context.ts","../../src/react/provider.tsx","../../src/react/useWallet.ts","../../src/react/useLocalStorage.ts","../../src/react/useChain.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * React context for Product SDK\n */\n\nimport { createContext, useContext } from \"react\";\nimport type { App } from \"../core/types.js\";\n\n/** Context for the Product SDK app instance */\nexport const ProductSDKContext = createContext<App | null>(null);\n\n/**\n * Hook to access the Product SDK app instance\n *\n * @throws If used outside of ProductSDKProvider\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const app = useProductSDK();\n *   // Use app.wallet, app.localStorage, etc.\n * }\n * ```\n */\nexport function useProductSDK(): App {\n    const app = useContext(ProductSDKContext);\n    if (!app) {\n        throw new Error(\n            \"useProductSDK must be used within a ProductSDKProvider. \" +\n                'Wrap your app with <ProductSDKProvider name=\"your-app\">.',\n        );\n    }\n    return app;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * ProductSDKProvider component\n */\n\nimport React, { useEffect, useState, type ReactNode } from \"react\";\nimport { ProductSDKContext } from \"./context.js\";\nimport { createApp } from \"../core/createApp.js\";\nimport type { App, LogLevel } from \"../core/types.js\";\n\n/** Props for ProductSDKProvider */\nexport interface ProductSDKProviderProps {\n    /** Application name - used for storage namespacing and product account derivation */\n    name: string;\n    /** Log level (default: 'info') */\n    logLevel?: LogLevel;\n    /** Child components */\n    children: ReactNode;\n    /** Fallback to show while loading */\n    fallback?: ReactNode;\n}\n\n/**\n * Provider component that initializes the Product SDK\n *\n * @example\n * ```tsx\n * import { ProductSDKProvider } from '@parity/product-sdk/react';\n *\n * function App() {\n *   return (\n *     <ProductSDKProvider name=\"my-app\" fallback={<Loading />}>\n *       <MyApp />\n *     </ProductSDKProvider>\n *   );\n * }\n * ```\n */\nexport function ProductSDKProvider({\n    name,\n    logLevel = \"info\",\n    children,\n    fallback = null,\n}: ProductSDKProviderProps) {\n    const [app, setApp] = useState<App | null>(null);\n    const [error, setError] = useState<Error | null>(null);\n\n    useEffect(() => {\n        let mounted = true;\n\n        createApp({ name, logLevel })\n            .then((createdApp) => {\n                if (mounted) {\n                    setApp(createdApp);\n                }\n            })\n            .catch((e) => {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                }\n            });\n\n        return () => {\n            mounted = false;\n        };\n    }, [name, logLevel]);\n\n    if (error) {\n        throw error;\n    }\n\n    if (!app) {\n        return <>{fallback}</>;\n    }\n\n    return <ProductSDKContext.Provider value={app}>{children}</ProductSDKContext.Provider>;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useWallet hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type {\n    Account,\n    DotNsIdentitySignature,\n    SignMessageWithDotNsIdentityArgs,\n} from \"../core/types.js\";\n\n/** Wallet hook state */\nexport interface UseWalletState {\n    /** Whether wallet is connected */\n    isConnected: boolean;\n    /** Whether connection is in progress */\n    isConnecting: boolean;\n    /** Available accounts */\n    accounts: Account[];\n    /** Currently selected account */\n    selectedAccount: Account | null;\n    /** Last error */\n    error: Error | null;\n}\n\n/** Wallet hook actions */\nexport interface UseWalletActions {\n    /** Connect to wallet */\n    connect: () => Promise<void>;\n    /** Disconnect from wallet */\n    disconnect: () => Promise<void>;\n    /** Select an account */\n    selectAccount: (address: string) => void;\n    /** Sign a message */\n    signMessage: (message: string | Uint8Array) => Promise<Uint8Array>;\n    /** Sign a message with the account that owns a DotNS / People username identity. */\n    signMessageWithDotNsIdentity: (\n        args: SignMessageWithDotNsIdentityArgs,\n    ) => Promise<DotNsIdentitySignature>;\n}\n\n/** Return type of useWallet */\nexport type UseWalletReturn = UseWalletState & UseWalletActions;\n\n/**\n * Hook for wallet connection and signing\n *\n * @example\n * ```tsx\n * function WalletButton() {\n *   const { isConnected, accounts, connect, disconnect, selectAccount } = useWallet();\n *\n *   if (!isConnected) {\n *     return <button onClick={connect}>Connect Wallet</button>;\n *   }\n *\n *   return (\n *     <div>\n *       <select onChange={(e) => selectAccount(e.target.value)}>\n *         {accounts.map((a) => (\n *           <option key={a.address} value={a.address}>\n *             {a.name || a.address}\n *           </option>\n *         ))}\n *       </select>\n *       <button onClick={disconnect}>Disconnect</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useWallet(): UseWalletReturn {\n    const app = useProductSDK();\n\n    const [state, setState] = useState<UseWalletState>({\n        isConnected: false,\n        isConnecting: false,\n        accounts: [],\n        selectedAccount: null,\n        error: null,\n    });\n\n    const connect = useCallback(async () => {\n        setState((s) => ({ ...s, isConnecting: true, error: null }));\n        try {\n            const result = await app.wallet.connect();\n            setState((s) => ({\n                ...s,\n                isConnected: true,\n                isConnecting: false,\n                accounts: result.accounts,\n                selectedAccount: result.accounts[0] || null,\n            }));\n        } catch (e) {\n            setState((s) => ({\n                ...s,\n                isConnecting: false,\n                error: e instanceof Error ? e : new Error(String(e)),\n            }));\n        }\n    }, [app]);\n\n    const disconnect = useCallback(async () => {\n        await app.wallet.disconnect();\n        setState({\n            isConnected: false,\n            isConnecting: false,\n            accounts: [],\n            selectedAccount: null,\n            error: null,\n        });\n    }, [app]);\n\n    const selectAccount = useCallback(\n        (address: string) => {\n            app.wallet.selectAccount(address);\n            const account = state.accounts.find((a) => a.address === address) || null;\n            setState((s) => ({ ...s, selectedAccount: account }));\n        },\n        [app, state.accounts],\n    );\n\n    const signMessage = useCallback(\n        async (message: string | Uint8Array) => {\n            return app.wallet.signMessage(message);\n        },\n        [app],\n    );\n\n    const signMessageWithDotNsIdentity = useCallback(\n        async (args: SignMessageWithDotNsIdentityArgs) => {\n            return app.wallet.signMessageWithDotNsIdentity(args);\n        },\n        [app],\n    );\n\n    // Subscribe to account changes\n    useEffect(() => {\n        const unsubscribe = app.wallet.onAccountChange((account) => {\n            setState((s) => ({ ...s, selectedAccount: account }));\n        });\n        return unsubscribe;\n    }, [app]);\n\n    return {\n        ...state,\n        connect,\n        disconnect,\n        selectAccount,\n        signMessage,\n        signMessageWithDotNsIdentity,\n    };\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useLocalStorage hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\n\n/**\n * Hook for key-value storage operations\n *\n * @param key - Storage key\n * @param defaultValue - Default value if key doesn't exist\n *\n * @example\n * ```tsx\n * function ThemeToggle() {\n *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');\n *\n *   if (loading) return <div>Loading...</div>;\n *\n *   return (\n *     <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>\n *       Current: {theme}\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useLocalStorage<T = string>(\n    key: string,\n    defaultValue?: T,\n): [T | null, (value: T) => Promise<void>, { loading: boolean; error: Error | null }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<T | null>(null);\n    const [loading, setLoading] = useState(true);\n    const [error, setError] = useState<Error | null>(null);\n\n    // Load initial value\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            try {\n                setLoading(true);\n                const stored = await app.localStorage.getJSON<T>(key);\n                if (mounted) {\n                    setValue(stored ?? defaultValue ?? null);\n                    setLoading(false);\n                }\n            } catch (e) {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                    setLoading(false);\n                }\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: T) => {\n            try {\n                setError(null);\n                await app.localStorage.setJSON(key, newValue);\n                setValue(newValue);\n            } catch (e) {\n                setError(e instanceof Error ? e : new Error(String(e)));\n                throw e;\n            }\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading, error }];\n}\n\n/**\n * Hook for string storage (simpler API)\n *\n * @param key - Storage key\n * @param defaultValue - Default value\n */\nexport function useLocalStorageString(\n    key: string,\n    defaultValue?: string,\n): [string | null, (value: string) => Promise<void>, { loading: boolean }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<string | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            const stored = await app.localStorage.get(key);\n            if (mounted) {\n                setValue(stored ?? defaultValue ?? null);\n                setLoading(false);\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: string) => {\n            await app.localStorage.set(key, newValue);\n            setValue(newValue);\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading }];\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useChain hook\n */\n\nimport { useMemo } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type { ChainDefinition, TypedApi } from \"../core/types.js\";\n\n/**\n * Hook to get a typed chain client\n *\n * @param chain - Chain descriptor (PAPI ChainDefinition)\n *\n * @example\n * ```tsx\n * import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';\n * import { useChain } from '@parity/product-sdk/react';\n *\n * function AssetHubBalance() {\n *   const assetHub = useChain(paseo_asset_hub);\n *\n *   // assetHub is typed for Asset Hub queries\n *   const balance = await assetHub.query.System.Account.getValue(address);\n * }\n * ```\n */\nexport function useChain<T extends ChainDefinition>(chain: T): TypedApi<T> {\n    const app = useProductSDK();\n\n    return useMemo(() => {\n        return app.chain.getClient(chain);\n    }, [app, chain]);\n}\n"]}
+{"version":3,"sources":["../../src/react/context.ts","../../src/react/provider.tsx","../../src/react/useWallet.ts","../../src/react/useLocalStorage.ts","../../src/react/useChain.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * React context for Product SDK\n */\n\nimport { createContext, useContext } from \"react\";\nimport type { App } from \"../core/types.js\";\n\n/** Context for the Product SDK app instance */\nexport const ProductSDKContext = createContext<App | null>(null);\n\n/**\n * Hook to access the Product SDK app instance\n *\n * @throws If used outside of ProductSDKProvider\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const app = useProductSDK();\n *   // Use app.wallet, app.localStorage, etc.\n * }\n * ```\n */\nexport function useProductSDK(): App {\n    const app = useContext(ProductSDKContext);\n    if (!app) {\n        throw new Error(\n            \"useProductSDK must be used within a ProductSDKProvider. \" +\n                \"Wrap your app with <ProductSDKProvider>.\",\n        );\n    }\n    return app;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * ProductSDKProvider component\n */\n\nimport React, { useEffect, useState, type ReactNode } from \"react\";\nimport { ProductSDKContext } from \"./context.js\";\nimport { createApp } from \"../core/createApp.js\";\nimport type { App, LogLevel } from \"../core/types.js\";\n\n/** Props for ProductSDKProvider */\nexport interface ProductSDKProviderProps {\n    /** @deprecated Ignored with a warning. The host product ID supplies the app name. */\n    name?: string;\n    /** Log level (default: 'info') */\n    logLevel?: LogLevel;\n    /** Child components */\n    children: ReactNode;\n    /** Fallback to show while loading */\n    fallback?: ReactNode;\n}\n\n/**\n * Provider component that initializes the Product SDK\n *\n * @example\n * ```tsx\n * import { ProductSDKProvider } from '@parity/product-sdk/react';\n *\n * function App() {\n *   return (\n *     <ProductSDKProvider fallback={<Loading />}>\n *       <MyApp />\n *     </ProductSDKProvider>\n *   );\n * }\n * ```\n */\nexport function ProductSDKProvider({\n    name,\n    logLevel = \"info\",\n    children,\n    fallback = null,\n}: ProductSDKProviderProps) {\n    const [app, setApp] = useState<App | null>(null);\n    const [error, setError] = useState<Error | null>(null);\n\n    useEffect(() => {\n        let mounted = true;\n\n        createApp({ name, logLevel })\n            .then((createdApp) => {\n                if (mounted) {\n                    setApp(createdApp);\n                }\n            })\n            .catch((e) => {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                }\n            });\n\n        return () => {\n            mounted = false;\n        };\n    }, [name, logLevel]);\n\n    if (error) {\n        throw error;\n    }\n\n    if (!app) {\n        return <>{fallback}</>;\n    }\n\n    return <ProductSDKContext.Provider value={app}>{children}</ProductSDKContext.Provider>;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useWallet hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type {\n    Account,\n    DotNsIdentitySignature,\n    SignMessageWithDotNsIdentityArgs,\n} from \"../core/types.js\";\n\n/** Wallet hook state */\nexport interface UseWalletState {\n    /** Whether wallet is connected */\n    isConnected: boolean;\n    /** Whether connection is in progress */\n    isConnecting: boolean;\n    /** Available accounts */\n    accounts: Account[];\n    /** Currently selected account */\n    selectedAccount: Account | null;\n    /** Last error */\n    error: Error | null;\n}\n\n/** Wallet hook actions */\nexport interface UseWalletActions {\n    /** Connect to wallet */\n    connect: () => Promise<void>;\n    /** Disconnect from wallet */\n    disconnect: () => Promise<void>;\n    /** Select an account */\n    selectAccount: (address: string) => void;\n    /** Sign a message */\n    signMessage: (message: string | Uint8Array) => Promise<Uint8Array>;\n    /** Sign a message with the account that owns a DotNS / People username identity. */\n    signMessageWithDotNsIdentity: (\n        args: SignMessageWithDotNsIdentityArgs,\n    ) => Promise<DotNsIdentitySignature>;\n}\n\n/** Return type of useWallet */\nexport type UseWalletReturn = UseWalletState & UseWalletActions;\n\n/**\n * Hook for wallet connection and signing\n *\n * @example\n * ```tsx\n * function WalletButton() {\n *   const { isConnected, accounts, connect, disconnect, selectAccount } = useWallet();\n *\n *   if (!isConnected) {\n *     return <button onClick={connect}>Connect Wallet</button>;\n *   }\n *\n *   return (\n *     <div>\n *       <select onChange={(e) => selectAccount(e.target.value)}>\n *         {accounts.map((a) => (\n *           <option key={a.address} value={a.address}>\n *             {a.name || a.address}\n *           </option>\n *         ))}\n *       </select>\n *       <button onClick={disconnect}>Disconnect</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useWallet(): UseWalletReturn {\n    const app = useProductSDK();\n\n    const [state, setState] = useState<UseWalletState>({\n        isConnected: false,\n        isConnecting: false,\n        accounts: [],\n        selectedAccount: null,\n        error: null,\n    });\n\n    const connect = useCallback(async () => {\n        setState((s) => ({ ...s, isConnecting: true, error: null }));\n        try {\n            const result = await app.wallet.connect();\n            setState((s) => ({\n                ...s,\n                isConnected: true,\n                isConnecting: false,\n                accounts: result.accounts,\n                selectedAccount: result.accounts[0] || null,\n            }));\n        } catch (e) {\n            setState((s) => ({\n                ...s,\n                isConnecting: false,\n                error: e instanceof Error ? e : new Error(String(e)),\n            }));\n        }\n    }, [app]);\n\n    const disconnect = useCallback(async () => {\n        await app.wallet.disconnect();\n        setState({\n            isConnected: false,\n            isConnecting: false,\n            accounts: [],\n            selectedAccount: null,\n            error: null,\n        });\n    }, [app]);\n\n    const selectAccount = useCallback(\n        (address: string) => {\n            app.wallet.selectAccount(address);\n            const account = state.accounts.find((a) => a.address === address) || null;\n            setState((s) => ({ ...s, selectedAccount: account }));\n        },\n        [app, state.accounts],\n    );\n\n    const signMessage = useCallback(\n        async (message: string | Uint8Array) => {\n            return app.wallet.signMessage(message);\n        },\n        [app],\n    );\n\n    const signMessageWithDotNsIdentity = useCallback(\n        async (args: SignMessageWithDotNsIdentityArgs) => {\n            return app.wallet.signMessageWithDotNsIdentity(args);\n        },\n        [app],\n    );\n\n    // Subscribe to account changes\n    useEffect(() => {\n        const unsubscribe = app.wallet.onAccountChange((account) => {\n            setState((s) => ({ ...s, selectedAccount: account }));\n        });\n        return unsubscribe;\n    }, [app]);\n\n    return {\n        ...state,\n        connect,\n        disconnect,\n        selectAccount,\n        signMessage,\n        signMessageWithDotNsIdentity,\n    };\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useLocalStorage hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\n\n/**\n * Hook for key-value storage operations\n *\n * @param key - Storage key\n * @param defaultValue - Default value if key doesn't exist\n *\n * @example\n * ```tsx\n * function ThemeToggle() {\n *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');\n *\n *   if (loading) return <div>Loading...</div>;\n *\n *   return (\n *     <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>\n *       Current: {theme}\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useLocalStorage<T = string>(\n    key: string,\n    defaultValue?: T,\n): [T | null, (value: T) => Promise<void>, { loading: boolean; error: Error | null }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<T | null>(null);\n    const [loading, setLoading] = useState(true);\n    const [error, setError] = useState<Error | null>(null);\n\n    // Load initial value\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            try {\n                setLoading(true);\n                const stored = await app.localStorage.getJSON<T>(key);\n                if (mounted) {\n                    setValue(stored ?? defaultValue ?? null);\n                    setLoading(false);\n                }\n            } catch (e) {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                    setLoading(false);\n                }\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: T) => {\n            try {\n                setError(null);\n                await app.localStorage.setJSON(key, newValue);\n                setValue(newValue);\n            } catch (e) {\n                setError(e instanceof Error ? e : new Error(String(e)));\n                throw e;\n            }\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading, error }];\n}\n\n/**\n * Hook for string storage (simpler API)\n *\n * @param key - Storage key\n * @param defaultValue - Default value\n */\nexport function useLocalStorageString(\n    key: string,\n    defaultValue?: string,\n): [string | null, (value: string) => Promise<void>, { loading: boolean }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<string | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            const stored = await app.localStorage.get(key);\n            if (mounted) {\n                setValue(stored ?? defaultValue ?? null);\n                setLoading(false);\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: string) => {\n            await app.localStorage.set(key, newValue);\n            setValue(newValue);\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading }];\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useChain hook\n */\n\nimport { useMemo } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type { ChainDefinition, TypedApi } from \"../core/types.js\";\n\n/**\n * Hook to get a typed chain client\n *\n * @param chain - Chain descriptor (PAPI ChainDefinition)\n *\n * @example\n * ```tsx\n * import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';\n * import { useChain } from '@parity/product-sdk/react';\n *\n * function AssetHubBalance() {\n *   const assetHub = useChain(paseo_asset_hub);\n *\n *   // assetHub is typed for Asset Hub queries\n *   const balance = await assetHub.query.System.Account.getValue(address);\n * }\n * ```\n */\nexport function useChain<T extends ChainDefinition>(chain: T): TypedApi<T> {\n    const app = useProductSDK();\n\n    return useMemo(() => {\n        return app.chain.getClient(chain);\n    }, [app, chain]);\n}\n"]}

package/dist/renderer/index.d.ts

@@ -0,0 +1 @@
+export * from '@parity/product-sdk-renderer';

package/dist/renderer/index.js

@@ -0,0 +1,3 @@
+export * from '@parity/product-sdk-renderer';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { A as Account, L as LocalStorageApi, C as ChainApi, a as CloudStorageApi, b as App } from '../types-C676_6Fp.js';
+import { A as Account, L as LocalStorageApi, C as ChainApi, a as CloudStorageApi, b as App } from '../types-BpWw-OJl.js';
 export * from '@parity/product-sdk-local-storage/testing';
 export * from '@parity/product-sdk-signer/testing';
 export * from '@parity/product-sdk-contracts/testing';

package/dist/{types-C676_6Fp.d.ts → types-BpWw-OJl.d.ts}

@@ -16,8 +16,8 @@ interface CloudStorageConfig {
 }
 /** Configuration for createApp */
 interface AppConfig {
-    /** Application name - used to derive product accounts and namespace storage */
-    name: string;
+    /** @deprecated Ignored with a warning. The host product ID supplies the app name. */
+    name?: string;
     /** Log level for SDK operations (default: 'info') */
     logLevel?: LogLevel;
     /**
@@ -27,6 +27,11 @@ interface AppConfig {
      */
     cloudStorage?: CloudStorageConfig | false;
 }
+/** App configuration with the identity resolved from the host. */
+interface AppInfo extends Omit<AppConfig, "name"> {
+    /** App name and storage prefix, omitting the host ID's final domain suffix. Local host IDs stay unchanged. */
+    name: string;
+}
 /** Wallet API exposed by the SDK */
 interface WalletApi {
     /** Connect to available wallet providers */
@@ -158,8 +163,8 @@ interface App {
     chain: ChainApi;
     /** Cloud Storage operations (null if disabled via config) */
     cloudStorage: CloudStorageApi | null;
-    /** Get app configuration */
-    getAppInfo(): AppConfig;
+    /** Get app configuration with the host-derived name. */
+    getAppInfo(): AppInfo;
 }
 /** Account information */
 interface Account {
@@ -213,4 +218,4 @@ interface DotNsIdentitySignature {
     signature: Uint8Array;
 }
 
-export type { Account as A, ChainApi as C, DotNsIdentitySignature as D, LocalStorageApi as L, SignMessageWithDotNsIdentityArgs as S, WalletApi as W, CloudStorageApi as a, App as b, AppConfig as c, CloudStorageConfig as d };
+export type { Account as A, ChainApi as C, DotNsIdentitySignature as D, LocalStorageApi as L, SignMessageWithDotNsIdentityArgs as S, WalletApi as W, CloudStorageApi as a, App as b, AppConfig as c, AppInfo as d, CloudStorageConfig as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Unified SDK for building products in the Polkadot ecosystem - umbrella package",
   "type": "module",
   "sideEffects": false,
@@ -56,6 +56,10 @@
       "import": "./dist/local-storage/index.js",
       "types": "./dist/local-storage/index.d.ts"
     },
+    "./renderer": {
+      "import": "./dist/renderer/index.js",
+      "types": "./dist/renderer/index.d.ts"
+    },
     "./wallet": {
       "import": "./dist/wallet/index.js",
       "types": "./dist/wallet/index.d.ts"
@@ -72,19 +76,20 @@
   "dependencies": {
     "polkadot-api": "^2.1.6",
     "@parity/product-sdk-address": "0.2.0",
-    "@parity/product-sdk-cloud-storage": "0.12.1",
-    "@parity/product-sdk-chain-client": "0.12.5",
-    "@parity/product-sdk-contracts": "0.10.9",
-    "@parity/product-sdk-host": "0.21.0",
+    "@parity/product-sdk-cloud-storage": "0.12.3",
+    "@parity/product-sdk-chain-client": "0.12.7",
     "@parity/product-sdk-crypto": "0.1.1",
-    "@parity/product-sdk-keys": "0.3.26",
+    "@parity/product-sdk-contracts": "0.10.11",
+    "@parity/product-sdk-host": "0.23.0",
+    "@parity/product-sdk-individuality": "0.6.0",
+    "@parity/product-sdk-keys": "0.4.1",
     "@parity/product-sdk-logger": "0.1.1",
     "@parity/product-sdk-errors": "0.2.0",
-    "@parity/product-sdk-individuality": "0.5.0",
-    "@parity/result": "0.2.0",
-    "@parity/product-sdk-signer": "0.14.6",
-    "@parity/product-sdk-local-storage": "0.3.11",
-    "@parity/product-sdk-tx": "0.4.9"
+    "@parity/product-sdk-signer": "0.15.1",
+    "@parity/product-sdk-local-storage": "0.3.13",
+    "@parity/product-sdk-renderer": "0.3.0",
+    "@parity/product-sdk-tx": "0.4.11",
+    "@parity/result": "0.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -97,6 +102,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^18.0.0",
+    "neverthrow": "^8.2.0",
     "react": "^18.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"

package/src/core/createApp.test.ts

@@ -0,0 +1,194 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+import {
+    afterEach,
+    beforeEach,
+    describe,
+    expect,
+    expectTypeOf,
+    it,
+    vi,
+    type MockInstance,
+} from "vitest";
+import { errAsync, okAsync } from "neverthrow";
+import { HostUnavailableError, type TruApi } from "@parity/product-sdk-host";
+import {
+    createFakeHost,
+    createFakeTruApiClient,
+    setTruApiClient,
+} from "@parity/product-sdk-host/testing";
+import { configure, type LogEntry } from "@parity/product-sdk-logger";
+import { createApp } from "./createApp.js";
+import type { App } from "./types.js";
+import type { ProductSDKProviderProps } from "../react/provider.js";
+
+describe("host-derived app identity", () => {
+    let client: TruApi;
+    let entries: LogEntry[];
+    const apps: App[] = [];
+    let getProductContext: MockInstance<TruApi["system"]["getProductContext"]>;
+
+    beforeEach(() => {
+        client = createFakeTruApiClient();
+        getProductContext = vi.spyOn(client.system, "getProductContext");
+        getProductContext.mockReturnValue(okAsync({ productId: "session.paseo" }));
+        setTruApiClient(client);
+        entries = [];
+        configure({ level: "warn", namespaces: [], handler: (entry) => entries.push(entry) });
+    });
+
+    afterEach(async () => {
+        for (const app of apps.splice(0)) await app.wallet.disconnect();
+        setTruApiClient(null);
+        vi.restoreAllMocks();
+    });
+
+    it("works with the public fake host without overriding protocol methods", async () => {
+        using host = createFakeHost();
+        const app = await createApp({ cloudStorage: false });
+        apps.push(app);
+        const { accounts } = await app.wallet.connect();
+        await app.localStorage.set("key", "value");
+        expect({
+            info: app.getAppInfo(),
+            accountCount: accounts.length,
+            stored: (await host.client.localStorage.read({ key: "fake-app:key" }))._unsafeUnwrap(),
+        }).toEqual({
+            info: { name: "fake-app", cloudStorage: false },
+            accountCount: 1,
+            stored: { value: "0x76616c7565" },
+        });
+    });
+
+    it.each([
+        ["my-app.dot", "my-app"],
+        ["session.paseo", "session"],
+        ["nested.app.dot", "nested.app"],
+        ["localhost", "localhost"],
+        ["localhost:3000", "localhost:3000"],
+        ["127.0.0.1", "127.0.0.1"],
+        ["127.0.0.1:3000", "127.0.0.1:3000"],
+        ["app.localhost", "app.localhost"],
+        ["app.localhost:3000", "app.localhost:3000"],
+    ])(
+        "keeps wallet identity %s while using %s for app info and storage",
+        async (productId, appName) => {
+            getProductContext.mockReturnValue(okAsync({ productId }));
+            const getAccount = vi.spyOn(client.account, "getAccount");
+            const write = vi.spyOn(client.localStorage, "write");
+            const app = await createApp({ cloudStorage: false });
+            apps.push(app);
+            const { accounts } = await app.wallet.connect();
+            await app.localStorage.set("key", "value");
+            const name: string = app.getAppInfo().name;
+
+            expect({
+                name,
+                accountCount: accounts.length,
+                accountRequests: getAccount.mock.calls,
+                storageWrite: write.mock.calls.at(-1),
+                stored: await app.localStorage.get("key"),
+            }).toEqual({
+                name: appName,
+                accountCount: 1,
+                accountRequests: [
+                    [
+                        {
+                            productAccountId: {
+                                dotNsIdentifier: productId,
+                                derivationIndex: { tag: "Index", value: 0 },
+                            },
+                        },
+                    ],
+                ],
+                storageWrite: [{ key: `${appName}:key`, value: "0x76616c7565" }],
+                stored: "value",
+            });
+        },
+    );
+
+    it("keeps existing bare-name storage readable and writes to the same prefix", async () => {
+        getProductContext.mockReturnValue(okAsync({ productId: "my-app.dot" }));
+        await client.localStorage.write({ key: "my-app:theme", value: "0x6461726b" });
+        const app = await createApp({ cloudStorage: false });
+        apps.push(app);
+        const previous = await app.localStorage.get("theme");
+        await app.localStorage.set("theme", "light");
+
+        expect({
+            previous,
+            current: (await client.localStorage.read({ key: "my-app:theme" }))._unsafeUnwrap(),
+            fullIdPrefix: (
+                await client.localStorage.read({ key: "my-app.dot:theme" })
+            )._unsafeUnwrap(),
+        }).toEqual({
+            previous: "dark",
+            current: { value: "0x6c69676874" },
+            fullIdPrefix: { value: undefined },
+        });
+    });
+
+    it("requests the host identity without configuration or a deprecation warning", async () => {
+        expectTypeOf({ children: null }).toMatchTypeOf<ProductSDKProviderProps>();
+        const error = { tag: "Unsupported" } as const;
+        getProductContext.mockReturnValue(errAsync(error));
+        await expect(createApp()).rejects.toMatchObject({
+            name: "HostCallFailedError",
+            cause: error,
+        });
+        expect(entries.filter((entry) => entry.namespace === "app")).toEqual([]);
+    });
+
+    it.each(["wrong-app", ""])("ignores and warns about the deprecated name %j", async (name) => {
+        const app = await createApp({ name, cloudStorage: false });
+        apps.push(app);
+        await app.localStorage.set("key", "retained");
+        const unnamed = await createApp({ cloudStorage: false });
+        apps.push(unnamed);
+        expect({
+            info: app.getAppInfo(),
+            storedWithoutName: await unnamed.localStorage.get("key"),
+            warnings: entries
+                .filter((entry) => entry.namespace === "app")
+                .map(({ level, message }) => ({ level, message })),
+        }).toEqual({
+            info: { name: "session", cloudStorage: false },
+            storedWithoutName: "retained",
+            warnings: [
+                {
+                    level: "warn",
+                    message:
+                        "createApp: name is deprecated and ignored. Remove the name option. The SDK resolves the app name from system.getProductContext(), dropping the product ID's final domain suffix (my-app.dot -> my-app). Local development IDs stay unchanged.",
+                },
+            ],
+        });
+    });
+
+    it("rejects unavailable hosts even when a deprecated name is supplied", async () => {
+        setTruApiClient(null);
+        await expect(createApp({ name: "fallback", cloudStorage: false })).rejects.toBeInstanceOf(
+            HostUnavailableError,
+        );
+    });
+
+    it("preserves a refused context instead of using the deprecated name", async () => {
+        const error = { tag: "Unsupported" } as const;
+        getProductContext.mockReturnValue(errAsync(error));
+        await expect(createApp({ name: "fallback", cloudStorage: false })).rejects.toMatchObject({
+            name: "HostCallFailedError",
+            message: "system.getProductContext: Unsupported",
+            payload: error,
+            cause: error,
+        });
+    });
+
+    it("preserves a context transport rejection", async () => {
+        const error = new Error("host connection closed");
+        getProductContext.mockImplementation(() =>
+            okAsync(undefined).map(() => {
+                throw error;
+            }),
+        );
+        await expect(createApp({ cloudStorage: false })).rejects.toBe(error);
+    });
+});

package/src/core/createApp.ts

@@ -34,7 +34,12 @@ import {
     destroyAll,
 } from "@parity/product-sdk-chain-client";
 import { accountIdBytes } from "@parity/product-sdk-address";
-import { getAccountsProvider } from "@parity/product-sdk-host";
+import {
+    getAccountsProvider,
+    getTruApi,
+    HostCallFailedError,
+    HostUnavailableError,
+} from "@parity/product-sdk-host";
 import {
     accountIdBytesToHex,
     type PeopleUsernameQueryApi,
@@ -55,19 +60,16 @@ const log = createLogger("app");
  *
  * // Default: cloud storage enabled with paseo environment
  * const app = await createApp({
- *   name: 'my-app',
  *   logLevel: 'info',
  * });
  *
  * // Custom cloud storage environment
  * const prodApp = await createApp({
- *   name: 'my-app',
  *   cloudStorage: { environment: 'polkadot' },
  * });
  *
  * // Disable cloud storage entirely
  * const noCloudStorageApp = await createApp({
- *   name: 'my-app',
  *   cloudStorage: false,
  * });
  *
@@ -83,20 +85,40 @@ const log = createLogger("app");
  * }
  * ```
  */
-export async function createApp(config: AppConfig): Promise<App> {
+export async function createApp(config: AppConfig = {}): Promise<App> {
     // Set log level if specified
     if (config.logLevel) {
         configure({ level: config.logLevel });
     }
 
-    log.info("Creating Product SDK app", { name: config.name });
+    if (config.name !== undefined) {
+        log.warn(
+            "createApp: name is deprecated and ignored. Remove the name option. The SDK resolves the app name from system.getProductContext(), dropping the product ID's final domain suffix (my-app.dot -> my-app). Local development IDs stay unchanged.",
+        );
+    }
+
+    const truApi = await getTruApi();
+    if (!truApi) {
+        throw new HostUnavailableError("createApp requires a host product context");
+    }
+    const { productId } = await truApi.system.getProductContext().match(
+        (context) => context,
+        (error) => {
+            throw new HostCallFailedError("system.getProductContext", error);
+        },
+    );
+
+    const isLocalHost = /^(?:localhost|127\.0\.0\.1|[^:]+\.localhost)(?::\d+)?$/i.test(productId);
+    const name = isLocalHost ? productId : productId.replace(/\.[^.]+$/, "");
+
+    log.info("Creating Product SDK app", { name });
 
     // Initialize storage (container-only - will throw if not in container)
-    const localKvStore = await createLocalKvStore({ prefix: config.name });
+    const localKvStore = await createLocalKvStore({ prefix: name });
 
     // Initialize signer manager
     const signerManager = new SignerManager({
-        dappName: config.name,
+        dappName: productId,
     });
 
     // Initialize cloud storage client (configurable, defaults to paseo).
@@ -197,7 +219,7 @@ export async function createApp(config: AppConfig): Promise<App> {
         : null;
 
     log.info("Product SDK app created", {
-        name: config.name,
+        name,
         cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : "disabled",
     });
 
@@ -206,7 +228,7 @@ export async function createApp(config: AppConfig): Promise<App> {
         localStorage: localStorageApi,
         chain: chainApi,
         cloudStorage: cloudStorageApi,
-        getAppInfo: () => ({ ...config }),
+        getAppInfo: () => ({ ...config, name }),
     };
 }
 

package/src/core/types.ts

@@ -25,8 +25,8 @@ export interface CloudStorageConfig {
 
 /** Configuration for createApp */
 export interface AppConfig {
-    /** Application name - used to derive product accounts and namespace storage */
-    name: string;
+    /** @deprecated Ignored with a warning. The host product ID supplies the app name. */
+    name?: string;
     /** Log level for SDK operations (default: 'info') */
     logLevel?: LogLevel;
     /**
@@ -37,6 +37,12 @@ export interface AppConfig {
     cloudStorage?: CloudStorageConfig | false;
 }
 
+/** App configuration with the identity resolved from the host. */
+export interface AppInfo extends Omit<AppConfig, "name"> {
+    /** App name and storage prefix, omitting the host ID's final domain suffix. Local host IDs stay unchanged. */
+    name: string;
+}
+
 /** Wallet API exposed by the SDK */
 export interface WalletApi {
     /** Connect to available wallet providers */
@@ -176,8 +182,8 @@ export interface App {
     chain: ChainApi;
     /** Cloud Storage operations (null if disabled via config) */
     cloudStorage: CloudStorageApi | null;
-    /** Get app configuration */
-    getAppInfo(): AppConfig;
+    /** Get app configuration with the host-derived name. */
+    getAppInfo(): AppInfo;
 }
 
 /** Account information */

package/src/index.ts

@@ -4,13 +4,13 @@
  * @parity/product-sdk
  *
  * Unified SDK for building products on the Polkadot ecosystem.
+ * App identity comes from the host and scopes wallet accounts and local storage.
  *
  * @example
  * ```ts
  * import { createApp } from '@parity/product-sdk';
  *
- * const app = createApp({
- *   name: 'my-app',
+ * const app = await createApp({
  *   logLevel: 'info',
  * });
  *
@@ -30,6 +30,7 @@ export { configure, createLogger } from "./core/logger.js";
 export type {
     App,
     AppConfig,
+    AppInfo,
     LogLevel,
     WalletApi,
     LocalStorageApi,

package/src/react/context.ts

@@ -28,7 +28,7 @@ export function useProductSDK(): App {
     if (!app) {
         throw new Error(
             "useProductSDK must be used within a ProductSDKProvider. " +
-                'Wrap your app with <ProductSDKProvider name="your-app">.',
+                "Wrap your app with <ProductSDKProvider>.",
         );
     }
     return app;

package/src/react/index.ts

@@ -12,7 +12,7 @@
  *
  * function App() {
  *   return (
- *     <ProductSDKProvider name="my-app">
+ *     <ProductSDKProvider>
  *       <MyApp />
  *     </ProductSDKProvider>
  *   );

package/src/react/provider.tsx

@@ -11,8 +11,8 @@ import type { App, LogLevel } from "../core/types.js";
 
 /** Props for ProductSDKProvider */
 export interface ProductSDKProviderProps {
-    /** Application name - used for storage namespacing and product account derivation */
-    name: string;
+    /** @deprecated Ignored with a warning. The host product ID supplies the app name. */
+    name?: string;
     /** Log level (default: 'info') */
     logLevel?: LogLevel;
     /** Child components */
@@ -30,7 +30,7 @@ export interface ProductSDKProviderProps {
  *
  * function App() {
  *   return (
- *     <ProductSDKProvider name="my-app" fallback={<Loading />}>
+ *     <ProductSDKProvider fallback={<Loading />}>
  *       <MyApp />
  *     </ProductSDKProvider>
  *   );

package/src/renderer/index.ts

@@ -0,0 +1,10 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Renderer trees — Pocket card faces and rendered chat bodies.
+ *
+ * Re-exports `@parity/product-sdk-renderer`.
+ *
+ * @module
+ */
+export * from "@parity/product-sdk-renderer";

package/dist/chunk-KXJT2BNL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/createApp.ts"],"names":["err"],"mappings":"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","file":"chunk-KXJT2BNL.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and cloud storage APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    ChainApi,\n    Account,\n    CloudStorageApi,\n    LocalStorageApi,\n} from \"./types.js\";\nimport { createLocalStorageApi } from \"./local-storage-api.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createLocalKvStore } from \"@parity/product-sdk-local-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport {\n    CloudStorageClient,\n    ProductCloudStorageError,\n    calculateCid,\n    createLazySigner,\n} from \"@parity/product-sdk-cloud-storage\";\nimport { err, ok } from \"@parity/result\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\nimport { accountIdBytes } from \"@parity/product-sdk-address\";\nimport { getAccountsProvider } from \"@parity/product-sdk-host\";\nimport {\n    accountIdBytesToHex,\n    type PeopleUsernameQueryApi,\n    resolvePeopleUsernameOwner,\n} from \"../identity/dotns.js\";\n\nconst log = createLogger(\"app\");\n\n/**\n * Create a new Product SDK app instance\n *\n * @param config - Application configuration\n * @returns App instance with all APIs\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * // Default: cloud storage enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom cloud storage environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: { environment: 'polkadot' },\n * });\n *\n * // Disable cloud storage entirely\n * const noCloudStorageApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.localStorage.set('key', 'value');\n *\n * // Use cloud storage (check for null if it might be disabled)\n * if (app.cloudStorage) {\n *   const cid = await app.cloudStorage.upload('hello world');\n * }\n * ```\n */\nexport async function createApp(config: AppConfig): Promise<App> {\n    // Set log level if specified\n    if (config.logLevel) {\n        configure({ level: config.logLevel });\n    }\n\n    log.info(\"Creating Product SDK app\", { name: config.name });\n\n    // Initialize storage (container-only - will throw if not in container)\n    const localKvStore = await createLocalKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize cloud storage client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the cloud storage client can be built before\n    // an account is selected. Uploads will throw a clear error if no signer\n    // is available at submission time. Reads (fetch / fetchJson) don't need\n    // a signer, so they work regardless of whether an account is selected --\n    // but they are container-only and throw CloudStorageHostUnavailableError\n    // outside a host container (no IPFS-gateway fallback).\n    const cloudStorageEnabled = config.cloudStorage !== false;\n    const cloudStorageEnvironment =\n        typeof config.cloudStorage === \"object\" ? config.cloudStorage.environment : \"paseo\";\n    const cloudStorageClient = cloudStorageEnabled\n        ? await CloudStorageClient.create({\n              environment: cloudStorageEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (cloudStorageEnabled) {\n        log.debug(\"Cloud Storage client (Bulletin) initialized\", {\n            environment: cloudStorageEnvironment,\n        });\n    } else {\n        log.debug(\"Cloud Storage client disabled\");\n    }\n\n    // Storage API adapter — shared with `createFakeApp` so the two cannot drift.\n    const localStorageApi: LocalStorageApi = createLocalStorageApi(localKvStore);\n\n    // Create wallet API adapter\n    const walletApi = createWalletApi(signerManager);\n\n    // Create chain API\n    const chainApi: ChainApi = {\n        getClient(descriptor) {\n            log.debug(\"getClient called\", { genesis: descriptor.genesis });\n            const client = getClient(descriptor);\n            return client.getTypedApi(descriptor);\n        },\n\n        getRawClient(descriptor) {\n            log.debug(\"getRawClient called\", { genesis: descriptor.genesis });\n            return getClient(descriptor);\n        },\n\n        async connect<T extends Record<string, ChainDefinition>>(chains: T) {\n            log.debug(\"connect called\", { chains: Object.keys(chains) });\n            return createChainClient({ chains });\n        },\n\n        isConnected(descriptor) {\n            return isConnected(descriptor);\n        },\n\n        destroyAll() {\n            log.debug(\"destroyAll called\");\n            destroyAll();\n        },\n    };\n\n    // Create Cloud Storage API adapter (null if disabled)\n    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  try {\n                      // Explicitly request a DAG-PB manifest so chunked uploads always\n                      // resolve to a single root CID. Without this, AsyncBulletinClient\n                      // can return `result.cid: undefined` for chunked-without-manifest\n                      // uploads — but app consumers expect a CID they can hand to\n                      // `fetch(cid)`, so treat a missing CID as an error.\n                      const uploaded = await cloudStorageClient\n                          .store(bytes)\n                          .withManifest(true)\n                          .send();\n                      if (!uploaded.cid) {\n                          return err(\n                              new ProductCloudStorageError(\n                                  \"Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                              ),\n                          );\n                      }\n                      return ok(uploaded.cid.toString());\n                  } catch (cause) {\n                      const message = cause instanceof Error ? cause.message : String(cause);\n                      return err(new ProductCloudStorageError(message, { cause }));\n                  }\n              },\n              fetch: (cid) => cloudStorageClient.fetchBytes(cid),\n              computeCid: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  const cid = await calculateCid(bytes);\n                  return cid.toString();\n              },\n          }\n        : null;\n\n    log.info(\"Product SDK app created\", {\n        name: config.name,\n        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        localStorage: localStorageApi,\n        chain: chainApi,\n        cloudStorage: cloudStorageApi,\n        getAppInfo: () => ({ ...config }),\n    };\n}\n\n/**\n * Create wallet API adapter using SignerManager from leaf package\n */\nfunction createWalletApi(signerManager: SignerManager): WalletApi {\n    // Track account change subscribers\n    const accountChangeSubscribers = new Set<(account: Account | null) => void>();\n\n    // Subscribe to signer manager state changes\n    signerManager.subscribe((state) => {\n        const account = state.selectedAccount\n            ? {\n                  address: state.selectedAccount.address,\n                  name: state.selectedAccount.name ?? undefined,\n                  source: state.selectedAccount.source,\n              }\n            : null;\n        for (const callback of accountChangeSubscribers) {\n            try {\n                callback(account);\n            } catch (e) {\n                log.warn(\"Account change callback threw\", { error: e });\n            }\n        }\n    });\n\n    return {\n        async connect(): Promise<{ accounts: Account[] }> {\n            const result = await signerManager.connect();\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return {\n                accounts: result.value.map((a) => ({\n                    address: a.address,\n                    name: a.name ?? undefined,\n                    source: a.source,\n                })),\n            };\n        },\n\n        async disconnect(): Promise<void> {\n            signerManager.disconnect();\n        },\n\n        getAccounts(): Account[] {\n            return signerManager.getState().accounts.map((a) => ({\n                address: a.address,\n                name: a.name ?? undefined,\n                source: a.source,\n            }));\n        },\n\n        getSelectedAccount(): Account | null {\n            const selected = signerManager.getState().selectedAccount;\n            if (!selected) return null;\n            return {\n                address: selected.address,\n                name: selected.name ?? undefined,\n                source: selected.source,\n            };\n        },\n\n        selectAccount(address: string): void {\n            signerManager.selectAccount(address);\n        },\n\n        async signMessage(message: string | Uint8Array): Promise<Uint8Array> {\n            const bytes = typeof message === \"string\" ? new TextEncoder().encode(message) : message;\n            const result = await signerManager.signRaw(bytes);\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return result.value;\n        },\n\n        async signMessageWithDotNsIdentity(args) {\n            const message =\n                typeof args.message === \"string\"\n                    ? new TextEncoder().encode(args.message)\n                    : args.message;\n            const accountsProvider = await getHostAccountsProvider();\n            const username = args.username ?? (await getPrimaryUsername(accountsProvider));\n\n            // Reuse an already-connected People chain when the caller has\n            // wired one up via `app.chain.connect({ ..., <name>: peopleChain })`.\n            // Fall back to opening a transient connection so first-time users\n            // don't have to think about chain lifecycles. The chain-client\n            // module caches by genesis fingerprint, so subsequent\n            // signMessageWithDotNsIdentity calls share whichever connection\n            // got established first.\n            const peopleClient = isConnected(args.peopleChain)\n                ? getClient(args.peopleChain)\n                : await createChainClient({ chains: { people: args.peopleChain } }).then(\n                      (c) => c.raw.people,\n                  );\n            // PAPI's `TypedApi.query.X.Y.getValue` is variadic\n            // (`...args: [...WithCallOptions<Args>]`) so it's not assignable\n            // to our deliberately-narrow `(key) => Promise<...>` shape. The\n            // resolver only ever passes the storage key; the cast adapts the\n            // wider PAPI surface to the minimum we depend on.\n            const peopleApi = peopleClient.getTypedApi(\n                args.peopleChain,\n            ) as unknown as PeopleUsernameQueryApi;\n            const owner = await resolvePeopleUsernameOwner(username, peopleApi);\n            if (!owner) {\n                throw new Error(`No account owns DotNS username \"${username}\"`);\n            }\n\n            const publicKey = accountIdBytes(owner);\n            // This field is hex, not the SS58 the resolver now returns. Converted\n            // here and not in the try, so an address failure is not reported as a\n            // signing failure.\n            const accountId = accountIdBytesToHex(publicKey);\n            const signer = accountsProvider.getLegacyAccountSigner({ publicKey, name: username });\n\n            try {\n                return {\n                    username,\n                    accountId,\n                    signature: await signer.signBytes(message),\n                };\n            } catch (cause) {\n                throw new Error(\n                    `Failed to sign with DotNS username \"${username}\": ${\n                        cause instanceof Error ? cause.message : String(cause)\n                    }`,\n                    { cause },\n                );\n            }\n        },\n\n        onAccountChange(callback: (account: Account | null) => void): () => void {\n            accountChangeSubscribers.add(callback);\n            return () => accountChangeSubscribers.delete(callback);\n        },\n\n        getProductAccount(): Account | null {\n            // Product accounts require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccount() directly\n            log.warn(\n                \"getProductAccount() is deprecated - use SignerManager.getProductAccount() directly\",\n            );\n            return null;\n        },\n\n        getAnonymousAlias(): string | null {\n            // Anonymous aliases require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccountAlias() directly\n            log.warn(\n                \"getAnonymousAlias() is deprecated - use SignerManager.getProductAccountAlias() directly\",\n            );\n            return null;\n        },\n\n        async createProof(_message: Uint8Array): Promise<Uint8Array> {\n            // Ring VRF proofs require SignerManager.createRingVRFProof() directly\n            throw new Error(\n                \"createProof() is not implemented in the App API. \" +\n                    \"Use SignerManager.createRingVRFProof() directly.\",\n            );\n        },\n    };\n}\n\ntype HostAccountsProvider = NonNullable<Awaited<ReturnType<typeof getAccountsProvider>>>;\n\nasync function getHostAccountsProvider(): Promise<HostAccountsProvider> {\n    const provider = await getAccountsProvider();\n    if (!provider) {\n        throw new Error(\"Host accounts provider is not available\");\n    }\n    return provider;\n}\n\nasync function getPrimaryUsername(accountsProvider: HostAccountsProvider): Promise<string> {\n    const result = await accountsProvider.getUserId().match(\n        (value) => value,\n        (err) => {\n            throw err;\n        },\n    );\n    const username = result.primaryUsername.trim();\n    if (!username) {\n        throw new Error(\"Host identity did not provide a primary DotNS username\");\n    }\n    return username;\n}\n"]}