@hashgraphonline/standards-sdk 0.1.144 → 0.1.145

package/dist/es/standards-sdk.es95.js

@@ -1,148 +1,52 @@
-import { HederaMirrorNode } from "./standards-sdk.es127.js";
-import { KeyList } from "@hashgraph/sdk";
-import { buildHcs16CreateFloraTopicTx } from "./standards-sdk.es92.js";
-import { Logger } from "./standards-sdk.es106.js";
-import { FloraTopicType } from "./standards-sdk.es91.js";
-class HCS16BaseClient {
-  constructor(params) {
-    this.network = params.network;
-    this.logger = params.logger || new Logger({ level: "info", module: "HCS-16" });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {
-      customUrl: params.mirrorNodeUrl
-    });
+import { z } from "zod";
+const hcs17MessageSchema = z.object({
+  p: z.literal("hcs-17"),
+  op: z.literal("state_hash"),
+  state_hash: z.string().min(1),
+  topics: z.array(z.string()),
+  account_id: z.string().min(1),
+  epoch: z.number().int().nonnegative().optional(),
+  timestamp: z.string().optional(),
+  m: z.string().optional()
+});
+class StateHashError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "StateHashError";
   }
-  async assembleKeyList(params) {
-    const keys = [];
-    for (const accountId of params.members) {
-      const pub = await this.mirrorNode.getPublicKey(accountId);
-      keys.push(pub);
-    }
-    return new KeyList(keys, params.threshold);
-  }
-  async assembleSubmitKeyList(members) {
-    const keys = [];
-    for (const accountId of members) {
-      const pub = await this.mirrorNode.getPublicKey(accountId);
-      keys.push(pub);
-    }
-    return new KeyList(keys, 1);
-  }
-  buildFloraTopicCreateTxs(params) {
-    const communication = buildHcs16CreateFloraTopicTx({
-      floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.COMMUNICATION,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
-      autoRenewAccountId: params.autoRenewAccountId
-    });
-    const transaction = buildHcs16CreateFloraTopicTx({
-      floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.TRANSACTION,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
-      autoRenewAccountId: params.autoRenewAccountId
-    });
-    const state = buildHcs16CreateFloraTopicTx({
-      floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.STATE,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
-      autoRenewAccountId: params.autoRenewAccountId
-    });
-    return { communication, transaction, state };
-  }
-  /**
-   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.
-   */
-  parseTopicMemo(memo) {
-    const match = memo.match(/^hcs-16:([0-9.]+):(\d)$/);
+}
+var HCS17TopicType = /* @__PURE__ */ ((HCS17TopicType2) => {
+  HCS17TopicType2[HCS17TopicType2["STATE"] = 0] = "STATE";
+  return HCS17TopicType2;
+})(HCS17TopicType || {});
+function generateHCS17Memo(ttl) {
+  return `hcs-17:${0}:${ttl}`;
+}
+function parseHCS17Memo(memo) {
+  try {
+    const match = memo.match(/^hcs-17:(\d+):(\d+)$/);
     if (!match) {
-      return null;
+      return void 0;
     }
-    const floraAccountId = match[1];
-    const topicType = Number(match[2]);
-    if (topicType !== FloraTopicType.COMMUNICATION && topicType !== FloraTopicType.TRANSACTION && topicType !== FloraTopicType.STATE) {
-      return null;
+    const type = Number(match[1]);
+    const ttl = Number(match[2]);
+    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {
+      return void 0;
     }
-    return {
-      protocol: "hcs-16",
-      floraAccountId,
-      topicType
-    };
-  }
-  /**
-   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.
-   */
-  createFloraMessage(op, operatorId, body) {
-    const payload = {
-      p: "hcs-16",
-      op,
-      operator_id: operatorId,
-      ...body || {}
-    };
-    return payload;
-  }
-  /**
-   * Fetch recent HCS‑16 messages from a topic via Mirror Node.
-   */
-  async getRecentMessages(topicId, options) {
-    const limit = options?.limit ?? 25;
-    const order = options?.order ?? "desc";
-    const items = await this.mirrorNode.getTopicMessages(topicId, { limit, order });
-    const results = [];
-    for (const raw of items) {
-      if (raw.p !== "hcs-16") {
-        continue;
-      }
-      const {
-        consensus_timestamp,
-        sequence_number,
-        running_hash,
-        running_hash_version,
-        topic_id,
-        payer,
-        created,
-        chunk_info,
-        ...payload
-      } = raw;
-      const op = payload.op;
-      const operatorId = payload.operator_id;
-      if (options?.opFilter && op !== options.opFilter) {
-        continue;
-      }
-      if (typeof operatorId !== "string") {
-        continue;
-      }
-      const message = payload;
-      results.push({
-        message,
-        consensus_timestamp,
-        sequence_number: Number(sequence_number),
-        payer
-      });
-    }
-    return results;
-  }
-  /**
-   * Return the latest valid HCS‑16 message on a topic, if any.
-   */
-  async getLatestMessage(topicId, opFilter) {
-    const items = await this.getRecentMessages(topicId, {
-      limit: 1,
-      order: "desc",
-      opFilter
-    });
-    if (items.length === 0) {
-      return null;
+    if (type !== 0) {
+      return void 0;
     }
-    const first = items[0];
-    return Object.assign({}, first.message, {
-      consensus_timestamp: first.consensus_timestamp,
-      sequence_number: first.sequence_number
-    });
+    return { type, ttl };
+  } catch {
+    return void 0;
   }
 }
 export {
-  HCS16BaseClient
+  HCS17TopicType,
+  StateHashError,
+  generateHCS17Memo,
+  hcs17MessageSchema,
+  parseHCS17Memo
 };
 //# sourceMappingURL=standards-sdk.es95.js.map

package/dist/es/standards-sdk.es95.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es95.js","sources":["../../src/hcs-16/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { KeyList, TopicCreateTransaction, PublicKey } from '@hashgraph/sdk';\nimport { buildHcs16CreateFloraTopicTx } from './tx';\nimport { Logger, ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { FloraTopicType, FloraMessage, FloraOperation } from './types';\nimport type { HCSMessageWithCommonFields } from '../services/types';\n\n/**\n * Base client for HCS‑16 functionality. Provides logging, mirror‑node access,\n * memo helpers, and light message utilities shared by Node and Browser clients.\n */\nexport class HCS16BaseClient {\n  protected readonly network: NetworkType;\n  public mirrorNode: HederaMirrorNode;\n  protected readonly logger: ILogger;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-16' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  async assembleKeyList(params: {\n    members: string[];\n    threshold: number;\n  }): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of params.members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, params.threshold);\n  }\n\n  async assembleSubmitKeyList(members: string[]): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, 1);\n  }\n\n  buildFloraTopicCreateTxs(params: {\n    floraAccountId: string;\n    keyList: KeyList;\n    submitList: KeyList;\n    autoRenewAccountId?: string;\n  }): {\n    communication: TopicCreateTransaction;\n    transaction: TopicCreateTransaction;\n    state: TopicCreateTransaction;\n  } {\n    const communication = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.COMMUNICATION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const transaction = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.TRANSACTION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const state = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.STATE,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    return { communication, transaction, state };\n  }\n\n  /**\n   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.\n   */\n  parseTopicMemo(memo: string): {\n    protocol: 'hcs-16';\n    floraAccountId: string;\n    topicType: FloraTopicType;\n  } | null {\n    const match = memo.match(/^hcs-16:([0-9.]+):(\\d)$/);\n    if (!match) {\n      return null;\n    }\n    const floraAccountId = match[1];\n    const topicType = Number(match[2]) as FloraTopicType;\n    if (\n      topicType !== FloraTopicType.COMMUNICATION &&\n      topicType !== FloraTopicType.TRANSACTION &&\n      topicType !== FloraTopicType.STATE\n    ) {\n      return null;\n    }\n    return {\n      protocol: 'hcs-16',\n      floraAccountId,\n      topicType,\n    };\n  }\n\n  /**\n   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.\n   */\n  protected createFloraMessage(\n    op: FloraOperation,\n    operatorId: string,\n    body?: Record<string, unknown>,\n  ): FloraMessage {\n    const payload: FloraMessage = {\n      p: 'hcs-16',\n      op,\n      operator_id: operatorId,\n      ...(body || {}),\n    } as FloraMessage;\n    return payload;\n  }\n\n  /**\n   * Fetch recent HCS‑16 messages from a topic via Mirror Node.\n   */\n  async getRecentMessages(\n    topicId: string,\n    options?: {\n      limit?: number;\n      order?: 'asc' | 'desc';\n      opFilter?: FloraOperation | string;\n    },\n  ): Promise<\n    Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }>\n  > {\n    const limit = options?.limit ?? 25;\n    const order = options?.order ?? 'desc';\n    const items: HCSMessageWithCommonFields[] =\n      await this.mirrorNode.getTopicMessages(topicId, { limit, order });\n\n    const results: Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }> = [];\n\n    for (const raw of items) {\n      if (raw.p !== 'hcs-16') {\n        continue;\n      }\n\n      const {\n        consensus_timestamp,\n        sequence_number,\n        running_hash,\n        running_hash_version,\n        topic_id,\n        payer,\n        created,\n        chunk_info,\n        ...payload\n      } = raw as unknown as Record<string, unknown>;\n\n      const op = payload.op as FloraOperation | string | undefined;\n      const operatorId = payload.operator_id as string | undefined;\n\n      if (options?.opFilter && op !== options.opFilter) {\n        continue;\n      }\n      if (typeof operatorId !== 'string') {\n        continue;\n      }\n\n      const message = payload as unknown as FloraMessage;\n\n      results.push({\n        message,\n        consensus_timestamp: consensus_timestamp as string | undefined,\n        sequence_number: Number(sequence_number),\n        payer: payer as string | undefined,\n      });\n    }\n    return results;\n  }\n\n  /**\n   * Return the latest valid HCS‑16 message on a topic, if any.\n   */\n  async getLatestMessage(\n    topicId: string,\n    opFilter?: FloraOperation | string,\n  ): Promise<\n    | (FloraMessage & { consensus_timestamp?: string; sequence_number: number })\n    | null\n  > {\n    const items = await this.getRecentMessages(topicId, {\n      limit: 1,\n      order: 'desc',\n      opFilter,\n    });\n    if (items.length === 0) {\n      return null;\n    }\n    const first = items[0];\n    return Object.assign({}, first.message, {\n      consensus_timestamp: first.consensus_timestamp,\n      sequence_number: first.sequence_number,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es95.js","sources":["../../src/hcs-17/types.ts"],"sourcesContent":["import { PublicKey, PrivateKey } from '@hashgraph/sdk';\nimport type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport { z } from 'zod';\nimport { Logger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * HCS-17 Topic state information\n */\nexport interface TopicState {\n  topicId: string;\n  latestRunningHash: string;\n}\n\n/**\n * HCS-17 Account state hash input\n */\nexport interface AccountStateInput {\n  accountId: string;\n  publicKey: PublicKey | string;\n  topics: TopicState[];\n}\n\n/**\n * HCS-17 Composite state hash input for Flora/Bloom\n */\nexport interface CompositeStateInput {\n  compositeAccountId: string;\n  compositePublicKeyFingerprint: string;\n  memberStates: Array<{\n    accountId: string;\n    stateHash: string;\n  }>;\n  compositeTopics: TopicState[];\n}\n\n/**\n * HCS-17 State hash message format\n */\nexport interface StateHashMessage {\n  p: 'hcs-17';\n  op: 'state_hash';\n  state_hash: string;\n  topics: string[];\n  account_id: string;\n  epoch?: number;\n  timestamp?: string;\n  m?: string;\n}\n\nexport const hcs17MessageSchema = z.object({\n  p: z.literal('hcs-17'),\n  op: z.literal('state_hash'),\n  state_hash: z.string().min(1),\n  topics: z.array(z.string()),\n  account_id: z.string().min(1),\n  epoch: z.number().int().nonnegative().optional(),\n  timestamp: z.string().optional(),\n  m: z.string().optional(),\n});\n\n/**\n * HCS-17 State hash result\n */\nexport interface StateHashResult {\n  stateHash: string;\n  accountId: string;\n  timestamp: Date;\n  topicCount: number;\n}\n\n/**\n * HCS-17 Composite state hash result\n */\nexport interface CompositeStateHashResult extends StateHashResult {\n  memberCount: number;\n  compositeTopicCount: number;\n}\n\n/**\n * HCS-17 errors\n */\nexport class StateHashError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'StateHashError';\n  }\n}\n\n/**\n * Base configuration shared by HCS‑17 Node and Browser clients.\n */\nexport interface HCS17ClientConfig {\n  network: NetworkType;\n  logLevel?: LogLevel;\n  silent?: boolean;\n  mirrorNodeUrl?: string;\n  logger?: Logger;\n}\n\n/**\n * Node SDK configuration for HCS‑17 client.\n */\nexport interface SDKHCS17ClientConfig extends HCS17ClientConfig {\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n}\n\n/**\n * Browser client configuration for HCS‑17 operations.\n */\nexport interface BrowserHCS17ClientConfig extends HCS17ClientConfig {\n  hwc?: HashinalsWalletConnectSDK;\n  signer?: DAppSigner;\n}\n\n/**\n * HCS‑17 topic types (numeric codes for memo encoding).\n */\nexport enum HCS17TopicType {\n  STATE = 0,\n}\n\n/**\n * Generate the standard HCS‑17 topic memo: `hcs-17:<type>:<ttl>`.\n */\nexport function generateHCS17Memo(ttl: number): string {\n  return `hcs-17:${HCS17TopicType.STATE}:${ttl}`;\n}\n\n/**\n * Parse an HCS‑17 memo into `{ type, ttl }` if valid.\n */\nexport function parseHCS17Memo(\n  memo: string,\n): { type: HCS17TopicType; ttl: number } | undefined {\n  try {\n    const match = memo.match(/^hcs-17:(\\d+):(\\d+)$/);\n    if (!match) {\n      return undefined;\n    }\n    const type = Number(match[1]) as HCS17TopicType;\n    const ttl = Number(match[2]);\n    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {\n      return undefined;\n    }\n    if (type !== HCS17TopicType.STATE) {\n      return undefined;\n    }\n    return { type, ttl };\n  } catch {\n    return undefined;\n  }\n}\n"],"names":["HCS17TopicType"],"mappings":";AAmDO,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,GAAG,EAAE,QAAQ,QAAQ;AAAA,EACrB,IAAI,EAAE,QAAQ,YAAY;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,QAAQ,EAAE,MAAM,EAAE,QAAQ;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,OAAO,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,EACtC,WAAW,EAAE,OAAA,EAAS,SAAA;AAAA,EACtB,GAAG,EAAE,OAAA,EAAS,SAAA;AAChB,CAAC;AAuBM,MAAM,uBAAuB,MAAM;AAAA,EACxC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAiCO,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,WAAQ,CAAA,IAAR;AADU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAOL,SAAS,kBAAkB,KAAqB;AACrD,SAAO,UAAU,KAAwB,GAAG;AAC9C;AAKO,SAAS,eACd,MACmD;AACnD,MAAI;AACF,UAAM,QAAQ,KAAK,MAAM,sBAAsB;AAC/C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AACA,UAAM,OAAO,OAAO,MAAM,CAAC,CAAC;AAC5B,UAAM,MAAM,OAAO,MAAM,CAAC,CAAC;AAC3B,QAAI,OAAO,MAAM,IAAI,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,GAAG;AACvD,aAAO;AAAA,IACT;AACA,QAAI,SAAS,GAAsB;AACjC,aAAO;AAAA,IACT;AACA,WAAO,EAAE,MAAM,IAAA;AAAA,EACjB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}

package/dist/es/standards-sdk.es96.js

@@ -1,51 +1,268 @@
-import { z } from "zod";
-const hcs17MessageSchema = z.object({
-  p: z.literal("hcs-17"),
-  op: z.literal("state_hash"),
-  state_hash: z.string().min(1),
-  topics: z.array(z.string()),
-  account_id: z.string().min(1),
-  timestamp: z.string().optional(),
-  m: z.string().optional()
-});
-class StateHashError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "StateHashError";
+import { HederaMirrorNode } from "./standards-sdk.es126.js";
+import { Logger } from "./standards-sdk.es105.js";
+import { createHash } from "crypto";
+import { hcs17MessageSchema, generateHCS17Memo, parseHCS17Memo, HCS17TopicType } from "./standards-sdk.es95.js";
+class HCS17BaseClient {
+  constructor(config) {
+    this.network = config.network;
+    this.logger = config.logger || new Logger({ level: config.logLevel || "info", module: "HCS-17" });
+    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {
+      customUrl: config.mirrorNodeUrl
+    });
   }
-}
-var HCS17TopicType = /* @__PURE__ */ ((HCS17TopicType2) => {
-  HCS17TopicType2[HCS17TopicType2["STATE"] = 0] = "STATE";
-  return HCS17TopicType2;
-})(HCS17TopicType || {});
-function generateHCS17Memo(ttl) {
-  return `hcs-17:${0}:${ttl}`;
-}
-function parseHCS17Memo(memo) {
-  try {
-    const match = memo.match(/^hcs-17:(\d+):(\d+)$/);
-    if (!match) {
-      return void 0;
+  /**
+   * Create a valid HCS‑17 state hash message payload.
+   */
+  createMessage(params) {
+    const msg = {
+      p: "hcs-17",
+      op: "state_hash",
+      state_hash: params.stateHash,
+      topics: params.topics,
+      account_id: params.accountId,
+      epoch: params.epoch,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      m: params.memo
+    };
+    return msg;
+  }
+  /**
+   * Validate an HCS‑17 message against the schema.
+   */
+  validateMessage(message) {
+    const res = hcs17MessageSchema.safeParse(message);
+    if (res.success) {
+      return { valid: true, errors: [] };
     }
-    const type = Number(match[1]);
-    const ttl = Number(match[2]);
-    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {
-      return void 0;
+    const errors = res.error.errors.map(
+      (e) => `${e.path.join(".")}: ${e.message}`
+    );
+    this.logger.debug(`HCS-17 message validation failed: ${errors.join(", ")}`);
+    return { valid: false, errors };
+  }
+  /**
+   * Generate default HCS‑17 topic memo using numeric enum codes.
+   */
+  generateTopicMemo(ttl) {
+    return generateHCS17Memo(ttl);
+  }
+  /**
+   * Validate that a topic is a valid HCS‑17 topic and return parsed info.
+   */
+  async validateHCS17Topic(topicId) {
+    try {
+      const info = await this.mirrorNode.getTopicInfo(topicId);
+      const parsed = parseHCS17Memo(info.memo);
+      if (!parsed) {
+        return { valid: false, error: "Invalid HCS-17 memo format" };
+      }
+      if (parsed.type !== HCS17TopicType.STATE) {
+        return { valid: false, error: "Unsupported HCS-17 topic type" };
+      }
+      return { valid: true, type: parsed.type, ttl: parsed.ttl };
+    } catch (e) {
+      return { valid: false, error: String(e) };
+    }
+  }
+  /**
+   * Fetch recent HCS‑17 messages from a topic via Mirror Node.
+   */
+  async getRecentMessages(topicId, options) {
+    const limit = options?.limit ?? 25;
+    const order = options?.order ?? "desc";
+    const items = await this.mirrorNode.getTopicMessages(topicId, {
+      limit,
+      order
+    });
+    const results = [];
+    for (const m of items) {
+      try {
+        if (m.p !== "hcs-17" || m.op !== "state_hash") {
+          continue;
+        }
+        const envelope = m;
+        const { valid } = this.validateMessage(envelope);
+        if (!valid) {
+          continue;
+        }
+        results.push({
+          message: {
+            p: "hcs-17",
+            op: "state_hash",
+            state_hash: envelope.state_hash,
+            topics: envelope.topics,
+            account_id: envelope.account_id,
+            epoch: envelope.epoch,
+            timestamp: envelope.timestamp,
+            m: envelope.m
+          },
+          consensus_timestamp: envelope.consensus_timestamp,
+          sequence_number: Number(envelope.sequence_number),
+          payer: envelope.payer
+        });
+      } catch (err) {
+        this.logger.debug(`Failed to parse HCS-17 message: ${err}`);
+      }
+    }
+    return results;
+  }
+  /**
+   * Return the latest valid HCS‑17 message on a topic, if any.
+   */
+  async getLatestMessage(topicId) {
+    const items = await this.getRecentMessages(topicId, {
+      limit: 1,
+      order: "desc"
+    });
+    if (!items.length) {
+      return null;
     }
-    if (type !== 0) {
-      return void 0;
+    const { message, consensus_timestamp, sequence_number } = items[0];
+    return Object.assign({}, message, { consensus_timestamp, sequence_number });
+  }
+  /**
+   * Calculate state hash for a single account.
+   */
+  calculateAccountStateHash(input) {
+    try {
+      this.logger.debug("Calculating account state hash", {
+        accountId: input.accountId,
+        topicCount: input.topics.length
+      });
+      const sortedTopics = [...input.topics].sort(
+        (a, b) => a.topicId.localeCompare(b.topicId)
+      );
+      let concatenated = "";
+      for (const topic of sortedTopics) {
+        concatenated += topic.topicId + topic.latestRunningHash;
+      }
+      let publicKeyString = "";
+      if (typeof input.publicKey === "string") {
+        publicKeyString = input.publicKey;
+      } else {
+        publicKeyString = input.publicKey.toString();
+      }
+      concatenated += publicKeyString;
+      const hash = createHash("sha384");
+      hash.update(concatenated);
+      const stateHash = hash.digest("hex");
+      this.logger.debug("Account state hash calculated", {
+        accountId: input.accountId,
+        stateHash
+      });
+      return {
+        stateHash,
+        accountId: input.accountId,
+        timestamp: /* @__PURE__ */ new Date(),
+        topicCount: input.topics.length
+      };
+    } catch (error) {
+      this.logger.error("Failed to calculate account state hash", error);
+      throw new Error("HCS-17 CALCULATION_FAILED");
+    }
+  }
+  /**
+   * Calculate composite state hash for composite accounts (e.g., Flora/Bloom).
+   */
+  calculateCompositeStateHash(input) {
+    try {
+      this.logger.debug("Calculating composite state hash", {
+        compositeAccountId: input.compositeAccountId,
+        memberCount: input.memberStates.length,
+        topicCount: input.compositeTopics.length
+      });
+      const sortedMembers = [...input.memberStates].sort(
+        (a, b) => a.accountId.localeCompare(b.accountId)
+      );
+      const sortedTopics = [...input.compositeTopics].sort(
+        (a, b) => a.topicId.localeCompare(b.topicId)
+      );
+      let concatenated = "";
+      for (const member of sortedMembers) {
+        concatenated += member.accountId + member.stateHash;
+      }
+      for (const topic of sortedTopics) {
+        concatenated += topic.topicId + topic.latestRunningHash;
+      }
+      concatenated += input.compositePublicKeyFingerprint;
+      const hash = createHash("sha384");
+      hash.update(concatenated);
+      const stateHash = hash.digest("hex");
+      this.logger.debug("Composite state hash calculated", {
+        compositeAccountId: input.compositeAccountId,
+        stateHash
+      });
+      return {
+        stateHash,
+        accountId: input.compositeAccountId,
+        timestamp: /* @__PURE__ */ new Date(),
+        topicCount: input.compositeTopics.length,
+        memberCount: input.memberStates.length,
+        compositeTopicCount: input.compositeTopics.length
+      };
+    } catch (error) {
+      this.logger.error("Failed to calculate composite state hash", error);
+      throw new Error("HCS-17 COMPOSITE_CALCULATION_FAILED");
+    }
+  }
+  /**
+   * Calculate deterministic fingerprint for a threshold key from member public keys.
+   */
+  calculateKeyFingerprint(keys, threshold) {
+    try {
+      const sortedKeys = [...keys].sort(
+        (a, b) => a.toString().localeCompare(b.toString())
+      );
+      const keyData = { threshold, keys: sortedKeys.map((k) => k.toString()) };
+      const hash = createHash("sha384");
+      hash.update(JSON.stringify(keyData));
+      return hash.digest("hex");
+    } catch (error) {
+      this.logger.error("Failed to calculate key fingerprint", error);
+      throw new Error("HCS-17 FINGERPRINT_FAILED");
+    }
+  }
+  /**
+   * Build a valid HCS‑17 state hash message.
+   */
+  createStateHashMessage(stateHash, accountId, topicIds, memo) {
+    return {
+      p: "hcs-17",
+      op: "state_hash",
+      state_hash: stateHash,
+      topics: topicIds,
+      account_id: accountId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      m: memo
+    };
+  }
+  /**
+   * Recompute and verify a state hash input against an expected value.
+   */
+  async verifyStateHash(input, expectedHash) {
+    try {
+      let calculatedHash;
+      if ("publicKey" in input) {
+        calculatedHash = this.calculateAccountStateHash(input).stateHash;
+      } else {
+        calculatedHash = this.calculateCompositeStateHash(input).stateHash;
+      }
+      const isValid = calculatedHash === expectedHash;
+      const accountId = "accountId" in input ? input.accountId : input.compositeAccountId;
+      this.logger.debug("State hash verification", {
+        accountId,
+        isValid,
+        expected: expectedHash,
+        calculated: calculatedHash
+      });
+      return isValid;
+    } catch (error) {
+      this.logger.error("Failed to verify state hash", error);
+      return false;
     }
-    return { type, ttl };
-  } catch {
-    return void 0;
   }
 }
 export {
-  HCS17TopicType,
-  StateHashError,
-  generateHCS17Memo,
-  hcs17MessageSchema,
-  parseHCS17Memo
+  HCS17BaseClient
 };
 //# sourceMappingURL=standards-sdk.es96.js.map

package/dist/es/standards-sdk.es96.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es96.js","sources":["../../src/hcs-17/types.ts"],"sourcesContent":["import { PublicKey, PrivateKey } from '@hashgraph/sdk';\nimport type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport { z } from 'zod';\nimport { Logger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * HCS-17 Topic state information\n */\nexport interface TopicState {\n  topicId: string;\n  latestRunningHash: string;\n}\n\n/**\n * HCS-17 Account state hash input\n */\nexport interface AccountStateInput {\n  accountId: string;\n  publicKey: PublicKey | string;\n  topics: TopicState[];\n}\n\n/**\n * HCS-17 Composite state hash input for Flora/Bloom\n */\nexport interface CompositeStateInput {\n  compositeAccountId: string;\n  compositePublicKeyFingerprint: string;\n  memberStates: Array<{\n    accountId: string;\n    stateHash: string;\n  }>;\n  compositeTopics: TopicState[];\n}\n\n/**\n * HCS-17 State hash message format\n */\nexport interface StateHashMessage {\n  p: 'hcs-17';\n  op: 'state_hash';\n  state_hash: string;\n  topics: string[];\n  account_id: string;\n  timestamp?: string;\n  m?: string;\n}\n\nexport const hcs17MessageSchema = z.object({\n  p: z.literal('hcs-17'),\n  op: z.literal('state_hash'),\n  state_hash: z.string().min(1),\n  topics: z.array(z.string()),\n  account_id: z.string().min(1),\n  timestamp: z.string().optional(),\n  m: z.string().optional(),\n});\n\n/**\n * HCS-17 State hash result\n */\nexport interface StateHashResult {\n  stateHash: string;\n  accountId: string;\n  timestamp: Date;\n  topicCount: number;\n}\n\n/**\n * HCS-17 Composite state hash result\n */\nexport interface CompositeStateHashResult extends StateHashResult {\n  memberCount: number;\n  compositeTopicCount: number;\n}\n\n/**\n * HCS-17 errors\n */\nexport class StateHashError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'StateHashError';\n  }\n}\n\n/**\n * Base configuration shared by HCS‑17 Node and Browser clients.\n */\nexport interface HCS17ClientConfig {\n  network: NetworkType;\n  logLevel?: LogLevel;\n  silent?: boolean;\n  mirrorNodeUrl?: string;\n  logger?: Logger;\n}\n\n/**\n * Node SDK configuration for HCS‑17 client.\n */\nexport interface SDKHCS17ClientConfig extends HCS17ClientConfig {\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n}\n\n/**\n * Browser client configuration for HCS‑17 operations.\n */\nexport interface BrowserHCS17ClientConfig extends HCS17ClientConfig {\n  hwc?: HashinalsWalletConnectSDK;\n  signer?: DAppSigner;\n}\n\n/**\n * HCS‑17 topic types (numeric codes for memo encoding).\n */\nexport enum HCS17TopicType {\n  STATE = 0,\n}\n\n/**\n * Generate the standard HCS‑17 topic memo: `hcs-17:<type>:<ttl>`.\n */\nexport function generateHCS17Memo(ttl: number): string {\n  return `hcs-17:${HCS17TopicType.STATE}:${ttl}`;\n}\n\n/**\n * Parse an HCS‑17 memo into `{ type, ttl }` if valid.\n */\nexport function parseHCS17Memo(\n  memo: string,\n): { type: HCS17TopicType; ttl: number } | undefined {\n  try {\n    const match = memo.match(/^hcs-17:(\\d+):(\\d+)$/);\n    if (!match) {\n      return undefined;\n    }\n    const type = Number(match[1]) as HCS17TopicType;\n    const ttl = Number(match[2]);\n    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {\n      return undefined;\n    }\n    if (type !== HCS17TopicType.STATE) {\n      return undefined;\n    }\n    return { type, ttl };\n  } catch {\n    return undefined;\n  }\n}\n"],"names":["HCS17TopicType"],"mappings":";AAkDO,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,GAAG,EAAE,QAAQ,QAAQ;AAAA,EACrB,IAAI,EAAE,QAAQ,YAAY;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,QAAQ,EAAE,MAAM,EAAE,QAAQ;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,WAAW,EAAE,OAAA,EAAS,SAAA;AAAA,EACtB,GAAG,EAAE,OAAA,EAAS,SAAA;AAChB,CAAC;AAuBM,MAAM,uBAAuB,MAAM;AAAA,EACxC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAiCO,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,WAAQ,CAAA,IAAR;AADU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAOL,SAAS,kBAAkB,KAAqB;AACrD,SAAO,UAAU,KAAwB,GAAG;AAC9C;AAKO,SAAS,eACd,MACmD;AACnD,MAAI;AACF,UAAM,QAAQ,KAAK,MAAM,sBAAsB;AAC/C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AACA,UAAM,OAAO,OAAO,MAAM,CAAC,CAAC;AAC5B,UAAM,MAAM,OAAO,MAAM,CAAC,CAAC;AAC3B,QAAI,OAAO,MAAM,IAAI,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,GAAG;AACvD,aAAO;AAAA,IACT;AACA,QAAI,SAAS,GAAsB;AACjC,aAAO;AAAA,IACT;AACA,WAAO,EAAE,MAAM,IAAA;AAAA,EACjB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-sdk.es96.js","sources":["../../src/hcs-17/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { Logger, ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { createHash } from 'crypto';\nimport {\n  hcs17MessageSchema,\n  StateHashMessage,\n  HCS17ClientConfig,\n  parseHCS17Memo,\n  generateHCS17Memo,\n  HCS17TopicType,\n  AccountStateInput,\n  CompositeStateInput,\n  StateHashResult,\n  CompositeStateHashResult,\n} from './types';\nimport { PublicKey } from '@hashgraph/sdk';\n\n/**\n * Base client for HCS‑17 functionality, shared between Node and Browser clients.\n * Provides logging, mirror‑node access, message creation/validation,\n * topic memo helpers, and registry/message querying utilities.\n */\nexport class HCS17BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly mirrorNode: HederaMirrorNode;\n  protected readonly logger: ILogger;\n\n  constructor(config: HCS17ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      new Logger({ level: config.logLevel || 'info', module: 'HCS-17' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: config.mirrorNodeUrl,\n    });\n  }\n\n  /**\n   * Create a valid HCS‑17 state hash message payload.\n   */\n  protected createMessage(params: {\n    stateHash: string;\n    accountId: string;\n    topics: string[];\n    memo?: string;\n    epoch?: number;\n  }): StateHashMessage {\n    const msg: StateHashMessage = {\n      p: 'hcs-17',\n      op: 'state_hash',\n      state_hash: params.stateHash,\n      topics: params.topics,\n      account_id: params.accountId,\n      epoch: params.epoch,\n      timestamp: new Date().toISOString(),\n      m: params.memo,\n    };\n    return msg;\n  }\n\n  /**\n   * Validate an HCS‑17 message against the schema.\n   */\n  protected validateMessage(message: unknown): {\n    valid: boolean;\n    errors: string[];\n  } {\n    const res = hcs17MessageSchema.safeParse(message);\n    if (res.success) {\n      return { valid: true, errors: [] };\n    }\n    const errors = res.error.errors.map(\n      e => `${e.path.join('.')}: ${e.message}`,\n    );\n    this.logger.debug(`HCS-17 message validation failed: ${errors.join(', ')}`);\n    return { valid: false, errors };\n  }\n\n  /**\n   * Generate default HCS‑17 topic memo using numeric enum codes.\n   */\n  protected generateTopicMemo(ttl: number): string {\n    return generateHCS17Memo(ttl);\n  }\n\n  /**\n   * Validate that a topic is a valid HCS‑17 topic and return parsed info.\n   */\n  async validateHCS17Topic(topicId: string): Promise<{\n    valid: boolean;\n    type?: HCS17TopicType;\n    ttl?: number;\n    error?: string;\n  }> {\n    try {\n      const info = await this.mirrorNode.getTopicInfo(topicId);\n      const parsed = parseHCS17Memo(info.memo);\n      if (!parsed) {\n        return { valid: false, error: 'Invalid HCS-17 memo format' };\n      }\n      if (parsed.type !== HCS17TopicType.STATE) {\n        return { valid: false, error: 'Unsupported HCS-17 topic type' };\n      }\n      return { valid: true, type: parsed.type, ttl: parsed.ttl };\n    } catch (e: unknown) {\n      return { valid: false, error: String(e) };\n    }\n  }\n\n  /**\n   * Fetch recent HCS‑17 messages from a topic via Mirror Node.\n   */\n  async getRecentMessages(\n    topicId: string,\n    options?: { limit?: number; order?: 'asc' | 'desc' },\n  ): Promise<\n    Array<{\n      message: StateHashMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }>\n  > {\n    const limit = options?.limit ?? 25;\n    const order = options?.order ?? 'desc';\n    const items = await this.mirrorNode.getTopicMessages(topicId, {\n      limit,\n      order,\n    });\n    type HCS17Envelope = StateHashMessage & {\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    };\n    const results: Array<{\n      message: StateHashMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }> = [];\n    for (const m of items) {\n      try {\n        if (m.p !== 'hcs-17' || m.op !== 'state_hash') {\n          continue;\n        }\n        const envelope = m as unknown as HCS17Envelope;\n        const { valid } = this.validateMessage(envelope);\n        if (!valid) {\n          continue;\n        }\n        results.push({\n          message: {\n            p: 'hcs-17',\n            op: 'state_hash',\n            state_hash: envelope.state_hash,\n            topics: envelope.topics,\n            account_id: envelope.account_id,\n            epoch: envelope.epoch,\n            timestamp: envelope.timestamp,\n            m: envelope.m,\n          },\n          consensus_timestamp: envelope.consensus_timestamp,\n          sequence_number: Number(envelope.sequence_number),\n          payer: envelope.payer,\n        });\n      } catch (err) {\n        this.logger.debug(`Failed to parse HCS-17 message: ${err}`);\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Return the latest valid HCS‑17 message on a topic, if any.\n   */\n  async getLatestMessage(topicId: string): Promise<\n    | (StateHashMessage & {\n        consensus_timestamp?: string;\n        sequence_number: number;\n      })\n    | null\n  > {\n    const items = await this.getRecentMessages(topicId, {\n      limit: 1,\n      order: 'desc',\n    });\n    if (!items.length) {\n      return null;\n    }\n    const { message, consensus_timestamp, sequence_number } = items[0];\n    return Object.assign({}, message, { consensus_timestamp, sequence_number });\n  }\n\n  /**\n   * Calculate state hash for a single account.\n   */\n  public calculateAccountStateHash(input: AccountStateInput): StateHashResult {\n    try {\n      this.logger.debug('Calculating account state hash', {\n        accountId: input.accountId,\n        topicCount: input.topics.length,\n      });\n\n      const sortedTopics = [...input.topics].sort((a, b) =>\n        a.topicId.localeCompare(b.topicId),\n      );\n\n      let concatenated = '';\n      for (const topic of sortedTopics) {\n        concatenated += topic.topicId + topic.latestRunningHash;\n      }\n\n      let publicKeyString = '';\n      if (typeof input.publicKey === 'string') {\n        publicKeyString = input.publicKey;\n      } else {\n        publicKeyString = input.publicKey.toString();\n      }\n      concatenated += publicKeyString;\n      const hash = createHash('sha384');\n      hash.update(concatenated);\n      const stateHash = hash.digest('hex');\n\n      this.logger.debug('Account state hash calculated', {\n        accountId: input.accountId,\n        stateHash,\n      });\n\n      return {\n        stateHash,\n        accountId: input.accountId,\n        timestamp: new Date(),\n        topicCount: input.topics.length,\n      };\n    } catch (error) {\n      this.logger.error('Failed to calculate account state hash', error);\n      throw new Error('HCS-17 CALCULATION_FAILED');\n    }\n  }\n\n  /**\n   * Calculate composite state hash for composite accounts (e.g., Flora/Bloom).\n   */\n  public calculateCompositeStateHash(\n    input: CompositeStateInput,\n  ): CompositeStateHashResult {\n    try {\n      this.logger.debug('Calculating composite state hash', {\n        compositeAccountId: input.compositeAccountId,\n        memberCount: input.memberStates.length,\n        topicCount: input.compositeTopics.length,\n      });\n\n      const sortedMembers = [...input.memberStates].sort((a, b) =>\n        a.accountId.localeCompare(b.accountId),\n      );\n\n      const sortedTopics = [...input.compositeTopics].sort((a, b) =>\n        a.topicId.localeCompare(b.topicId),\n      );\n\n      let concatenated = '';\n      for (const member of sortedMembers) {\n        concatenated += member.accountId + member.stateHash;\n      }\n      for (const topic of sortedTopics) {\n        concatenated += topic.topicId + topic.latestRunningHash;\n      }\n\n      concatenated += input.compositePublicKeyFingerprint;\n      const hash = createHash('sha384');\n      hash.update(concatenated);\n      const stateHash = hash.digest('hex');\n\n      this.logger.debug('Composite state hash calculated', {\n        compositeAccountId: input.compositeAccountId,\n        stateHash,\n      });\n\n      return {\n        stateHash,\n        accountId: input.compositeAccountId,\n        timestamp: new Date(),\n        topicCount: input.compositeTopics.length,\n        memberCount: input.memberStates.length,\n        compositeTopicCount: input.compositeTopics.length,\n      };\n    } catch (error) {\n      this.logger.error('Failed to calculate composite state hash', error);\n      throw new Error('HCS-17 COMPOSITE_CALCULATION_FAILED');\n    }\n  }\n\n  /**\n   * Calculate deterministic fingerprint for a threshold key from member public keys.\n   */\n  public calculateKeyFingerprint(keys: PublicKey[], threshold: number): string {\n    try {\n      const sortedKeys = [...keys].sort((a, b) =>\n        a.toString().localeCompare(b.toString()),\n      );\n      const keyData = { threshold, keys: sortedKeys.map(k => k.toString()) };\n      const hash = createHash('sha384');\n      hash.update(JSON.stringify(keyData));\n      return hash.digest('hex');\n    } catch (error) {\n      this.logger.error('Failed to calculate key fingerprint', error);\n      throw new Error('HCS-17 FINGERPRINT_FAILED');\n    }\n  }\n\n  /**\n   * Build a valid HCS‑17 state hash message.\n   */\n  public createStateHashMessage(\n    stateHash: string,\n    accountId: string,\n    topicIds: string[],\n    memo?: string,\n  ): StateHashMessage {\n    return {\n      p: 'hcs-17',\n      op: 'state_hash',\n      state_hash: stateHash,\n      topics: topicIds,\n      account_id: accountId,\n      timestamp: new Date().toISOString(),\n      m: memo,\n    };\n  }\n\n  /**\n   * Recompute and verify a state hash input against an expected value.\n   */\n  public async verifyStateHash(\n    input: AccountStateInput | CompositeStateInput,\n    expectedHash: string,\n  ): Promise<boolean> {\n    try {\n      let calculatedHash: string;\n      if ('publicKey' in input) {\n        calculatedHash = this.calculateAccountStateHash(input).stateHash;\n      } else {\n        calculatedHash = this.calculateCompositeStateHash(input).stateHash;\n      }\n      const isValid = calculatedHash === expectedHash;\n      const accountId =\n        'accountId' in input ? input.accountId : input.compositeAccountId;\n      this.logger.debug('State hash verification', {\n        accountId,\n        isValid,\n        expected: expectedHash,\n        calculated: calculatedHash,\n      });\n      return isValid;\n    } catch (error) {\n      this.logger.error('Failed to verify state hash', error);\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}