@parity/product-sdk 0.1.0

package/dist/identity/index.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Identity module types
+ *
+ * Types for DotNS name resolution and product account derivation
+ */
+/** DotNS name resolution result */
+interface DotNsRecord {
+    /** Resolved SS58 address */
+    address: string;
+    /** Name that was resolved */
+    name: string;
+    /** Owner address */
+    owner: string;
+    /** Expiration timestamp (if applicable) */
+    expiresAt?: number;
+}
+/** Product account info */
+interface ProductAccountInfo {
+    /** Product-scoped SS58 address */
+    address: string;
+    /** H160 EVM address */
+    h160Address: `0x${string}`;
+    /** Parent account address */
+    parentAddress: string;
+    /** Product name used for derivation */
+    productName: string;
+}
+/** Ring VRF alias info */
+interface AnonymousAliasInfo {
+    /** Anonymous alias identifier */
+    alias: string;
+    /** Ring location for proof generation */
+    ringLocation: RingLocation;
+    /** Context used for alias derivation */
+    context: string;
+}
+/** Ring location for VRF proofs */
+interface RingLocation {
+    /** Ring index */
+    ringIndex: number;
+    /** Member index within ring */
+    memberIndex: number;
+}
+/** Identity verification result */
+interface VerificationResult {
+    /** Whether identity is verified */
+    verified: boolean;
+    /** Verification method used */
+    method: "on-chain" | "judgement" | "social";
+    /** Verification details */
+    details?: Record<string, unknown>;
+}
+/** On-chain identity info */
+interface OnChainIdentity {
+    /** Display name */
+    display?: string;
+    /** Legal name */
+    legal?: string;
+    /** Web URL */
+    web?: string;
+    /** Email */
+    email?: string;
+    /** Twitter handle */
+    twitter?: string;
+    /** Riot/Matrix handle */
+    riot?: string;
+    /** Additional fields */
+    additional: Array<[string, string]>;
+}
+
+/**
+ * DotNS (Polkadot Name Service) utilities
+ *
+ * Provides name resolution for .dot domains
+ */
+
+/**
+ * Check if a string is a valid DotNS name
+ *
+ * @param name - Name to validate
+ * @returns True if valid DotNS name
+ */
+declare function isValidDotNsName(name: string): boolean;
+/**
+ * Normalize a DotNS name (lowercase, trim whitespace)
+ *
+ * @param name - Name to normalize
+ * @returns Normalized name
+ */
+declare function normalizeDotNsName(name: string): string;
+/**
+ * Resolve a DotNS name to an address
+ *
+ * @param name - DotNS name (e.g., "alice.dot")
+ * @returns Resolved record or null if not found
+ *
+ * @example
+ * ```ts
+ * const record = await resolveDotNs('alice.dot');
+ * if (record) {
+ *   console.log('Address:', record.address);
+ * }
+ * ```
+ */
+declare function resolveDotNs(name: string): Promise<DotNsRecord | null>;
+/**
+ * Reverse resolve an address to a DotNS name
+ *
+ * @param address - SS58 address
+ * @returns Primary name or null if none set
+ */
+declare function reverseDotNs(address: string): Promise<string | null>;
+/**
+ * Check if a DotNS name is available for registration
+ *
+ * @param name - Name to check
+ * @returns True if available
+ */
+declare function isDotNsAvailable(name: string): Promise<boolean>;
+
+/**
+ * Product account derivation
+ *
+ * Derives product-scoped accounts from a parent account
+ */
+
+/**
+ * Derive a product-scoped account from a parent account
+ *
+ * The product account is deterministically derived using:
+ * productPublicKey = hash(parentPublicKey || productName)
+ *
+ * @param parentAddress - Parent account SS58 address
+ * @param productName - Product name for derivation
+ * @param ss58Prefix - SS58 prefix (default: 42)
+ * @returns Product account info
+ *
+ * @example
+ * ```ts
+ * const productAccount = deriveProductAccount(
+ *   '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
+ *   'my-app'
+ * );
+ * console.log('Product address:', productAccount.address);
+ * ```
+ */
+declare function deriveProductAccount(parentAddress: string, productName: string, ss58Prefix?: number): ProductAccountInfo;
+/**
+ * Verify that a product account was derived from a parent account
+ *
+ * @param productAddress - Product account address
+ * @param parentAddress - Claimed parent address
+ * @param productName - Product name
+ * @returns True if derivation is valid
+ */
+declare function verifyProductAccount(productAddress: string, parentAddress: string, productName: string): boolean;
+/**
+ * Derive an anonymous alias using Ring VRF
+ *
+ * This creates a context-specific alias that cannot be linked
+ * back to the original identity without the ring proof.
+ *
+ * @param context - Context for alias derivation (e.g., "voting-round-1")
+ * @param ringLocation - Ring location for proof generation
+ * @returns Anonymous alias info
+ */
+declare function deriveAnonymousAlias(context: string, ringLocation: RingLocation): AnonymousAliasInfo;
+/**
+ * Create a Ring VRF proof for a message
+ *
+ * @param message - Message to prove
+ * @param ringLocation - Ring location
+ * @returns Proof bytes
+ */
+declare function createRingProof(message: Uint8Array, ringLocation: RingLocation): Promise<Uint8Array>;
+/**
+ * Verify a Ring VRF proof
+ *
+ * @param message - Original message
+ * @param proof - Proof bytes
+ * @param alias - Expected alias
+ * @returns True if proof is valid
+ */
+declare function verifyRingProof(message: Uint8Array, proof: Uint8Array, alias: string): Promise<boolean>;
+
+export { type AnonymousAliasInfo, type DotNsRecord, type OnChainIdentity, type ProductAccountInfo, type RingLocation, type VerificationResult, createRingProof, deriveAnonymousAlias, deriveProductAccount, isDotNsAvailable, isValidDotNsName, normalizeDotNsName, resolveDotNs, reverseDotNs, verifyProductAccount, verifyRingProof };

