@hashgraphonline/standards-sdk 0.1.141-canary.8 → 0.1.141-feat-hcs-21-flora-adapter.canary.cff94ea.45

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

@@ -1,143 +1,160 @@
-import { HederaMirrorNode } from "./standards-sdk.es126.js";
-import { KeyList } from "@hashgraph/sdk";
-import { buildHcs16CreateFloraTopicTx } from "./standards-sdk.es91.js";
-import { Logger } from "./standards-sdk.es105.js";
-import { FloraTopicType } from "./standards-sdk.es90.js";
-class HCS16BaseClient {
-  constructor(params) {
-    this.network = params.network;
-    this.logger = params.logger || new Logger({ level: "info", module: "HCS-16" });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {
-      customUrl: params.mirrorNodeUrl
-    });
+import { ScheduleSignTransaction } from "@hashgraph/sdk";
+import { buildHcs16CreateFloraTopicTx, buildHcs16FloraCreatedTx, buildHcs16TransactionTx, buildHcs16StateUpdateTx, buildHcs16CreateAccountTx, buildHcs16FloraJoinRequestTx, buildHcs16FloraJoinVoteTx, buildHcs16FloraJoinAcceptedTx } from "./standards-sdk.es92.js";
+import { HCS16BaseClient } from "./standards-sdk.es95.js";
+class HCS16BrowserClient extends HCS16BaseClient {
+  constructor(config) {
+    super({ network: config.network });
+    this.hwc = config.hwc;
+    this.signer = config.signer;
   }
-  async assembleKeyList(params) {
-    const keys = [];
-    for (const accountId of params.members) {
-      const pub = await this.mirrorNode.getPublicKey(accountId);
-      keys.push(pub);
+  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 new KeyList(keys, params.threshold);
+    return accountId;
   }
-  async assembleSubmitKeyList(members) {
-    const keys = [];
-    for (const accountId of members) {
-      const pub = await this.mirrorNode.getPublicKey(accountId);
-      keys.push(pub);
+  getSigner() {
+    if (this.signer) {
+      return this.signer;
     }
-    return new KeyList(keys, 1);
+    this.ensureConnected();
+    const s = this.hwc?.dAppConnector?.signers?.[0];
+    if (!s) {
+      throw new Error("No active wallet signer");
+    }
+    return s;
   }
-  buildFloraTopicCreateTxs(params) {
-    const communication = buildHcs16CreateFloraTopicTx({
-      floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.COMMUNICATION,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
-      autoRenewAccountId: params.autoRenewAccountId
-    });
-    const transaction = buildHcs16CreateFloraTopicTx({
+  async createFloraTopic(params) {
+    this.ensureConnected();
+    const signer = this.getSigner();
+    const tx = buildHcs16CreateFloraTopicTx({
       floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.TRANSACTION,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
+      topicType: params.topicType,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
       autoRenewAccountId: params.autoRenewAccountId
     });
-    const state = buildHcs16CreateFloraTopicTx({
-      floraAccountId: params.floraAccountId,
-      topicType: FloraTopicType.STATE,
-      adminKey: params.keyList,
-      submitKey: params.submitList,
-      autoRenewAccountId: params.autoRenewAccountId
-    });
-    return { communication, transaction, state };
+    const frozen = await tx.freezeWithSigner(signer);
+    const res = await frozen.executeWithSigner(signer);
+    const receipt = await res.getReceiptWithSigner(signer);
+    const topicId = receipt?.topicId?.toString?.() || "";
+    return topicId;
   }
-  /**
-   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.
-   */
-  parseTopicMemo(memo) {
-    const match = memo.match(/^hcs-16:([0-9.]+):(\d)$/);
-    if (!match) {
-      return null;
-    }
-    return {
-      protocol: "hcs-16",
-      floraAccountId: match[1],
-      topicType: Number(match[2])
-    };
+  async sendFloraCreated(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16FloraCreatedTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
   }
-  /**
-   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.
-   */
-  createFloraMessage(op, operatorId, body) {
-    const payload = {
-      p: "hcs-16",
-      op,
-      operator_id: operatorId,
-      ...body || {}
-    };
-    return payload;
+  async sendTransaction(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16TransactionTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
   }
   /**
-   * Fetch recent HCS‑16 messages from a topic via Mirror Node.
+   * Wallet-signed ScheduleSign for a given scheduleId.
    */
-  async getRecentMessages(topicId, options) {
-    const limit = options?.limit ?? 25;
-    const order = options?.order ?? "desc";
-    const items = await this.mirrorNode.getTopicMessages(topicId, { limit, order });
-    const results = [];
-    for (const raw of items) {
-      if (raw.p !== "hcs-16") {
-        continue;
-      }
-      const {
-        consensus_timestamp,
-        sequence_number,
-        running_hash,
-        running_hash_version,
-        topic_id,
-        payer,
-        created,
-        chunk_info,
-        ...payload
-      } = raw;
-      const op = payload.op;
-      const operatorId = payload.operator_id;
-      if (options?.opFilter && op !== options.opFilter) {
-        continue;
-      }
-      if (typeof operatorId !== "string") {
-        continue;
-      }
-      const message = payload;
-      results.push({
-        message,
-        consensus_timestamp,
-        sequence_number: Number(sequence_number),
-        payer
-      });
-    }
-    return results;
+  async signSchedule(params) {
+    const signer = this.getSigner();
+    const tx = await new ScheduleSignTransaction().setScheduleId(params.scheduleId).freezeWithSigner(signer);
+    await tx.executeWithSigner(signer);
   }
+  async sendStateUpdate(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16StateUpdateTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
+  }
+  /** credit_purchase is not part of HCS-16 specification */
   /**
-   * Return the latest valid HCS‑16 message on a topic, if any.
+   * Create Flora account and C/T/S topics using DAppSigner.
+   * - Account KeyList = threshold of members
+   * - Topic submitKey = 1-of-M KeyList of members
+   * Returns created Flora account ID and topic IDs.
    */
-  async getLatestMessage(topicId, opFilter) {
-    const items = await this.getRecentMessages(topicId, {
-      limit: 1,
-      order: "desc",
-      opFilter
+  async createFloraAccountWithTopics(params) {
+    const signer = this.getSigner();
+    const keyList = await this.assembleKeyList({
+      members: params.members,
+      threshold: params.threshold
+    });
+    const submitList = await this.assembleSubmitKeyList(params.members);
+    const createAcc = buildHcs16CreateAccountTx({
+      keyList,
+      initialBalanceHbar: typeof params.initialBalanceHbar === "number" ? params.initialBalanceHbar : 5,
+      maxAutomaticTokenAssociations: -1
     });
-    if (items.length === 0) {
-      return null;
+    const accFrozen = await createAcc.freezeWithSigner(signer);
+    const accExec = await accFrozen.executeWithSigner(signer);
+    const accReceipt = await accExec.getReceiptWithSigner(signer);
+    const floraAccountId = accReceipt?.accountId?.toString?.();
+    if (!floraAccountId) {
+      throw new Error("Failed to create Flora account");
     }
-    const first = items[0];
-    return Object.assign({}, first.message, {
-      consensus_timestamp: first.consensus_timestamp,
-      sequence_number: first.sequence_number
+    const {
+      communication: commTx,
+      transaction: trnTx,
+      state: stateTx
+    } = this.buildFloraTopicCreateTxs({
+      floraAccountId,
+      keyList,
+      submitList,
+      autoRenewAccountId: params.autoRenewAccountId
+    });
+    const commR = await (await (await commTx.freezeWithSigner(signer)).executeWithSigner(signer)).getReceiptWithSigner(signer);
+    const trnR = await (await (await trnTx.freezeWithSigner(signer)).executeWithSigner(signer)).getReceiptWithSigner(signer);
+    const stateR = await (await (await stateTx.freezeWithSigner(signer)).executeWithSigner(signer)).getReceiptWithSigner(signer);
+    const topics = {
+      communication: commR?.topicId?.toString?.() || "",
+      transaction: trnR?.topicId?.toString?.() || "",
+      state: stateR?.topicId?.toString?.() || ""
+    };
+    return { floraAccountId, topics };
+  }
+  /** Publish flora_created on the communication topic. */
+  async publishFloraCreated(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16FloraCreatedTx({
+      topicId: params.communicationTopicId,
+      operatorId: params.operatorId,
+      floraAccountId: params.floraAccountId,
+      topics: params.topics
     });
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
+  }
+  /**
+   * Post flora_join_request on Flora communication topic.
+   * If submitKey=1/M, a member must relay the message.
+   */
+  async sendFloraJoinRequest(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16FloraJoinRequestTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
+  }
+  /** Post flora_join_vote approval/rejection on the communication topic. */
+  async sendFloraJoinVote(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16FloraJoinVoteTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
+  }
+  /** Post flora_join_accepted after threshold approval. */
+  async sendFloraJoinAccepted(params) {
+    const signer = this.getSigner();
+    const tx = buildHcs16FloraJoinAcceptedTx(params);
+    const frozen = await tx.freezeWithSigner(signer);
+    await frozen.executeWithSigner(signer);
   }
 }
 export {
-  HCS16BaseClient
+  HCS16BrowserClient
 };
 //# sourceMappingURL=standards-sdk.es94.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es94.js","sources":["../../src/hcs-16/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { KeyList, TopicCreateTransaction, PublicKey } from '@hashgraph/sdk';\nimport { buildHcs16CreateFloraTopicTx } from './tx';\nimport { Logger, ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { FloraTopicType, FloraMessage, FloraOperation } from './types';\nimport type { HCSMessageWithCommonFields } from '../services/types';\n\n/**\n * Base client for HCS‑16 functionality. Provides logging, mirror‑node access,\n * memo helpers, and light message utilities shared by Node and Browser clients.\n */\nexport class HCS16BaseClient {\n  protected readonly network: NetworkType;\n  public mirrorNode: HederaMirrorNode;\n  protected readonly logger: ILogger;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-16' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  async assembleKeyList(params: {\n    members: string[];\n    threshold: number;\n  }): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of params.members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, params.threshold);\n  }\n\n  async assembleSubmitKeyList(members: string[]): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, 1);\n  }\n\n  buildFloraTopicCreateTxs(params: {\n    floraAccountId: string;\n    keyList: KeyList;\n    submitList: KeyList;\n    autoRenewAccountId?: string;\n  }): {\n    communication: TopicCreateTransaction;\n    transaction: TopicCreateTransaction;\n    state: TopicCreateTransaction;\n  } {\n    const communication = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.COMMUNICATION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const transaction = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.TRANSACTION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const state = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.STATE,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    return { communication, transaction, state };\n  }\n\n  /**\n   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.\n   */\n  parseTopicMemo(memo: string): {\n    protocol: 'hcs-16';\n    floraAccountId: string;\n    topicType: FloraTopicType;\n  } | null {\n    const match = memo.match(/^hcs-16:([0-9.]+):(\\d)$/);\n    if (!match) {\n      return null;\n    }\n    return {\n      protocol: 'hcs-16',\n      floraAccountId: match[1],\n      topicType: Number(match[2]) as FloraTopicType,\n    };\n  }\n\n  /**\n   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.\n   */\n  protected createFloraMessage(\n    op: FloraOperation,\n    operatorId: string,\n    body?: Record<string, unknown>,\n  ): FloraMessage {\n    const payload: FloraMessage = {\n      p: 'hcs-16',\n      op,\n      operator_id: operatorId,\n      ...(body || {}),\n    } as FloraMessage;\n    return payload;\n  }\n\n  /**\n   * Fetch recent HCS‑16 messages from a topic via Mirror Node.\n   */\n  async getRecentMessages(\n    topicId: string,\n    options?: {\n      limit?: number;\n      order?: 'asc' | 'desc';\n      opFilter?: FloraOperation | string;\n    },\n  ): Promise<\n    Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }>\n  > {\n    const limit = options?.limit ?? 25;\n    const order = options?.order ?? 'desc';\n    const items: HCSMessageWithCommonFields[] =\n      await this.mirrorNode.getTopicMessages(topicId, { limit, order });\n\n    const results: Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }> = [];\n\n    for (const raw of items) {\n      if (raw.p !== 'hcs-16') {\n        continue;\n      }\n\n      const {\n        consensus_timestamp,\n        sequence_number,\n        running_hash,\n        running_hash_version,\n        topic_id,\n        payer,\n        created,\n        chunk_info,\n        ...payload\n      } = raw as unknown as Record<string, unknown>;\n\n      const op = payload.op as FloraOperation | string | undefined;\n      const operatorId = payload.operator_id as string | undefined;\n\n      if (options?.opFilter && op !== options.opFilter) {\n        continue;\n      }\n      if (typeof operatorId !== 'string') {\n        continue;\n      }\n\n      const message = payload as unknown as FloraMessage;\n\n      results.push({\n        message,\n        consensus_timestamp: consensus_timestamp as string | undefined,\n        sequence_number: Number(sequence_number),\n        payer: payer as string | undefined,\n      });\n    }\n    return results;\n  }\n\n  /**\n   * Return the latest valid HCS‑16 message on a topic, if any.\n   */\n  async getLatestMessage(\n    topicId: string,\n    opFilter?: FloraOperation | string,\n  ): Promise<\n    | (FloraMessage & { consensus_timestamp?: string; sequence_number: number })\n    | null\n  > {\n    const items = await this.getRecentMessages(topicId, {\n      limit: 1,\n      order: 'desc',\n      opFilter,\n    });\n    if (items.length === 0) {\n      return null;\n    }\n    const first = items[0];\n    return Object.assign({}, first.message, {\n      consensus_timestamp: first.consensus_timestamp,\n      sequence_number: first.sequence_number,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es94.js","sources":["../../src/hcs-16/browser.ts"],"sourcesContent":["import type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport type { PublicKey, KeyList } from '@hashgraph/sdk';\nimport { ScheduleSignTransaction } from '@hashgraph/sdk';\nimport {\n  buildHcs16CreateFloraTopicTx,\n  buildHcs16FloraCreatedTx,\n  buildHcs16TransactionTx,\n  buildHcs16StateUpdateTx,\n  buildHcs16FloraJoinRequestTx,\n  buildHcs16FloraJoinVoteTx,\n  buildHcs16FloraJoinAcceptedTx,\n  buildHcs16CreateAccountTx,\n} from './tx';\nimport { FloraTopicType } from './types';\nimport { HCS16BaseClient } from './base-client';\n\nexport interface HCS16BrowserClientConfig {\n  network: 'testnet' | 'mainnet';\n  hwc?: HashinalsWalletConnectSDK;\n  signer?: DAppSigner;\n}\n\n/**\n * Browser client for HCS‑16 operations using a DAppSigner.\n */\nexport class HCS16BrowserClient extends HCS16BaseClient {\n  private readonly hwc?: HashinalsWalletConnectSDK;\n  private readonly signer?: DAppSigner;\n\n  constructor(config: HCS16BrowserClientConfig) {\n    super({ network: config.network });\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  async createFloraTopic(params: {\n    floraAccountId: string;\n    topicType: FloraTopicType;\n    adminKey?: PublicKey | KeyList;\n    submitKey?: PublicKey | KeyList;\n    autoRenewAccountId?: string;\n  }): Promise<string> {\n    this.ensureConnected();\n    const signer = this.getSigner();\n    const tx = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: params.topicType,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\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    return topicId;\n  }\n\n  async sendFloraCreated(params: {\n    topicId: string;\n    operatorId: string;\n    floraAccountId: string;\n    topics: { communication: string; transaction: string; state: string };\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16FloraCreatedTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  async sendTransaction(params: {\n    topicId: string;\n    operatorId: string;\n    scheduleId: string;\n    data?: string;\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16TransactionTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  /**\n   * Wallet-signed ScheduleSign for a given scheduleId.\n   */\n  async signSchedule(params: { scheduleId: string }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = await new ScheduleSignTransaction()\n      .setScheduleId(params.scheduleId)\n      .freezeWithSigner(signer);\n    await tx.executeWithSigner(signer);\n  }\n\n  async sendStateUpdate(params: {\n    topicId: string;\n    operatorId: string;\n    hash: string;\n    epoch?: number;\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16StateUpdateTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  /** credit_purchase is not part of HCS-16 specification */\n\n  /**\n   * Create Flora account and C/T/S topics using DAppSigner.\n   * - Account KeyList = threshold of members\n   * - Topic submitKey = 1-of-M KeyList of members\n   * Returns created Flora account ID and topic IDs.\n   */\n  async createFloraAccountWithTopics(params: {\n    members: string[];\n    threshold: number;\n    initialBalanceHbar?: number;\n    autoRenewAccountId?: string;\n  }): Promise<{\n    floraAccountId: string;\n    topics: { communication: string; transaction: string; state: string };\n  }> {\n    const signer = this.getSigner();\n    const keyList = await this.assembleKeyList({\n      members: params.members,\n      threshold: params.threshold,\n    });\n    const submitList = await this.assembleSubmitKeyList(params.members);\n\n    const createAcc = buildHcs16CreateAccountTx({\n      keyList,\n      initialBalanceHbar:\n        typeof params.initialBalanceHbar === 'number'\n          ? params.initialBalanceHbar\n          : 5,\n      maxAutomaticTokenAssociations: -1,\n    });\n    const accFrozen = await createAcc.freezeWithSigner(signer);\n    const accExec = await accFrozen.executeWithSigner(signer);\n    const accReceipt = await accExec.getReceiptWithSigner(signer);\n    const floraAccountId = accReceipt?.accountId?.toString?.();\n    if (!floraAccountId) {\n      throw new Error('Failed to create Flora account');\n    }\n\n    const {\n      communication: commTx,\n      transaction: trnTx,\n      state: stateTx,\n    } = this.buildFloraTopicCreateTxs({\n      floraAccountId,\n      keyList,\n      submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n\n    const commR = await (\n      await (await commTx.freezeWithSigner(signer)).executeWithSigner(signer)\n    ).getReceiptWithSigner(signer);\n    const trnR = await (\n      await (await trnTx.freezeWithSigner(signer)).executeWithSigner(signer)\n    ).getReceiptWithSigner(signer);\n    const stateR = await (\n      await (await stateTx.freezeWithSigner(signer)).executeWithSigner(signer)\n    ).getReceiptWithSigner(signer);\n    const topics = {\n      communication: commR?.topicId?.toString?.() || '',\n      transaction: trnR?.topicId?.toString?.() || '',\n      state: stateR?.topicId?.toString?.() || '',\n    };\n    return { floraAccountId, topics };\n  }\n\n  /** Publish flora_created on the communication topic. */\n  async publishFloraCreated(params: {\n    communicationTopicId: string;\n    operatorId: string;\n    floraAccountId: string;\n    topics: { communication: string; transaction: string; state: string };\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16FloraCreatedTx({\n      topicId: params.communicationTopicId,\n      operatorId: params.operatorId,\n      floraAccountId: params.floraAccountId,\n      topics: params.topics,\n    });\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  /**\n   * Post flora_join_request on Flora communication topic.\n   * If submitKey=1/M, a member must relay the message.\n   */\n  async sendFloraJoinRequest(params: {\n    topicId: string;\n    operatorId: string;\n    candidateAccountId: string;\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16FloraJoinRequestTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  /** Post flora_join_vote approval/rejection on the communication topic. */\n  async sendFloraJoinVote(params: {\n    topicId: string;\n    operatorId: string;\n    candidateAccountId: string;\n    approve: boolean;\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16FloraJoinVoteTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n\n  /** Post flora_join_accepted after threshold approval. */\n  async sendFloraJoinAccepted(params: {\n    topicId: string;\n    operatorId: string;\n    members: string[];\n    epoch?: number;\n  }): Promise<void> {\n    const signer = this.getSigner();\n    const tx = buildHcs16FloraJoinAcceptedTx(params);\n    const frozen = await tx.freezeWithSigner(signer);\n    await frozen.executeWithSigner(signer);\n  }\n}\n"],"names":[],"mappings":"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"}

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

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

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

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