@hashgraphonline/standards-sdk 0.1.168 → 0.1.170

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

@@ -1,37 +1,323 @@
-import { getSkillVerificationStatus } from "./standards-sdk.es162.js";
-import { HCS26BaseClient } from "./standards-sdk.es115.js";
-function mapVerification(status) {
-  const pendingRequest = status.pendingRequest ?? void 0;
-  return {
-    name: status.name,
-    verified: status.verified,
-    previouslyVerified: status.previouslyVerified,
-    ...pendingRequest ? { pendingRequest } : {}
-  };
-}
-function createRegistryBrokerVerificationProvider(client) {
-  return {
-    async getSkillVerificationStatus(params) {
-      const status = await getSkillVerificationStatus(client, {
-        name: params.name
+import { AccountId, Client, TopicCreateTransaction, TopicId, TopicMessageSubmitTransaction, PublicKey, KeyList, PrivateKey } from "@hashgraph/sdk";
+import { randomUUID, createHash } from "crypto";
+import { InscriptionSDK } from "./standards-sdk.es160.js";
+import { createNodeOperatorContext } from "./standards-sdk.es158.js";
+import { inscribe } from "./standards-sdk.es142.js";
+import { getTopicId } from "./standards-sdk.es132.js";
+import { HCS27BaseClient } from "./standards-sdk.es115.js";
+import { toHCS27CheckpointMetadata, hcs27CheckpointMetadataSchema, hcs27CheckpointMessageSchema } from "./standards-sdk.es112.js";
+const MAX_PAYLOAD_BYTES = 1024;
+class HCS27Client extends HCS27BaseClient {
+  constructor(config) {
+    super(config);
+    this.topicSubmitKeySigners = /* @__PURE__ */ new Map();
+    this.operatorId = typeof config.operatorId === "string" ? AccountId.fromString(config.operatorId) : config.operatorId;
+    let resolvedClient = config.client;
+    if (!resolvedClient) {
+      if (config.network === "mainnet") {
+        resolvedClient = Client.forMainnet();
+      } else {
+        resolvedClient = Client.forTestnet();
+      }
+    }
+    this.operatorCtx = createNodeOperatorContext({
+      network: this.network,
+      operatorId: this.operatorId,
+      operatorKey: config.operatorKey,
+      keyType: config.keyType,
+      mirrorNode: this.mirrorNode,
+      logger: this.logger,
+      client: resolvedClient
+    });
+    this.client = this.operatorCtx.client;
+  }
+  getKeyType() {
+    return this.operatorCtx.keyType;
+  }
+  async createCheckpointTopic(options = {}) {
+    await this.operatorCtx.ensureInitialized();
+    const transaction = new TopicCreateTransaction().setTopicMemo(
+      this.buildTopicMemo(options.ttl)
+    );
+    const adminKeyMaterial = this.resolveTopicKeyMaterial(options.adminKey);
+    this.assertSignableTopicKey(options.adminKey, adminKeyMaterial, "adminKey");
+    if (adminKeyMaterial.publicKey) {
+      transaction.setAdminKey(adminKeyMaterial.publicKey);
+    }
+    const submitKeyMaterial = this.resolveTopicKeyMaterial(options.submitKey);
+    this.assertSignableTopicKey(
+      options.submitKey,
+      submitKeyMaterial,
+      "submitKey"
+    );
+    if (submitKeyMaterial.publicKey) {
+      transaction.setSubmitKey(submitKeyMaterial.publicKey);
+    }
+    if (options.transactionMemo?.trim()) {
+      transaction.setTransactionMemo(options.transactionMemo.trim());
+    }
+    let response;
+    if (adminKeyMaterial.signer || submitKeyMaterial.signer) {
+      const frozenTransaction = await transaction.freezeWith(this.client);
+      let signedTransaction = frozenTransaction;
+      if (adminKeyMaterial.signer) {
+        signedTransaction = await signedTransaction.sign(
+          adminKeyMaterial.signer
+        );
+      }
+      if (submitKeyMaterial.signer) {
+        signedTransaction = await signedTransaction.sign(
+          submitKeyMaterial.signer
+        );
+      }
+      response = await signedTransaction.execute(this.client);
+    } else {
+      response = await transaction.execute(this.client);
+    }
+    const receipt = await response.getReceipt(this.client);
+    if (!receipt.topicId) {
+      throw new Error("Failed to create checkpoint topic: topicId empty");
+    }
+    if (submitKeyMaterial.signer) {
+      this.topicSubmitKeySigners.set(
+        receipt.topicId.toString(),
+        submitKeyMaterial.signer
+      );
+    }
+    return {
+      topicId: receipt.topicId.toString(),
+      transactionId: response.transactionId.toString()
+    };
+  }
+  async publishCheckpoint(topicId, metadata, messageMemo, transactionMemo) {
+    await this.operatorCtx.ensureInitialized();
+    const normalizedTopicId = TopicId.fromString(topicId).toString();
+    const parsedMetadata = toHCS27CheckpointMetadata(
+      hcs27CheckpointMetadataSchema.parse(metadata)
+    );
+    const { message, inlineResolvedMetadata } = await this.prepareCheckpointPayload(parsedMetadata, messageMemo);
+    if (typeof message.metadata === "string" && inlineResolvedMetadata) {
+      await this.validateCheckpointMessage(message, async (reference) => {
+        if (reference === message.metadata) {
+          return inlineResolvedMetadata;
+        }
+        return this.resolveHCS1Reference(reference);
       });
-      return mapVerification(status);
+    } else {
+      await this.validateCheckpointMessage(message);
     }
-  };
-}
-class HCS26Client extends HCS26BaseClient {
-  constructor(config) {
-    const provider = config.verificationProvider ?? (config.registryBrokerClient ? createRegistryBrokerVerificationProvider(config.registryBrokerClient) : void 0);
-    super({
-      network: config.network,
-      logger: config.logger,
-      mirrorNode: config.mirrorNode,
-      verificationProvider: provider
+    const transaction = new TopicMessageSubmitTransaction().setTopicId(TopicId.fromString(normalizedTopicId)).setMessage(JSON.stringify(message)).setTransactionMemo(
+      transactionMemo?.trim() || this.buildTransactionMemo()
+    );
+    const submitKeySigner = this.topicSubmitKeySigners.get(normalizedTopicId);
+    const response = submitKeySigner ? await (await transaction.freezeWith(this.client)).sign(submitKeySigner).then((signedTransaction) => signedTransaction.execute(this.client)) : await transaction.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    return {
+      transactionId: response.transactionId.toString(),
+      sequenceNumber: this.parseSequenceNumber(receipt.topicSequenceNumber),
+      receipt
+    };
+  }
+  registerTopicSubmitKey(topicId, submitKey) {
+    const submitKeyMaterial = this.resolveTopicKeyMaterial(submitKey);
+    if (!submitKeyMaterial.signer) {
+      throw new Error(
+        "submitKey must include a private key so the client can sign private-topic submissions"
+      );
+    }
+    this.topicSubmitKeySigners.set(
+      TopicId.fromString(topicId).toString(),
+      submitKeyMaterial.signer
+    );
+  }
+  resolveTopicKeyMaterial(input) {
+    if (input === void 0 || input === false) {
+      return {};
+    }
+    if (input instanceof PublicKey || input instanceof KeyList) {
+      return { publicKey: input };
+    }
+    if (input instanceof PrivateKey) {
+      return { publicKey: input.publicKey, signer: input };
+    }
+    if (typeof input === "boolean") {
+      return input ? { publicKey: this.operatorCtx.operatorKey.publicKey } : {};
+    }
+    if (typeof input === "string") {
+      if (input.trim().length === 0) {
+        throw new Error("topic key string cannot be empty");
+      }
+      try {
+        return { publicKey: PublicKey.fromString(input) };
+      } catch (publicKeyError) {
+        try {
+          const signer = PrivateKey.fromString(input);
+          return { publicKey: signer.publicKey, signer };
+        } catch (privateKeyError) {
+          throw new Error(
+            `Failed to parse topic key as PublicKey or PrivateKey: ${String(
+              publicKeyError
+            )}; ${String(privateKeyError)}`
+          );
+        }
+      }
+    }
+    return {};
+  }
+  assertSignableTopicKey(input, material, fieldName) {
+    if (!input || typeof input === "boolean" || material.signer) {
+      return;
+    }
+    if (material.publicKey && !this.operatorCanSignTopicKey(material.publicKey)) {
+      throw new Error(
+        `${fieldName} must include a private key or use true to reuse the operator key`
+      );
+    }
+  }
+  operatorCanSignTopicKey(publicKey) {
+    if (publicKey instanceof PublicKey) {
+      return this.operatorCtx.operatorKey.publicKey.equals(publicKey);
+    }
+    return this.operatorCanSignKeyList(publicKey);
+  }
+  operatorCanSignKeyList(keyList) {
+    const keys = keyList.toArray();
+    const threshold = keyList.threshold ?? keys.length;
+    if (threshold > 1 || keys.length === 0) {
+      return false;
+    }
+    return keys.some((key) => {
+      if (key instanceof PublicKey) {
+        return this.operatorCtx.operatorKey.publicKey.equals(key);
+      }
+      if (key instanceof KeyList) {
+        return this.operatorCanSignKeyList(key);
+      }
+      return false;
+    });
+  }
+  parseSequenceNumber(value) {
+    const parsed = BigInt(value.toString());
+    if (parsed > BigInt(Number.MAX_SAFE_INTEGER)) {
+      throw new Error(
+        "topicSequenceNumber exceeds Number.MAX_SAFE_INTEGER and cannot be represented safely"
+      );
+    }
+    return Number(parsed);
+  }
+  async prepareCheckpointPayload(metadata, messageMemo) {
+    const normalizedMemo = messageMemo?.trim();
+    if (normalizedMemo && normalizedMemo.length > 299) {
+      throw new Error(
+        "messageMemo must be 299 characters or fewer for HCS-27 checkpoints"
+      );
+    }
+    const inlineMessage = {
+      p: "hcs-27",
+      op: "register",
+      metadata,
+      ...normalizedMemo ? { m: normalizedMemo } : {}
+    };
+    const inlinePayload = JSON.stringify(inlineMessage);
+    if (Buffer.byteLength(inlinePayload, "utf8") <= MAX_PAYLOAD_BYTES) {
+      return { message: inlineMessage };
+    }
+    const metadataBytes = Buffer.from(JSON.stringify(metadata), "utf8");
+    const digest = this.sha256Base64Url(metadataBytes);
+    hcs27CheckpointMessageSchema.parse({
+      p: "hcs-27",
+      op: "register",
+      metadata: "hcs://1/18446744073709551615.18446744073709551615.18446744073709551615",
+      metadata_digest: {
+        alg: "sha-256",
+        b64u: digest
+      },
+      ...normalizedMemo ? { m: normalizedMemo } : {}
+    });
+    const maxReferencePayload = JSON.stringify({
+      p: "hcs-27",
+      op: "register",
+      metadata: "hcs://1/18446744073709551615.18446744073709551615.18446744073709551615",
+      metadata_digest: {
+        alg: "sha-256",
+        b64u: digest
+      },
+      ...normalizedMemo ? { m: normalizedMemo } : {}
     });
+    if (Buffer.byteLength(maxReferencePayload, "utf8") > MAX_PAYLOAD_BYTES) {
+      throw new Error(
+        `checkpoint overflow pointer message exceeds ${MAX_PAYLOAD_BYTES} bytes`
+      );
+    }
+    const reference = await this.publishMetadataHCS1(metadataBytes);
+    const overflowMessage = {
+      p: "hcs-27",
+      op: "register",
+      metadata: reference,
+      metadata_digest: {
+        alg: "sha-256",
+        b64u: digest
+      },
+      ...normalizedMemo ? { m: normalizedMemo } : {}
+    };
+    const overflowPayload = JSON.stringify(overflowMessage);
+    if (Buffer.byteLength(overflowPayload, "utf8") > MAX_PAYLOAD_BYTES) {
+      throw new Error(
+        `checkpoint overflow pointer message still exceeds ${MAX_PAYLOAD_BYTES} bytes`
+      );
+    }
+    return {
+      message: overflowMessage,
+      inlineResolvedMetadata: metadataBytes
+    };
+  }
+  async publishMetadataHCS1(metadataBytes) {
+    if (this.network !== "testnet" && this.network !== "mainnet") {
+      throw new Error(
+        `HCS-1 metadata publication is only supported on testnet and mainnet, got ${this.network}`
+      );
+    }
+    const authOptions = {
+      accountId: this.operatorId.toString(),
+      privateKey: this.operatorCtx.operatorKey,
+      network: this.network
+    };
+    if (!this.inscriptionSDK) {
+      this.inscriptionSDK = await InscriptionSDK.createWithAuth({
+        type: "server",
+        ...authOptions
+      });
+    }
+    const response = await inscribe(
+      {
+        type: "buffer",
+        buffer: metadataBytes,
+        fileName: `hcs27-checkpoint-${randomUUID()}.json`,
+        mimeType: "application/json"
+      },
+      authOptions,
+      {
+        mode: "file",
+        fileStandard: "hcs-1",
+        waitForConfirmation: true,
+        waitMaxAttempts: 120,
+        waitIntervalMs: 2e3
+      },
+      this.inscriptionSDK
+    );
+    const topicId = getTopicId(response.inscription);
+    if (!topicId) {
+      throw new Error(
+        "Failed to inscribe overflow HCS-27 metadata: no topic ID returned"
+      );
+    }
+    return `hcs://1/${topicId}`;
+  }
+  sha256Base64Url(payload) {
+    return createHash("sha256").update(payload).digest("base64url");
   }
 }
 export {
-  HCS26Client,
-  createRegistryBrokerVerificationProvider
+  HCS27Client
 };
 //# sourceMappingURL=standards-sdk.es116.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es116.js","sources":["../../src/hcs-26/sdk.ts"],"sourcesContent":["import type { RegistryBrokerClient } from '../services/registry-broker/client/base-client';\nimport { getSkillVerificationStatus } from '../services/registry-broker/client/skills';\nimport type { SkillVerificationStatusResponse } from '../services/registry-broker/types';\nimport {\n  HCS26BaseClient,\n  type HCS26ClientConfig,\n  type HCS26SkillVerificationProvider,\n  type HCS26SkillVerificationStatus,\n} from './base-client';\n\nexport interface SDKHCS26ClientConfig extends HCS26ClientConfig {\n  registryBrokerClient?: RegistryBrokerClient;\n}\n\nfunction mapVerification(\n  status: SkillVerificationStatusResponse,\n): HCS26SkillVerificationStatus {\n  const pendingRequest = status.pendingRequest ?? undefined;\n  return {\n    name: status.name,\n    verified: status.verified,\n    previouslyVerified: status.previouslyVerified,\n    ...(pendingRequest ? { pendingRequest } : {}),\n  };\n}\n\nexport function createRegistryBrokerVerificationProvider(\n  client: RegistryBrokerClient,\n): HCS26SkillVerificationProvider {\n  return {\n    async getSkillVerificationStatus(params: { name: string }) {\n      const status = await getSkillVerificationStatus(client, {\n        name: params.name,\n      });\n      return mapVerification(status);\n    },\n  };\n}\n\nexport class HCS26Client extends HCS26BaseClient {\n  constructor(config: SDKHCS26ClientConfig) {\n    const provider =\n      config.verificationProvider ??\n      (config.registryBrokerClient\n        ? createRegistryBrokerVerificationProvider(config.registryBrokerClient)\n        : undefined);\n\n    super({\n      network: config.network,\n      logger: config.logger,\n      mirrorNode: config.mirrorNode,\n      verificationProvider: provider,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAcA,SAAS,gBACP,QAC8B;AAC9B,QAAM,iBAAiB,OAAO,kBAAkB;AAChD,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,UAAU,OAAO;AAAA,IACjB,oBAAoB,OAAO;AAAA,IAC3B,GAAI,iBAAiB,EAAE,mBAAmB,CAAA;AAAA,EAAC;AAE/C;AAEO,SAAS,yCACd,QACgC;AAChC,SAAO;AAAA,IACL,MAAM,2BAA2B,QAA0B;AACzD,YAAM,SAAS,MAAM,2BAA2B,QAAQ;AAAA,QACtD,MAAM,OAAO;AAAA,MAAA,CACd;AACD,aAAO,gBAAgB,MAAM;AAAA,IAC/B;AAAA,EAAA;AAEJ;AAEO,MAAM,oBAAoB,gBAAgB;AAAA,EAC/C,YAAY,QAA8B;AACxC,UAAM,WACJ,OAAO,yBACN,OAAO,uBACJ,yCAAyC,OAAO,oBAAoB,IACpE;AAEN,UAAM;AAAA,MACJ,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB,sBAAsB;AAAA,IAAA,CACvB;AAAA,EACH;AACF;"}
+{"version":3,"file":"standards-sdk.es116.js","sources":["../../src/hcs-27/sdk.ts"],"sourcesContent":["import {\n  AccountId,\n  Client,\n  KeyList,\n  PrivateKey,\n  PublicKey,\n  TopicCreateTransaction,\n  TopicId,\n  TopicMessageSubmitTransaction,\n} from '@hashgraph/sdk';\nimport { createHash, randomUUID } from 'crypto';\nimport { InscriptionSDK } from '@kiloscribe/inscription-sdk';\nimport {\n  createNodeOperatorContext,\n  type NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport { inscribe } from '../inscribe/inscriber';\nimport { getTopicId } from '../utils/topic-id-utils';\nimport { HCS27BaseClient } from './base-client';\nimport {\n  hcs27CheckpointMetadataSchema,\n  hcs27CheckpointMessageSchema,\n  type HCS27CheckpointMessage,\n  type HCS27CheckpointMetadata,\n  type HCS27CreateCheckpointTopicOptions,\n  type HCS27CreateCheckpointTopicResult,\n  type HCS27PublishCheckpointResult,\n  type HCS27TopicKey,\n  type SDKHCS27ClientConfig,\n  toHCS27CheckpointMetadata,\n} from './types';\n\nconst MAX_PAYLOAD_BYTES = 1024;\n\nexport class HCS27Client extends HCS27BaseClient {\n  private readonly client: Client;\n  private readonly operatorId: AccountId;\n  private readonly operatorCtx: NodeOperatorContext;\n  private inscriptionSDK?: InscriptionSDK;\n  private readonly topicSubmitKeySigners = new Map<string, PrivateKey>();\n\n  constructor(config: SDKHCS27ClientConfig) {\n    super(config);\n    this.operatorId =\n      typeof config.operatorId === 'string'\n        ? AccountId.fromString(config.operatorId)\n        : config.operatorId;\n\n    let resolvedClient = config.client;\n    if (!resolvedClient) {\n      if (config.network === 'mainnet') {\n        resolvedClient = Client.forMainnet();\n      } else {\n        resolvedClient = Client.forTestnet();\n      }\n    }\n\n    this.operatorCtx = createNodeOperatorContext({\n      network: this.network,\n      operatorId: this.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client: resolvedClient,\n    });\n    this.client = this.operatorCtx.client;\n  }\n\n  getKeyType(): 'ed25519' | 'ecdsa' {\n    return this.operatorCtx.keyType;\n  }\n\n  async createCheckpointTopic(\n    options: HCS27CreateCheckpointTopicOptions = {},\n  ): Promise<HCS27CreateCheckpointTopicResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const transaction = new TopicCreateTransaction().setTopicMemo(\n      this.buildTopicMemo(options.ttl),\n    );\n\n    const adminKeyMaterial = this.resolveTopicKeyMaterial(options.adminKey);\n    this.assertSignableTopicKey(options.adminKey, adminKeyMaterial, 'adminKey');\n    if (adminKeyMaterial.publicKey) {\n      transaction.setAdminKey(adminKeyMaterial.publicKey);\n    }\n\n    const submitKeyMaterial = this.resolveTopicKeyMaterial(options.submitKey);\n    this.assertSignableTopicKey(\n      options.submitKey,\n      submitKeyMaterial,\n      'submitKey',\n    );\n    if (submitKeyMaterial.publicKey) {\n      transaction.setSubmitKey(submitKeyMaterial.publicKey);\n    }\n\n    if (options.transactionMemo?.trim()) {\n      transaction.setTransactionMemo(options.transactionMemo.trim());\n    }\n\n    let response;\n    if (adminKeyMaterial.signer || submitKeyMaterial.signer) {\n      const frozenTransaction = await transaction.freezeWith(this.client);\n      let signedTransaction = frozenTransaction;\n      if (adminKeyMaterial.signer) {\n        signedTransaction = await signedTransaction.sign(\n          adminKeyMaterial.signer,\n        );\n      }\n      if (submitKeyMaterial.signer) {\n        signedTransaction = await signedTransaction.sign(\n          submitKeyMaterial.signer,\n        );\n      }\n      response = await signedTransaction.execute(this.client);\n    } else {\n      response = await transaction.execute(this.client);\n    }\n    const receipt = await response.getReceipt(this.client);\n    if (!receipt.topicId) {\n      throw new Error('Failed to create checkpoint topic: topicId empty');\n    }\n    if (submitKeyMaterial.signer) {\n      this.topicSubmitKeySigners.set(\n        receipt.topicId.toString(),\n        submitKeyMaterial.signer,\n      );\n    }\n\n    return {\n      topicId: receipt.topicId.toString(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  async publishCheckpoint(\n    topicId: string,\n    metadata: HCS27CheckpointMetadata,\n    messageMemo?: string,\n    transactionMemo?: string,\n  ): Promise<HCS27PublishCheckpointResult> {\n    await this.operatorCtx.ensureInitialized();\n    const normalizedTopicId = TopicId.fromString(topicId).toString();\n    const parsedMetadata = toHCS27CheckpointMetadata(\n      hcs27CheckpointMetadataSchema.parse(metadata),\n    );\n    const { message, inlineResolvedMetadata } =\n      await this.prepareCheckpointPayload(parsedMetadata, messageMemo);\n\n    if (typeof message.metadata === 'string' && inlineResolvedMetadata) {\n      await this.validateCheckpointMessage(message, async reference => {\n        if (reference === message.metadata) {\n          return inlineResolvedMetadata;\n        }\n        return this.resolveHCS1Reference(reference);\n      });\n    } else {\n      await this.validateCheckpointMessage(message);\n    }\n\n    const transaction = new TopicMessageSubmitTransaction()\n      .setTopicId(TopicId.fromString(normalizedTopicId))\n      .setMessage(JSON.stringify(message))\n      .setTransactionMemo(\n        transactionMemo?.trim() || this.buildTransactionMemo(),\n      );\n    const submitKeySigner = this.topicSubmitKeySigners.get(normalizedTopicId);\n    const response = submitKeySigner\n      ? await (await transaction.freezeWith(this.client))\n          .sign(submitKeySigner)\n          .then(signedTransaction => signedTransaction.execute(this.client))\n      : await transaction.execute(this.client);\n\n    const receipt = await response.getReceipt(this.client);\n\n    return {\n      transactionId: response.transactionId.toString(),\n      sequenceNumber: this.parseSequenceNumber(receipt.topicSequenceNumber),\n      receipt,\n    };\n  }\n\n  registerTopicSubmitKey(topicId: string, submitKey: HCS27TopicKey): void {\n    const submitKeyMaterial = this.resolveTopicKeyMaterial(submitKey);\n    if (!submitKeyMaterial.signer) {\n      throw new Error(\n        'submitKey must include a private key so the client can sign private-topic submissions',\n      );\n    }\n    this.topicSubmitKeySigners.set(\n      TopicId.fromString(topicId).toString(),\n      submitKeyMaterial.signer,\n    );\n  }\n\n  private resolveTopicKeyMaterial(input?: HCS27TopicKey): {\n    publicKey?: PublicKey | KeyList;\n    signer?: PrivateKey;\n  } {\n    if (input === undefined || input === false) {\n      return {};\n    }\n    if (input instanceof PublicKey || input instanceof KeyList) {\n      return { publicKey: input };\n    }\n    if (input instanceof PrivateKey) {\n      return { publicKey: input.publicKey, signer: input };\n    }\n    if (typeof input === 'boolean') {\n      return input ? { publicKey: this.operatorCtx.operatorKey.publicKey } : {};\n    }\n    if (typeof input === 'string') {\n      if (input.trim().length === 0) {\n        throw new Error('topic key string cannot be empty');\n      }\n      try {\n        return { publicKey: PublicKey.fromString(input) };\n      } catch (publicKeyError) {\n        try {\n          const signer = PrivateKey.fromString(input);\n          return { publicKey: signer.publicKey, signer };\n        } catch (privateKeyError) {\n          throw new Error(\n            `Failed to parse topic key as PublicKey or PrivateKey: ${String(\n              publicKeyError,\n            )}; ${String(privateKeyError)}`,\n          );\n        }\n      }\n    }\n    return {};\n  }\n\n  private assertSignableTopicKey(\n    input: HCS27TopicKey | undefined,\n    material: { publicKey?: PublicKey | KeyList; signer?: PrivateKey },\n    fieldName: 'adminKey' | 'submitKey',\n  ): void {\n    if (!input || typeof input === 'boolean' || material.signer) {\n      return;\n    }\n    if (\n      material.publicKey &&\n      !this.operatorCanSignTopicKey(material.publicKey)\n    ) {\n      throw new Error(\n        `${fieldName} must include a private key or use true to reuse the operator key`,\n      );\n    }\n  }\n\n  private operatorCanSignTopicKey(publicKey: PublicKey | KeyList): boolean {\n    if (publicKey instanceof PublicKey) {\n      return this.operatorCtx.operatorKey.publicKey.equals(publicKey);\n    }\n    return this.operatorCanSignKeyList(publicKey);\n  }\n\n  private operatorCanSignKeyList(keyList: KeyList): boolean {\n    const keys = keyList.toArray();\n    const threshold = keyList.threshold ?? keys.length;\n    if (threshold > 1 || keys.length === 0) {\n      return false;\n    }\n\n    return keys.some(key => {\n      if (key instanceof PublicKey) {\n        return this.operatorCtx.operatorKey.publicKey.equals(key);\n      }\n      if (key instanceof KeyList) {\n        return this.operatorCanSignKeyList(key);\n      }\n      return false;\n    });\n  }\n\n  private parseSequenceNumber(\n    value: { toString(): string } | number | bigint | string,\n  ): number {\n    const parsed = BigInt(value.toString());\n    if (parsed > BigInt(Number.MAX_SAFE_INTEGER)) {\n      throw new Error(\n        'topicSequenceNumber exceeds Number.MAX_SAFE_INTEGER and cannot be represented safely',\n      );\n    }\n    return Number(parsed);\n  }\n\n  private async prepareCheckpointPayload(\n    metadata: HCS27CheckpointMetadata,\n    messageMemo?: string,\n  ): Promise<{\n    message: HCS27CheckpointMessage;\n    inlineResolvedMetadata?: Buffer;\n  }> {\n    const normalizedMemo = messageMemo?.trim();\n    if (normalizedMemo && normalizedMemo.length > 299) {\n      throw new Error(\n        'messageMemo must be 299 characters or fewer for HCS-27 checkpoints',\n      );\n    }\n\n    const inlineMessage: HCS27CheckpointMessage = {\n      p: 'hcs-27',\n      op: 'register',\n      metadata,\n      ...(normalizedMemo ? { m: normalizedMemo } : {}),\n    };\n    const inlinePayload = JSON.stringify(inlineMessage);\n    if (Buffer.byteLength(inlinePayload, 'utf8') <= MAX_PAYLOAD_BYTES) {\n      return { message: inlineMessage };\n    }\n\n    const metadataBytes = Buffer.from(JSON.stringify(metadata), 'utf8');\n    const digest = this.sha256Base64Url(metadataBytes);\n    hcs27CheckpointMessageSchema.parse({\n      p: 'hcs-27',\n      op: 'register',\n      metadata:\n        'hcs://1/18446744073709551615.18446744073709551615.18446744073709551615',\n      metadata_digest: {\n        alg: 'sha-256',\n        b64u: digest,\n      },\n      ...(normalizedMemo ? { m: normalizedMemo } : {}),\n    });\n\n    const maxReferencePayload = JSON.stringify({\n      p: 'hcs-27',\n      op: 'register',\n      metadata:\n        'hcs://1/18446744073709551615.18446744073709551615.18446744073709551615',\n      metadata_digest: {\n        alg: 'sha-256',\n        b64u: digest,\n      },\n      ...(normalizedMemo ? { m: normalizedMemo } : {}),\n    });\n    if (Buffer.byteLength(maxReferencePayload, 'utf8') > MAX_PAYLOAD_BYTES) {\n      throw new Error(\n        `checkpoint overflow pointer message exceeds ${MAX_PAYLOAD_BYTES} bytes`,\n      );\n    }\n\n    const reference = await this.publishMetadataHCS1(metadataBytes);\n    const overflowMessage: HCS27CheckpointMessage = {\n      p: 'hcs-27',\n      op: 'register',\n      metadata: reference,\n      metadata_digest: {\n        alg: 'sha-256',\n        b64u: digest,\n      },\n      ...(normalizedMemo ? { m: normalizedMemo } : {}),\n    };\n    const overflowPayload = JSON.stringify(overflowMessage);\n    if (Buffer.byteLength(overflowPayload, 'utf8') > MAX_PAYLOAD_BYTES) {\n      throw new Error(\n        `checkpoint overflow pointer message still exceeds ${MAX_PAYLOAD_BYTES} bytes`,\n      );\n    }\n\n    return {\n      message: overflowMessage,\n      inlineResolvedMetadata: metadataBytes,\n    };\n  }\n\n  private async publishMetadataHCS1(metadataBytes: Buffer): Promise<string> {\n    if (this.network !== 'testnet' && this.network !== 'mainnet') {\n      throw new Error(\n        `HCS-1 metadata publication is only supported on testnet and mainnet, got ${this.network}`,\n      );\n    }\n\n    const authOptions = {\n      accountId: this.operatorId.toString(),\n      privateKey: this.operatorCtx.operatorKey,\n      network: this.network,\n    };\n\n    if (!this.inscriptionSDK) {\n      this.inscriptionSDK = await InscriptionSDK.createWithAuth({\n        type: 'server',\n        ...authOptions,\n      });\n    }\n\n    const response = await inscribe(\n      {\n        type: 'buffer',\n        buffer: metadataBytes,\n        fileName: `hcs27-checkpoint-${randomUUID()}.json`,\n        mimeType: 'application/json',\n      },\n      authOptions,\n      {\n        mode: 'file',\n        fileStandard: 'hcs-1',\n        waitForConfirmation: true,\n        waitMaxAttempts: 120,\n        waitIntervalMs: 2000,\n      },\n      this.inscriptionSDK,\n    );\n\n    const topicId = getTopicId(response.inscription);\n    if (!topicId) {\n      throw new Error(\n        'Failed to inscribe overflow HCS-27 metadata: no topic ID returned',\n      );\n    }\n\n    return `hcs://1/${topicId}`;\n  }\n\n  private sha256Base64Url(payload: Buffer): string {\n    return createHash('sha256').update(payload).digest('base64url');\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,15 +1,255 @@
-import { HCS26BaseClient } from "./standards-sdk.es115.js";
-class HCS26BrowserClient extends HCS26BaseClient {
-  constructor(config) {
-    super({
-      network: config.network,
-      logger: config.logger,
-      mirrorNode: config.mirrorNode,
-      verificationProvider: config.verificationProvider
-    });
+import { z } from "zod";
+const HCS26_PROTOCOL = "hcs-26";
+const hcs26TopicTypeEnumSchema = z.union([
+  z.literal(0),
+  // discovery
+  z.literal(1),
+  // version
+  z.literal(2)
+  // reputation (optional)
+]);
+const hcs26OperationEnumSchema = z.union([
+  z.literal(0),
+  // register
+  z.literal(1),
+  // update
+  z.literal(2),
+  // delete
+  z.literal(3)
+  // migrate
+]);
+const topicIdSchema = z.string().regex(/^[0-9]+\.[0-9]+\.[0-9]+$/);
+const hcs1HrlSchema = z.string().regex(/^hcs:\/\/1\/[0-9]+\.[0-9]+\.[0-9]+$/);
+const decentralizedAssetUriSchema = z.string().regex(
+  /^(hcs:\/\/1\/[0-9]+\.[0-9]+\.[0-9]+|ipfs:\/\/\S+|ar:\/\/\S+|ord:\/\/\S+)$/
+);
+const semverSchema = z.string().regex(
+  /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
+);
+function validateNormalizedRelativePath(pathRaw) {
+  const path = pathRaw.trim();
+  if (!path) {
+    throw new Error("Path must be non-empty");
+  }
+  if (path.startsWith("/")) {
+    throw new Error("Path must be relative");
+  }
+  if (path.includes("\\")) {
+    throw new Error('Path must use "/" separators');
+  }
+  const segments = path.split("/");
+  for (const segment of segments) {
+    if (!segment || segment === "." || segment === "..") {
+      throw new Error(
+        'Path must be normalized (no ".", "..", or empty segments)'
+      );
+    }
   }
 }
+const hcs1HrlOptionalSchema = z.string().regex(/^hcs:\/\/1\/[0-9]+\.[0-9]+\.[0-9]+$/).optional();
+const discoveryMetadataAuthorSchema = z.union([
+  z.string().min(1),
+  z.object({
+    name: z.string().min(1),
+    contact: z.string().min(1).optional(),
+    url: z.string().url().optional()
+  }).passthrough()
+]);
+const hcs26DiscoveryMetadataSchema = z.object({
+  name: z.string().min(1),
+  description: z.string().min(1),
+  author: discoveryMetadataAuthorSchema,
+  license: z.string().min(1),
+  tags: z.array(
+    z.union([
+      z.number().int().positive(),
+      z.string().regex(/^(0|[1-9]\d*)$/).transform((value) => Number.parseInt(value, 10))
+    ])
+  ).optional(),
+  homepage: z.string().url().optional(),
+  icon: z.union([z.string().url(), decentralizedAssetUriSchema]).optional(),
+  icon_hcs1: hcs1HrlOptionalSchema,
+  languages: z.array(z.string().min(1)).optional(),
+  capabilities: z.array(z.string().min(1)).optional(),
+  repo: z.string().url().optional(),
+  commit: z.string().regex(/^[0-9a-f]{7,64}$/i, "commit must be a git commit SHA").optional()
+}).passthrough();
+const hcs26DiscoveryMetadataPatchSchema = hcs26DiscoveryMetadataSchema.partial().passthrough();
+const hcs26DiscoveryRegisterSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("register"),
+  t_id: topicIdSchema,
+  account_id: z.string().min(1),
+  metadata: z.union([hcs26DiscoveryMetadataSchema, hcs1HrlSchema]),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26DiscoveryRegisterLegacySchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("register"),
+  version_registry: topicIdSchema,
+  publisher: z.string().min(1),
+  metadata: z.union([hcs26DiscoveryMetadataSchema, hcs1HrlSchema]),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26DiscoveryUpdateSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("update"),
+  uid: z.string().min(1),
+  account_id: z.string().min(1).optional(),
+  metadata: z.union([hcs26DiscoveryMetadataPatchSchema, hcs1HrlSchema]).optional(),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26DiscoveryUpdateLegacySchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("update"),
+  uid: z.string().min(1),
+  publisher: z.string().min(1).optional(),
+  metadata: z.union([hcs26DiscoveryMetadataPatchSchema, hcs1HrlSchema]).optional(),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26DiscoveryDeleteSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("delete"),
+  uid: z.string().min(1),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26DiscoveryMigrateSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("migrate"),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const checksumSchema = z.string().regex(/^sha256:[0-9a-f]{64}$/);
+const hcs26VersionRegisterSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("register"),
+  skill_uid: z.number().int().positive(),
+  version: semverSchema,
+  t_id: topicIdSchema,
+  checksum: checksumSchema.optional(),
+  status: z.enum(["active", "deprecated", "yanked"]).optional(),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26VersionRegisterLegacySchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("register"),
+  skill_uid: z.number().int().positive(),
+  version: semverSchema,
+  manifest_hcs1: hcs1HrlSchema,
+  checksum: checksumSchema.optional(),
+  status: z.enum(["active", "deprecated", "yanked"]).optional(),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26VersionUpdateSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("update"),
+  uid: z.string().min(1),
+  status: z.enum(["active", "deprecated", "yanked"]).optional(),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26VersionDeleteSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("delete"),
+  uid: z.string().min(1),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26VersionMigrateSchema = z.object({
+  p: z.literal(HCS26_PROTOCOL),
+  op: z.literal("migrate"),
+  m: z.string().max(500).optional(),
+  sequence_number: z.number().int().optional()
+}).passthrough();
+const hcs26ManifestFileSchema = z.object({
+  path: z.string().min(1).superRefine((value, ctx) => {
+    try {
+      validateNormalizedRelativePath(value);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message });
+    }
+  }),
+  hrl: hcs1HrlSchema,
+  sha256: z.string().regex(/^[0-9a-f]{64}$/),
+  mime: z.string().min(1)
+}).passthrough();
+const hcs26SkillManifestSchema = z.object({
+  name: z.string().min(1),
+  description: z.string().min(1),
+  version: semverSchema,
+  license: z.string().min(1),
+  author: discoveryMetadataAuthorSchema,
+  tags: z.array(
+    z.union([
+      z.number().int().positive(),
+      z.string().regex(/^(0|[1-9]\d*)$/).transform((value) => Number.parseInt(value, 10))
+    ])
+  ).optional(),
+  homepage: z.string().url().optional(),
+  languages: z.array(z.string().min(1)).optional(),
+  repo: z.string().url().optional(),
+  commit: z.string().regex(/^[0-9a-f]{7,64}$/i, "commit must be a git commit SHA").optional(),
+  entrypoints: z.array(
+    z.object({
+      path: z.string().min(1),
+      language: z.string().min(1),
+      args: z.array(z.string()).optional()
+    }).passthrough()
+  ).optional(),
+  files: z.array(hcs26ManifestFileSchema).min(1)
+}).passthrough().superRefine((value, ctx) => {
+  const hasSkillMd = value.files.some((file) => file.path === "SKILL.md");
+  if (!hasSkillMd) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: 'SKILL.md must be present in the manifest files list with path "SKILL.md".',
+      path: ["files"]
+    });
+  }
+});
+const hcs26DiscoveryMessageSchema = z.union([
+  hcs26DiscoveryRegisterSchema,
+  hcs26DiscoveryRegisterLegacySchema,
+  hcs26DiscoveryUpdateSchema,
+  hcs26DiscoveryUpdateLegacySchema,
+  hcs26DiscoveryDeleteSchema,
+  hcs26DiscoveryMigrateSchema
+]);
+const hcs26VersionMessageSchema = z.union([
+  hcs26VersionRegisterSchema,
+  hcs26VersionRegisterLegacySchema,
+  hcs26VersionUpdateSchema,
+  hcs26VersionDeleteSchema,
+  hcs26VersionMigrateSchema
+]);
 export {
-  HCS26BrowserClient
+  HCS26_PROTOCOL,
+  hcs26DiscoveryDeleteSchema,
+  hcs26DiscoveryMessageSchema,
+  hcs26DiscoveryMetadataPatchSchema,
+  hcs26DiscoveryMetadataSchema,
+  hcs26DiscoveryMigrateSchema,
+  hcs26DiscoveryRegisterLegacySchema,
+  hcs26DiscoveryRegisterSchema,
+  hcs26DiscoveryUpdateLegacySchema,
+  hcs26DiscoveryUpdateSchema,
+  hcs26ManifestFileSchema,
+  hcs26OperationEnumSchema,
+  hcs26SkillManifestSchema,
+  hcs26TopicTypeEnumSchema,
+  hcs26VersionDeleteSchema,
+  hcs26VersionMessageSchema,
+  hcs26VersionMigrateSchema,
+  hcs26VersionRegisterLegacySchema,
+  hcs26VersionRegisterSchema,
+  hcs26VersionUpdateSchema
 };
 //# sourceMappingURL=standards-sdk.es117.js.map