@parity/product-sdk 0.5.0 → 0.7.0

package/src/identity/product-account.ts

@@ -1,56 +1,60 @@
 /**
- * Product account derivation
+ * Context alias derivation
  *
- * Derives product-scoped accounts from a parent account
+ * Derives a deterministic, context-bound alias from a parent account using blake2b-256.
+ *
+ * NOTE: this is NOT the canonical sr25519 product-account derivation used by
+ * mobile, desktop, and dotli hosts. For that, use
+ * `@parity/product-sdk-keys::deriveProductAccountPublicKey`.
  */
 
 import { createLogger } from "@parity/product-sdk-logger";
 import { blake2b256 } from "@parity/product-sdk-crypto";
 import { ss58Encode, ss58Decode, deriveH160 } from "@parity/product-sdk-address";
-import type { ProductAccountInfo, AnonymousAliasInfo, RingLocation } from "./types.js";
+import type { ContextAliasInfo, AnonymousAliasInfo, RingLocation } from "./types.js";
 
 const log = createLogger("identity");
 
 /**
- * Derive a product-scoped account from a parent account
+ * Derive a context-bound alias from a parent account.
  *
- * The product account is deterministically derived using:
- * productPublicKey = hash(parentPublicKey || productName)
+ * The alias is deterministically derived using:
+ * aliasPublicKey = blake2b256(parentPublicKey || context)
  *
  * @param parentAddress - Parent account SS58 address
- * @param productName - Product name for derivation
+ * @param context - Context string for derivation (e.g. an app id or scope label)
  * @param ss58Prefix - SS58 prefix (default: 42)
- * @returns Product account info
+ * @returns Context alias info
  *
  * @example
  * ```ts
- * const productAccount = deriveProductAccount(
+ * const alias = deriveContextAlias(
  *   '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
- *   'my-app'
+ *   'voting-round-1'
  * );
- * console.log('Product address:', productAccount.address);
+ * console.log('Alias address:', alias.address);
  * ```
  */
