@hashgraphonline/standards-sdk 0.1.159 → 0.1.161

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

@@ -1,499 +1,211 @@
-import { AccountId, Client, Status, TopicCreateTransaction } from "@hashgraph/sdk";
-import { HCS20BaseClient } from "./standards-sdk.es74.js";
-import { PointsDeploymentError, PointsValidationError, PointsTransferError, PointsBurnError } from "./standards-sdk.es73.js";
-import { sleep } from "./standards-sdk.es121.js";
-import { createNodeOperatorContext } from "./standards-sdk.es146.js";
-import { HCS2Client } from "./standards-sdk.es68.js";
-import { buildHcs20DeployTx, buildHcs20MintTx, buildHcs20TransferTx, buildHcs20BurnTx, buildHcs20RegisterTx } from "./standards-sdk.es78.js";
-class HCS20Client extends HCS20BaseClient {
-  constructor(config) {
-    super(config);
-    this.operatorAccountId = typeof config.operatorId === "string" ? AccountId.fromString(config.operatorId) : config.operatorId;
-    this.operatorId = this.operatorAccountId.toString();
-    const baseClient = this.network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
-    this.operatorCtx = createNodeOperatorContext({
-      network: this.network,
-      operatorId: this.operatorId,
-      operatorKey: config.operatorKey,
-      keyType: config.keyType,
-      mirrorNode: this.mirrorNode,
-      logger: this.logger,
-      client: baseClient
-    });
-    this.client = this.operatorCtx.client;
-    void this.operatorCtx.ensureInitialized();
-  }
-  /**
-   * Ensure operator is initialized before operations
-   */
-  async ensureInitialized() {
-    await this.operatorCtx.ensureInitialized();
-  }
+import { Logger } from "./standards-sdk.es117.js";
+import { HederaMirrorNode } from "./standards-sdk.es138.js";
+import { hcs2MessageSchema, HCS2Operation, HCS2RegistryType } from "./standards-sdk.es73.js";
+import { ZodError } from "zod";
+class HCS2BaseClient {
   /**
-   * Submit a payload to a topic
+   * Create a new HCS-2 base client
+   * @param config Client configuration
    */
-  async submitPayload(transaction, submitKey) {
-    let transactionResponse;
-    if (submitKey) {
-      const frozenTransaction = transaction.freezeWith(this.client);
-      const signedTransaction = await frozenTransaction.sign(submitKey);
-      transactionResponse = await signedTransaction.execute(this.client);
-    } else {
-      transactionResponse = await transaction.execute(this.client);
-    }
-    const receipt = await transactionResponse.getReceipt(this.client);
-    if (!receipt || receipt.status !== Status.Success) {
-      throw new Error("Failed to submit message to topic");
-    }
-    return {
-      receipt,
-      transactionId: transactionResponse.transactionId.toString()
-    };
+  constructor(config) {
+    this.network = config.network;
+    this.logger = config.logger || Logger.getInstance({
+      level: config.logLevel || "info",
+      module: "HCS2Client",
+      silent: config.silent
+    });
+    this.mirrorNode = new HederaMirrorNode(
+      this.network,
+      this.logger,
+      config.mirrorNodeUrl ? { customUrl: config.mirrorNodeUrl } : void 0
+    );
   }
   /**
-   * Create a public topic for HCS-20 (for testnet)
+   * Determine the registry type from a topic memo
+   * @param memo The topic memo
+   * @returns The registry type or undefined if not found
    */
-  async createPublicTopic(memo) {
-    await this.ensureInitialized();
-    this.logger.info("Creating public HCS-20 topic...");
-    const topicCreateTx = await new TopicCreateTransaction().setTopicMemo(memo || "HCS-20 Public Topic").execute(this.client);
-    const receipt = await topicCreateTx.getReceipt(this.client);
-    if (receipt.status !== Status.Success || !receipt.topicId) {
-      throw new Error("Failed to create public topic");
+  parseRegistryTypeFromMemo(memo) {
+    try {
+      const regex = /hcs-2:(\d):(\d+)/;
+      const match = memo.match(regex);
+      if (match && match.length === 3) {
+        const registryType = parseInt(match[1]);
+        const ttl = parseInt(match[2]);
+        if (registryType !== void 0 && !isNaN(ttl)) {
+          return { registryType, ttl };
+        }
+      }
+      return void 0;
+    } catch (error) {
+      this.logger.error(`Error parsing registry type from memo: ${error}`);
+      return void 0;
     }
-    const topicId = receipt.topicId.toString();
-    this.logger.info(`Created public topic: ${topicId}`);
-    this.publicTopicId = topicId;
-    return topicId;
   }
   /**
-   * Create a registry topic for HCS-20
+   * Generate a memo string for a registry topic
+   * @param registryType The registry type
+   * @param ttl The time-to-live in seconds
+   * @returns The memo string
    */
-  async createRegistryTopic() {
-    await this.ensureInitialized();
-    this.logger.info("Creating HCS-20 registry topic...");
-    const hcs2Client = new HCS2Client({
-      operatorId: this.operatorId,
-      operatorKey: this.operatorCtx.operatorKey,
-      network: this.network
-    });
-    const topicCreateResponse = await hcs2Client.createRegistry({
-      submitKey: this.operatorCtx.operatorKey,
-      adminKey: this.operatorCtx.operatorKey
-    });
-    if (!topicCreateResponse.success) {
-      throw new Error("Failed to create registry topic");
-    }
-    const topicId = topicCreateResponse.topicId;
-    this.logger.info(`Created registry topic: ${topicId}`);
-    this.registryTopicId = topicId;
-    return topicId;
+  generateRegistryMemo(registryType, ttl) {
+    return `hcs-2:${registryType}:${ttl}`;
   }
   /**
-   * Deploy new points
+   * Validate a HCS-2 message
+   * @param message The message to validate
+   * @returns Validation result
    */
-  async deployPoints(options) {
-    await this.ensureInitialized();
-    const { progressCallback } = options;
+  validateMessage(message) {
     try {
-      progressCallback?.({
-        stage: "creating-topic",
-        percentage: 20
-      });
-      let topicId;
-      const hcs2Client = new HCS2Client({
-        operatorId: this.operatorId,
-        operatorKey: this.operatorCtx.operatorKey,
-        network: this.network
-      });
-      if (options.usePrivateTopic) {
-        const topicCreateResponse = await hcs2Client.createRegistry({
-          submitKey: this.operatorCtx.operatorKey,
-          adminKey: this.operatorCtx.operatorKey
+      hcs2MessageSchema.parse(message);
+      return { valid: true, errors: [] };
+    } catch (error) {
+      const errors = [];
+      if (error instanceof ZodError) {
+        error.errors.forEach((err) => {
+          const path = err.path.join(".");
+          errors.push(`${path ? path + ": " : ""}${err.message}`);
         });
-        if (!topicCreateResponse.success) {
-          throw new PointsDeploymentError(
-            "Failed to create topic",
-            options.tick
-          );
-        }
-        topicId = topicCreateResponse.topicId;
-        this.logger.info(`Created private topic: ${topicId}`);
       } else {
-        topicId = this.publicTopicId;
-      }
-      progressCallback?.({
-        stage: "submitting-deploy",
-        percentage: 50,
-        topicId
-      });
-      const deployMessage = {
-        p: "hcs-20",
-        op: "deploy",
-        name: options.name,
-        tick: this.normalizeTick(options.tick),
-        max: options.maxSupply,
-        lim: options.limitPerMint,
-        metadata: options.metadata,
-        m: options.topicMemo
-      };
-      const validation = this.validateMessage(deployMessage);
-      if (!validation.valid) {
-        throw new PointsValidationError(
-          "Invalid deploy message",
-          validation.errors
-        );
+        errors.push(`Unexpected error: ${error}`);
       }
-      const deployTransaction = buildHcs20DeployTx({
-        topicId,
-        name: options.name,
-        tick: options.tick,
-        max: options.maxSupply,
-        lim: options.limitPerMint,
-        metadata: options.metadata,
-        memo: options.topicMemo
-      });
-      const { transactionId: deployTxId } = await this.submitPayload(deployTransaction);
-      progressCallback?.({
-        stage: "confirming",
-        percentage: 80,
-        topicId,
-        deployTxId
-      });
-      await this.waitForMirrorNodeConfirmation(topicId, deployTxId);
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        topicId,
-        deployTxId
-      });
-      const pointsInfo = {
-        name: options.name,
-        tick: this.normalizeTick(options.tick),
-        maxSupply: options.maxSupply,
-        limitPerMint: options.limitPerMint,
-        metadata: options.metadata,
-        topicId,
-        deployerAccountId: this.operatorId,
-        currentSupply: "0",
-        deploymentTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        isPrivate: options.usePrivateTopic || false
-      };
-      return pointsInfo;
-    } catch (error) {
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        error: error instanceof Error ? error.message : "Unknown error"
-      });
-      throw error;
+      this.logger.debug(`Message validation failed: ${errors.join(", ")}`);
+      return { valid: false, errors };
     }
   }
   /**
-   * Mint points
+   * Create a register message
+   * @param targetTopicId The target topic ID
+   * @param metadata Optional metadata URI
+   * @param memo Optional memo
+   * @param protocol Optional protocol version (defaults to 'hcs-2')
+   * @returns The register message
    */
-  async mintPoints(options) {
-    await this.ensureInitialized();
-    const { progressCallback } = options;
-    try {
-      progressCallback?.({
-        stage: "validating",
-        percentage: 20
-      });
-      const normalizedTick = this.normalizeTick(options.tick);
-      progressCallback?.({
-        stage: "submitting",
-        percentage: 50
-      });
-      const topicId = options.topicId ? this.topicToString(options.topicId) : this.publicTopicId;
-      const mintTransaction = buildHcs20MintTx({
-        topicId,
-        tick: options.tick,
-        amt: options.amount,
-        to: this.accountToString(options.to),
-        memo: options.memo
-      });
-      const { transactionId: mintTxId } = await this.submitPayload(mintTransaction);
-      progressCallback?.({
-        stage: "confirming",
-        percentage: 80,
-        mintTxId
-      });
-      if (!options.disableMirrorCheck) {
-        await this.waitForMirrorNodeConfirmation(topicId, mintTxId);
-      }
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        mintTxId
-      });
-      const transaction = {
-        id: mintTxId,
-        operation: "mint",
-        tick: normalizedTick,
-        amount: options.amount,
-        to: this.accountToString(options.to),
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        sequenceNumber: 0,
-        topicId,
-        transactionId: mintTxId,
-        memo: options.memo
-      };
-      return transaction;
-    } catch (error) {
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        error: error instanceof Error ? error.message : "Unknown error"
-      });
-      throw error;
-    }
+  createRegisterMessage(targetTopicId, metadata, memo, protocol = "hcs-2") {
+    return {
+      p: protocol,
+      op: HCS2Operation.REGISTER,
+      t_id: targetTopicId,
+      metadata,
+      m: memo
+    };
   }
   /**
-   * Transfer points
+   * Create an update message
+   * @param targetTopicId The target topic ID
+   * @param uid The unique ID to update
+   * @param metadata Optional metadata URI
+   * @param memo Optional memo
+   * @param protocol Optional protocol version (defaults to 'hcs-2')
+   * @returns The update message
    */
-  async transferPoints(options) {
-    await this.ensureInitialized();
-    const { progressCallback } = options;
-    try {
-      progressCallback?.({
-        stage: "validating-balance",
-        percentage: 20
-      });
-      const normalizedTick = this.normalizeTick(options.tick);
-      const fromAccount = this.accountToString(options.from);
-      const toAccount = this.accountToString(options.to);
-      if (fromAccount !== this.operatorId) {
-        throw new PointsTransferError(
-          "For public topics, transaction payer must match sender",
-          options.tick,
-          fromAccount,
-          toAccount,
-          options.amount
-        );
-      }
-      progressCallback?.({
-        stage: "submitting",
-        percentage: 50
-      });
-      const topicId = options.topicId ? this.topicToString(options.topicId) : this.publicTopicId;
-      const transferTransaction = buildHcs20TransferTx({
-        topicId,
-        tick: options.tick,
-        amt: options.amount,
-        from: fromAccount,
-        to: toAccount,
-        memo: options.memo
-      });
-      const { transactionId: transferTxId } = await this.submitPayload(transferTransaction);
-      progressCallback?.({
-        stage: "confirming",
-        percentage: 80,
-        transferTxId
-      });
-      await this.waitForMirrorNodeConfirmation(topicId, transferTxId);
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        transferTxId
-      });
-      const transaction = {
-        id: transferTxId,
-        operation: "transfer",
-        tick: normalizedTick,
-        amount: options.amount,
-        from: fromAccount,
-        to: toAccount,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        sequenceNumber: 0,
-        topicId,
-        transactionId: transferTxId,
-        memo: options.memo
-      };
-      return transaction;
-    } catch (error) {
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        error: error instanceof Error ? error.message : "Unknown error"
-      });
-      throw error;
-    }
+  createUpdateMessage(targetTopicId, uid, metadata, memo, protocol = "hcs-2") {
+    return {
+      p: protocol,
+      op: HCS2Operation.UPDATE,
+      t_id: targetTopicId,
+      uid,
+      metadata,
+      m: memo
+    };
   }
   /**
-   * Burn points
+   * Create a delete message
+   * @param uid The unique ID to delete
+   * @param memo Optional memo
+   * @param protocol Optional protocol version (defaults to 'hcs-2')
+   * @returns The delete message
    */
