@hashgraphonline/standards-sdk 0.0.157-canary.2 → 0.0.157-canary.4

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

@@ -1,347 +1,11 @@
-import { KeyList, AccountCreateTransaction, Hbar, AccountInfoQuery, TopicCreateTransaction, CustomFixedFee, AccountId, TopicMessageSubmitTransaction, TokenId } from "@hashgraph/sdk";
-import { Logger } from "./standards-sdk.es35.js";
-import { FloraError, FloraTopicType, FloraOperation } from "./standards-sdk.es29.js";
-import { FloraBuilder } from "./standards-sdk.es14.js";
-import { HCS11Client } from "./standards-sdk.es15.js";
-class FloraAccountManager {
-  constructor(client, network, logger) {
-    this.client = client;
-    this.logger = logger || new Logger({ module: "FloraAccountManager" });
-    this.network = network || "testnet";
-  }
-  /**
-   * Create a Flora account with threshold key and required topics
-   */
-  async createFlora(config) {
-    try {
-      this.logger.info("Creating Flora account");
-      const keyList = new KeyList(
-        config.members.map((m) => m.publicKey),
-        config.threshold
-      );
-      const transaction = new AccountCreateTransaction().setKey(keyList).setInitialBalance(new Hbar(config.initialBalance || 1)).setMaxAutomaticTokenAssociations(
-        config.maxAutomaticTokenAssociations || -1
-      );
-      const response = await transaction.execute(this.client);
-      const receipt = await response.getReceipt(this.client);
-      if (!receipt.accountId) {
-        throw new Error("Failed to create Flora account");
-      }
-      const floraAccountId = receipt.accountId;
-      const floraAccount = await this.createFloraAccount(keyList, config);
-      const topics = await this.createFloraTopics(
-        floraAccount,
-        keyList,
-        config
-      );
-      await this.createFloraProfile(floraAccount, topics, config);
-      this.logger.info("Flora created successfully", {
-        floraAccountId: floraAccount.toString(),
-        topics: {
-          communication: topics.communication.toString(),
-          transaction: topics.transaction.toString(),
-          state: topics.state.toString()
-        }
-      });
-      return {
-        floraAccountId: floraAccount,
-        topics,
-        keyList,
-        transactionId: ""
-      };
-    } catch (error) {
-      this.logger.error("Failed to create Flora", error);
-      throw error;
-    }
-  }
-  /**
-   * Build KeyList from member public keys
-   */
-  async buildKeyList(members, threshold) {
-    const keyList = new KeyList();
-    keyList.setThreshold(threshold);
-    for (const member of members) {
-      if (member.publicKey) {
-        keyList.push(member.publicKey);
-      } else {
-        const accountInfo = await new AccountInfoQuery().setAccountId(member.accountId).execute(this.client);
-        keyList.push(accountInfo.key);
-      }
-    }
-    return keyList;
-  }
-  /**
-   * Create the Flora account with threshold key
-   */
-  async createFloraAccount(keyList, config) {
-    const transaction = new AccountCreateTransaction().setKey(keyList).setInitialBalance(new Hbar(config.initialBalance || 20)).setMaxAutomaticTokenAssociations(
-      config.maxAutomaticTokenAssociations || -1
-    );
-    const response = await transaction.execute(this.client);
-    const receipt = await response.getReceipt(this.client);
-    if (!receipt.accountId) {
-      throw new FloraError(
-        "Failed to create Flora account",
-        "ACCOUNT_CREATION_FAILED"
-      );
-    }
-    return receipt.accountId;
-  }
-  /**
-   * Create the three required Flora topics with HCS-16 memo format
-   */
-  async createFloraTopics(floraAccountId, adminKey, config) {
-    const submitKeyList = new KeyList();
-    submitKeyList.setThreshold(1);
-    for (const member of config.members) {
-      if (member.publicKey) {
-        submitKeyList.push(member.publicKey);
-      } else {
-        throw new FloraError(
-          `Public key required for member ${member.accountId}`,
-          "MISSING_PUBLIC_KEY"
-        );
-      }
-    }
-    const [communication, transaction, state] = await Promise.all([
-      this.createTopic(
-        floraAccountId,
-        FloraTopicType.COMMUNICATION,
-        adminKey,
-        submitKeyList,
-        config.customFees
-      ),
-      this.createTopic(
-        floraAccountId,
-        FloraTopicType.TRANSACTION,
-        adminKey,
-        submitKeyList,
-        config.customFees
-      ),
-      this.createTopic(
-        floraAccountId,
-        FloraTopicType.STATE,
-        adminKey,
-        submitKeyList,
-        config.customFees
-      )
-    ]);
-    return { communication, transaction, state };
-  }
-  /**
-   * Create a single topic with HCS-16 memo format
-   */
-  async createTopic(floraAccountId, topicType, adminKey, submitKey, customFees) {
-    const memo = `hcs-16:${floraAccountId}:${topicType}`;
-    const transaction = new TopicCreateTransaction().setTopicMemo(memo).setAdminKey(adminKey).setSubmitKey(submitKey);
-    if (customFees && customFees.length > 0) {
-      const fees = customFees.map(
-        (fee) => new CustomFixedFee().setAmount(fee.amount).setFeeCollectorAccountId(
-          AccountId.fromString(fee.feeCollectorAccountId)
-        )
-      );
-      transaction.setCustomFees(fees);
-    }
-    const response = await transaction.execute(this.client);
-    const receipt = await response.getReceipt(this.client);
-    if (!receipt.topicId) {
-      throw new FloraError(
-        `Failed to create ${FloraTopicType[topicType]} topic`,
-        "TOPIC_CREATION_FAILED"
-      );
-    }
-    return receipt.topicId;
-  }
-  /**
-   * Create and store Flora profile using HCS-11
-   */
-  async createFloraProfile(floraAccountId, topics, config) {
-    this.logger.info("Creating Flora profile using HCS-11");
-    const operatorMember = config.members[0];
-    if (!operatorMember.privateKey) {
-      throw new FloraError(
-        "First member must have private key to create profile",
-        "MISSING_PRIVATE_KEY"
-      );
-    }
-    const hcs11Client = new HCS11Client({
-      network: this.network,
-      auth: {
-        operatorId: floraAccountId.toString(),
-        privateKey: operatorMember.privateKey
-      }
-    });
-    const floraBuilder = new FloraBuilder().setDisplayName(config.displayName).setMembers(config.members).setThreshold(config.threshold).setTopics({
-      communication: topics.communication.toString(),
-      transaction: topics.transaction.toString(),
-      state: topics.state.toString()
-    }).setPolicies(config.policies);
-    if (config.bio) {
-      floraBuilder.setBio(config.bio);
-    }
-    if (config.metadata) {
-      floraBuilder.setMetadata(config.metadata);
-    }
-    const profile = floraBuilder.build();
-    const inscriptionResult = await hcs11Client.createAndInscribeProfile(
-      profile,
-      true
-    );
-    if (!inscriptionResult.success) {
-      throw new FloraError(
-        `Failed to inscribe Flora profile: ${inscriptionResult.error}`,
-        "PROFILE_INSCRIPTION_FAILED"
-      );
-    }
-    this.logger.info("Flora profile inscribed successfully", {
-      profileTopicId: inscriptionResult.profileTopicId,
-      transactionId: inscriptionResult.transactionId
-    });
-    return inscriptionResult.profileTopicId;
-  }
-  /**
-   * Send a message to a Flora topic
-   */
-  async sendFloraMessage(topicId, message) {
-    try {
-      message.p = "hcs-16";
-      const transaction = new TopicMessageSubmitTransaction().setTopicId(topicId).setMessage(JSON.stringify(message));
-      const response = await transaction.execute(this.client);
-      await response.getReceipt(this.client);
-      this.logger.debug("Flora message sent", {
-        topicId: topicId.toString(),
-        operation: message.op
-      });
-    } catch (error) {
-      this.logger.error("Failed to send Flora message", error);
-      throw error;
-    }
-  }
-  /**
-   * Send flora_created notification to all members
-   */
-  async notifyFloraCreated(result, memberTopics) {
-    const message = {
-      p: "hcs-16",
-      op: FloraOperation.FLORA_CREATED,
-      operator_id: `${this.client.operatorAccountId}@${result.floraAccountId}`,
-      flora_account_id: result.floraAccountId.toString(),
-      topics: {
-        communication: result.topics.communication.toString(),
-        transaction: result.topics.transaction.toString(),
-        state: result.topics.state.toString()
-      }
-    };
-    await Promise.all(
-      memberTopics.map((topicId) => this.sendFloraMessage(topicId, message))
-    );
-  }
-  /**
-   * Parse HCS-16 topic memo
-   */
-  parseTopicMemo(memo) {
-    const match = memo.match(/^hcs-16:([0-9.]+):(\d)$/);
-    if (!match) {
-      return null;
-    }
-    return {
-      protocol: "hcs-16",
-      floraAccountId: match[1],
-      topicType: parseInt(match[2])
-    };
-  }
-  /**
-   * Create a proposal for a scheduled transaction
-   */
-  async createTransactionProposal(transactionTopicId, scheduledTxId, description, operatorAccountId, floraAccountId) {
-    const message = {
-      p: "hcs-16",
-      op: FloraOperation.TX_PROPOSAL,
-      operator_id: `${operatorAccountId}@${floraAccountId}`,
-      scheduled_tx_id: scheduledTxId,
-      description,
-      m: description
-    };
-    await this.sendFloraMessage(transactionTopicId, message);
-  }
-  /**
-   * Submit a state update to the state topic
-   */
-  async submitStateUpdate(stateTopicId, stateHash, operatorAccountId, floraAccountId, epoch) {
-    const message = {
-      p: "hcs-16",
-      op: FloraOperation.STATE_UPDATE,
-      operator_id: `${operatorAccountId}@${floraAccountId}`,
-      hash: stateHash,
-      epoch,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    await this.sendFloraMessage(stateTopicId, message);
-  }
-  /**
-   * Create a generic HCS-16 transaction topic with HIP-991 support
-   * This can be used for any HCS-16 compliant topic, not just Flora accounts
-   */
-  async createTransactionTopic(config) {
-    const transaction = new TopicCreateTransaction().setTopicMemo(config.memo);
-    if (config.adminKey) {
-      transaction.setAdminKey(config.adminKey);
-    }
-    if (config.submitKey) {
-      transaction.setSubmitKey(config.submitKey);
-    }
-    if (config.feeScheduleKey) {
-      transaction.setFeeScheduleKey(config.feeScheduleKey);
-    }
-    if (config.customFees && config.customFees.length > 0) {
-      const fees = config.customFees.map((fee) => {
-        const customFee = new CustomFixedFee().setAmount(fee.amount).setFeeCollectorAccountId(
-          AccountId.fromString(fee.feeCollectorAccountId)
-        );
-        if (fee.denominatingTokenId) {
-          customFee.setDenominatingTokenId(
-            TokenId.fromString(fee.denominatingTokenId)
-          );
-        }
-        return customFee;
-      });
-      transaction.setCustomFees(fees);
-    }
-    if (config.feeExemptKeys && config.feeExemptKeys.length > 0) {
-      transaction.setFeeExemptKeyList(config.feeExemptKeys);
-    }
-    const response = await transaction.execute(this.client);
-    const receipt = await response.getReceipt(this.client);
-    if (!receipt.topicId) {
-      throw new FloraError(
-        "Failed to create transaction topic",
-        "TOPIC_CREATION_FAILED"
-      );
-    }
-    this.logger.info("Created HCS-16 transaction topic", {
-      topicId: receipt.topicId.toString(),
-      memo: config.memo,
-      hasFees: !!config.customFees
-    });
-    return receipt.topicId;
-  }
-  /**
-   * Submit HCS-16 compliant credit purchase message
-   */
-  async submitCreditPurchase(topicId, purchaser, amount, floraAccountId) {
-    const message = {
-      p: "hcs-16",
-      op: FloraOperation.CREDIT_PURCHASE,
-      operator_id: floraAccountId ? `${purchaser}@${floraAccountId}` : purchaser,
-      amount,
-      purchaser,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      m: `Purchase ${amount} credits`
-    };
-    await this.sendFloraMessage(topicId, message);
+class StateHashError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "StateHashError";
   }
 }
 export {
-  FloraAccountManager
+  StateHashError
 };
 //# sourceMappingURL=standards-sdk.es30.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es30.js","sources":["../../src/hcs-16/flora-account-manager.ts"],"sourcesContent":["import {\n  Client,\n  AccountCreateTransaction,\n  AccountUpdateTransaction,\n  AccountInfoQuery,\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n  KeyList,\n  PublicKey,\n  PrivateKey,\n  Hbar,\n  AccountId,\n  TopicId,\n  CustomFixedFee,\n  TokenId,\n} from '@hashgraph/sdk';\nimport { Logger } from '../utils/logger';\nimport {\n  FloraConfig,\n  FloraCreationResult,\n  FloraTopics,\n  FloraTopicType,\n  FloraMessage,\n  FloraOperation,\n  FloraProfile,\n  FloraError,\n  FloraMember,\n  TransactionTopicConfig,\n  TransactionTopicFee,\n  CreditPurchaseMessage,\n} from './types';\nimport { HCS11Client, FloraBuilder } from '../hcs-11';\nimport type { NetworkType } from '../utils/types';\n\n/**\n * HCS-16 Flora Account Manager\n * Manages creation and operation of Flora multi-party accounts\n */\nexport class FloraAccountManager {\n  private readonly logger: Logger;\n  private readonly network: NetworkType;\n\n  constructor(\n    private readonly client: Client,\n    network?: NetworkType,\n    logger?: Logger,\n  ) {\n    this.logger = logger || new Logger({ module: 'FloraAccountManager' });\n    this.network = network || 'testnet';\n  }\n\n  /**\n   * Create a Flora account with threshold key and required topics\n   */\n  async createFlora(config: FloraConfig): Promise<FloraCreationResult> {\n    try {\n      this.logger.info('Creating Flora account');\n\n      const keyList = new KeyList(\n        config.members.map(m => m.publicKey),\n        config.threshold,\n      );\n\n      const transaction = new AccountCreateTransaction()\n        .setKey(keyList)\n        .setInitialBalance(new Hbar(config.initialBalance || 1))\n        .setMaxAutomaticTokenAssociations(\n          config.maxAutomaticTokenAssociations || -1,\n        );\n\n      const response = await transaction.execute(this.client);\n      const receipt = await response.getReceipt(this.client);\n\n      if (!receipt.accountId) {\n        throw new Error('Failed to create Flora account');\n      }\n\n      const floraAccountId = receipt.accountId;\n\n      const floraAccount = await this.createFloraAccount(keyList, config);\n\n      const topics = await this.createFloraTopics(\n        floraAccount,\n        keyList,\n        config,\n      );\n      await this.createFloraProfile(floraAccount, topics, config);\n\n      this.logger.info('Flora created successfully', {\n        floraAccountId: floraAccount.toString(),\n        topics: {\n          communication: topics.communication.toString(),\n          transaction: topics.transaction.toString(),\n          state: topics.state.toString(),\n        },\n      });\n\n      return {\n        floraAccountId: floraAccount,\n        topics,\n        keyList,\n        transactionId: '',\n      };\n    } catch (error) {\n      this.logger.error('Failed to create Flora', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Build KeyList from member public keys\n   */\n  private async buildKeyList(\n    members: FloraMember[],\n    threshold: number,\n  ): Promise<KeyList> {\n    const keyList = new KeyList();\n    keyList.setThreshold(threshold);\n\n    for (const member of members) {\n      if (member.publicKey) {\n        keyList.push(member.publicKey);\n      } else {\n        const accountInfo = await new AccountInfoQuery()\n          .setAccountId(member.accountId)\n          .execute(this.client);\n        keyList.push(accountInfo.key);\n      }\n    }\n\n    return keyList;\n  }\n\n  /**\n   * Create the Flora account with threshold key\n   */\n  private async createFloraAccount(\n    keyList: KeyList,\n    config: FloraConfig,\n  ): Promise<AccountId> {\n    const transaction = new AccountCreateTransaction()\n      .setKey(keyList)\n      .setInitialBalance(new Hbar(config.initialBalance || 20))\n      .setMaxAutomaticTokenAssociations(\n        config.maxAutomaticTokenAssociations || -1,\n      );\n\n    const response = await transaction.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (!receipt.accountId) {\n      throw new FloraError(\n        'Failed to create Flora account',\n        'ACCOUNT_CREATION_FAILED',\n      );\n    }\n\n    return receipt.accountId;\n  }\n\n  /**\n   * Create the three required Flora topics with HCS-16 memo format\n   */\n  private async createFloraTopics(\n    floraAccountId: AccountId,\n    adminKey: KeyList,\n    config: FloraConfig,\n  ): Promise<FloraTopics> {\n    const submitKeyList = new KeyList();\n    submitKeyList.setThreshold(1);\n\n    for (const member of config.members) {\n      if (member.publicKey) {\n        submitKeyList.push(member.publicKey);\n      } else {\n        throw new FloraError(\n          `Public key required for member ${member.accountId}`,\n          'MISSING_PUBLIC_KEY',\n        );\n      }\n    }\n\n    const [communication, transaction, state] = await Promise.all([\n      this.createTopic(\n        floraAccountId,\n        FloraTopicType.COMMUNICATION,\n        adminKey,\n        submitKeyList,\n        config.customFees,\n      ),\n      this.createTopic(\n        floraAccountId,\n        FloraTopicType.TRANSACTION,\n        adminKey,\n        submitKeyList,\n        config.customFees,\n      ),\n      this.createTopic(\n        floraAccountId,\n        FloraTopicType.STATE,\n        adminKey,\n        submitKeyList,\n        config.customFees,\n      ),\n    ]);\n\n    return { communication, transaction, state };\n  }\n\n  /**\n   * Create a single topic with HCS-16 memo format\n   */\n  private async createTopic(\n    floraAccountId: AccountId,\n    topicType: FloraTopicType,\n    adminKey: KeyList,\n    submitKey: KeyList,\n    customFees?: Array<{ amount: number; feeCollectorAccountId: string }>,\n  ): Promise<TopicId> {\n    const memo = `hcs-16:${floraAccountId}:${topicType}`;\n\n    const transaction = new TopicCreateTransaction()\n      .setTopicMemo(memo)\n      .setAdminKey(adminKey)\n      .setSubmitKey(submitKey);\n\n    if (customFees && customFees.length > 0) {\n      const fees = customFees.map(fee =>\n        new CustomFixedFee()\n          .setAmount(fee.amount)\n          .setFeeCollectorAccountId(\n            AccountId.fromString(fee.feeCollectorAccountId),\n          ),\n      );\n      transaction.setCustomFees(fees);\n    }\n\n    const response = await transaction.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (!receipt.topicId) {\n      throw new FloraError(\n        `Failed to create ${FloraTopicType[topicType]} topic`,\n        'TOPIC_CREATION_FAILED',\n      );\n    }\n\n    return receipt.topicId;\n  }\n\n  /**\n   * Create and store Flora profile using HCS-11\n   */\n  private async createFloraProfile(\n    floraAccountId: AccountId,\n    topics: FloraTopics,\n    config: FloraConfig,\n  ): Promise<string> {\n    this.logger.info('Creating Flora profile using HCS-11');\n\n    const operatorMember = config.members[0];\n    if (!operatorMember.privateKey) {\n      throw new FloraError(\n        'First member must have private key to create profile',\n        'MISSING_PRIVATE_KEY',\n      );\n    }\n\n    const hcs11Client = new HCS11Client({\n      network: this.network,\n      auth: {\n        operatorId: floraAccountId.toString(),\n        privateKey: operatorMember.privateKey,\n      },\n    });\n\n    const floraBuilder = new FloraBuilder()\n      .setDisplayName(config.displayName)\n      .setMembers(config.members)\n      .setThreshold(config.threshold)\n      .setTopics({\n        communication: topics.communication.toString(),\n        transaction: topics.transaction.toString(),\n        state: topics.state.toString(),\n      })\n      .setPolicies(config.policies);\n\n    if (config.bio) {\n      floraBuilder.setBio(config.bio);\n    }\n\n    if (config.metadata) {\n      floraBuilder.setMetadata(config.metadata);\n    }\n\n    const profile = floraBuilder.build();\n\n    const inscriptionResult = await hcs11Client.createAndInscribeProfile(\n      profile,\n      true,\n    );\n\n    if (!inscriptionResult.success) {\n      throw new FloraError(\n        `Failed to inscribe Flora profile: ${inscriptionResult.error}`,\n        'PROFILE_INSCRIPTION_FAILED',\n      );\n    }\n\n    this.logger.info('Flora profile inscribed successfully', {\n      profileTopicId: inscriptionResult.profileTopicId,\n      transactionId: inscriptionResult.transactionId,\n    });\n\n    return inscriptionResult.profileTopicId;\n  }\n\n  /**\n   * Send a message to a Flora topic\n   */\n  async sendFloraMessage(\n    topicId: string | TopicId,\n    message: FloraMessage,\n  ): Promise<void> {\n    try {\n      message.p = 'hcs-16';\n\n      const transaction = new TopicMessageSubmitTransaction()\n        .setTopicId(topicId)\n        .setMessage(JSON.stringify(message));\n\n      const response = await transaction.execute(this.client);\n      await response.getReceipt(this.client);\n\n      this.logger.debug('Flora message sent', {\n        topicId: topicId.toString(),\n        operation: message.op,\n      });\n    } catch (error) {\n      this.logger.error('Failed to send Flora message', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Send flora_created notification to all members\n   */\n  async notifyFloraCreated(\n    result: FloraCreationResult,\n    memberTopics: string[],\n  ): Promise<void> {\n    const message: FloraMessage = {\n      p: 'hcs-16',\n      op: FloraOperation.FLORA_CREATED,\n      operator_id: `${this.client.operatorAccountId}@${result.floraAccountId}`,\n      flora_account_id: result.floraAccountId.toString(),\n      topics: {\n        communication: result.topics.communication.toString(),\n        transaction: result.topics.transaction.toString(),\n        state: result.topics.state.toString(),\n      },\n    };\n\n    await Promise.all(\n      memberTopics.map(topicId => this.sendFloraMessage(topicId, message)),\n    );\n  }\n\n  /**\n   * Parse HCS-16 topic memo\n   */\n  parseTopicMemo(memo: string): {\n    protocol: string;\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\n    return {\n      protocol: 'hcs-16',\n      floraAccountId: match[1],\n      topicType: parseInt(match[2]) as FloraTopicType,\n    };\n  }\n\n  /**\n   * Create a proposal for a scheduled transaction\n   */\n  async createTransactionProposal(\n    transactionTopicId: string | TopicId,\n    scheduledTxId: string,\n    description: string,\n    operatorAccountId: string,\n    floraAccountId: string,\n  ): Promise<void> {\n    const message: FloraMessage = {\n      p: 'hcs-16',\n      op: FloraOperation.TX_PROPOSAL,\n      operator_id: `${operatorAccountId}@${floraAccountId}`,\n      scheduled_tx_id: scheduledTxId,\n      description,\n      m: description,\n    };\n\n    await this.sendFloraMessage(transactionTopicId, message);\n  }\n\n  /**\n   * Submit a state update to the state topic\n   */\n  async submitStateUpdate(\n    stateTopicId: string | TopicId,\n    stateHash: string,\n    operatorAccountId: string,\n    floraAccountId: string,\n    epoch?: number,\n  ): Promise<void> {\n    const message: FloraMessage = {\n      p: 'hcs-16',\n      op: FloraOperation.STATE_UPDATE,\n      operator_id: `${operatorAccountId}@${floraAccountId}`,\n      hash: stateHash,\n      epoch,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.sendFloraMessage(stateTopicId, message);\n  }\n\n  /**\n   * Create a generic HCS-16 transaction topic with HIP-991 support\n   * This can be used for any HCS-16 compliant topic, not just Flora accounts\n   */\n  async createTransactionTopic(\n    config: TransactionTopicConfig,\n  ): Promise<TopicId> {\n    const transaction = new TopicCreateTransaction().setTopicMemo(config.memo);\n\n    if (config.adminKey) {\n      transaction.setAdminKey(config.adminKey);\n    }\n    if (config.submitKey) {\n      transaction.setSubmitKey(config.submitKey);\n    }\n    if (config.feeScheduleKey) {\n      transaction.setFeeScheduleKey(config.feeScheduleKey);\n    }\n\n    if (config.customFees && config.customFees.length > 0) {\n      const fees = config.customFees.map(fee => {\n        const customFee = new CustomFixedFee()\n          .setAmount(fee.amount)\n          .setFeeCollectorAccountId(\n            AccountId.fromString(fee.feeCollectorAccountId),\n          );\n\n        if (fee.denominatingTokenId) {\n          customFee.setDenominatingTokenId(\n            TokenId.fromString(fee.denominatingTokenId),\n          );\n        }\n\n        return customFee;\n      });\n      transaction.setCustomFees(fees);\n    }\n\n    if (config.feeExemptKeys && config.feeExemptKeys.length > 0) {\n      (transaction as any).setFeeExemptKeyList(config.feeExemptKeys);\n    }\n\n    const response = await transaction.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (!receipt.topicId) {\n      throw new FloraError(\n        'Failed to create transaction topic',\n        'TOPIC_CREATION_FAILED',\n      );\n    }\n\n    this.logger.info('Created HCS-16 transaction topic', {\n      topicId: receipt.topicId.toString(),\n      memo: config.memo,\n      hasFees: !!config.customFees,\n    });\n\n    return receipt.topicId;\n  }\n\n  /**\n   * Submit HCS-16 compliant credit purchase message\n   */\n  async submitCreditPurchase(\n    topicId: string | TopicId,\n    purchaser: string,\n    amount: number,\n    floraAccountId?: string,\n  ): Promise<void> {\n    const message: CreditPurchaseMessage = {\n      p: 'hcs-16',\n      op: FloraOperation.CREDIT_PURCHASE,\n      operator_id: floraAccountId\n        ? `${purchaser}@${floraAccountId}`\n        : purchaser,\n      amount,\n      purchaser,\n      timestamp: new Date().toISOString(),\n      m: `Purchase ${amount} credits`,\n    };\n\n    await this.sendFloraMessage(topicId, message);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es30.js","sources":["../../src/hcs-17/types.ts"],"sourcesContent":["import { PublicKey } from '@hashgraph/sdk';\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\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"],"names":[],"mappings":"AAkEO,MAAM,uBAAuB,MAAM;AAAA,EACxC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}

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

@@ -1,11 +1,207 @@
-class StateHashError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "StateHashError";
+import { createHash } from "crypto";
+import { Logger } from "./standards-sdk.es34.js";
+import { StateHashError } from "./standards-sdk.es30.js";
+class StateHashCalculator {
+  constructor(logger) {
+    this.logger = logger || new Logger({ module: "StateHashCalculator" });
+  }
+  /**
+   * Calculate state hash for a single account
+   * StateHash = SHA384(topicId_1 || latestRunningHash_1 || ... || topicId_n || latestRunningHash_n || account_publicKey)
+   */
+  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;
+      }
+      const publicKeyString = typeof input.publicKey === "string" ? input.publicKey : 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 StateHashError(
+        "Failed to calculate account state hash",
+        "CALCULATION_FAILED"
+      );
+    }
+  }
+  /**
+   * Calculate composite state hash for Flora/Bloom
+   * CompositeStateHash = SHA384(
+   *   Σ_sorted(accountId_i || StateHash_i) ||
+   *   Σ_sorted(topicId_j || runningHash_j) ||
+   *   composite_publicKeyFingerprint
+   * )
+   */
+  calculateCompositeStateHash(input) {
+    try {
+      this.logger.debug("Calculating composite state hash", {
+        compositeAccountId: input.compositeAccountId,
+        memberCount: input.memberStates.length,
+        topicCount: input.compositeTopics.length
+      });
+      const sortedMembers = [...input.memberStates].sort(
+        (a, b) => a.accountId.localeCompare(b.accountId)
+      );
+      const sortedTopics = [...input.compositeTopics].sort(
+        (a, b) => a.topicId.localeCompare(b.topicId)
+      );
+      let concatenated = "";
+      for (const member of sortedMembers) {
+        concatenated += member.accountId + member.stateHash;
+      }
+      for (const topic of sortedTopics) {
+        concatenated += topic.topicId + topic.latestRunningHash;
+      }
+      concatenated += input.compositePublicKeyFingerprint;
+      const hash = createHash("sha384");
+      hash.update(concatenated);
+      const stateHash = hash.digest("hex");
+      this.logger.debug("Composite state hash calculated", {
+        compositeAccountId: input.compositeAccountId,
+        stateHash
+      });
+      return {
+        stateHash,
+        accountId: input.compositeAccountId,
+        timestamp: /* @__PURE__ */ new Date(),
+        topicCount: input.compositeTopics.length,
+        memberCount: input.memberStates.length,
+        compositeTopicCount: input.compositeTopics.length
+      };
+    } catch (error) {
+      this.logger.error("Failed to calculate composite state hash", error);
+      throw new StateHashError(
+        "Failed to calculate composite state hash",
+        "CALCULATION_FAILED"
+      );
+    }
+  }
+  /**
+   * Calculate deterministic public key fingerprint for KeyList/Threshold keys
+   * Used for Flora/Bloom accounts
+   */
+  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 StateHashError(
+        "Failed to calculate key fingerprint",
+        "FINGERPRINT_FAILED"
+      );
+    }
+  }
+  /**
+   * Create 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
+    };
+  }
+  /**
+   * Verify state hash by recalculating
+   */
+  async verifyStateHash(input, expectedHash) {
+    try {
+      let calculatedHash;
+      if ("publicKey" in input) {
+        const result = this.calculateAccountStateHash(input);
+        calculatedHash = result.stateHash;
+      } else {
+        const result = this.calculateCompositeStateHash(input);
+        calculatedHash = result.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;
+    }
+  }
+  /**
+   * Get latest running hashes for topics (mock implementation)
+   * In production, this would query the actual Hedera network
+   */
+  async getTopicRunningHashes(topicIds) {
+    return topicIds.map((topicId) => ({
+      topicId,
+      latestRunningHash: createHash("sha256").update(`mock-hash-${topicId}-${Date.now()}`).digest("hex").substring(0, 48)
+    }));
+  }
+  /**
+   * Calculate and publish state hash to a topic
+   */
+  async publishStateHash(stateHash, accountId, topicIds, publishTopicId, client) {
+    try {
+      const message = this.createStateHashMessage(
+        stateHash,
+        accountId,
+        topicIds,
+        "State synchronization"
+      );
+      const { TopicMessageSubmitTransaction } = await import("@hashgraph/sdk");
+      const transaction = new TopicMessageSubmitTransaction().setTopicId(publishTopicId).setMessage(JSON.stringify(message));
+      const response = await transaction.execute(client);
+      await response.getReceipt(client);
+      this.logger.info("State hash published", {
+        accountId,
+        topicId: publishTopicId,
+        stateHash
+      });
+    } catch (error) {
+      this.logger.error("Failed to publish state hash", error);
+      throw new StateHashError(
+        "Failed to publish state hash",
+        "PUBLISH_FAILED"
+      );
+    }
   }
 }
 export {
-  StateHashError
+  StateHashCalculator
 };
 //# sourceMappingURL=standards-sdk.es31.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es31.js","sources":["../../src/hcs-17/types.ts"],"sourcesContent":["import { PublicKey } from '@hashgraph/sdk';\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\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"],"names":[],"mappings":"AAkEO,MAAM,uBAAuB,MAAM;AAAA,EACxC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"standards-sdk.es31.js","sources":["../../src/hcs-17/state-hash-calculator.ts"],"sourcesContent":["import { createHash } from 'crypto';\nimport { PublicKey, KeyList, Key } from '@hashgraph/sdk';\nimport { Logger } from '../utils/logger';\nimport {\n  AccountStateInput,\n  CompositeStateInput,\n  StateHashResult,\n  CompositeStateHashResult,\n  StateHashMessage,\n  TopicState,\n  StateHashError,\n} from './types';\n\n/**\n * HCS-17 State Hash Calculator\n * Calculates state hashes for accounts and composite accounts (Flora/Bloom)\n */\nexport class StateHashCalculator {\n  private readonly logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.logger = logger || new Logger({ module: 'StateHashCalculator' });\n  }\n\n  /**\n   * Calculate state hash for a single account\n   * StateHash = SHA384(topicId_1 || latestRunningHash_1 || ... || topicId_n || latestRunningHash_n || account_publicKey)\n   */\n  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      const publicKeyString =\n        typeof input.publicKey === 'string'\n          ? input.publicKey\n          : input.publicKey.toString();\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 StateHashError(\n        'Failed to calculate account state hash',\n        'CALCULATION_FAILED',\n      );\n    }\n  }\n\n  /**\n   * Calculate composite state hash for Flora/Bloom\n   * CompositeStateHash = SHA384(\n   *   Σ_sorted(accountId_i || StateHash_i) ||\n   *   Σ_sorted(topicId_j || runningHash_j) ||\n   *   composite_publicKeyFingerprint\n   * )\n   */\n  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\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 StateHashError(\n        'Failed to calculate composite state hash',\n        'CALCULATION_FAILED',\n      );\n    }\n  }\n\n  /**\n   * Calculate deterministic public key fingerprint for KeyList/Threshold keys\n   * Used for Flora/Bloom accounts\n   */\n  calculateKeyFingerprint(keys: PublicKey[], threshold: number): string {\n    try {\n      const sortedKeys = [...keys].sort((a, b) =>\n        a.toString().localeCompare(b.toString()),\n      );\n\n      const keyData = {\n        threshold,\n        keys: sortedKeys.map(k => k.toString()),\n      };\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 StateHashError(\n        'Failed to calculate key fingerprint',\n        'FINGERPRINT_FAILED',\n      );\n    }\n  }\n\n  /**\n   * Create HCS-17 state hash message\n   */\n  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   * Verify state hash by recalculating\n   */\n  async verifyStateHash(\n    input: AccountStateInput | CompositeStateInput,\n    expectedHash: string,\n  ): Promise<boolean> {\n    try {\n      let calculatedHash: string;\n\n      if ('publicKey' in input) {\n        const result = this.calculateAccountStateHash(input);\n        calculatedHash = result.stateHash;\n      } else {\n        const result = this.calculateCompositeStateHash(input);\n        calculatedHash = result.stateHash;\n      }\n\n      const isValid = calculatedHash === expectedHash;\n\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\n      return isValid;\n    } catch (error) {\n      this.logger.error('Failed to verify state hash', error);\n      return false;\n    }\n  }\n\n  /**\n   * Get latest running hashes for topics (mock implementation)\n   * In production, this would query the actual Hedera network\n   */\n  async getTopicRunningHashes(topicIds: string[]): Promise<TopicState[]> {\n    return topicIds.map(topicId => ({\n      topicId,\n      latestRunningHash: createHash('sha256')\n        .update(`mock-hash-${topicId}-${Date.now()}`)\n        .digest('hex')\n        .substring(0, 48),\n    }));\n  }\n\n  /**\n   * Calculate and publish state hash to a topic\n   */\n  async publishStateHash(\n    stateHash: string,\n    accountId: string,\n    topicIds: string[],\n    publishTopicId: string,\n    client: any,\n  ): Promise<void> {\n    try {\n      const message = this.createStateHashMessage(\n        stateHash,\n        accountId,\n        topicIds,\n        'State synchronization',\n      );\n\n      const { TopicMessageSubmitTransaction } = await import('@hashgraph/sdk');\n\n      const transaction = new TopicMessageSubmitTransaction()\n        .setTopicId(publishTopicId)\n        .setMessage(JSON.stringify(message));\n\n      const response = await transaction.execute(client);\n      await response.getReceipt(client);\n\n      this.logger.info('State hash published', {\n        accountId,\n        topicId: publishTopicId,\n        stateHash,\n      });\n    } catch (error) {\n      this.logger.error('Failed to publish state hash', error);\n      throw new StateHashError(\n        'Failed to publish state hash',\n        'PUBLISH_FAILED',\n      );\n    }\n  }\n}\n"],"names":[],"mappings":"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"}