-export function deriveProductAccount(
+export function deriveContextAlias(
     parentAddress: string,
-    productName: string,
+    context: string,
     ss58Prefix = 42,
-): ProductAccountInfo {
+): ContextAliasInfo {
     const { publicKey: parentPublicKey } = ss58Decode(parentAddress);
 
-    // Derive product public key: blake2b-256(parentPublicKey || productName)
-    const productNameBytes = new TextEncoder().encode(productName);
-    const combined = new Uint8Array(parentPublicKey.length + productNameBytes.length);
+    // Derive alias public key: blake2b-256(parentPublicKey || context)
+    const contextBytes = new TextEncoder().encode(context);
+    const combined = new Uint8Array(parentPublicKey.length + contextBytes.length);
     combined.set(parentPublicKey, 0);
-    combined.set(productNameBytes, parentPublicKey.length);
+    combined.set(contextBytes, parentPublicKey.length);
 
-    const productPublicKey = blake2b256(combined);
-    const address = ss58Encode(productPublicKey, ss58Prefix);
-    const h160Address = deriveH160(productPublicKey);
+    const aliasPublicKey = blake2b256(combined);
+    const address = ss58Encode(aliasPublicKey, ss58Prefix);
+    const h160Address = deriveH160(aliasPublicKey);
 
-    log.debug("Derived product account", {
+    log.debug("Derived context alias", {
         parentAddress,
-        productName,
+        context,
         address,
     });
 
@@ -58,32 +62,32 @@ export function deriveProductAccount(
         address,
         h160Address,
         parentAddress,
-        productName,
+        context,
     };
 }
 
 /**
- * Verify that a product account was derived from a parent account
+ * Verify that a context alias was derived from a parent account.
  *
- * @param productAddress - Product account address
+ * @param aliasAddress - Context alias SS58 address
  * @param parentAddress - Claimed parent address
- * @param productName - Product name
+ * @param context - Context string used for derivation
  * @returns True if derivation is valid
  */
-export function verifyProductAccount(
-    productAddress: string,
+export function verifyContextAlias(
+    aliasAddress: string,
     parentAddress: string,
-    productName: string,
+    context: string,
 ): boolean {
     try {
-        const derived = deriveProductAccount(parentAddress, productName);
-        const { publicKey: productKey } = ss58Decode(productAddress);
+        const derived = deriveContextAlias(parentAddress, context);
+        const { publicKey: aliasKey } = ss58Decode(aliasAddress);
         const { publicKey: derivedKey } = ss58Decode(derived.address);
 
         // Compare public keys
-        if (productKey.length !== derivedKey.length) return false;
-        for (let i = 0; i < productKey.length; i++) {
-            if (productKey[i] !== derivedKey[i]) return false;
+        if (aliasKey.length !== derivedKey.length) return false;
+        for (let i = 0; i < aliasKey.length; i++) {
+            if (aliasKey[i] !== derivedKey[i]) return false;
         }
         return true;
     } catch {

package/src/identity/types.ts

@@ -1,7 +1,7 @@
 /**
  * Identity module types
  *
- * Types for DotNS name resolution and product account derivation
+ * Types for DotNS name resolution and context-alias derivation
  */
 
 /** DotNS name resolution result */
@@ -16,16 +16,16 @@ export interface DotNsRecord {
     expiresAt?: number;
 }
 
-/** Product account info */
-export interface ProductAccountInfo {
-    /** Product-scoped SS58 address */
+/** Context alias info: a deterministic, context-bound alias derived from a parent account */
+export interface ContextAliasInfo {
+    /** Alias SS58 address */
     address: string;
     /** H160 EVM address */
     h160Address: `0x${string}`;
     /** Parent account address */
     parentAddress: string;
-    /** Product name used for derivation */
-    productName: string;
+    /** Context string used for derivation */
+    context: string;
 }
 
 /** Ring VRF alias info */

package/src/index.ts

@@ -16,7 +16,7 @@
  * const { accounts } = await app.wallet.connect();
  *
  * // Use storage
- * await app.storage.set('key', 'value');
+ * await app.localStorage.set('key', 'value');
  * ```
  *
  * @packageDocumentation
@@ -30,9 +30,9 @@ export type {
     AppConfig,
     LogLevel,
     WalletApi,
-    StorageApi,
+    LocalStorageApi,
     ChainApi,
-    BulletinApi,
+    CloudStorageApi,
     Account,
     ChainClient,
     ChainDefinition,
@@ -45,5 +45,5 @@ export type { LogEntry, LogHandler, LoggerConfig, Logger } from "./core/logger.j
 export { isInsideContainer, isInsideContainerSync } from "@parity/product-sdk-host";
 export { createChainClient } from "@parity/product-sdk-chain-client";
 export { SignerManager } from "@parity/product-sdk-signer";
-export { createKvStore } from "@parity/product-sdk-storage";
-export { BulletinClient, calculateCid } from "@parity/product-sdk-bulletin";
+export { createLocalKvStore } from "@parity/product-sdk-local-storage";
+export { CloudStorageClient, calculateCid } from "@parity/product-sdk-cloud-storage";

package/src/local-storage/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @parity/product-sdk/local-storage
+ *
+ * Re-exports from @parity/product-sdk-local-storage.
+ */
+export * from "@parity/product-sdk-local-storage";

package/src/react/context.ts

@@ -17,7 +17,7 @@ export const ProductSDKContext = createContext<App | null>(null);
  * ```tsx
  * function MyComponent() {
  *   const app = useProductSDK();
- *   // Use app.wallet, app.storage, etc.
+ *   // Use app.wallet, app.localStorage, etc.
  * }
  * ```
  */

package/src/react/index.ts

@@ -6,7 +6,7 @@
  *
  * @example
  * ```tsx
- * import { ProductSDKProvider, useWallet, useStorage } from '@parity/product-sdk/react';
+ * import { ProductSDKProvider, useWallet, useLocalStorage } from '@parity/product-sdk/react';
  *
  * function App() {
  *   return (
@@ -18,7 +18,7 @@
  *
  * function MyApp() {
  *   const { isConnected, connect, accounts } = useWallet();
- *   const [theme, setTheme] = useStorage('theme', 'light');
+ *   const [theme, setTheme] = useLocalStorage('theme', 'light');
  *
  *   // ...
  * }
@@ -36,6 +36,6 @@ export { ProductSDKContext, useProductSDK } from "./context.js";
 export { useWallet } from "./useWallet.js";
 export type { UseWalletState, UseWalletActions, UseWalletReturn } from "./useWallet.js";
 
-export { useStorage, useStorageString } from "./useStorage.js";
+export { useLocalStorage, useLocalStorageString } from "./useLocalStorage.js";
 
 export { useChain } from "./useChain.js";

package/src/react/{useStorage.ts → useLocalStorage.ts}

@@ -1,5 +1,5 @@
 /**
- * useStorage hook
+ * useLocalStorage hook
  */
 
 import { useState, useEffect, useCallback } from "react";
@@ -14,7 +14,7 @@ import { useProductSDK } from "./context.js";
  * @example
  * ```tsx
  * function ThemeToggle() {
- *   const [theme, setTheme, { loading }] = useStorage('theme', 'light');
+ *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');
  *
  *   if (loading) return <div>Loading...</div>;
  *
@@ -26,7 +26,7 @@ import { useProductSDK } from "./context.js";
  * }
  * ```
  */
-export function useStorage<T = string>(
+export function useLocalStorage<T = string>(
     key: string,
     defaultValue?: T,
 ): [T | null, (value: T) => Promise<void>, { loading: boolean; error: Error | null }] {
@@ -43,7 +43,7 @@ export function useStorage<T = string>(
         const loadValue = async () => {
             try {
                 setLoading(true);
-                const stored = await app.storage.getJSON<T>(key);
+                const stored = await app.localStorage.getJSON<T>(key);
                 if (mounted) {
                     setValue(stored ?? defaultValue ?? null);
                     setLoading(false);
@@ -67,7 +67,7 @@ export function useStorage<T = string>(
         async (newValue: T) => {
             try {
                 setError(null);
-                await app.storage.setJSON(key, newValue);
+                await app.localStorage.setJSON(key, newValue);
                 setValue(newValue);
             } catch (e) {
                 setError(e instanceof Error ? e : new Error(String(e)));
@@ -86,7 +86,7 @@ export function useStorage<T = string>(
  * @param key - Storage key
  * @param defaultValue - Default value
  */
-export function useStorageString(
+export function useLocalStorageString(
     key: string,
     defaultValue?: string,
 ): [string | null, (value: string) => Promise<void>, { loading: boolean }] {
@@ -99,7 +99,7 @@ export function useStorageString(
         let mounted = true;
 
         const loadValue = async () => {
-            const stored = await app.storage.get(key);
+            const stored = await app.localStorage.get(key);
             if (mounted) {
                 setValue(stored ?? defaultValue ?? null);
                 setLoading(false);
@@ -115,7 +115,7 @@ export function useStorageString(
 
     const setStoredValue = useCallback(
         async (newValue: string) => {
-            await app.storage.set(key, newValue);
+            await app.localStorage.set(key, newValue);
             setValue(newValue);
         },
         [app, key],

package/dist/bulletin/index.d.ts

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

package/dist/bulletin/index.js

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

package/dist/chunk-6W3TCR3W.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/createApp.ts"],"names":[],"mappings":"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","file":"chunk-6W3TCR3W.js","sourcesContent":["/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and bulletin APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    StorageApi,\n    ChainApi,\n    BulletinApi,\n    Account,\n} from \"./types.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createKvStore } from \"@parity/product-sdk-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport { BulletinClient, calculateCid, createLazySigner } from \"@parity/product-sdk-bulletin\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\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: bulletin enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom bulletin environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   bulletin: { environment: 'polkadot' },\n * });\n *\n * // Disable bulletin entirely\n * const noBulletinApp = await createApp({\n *   name: 'my-app',\n *   bulletin: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.storage.set('key', 'value');\n *\n * // Use bulletin (check for null if it might be disabled)\n * if (app.bulletin) {\n *   const cid = await app.bulletin.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 kvStore = await createKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize bulletin client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the bulletin 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 and work regardless.\n    const bulletinEnabled = config.bulletin !== false;\n    const bulletinEnvironment =\n        typeof config.bulletin === \"object\" ? config.bulletin.environment : \"paseo\";\n    const bulletinClient = bulletinEnabled\n        ? await BulletinClient.create({\n              environment: bulletinEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (bulletinEnabled) {\n        log.debug(\"Bulletin client initialized\", { environment: bulletinEnvironment });\n    } else {\n        log.debug(\"Bulletin client disabled\");\n    }\n\n    // Create storage API adapter\n    const storageApi: StorageApi = {\n        get: (key) => kvStore.get(key),\n        set: (key, value) => kvStore.set(key, value),\n        getJSON: <T>(key: string) => kvStore.getJSON<T>(key),\n        setJSON: <T>(key: string, value: T) => kvStore.setJSON(key, value),\n        remove: (key) => kvStore.remove(key),\n        clear: async () => {\n            // KvStore doesn't have clear - this is a no-op\n            log.debug(\"clear() is not supported in container storage mode\");\n        },\n    };\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            // Build empty rpcs object (required by API but unused - host routes connections)\n            const rpcs = Object.fromEntries(\n                Object.keys(chains).map((k) => [k, [] as readonly string[]]),\n            ) as { [K in keyof T]: readonly string[] };\n            return createChainClient({ chains, rpcs });\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 bulletin API adapter (null if disabled)\n    const bulletinApi: BulletinApi | null = bulletinClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\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 BulletinApi.upload promises a string return, and\n                  // app consumers expect a CID they can hand to `fetch(cid)`. Keep\n                  // the defensive null-check below as belt-and-braces in case the\n                  // upstream contract shifts.\n                  const result = await bulletinClient.store(bytes).withManifest(true).send();\n                  if (!result.cid) {\n                      throw new Error(\n                          \"Bulletin upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                      );\n                  }\n                  return result.cid.toString();\n              },\n              fetch: (cid) => bulletinClient.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        bulletin: bulletinEnabled ? bulletinEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        storage: storageApi,\n        chain: chainApi,\n        bulletin: bulletinApi,\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        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"]}

package/dist/storage/index.d.ts

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

package/dist/storage/index.js

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

package/src/bulletin/index.ts

@@ -1,6 +0,0 @@
-/**
- * @parity/product-sdk/bulletin
- *
- * Re-exports from @parity/product-sdk-bulletin.
- */
-export * from "@parity/product-sdk-bulletin";

package/src/storage/index.ts

@@ -1,6 +0,0 @@
-/**
- * @parity/product-sdk/storage
- *
- * Re-exports from @parity/product-sdk-storage.
- */
-export * from "@parity/product-sdk-storage";