@hashgraphonline/standards-sdk 0.1.141-canary.4 → 0.1.141-canary.41

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

@@ -1,103 +1,266 @@
-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.es137.js";
-class HCS17Client extends HCS17BaseClient {
+import { HederaMirrorNode } from "./standards-sdk.es127.js";
+import { Logger } from "./standards-sdk.es106.js";
+import { createHash } from "crypto";
+import { hcs17MessageSchema, generateHCS17Memo, parseHCS17Memo, HCS17TopicType } from "./standards-sdk.es96.js";
+class 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.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
     });
-    this.client = this.operatorCtx.client;
   }
-  getKeyType() {
-    return this.operatorCtx.keyType;
+  /**
+   * 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;
   }
   /**
-   * Create an HCS topic intended for HCS‑17 state messages.
+   * Validate an HCS‑17 message against the schema.
    */
-  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");
+  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) };
     }
-    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.
+   * Fetch recent HCS‑17 messages from a topic via Mirror Node.
    */
-  async submitMessage(topicId, message) {
-    const { valid, errors } = this.validateMessage(message);
-    if (!valid) {
-      throw new Error(`Invalid HCS-17 message: ${errors.join(", ")}`);
+  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}`);
+      }
     }
-    const tx = buildHcs17MessageTx({
-      topicId,
-      stateHash: message.state_hash,
-      accountId: message.account_id,
-      topics: message.topics,
-      memo: message.m
+    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"
     });
-    const resp = await tx.execute(this.client);
-    const receipt = await resp.getReceipt(this.client);
-    return receipt;
+    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");
+    }
   }
   /**
-   * Compute current account state hash from topic running hashes and publish it.
+   * Calculate composite state hash for composite accounts (e.g., Flora/Bloom).
    */
-  async computeAndPublish(params) {
-    const topicStates = [];
-    for (const t of params.topics) {
-      const msgs = await this.mirrorNode.getTopicMessages(t, {
-        limit: 1,
-        order: "desc"
+  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
       });
-      const latest = msgs[0];
-      const running = latest?.running_hash || "";
-      topicStates.push({ topicId: t, latestRunningHash: running });
+      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");
     }
-    const input = {
-      accountId: params.accountId,
-      publicKey: params.accountPublicKey,
-      topics: topicStates
+  }
+  /**
+   * 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
     };
-    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 };
+  }
+  /**
+   * 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 {
-  HCS17Client
+  HCS17BaseClient
 };
 //# 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-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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"}
+{"version":3,"file":"standards-sdk.es97.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.es98.js

@@ -1,57 +1,53 @@
-import { HCS17BaseClient } from "./standards-sdk.es96.js";
-import { buildHcs17CreateTopicTx, buildHcs17MessageTx } from "./standards-sdk.es99.js";
-class HCS17BrowserClient extends HCS17BaseClient {
+import { AccountId, Client } from "@hashgraph/sdk";
+import { HCS17BaseClient } from "./standards-sdk.es97.js";
+import { buildHcs17CreateTopicTx, buildHcs17MessageTx } from "./standards-sdk.es100.js";
+import { createNodeOperatorContext } from "./standards-sdk.es137.js";
+class HCS17Client extends HCS17BaseClient {
   constructor(config) {
     super(config);
-    this.hwc = config.hwc;
-    this.signer = config.signer;
-  }
-  ensureConnected() {
-    if (this.signer && typeof this.signer.getAccountId === "function") {
-      return this.signer.getAccountId().toString();
-    }
-    const info = this.hwc?.getAccountInfo?.();
-    const accountId = info?.accountId;
-    if (!accountId) {
-      throw new Error("No active wallet connection");
-    }
-    return accountId;
+    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;
   }
-  getSigner() {
-    if (this.signer) {
-      return this.signer;
-    }
-    this.ensureConnected();
-    const s = this.hwc?.dAppConnector?.signers?.[0];
-    if (!s) {
-      throw new Error("No active wallet signer");
-    }
-    return s;
+  getKeyType() {
+    return this.operatorCtx.keyType;
   }
   /**
-   * Create an HCS‑17 state topic, signing with the connected signer.
+   * Create an HCS topic intended for HCS‑17 state messages.
    */
   async createStateTopic(options) {
-    this.ensureConnected();
-    const signer = this.getSigner();
     const ttl = options?.ttl ?? 86400;
-    const tx = buildHcs17CreateTopicTx({ ttl });
-    const frozen = await tx.freezeWithSigner(signer);
-    const res = await frozen.executeWithSigner(signer);
-    const receipt = await res.getReceiptWithSigner(signer);
-    const topicId = receipt?.topicId?.toString?.() || "";
-    this.logger.info(`Created HCS-17 state topic via wallet: ${topicId}`);
+    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 an HCS‑17 message to a topic, signing with the connected signer.
+   * 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 signer = this.getSigner();
     const tx = buildHcs17MessageTx({
       topicId,
       stateHash: message.state_hash,
@@ -59,17 +55,14 @@ class HCS17BrowserClient extends HCS17BaseClient {
       topics: message.topics,
       memo: message.m
     });
-    const frozen = await tx.freezeWithSigner(signer);
-    const res = await frozen.executeWithSigner(signer);
-    await res.getReceiptWithSigner(signer);
-    return {};
+    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) {
-    this.ensureConnected();
-    const signer = this.getSigner();
     const topicStates = [];
     for (const t of params.topics) {
       const msgs = await this.mirrorNode.getTopicMessages(t, {
@@ -77,7 +70,7 @@ class HCS17BrowserClient extends HCS17BaseClient {
         order: "desc"
       });
       const latest = msgs[0];
-      const running = latest && latest.running_hash || "";
+      const running = latest?.running_hash || "";
       topicStates.push({ topicId: t, latestRunningHash: running });
     }
     const input = {
@@ -86,6 +79,12 @@ class HCS17BrowserClient extends HCS17BaseClient {
       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,
@@ -93,12 +92,12 @@ class HCS17BrowserClient extends HCS17BaseClient {
       topics: params.topics,
       memo: params.memo
     });
-    const frozen = await tx.freezeWithSigner(signer);
-    await frozen.executeWithSigner(signer);
-    return { stateHash: result.stateHash };
+    const resp = await tx.execute(this.client);
+    const receipt = await resp.getReceipt(this.client);
+    return { stateHash: result.stateHash, receipt };
   }
 }
 export {
-  HCS17BrowserClient
+  HCS17Client
 };
 //# sourceMappingURL=standards-sdk.es98.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es98.js","sources":["../../src/hcs-17/browser.ts"],"sourcesContent":["import { HCS17BaseClient } from './base-client';\nimport { BrowserHCS17ClientConfig, StateHashMessage } from './types';\nimport { buildHcs17CreateTopicTx, buildHcs17MessageTx } from './tx';\nimport type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport type { PublicKey } from '@hashgraph/sdk';\n\n/**\n * Browser client for HCS‑17 operations using a DAppSigner.\n * Builds transactions and executes via signer without helper shims.\n */\nexport class HCS17BrowserClient extends HCS17BaseClient {\n  private hwc?: HashinalsWalletConnectSDK;\n  private signer?: DAppSigner;\n\n  constructor(config: BrowserHCS17ClientConfig) {\n    super(config);\n    this.hwc = config.hwc;\n    this.signer = config.signer;\n  }\n\n  private ensureConnected(): string {\n    if (\n      this.signer &&\n      typeof (this.signer as DAppSigner).getAccountId === 'function'\n    ) {\n      return (this.signer as DAppSigner).getAccountId().toString();\n    }\n    const info = this.hwc?.getAccountInfo?.();\n    const accountId = info?.accountId;\n    if (!accountId) {\n      throw new Error('No active wallet connection');\n    }\n    return accountId;\n  }\n\n  private getSigner(): DAppSigner {\n    if (this.signer) {\n      return this.signer;\n    }\n    this.ensureConnected();\n    const s = this.hwc?.dAppConnector?.signers?.[0];\n    if (!s) {\n      throw new Error('No active wallet signer');\n    }\n    return s as unknown as DAppSigner;\n  }\n\n  /**\n   * Create an HCS‑17 state topic, signing with the connected signer.\n   */\n  async createStateTopic(options?: {\n    ttl?: number;\n    adminKey?: boolean | string;\n    submitKey?: boolean | string;\n  }): Promise<string> {\n    this.ensureConnected();\n    const signer = this.getSigner();\n    const ttl = options?.ttl ?? 86400;\n    const tx = buildHcs17CreateTopicTx({ ttl });\n    const frozen = await tx.freezeWithSigner(signer);\n    const res = await frozen.executeWithSigner(signer);\n    const receipt = await res.getReceiptWithSigner(signer);\n    const topicId = receipt?.topicId?.toString?.() || '';\n    this.logger.info(`Created HCS-17 state topic via wallet: ${topicId}`);\n    return topicId;\n  }\n\n  /**\n   * Submit an HCS‑17 message to a topic, signing with the connected signer.\n   */\n  async submitMessage(\n    topicId: string,\n    message: StateHashMessage,\n  ): Promise<{ transactionId?: string }> {\n    const { valid, errors } = this.validateMessage(message);\n    if (!valid) {\n      throw new Error(`Invalid HCS-17 message: ${errors.join(', ')}`);\n    }\n    const signer = this.getSigner();\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 frozen = await tx.freezeWithSigner(signer);\n    const res = await frozen.executeWithSigner(signer);\n    await res.getReceiptWithSigner(signer);\n    return {};\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 }> {\n    this.ensureConnected();\n    const signer = this.getSigner();\n\n    const topicStates: { topicId: string; latestRunningHash: string }[] = [];\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 && (latest as any).running_hash) || '';\n      topicStates.push({ topicId: t, latestRunningHash: running });\n    }\n\n    const input = {\n      accountId: params.accountId,\n      publicKey: params.accountPublicKey,\n      topics: topicStates,\n    };\n    const result = this.calculateAccountStateHash(input);\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 frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n    return { stateHash: result.stateHash };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es98.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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"}