-  async burnPoints(options) {
-    await this.ensureInitialized();
-    const { progressCallback } = options;
-    try {
-      progressCallback?.({
-        stage: "validating-balance",
-        percentage: 20
-      });
-      const normalizedTick = this.normalizeTick(options.tick);
-      const fromAccount = this.accountToString(options.from);
-      if (fromAccount !== this.operatorId) {
-        throw new PointsBurnError(
-          "For public topics, transaction payer must match burner",
-          options.tick,
-          fromAccount,
-          options.amount
-        );
-      }
-      progressCallback?.({
-        stage: "submitting",
-        percentage: 50
-      });
-      const topicId = options.topicId ? this.topicToString(options.topicId) : this.publicTopicId;
-      const burnTransaction = buildHcs20BurnTx({
-        topicId,
-        tick: options.tick,
-        amt: options.amount,
-        from: fromAccount,
-        memo: options.memo
-      });
-      const { transactionId: burnTxId } = await this.submitPayload(burnTransaction);
-      progressCallback?.({
-        stage: "confirming",
-        percentage: 80,
-        burnTxId
-      });
-      await this.waitForMirrorNodeConfirmation(topicId, burnTxId);
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        burnTxId
-      });
-      const transaction = {
-        id: burnTxId,
-        operation: "burn",
-        tick: normalizedTick,
-        amount: options.amount,
-        from: fromAccount,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        sequenceNumber: 0,
-        topicId,
-        transactionId: burnTxId,
-        memo: options.memo
-      };
-      return transaction;
-    } catch (error) {
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        error: error instanceof Error ? error.message : "Unknown error"
-      });
-      throw error;
-    }
+  createDeleteMessage(uid, memo, protocol = "hcs-2") {
+    return {
+      p: protocol,
+      op: HCS2Operation.DELETE,
+      uid,
+      m: memo
+    };
   }
   /**
-   * Register a topic in the registry
+   * Create a migrate message
+   * @param targetTopicId The target topic ID to migrate to
+   * @param metadata Optional metadata URI
+   * @param memo Optional memo
+   * @param protocol Optional protocol version (defaults to 'hcs-2')
+   * @returns The migrate message
    */
