@hashgraphonline/standards-sdk 0.1.141 → 0.1.143

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

@@ -1,12 +1,14 @@
 import { Client, Status } from "@hashgraph/sdk";
-import { createNodeOperatorContext } from "./standards-sdk.es135.js";
-import { Logger } from "./standards-sdk.es105.js";
+import { createNodeOperatorContext } from "./standards-sdk.es136.js";
+import { Logger } from "./standards-sdk.es106.js";
 import { HCS21BaseClient } from "./standards-sdk.es83.js";
-import { HCS21MetadataPointerPattern } from "./standards-sdk.es80.js";
+import { metadataDocumentSchema, HCS21TopicType, HCS21ManifestPointerPattern } from "./standards-sdk.es80.js";
 import { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from "./standards-sdk.es82.js";
+import { buildHcs2CreateRegistryTx, buildHcs2RegisterTx } from "./standards-sdk.es72.js";
+import { HCS2RegistryType } from "./standards-sdk.es68.js";
 import { HCS21ValidationError } from "./standards-sdk.es81.js";
-import { inscribe } from "./standards-sdk.es124.js";
-import { getTopicId } from "./standards-sdk.es114.js";
+import { inscribe } from "./standards-sdk.es125.js";
+import { getTopicId } from "./standards-sdk.es115.js";
 class HCS21Client extends HCS21BaseClient {
   constructor(config) {
     const logger = config.logger || new Logger({ level: config.logLevel || "info", module: "HCS-21" });
@@ -30,21 +32,25 @@ class HCS21Client extends HCS21BaseClient {
   }
   async inscribeMetadata(params) {
     await this.operatorCtx.ensureInitialized();
-    const metadataJson = JSON.stringify(params.metadata, null, 2);
+    const metadataPayload = metadataDocumentSchema.parse(params.document);
+    const metadataJson = JSON.stringify(metadataPayload, null, 2);
     const buffer = Buffer.from(metadataJson, "utf8");
+    const connectionMode = params.inscriptionOptions?.connectionMode ?? (params.inscriptionOptions?.websocket === false ? "http" : "auto");
     const inscriptionOptions = {
       waitForConfirmation: true,
+      connectionMode,
+      websocket: params.inscriptionOptions?.websocket ?? false,
       ...params.inscriptionOptions || {},
       metadata: {
         ...params.inscriptionOptions?.metadata || {},
-        ...params.metadata
+        ...metadataPayload
       }
     };
     const inscription = await inscribe(
       {
         type: "buffer",
         buffer,
-        fileName: params.fileName || `hcs21-package-metadata-${Date.now()}.json`,
+        fileName: params.fileName || `hcs21-adapter-manifest-${Date.now()}.json`,
         mimeType: "application/json"
       },
       {
@@ -56,7 +62,7 @@ class HCS21Client extends HCS21BaseClient {
     );
     if (!inscription.confirmed || !inscription.inscription) {
       throw new HCS21ValidationError(
-        "Failed to inscribe package metadata",
+        "Failed to inscribe HCS-21 metadata",
         "invalid_payload"
       );
     }
@@ -68,18 +74,22 @@ class HCS21Client extends HCS21BaseClient {
       );
     }
     const rawSequence = inscription.inscription.sequence_number ?? inscription.inscription.sequenceNumber;
-    const pointerResult = await this.resolveMetadataPointer(
+    const pointerResult = await this.resolveManifestPointer(
       topicId,
       rawSequence
     );
+    const declarationManifestSequence = inscription.result?.manifest_sequence;
     const resultDetails = inscription.result && "jobId" in inscription.result ? {
       jobId: inscription.result.jobId,
-      transactionId: inscription.result.transactionId
+      transactionId: inscription.result.transactionId,
+      totalCostHbar: inscription.costSummary?.totalCostHbar,
+      costBreakdown: inscription.costSummary?.breakdown
     } : {};
     return {
       pointer: pointerResult.pointer,
       topicId,
       sequenceNumber: pointerResult.sequenceNumber,
+      manifestSequence: declarationManifestSequence || pointerResult.sequenceNumber,
       ...resultDetails
     };
   }
@@ -88,6 +98,8 @@ class HCS21Client extends HCS21BaseClient {
     const tx = buildHcs21CreateRegistryTx({
       ttl: params.ttl,
       indexed: params.indexed,
+      type: params.type,
+      metaTopicId: params.metaTopicId,
       adminKey: params.adminKey,
       submitKey: params.submitKey,
       operatorPublicKey: this.operatorCtx.operatorKey.publicKey
@@ -105,6 +117,175 @@ class HCS21Client extends HCS21BaseClient {
     }
     return receipt.topicId.toString();
   }
+  async createAdapterVersionPointerTopic(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs2CreateRegistryTx({
+      registryType: HCS2RegistryType.NON_INDEXED,
+      ttl: params.ttl,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      memoOverride: params.memoOverride,
+      operatorPublicKey: this.operatorCtx.operatorKey.publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create HCS-2 registry version topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async createRegistryDiscoveryTopic(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs2CreateRegistryTx({
+      registryType: HCS2RegistryType.INDEXED,
+      ttl: params.ttl,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      memoOverride: params.memoOverride,
+      operatorPublicKey: this.operatorCtx.operatorKey.publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create registry-of-registries topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async createAdapterCategoryTopic(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs21CreateRegistryTx({
+      ttl: params.ttl,
+      indexed: params.indexed ?? 0,
+      type: HCS21TopicType.ADAPTER_CATEGORY,
+      metaTopicId: params.metaTopicId,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      operatorPublicKey: this.operatorCtx.operatorKey.publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create adapter category topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  /**
+   * Publish a pointer from a version topic to the active declaration topic.
+   * Version pointer messages carry no metadata.
+   */
+  async publishVersionPointer(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.versionTopicId,
+      targetTopicId: params.declarationTopicId,
+      memo: params.memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to publish registry version pointer",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),
+      transactionId: response.transactionId.toString()
+    };
+  }
+  async resolveVersionPointer(versionTopicId) {
+    const [latest] = await this.mirrorNode.getTopicMessages(versionTopicId, {
+      limit: 1,
+      order: "desc"
+    });
+    if (!latest) {
+      throw new HCS21ValidationError(
+        "Version pointer topic has no messages",
+        "invalid_payload"
+      );
+    }
+    const declarationTopicId = latest.t_id;
+    if (typeof declarationTopicId !== "string" || declarationTopicId.length === 0) {
+      throw new HCS21ValidationError(
+        "Version pointer topic does not include a declaration topic ID (`t_id`)",
+        "invalid_payload"
+      );
+    }
+    const rawSequence = typeof latest.sequence_number === "number" ? latest.sequence_number : Number(latest.sequence_number);
+    const sequenceNumber = Number.isFinite(rawSequence) ? rawSequence : 0;
+    return {
+      versionTopicId,
+      declarationTopicId,
+      sequenceNumber,
+      payer: latest.payer,
+      memo: latest.m,
+      op: latest.op
+    };
+  }
+  async registerCategoryTopic(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.discoveryTopicId,
+      targetTopicId: params.categoryTopicId,
+      metadata: params.metadata,
+      memo: params.memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to register adapter category topic",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),
+      transactionId: response.transactionId.toString()
+    };
+  }
+  async publishCategoryEntry(params) {
+    await this.operatorCtx.ensureInitialized();
+    const memo = params.memo ?? `adapter:${params.adapterId}`;
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.categoryTopicId,
+      targetTopicId: params.versionTopicId,
+      metadata: params.metadata,
+      memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to publish adapter category entry",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),
+      transactionId: response.transactionId.toString()
+    };
+  }
   async publishDeclaration(params) {
     await this.operatorCtx.ensureInitialized();
     const declaration = this.normalizeDeclarationInput(params.declaration);
@@ -132,7 +313,7 @@ class HCS21Client extends HCS21BaseClient {
     }
     return this.buildDeclaration(declaration);
   }
-  async resolveMetadataPointer(topicId, sequence) {
+  async resolveManifestPointer(topicId, sequence) {
     const numericSequence = typeof sequence === "string" ? Number(sequence) : sequence;
     let resolvedSequence = typeof numericSequence === "number" && Number.isFinite(numericSequence) ? numericSequence : void 0;
     if (!resolvedSequence) {
@@ -142,7 +323,7 @@ class HCS21Client extends HCS21BaseClient {
       });
       if (!latest || !latest.sequence_number) {
         throw new HCS21ValidationError(
-          "Unable to resolve metadata sequence number",
+          "Unable to resolve manifest sequence number",
           "invalid_payload"
         );
       }
@@ -150,14 +331,14 @@ class HCS21Client extends HCS21BaseClient {
     }
     if (!Number.isFinite(resolvedSequence)) {
       throw new HCS21ValidationError(
-        "Invalid metadata sequence number",
+        "Invalid manifest sequence number",
         "invalid_payload"
       );
     }
-    const pointer = `hcs://1/${topicId}/${resolvedSequence}`;
-    if (!HCS21MetadataPointerPattern.test(pointer)) {
+    const pointer = `hcs://1/${topicId}`;
+    if (!HCS21ManifestPointerPattern.test(pointer)) {
       throw new HCS21ValidationError(
-        "Metadata pointer format is invalid",
+        "Manifest pointer format is invalid",
         "invalid_payload"
       );
     }

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es84.js","sources":["../../src/hcs-21/sdk.ts"],"sourcesContent":["import {\n  Client,\n  PrivateKey,\n  Status,\n  TopicCreateTransaction,\n} from '@hashgraph/sdk';\nimport {\n  createNodeOperatorContext,\n  NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport { Logger, ILogger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21BaseClient, BuildDeclarationParams } from './base-client';\nimport {\n  HCS21MetadataPointerPattern,\n  PackageDeclaration,\n  PackageMetadataPointer,\n  PackageMetadataRecord,\n} from './types';\nimport { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from './tx';\nimport { HCS21ValidationError } from './errors';\nimport { MaybeKey } from '../common/tx/tx-utils';\nimport { inscribe } from '../inscribe/inscriber';\nimport type { InscriptionOptions } from '../inscribe/types';\nimport { getTopicId } from '../utils/topic-id-utils';\n\nexport interface HCS21ClientConfig {\n  network: NetworkType;\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n  logLevel?: LogLevel;\n  logger?: ILogger;\n  mirrorNodeUrl?: string;\n}\n\nexport interface CreateRegistryTopicParams {\n  ttl: number;\n  indexed?: 0 | 1;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n}\n\nexport interface PublishDeclarationResult {\n  sequenceNumber?: number;\n  transactionId: string;\n}\n\nexport interface PublishDeclarationParams {\n  topicId: string;\n  declaration: PackageDeclaration | BuildDeclarationParams;\n  transactionMemo?: string;\n}\n\nexport interface InscribePackageMetadataParams {\n  metadata: PackageMetadataRecord;\n  fileName?: string;\n  inscriptionOptions?: InscriptionOptions;\n}\n\nexport class HCS21Client extends HCS21BaseClient {\n  private readonly client: Client;\n  private readonly operatorCtx: NodeOperatorContext;\n\n  constructor(config: HCS21ClientConfig) {\n    const logger =\n      config.logger ||\n      new Logger({ level: config.logLevel || 'info', module: 'HCS-21' });\n    super({\n      network: config.network,\n      logger,\n      mirrorNodeUrl: config.mirrorNodeUrl,\n    });\n\n    const baseClient =\n      config.network === 'mainnet' ? Client.forMainnet() : Client.forTestnet();\n\n    this.operatorCtx = createNodeOperatorContext({\n      network: config.network,\n      operatorId: config.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client: baseClient,\n    });\n\n    void this.operatorCtx.ensureInitialized();\n    this.client = this.operatorCtx.client;\n  }\n\n  async inscribeMetadata(\n    params: InscribePackageMetadataParams,\n  ): Promise<PackageMetadataPointer> {\n    await this.operatorCtx.ensureInitialized();\n\n    const metadataJson = JSON.stringify(params.metadata, null, 2);\n    const buffer = Buffer.from(metadataJson, 'utf8');\n    const inscriptionOptions: InscriptionOptions = {\n      waitForConfirmation: true,\n      ...(params.inscriptionOptions || {}),\n      metadata: {\n        ...(params.inscriptionOptions?.metadata || {}),\n        ...params.metadata,\n      },\n    };\n\n    const inscription = await inscribe(\n      {\n        type: 'buffer',\n        buffer,\n        fileName:\n          params.fileName || `hcs21-package-metadata-${Date.now()}.json`,\n        mimeType: 'application/json',\n      },\n      {\n        accountId: this.operatorCtx.operatorId.toString(),\n        privateKey: this.operatorCtx.operatorKey,\n        network: this.network,\n      },\n      inscriptionOptions,\n    );\n\n    if (!inscription.confirmed || !inscription.inscription) {\n      throw new HCS21ValidationError(\n        'Failed to inscribe package metadata',\n        'invalid_payload',\n      );\n    }\n\n    const topicId =\n      (inscription.inscription as { jsonTopicId?: string }).jsonTopicId ||\n      (inscription.inscription as { topic_id?: string }).topic_id ||\n      getTopicId(inscription.inscription);\n\n    if (!topicId) {\n      throw new HCS21ValidationError(\n        'Metadata inscription did not return a topic ID',\n        'invalid_payload',\n      );\n    }\n\n    const rawSequence =\n      (inscription.inscription as { sequence_number?: number })\n        .sequence_number ??\n      (inscription.inscription as { sequenceNumber?: number }).sequenceNumber;\n\n    const pointerResult = await this.resolveMetadataPointer(\n      topicId,\n      rawSequence,\n    );\n\n    const resultDetails =\n      inscription.result && 'jobId' in inscription.result\n        ? {\n            jobId: inscription.result.jobId,\n            transactionId: inscription.result.transactionId,\n          }\n        : {};\n\n    return {\n      pointer: pointerResult.pointer,\n      topicId,\n      sequenceNumber: pointerResult.sequenceNumber,\n      ...resultDetails,\n    };\n  }\n\n  async createRegistryTopic(\n    params: CreateRegistryTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx: TopicCreateTransaction = buildHcs21CreateRegistryTx({\n      ttl: params.ttl,\n      indexed: params.indexed,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create HCS-21 registry topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  async publishDeclaration(\n    params: PublishDeclarationParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const declaration = this.normalizeDeclarationInput(params.declaration);\n    const tx = buildHcs21MessageTx({\n      topicId: params.topicId,\n      declaration,\n      transactionMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to submit HCS-21 declaration',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  private normalizeDeclarationInput(\n    declaration: PackageDeclaration | BuildDeclarationParams,\n  ): PackageDeclaration {\n    if ('p' in declaration) {\n      return this.validateDeclaration(declaration);\n    }\n    return this.buildDeclaration(declaration);\n  }\n\n  private async resolveMetadataPointer(\n    topicId: string,\n    sequence?: number,\n  ): Promise<{ pointer: string; sequenceNumber: number }> {\n    const numericSequence =\n      typeof sequence === 'string' ? Number(sequence) : sequence;\n    let resolvedSequence =\n      typeof numericSequence === 'number' && Number.isFinite(numericSequence)\n        ? numericSequence\n        : undefined;\n\n    if (!resolvedSequence) {\n      const [latest] = await this.mirrorNode.getTopicMessages(topicId, {\n        limit: 1,\n        order: 'desc',\n      });\n\n      if (!latest || !latest.sequence_number) {\n        throw new HCS21ValidationError(\n          'Unable to resolve metadata sequence number',\n          'invalid_payload',\n        );\n      }\n\n      resolvedSequence = Number(latest.sequence_number);\n    }\n\n    if (!Number.isFinite(resolvedSequence)) {\n      throw new HCS21ValidationError(\n        'Invalid metadata sequence number',\n        'invalid_payload',\n      );\n    }\n\n    const pointer = `hcs://1/${topicId}/${resolvedSequence}`;\n\n    if (!HCS21MetadataPointerPattern.test(pointer)) {\n      throw new HCS21ValidationError(\n        'Metadata pointer format is invalid',\n        'invalid_payload',\n      );\n    }\n\n    return { pointer, sequenceNumber: resolvedSequence };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es84.js","sources":["../../src/hcs-21/sdk.ts"],"sourcesContent":["import {\n  Client,\n  PrivateKey,\n  Status,\n  TopicCreateTransaction,\n} from '@hashgraph/sdk';\nimport {\n  createNodeOperatorContext,\n  NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport { Logger, ILogger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21BaseClient, BuildDeclarationParams } from './base-client';\nimport {\n  AdapterDeclaration,\n  HCS21ManifestPointerPattern,\n  HCS21MetadataDocument,\n  HCS21TopicType,\n  ManifestPointer,\n  metadataDocumentSchema,\n} from './types';\nimport { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from './tx';\nimport { buildHcs2CreateRegistryTx, buildHcs2RegisterTx } from '../hcs-2/tx';\nimport { HCS2RegistryType } from '../hcs-2/types';\nimport { HCS21ValidationError } from './errors';\nimport { MaybeKey } from '../common/tx/tx-utils';\nimport { inscribe } from '../inscribe/inscriber';\nimport type { InscriptionOptions } from '../inscribe/types';\nimport { getTopicId } from '../utils/topic-id-utils';\n\nexport interface HCS21ClientConfig {\n  network: NetworkType;\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n  logLevel?: LogLevel;\n  logger?: ILogger;\n  mirrorNodeUrl?: string;\n}\n\nexport interface CreateRegistryTopicParams {\n  ttl: number;\n  indexed?: 0 | 1;\n  type?: HCS21TopicType;\n  metaTopicId?: string;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n}\n\nexport interface PublishDeclarationResult {\n  sequenceNumber?: number;\n  transactionId: string;\n}\n\nexport interface PublishDeclarationParams {\n  topicId: string;\n  declaration: AdapterDeclaration | BuildDeclarationParams;\n  transactionMemo?: string;\n}\n\nexport interface InscribeMetadataParams {\n  document: HCS21MetadataDocument;\n  fileName?: string;\n  inscriptionOptions?: InscriptionOptions;\n}\n\nexport interface CreateAdapterVersionPointerTopicParams {\n  ttl: number;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n  memoOverride?: string;\n}\n\nexport interface CreateRegistryDiscoveryTopicParams {\n  ttl: number;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n  memoOverride?: string;\n}\n\nexport interface CreateAdapterCategoryTopicParams {\n  ttl: number;\n  indexed?: 0 | 1;\n  metaTopicId?: string;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n}\n\nexport interface PublishVersionPointerParams {\n  versionTopicId: string;\n  declarationTopicId: string;\n  memo?: string;\n  transactionMemo?: string;\n}\n\nexport interface RegisterCategoryTopicParams {\n  discoveryTopicId: string;\n  categoryTopicId: string;\n  metadata?: string;\n  memo?: string;\n  transactionMemo?: string;\n}\n\nexport interface PublishCategoryEntryParams {\n  categoryTopicId: string;\n  adapterId: string;\n  versionTopicId: string;\n  metadata?: string;\n  memo?: string;\n  transactionMemo?: string;\n}\n\nexport interface VersionPointerResolution {\n  versionTopicId: string;\n  declarationTopicId: string;\n  sequenceNumber: number;\n  payer?: string;\n  memo?: string;\n  op?: string;\n}\n\nexport class HCS21Client extends HCS21BaseClient {\n  private readonly client: Client;\n  private readonly operatorCtx: NodeOperatorContext;\n\n  constructor(config: HCS21ClientConfig) {\n    const logger =\n      config.logger ||\n      new Logger({ level: config.logLevel || 'info', module: 'HCS-21' });\n    super({\n      network: config.network,\n      logger,\n      mirrorNodeUrl: config.mirrorNodeUrl,\n    });\n\n    const baseClient =\n      config.network === 'mainnet' ? Client.forMainnet() : Client.forTestnet();\n\n    this.operatorCtx = createNodeOperatorContext({\n      network: config.network,\n      operatorId: config.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client: baseClient,\n    });\n\n    void this.operatorCtx.ensureInitialized();\n    this.client = this.operatorCtx.client;\n  }\n\n  async inscribeMetadata(\n    params: InscribeMetadataParams,\n  ): Promise<ManifestPointer> {\n    await this.operatorCtx.ensureInitialized();\n\n    const metadataPayload = metadataDocumentSchema.parse(params.document);\n    const metadataJson = JSON.stringify(metadataPayload, null, 2);\n    const buffer = Buffer.from(metadataJson, 'utf8');\n    const connectionMode =\n      params.inscriptionOptions?.connectionMode ??\n      (params.inscriptionOptions?.websocket === false ? 'http' : 'auto');\n    const inscriptionOptions: InscriptionOptions = {\n      waitForConfirmation: true,\n      connectionMode,\n      websocket: params.inscriptionOptions?.websocket ?? false,\n      ...(params.inscriptionOptions || {}),\n      metadata: {\n        ...(params.inscriptionOptions?.metadata || {}),\n        ...metadataPayload,\n      },\n    };\n\n    const inscription = await inscribe(\n      {\n        type: 'buffer',\n        buffer,\n        fileName:\n          params.fileName || `hcs21-adapter-manifest-${Date.now()}.json`,\n        mimeType: 'application/json',\n      },\n      {\n        accountId: this.operatorCtx.operatorId.toString(),\n        privateKey: this.operatorCtx.operatorKey,\n        network: this.network,\n      },\n      inscriptionOptions,\n    );\n\n    if (!inscription.confirmed || !inscription.inscription) {\n      throw new HCS21ValidationError(\n        'Failed to inscribe HCS-21 metadata',\n        'invalid_payload',\n      );\n    }\n\n    const topicId =\n      (inscription.inscription as { jsonTopicId?: string }).jsonTopicId ||\n      (inscription.inscription as { topic_id?: string }).topic_id ||\n      getTopicId(inscription.inscription);\n\n    if (!topicId) {\n      throw new HCS21ValidationError(\n        'Metadata inscription did not return a topic ID',\n        'invalid_payload',\n      );\n    }\n\n    const rawSequence =\n      (inscription.inscription as { sequence_number?: number })\n        .sequence_number ??\n      (inscription.inscription as { sequenceNumber?: number }).sequenceNumber;\n\n    const pointerResult = await this.resolveManifestPointer(\n      topicId,\n      rawSequence,\n    );\n\n    const declarationManifestSequence = (\n      inscription.result as { manifest_sequence?: number }\n    )?.manifest_sequence;\n\n    const resultDetails =\n      inscription.result && 'jobId' in inscription.result\n        ? {\n            jobId: inscription.result.jobId,\n            transactionId: inscription.result.transactionId,\n            totalCostHbar: inscription.costSummary?.totalCostHbar,\n            costBreakdown: inscription.costSummary?.breakdown,\n          }\n        : {};\n\n    return {\n      pointer: pointerResult.pointer,\n      topicId,\n      sequenceNumber: pointerResult.sequenceNumber,\n      manifestSequence:\n        declarationManifestSequence || pointerResult.sequenceNumber,\n      ...resultDetails,\n    };\n  }\n\n  async createRegistryTopic(\n    params: CreateRegistryTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx: TopicCreateTransaction = buildHcs21CreateRegistryTx({\n      ttl: params.ttl,\n      indexed: params.indexed,\n      type: params.type,\n      metaTopicId: params.metaTopicId,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create HCS-21 registry topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  async createAdapterVersionPointerTopic(\n    params: CreateAdapterVersionPointerTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx = buildHcs2CreateRegistryTx({\n      registryType: HCS2RegistryType.NON_INDEXED,\n      ttl: params.ttl,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      memoOverride: params.memoOverride,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create HCS-2 registry version topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  async createRegistryDiscoveryTopic(\n    params: CreateRegistryDiscoveryTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx = buildHcs2CreateRegistryTx({\n      registryType: HCS2RegistryType.INDEXED,\n      ttl: params.ttl,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      memoOverride: params.memoOverride,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create registry-of-registries topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  async createAdapterCategoryTopic(\n    params: CreateAdapterCategoryTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx: TopicCreateTransaction = buildHcs21CreateRegistryTx({\n      ttl: params.ttl,\n      indexed: params.indexed ?? 0,\n      type: HCS21TopicType.ADAPTER_CATEGORY,\n      metaTopicId: params.metaTopicId,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create adapter category topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  /**\n   * Publish a pointer from a version topic to the active declaration topic.\n   * Version pointer messages carry no metadata.\n   */\n  async publishVersionPointer(\n    params: PublishVersionPointerParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx = buildHcs2RegisterTx({\n      registryTopicId: params.versionTopicId,\n      targetTopicId: params.declarationTopicId,\n      memo: params.memo,\n      analyticsMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to publish registry version pointer',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  async resolveVersionPointer(\n    versionTopicId: string,\n  ): Promise<VersionPointerResolution> {\n    const [latest] = await this.mirrorNode.getTopicMessages(versionTopicId, {\n      limit: 1,\n      order: 'desc',\n    });\n\n    if (!latest) {\n      throw new HCS21ValidationError(\n        'Version pointer topic has no messages',\n        'invalid_payload',\n      );\n    }\n\n    const declarationTopicId = (latest as { t_id?: unknown }).t_id;\n\n    if (\n      typeof declarationTopicId !== 'string' ||\n      declarationTopicId.length === 0\n    ) {\n      throw new HCS21ValidationError(\n        'Version pointer topic does not include a declaration topic ID (`t_id`)',\n        'invalid_payload',\n      );\n    }\n\n    const rawSequence =\n      typeof latest.sequence_number === 'number'\n        ? latest.sequence_number\n        : Number(latest.sequence_number);\n    const sequenceNumber = Number.isFinite(rawSequence) ? rawSequence : 0;\n\n    return {\n      versionTopicId,\n      declarationTopicId,\n      sequenceNumber,\n      payer: (latest as { payer?: string }).payer,\n      memo: (latest as { m?: string }).m,\n      op: (latest as { op?: string }).op,\n    };\n  }\n\n  async registerCategoryTopic(\n    params: RegisterCategoryTopicParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx = buildHcs2RegisterTx({\n      registryTopicId: params.discoveryTopicId,\n      targetTopicId: params.categoryTopicId,\n      metadata: params.metadata,\n      memo: params.memo,\n      analyticsMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to register adapter category topic',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  async publishCategoryEntry(\n    params: PublishCategoryEntryParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const memo = params.memo ?? `adapter:${params.adapterId}`;\n    const tx = buildHcs2RegisterTx({\n      registryTopicId: params.categoryTopicId,\n      targetTopicId: params.versionTopicId,\n      metadata: params.metadata,\n      memo,\n      analyticsMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to publish adapter category entry',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  async publishDeclaration(\n    params: PublishDeclarationParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const declaration = this.normalizeDeclarationInput(params.declaration);\n    const tx = buildHcs21MessageTx({\n      topicId: params.topicId,\n      declaration,\n      transactionMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to submit HCS-21 declaration',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  private normalizeDeclarationInput(\n    declaration: AdapterDeclaration | BuildDeclarationParams,\n  ): AdapterDeclaration {\n    if ('p' in declaration) {\n      return this.validateDeclaration(declaration);\n    }\n    return this.buildDeclaration(declaration);\n  }\n\n  private async resolveManifestPointer(\n    topicId: string,\n    sequence?: number,\n  ): Promise<{ pointer: string; sequenceNumber: number }> {\n    const numericSequence =\n      typeof sequence === 'string' ? Number(sequence) : sequence;\n    let resolvedSequence =\n      typeof numericSequence === 'number' && Number.isFinite(numericSequence)\n        ? numericSequence\n        : undefined;\n\n    if (!resolvedSequence) {\n      const [latest] = await this.mirrorNode.getTopicMessages(topicId, {\n        limit: 1,\n        order: 'desc',\n      });\n\n      if (!latest || !latest.sequence_number) {\n        throw new HCS21ValidationError(\n          'Unable to resolve manifest sequence number',\n          'invalid_payload',\n        );\n      }\n\n      resolvedSequence = Number(latest.sequence_number);\n    }\n\n    if (!Number.isFinite(resolvedSequence)) {\n      throw new HCS21ValidationError(\n        'Invalid manifest sequence number',\n        'invalid_payload',\n      );\n    }\n\n    const pointer = `hcs://1/${topicId}`;\n\n    if (!HCS21ManifestPointerPattern.test(pointer)) {\n      throw new HCS21ValidationError(\n        'Manifest pointer format is invalid',\n        'invalid_payload',\n      );\n    }\n\n    return { pointer, sequenceNumber: resolvedSequence };\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,34 +1,281 @@
+import { Status, PublicKey, TransactionId, AccountId } from "@hashgraph/sdk";
 import { HCS21BaseClient } from "./standards-sdk.es83.js";
+import { HCS21TopicType } from "./standards-sdk.es80.js";
+import { HCS21ValidationError } from "./standards-sdk.es81.js";
+import { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from "./standards-sdk.es82.js";
+import { buildHcs2CreateRegistryTx, buildHcs2RegisterTx } from "./standards-sdk.es72.js";
+import { HCS2RegistryType } from "./standards-sdk.es68.js";
 class HCS21BrowserClient extends HCS21BaseClient {
   constructor(config) {
     super({ network: config.network, logger: config.logger });
     this.hwc = config.hwc;
   }
+  async createRegistryTopic(params) {
+    const { publicKey } = await this.getSignerContext();
+    const tx = buildHcs21CreateRegistryTx({
+      ttl: params.ttl,
+      indexed: params.indexed,
+      type: params.type,
+      metaTopicId: params.metaTopicId,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      operatorPublicKey: publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const { receipt } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create HCS-21 registry topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async createAdapterVersionPointerTopic(params) {
+    const { publicKey } = await this.getSignerContext();
+    const tx = buildHcs2CreateRegistryTx({
+      registryType: HCS2RegistryType.NON_INDEXED,
+      ttl: params.ttl,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      memoOverride: params.memoOverride,
+      operatorPublicKey: publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const { receipt } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create HCS-2 registry version topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async createRegistryDiscoveryTopic(params) {
+    const { publicKey } = await this.getSignerContext();
+    const tx = buildHcs2CreateRegistryTx({
+      registryType: HCS2RegistryType.INDEXED,
+      ttl: params.ttl,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      memoOverride: params.memoOverride,
+      operatorPublicKey: publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const { receipt } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create registry-of-registries topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async createAdapterCategoryTopic(params) {
+    const { publicKey } = await this.getSignerContext();
+    const tx = buildHcs21CreateRegistryTx({
+      ttl: params.ttl,
+      indexed: params.indexed ?? 0,
+      type: HCS21TopicType.ADAPTER_CATEGORY,
+      metaTopicId: params.metaTopicId,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      operatorPublicKey: publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const { receipt } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create adapter category topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async publishVersionPointer(params) {
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.versionTopicId,
+      targetTopicId: params.declarationTopicId,
+      memo: params.memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const { receipt, transactionId } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to publish registry version pointer",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: this.toNumber(receipt.topicSequenceNumber),
+      transactionId
+    };
+  }
+  async resolveVersionPointer(versionTopicId) {
+    const [latest] = await this.mirrorNode.getTopicMessages(versionTopicId, {
+      limit: 1,
+      order: "desc"
+    });
+    if (!latest) {
+      throw new HCS21ValidationError(
+        "Version pointer topic has no messages",
+        "invalid_payload"
+      );
+    }
+    const declarationTopicId = latest.t_id;
+    if (typeof declarationTopicId !== "string" || declarationTopicId.length === 0) {
+      throw new HCS21ValidationError(
+        "Version pointer topic does not include a declaration topic ID (`t_id`)",
+        "invalid_payload"
+      );
+    }
+    const rawSequence = typeof latest.sequence_number === "number" ? latest.sequence_number : Number(latest.sequence_number);
+    const sequenceNumber = Number.isFinite(rawSequence) ? rawSequence : 0;
+    return {
+      versionTopicId,
+      declarationTopicId,
+      sequenceNumber,
+      payer: latest.payer,
+      memo: latest.m,
+      op: latest.op
+    };
+  }
+  async registerCategoryTopic(params) {
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.discoveryTopicId,
+      targetTopicId: params.categoryTopicId,
+      metadata: params.metadata,
+      memo: params.memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const { receipt, transactionId } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to register adapter category topic",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: this.toNumber(receipt.topicSequenceNumber),
+      transactionId
+    };
+  }
+  async publishCategoryEntry(params) {
+    const memo = params.memo ?? `adapter:${params.adapterId}`;
+    const tx = buildHcs2RegisterTx({
+      registryTopicId: params.categoryTopicId,
+      targetTopicId: params.versionTopicId,
+      metadata: params.metadata,
+      memo,
+      analyticsMemo: params.transactionMemo
+    });
+    const { receipt, transactionId } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to publish adapter category entry",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: this.toNumber(receipt.topicSequenceNumber),
+      transactionId
+    };
+  }
   async publishDeclaration(params) {
     const declaration = "p" in params.declaration ? this.validateDeclaration(params.declaration) : this.buildDeclaration(params.declaration);
-    await this.hwc.submitMessageToTopic(
-      params.topicId,
-      JSON.stringify(declaration)
-    );
+    const tx = buildHcs21MessageTx({
+      topicId: params.topicId,
+      declaration,
+      transactionMemo: params.transactionMemo
+    });
+    const { receipt, transactionId } = await this.executeWithWallet(tx);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to submit HCS-21 declaration",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: this.toNumber(receipt.topicSequenceNumber),
+      transactionId
+    };
   }
-  async fetchDeclarations(topicId) {
+  async fetchDeclarations(topicId, options) {
     const { messages = [] } = await this.hwc.getMessages(topicId);
     const envelopes = [];
     for (const message of messages) {
+      if (!message || message.p !== "hcs-21") {
+        continue;
+      }
       try {
-        const declaration = this.validateDeclaration(message.message);
+        const declaration = this.validateDeclaration(message);
         envelopes.push({
           declaration,
           consensusTimestamp: message.consensus_timestamp,
-          sequenceNumber: Number(message.sequence_number || 0),
-          payer: message.payer_account_id
+          sequenceNumber: Number(message.sequence_number ?? 0),
+          payer: message.payer
         });
       } catch (error) {
         const detail = error instanceof Error ? error.message : "unknown error";
         this.logger.warn(`Skipping invalid HCS-21 browser message: ${detail}`);
       }
     }
-    return envelopes;
+    const ordered = options?.order === "desc" ? [...envelopes].sort((a, b) => b.sequenceNumber - a.sequenceNumber) : envelopes;
+    if (options?.limit && options.limit > 0) {
+      return ordered.slice(0, options.limit);
+    }
+    return ordered;
+  }
+  async getSignerContext() {
+    if (this.signerCache) {
+      return this.signerCache;
+    }
+    const accountInfo = this.hwc.getAccountInfo?.();
+    const accountId = typeof accountInfo === "string" ? accountInfo : accountInfo?.accountId;
+    if (!accountId) {
+      throw new HCS21ValidationError(
+        "Wallet is not connected",
+        "invalid_payload"
+      );
+    }
+    const accountResponse = await this.hwc.requestAccount(accountId);
+    const key = accountResponse?.key?.key;
+    if (!key) {
+      throw new HCS21ValidationError(
+        "Unable to resolve wallet public key",
+        "invalid_payload"
+      );
+    }
+    const publicKey = PublicKey.fromString(key);
+    this.signerCache = { accountId, publicKey };
+    return this.signerCache;
+  }
+  async executeWithWallet(tx) {
+    const { accountId } = await this.getSignerContext();
+    const txId = TransactionId.generate(AccountId.fromString(accountId));
+    tx.setTransactionId(txId);
+    const receipt = await this.hwc.executeTransaction(tx, false);
+    return {
+      receipt,
+      transactionId: txId.toString()
+    };
+  }
+  toNumber(value) {
+    if (typeof value === "number") {
+      return value;
+    }
+    if (value && typeof value.toNumber === "function") {
+      return value.toNumber();
+    }
+    return void 0;
   }
 }
 export {