@hashgraphonline/standards-sdk 0.1.136-fix-hol-env.canary.a285980.31 → 0.1.137-feat-hcs-21.canary.5802d65.32

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

@@ -1,37 +1,266 @@
-import { buildHcs18AnnounceMessage, buildHcs18ProposeMessage, buildHcs18RespondMessage, buildHcs18CompleteMessage, buildHcs18WithdrawMessage } from "./standards-sdk.es97.js";
-class HCS18BrowserClient {
+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.hwc = config.hwc;
+    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
+    });
   }
-  async submit(discoveryTopicId, message) {
-    const receipt = await this.hwc.submitMessageToTopic(
-      discoveryTopicId,
-      JSON.stringify(message)
+  /**
+   * 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,
+      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}`
     );
-    return receipt;
+    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,
+            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 });
   }
-  async announce(params) {
-    const message = buildHcs18AnnounceMessage(params.data);
-    return this.submit(params.discoveryTopicId, message);
+  /**
+   * 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");
+    }
   }
-  async propose(params) {
-    const message = buildHcs18ProposeMessage(params.data);
-    return this.submit(params.discoveryTopicId, message);
+  /**
+   * 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");
+    }
   }
-  async respond(params) {
-    const message = buildHcs18RespondMessage(params.data);
-    return this.submit(params.discoveryTopicId, message);
+  /**
+   * 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");
+    }
   }
-  async complete(params) {
-    const message = buildHcs18CompleteMessage(params.data);
-    return this.submit(params.discoveryTopicId, message);
+  /**
+   * 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
+    };
   }
-  async withdraw(params) {
-    const message = buildHcs18WithdrawMessage(params.data);
-    return this.submit(params.discoveryTopicId, message);
+  /**
+   * 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;
+    }
   }
 }
 export {
-  HCS18BrowserClient
+  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-18/browser.ts"],"sourcesContent":["import type { TransactionReceipt } from '@hashgraph/sdk';\nimport { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type {\n  DiscoveryMessage,\n  AnnounceData,\n  ProposeData,\n  RespondData,\n  CompleteMessage,\n  WithdrawMessage,\n} from './types';\nimport {\n  buildHcs18AnnounceMessage,\n  buildHcs18ProposeMessage,\n  buildHcs18RespondMessage,\n  buildHcs18CompleteMessage,\n  buildHcs18WithdrawMessage,\n} from './tx';\n\nexport interface BrowserHCS18ClientConfig {\n  network: 'testnet' | 'mainnet';\n  hwc: HashinalsWalletConnectSDK;\n}\n\nexport class HCS18BrowserClient {\n  private readonly hwc: HashinalsWalletConnectSDK;\n\n  constructor(config: BrowserHCS18ClientConfig) {\n    this.hwc = config.hwc;\n  }\n\n  async submit(\n    discoveryTopicId: string,\n    message: DiscoveryMessage,\n  ): Promise<TransactionReceipt> {\n    const receipt = await this.hwc.submitMessageToTopic(\n      discoveryTopicId,\n      JSON.stringify(message),\n    );\n    return receipt;\n  }\n\n  async announce(params: {\n    discoveryTopicId: string;\n    data: AnnounceData;\n  }): Promise<TransactionReceipt> {\n    const message = buildHcs18AnnounceMessage(params.data);\n    return this.submit(params.discoveryTopicId, message);\n  }\n\n  async propose(params: {\n    discoveryTopicId: string;\n    data: ProposeData;\n  }): Promise<TransactionReceipt> {\n    const message = buildHcs18ProposeMessage(params.data);\n    return this.submit(params.discoveryTopicId, message);\n  }\n\n  async respond(params: {\n    discoveryTopicId: string;\n    data: RespondData;\n  }): Promise<TransactionReceipt> {\n    const message = buildHcs18RespondMessage(params.data);\n    return this.submit(params.discoveryTopicId, message);\n  }\n\n  async complete(params: {\n    discoveryTopicId: string;\n    data: CompleteMessage['data'];\n  }): Promise<TransactionReceipt> {\n    const message = buildHcs18CompleteMessage(params.data);\n    return this.submit(params.discoveryTopicId, message);\n  }\n\n  async withdraw(params: {\n    discoveryTopicId: string;\n    data: WithdrawMessage['data'];\n  }): Promise<TransactionReceipt> {\n    const message = buildHcs18WithdrawMessage(params.data);\n    return this.submit(params.discoveryTopicId, message);\n  }\n}\n"],"names":[],"mappings":";AAuBO,MAAM,mBAAmB;AAAA,EAG9B,YAAY,QAAkC;AAC5C,SAAK,MAAM,OAAO;AAAA,EACpB;AAAA,EAEA,MAAM,OACJ,kBACA,SAC6B;AAC7B,UAAM,UAAU,MAAM,KAAK,IAAI;AAAA,MAC7B;AAAA,MACA,KAAK,UAAU,OAAO;AAAA,IAAA;AAExB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,QAGiB;AAC9B,UAAM,UAAU,0BAA0B,OAAO,IAAI;AACrD,WAAO,KAAK,OAAO,OAAO,kBAAkB,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,QAAQ,QAGkB;AAC9B,UAAM,UAAU,yBAAyB,OAAO,IAAI;AACpD,WAAO,KAAK,OAAO,OAAO,kBAAkB,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,QAAQ,QAGkB;AAC9B,UAAM,UAAU,yBAAyB,OAAO,IAAI;AACpD,WAAO,KAAK,OAAO,OAAO,kBAAkB,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,SAAS,QAGiB;AAC9B,UAAM,UAAU,0BAA0B,OAAO,IAAI;AACrD,WAAO,KAAK,OAAO,OAAO,kBAAkB,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,SAAS,QAGiB;AAC9B,UAAM,UAAU,0BAA0B,OAAO,IAAI;AACrD,WAAO,KAAK,OAAO,OAAO,kBAAkB,OAAO;AAAA,EACrD;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  }): 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      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            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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"}

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

@@ -1,87 +1,103 @@
-import { TopicMessageSubmitTransaction } from "@hashgraph/sdk";
-import { DiscoveryOperation } from "./standards-sdk.es94.js";
-import { buildTopicCreateTx } from "./standards-sdk.es132.js";
-function buildHcs18DiscoveryMemo(ttlSeconds, memoOverride) {
-  if (memoOverride && memoOverride.trim().length > 0) {
-    return memoOverride;
+import { AccountId, Client } from "@hashgraph/sdk";
+import { HCS17BaseClient } from "./standards-sdk.es96.js";
+import { buildHcs17CreateTopicTx, buildHcs17MessageTx } from "./standards-sdk.es99.js";
+import { createNodeOperatorContext } from "./standards-sdk.es135.js";
+class HCS17Client extends HCS17BaseClient {
+  constructor(config) {
+    super(config);
+    this.operatorId = AccountId.fromString(config.operatorId);
+    this.operatorCtx = createNodeOperatorContext({
+      network: this.network,
+      operatorId: this.operatorId,
+      operatorKey: config.operatorKey,
+      keyType: config.keyType,
+      mirrorNode: this.mirrorNode,
+      logger: this.logger,
+      client: config.network === "mainnet" ? Client.forMainnet() : Client.forTestnet()
+    });
+    this.client = this.operatorCtx.client;
   }
-  if (ttlSeconds && ttlSeconds > 0) {
-    return `hcs-18:0:${ttlSeconds}`;
+  getKeyType() {
+    return this.operatorCtx.keyType;
   }
-  return "hcs-18:0";
-}
-function buildHcs18CreateDiscoveryTopicTx(params) {
-  const memo = buildHcs18DiscoveryMemo(params.ttlSeconds, params.memoOverride);
-  return buildTopicCreateTx({
-    memo,
-    adminKey: params.adminKey,
-    submitKey: params.submitKey,
-    operatorPublicKey: params.operatorPublicKey
-  });
-}
-function opCode(op) {
-  switch (op) {
-    case DiscoveryOperation.ANNOUNCE:
-      return 0;
-    case DiscoveryOperation.PROPOSE:
-      return 1;
-    case DiscoveryOperation.RESPOND:
-      return 2;
-    case DiscoveryOperation.COMPLETE:
-      return 3;
-    case DiscoveryOperation.WITHDRAW:
-      return 4;
-    default:
-      return 0;
+  /**
+   * Create an HCS topic intended for HCS‑17 state messages.
+   */
+  async createStateTopic(options) {
+    const ttl = options?.ttl ?? 86400;
+    const tx = buildHcs17CreateTopicTx({
+      ttl,
+      adminKey: options?.adminKey,
+      submitKey: options?.submitKey,
+      operatorPublicKey: this.client.operatorPublicKey || void 0
+    });
+    const resp = await tx.execute(this.client);
+    const receipt = await resp.getReceipt(this.client);
+    if (!receipt.topicId) {
+      throw new Error("Failed to create topic: topicId empty");
+    }
+    const topicId = receipt.topicId.toString();
+    this.logger.info(`Created HCS-17 state topic ${topicId}`);
+    return topicId;
+  }
+  /**
+   * Submit a pre‑built HCS‑17 state hash message to a topic.
+   */
+  async submitMessage(topicId, message) {
+    const { valid, errors } = this.validateMessage(message);
+    if (!valid) {
+      throw new Error(`Invalid HCS-17 message: ${errors.join(", ")}`);
+    }
+    const tx = buildHcs17MessageTx({
+      topicId,
+      stateHash: message.state_hash,
+      accountId: message.account_id,
+      topics: message.topics,
+      memo: message.m
+    });
+    const resp = await tx.execute(this.client);
+    const receipt = await resp.getReceipt(this.client);
+    return receipt;
+  }
+  /**
+   * Compute current account state hash from topic running hashes and publish it.
+   */
+  async computeAndPublish(params) {
+    const topicStates = [];
+    for (const t of params.topics) {
+      const msgs = await this.mirrorNode.getTopicMessages(t, {
+        limit: 1,
+        order: "desc"
+      });
+      const latest = msgs[0];
+      const running = latest?.running_hash || "";
+      topicStates.push({ topicId: t, latestRunningHash: running });
+    }
+    const input = {
+      accountId: params.accountId,
+      publicKey: params.accountPublicKey,
+      topics: topicStates
+    };
+    const result = this.calculateAccountStateHash(input);
+    this.createStateHashMessage(
+      result.stateHash,
+      params.accountId,
+      params.topics,
+      params.memo
+    );
+    const tx = buildHcs17MessageTx({
+      topicId: params.publishTopicId,
+      stateHash: result.stateHash,
+      accountId: params.accountId,
+      topics: params.topics,
+      memo: params.memo
+    });
+    const resp = await tx.execute(this.client);
+    const receipt = await resp.getReceipt(this.client);
+    return { stateHash: result.stateHash, receipt };
   }
-}
-function buildHcs18SubmitDiscoveryMessageTx(params) {
-  const memo = typeof params.transactionMemo === "string" && params.transactionMemo.length > 0 ? params.transactionMemo : `hcs-18:op:${opCode(params.message.op)}`;
-  return new TopicMessageSubmitTransaction().setTopicId(params.topicId).setMessage(JSON.stringify(params.message)).setTransactionMemo(memo);
-}
-function buildHcs18AnnounceMessage(data) {
-  return {
-    p: "hcs-18",
-    op: DiscoveryOperation.ANNOUNCE,
-    data
-  };
-}
-function buildHcs18ProposeMessage(data) {
-  return {
-    p: "hcs-18",
-    op: DiscoveryOperation.PROPOSE,
-    data
-  };
-}
-function buildHcs18RespondMessage(data) {
-  return {
-    p: "hcs-18",
-    op: DiscoveryOperation.RESPOND,
-    data
-  };
-}
-function buildHcs18CompleteMessage(data) {
-  return {
-    p: "hcs-18",
-    op: DiscoveryOperation.COMPLETE,
-    data
-  };
-}
-function buildHcs18WithdrawMessage(data) {
-  return {
-    p: "hcs-18",
-    op: DiscoveryOperation.WITHDRAW,
-    data
-  };
 }
 export {
-  buildHcs18AnnounceMessage,
-  buildHcs18CompleteMessage,
-  buildHcs18CreateDiscoveryTopicTx,
-  buildHcs18DiscoveryMemo,
-  buildHcs18ProposeMessage,
-  buildHcs18RespondMessage,
-  buildHcs18SubmitDiscoveryMessageTx,
-  buildHcs18WithdrawMessage
+  HCS17Client
 };
 //# sourceMappingURL=standards-sdk.es97.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es97.js","sources":["../../src/hcs-18/tx.ts"],"sourcesContent":["import {\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n  PublicKey,\n} from '@hashgraph/sdk';\nimport type {\n  DiscoveryMessage,\n  AnnounceData,\n  ProposeData,\n  RespondData,\n  CompleteMessage,\n  WithdrawMessage,\n  AnnounceMessage,\n  ProposeMessage,\n  RespondMessage,\n} from './types';\nimport { DiscoveryOperation } from './types';\nimport type { MaybeKey } from '../common/tx/tx-utils';\nimport { buildTopicCreateTx } from '../common/tx/tx-utils';\n\nexport function buildHcs18DiscoveryMemo(\n  ttlSeconds?: number,\n  memoOverride?: string,\n): string {\n  if (memoOverride && memoOverride.trim().length > 0) {\n    return memoOverride;\n  }\n  if (ttlSeconds && ttlSeconds > 0) {\n    return `hcs-18:0:${ttlSeconds}`;\n  }\n  return 'hcs-18:0';\n}\n\nexport function buildHcs18CreateDiscoveryTopicTx(params: {\n  ttlSeconds?: number;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n  memoOverride?: string;\n}): TopicCreateTransaction {\n  const memo = buildHcs18DiscoveryMemo(params.ttlSeconds, params.memoOverride);\n  return buildTopicCreateTx({\n    memo,\n    adminKey: params.adminKey,\n    submitKey: params.submitKey,\n    operatorPublicKey: params.operatorPublicKey,\n  });\n}\n\nfunction opCode(op: DiscoveryOperation): number {\n  switch (op) {\n    case DiscoveryOperation.ANNOUNCE:\n      return 0;\n    case DiscoveryOperation.PROPOSE:\n      return 1;\n    case DiscoveryOperation.RESPOND:\n      return 2;\n    case DiscoveryOperation.COMPLETE:\n      return 3;\n    case DiscoveryOperation.WITHDRAW:\n      return 4;\n    default:\n      return 0;\n  }\n}\n\nexport function buildHcs18SubmitDiscoveryMessageTx(params: {\n  topicId: string;\n  message: DiscoveryMessage;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  const memo =\n    typeof params.transactionMemo === 'string' &&\n    params.transactionMemo.length > 0\n      ? params.transactionMemo\n      : `hcs-18:op:${opCode(params.message.op)}`;\n  return new TopicMessageSubmitTransaction()\n    .setTopicId(params.topicId)\n    .setMessage(JSON.stringify(params.message))\n    .setTransactionMemo(memo);\n}\n\nexport function buildHcs18AnnounceMessage(data: AnnounceData): AnnounceMessage {\n  return {\n    p: 'hcs-18',\n    op: DiscoveryOperation.ANNOUNCE,\n    data,\n  } as AnnounceMessage;\n}\n\nexport function buildHcs18ProposeMessage(data: ProposeData): ProposeMessage {\n  return {\n    p: 'hcs-18',\n    op: DiscoveryOperation.PROPOSE,\n    data,\n  } as ProposeMessage;\n}\n\nexport function buildHcs18RespondMessage(data: RespondData): RespondMessage {\n  return {\n    p: 'hcs-18',\n    op: DiscoveryOperation.RESPOND,\n    data,\n  } as RespondMessage;\n}\n\nexport function buildHcs18CompleteMessage(\n  data: CompleteMessage['data'],\n): CompleteMessage {\n  return {\n    p: 'hcs-18',\n    op: DiscoveryOperation.COMPLETE,\n    data,\n  } as CompleteMessage;\n}\n\nexport function buildHcs18WithdrawMessage(\n  data: WithdrawMessage['data'],\n): WithdrawMessage {\n  return {\n    p: 'hcs-18',\n    op: DiscoveryOperation.WITHDRAW,\n    data,\n  } as WithdrawMessage;\n}\n"],"names":[],"mappings":";;;AAoBO,SAAS,wBACd,YACA,cACQ;AACR,MAAI,gBAAgB,aAAa,KAAA,EAAO,SAAS,GAAG;AAClD,WAAO;AAAA,EACT;AACA,MAAI,cAAc,aAAa,GAAG;AAChC,WAAO,YAAY,UAAU;AAAA,EAC/B;AACA,SAAO;AACT;AAEO,SAAS,iCAAiC,QAMtB;AACzB,QAAM,OAAO,wBAAwB,OAAO,YAAY,OAAO,YAAY;AAC3E,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,mBAAmB,OAAO;AAAA,EAAA,CAC3B;AACH;AAEA,SAAS,OAAO,IAAgC;AAC9C,UAAQ,IAAA;AAAA,IACN,KAAK,mBAAmB;AACtB,aAAO;AAAA,IACT,KAAK,mBAAmB;AACtB,aAAO;AAAA,IACT,KAAK,mBAAmB;AACtB,aAAO;AAAA,IACT,KAAK,mBAAmB;AACtB,aAAO;AAAA,IACT,KAAK,mBAAmB;AACtB,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAEO,SAAS,mCAAmC,QAIjB;AAChC,QAAM,OACJ,OAAO,OAAO,oBAAoB,YAClC,OAAO,gBAAgB,SAAS,IAC5B,OAAO,kBACP,aAAa,OAAO,OAAO,QAAQ,EAAE,CAAC;AAC5C,SAAO,IAAI,8BAAA,EACR,WAAW,OAAO,OAAO,EACzB,WAAW,KAAK,UAAU,OAAO,OAAO,CAAC,EACzC,mBAAmB,IAAI;AAC5B;AAEO,SAAS,0BAA0B,MAAqC;AAC7E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,mBAAmB;AAAA,IACvB;AAAA,EAAA;AAEJ;AAEO,SAAS,yBAAyB,MAAmC;AAC1E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,mBAAmB;AAAA,IACvB;AAAA,EAAA;AAEJ;AAEO,SAAS,yBAAyB,MAAmC;AAC1E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,mBAAmB;AAAA,IACvB;AAAA,EAAA;AAEJ;AAEO,SAAS,0BACd,MACiB;AACjB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,mBAAmB;AAAA,IACvB;AAAA,EAAA;AAEJ;AAEO,SAAS,0BACd,MACiB;AACjB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,mBAAmB;AAAA,IACvB;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"standards-sdk.es97.js","sources":["../../src/hcs-17/sdk.ts"],"sourcesContent":["import {\n  Client,\n  PublicKey,\n  KeyList,\n  TransactionReceipt,\n  AccountId,\n} from '@hashgraph/sdk';\nimport { HCS17BaseClient } from './base-client';\nimport {\n  SDKHCS17ClientConfig,\n  StateHashMessage,\n  TopicState,\n  AccountStateInput,\n} from './types';\nimport { buildHcs17CreateTopicTx, buildHcs17MessageTx } from './tx';\nimport {\n  createNodeOperatorContext,\n  type NodeOperatorContext,\n} from '../common/node-operator-resolver';\n\n/**\n * Node SDK client for HCS‑17 operations.\n * Creates topics, submits messages, and can compute + publish state hashes.\n */\nexport class HCS17Client extends HCS17BaseClient {\n  private client: Client;\n  private operatorId: AccountId;\n  private operatorCtx: NodeOperatorContext;\n\n  constructor(config: SDKHCS17ClientConfig) {\n    super(config);\n    this.operatorId = AccountId.fromString(config.operatorId);\n    this.operatorCtx = createNodeOperatorContext({\n      network: this.network,\n      operatorId: this.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client:\n        config.network === 'mainnet'\n          ? Client.forMainnet()\n          : Client.forTestnet(),\n    });\n    this.client = this.operatorCtx.client;\n  }\n\n  public getKeyType(): 'ed25519' | 'ecdsa' {\n    return this.operatorCtx.keyType;\n  }\n\n  /**\n   * Create an HCS topic intended for HCS‑17 state messages.\n   */\n  async createStateTopic(options?: {\n    ttl?: number;\n    adminKey?: boolean | string | PublicKey | KeyList;\n    submitKey?: boolean | string | PublicKey | KeyList;\n  }): Promise<string> {\n    const ttl = options?.ttl ?? 86400;\n    const tx = buildHcs17CreateTopicTx({\n      ttl,\n      adminKey: options?.adminKey,\n      submitKey: options?.submitKey,\n      operatorPublicKey: this.client.operatorPublicKey || undefined,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    if (!receipt.topicId) {\n      throw new Error('Failed to create topic: topicId empty');\n    }\n    const topicId = receipt.topicId.toString();\n    this.logger.info(`Created HCS-17 state topic ${topicId}`);\n    return topicId;\n  }\n\n  /**\n   * Submit a pre‑built HCS‑17 state hash message to a topic.\n   */\n  async submitMessage(\n    topicId: string,\n    message: StateHashMessage,\n  ): Promise<TransactionReceipt> {\n    const { valid, errors } = this.validateMessage(message);\n    if (!valid) {\n      throw new Error(`Invalid HCS-17 message: ${errors.join(', ')}`);\n    }\n    const tx = buildHcs17MessageTx({\n      topicId,\n      stateHash: message.state_hash,\n      accountId: message.account_id,\n      topics: message.topics,\n      memo: message.m,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    return receipt;\n  }\n\n  /**\n   * Compute current account state hash from topic running hashes and publish it.\n   */\n  async computeAndPublish(params: {\n    accountId: string;\n    accountPublicKey: string | PublicKey;\n    topics: string[];\n    publishTopicId: string;\n    memo?: string;\n  }): Promise<{ stateHash: string; receipt: TransactionReceipt }> {\n    const topicStates: TopicState[] = [];\n    for (const t of params.topics) {\n      const msgs = await this.mirrorNode.getTopicMessages(t, {\n        limit: 1,\n        order: 'desc',\n      });\n      const latest = msgs[0];\n      const running = latest?.running_hash || '';\n      topicStates.push({ topicId: t, latestRunningHash: running });\n    }\n\n    const input: AccountStateInput = {\n      accountId: params.accountId,\n      publicKey: params.accountPublicKey,\n      topics: topicStates,\n    };\n    const result = this.calculateAccountStateHash(input);\n    const message: StateHashMessage = this.createStateHashMessage(\n      result.stateHash,\n      params.accountId,\n      params.topics,\n      params.memo,\n    );\n    const tx = buildHcs17MessageTx({\n      topicId: params.publishTopicId,\n      stateHash: result.stateHash,\n      accountId: params.accountId,\n      topics: params.topics,\n      memo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    return { stateHash: result.stateHash, receipt };\n  }\n}\n"],"names":[],"mappings":"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"}