-  async registerTopic(options) {
-    await this.ensureInitialized();
-    const { progressCallback } = options;
-    try {
-      progressCallback?.({
-        stage: "validating",
-        percentage: 20
-      });
-      const registerMessage = {
-        p: "hcs-20",
-        op: "register",
-        name: options.name,
-        metadata: options.metadata,
-        private: options.isPrivate,
-        t_id: this.topicToString(options.topicId),
-        m: options.memo
-      };
-      const validation = this.validateMessage(registerMessage);
-      if (!validation.valid) {
-        throw new PointsValidationError(
-          "Invalid register message",
-          validation.errors
-        );
-      }
-      if (!this.registryTopicId) {
-        throw new PointsDeploymentError(
-          "Registry topic not available",
-          options.name
-        );
-      }
-      progressCallback?.({
-        stage: "submitting",
-        percentage: 50
-      });
-      const registerTransaction = buildHcs20RegisterTx({
-        registryTopicId: this.registryTopicId,
-        name: options.name,
-        topicId: this.topicToString(options.topicId),
-        isPrivate: options.isPrivate,
-        metadata: options.metadata,
-        memo: options.memo
-      });
-      const { transactionId: registerTxId } = await this.submitPayload(
-        registerTransaction,
-        this.operatorCtx.operatorKey
-      );
-      progressCallback?.({
-        stage: "confirming",
-        percentage: 80,
-        registerTxId
-      });
-      await this.waitForMirrorNodeConfirmation(
-        this.registryTopicId,
-        registerTxId
-      );
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        registerTxId
-      });
-      this.logger.info(`Registered topic ${options.topicId} in registry`);
-    } catch (error) {
-      progressCallback?.({
-        stage: "complete",
-        percentage: 100,
-        error: error instanceof Error ? error.message : "Unknown error"
-      });
-      throw error;
-    }
+  createMigrateMessage(targetTopicId, metadata, memo, protocol = "hcs-2") {
+    return {
+      p: protocol,
+      op: HCS2Operation.MIGRATE,
+      t_id: targetTopicId,
+      metadata,
+      m: memo
+    };
   }
   /**
-   * Wait for mirror node to index a message
+   * Parse registry entries from topic messages
+   * @param topicId The topic ID
+   * @param messages The messages to parse
+   * @param registryType The registry type
+   * @param ttl The time-to-live in seconds
+   * @returns The parsed registry
    */