package/dist/identity/index.js

@@ -0,0 +1,109 @@
+// src/identity/dotns.ts
+import { createLogger } from "@parity/product-sdk-logger";
+var log = createLogger("identity");
+function isValidDotNsName(name) {
+  if (!name.endsWith(".dot")) return false;
+  const label = name.slice(0, -4);
+  if (label.length < 3 || label.length > 63) return false;
+  return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(label);
+}
+function normalizeDotNsName(name) {
+  let normalized = name.toLowerCase().trim();
+  if (!normalized.endsWith(".dot")) {
+    normalized += ".dot";
+  }
+  return normalized;
+}
+async function resolveDotNs(name) {
+  const normalized = normalizeDotNsName(name);
+  if (!isValidDotNsName(normalized)) {
+    log.warn("Invalid DotNS name", { name });
+    return null;
+  }
+  log.debug("Resolving DotNS name", { name: normalized });
+  throw new Error(
+    "resolveDotNs() is not yet implemented. This is a skeleton for the Product SDK structure."
+  );
+}
+async function reverseDotNs(address) {
+  log.debug("Reverse resolving address", { address });
+  throw new Error(
+    "reverseDotNs() is not yet implemented. This is a skeleton for the Product SDK structure."
+  );
+}
+async function isDotNsAvailable(name) {
+  const record = await resolveDotNs(name).catch(() => null);
+  return record === null;
+}
+
+// src/identity/product-account.ts
+import { createLogger as createLogger2 } from "@parity/product-sdk-logger";
+import { blake2b256 } from "@parity/product-sdk-crypto";
+import { ss58Encode, ss58Decode, deriveH160 } from "@parity/product-sdk-address";
+var log2 = createLogger2("identity");
+function deriveProductAccount(parentAddress, productName, ss58Prefix = 42) {
+  const { publicKey: parentPublicKey } = ss58Decode(parentAddress);
+  const productNameBytes = new TextEncoder().encode(productName);
+  const combined = new Uint8Array(parentPublicKey.length + productNameBytes.length);
+  combined.set(parentPublicKey, 0);
+  combined.set(productNameBytes, parentPublicKey.length);
+  const productPublicKey = blake2b256(combined);
+  const address = ss58Encode(productPublicKey, ss58Prefix);
+  const h160Address = deriveH160(productPublicKey);
+  log2.debug("Derived product account", {
+    parentAddress,
+    productName,
+    address
+  });
+  return {
+    address,
+    h160Address,
+    parentAddress,
+    productName
+  };
+}
+function verifyProductAccount(productAddress, parentAddress, productName) {
+  try {
+    const derived = deriveProductAccount(parentAddress, productName);
+    const { publicKey: productKey } = ss58Decode(productAddress);
+    const { publicKey: derivedKey } = ss58Decode(derived.address);
+    if (productKey.length !== derivedKey.length) return false;
+    for (let i = 0; i < productKey.length; i++) {
+      if (productKey[i] !== derivedKey[i]) return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function deriveAnonymousAlias(context, ringLocation) {
+  log2.debug("Deriving anonymous alias", { context, ringLocation });
+  throw new Error(
+    "deriveAnonymousAlias() is not yet implemented. This requires container mode with Ring VRF support."
+  );
+}
+async function createRingProof(message, ringLocation) {
+  log2.debug("Creating ring proof", { ringLocation });
+  throw new Error(
+    "createRingProof() is not yet implemented. This requires container mode with Ring VRF support."
+  );
+}
+async function verifyRingProof(message, proof, alias) {
+  log2.debug("Verifying ring proof");
+  throw new Error(
+    "verifyRingProof() is not yet implemented. This requires container mode with Ring VRF support."
+  );
+}
+export {
+  createRingProof,
+  deriveAnonymousAlias,
+  deriveProductAccount,
+  isDotNsAvailable,
+  isValidDotNsName,
+  normalizeDotNsName,
+  resolveDotNs,
+  reverseDotNs,
+  verifyProductAccount,
+  verifyRingProof
+};
+//# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/identity/dotns.ts","../../src/identity/product-account.ts"],"sourcesContent":["/**\n * DotNS (Polkadot Name Service) utilities\n *\n * Provides name resolution for .dot domains\n */\n\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport type { DotNsRecord } from \"./types.js\";\n\nconst log = createLogger(\"identity\");\n\n/**\n * Check if a string is a valid DotNS name\n *\n * @param name - Name to validate\n * @returns True if valid DotNS name\n */\nexport function isValidDotNsName(name: string): boolean {\n    // Basic validation: alphanumeric, hyphens, ends with .dot\n    if (!name.endsWith(\".dot\")) return false;\n    const label = name.slice(0, -4);\n    if (label.length < 3 || label.length > 63) return false;\n    return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(label);\n}\n\n/**\n * Normalize a DotNS name (lowercase, trim whitespace)\n *\n * @param name - Name to normalize\n * @returns Normalized name\n */\nexport function normalizeDotNsName(name: string): string {\n    let normalized = name.toLowerCase().trim();\n    if (!normalized.endsWith(\".dot\")) {\n        normalized += \".dot\";\n    }\n    return normalized;\n}\n\n/**\n * Resolve a DotNS name to an address\n *\n * @param name - DotNS name (e.g., \"alice.dot\")\n * @returns Resolved record or null if not found\n *\n * @example\n * ```ts\n * const record = await resolveDotNs('alice.dot');\n * if (record) {\n *   console.log('Address:', record.address);\n * }\n * ```\n */\nexport async function resolveDotNs(name: string): Promise<DotNsRecord | null> {\n    const normalized = normalizeDotNsName(name);\n\n    if (!isValidDotNsName(normalized)) {\n        log.warn(\"Invalid DotNS name\", { name });\n        return null;\n    }\n\n    log.debug(\"Resolving DotNS name\", { name: normalized });\n\n    // TODO: Implement via PAPI query to DotNS pallet\n    throw new Error(\n        \"resolveDotNs() is not yet implemented. \" +\n            \"This is a skeleton for the Product SDK structure.\",\n    );\n}\n\n/**\n * Reverse resolve an address to a DotNS name\n *\n * @param address - SS58 address\n * @returns Primary name or null if none set\n */\nexport async function reverseDotNs(address: string): Promise<string | null> {\n    log.debug(\"Reverse resolving address\", { address });\n\n    // TODO: Implement via PAPI query to DotNS pallet\n    throw new Error(\n        \"reverseDotNs() is not yet implemented. \" +\n            \"This is a skeleton for the Product SDK structure.\",\n    );\n}\n\n/**\n * Check if a DotNS name is available for registration\n *\n * @param name - Name to check\n * @returns True if available\n */\nexport async function isDotNsAvailable(name: string): Promise<boolean> {\n    const record = await resolveDotNs(name).catch(() => null);\n    return record === null;\n}\n","/**\n * Product account derivation\n *\n * Derives product-scoped accounts from a parent account\n */\n\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport { blake2b256 } from \"@parity/product-sdk-crypto\";\nimport { ss58Encode, ss58Decode, deriveH160 } from \"@parity/product-sdk-address\";\nimport type { ProductAccountInfo, AnonymousAliasInfo, RingLocation } from \"./types.js\";\n\nconst log = createLogger(\"identity\");\n\n/**\n * Derive a product-scoped account from a parent account\n *\n * The product account is deterministically derived using:\n * productPublicKey = hash(parentPublicKey || productName)\n *\n * @param parentAddress - Parent account SS58 address\n * @param productName - Product name for derivation\n * @param ss58Prefix - SS58 prefix (default: 42)\n * @returns Product account info\n *\n * @example\n * ```ts\n * const productAccount = deriveProductAccount(\n *   '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',\n *   'my-app'\n * );\n * console.log('Product address:', productAccount.address);\n * ```\n */\nexport function deriveProductAccount(\n    parentAddress: string,\n    productName: string,\n    ss58Prefix = 42,\n): ProductAccountInfo {\n    const { publicKey: parentPublicKey } = ss58Decode(parentAddress);\n\n    // Derive product public key: blake2b-256(parentPublicKey || productName)\n    const productNameBytes = new TextEncoder().encode(productName);\n    const combined = new Uint8Array(parentPublicKey.length + productNameBytes.length);\n    combined.set(parentPublicKey, 0);\n    combined.set(productNameBytes, parentPublicKey.length);\n\n    const productPublicKey = blake2b256(combined);\n    const address = ss58Encode(productPublicKey, ss58Prefix);\n    const h160Address = deriveH160(productPublicKey);\n\n    log.debug(\"Derived product account\", {\n        parentAddress,\n        productName,\n        address,\n    });\n\n    return {\n        address,\n        h160Address,\n        parentAddress,\n        productName,\n    };\n}\n\n/**\n * Verify that a product account was derived from a parent account\n *\n * @param productAddress - Product account address\n * @param parentAddress - Claimed parent address\n * @param productName - Product name\n * @returns True if derivation is valid\n */\nexport function verifyProductAccount(\n    productAddress: string,\n    parentAddress: string,\n    productName: string,\n): boolean {\n    try {\n        const derived = deriveProductAccount(parentAddress, productName);\n        const { publicKey: productKey } = ss58Decode(productAddress);\n        const { publicKey: derivedKey } = ss58Decode(derived.address);\n\n        // Compare public keys\n        if (productKey.length !== derivedKey.length) return false;\n        for (let i = 0; i < productKey.length; i++) {\n            if (productKey[i] !== derivedKey[i]) return false;\n        }\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Derive an anonymous alias using Ring VRF\n *\n * This creates a context-specific alias that cannot be linked\n * back to the original identity without the ring proof.\n *\n * @param context - Context for alias derivation (e.g., \"voting-round-1\")\n * @param ringLocation - Ring location for proof generation\n * @returns Anonymous alias info\n */\nexport function deriveAnonymousAlias(\n    context: string,\n    ringLocation: RingLocation,\n): AnonymousAliasInfo {\n    log.debug(\"Deriving anonymous alias\", { context, ringLocation });\n\n    // TODO: Implement Ring VRF alias derivation\n    // This requires the Ring VRF implementation from TruAPI\n    throw new Error(\n        \"deriveAnonymousAlias() is not yet implemented. \" +\n            \"This requires container mode with Ring VRF support.\",\n    );\n}\n\n/**\n * Create a Ring VRF proof for a message\n *\n * @param message - Message to prove\n * @param ringLocation - Ring location\n * @returns Proof bytes\n */\nexport async function createRingProof(\n    message: Uint8Array,\n    ringLocation: RingLocation,\n): Promise<Uint8Array> {\n    log.debug(\"Creating ring proof\", { ringLocation });\n\n    // TODO: Implement Ring VRF proof creation via TruAPI\n    throw new Error(\n        \"createRingProof() is not yet implemented. \" +\n            \"This requires container mode with Ring VRF support.\",\n    );\n}\n\n/**\n * Verify a Ring VRF proof\n *\n * @param message - Original message\n * @param proof - Proof bytes\n * @param alias - Expected alias\n * @returns True if proof is valid\n */\nexport async function verifyRingProof(\n    message: Uint8Array,\n    proof: Uint8Array,\n    alias: string,\n): Promise<boolean> {\n    log.debug(\"Verifying ring proof\");\n\n    // TODO: Implement Ring VRF proof verification\n    throw new Error(\n        \"verifyRingProof() is not yet implemented. \" +\n            \"This requires container mode with Ring VRF support.\",\n    );\n}\n"],"mappings":"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","names":["createLogger","log"]}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
+import { b as AppConfig, A as App } from './types-CZQDzQ53.js';
+export { a as Account, B as BulletinApi, C as ChainApi, S as StorageApi, W as WalletApi } from './types-CZQDzQ53.js';
+export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
+export { ChainClient, createChainClient } from '@parity/product-sdk-chain-client';
+export { SignerManager } from '@parity/product-sdk-signer';
+export { createKvStore } from '@parity/product-sdk-storage';
+export { BulletinClient, computeCid } from '@parity/product-sdk-bulletin';
+export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
+
+/**
+ * createApp - Main entry point for the Product SDK
+ *
+ * Creates an App instance with wallet, storage, chain, and bulletin APIs.
+ */
+
+/**
+ * Create a new Product SDK app instance
+ *
+ * @param config - Application configuration
+ * @returns App instance with all APIs
+ *
+ * @example
+ * ```ts
+ * import { createApp } from '@parity/product-sdk';
+ *
+ * // Default: bulletin enabled with paseo environment
+ * const app = await createApp({
+ *   name: 'my-app',
+ *   logLevel: 'info',
+ * });
+ *
+ * // Custom bulletin environment
+ * const prodApp = await createApp({
+ *   name: 'my-app',
+ *   bulletin: { environment: 'polkadot' },
+ * });
+ *
+ * // Disable bulletin entirely
+ * const noBulletinApp = await createApp({
+ *   name: 'my-app',
+ *   bulletin: false,
+ * });
+ *
+ * // Connect wallet
+ * const { accounts } = await app.wallet.connect();
+ *
+ * // Use storage
+ * await app.storage.set('key', 'value');
+ *
+ * // Use bulletin (check for null if it might be disabled)
+ * if (app.bulletin) {
+ *   const cid = await app.bulletin.upload('hello world');
+ * }
+ * ```
+ */
+declare function createApp(config: AppConfig): Promise<App>;
+
+export { App, AppConfig, createApp };

package/dist/index.js

@@ -0,0 +1,27 @@
+import {
+  configure,
+  createLogger
+} from "./chunk-XSKBA5SR.js";
+import {
+  createApp
+} from "./chunk-NVGSGXGH.js";
+
+// src/index.ts
+import { isInsideContainer, isInsideContainerSync } from "@parity/product-sdk-host";
+import { createChainClient } from "@parity/product-sdk-chain-client";
+import { SignerManager } from "@parity/product-sdk-signer";
+import { createKvStore } from "@parity/product-sdk-storage";
+import { BulletinClient, computeCid } from "@parity/product-sdk-bulletin";
+export {
+  BulletinClient,
+  SignerManager,
+  computeCid,
+  configure,
+  createApp,
+  createChainClient,
+  createKvStore,
+  createLogger,
+  isInsideContainer,
+  isInsideContainerSync
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @parity/product-sdk\n *\n * Unified SDK for building products on the Polkadot ecosystem.\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * const app = createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\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 *\n * @packageDocumentation\n */\n\n// Core exports\nexport { createApp } from \"./core/createApp.js\";\nexport { configure, createLogger } from \"./core/logger.js\";\nexport type {\n    App,\n    AppConfig,\n    LogLevel,\n    WalletApi,\n    StorageApi,\n    ChainApi,\n    BulletinApi,\n    Account,\n    ChainClient,\n    ChainDefinition,\n    TypedApi,\n    PolkadotClient,\n} from \"./core/types.js\";\nexport type { LogEntry, LogHandler, LoggerConfig, Logger } from \"./core/logger.js\";\n\n// Re-export common utilities from leaf packages\nexport { isInsideContainer, isInsideContainerSync } from \"@parity/product-sdk-host\";\nexport { createChainClient } from \"@parity/product-sdk-chain-client\";\nexport { SignerManager } from \"@parity/product-sdk-signer\";\nexport { createKvStore } from \"@parity/product-sdk-storage\";\nexport { BulletinClient, computeCid } from \"@parity/product-sdk-bulletin\";\n"],"mappings":";;;;;;;;;AA4CA,SAAS,mBAAmB,6BAA6B;AACzD,SAAS,yBAAyB;AAClC,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB,kBAAkB;","names":[]}

package/dist/react/index.d.ts

@@ -0,0 +1,177 @@
+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 { A as App, a as Account } from '../types-CZQDzQ53.js';
+import { ChainDefinition, TypedApi } from 'polkadot-api';
+import '@parity/product-sdk-bulletin';
+import '@parity/product-sdk-chain-client';
+
+/** Props for ProductSDKProvider */
+interface ProductSDKProviderProps {
+    /** Application name - used for storage namespacing and product account derivation */
+    name: string;
+    /** Log level (default: 'info') */
+    logLevel?: LogLevel;
+    /** Child components */
+    children: ReactNode;
+    /** Fallback to show while loading */
+    fallback?: ReactNode;
+}
+/**
+ * Provider component that initializes the Product SDK
+ *
+ * @example
+ * ```tsx
+ * import { ProductSDKProvider } from '@parity/product-sdk/react';
+ *
+ * function App() {
+ *   return (
+ *     <ProductSDKProvider name="my-app" fallback={<Loading />}>
+ *       <MyApp />
+ *     </ProductSDKProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function ProductSDKProvider({ name, logLevel, children, fallback, }: ProductSDKProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Context for the Product SDK app instance */
+declare const ProductSDKContext: react.Context<App | null>;
+/**
+ * Hook to access the Product SDK app instance
+ *
+ * @throws If used outside of ProductSDKProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const app = useProductSDK();
+ *   // Use app.wallet, app.storage, etc.
+ * }
+ * ```
+ */
+declare function useProductSDK(): App;
+
+/**
+ * useWallet hook
+ */
+
+/** Wallet hook state */
+interface UseWalletState {
+    /** Whether wallet is connected */
+    isConnected: boolean;
+    /** Whether connection is in progress */
+    isConnecting: boolean;
+    /** Available accounts */
+    accounts: Account[];
+    /** Currently selected account */
+    selectedAccount: Account | null;
+    /** Last error */
+    error: Error | null;
+}
+/** Wallet hook actions */
+interface UseWalletActions {
+    /** Connect to wallet */
+    connect: () => Promise<void>;
+    /** Disconnect from wallet */
+    disconnect: () => Promise<void>;
+    /** Select an account */
+    selectAccount: (address: string) => void;
+    /** Sign a message */
+    signMessage: (message: string | Uint8Array) => Promise<Uint8Array>;
+}
+/** Return type of useWallet */
+type UseWalletReturn = UseWalletState & UseWalletActions;
+/**
+ * Hook for wallet connection and signing
+ *
+ * @example
+ * ```tsx
+ * function WalletButton() {
+ *   const { isConnected, accounts, connect, disconnect, selectAccount } = useWallet();
+ *
+ *   if (!isConnected) {
+ *     return <button onClick={connect}>Connect Wallet</button>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <select onChange={(e) => selectAccount(e.target.value)}>
+ *         {accounts.map((a) => (
+ *           <option key={a.address} value={a.address}>
+ *             {a.name || a.address}
+ *           </option>
+ *         ))}
+ *       </select>
+ *       <button onClick={disconnect}>Disconnect</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useWallet(): UseWalletReturn;
+
+/**
+ * useStorage hook
+ */
+/**
+ * Hook for key-value storage operations
+ *
+ * @param key - Storage key
+ * @param defaultValue - Default value if key doesn't exist
+ *
+ * @example
+ * ```tsx
+ * function ThemeToggle() {
+ *   const [theme, setTheme, { loading }] = useStorage('theme', 'light');
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
+ *       Current: {theme}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useStorage<T = string>(key: string, defaultValue?: T): [T | null, (value: T) => Promise<void>, {
+    loading: boolean;
+    error: Error | null;
+}];
+/**
+ * Hook for string storage (simpler API)
+ *
+ * @param key - Storage key
+ * @param defaultValue - Default value
+ */
+declare function useStorageString(key: string, defaultValue?: string): [string | null, (value: string) => Promise<void>, {
+    loading: boolean;
+}];
+
+/**
+ * useChain hook
+ */
+
+/**
+ * Hook to get a typed chain client
+ *
+ * @param chain - Chain descriptor (PAPI ChainDefinition)
+ *
+ * @example
+ * ```tsx
+ * import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';
+ * import { useChain } from '@parity/product-sdk/react';
+ *
+ * function AssetHubBalance() {
+ *   const assetHub = useChain(paseo_asset_hub);
+ *
+ *   // assetHub is typed for Asset Hub queries
+ *   const balance = await assetHub.query.System.Account.getValue(address);
+ * }
+ * ```
+ */
+declare function useChain<T extends ChainDefinition>(chain: T): TypedApi<T>;
+
+export { ProductSDKContext, ProductSDKProvider, type ProductSDKProviderProps, type UseWalletActions, type UseWalletReturn, type UseWalletState, useChain, useProductSDK, useStorage, useStorageString, useWallet };