@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.es98.js

@@ -1,34 +1,104 @@
-import { Logger } from "./standards-sdk.es99.js";
-import { HederaMirrorNode } from "./standards-sdk.es120.js";
-class HCS18BaseClient {
+import { HCS17BaseClient } from "./standards-sdk.es96.js";
+import { buildHcs17CreateTopicTx, buildHcs17MessageTx } from "./standards-sdk.es99.js";
+class HCS17BrowserClient extends HCS17BaseClient {
   constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger || Logger.getInstance({ module: "HCS-18" });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
+    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;
+  }
+  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;
   }
   /**
-   * Retrieves HCS-18 discovery messages from a topic, filtered to valid operations.
+   * Create an HCS‑17 state topic, signing with the connected signer.
    */
-  async getDiscoveryMessages(topicId, options) {
-    const validOps = ["announce", "propose", "respond", "complete", "withdraw"];
-    const messages = await this.mirrorNode.getTopicMessages(topicId, options);
-    if (!messages) {
-      return [];
+  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}`);
+    return topicId;
+  }
+  /**
+   * Submit an HCS‑17 message to a topic, signing with the connected signer.
+   */
+  async submitMessage(topicId, message) {
+    const { valid, errors } = this.validateMessage(message);
+    if (!valid) {
+      throw new Error(`Invalid HCS-17 message: ${errors.join(", ")}`);
     }
-    return messages.filter((m) => m.p === "hcs-18" && validOps.includes(m.op));
+    const signer = this.getSigner();
+    const tx = buildHcs17MessageTx({
+      topicId,
+      stateHash: message.state_hash,
+      accountId: message.account_id,
+      topics: message.topics,
+      memo: message.m
+    });
+    const frozen = await tx.freezeWithSigner(signer);
+    const res = await frozen.executeWithSigner(signer);
+    await res.getReceiptWithSigner(signer);
+    return {};
   }
   /**
-   * Determines if a proposal has sufficient acceptances to proceed.
+   * Compute current account state hash from topic running hashes and publish it.
    */
-  isProposalReady(proposal) {
-    const acceptances = Array.from(proposal.responses.values()).filter(
-      (r) => r.decision === "accept"
-    );
-    const requiredResponses = proposal.data.members.length - 1;
-    return acceptances.length >= requiredResponses;
+  async computeAndPublish(params) {
+    this.ensureConnected();
+    const signer = this.getSigner();
+    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 && latest.running_hash || "";
+      topicStates.push({ topicId: t, latestRunningHash: running });
+    }
+    const input = {
+      accountId: params.accountId,
+      publicKey: params.accountPublicKey,
+      topics: topicStates
+    };
+    const result = this.calculateAccountStateHash(input);
+    const tx = buildHcs17MessageTx({
+      topicId: params.publishTopicId,
+      stateHash: result.stateHash,
+      accountId: params.accountId,
+      topics: params.topics,
+      memo: params.memo
+    });
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
+    return { stateHash: result.stateHash };
   }
 }
 export {
-  HCS18BaseClient
+  HCS17BrowserClient
 };
 //# 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-18/base-client.ts"],"sourcesContent":["import { Logger, type ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport type { NetworkType } from '../utils/types';\nimport type { HCSMessageWithCommonFields } from '../services/types';\nimport type { TrackedProposal } from './types';\n\nexport interface HCS18BaseConfig {\n  network: NetworkType;\n  logger?: ILogger;\n}\n\nexport abstract class HCS18BaseClient {\n  protected readonly logger: ILogger;\n  public readonly mirrorNode: HederaMirrorNode;\n  public readonly network: NetworkType;\n\n  constructor(config: HCS18BaseConfig) {\n    this.network = config.network;\n    this.logger = config.logger || Logger.getInstance({ module: 'HCS-18' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);\n  }\n\n  /**\n   * Retrieves HCS-18 discovery messages from a topic, filtered to valid operations.\n   */\n  public async getDiscoveryMessages(\n    topicId: string,\n    options?: {\n      sequenceNumber?: string | number;\n      limit?: number;\n      order?: 'asc' | 'desc';\n    },\n  ): Promise<HCSMessageWithCommonFields[]> {\n    const validOps = ['announce', 'propose', 'respond', 'complete', 'withdraw'];\n    const messages = await this.mirrorNode.getTopicMessages(topicId, options);\n    if (!messages) {\n      return [];\n    }\n    return messages.filter(m => m.p === 'hcs-18' && validOps.includes(m.op));\n  }\n\n  /**\n   * Determines if a proposal has sufficient acceptances to proceed.\n   */\n  public isProposalReady(proposal: TrackedProposal): boolean {\n    const acceptances = Array.from(proposal.responses.values()).filter(\n      r => r.decision === 'accept',\n    );\n    const requiredResponses = proposal.data.members.length - 1;\n    return acceptances.length >= requiredResponses;\n  }\n}\n"],"names":[],"mappings":";;AAWO,MAAe,gBAAgB;AAAA,EAKpC,YAAY,QAAyB;AACnC,SAAK,UAAU,OAAO;AACtB,SAAK,SAAS,OAAO,UAAU,OAAO,YAAY,EAAE,QAAQ,UAAU;AACtE,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,MAAM;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,qBACX,SACA,SAKuC;AACvC,UAAM,WAAW,CAAC,YAAY,WAAW,WAAW,YAAY,UAAU;AAC1E,UAAM,WAAW,MAAM,KAAK,WAAW,iBAAiB,SAAS,OAAO;AACxE,QAAI,CAAC,UAAU;AACb,aAAO,CAAA;AAAA,IACT;AACA,WAAO,SAAS,OAAO,CAAA,MAAK,EAAE,MAAM,YAAY,SAAS,SAAS,EAAE,EAAE,CAAC;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA,EAKO,gBAAgB,UAAoC;AACzD,UAAM,cAAc,MAAM,KAAK,SAAS,UAAU,OAAA,CAAQ,EAAE;AAAA,MAC1D,CAAA,MAAK,EAAE,aAAa;AAAA,IAAA;AAEtB,UAAM,oBAAoB,SAAS,KAAK,QAAQ,SAAS;AACzD,WAAO,YAAY,UAAU;AAAA,EAC/B;AACF;"}
+{"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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"}

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

@@ -1,145 +1,32 @@
-import { inspect } from "util";
-let loggerFactory = null;
-function setLoggerFactory(factory) {
-  loggerFactory = factory;
-  Logger.clearInstances();
+import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es136.js";
+import { generateHCS17Memo } from "./standards-sdk.es95.js";
+function buildHcs17CreateTopicTx(params) {
+  const memo = generateHCS17Memo(params.ttl);
+  return buildTopicCreateTx({
+    memo,
+    adminKey: params.adminKey,
+    submitKey: params.submitKey,
+    operatorPublicKey: params.operatorPublicKey
+  });
+}
+function buildHcs17MessageTx(params) {
+  const payload = {
+    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 buildMessageTx({
+    topicId: params.topicId,
+    message: JSON.stringify(payload),
+    transactionMemo: params.transactionMemo
+  });
 }
-const _Logger = class _Logger {
-  constructor(options = {}) {
-    if (loggerFactory) {
-      return loggerFactory(options);
-    }
-    const globalDisable = typeof process !== "undefined" && process.env?.DISABLE_LOGS === "true";
-    this.silent = options.silent || globalDisable;
-    this.level = this.silent ? "silent" : options.level || "info";
-    this.moduleContext = options.module || "app";
-    this.prettyPrint = !this.silent && options.prettyPrint !== false;
-  }
-  static getInstance(options = {}) {
-    const moduleKey = options.module || "default";
-    const globalDisable = typeof process !== "undefined" && process.env?.DISABLE_LOGS === "true";
-    if (globalDisable && _Logger.instances.has(moduleKey)) {
-      const existingLogger = _Logger.instances.get(moduleKey);
-      if (existingLogger.getLevel() !== "silent") {
-        _Logger.instances.delete(moduleKey);
-      }
-    }
-    if (!_Logger.instances.has(moduleKey)) {
-      const logger = loggerFactory ? loggerFactory(options) : new _Logger(options);
-      _Logger.instances.set(moduleKey, logger);
-    }
-    return _Logger.instances.get(moduleKey);
-  }
-  setLogLevel(level) {
-    this.level = level;
-  }
-  getLevel() {
-    return this.level;
-  }
-  setSilent(silent) {
-    this.silent = silent;
-    if (silent) {
-      this.level = "silent";
-    }
-  }
-  setModule(module) {
-    this.moduleContext = module;
-  }
-  formatArgs(args) {
-    if (args.length === 0) {
-      return { msg: "" };
-    }
-    if (args.length === 1) {
-      if (typeof args[0] === "string") {
-        return { msg: args[0] };
-      }
-      return { msg: "", data: args[0] };
-    }
-    const stringArgs = [];
-    const objectArgs = [];
-    args.forEach((arg) => {
-      if (typeof arg === "string" || typeof arg === "number" || typeof arg === "boolean") {
-        stringArgs.push(String(arg));
-      } else {
-        objectArgs.push(arg);
-      }
-    });
-    const msg = stringArgs.join(" ");
-    return objectArgs.length > 0 ? { msg, data: objectArgs } : { msg };
-  }
-  shouldLog(level) {
-    if (this.silent || this.level === "silent") {
-      return false;
-    }
-    const levels = ["trace", "debug", "info", "warn", "error", "silent"];
-    const currentLevelIndex = levels.indexOf(this.level);
-    const targetLevelIndex = levels.indexOf(level);
-    return targetLevelIndex >= currentLevelIndex;
-  }
-  getConsoleMethod(level) {
-    if (level === "error") {
-      return console.error;
-    }
-    if (level === "warn") {
-      return console.warn;
-    }
-    if (level === "debug") {
-      return console.debug;
-    }
-    return console.log;
-  }
-  writeLog(level, ...args) {
-    if (!this.shouldLog(level)) {
-      return;
-    }
-    const { msg, data } = this.formatArgs(args);
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    const consoleMethod = this.getConsoleMethod(level);
-    if (this.prettyPrint) {
-      const levelFormatted = level.toUpperCase().padEnd(5);
-      let output = `${timestamp} ${levelFormatted} [${this.moduleContext}] ${msg}`;
-      if (data) {
-        output += "\n" + inspect(data, { colors: true, depth: 3 });
-      }
-      consoleMethod(output);
-    } else {
-      const logObj = {
-        timestamp,
-        level,
-        module: this.moduleContext,
-        message: msg,
-        ...data && { data }
-      };
-      consoleMethod(JSON.stringify(logObj));
-    }
-  }
-  debug(...args) {
-    this.writeLog("debug", ...args);
-  }
-  info(...args) {
-    this.writeLog("info", ...args);
-  }
-  warn(...args) {
-    this.writeLog("warn", ...args);
-  }
-  error(...args) {
-    this.writeLog("error", ...args);
-  }
-  trace(...args) {
-    this.writeLog("trace", ...args);
-  }
-  /**
-   * Clear all logger instances
-   * Used when switching logger implementations
-   */
-  static clearInstances() {
-    _Logger.instances.clear();
-  }
-};
-_Logger.instances = /* @__PURE__ */ new Map();
-let Logger = _Logger;
 export {
-  Logger,
-  setLoggerFactory
+  buildHcs17CreateTopicTx,
+  buildHcs17MessageTx
 };
 //# sourceMappingURL=standards-sdk.es99.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es99.js","sources":["../../src/utils/logger.ts"],"sourcesContent":["import { inspect } from 'util';\n\nexport type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nexport interface LoggerOptions {\n  level?: LogLevel;\n  module?: string;\n  prettyPrint?: boolean;\n  silent?: boolean;\n}\n\nexport interface ILogger {\n  debug(...args: any[]): void;\n  info(...args: any[]): void;\n  warn(...args: any[]): void;\n  error(...args: any[]): void;\n  trace(...args: any[]): void;\n  setLogLevel(level: LogLevel): void;\n  getLevel(): LogLevel;\n  setSilent(silent: boolean): void;\n  setModule(module: string): void;\n}\n\nexport type LoggerFactory = (options: LoggerOptions) => ILogger;\n\nlet loggerFactory: LoggerFactory | null = null;\n\n/**\n * Set a custom logger factory to override the default Pino-based implementation\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  loggerFactory = factory;\n  Logger.clearInstances();\n}\n\nexport class Logger implements ILogger {\n  private static instances: Map<string, ILogger> = new Map();\n  private level: LogLevel;\n  private moduleContext: string;\n  private silent: boolean;\n  private prettyPrint: boolean;\n\n  constructor(options: LoggerOptions = {}) {\n    if (loggerFactory) {\n      return loggerFactory(options) as any;\n    }\n\n    const globalDisable =\n      typeof process !== 'undefined' && process.env?.DISABLE_LOGS === 'true';\n\n    this.silent = options.silent || globalDisable;\n    this.level = this.silent ? 'silent' : options.level || 'info';\n    this.moduleContext = options.module || 'app';\n    this.prettyPrint = !this.silent && options.prettyPrint !== false;\n  }\n\n  static getInstance(options: LoggerOptions = {}): ILogger {\n    const moduleKey = options.module || 'default';\n\n    const globalDisable =\n      typeof process !== 'undefined' && process.env?.DISABLE_LOGS === 'true';\n\n    if (globalDisable && Logger.instances.has(moduleKey)) {\n      const existingLogger = Logger.instances.get(moduleKey)!;\n      if (existingLogger.getLevel() !== 'silent') {\n        Logger.instances.delete(moduleKey);\n      }\n    }\n\n    if (!Logger.instances.has(moduleKey)) {\n      const logger = loggerFactory\n        ? loggerFactory(options)\n        : new Logger(options);\n      Logger.instances.set(moduleKey, logger);\n    }\n\n    return Logger.instances.get(moduleKey)!;\n  }\n\n  setLogLevel(level: LogLevel): void {\n    this.level = level;\n  }\n\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  setSilent(silent: boolean): void {\n    this.silent = silent;\n    if (silent) {\n      this.level = 'silent';\n    }\n  }\n\n  setModule(module: string): void {\n    this.moduleContext = module;\n  }\n\n  private formatArgs(args: any[]): { msg: string; data?: any } {\n    if (args.length === 0) {\n      return { msg: '' };\n    }\n\n    if (args.length === 1) {\n      if (typeof args[0] === 'string') {\n        return { msg: args[0] };\n      }\n      return { msg: '', data: args[0] };\n    }\n\n    const stringArgs: string[] = [];\n    const objectArgs: any[] = [];\n\n    args.forEach(arg => {\n      if (\n        typeof arg === 'string' ||\n        typeof arg === 'number' ||\n        typeof arg === 'boolean'\n      ) {\n        stringArgs.push(String(arg));\n      } else {\n        objectArgs.push(arg);\n      }\n    });\n\n    const msg = stringArgs.join(' ');\n    return objectArgs.length > 0 ? { msg, data: objectArgs } : { msg };\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    if (this.silent || this.level === 'silent') {\n      return false;\n    }\n\n    const levels = ['trace', 'debug', 'info', 'warn', 'error', 'silent'];\n    const currentLevelIndex = levels.indexOf(this.level);\n    const targetLevelIndex = levels.indexOf(level);\n\n    return targetLevelIndex >= currentLevelIndex;\n  }\n\n  private getConsoleMethod(level: LogLevel): (...args: any[]) => void {\n    if (level === 'error') {\n      return console.error;\n    }\n    if (level === 'warn') {\n      return console.warn;\n    }\n    if (level === 'debug') {\n      return console.debug;\n    }\n    return console.log;\n  }\n\n  private writeLog(level: LogLevel, ...args: any[]): void {\n    if (!this.shouldLog(level)) {\n      return;\n    }\n\n    const { msg, data } = this.formatArgs(args);\n    const timestamp = new Date().toISOString();\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (this.prettyPrint) {\n      const levelFormatted = level.toUpperCase().padEnd(5);\n      let output = `${timestamp} ${levelFormatted} [${this.moduleContext}] ${msg}`;\n\n      if (data) {\n        output += '\\n' + inspect(data, { colors: true, depth: 3 });\n      }\n\n      consoleMethod(output);\n    } else {\n      const logObj = {\n        timestamp,\n        level,\n        module: this.moduleContext,\n        message: msg,\n        ...(data && { data }),\n      };\n\n      consoleMethod(JSON.stringify(logObj));\n    }\n  }\n\n  debug(...args: any[]): void {\n    this.writeLog('debug', ...args);\n  }\n\n  info(...args: any[]): void {\n    this.writeLog('info', ...args);\n  }\n\n  warn(...args: any[]): void {\n    this.writeLog('warn', ...args);\n  }\n\n  error(...args: any[]): void {\n    this.writeLog('error', ...args);\n  }\n\n  trace(...args: any[]): void {\n    this.writeLog('trace', ...args);\n  }\n\n  /**\n   * Clear all logger instances\n   * Used when switching logger implementations\n   */\n  static clearInstances(): void {\n    Logger.instances.clear();\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es99.js","sources":["../../src/hcs-17/tx.ts"],"sourcesContent":["import {\n  PublicKey,\n  KeyList,\n  TopicMessageSubmitTransaction,\n  TopicCreateTransaction,\n} from '@hashgraph/sdk';\nimport { buildTopicCreateTx, buildMessageTx } from '../common/tx/tx-utils';\nimport { generateHCS17Memo, StateHashMessage } from './types';\n\n/**\n * Build a TopicCreateTransaction for HCS‑17 state topics.\n */\nexport function buildHcs17CreateTopicTx(params: {\n  ttl: number;\n  adminKey?: boolean | string | PublicKey | KeyList;\n  submitKey?: boolean | string | PublicKey | KeyList;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const memo = generateHCS17Memo(params.ttl);\n  return buildTopicCreateTx({\n    memo,\n    adminKey: params.adminKey,\n    submitKey: params.submitKey,\n    operatorPublicKey: params.operatorPublicKey,\n  });\n}\n\n/**\n * Build a TopicMessageSubmitTransaction for HCS‑17 messages.\n */\n/**\n * Build a TopicMessageSubmitTransaction for HCS‑17 messages.\n */\nexport function buildHcs17MessageTx(params: {\n  topicId: string;\n  stateHash: string;\n  accountId: string;\n  topics: string[];\n  memo?: string;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: 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 buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(payload),\n    transactionMemo: params.transactionMemo,\n  });\n}\n"],"names":[],"mappings":";;AAYO,SAAS,wBAAwB,QAKb;AACzB,QAAM,OAAO,kBAAkB,OAAO,GAAG;AACzC,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,mBAAmB,OAAO;AAAA,EAAA,CAC3B;AACH;AAQO,SAAS,oBAAoB,QAOF;AAChC,QAAM,UAA4B;AAAA,IAChC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,YAAY,OAAO;AAAA,IACnB,QAAQ,OAAO;AAAA,IACf,YAAY,OAAO;AAAA,IACnB,YAAW,oBAAI,KAAA,GAAO,YAAA;AAAA,IACtB,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,IAC/B,iBAAiB,OAAO;AAAA,EAAA,CACzB;AACH;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-sdk",
-  "version": "0.1.136-fix-hol-env.canary.a285980.31",
+  "version": "0.1.137-feat-hcs-21.canary.5802d65.32",
   "description": "The Hashgraph Online Standards SDK provides a complete implementation of the Hashgraph Consensus Standards (HCS), giving developers all the tools needed to build applications on Hedera.",
   "type": "module",
   "files": [
@@ -85,6 +85,7 @@
     "demo:hcs-20:deploy-and-mint": "tsx demo/hcs-20/deploy-and-mint.ts",
     "demo:hcs-20:deploy-points": "tsx demo/hcs-20/deploy-points.ts",
     "demo:hcs-20:mint-transfer-burn": "tsx demo/hcs-20/mint-transfer-burn.ts",
+    "demo:hcs-21": "tsx demo/hcs-21/adapter-declaration-demo.ts",
     "demo:hcs-6:browser": "pnpm run build && pnpm --dir demo/hcs-6/browser i && pnpm --dir demo/hcs-6/browser dev",
     "demo:hcs-5": "tsx demo/hcs-5/mint-hashinal.ts",
     "demo:registry-broker": "tsx demo/registry-broker/registry-broker-demo.ts",