-  async waitForMirrorNodeConfirmation(topicId, transactionId, maxRetries = 10) {
-    for (let i = 0; i < maxRetries; i++) {
+  parseRegistryEntries(topicId, messages, registryType, ttl) {
+    const entries = [];
+    let latestEntry;
+    this.logger.debug(
+      `Parsing ${messages.length} messages for topic ${topicId}`
+    );
+    for (const msg of messages) {
       try {
-        const messages = await this.mirrorNode.getTopicMessages(topicId, {
-          limit: 10,
-          order: "desc"
-        });
-        const found = messages.some((message) => {
-          if (typeof message !== "object" || message === null) {
-            return false;
-          }
-          const candidate = message;
-          return typeof candidate.consensus_timestamp === "string";
-        });
-        if (found) {
+        if (!msg.message) {
           this.logger.debug(
-            `Transaction ${transactionId} confirmed on mirror node`
+            `Message is missing 'message' property: ${JSON.stringify(msg)}`
           );
-          return;
+          continue;
+        }
+        const decodedMessage = Buffer.from(msg.message, "base64").toString(
+          "utf-8"
+        );
+        const message = JSON.parse(decodedMessage);
+        this.logger.debug(
+          `Successfully parsed message: ${JSON.stringify(message)}`
+        );
+        const { valid, errors } = this.validateMessage(message);
+        if (!valid) {
+          this.logger.warn(`Invalid HCS-2 message: ${errors.join(", ")}`);
+          continue;
+        }
+        const entry = {
+          topicId,
+          sequence: msg.sequence_number,
+          timestamp: msg.consensus_timestamp,
+          payer: msg.payer_account_id,
+          message,
+          consensus_timestamp: msg.consensus_timestamp,
+          registry_type: registryType
+        };
+        entries.push(entry);
+        if (registryType === HCS2RegistryType.NON_INDEXED || !latestEntry || entry.timestamp > latestEntry.timestamp) {
+          latestEntry = entry;
         }
       } catch (error) {
-        this.logger.debug(`Mirror node check attempt ${i + 1} failed:`, error);
+        this.logger.warn(`Error parsing message: ${error}`);
       }
-      await sleep(2e3);
     }
-    this.logger.warn(
-      `Transaction ${transactionId} not found on mirror node after ${maxRetries} attempts`
+    this.logger.debug(
+      `Parsed ${entries.length} valid entries for topic ${topicId}`
     );
+    return {
+      topicId,
+      registryType,
+      ttl,
+      entries: registryType === HCS2RegistryType.INDEXED ? entries : latestEntry ? [latestEntry] : [],
+      latestEntry
+    };
   }
 }
 export {
-  HCS20Client
+  HCS2BaseClient
 };
 //# sourceMappingURL=standards-sdk.es76.js.map