@hashgraphonline/standards-sdk 0.1.161 → 0.1.162

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

@@ -1,268 +1,52 @@
-import { HederaMirrorNode } from "./standards-sdk.es138.js";
-import { Logger } from "./standards-sdk.es117.js";
-import { createHash } from "crypto";
-import { hcs17MessageSchema, generateHCS17Memo, parseHCS17Memo, HCS17TopicType } from "./standards-sdk.es101.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
-    });
+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";
   }
-  /**
-   * 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 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;
-    }
-    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");
+}
+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;
     }
-  }
-  /**
-   * 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");
+    const type = Number(match[1]);
+    const ttl = Number(match[2]);
+    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {
+      return void 0;
     }
-  }
-  /**
-   * 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;
+    if (type !== 0) {
+      return void 0;
     }
+    return { type, ttl };
+  } catch {
+    return void 0;
   }
 }
 export {
-  HCS17BaseClient
+  HCS17TopicType,
+  StateHashError,
+  generateHCS17Memo,
+  hcs17MessageSchema,
+  parseHCS17Memo
 };
 //# sourceMappingURL=standards-sdk.es102.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es102.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":";;;;AAuBO,MAAM,gBAAgB;AAAA,EAK3B,YAAY,QAA2B;AACrC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,IAAI,OAAO,EAAE,OAAO,OAAO,YAAY,QAAQ,QAAQ,SAAA,CAAU;AACnE,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,QAAQ;AAAA,MAChE,WAAW,OAAO;AAAA,IAAA,CACnB;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKU,cAAc,QAMH;AACnB,UAAM,MAAwB;AAAA,MAC5B,GAAG;AAAA,MACH,IAAI;AAAA,MACJ,YAAY,OAAO;AAAA,MACnB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB,OAAO,OAAO;AAAA,MACd,YAAW,oBAAI,KAAA,GAAO,YAAA;AAAA,MACtB,GAAG,OAAO;AAAA,IAAA;AAEZ,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKU,gBAAgB,SAGxB;AACA,UAAM,MAAM,mBAAmB,UAAU,OAAO;AAChD,QAAI,IAAI,SAAS;AACf,aAAO,EAAE,OAAO,MAAM,QAAQ,CAAA,EAAC;AAAA,IACjC;AACA,UAAM,SAAS,IAAI,MAAM,OAAO;AAAA,MAC9B,CAAA,MAAK,GAAG,EAAE,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO;AAAA,IAAA;AAExC,SAAK,OAAO,MAAM,qCAAqC,OAAO,KAAK,IAAI,CAAC,EAAE;AAC1E,WAAO,EAAE,OAAO,OAAO,OAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKU,kBAAkB,KAAqB;AAC/C,WAAO,kBAAkB,GAAG;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAmB,SAKtB;AACD,QAAI;AACF,YAAM,OAAO,MAAM,KAAK,WAAW,aAAa,OAAO;AACvD,YAAM,SAAS,eAAe,KAAK,IAAI;AACvC,UAAI,CAAC,QAAQ;AACX,eAAO,EAAE,OAAO,OAAO,OAAO,6BAAA;AAAA,MAChC;AACA,UAAI,OAAO,SAAS,eAAe,OAAO;AACxC,eAAO,EAAE,OAAO,OAAO,OAAO,gCAAA;AAAA,MAChC;AACA,aAAO,EAAE,OAAO,MAAM,MAAM,OAAO,MAAM,KAAK,OAAO,IAAA;AAAA,IACvD,SAAS,GAAY;AACnB,aAAO,EAAE,OAAO,OAAO,OAAO,OAAO,CAAC,EAAA;AAAA,IACxC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBACJ,SACA,SAQA;AACA,UAAM,QAAQ,SAAS,SAAS;AAChC,UAAM,QAAQ,SAAS,SAAS;AAChC,UAAM,QAAQ,MAAM,KAAK,WAAW,iBAAiB,SAAS;AAAA,MAC5D;AAAA,MACA;AAAA,IAAA,CACD;AAMD,UAAM,UAKD,CAAA;AACL,eAAW,KAAK,OAAO;AACrB,UAAI;AACF,YAAI,EAAE,MAAM,YAAY,EAAE,OAAO,cAAc;AAC7C;AAAA,QACF;AACA,cAAM,WAAW;AACjB,cAAM,EAAE,MAAA,IAAU,KAAK,gBAAgB,QAAQ;AAC/C,YAAI,CAAC,OAAO;AACV;AAAA,QACF;AACA,gBAAQ,KAAK;AAAA,UACX,SAAS;AAAA,YACP,GAAG;AAAA,YACH,IAAI;AAAA,YACJ,YAAY,SAAS;AAAA,YACrB,QAAQ,SAAS;AAAA,YACjB,YAAY,SAAS;AAAA,YACrB,OAAO,SAAS;AAAA,YAChB,WAAW,SAAS;AAAA,YACpB,GAAG,SAAS;AAAA,UAAA;AAAA,UAEd,qBAAqB,SAAS;AAAA,UAC9B,iBAAiB,OAAO,SAAS,eAAe;AAAA,UAChD,OAAO,SAAS;AAAA,QAAA,CACjB;AAAA,MACH,SAAS,KAAK;AACZ,aAAK,OAAO,MAAM,mCAAmC,GAAG,EAAE;AAAA,MAC5D;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAiB,SAMrB;AACA,UAAM,QAAQ,MAAM,KAAK,kBAAkB,SAAS;AAAA,MAClD,OAAO;AAAA,MACP,OAAO;AAAA,IAAA,CACR;AACD,QAAI,CAAC,MAAM,QAAQ;AACjB,aAAO;AAAA,IACT;AACA,UAAM,EAAE,SAAS,qBAAqB,gBAAA,IAAoB,MAAM,CAAC;AACjE,WAAO,OAAO,OAAO,CAAA,GAAI,SAAS,EAAE,qBAAqB,iBAAiB;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA,EAKO,0BAA0B,OAA2C;AAC1E,QAAI;AACF,WAAK,OAAO,MAAM,kCAAkC;AAAA,QAClD,WAAW,MAAM;AAAA,QACjB,YAAY,MAAM,OAAO;AAAA,MAAA,CAC1B;AAED,YAAM,eAAe,CAAC,GAAG,MAAM,MAAM,EAAE;AAAA,QAAK,CAAC,GAAG,MAC9C,EAAE,QAAQ,cAAc,EAAE,OAAO;AAAA,MAAA;AAGnC,UAAI,eAAe;AACnB,iBAAW,SAAS,cAAc;AAChC,wBAAgB,MAAM,UAAU,MAAM;AAAA,MACxC;AAEA,UAAI,kBAAkB;AACtB,UAAI,OAAO,MAAM,cAAc,UAAU;AACvC,0BAAkB,MAAM;AAAA,MAC1B,OAAO;AACL,0BAAkB,MAAM,UAAU,SAAA;AAAA,MACpC;AACA,sBAAgB;AAChB,YAAM,OAAO,WAAW,QAAQ;AAChC,WAAK,OAAO,YAAY;AACxB,YAAM,YAAY,KAAK,OAAO,KAAK;AAEnC,WAAK,OAAO,MAAM,iCAAiC;AAAA,QACjD,WAAW,MAAM;AAAA,QACjB;AAAA,MAAA,CACD;AAED,aAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,+BAAe,KAAA;AAAA,QACf,YAAY,MAAM,OAAO;AAAA,MAAA;AAAA,IAE7B,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,0CAA0C,KAAK;AACjE,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,4BACL,OAC0B;AAC1B,QAAI;AACF,WAAK,OAAO,MAAM,oCAAoC;AAAA,QACpD,oBAAoB,MAAM;AAAA,QAC1B,aAAa,MAAM,aAAa;AAAA,QAChC,YAAY,MAAM,gBAAgB;AAAA,MAAA,CACnC;AAED,YAAM,gBAAgB,CAAC,GAAG,MAAM,YAAY,EAAE;AAAA,QAAK,CAAC,GAAG,MACrD,EAAE,UAAU,cAAc,EAAE,SAAS;AAAA,MAAA;AAGvC,YAAM,eAAe,CAAC,GAAG,MAAM,eAAe,EAAE;AAAA,QAAK,CAAC,GAAG,MACvD,EAAE,QAAQ,cAAc,EAAE,OAAO;AAAA,MAAA;AAGnC,UAAI,eAAe;AACnB,iBAAW,UAAU,eAAe;AAClC,wBAAgB,OAAO,YAAY,OAAO;AAAA,MAC5C;AACA,iBAAW,SAAS,cAAc;AAChC,wBAAgB,MAAM,UAAU,MAAM;AAAA,MACxC;AAEA,sBAAgB,MAAM;AACtB,YAAM,OAAO,WAAW,QAAQ;AAChC,WAAK,OAAO,YAAY;AACxB,YAAM,YAAY,KAAK,OAAO,KAAK;AAEnC,WAAK,OAAO,MAAM,mCAAmC;AAAA,QACnD,oBAAoB,MAAM;AAAA,QAC1B;AAAA,MAAA,CACD;AAED,aAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,+BAAe,KAAA;AAAA,QACf,YAAY,MAAM,gBAAgB;AAAA,QAClC,aAAa,MAAM,aAAa;AAAA,QAChC,qBAAqB,MAAM,gBAAgB;AAAA,MAAA;AAAA,IAE/C,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,4CAA4C,KAAK;AACnE,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACvD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,wBAAwB,MAAmB,WAA2B;AAC3E,QAAI;AACF,YAAM,aAAa,CAAC,GAAG,IAAI,EAAE;AAAA,QAAK,CAAC,GAAG,MACpC,EAAE,WAAW,cAAc,EAAE,SAAA,CAAU;AAAA,MAAA;AAEzC,YAAM,UAAU,EAAE,WAAW,MAAM,WAAW,IAAI,CAAA,MAAK,EAAE,SAAA,CAAU,EAAA;AACnE,YAAM,OAAO,WAAW,QAAQ;AAChC,WAAK,OAAO,KAAK,UAAU,OAAO,CAAC;AACnC,aAAO,KAAK,OAAO,KAAK;AAAA,IAC1B,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,uCAAuC,KAAK;AAC9D,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,uBACL,WACA,WACA,UACA,MACkB;AAClB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,IAAI;AAAA,MACJ,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,YAAW,oBAAI,KAAA,GAAO,YAAA;AAAA,MACtB,GAAG;AAAA,IAAA;AAAA,EAEP;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,gBACX,OACA,cACkB;AAClB,QAAI;AACF,UAAI;AACJ,UAAI,eAAe,OAAO;AACxB,yBAAiB,KAAK,0BAA0B,KAAK,EAAE;AAAA,MACzD,OAAO;AACL,yBAAiB,KAAK,4BAA4B,KAAK,EAAE;AAAA,MAC3D;AACA,YAAM,UAAU,mBAAmB;AACnC,YAAM,YACJ,eAAe,QAAQ,MAAM,YAAY,MAAM;AACjD,WAAK,OAAO,MAAM,2BAA2B;AAAA,QAC3C;AAAA,QACA;AAAA,QACA,UAAU;AAAA,QACV,YAAY;AAAA,MAAA,CACb;AACD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,+BAA+B,KAAK;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AACF;"}
+{"version":3,"file":"standards-sdk.es102.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;"}