@hashgraphonline/standards-sdk 0.1.138 → 0.1.139-feat-pong-agent.canary.e66e7a5.36

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es147.js","sources":["../../src/utils/parsers/parser-utils.ts"],"sourcesContent":["import { proto } from '@hashgraph/proto';\nimport { ContractId, Transaction } from '@hashgraph/sdk';\nimport { Buffer } from 'buffer';\n\nexport function parseKey(\n  key: proto.IKey | null | undefined,\n): string | undefined {\n  if (!key) {\n    return undefined;\n  }\n\n  if (key.contractID) {\n    return `ContractID: ${new ContractId(\n      key.contractID.shardNum ?? 0,\n      key.contractID.realmNum ?? 0,\n      key.contractID.contractNum ?? 0,\n    ).toString()}`;\n  }\n  if (key.ed25519) {\n    return `ED25519: ${Buffer.from(key.ed25519).toString('hex')}`;\n  }\n  if (key.ECDSASecp256k1) {\n    return `ECDSA_secp256k1: ${Buffer.from(key.ECDSASecp256k1).toString(\n      'hex',\n    )}`;\n  }\n  if (key?.keyList?.keys?.length > 0) {\n    const keys = key.keyList.keys.map(k => parseKey(k)).filter(Boolean);\n    return `KeyList (${keys.length} keys): [${keys.join(', ')}]`;\n  }\n  if (key?.thresholdKey?.keys?.keys?.length > 0) {\n    const keys = key.thresholdKey.keys.keys\n      .map(k => parseKey(k))\n      .filter(Boolean);\n    return `ThresholdKey (${key.thresholdKey.threshold} of ${\n      keys.length\n    }): [${keys.join(', ')}]`;\n  }\n  if (key.delegatableContractId) {\n    return `DelegatableContractID: ${new ContractId(\n      key.delegatableContractId.shardNum ?? 0,\n      key.delegatableContractId.realmNum ?? 0,\n      key.delegatableContractId.contractNum ?? 0,\n    ).toString()}`;\n  }\n  if (Object.keys(key).length === 0) {\n    return 'Empty Key Structure';\n  }\n\n  return 'Unknown or Unset Key Type';\n}\n\n/**\n * Extract TransactionBody from Transaction object using protobuf parsing\n * This replaces fragile constructor name checking with reliable protobuf data\n */\nexport function extractTransactionBody(\n  transaction: Transaction,\n): proto.ITransactionBody | null {\n  try {\n    const bytes = transaction.toBytes ? transaction.toBytes() : undefined;\n    if (!bytes) {\n      return null;\n    }\n\n    const decoded = proto.TransactionList.decode(bytes);\n    if (!decoded.transactionList || decoded.transactionList.length === 0) {\n      return null;\n    }\n\n    const tx = decoded.transactionList[0];\n\n    if (tx.bodyBytes && tx.bodyBytes.length > 0) {\n      return proto.TransactionBody.decode(tx.bodyBytes);\n    }\n\n    if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {\n      const signedTx = proto.SignedTransaction.decode(\n        tx.signedTransactionBytes,\n      );\n      if (signedTx.bodyBytes) {\n        return proto.TransactionBody.decode(signedTx.bodyBytes);\n      }\n    }\n\n    return null;\n  } catch (error) {\n    return null;\n  }\n}\n\n/**\n * Check if transaction has specific transaction type using protobuf data\n * This replaces constructor name checking with reliable protobuf field detection\n */\nexport function hasTransactionType(\n  transaction: Transaction,\n  transactionField: keyof proto.ITransactionBody,\n): boolean {\n  const txBody = extractTransactionBody(transaction);\n  return !!(txBody && txBody[transactionField]);\n}\n"],"names":[],"mappings":";;;AAIO,SAAS,SACd,KACoB;AACpB,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,MAAI,IAAI,YAAY;AAClB,WAAO,eAAe,IAAI;AAAA,MACxB,IAAI,WAAW,YAAY;AAAA,MAC3B,IAAI,WAAW,YAAY;AAAA,MAC3B,IAAI,WAAW,eAAe;AAAA,IAAA,EAC9B,UAAU;AAAA,EACd;AACA,MAAI,IAAI,SAAS;AACf,WAAO,YAAY,OAAO,KAAK,IAAI,OAAO,EAAE,SAAS,KAAK,CAAC;AAAA,EAC7D;AACA,MAAI,IAAI,gBAAgB;AACtB,WAAO,oBAAoB,OAAO,KAAK,IAAI,cAAc,EAAE;AAAA,MACzD;AAAA,IAAA,CACD;AAAA,EACH;AACA,MAAI,KAAK,SAAS,MAAM,SAAS,GAAG;AAClC,UAAM,OAAO,IAAI,QAAQ,KAAK,IAAI,CAAA,MAAK,SAAS,CAAC,CAAC,EAAE,OAAO,OAAO;AAClE,WAAO,YAAY,KAAK,MAAM,YAAY,KAAK,KAAK,IAAI,CAAC;AAAA,EAC3D;AACA,MAAI,KAAK,cAAc,MAAM,MAAM,SAAS,GAAG;AAC7C,UAAM,OAAO,IAAI,aAAa,KAAK,KAChC,IAAI,CAAA,MAAK,SAAS,CAAC,CAAC,EACpB,OAAO,OAAO;AACjB,WAAO,iBAAiB,IAAI,aAAa,SAAS,OAChD,KAAK,MACP,OAAO,KAAK,KAAK,IAAI,CAAC;AAAA,EACxB;AACA,MAAI,IAAI,uBAAuB;AAC7B,WAAO,0BAA0B,IAAI;AAAA,MACnC,IAAI,sBAAsB,YAAY;AAAA,MACtC,IAAI,sBAAsB,YAAY;AAAA,MACtC,IAAI,sBAAsB,eAAe;AAAA,IAAA,EACzC,UAAU;AAAA,EACd;AACA,MAAI,OAAO,KAAK,GAAG,EAAE,WAAW,GAAG;AACjC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAMO,SAAS,uBACd,aAC+B;AAC/B,MAAI;AACF,UAAM,QAAQ,YAAY,UAAU,YAAY,YAAY;AAC5D,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,MAAM,gBAAgB,OAAO,KAAK;AAClD,QAAI,CAAC,QAAQ,mBAAmB,QAAQ,gBAAgB,WAAW,GAAG;AACpE,aAAO;AAAA,IACT;AAEA,UAAM,KAAK,QAAQ,gBAAgB,CAAC;AAEpC,QAAI,GAAG,aAAa,GAAG,UAAU,SAAS,GAAG;AAC3C,aAAO,MAAM,gBAAgB,OAAO,GAAG,SAAS;AAAA,IAClD;AAEA,QAAI,GAAG,0BAA0B,GAAG,uBAAuB,SAAS,GAAG;AACrE,YAAM,WAAW,MAAM,kBAAkB;AAAA,QACvC,GAAG;AAAA,MAAA;AAEL,UAAI,SAAS,WAAW;AACtB,eAAO,MAAM,gBAAgB,OAAO,SAAS,SAAS;AAAA,MACxD;AAAA,IACF;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO;AAAA,EACT;AACF;AAMO,SAAS,mBACd,aACA,kBACS;AACT,QAAM,SAAS,uBAAuB,WAAW;AACjD,SAAO,CAAC,EAAE,UAAU,OAAO,gBAAgB;AAC7C;"}
+{"version":3,"file":"standards-sdk.es147.js","sources":["../../src/utils/dynamic-import.ts"],"sourcesContent":["import { isBrowser } from './is-browser';\n\nlet nodeRequire: NodeRequire | null | undefined;\n\nfunction isModuleNotFound(specifier: string, error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const code = Reflect.get(error, 'code');\n  const message = Reflect.get(error, 'message');\n  const messageText = typeof message === 'string' ? message : '';\n\n  if (typeof code === 'string' && code.includes('MODULE_NOT_FOUND')) {\n    return messageText.includes(specifier);\n  }\n\n  if (messageText) {\n    const lowered = messageText.toLowerCase();\n    if (\n      lowered.includes('cannot find module') ||\n      lowered.includes('module not found') ||\n      lowered.includes('cannot find package')\n    ) {\n      return lowered.includes(specifier.toLowerCase());\n    }\n  }\n\n  return false;\n}\n\nasync function resolveNodeRequire(): Promise<NodeRequire | null> {\n  if (nodeRequire !== undefined) {\n    return nodeRequire;\n  }\n\n  if (isBrowser) {\n    nodeRequire = null;\n    return nodeRequire;\n  }\n\n  try {\n    const globalObject =\n      typeof global !== 'undefined'\n        ? (global as typeof globalThis)\n        : globalThis;\n    const req =\n      globalObject.process?.mainModule?.require ??\n      (globalObject as { require?: NodeRequire }).require;\n\n    nodeRequire =\n      typeof req === 'function' &&\n      typeof (req as NodeRequire).resolve === 'function'\n        ? (req as NodeRequire)\n        : null;\n  } catch {\n    nodeRequire = null;\n  }\n\n  return nodeRequire;\n}\n\nasync function dynamicImport<T>(specifier: string): Promise<T | null> {\n  try {\n    return (await import(specifier)) as T;\n  } catch (error) {\n    if (isModuleNotFound(specifier, error)) {\n      return null;\n    }\n    throw error as Error;\n  }\n}\n\nexport async function optionalImport<T>(specifier: string): Promise<T | null> {\n  if (isBrowser) {\n    return dynamicImport<T>(specifier);\n  }\n\n  const requireFn = await resolveNodeRequire();\n  if (requireFn) {\n    try {\n      return requireFn(specifier) as T;\n    } catch (error) {\n      if (!isModuleNotFound(specifier, error)) {\n        throw error as Error;\n      }\n    }\n  }\n\n  return dynamicImport<T>(specifier);\n}\n"],"names":[],"mappings":";AAEA,IAAI;AAEJ,SAAS,iBAAiB,WAAmB,OAAyB;AACpE,MAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,WAAO;AAAA,EACT;AACA,QAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;AACtC,QAAM,UAAU,QAAQ,IAAI,OAAO,SAAS;AAC5C,QAAM,cAAc,OAAO,YAAY,WAAW,UAAU;AAE5D,MAAI,OAAO,SAAS,YAAY,KAAK,SAAS,kBAAkB,GAAG;AACjE,WAAO,YAAY,SAAS,SAAS;AAAA,EACvC;AAEA,MAAI,aAAa;AACf,UAAM,UAAU,YAAY,YAAA;AAC5B,QACE,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,kBAAkB,KACnC,QAAQ,SAAS,qBAAqB,GACtC;AACA,aAAO,QAAQ,SAAS,UAAU,YAAA,CAAa;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,qBAAkD;AAC/D,MAAI,gBAAgB,QAAW;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,WAAW;AACb,kBAAc;AACd,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,eACJ,OAAO,WAAW,cACb,SACD;AACN,UAAM,MACJ,aAAa,SAAS,YAAY,WACjC,aAA2C;AAE9C,kBACE,OAAO,QAAQ,cACf,OAAQ,IAAoB,YAAY,aACnC,MACD;AAAA,EACR,QAAQ;AACN,kBAAc;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,eAAe,cAAiB,WAAsC;AACpE,MAAI;AACF,WAAQ,MAAM,OAAO;AAAA,EACvB,SAAS,OAAO;AACd,QAAI,iBAAiB,WAAW,KAAK,GAAG;AACtC,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,eAAkB,WAAsC;AAC5E,MAAI,WAAW;AACb,WAAO,cAAiB,SAAS;AAAA,EACnC;AAEA,QAAM,YAAY,MAAM,mBAAA;AACxB,MAAI,WAAW;AACb,QAAI;AACF,aAAO,UAAU,SAAS;AAAA,IAC5B,SAAS,OAAO;AACd,UAAI,CAAC,iBAAiB,WAAW,KAAK,GAAG;AACvC,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO,cAAiB,SAAS;AACnC;"}

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

@@ -13,7 +13,7 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import { buildHcs10SubmitConnectionRequestTx, buildHcs10OutboundConnectionRequestRecordTx, buildHcs10OutboundConnectionCreatedRecordTx } from "./standards-sdk.es23.js";
 import { HRLResolver } from "./standards-sdk.es109.js";

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

@@ -1,7 +1,7 @@
 import "./standards-sdk.es2.js";
 import { Client, PrivateKey, AccountCreateTransaction, Hbar, CustomFixedFee, AccountId, TokenId, KeyList, TopicMessageSubmitTransaction, Transaction, ScheduleCreateTransaction, Timestamp } from "@hashgraph/sdk";
 import { AccountCreationError, TopicCreationError, ConnectionConfirmationError, PayloadSizeError } from "./standards-sdk.es18.js";
-import { InscriptionSDK } from "./standards-sdk.es141.js";
+import { InscriptionSDK } from "./standards-sdk.es138.js";
 import { Logger } from "./standards-sdk.es105.js";
 import { accountIdsToExemptKeys } from "./standards-sdk.es107.js";
 import { ProgressReporter } from "./standards-sdk.es108.js";
@@ -16,7 +16,7 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import "buffer";
 import "ethers";

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

@@ -12,14 +12,14 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import "buffer";
 import "ethers";
 import "./standards-sdk.es122.js";
 import "./standards-sdk.es113.js";
 import { getTopicId } from "./standards-sdk.es114.js";
-import { InscriptionSDK } from "./standards-sdk.es141.js";
+import { InscriptionSDK } from "./standards-sdk.es138.js";
 import { HCS10BaseClient, Hcs10MemoType } from "./standards-sdk.es17.js";
 import * as mime from "mime-types";
 import { AgentBuilder } from "./standards-sdk.es24.js";

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

@@ -1,6 +1,6 @@
 import { Client, Status, PrivateKey, AccountUpdateTransaction } from "@hashgraph/sdk";
 import { inscribeWithSigner, inscribe } from "./standards-sdk.es124.js";
-import "./standards-sdk.es141.js";
+import "./standards-sdk.es138.js";
 import { Logger } from "./standards-sdk.es105.js";
 import { HederaMirrorNode } from "./standards-sdk.es126.js";
 import { ProgressReporter } from "./standards-sdk.es108.js";
@@ -14,7 +14,7 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import { z } from "zod";
 import "@hashgraph/proto";
 import "buffer";

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

@@ -1,6 +1,6 @@
 import { RegistryType } from "./standards-sdk.es30.js";
 import { inscribe, inscribeWithSigner } from "./standards-sdk.es124.js";
-import "./standards-sdk.es141.js";
+import "./standards-sdk.es138.js";
 class BaseRegistry {
   constructor(networkType, logger, registryType, topicId, client) {
     this.entries = /* @__PURE__ */ new Map();

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

@@ -1,7 +1,7 @@
 import { RegistryType } from "./standards-sdk.es30.js";
 import { BaseRegistry } from "./standards-sdk.es31.js";
 import { retrieveInscription } from "./standards-sdk.es124.js";
-import "./standards-sdk.es141.js";
+import "./standards-sdk.es138.js";
 import { getCryptoAdapter } from "./standards-sdk.es119.js";
 import { isSSREnvironment } from "./standards-sdk.es117.js";
 import { validateActionRegistration } from "./standards-sdk.es43.js";

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

@@ -10,10 +10,10 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import "@hashgraph/sdk";
-import "./standards-sdk.es141.js";
+import "./standards-sdk.es138.js";
 import "@hashgraph/proto";
 import "buffer";
 import "ethers";

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

@@ -3,7 +3,7 @@ import { HCS12BaseClient } from "./standards-sdk.es36.js";
 import { createNodeOperatorContext } from "./standards-sdk.es135.js";
 import { RegistryType } from "./standards-sdk.es30.js";
 import { inscribe } from "./standards-sdk.es124.js";
-import { InscriptionSDK } from "./standards-sdk.es141.js";
+import { InscriptionSDK } from "./standards-sdk.es138.js";
 import { ActionRegistry } from "./standards-sdk.es32.js";
 import { BlockLoader } from "./standards-sdk.es33.js";
 import { AssemblyRegistry } from "./standards-sdk.es34.js";

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

@@ -2,7 +2,7 @@ import { TopicCreateTransaction, TransactionId, AccountId, PublicKey, KeyList, T
 import { HCS12BaseClient } from "./standards-sdk.es36.js";
 import { RegistryType } from "./standards-sdk.es30.js";
 import { inscribeWithSigner } from "./standards-sdk.es124.js";
-import { InscriptionSDK } from "./standards-sdk.es141.js";
+import { InscriptionSDK } from "./standards-sdk.es138.js";
 import { ActionRegistry } from "./standards-sdk.es32.js";
 import { BlockLoader } from "./standards-sdk.es33.js";
 import { AssemblyRegistry } from "./standards-sdk.es34.js";

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

@@ -1,5 +1,5 @@
 import { getCryptoAdapter } from "./standards-sdk.es119.js";
-import { base58Encode } from "./standards-sdk.es137.js";
+import { base58Encode } from "./standards-sdk.es146.js";
 import { canonicalizeAgentData } from "./standards-sdk.es56.js";
 function encodeMultibaseB58btc(input) {
   const bytes = Buffer.from(input, "utf8");

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

@@ -1,6 +1,6 @@
 import { HieroDidResolver } from "./standards-sdk.es60.js";
 import { parseHcs14Did } from "./standards-sdk.es57.js";
-import { multibaseB58btcDecode } from "./standards-sdk.es137.js";
+import { multibaseB58btcDecode } from "./standards-sdk.es146.js";
 class ResolverRegistry {
   constructor() {
     this.resolvers = [];

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

@@ -1,4 +1,4 @@
-import { optionalImport } from "./standards-sdk.es138.js";
+import { optionalImport } from "./standards-sdk.es147.js";
 const hieroResolverModuleId = ["@hiero-did-sdk", "resolver"].join("/");
 let resolverPromise = null;
 async function loadResolveDID() {

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

@@ -19,7 +19,7 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import "@hashgraph/proto";
 import "buffer";

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

@@ -1,4 +1,4 @@
-import { optionalImport } from "./standards-sdk.es138.js";
+import { optionalImport } from "./standards-sdk.es147.js";
 const hieroRegistrarModuleId = ["@hiero-did-sdk", "registrar"].join("/");
 let registrarPromise = null;
 async function loadCreateDID() {

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

@@ -1,4 +1,4 @@
-import { HCS5BaseClient } from "./standards-sdk.es140.js";
+import { HCS5BaseClient } from "./standards-sdk.es139.js";
 import { buildHcs1Hrl } from "./standards-sdk.es64.js";
 import { PrivateKey } from "@hashgraph/sdk";
 import { inscribeWithSigner } from "./standards-sdk.es124.js";

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

@@ -1,4 +1,4 @@
-import { HCS5BaseClient } from "./standards-sdk.es140.js";
+import { HCS5BaseClient } from "./standards-sdk.es139.js";
 import { buildHcs1Hrl } from "./standards-sdk.es64.js";
 import { AccountId } from "@hashgraph/sdk";
 import { inscribe } from "./standards-sdk.es124.js";

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

@@ -10,7 +10,7 @@ import "viem/accounts";
 import "viem/chains";
 import "x402-axios";
 import "x402/types";
-import "./standards-sdk.es139.js";
+import "./standards-sdk.es137.js";
 import "zod";
 import "@hashgraph/sdk";
 import { HCS20_CONSTANTS, HCS20MessageSchema } from "./standards-sdk.es73.js";

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

@@ -1,18 +1,33 @@
 import { z } from "zod";
 const HCS21_PROTOCOL = "hcs-21";
 const HCS21_MAX_MESSAGE_BYTES = 1024;
+const HCS21_REGISTRY_NAMESPACES = [
+  "npm",
+  "pypi",
+  "oci",
+  "composer",
+  "packagist",
+  "cargo",
+  "nuget",
+  "maven",
+  "rubygems",
+  "helm",
+  "go"
+];
 const HCS21MetadataPointerPattern = /^hcs:\/\/1\/0\.0\.\d+\/\d+$/;
 var HCS21TopicType = /* @__PURE__ */ ((HCS21TopicType2) => {
   HCS21TopicType2[HCS21TopicType2["REGISTRY"] = 0] = "REGISTRY";
   return HCS21TopicType2;
 })(HCS21TopicType || {});
-const adapterDeclarationSchema = z.object({
+const packageDeclarationSchema = z.object({
   p: z.literal(HCS21_PROTOCOL),
   op: z.enum(["register", "update"]),
-  registry: z.enum(["npm", "pypi"]),
-  pkg: z.string().min(1),
-  name: z.string().min(1),
-  kind: z.enum(["web2", "web3"]),
+  registry: z.enum(HCS21_REGISTRY_NAMESPACES),
+  t_id: z.string().min(1),
+  n: z.string().min(1),
+  d: z.string().min(1),
+  a: z.string().min(1),
+  tags: z.array(z.string().min(1)).max(16).optional(),
   metadata: z.string().regex(
     HCS21MetadataPointerPattern,
     "metadata must be an HCS-1 HRL (hcs://1/<topicId>/<sequence>)"
@@ -23,6 +38,7 @@ export {
   HCS21TopicType,
   HCS21_MAX_MESSAGE_BYTES,
   HCS21_PROTOCOL,
-  adapterDeclarationSchema
+  HCS21_REGISTRY_NAMESPACES,
+  packageDeclarationSchema
 };
 //# sourceMappingURL=standards-sdk.es80.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es80.js","sources":["../../src/hcs-21/types.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const HCS21_PROTOCOL = 'hcs-21';\nexport const HCS21_MAX_MESSAGE_BYTES = 1024;\n\nexport type AdapterPackageRegistry = 'npm' | 'pypi';\nexport type AdapterPlatformKind = 'web2' | 'web3';\nexport type AdapterOperation = 'register' | 'update';\n\nexport const HCS21MetadataPointerPattern = /^hcs:\\/\\/1\\/0\\.0\\.\\d+\\/\\d+$/;\n\nexport interface AdapterDeclaration {\n  p: typeof HCS21_PROTOCOL;\n  op: AdapterOperation;\n  registry: AdapterPackageRegistry;\n  pkg: string;\n  name: string;\n  kind: AdapterPlatformKind;\n  metadata?: string;\n}\n\nexport interface AdapterMetadataRecord {\n  name: string;\n  pkg: string;\n  registry: AdapterPackageRegistry;\n  kind: AdapterPlatformKind;\n  description?: string;\n  website?: string;\n  source?: string;\n  contact?: string;\n  capabilities?: string[];\n  tags?: string[];\n  [key: string]: unknown;\n}\n\nexport interface AdapterMetadataPointer {\n  pointer: string;\n  topicId: string;\n  sequenceNumber: number;\n  jobId?: string;\n  transactionId?: string;\n}\n\nexport interface AdapterDeclarationEnvelope {\n  declaration: AdapterDeclaration;\n  consensusTimestamp?: string;\n  sequenceNumber: number;\n  payer?: string;\n}\n\nexport enum HCS21TopicType {\n  REGISTRY = 0,\n}\n\nexport const adapterDeclarationSchema = z.object({\n  p: z.literal(HCS21_PROTOCOL),\n  op: z.enum(['register', 'update']),\n  registry: z.enum(['npm', 'pypi']),\n  pkg: z.string().min(1),\n  name: z.string().min(1),\n  kind: z.enum(['web2', 'web3']),\n  metadata: z\n    .string()\n    .regex(\n      HCS21MetadataPointerPattern,\n      'metadata must be an HCS-1 HRL (hcs://1/<topicId>/<sequence>)',\n    )\n    .optional(),\n});\n\nexport type AdapterDeclarationValidation = z.infer<\n  typeof adapterDeclarationSchema\n>;\n"],"names":["HCS21TopicType"],"mappings":";AAEO,MAAM,iBAAiB;AACvB,MAAM,0BAA0B;AAMhC,MAAM,8BAA8B;AAyCpC,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,cAAW,CAAA,IAAX;AADU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAIL,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,GAAG,EAAE,QAAQ,cAAc;AAAA,EAC3B,IAAI,EAAE,KAAK,CAAC,YAAY,QAAQ,CAAC;AAAA,EACjC,UAAU,EAAE,KAAK,CAAC,OAAO,MAAM,CAAC;AAAA,EAChC,KAAK,EAAE,SAAS,IAAI,CAAC;AAAA,EACrB,MAAM,EAAE,SAAS,IAAI,CAAC;AAAA,EACtB,MAAM,EAAE,KAAK,CAAC,QAAQ,MAAM,CAAC;AAAA,EAC7B,UAAU,EACP,OAAA,EACA;AAAA,IACC;AAAA,IACA;AAAA,EAAA,EAED,SAAA;AACL,CAAC;"}
+{"version":3,"file":"standards-sdk.es80.js","sources":["../../src/hcs-21/types.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const HCS21_PROTOCOL = 'hcs-21';\nexport const HCS21_MAX_MESSAGE_BYTES = 1024;\n\nexport const HCS21_REGISTRY_NAMESPACES = [\n  'npm',\n  'pypi',\n  'oci',\n  'composer',\n  'packagist',\n  'cargo',\n  'nuget',\n  'maven',\n  'rubygems',\n  'helm',\n  'go',\n] as const;\n\nexport type PackageRegistryNamespace =\n  (typeof HCS21_REGISTRY_NAMESPACES)[number];\nexport type HCS21Operation = 'register' | 'update';\n\nexport const HCS21MetadataPointerPattern = /^hcs:\\/\\/1\\/0\\.0\\.\\d+\\/\\d+$/;\n\nexport interface PackageDeclaration {\n  p: typeof HCS21_PROTOCOL;\n  op: HCS21Operation;\n  registry: PackageRegistryNamespace;\n  t_id: string;\n  n: string;\n  d: string;\n  a: string;\n  tags?: string[];\n  metadata?: string;\n}\n\nexport interface PackageArtifact {\n  type: string;\n  url: string;\n  digest?: string;\n  signature?: string;\n  [key: string]: unknown;\n}\n\nexport interface PackageMetadataRecord {\n  schema: string;\n  t_id?: string;\n  description?: string;\n  maintainers?: string[];\n  website?: string;\n  docs?: string;\n  source?: string;\n  support?: string;\n  tags?: string[];\n  artifacts?: PackageArtifact[];\n  capabilities?: string[];\n  dependencies?: Record<string, string>;\n  [key: string]: unknown;\n}\n\nexport interface PackageMetadataPointer {\n  pointer: string;\n  topicId: string;\n  sequenceNumber: number;\n  jobId?: string;\n  transactionId?: string;\n}\n\nexport interface PackageDeclarationEnvelope {\n  declaration: PackageDeclaration;\n  consensusTimestamp?: string;\n  sequenceNumber: number;\n  payer?: string;\n}\n\nexport enum HCS21TopicType {\n  REGISTRY = 0,\n}\n\nexport const packageDeclarationSchema = z.object({\n  p: z.literal(HCS21_PROTOCOL),\n  op: z.enum(['register', 'update']),\n  registry: z.enum(HCS21_REGISTRY_NAMESPACES),\n  t_id: z.string().min(1),\n  n: z.string().min(1),\n  d: z.string().min(1),\n  a: z.string().min(1),\n  tags: z.array(z.string().min(1)).max(16).optional(),\n  metadata: z\n    .string()\n    .regex(\n      HCS21MetadataPointerPattern,\n      'metadata must be an HCS-1 HRL (hcs://1/<topicId>/<sequence>)',\n    )\n    .optional(),\n});\n\nexport type PackageDeclarationValidation = z.infer<\n  typeof packageDeclarationSchema\n>;\n"],"names":["HCS21TopicType"],"mappings":";AAEO,MAAM,iBAAiB;AACvB,MAAM,0BAA0B;AAEhC,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMO,MAAM,8BAA8B;AAqDpC,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,cAAW,CAAA,IAAX;AADU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAIL,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,GAAG,EAAE,QAAQ,cAAc;AAAA,EAC3B,IAAI,EAAE,KAAK,CAAC,YAAY,QAAQ,CAAC;AAAA,EACjC,UAAU,EAAE,KAAK,yBAAyB;AAAA,EAC1C,MAAM,EAAE,SAAS,IAAI,CAAC;AAAA,EACtB,GAAG,EAAE,SAAS,IAAI,CAAC;AAAA,EACnB,GAAG,EAAE,SAAS,IAAI,CAAC;AAAA,EACnB,GAAG,EAAE,SAAS,IAAI,CAAC;AAAA,EACnB,MAAM,EAAE,MAAM,EAAE,OAAA,EAAS,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAA;AAAA,EACzC,UAAU,EACP,OAAA,EACA;AAAA,IACC;AAAA,IACA;AAAA,EAAA,EAED,SAAA;AACL,CAAC;"}

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es82.js","sources":["../../src/hcs-21/tx.ts"],"sourcesContent":["import {\n  PublicKey,\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n} from '@hashgraph/sdk';\nimport {\n  buildTopicCreateTx,\n  buildMessageTx,\n  MaybeKey,\n} from '../common/tx/tx-utils';\nimport { AdapterDeclaration, HCS21TopicType } from './types';\n\nexport function buildHcs21RegistryMemo(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n}): string {\n  const indexed = params.indexed ?? 0;\n  return `hcs-21:${indexed}:${params.ttl}:${HCS21TopicType.REGISTRY}`;\n}\n\nexport function buildHcs21CreateRegistryTx(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const memo = buildHcs21RegistryMemo({\n    ttl: params.ttl,\n    indexed: params.indexed,\n  });\n  return buildTopicCreateTx({\n    memo,\n    adminKey: params.adminKey,\n    submitKey: params.submitKey,\n    operatorPublicKey: params.operatorPublicKey,\n  });\n}\n\nexport function buildHcs21MessageTx(params: {\n  topicId: string;\n  declaration: AdapterDeclaration;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(params.declaration),\n    transactionMemo: params.transactionMemo,\n  });\n}\n"],"names":[],"mappings":";;AAYO,SAAS,uBAAuB,QAG5B;AACT,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO,UAAU,OAAO,IAAI,OAAO,GAAG,IAAI,eAAe,QAAQ;AACnE;AAEO,SAAS,2BAA2B,QAMhB;AACzB,QAAM,OAAO,uBAAuB;AAAA,IAClC,KAAK,OAAO;AAAA,IACZ,SAAS,OAAO;AAAA,EAAA,CACjB;AACD,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,mBAAmB,OAAO;AAAA,EAAA,CAC3B;AACH;AAEO,SAAS,oBAAoB,QAIF;AAChC,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO,WAAW;AAAA,IAC1C,iBAAiB,OAAO;AAAA,EAAA,CACzB;AACH;"}
+{"version":3,"file":"standards-sdk.es82.js","sources":["../../src/hcs-21/tx.ts"],"sourcesContent":["import {\n  PublicKey,\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n} from '@hashgraph/sdk';\nimport {\n  buildTopicCreateTx,\n  buildMessageTx,\n  MaybeKey,\n} from '../common/tx/tx-utils';\nimport { HCS21TopicType, PackageDeclaration } from './types';\n\nexport function buildHcs21RegistryMemo(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n}): string {\n  const indexed = params.indexed ?? 0;\n  return `hcs-21:${indexed}:${params.ttl}:${HCS21TopicType.REGISTRY}`;\n}\n\nexport function buildHcs21CreateRegistryTx(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const memo = buildHcs21RegistryMemo({\n    ttl: params.ttl,\n    indexed: params.indexed,\n  });\n  return buildTopicCreateTx({\n    memo,\n    adminKey: params.adminKey,\n    submitKey: params.submitKey,\n    operatorPublicKey: params.operatorPublicKey,\n  });\n}\n\nexport function buildHcs21MessageTx(params: {\n  topicId: string;\n  declaration: PackageDeclaration;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(params.declaration),\n    transactionMemo: params.transactionMemo,\n  });\n}\n"],"names":[],"mappings":";;AAYO,SAAS,uBAAuB,QAG5B;AACT,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO,UAAU,OAAO,IAAI,OAAO,GAAG,IAAI,eAAe,QAAQ;AACnE;AAEO,SAAS,2BAA2B,QAMhB;AACzB,QAAM,OAAO,uBAAuB;AAAA,IAClC,KAAK,OAAO;AAAA,IACZ,SAAS,OAAO;AAAA,EAAA,CACjB;AACD,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,mBAAmB,OAAO;AAAA,EAAA,CAC3B;AACH;AAEO,SAAS,oBAAoB,QAIF;AAChC,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO,WAAW;AAAA,IAC1C,iBAAiB,OAAO;AAAA,EAAA,CACzB;AACH;"}

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

@@ -1,7 +1,7 @@
 import { HederaMirrorNode } from "./standards-sdk.es126.js";
 import { Logger } from "./standards-sdk.es105.js";
 import { HCS21ValidationError } from "./standards-sdk.es81.js";
-import { HCS21_PROTOCOL, adapterDeclarationSchema, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
+import { HCS21_PROTOCOL, packageDeclarationSchema, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
 class HCS21BaseClient {
   constructor(params) {
     this.network = params.network;
@@ -15,9 +15,11 @@ class HCS21BaseClient {
       p: HCS21_PROTOCOL,
       op: params.op,
       registry: params.registry,
-      pkg: params.pkg,
-      name: params.name,
-      kind: params.kind,
+      t_id: params.t_id,
+      n: params.name,
+      d: params.description,
+      a: params.author,
+      tags: params.tags,
       metadata: params.metadata
     };
     return this.validateDeclaration(declaration);
@@ -25,13 +27,13 @@ class HCS21BaseClient {
   validateDeclaration(input) {
     try {
       const payload = typeof input === "string" ? JSON.parse(input) : input;
-      const parsed = adapterDeclarationSchema.parse(
+      const parsed = packageDeclarationSchema.parse(
         payload
       );
       this.assertSizeLimit(parsed);
       return parsed;
     } catch (error) {
-      const message = error instanceof Error ? error.message : "Invalid adapter declaration";
+      const message = error instanceof Error ? error.message : "Invalid package declaration";
       throw new HCS21ValidationError(message, "invalid_payload");
     }
   }

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es83.js","sources":["../../src/hcs-21/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { ILogger, Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21ValidationError } from './errors';\nimport {\n  AdapterDeclaration,\n  AdapterDeclarationEnvelope,\n  AdapterOperation,\n  AdapterPackageRegistry,\n  AdapterPlatformKind,\n  HCS21_MAX_MESSAGE_BYTES,\n  HCS21_PROTOCOL,\n  adapterDeclarationSchema,\n} from './types';\n\nexport interface BuildDeclarationParams {\n  op: AdapterOperation;\n  registry: AdapterPackageRegistry;\n  pkg: string;\n  name: string;\n  kind: AdapterPlatformKind;\n  metadata?: string;\n}\n\nexport interface FetchDeclarationsOptions {\n  limit?: number;\n  order?: 'asc' | 'desc';\n}\n\nexport class HCS21BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly logger: ILogger;\n  protected readonly mirrorNode: HederaMirrorNode;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-21' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  buildDeclaration(params: BuildDeclarationParams): AdapterDeclaration {\n    const declaration: AdapterDeclaration = {\n      p: HCS21_PROTOCOL,\n      op: params.op,\n      registry: params.registry,\n      pkg: params.pkg,\n      name: params.name,\n      kind: params.kind,\n      metadata: params.metadata,\n    };\n\n    return this.validateDeclaration(declaration);\n  }\n\n  validateDeclaration(input: unknown): AdapterDeclaration {\n    try {\n      const payload = typeof input === 'string' ? JSON.parse(input) : input;\n      const parsed = adapterDeclarationSchema.parse(\n        payload,\n      ) as AdapterDeclaration;\n      this.assertSizeLimit(parsed);\n      return parsed;\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : 'Invalid adapter declaration';\n      throw new HCS21ValidationError(message, 'invalid_payload');\n    }\n  }\n\n  async fetchDeclarations(\n    topicId: string,\n    options?: FetchDeclarationsOptions,\n  ): Promise<AdapterDeclarationEnvelope[]> {\n    const rawMessages = await this.mirrorNode.getTopicMessages(topicId, {\n      limit: options?.limit,\n      order: options?.order,\n    });\n\n    const envelopes: AdapterDeclarationEnvelope[] = [];\n\n    for (const message of rawMessages) {\n      if (message.p !== HCS21_PROTOCOL) {\n        continue;\n      }\n\n      try {\n        const declaration = this.validateDeclaration(message);\n        envelopes.push({\n          declaration,\n          consensusTimestamp: message.consensus_timestamp,\n          sequenceNumber: message.sequence_number,\n          payer: message.payer,\n        });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : 'unknown error';\n        this.logger.warn(`Skipping invalid HCS-21 message: ${detail}`);\n      }\n    }\n\n    return envelopes;\n  }\n\n  protected assertSizeLimit(payload: AdapterDeclaration): void {\n    const json = JSON.stringify(payload);\n    const bytes = Buffer.byteLength(json, 'utf8');\n    if (bytes > HCS21_MAX_MESSAGE_BYTES) {\n      throw new HCS21ValidationError(\n        `HCS-21 payload exceeds 1024 bytes (${bytes})`,\n        'size_exceeded',\n      );\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AA6BO,MAAM,gBAAgB;AAAA,EAK3B,YAAY,QAIT;AACD,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UAAU,IAAI,OAAO,EAAE,OAAO,QAAQ,QAAQ,UAAU;AACjE,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,QAAQ;AAAA,MAChE,WAAW,OAAO;AAAA,IAAA,CACnB;AAAA,EACH;AAAA,EAEA,iBAAiB,QAAoD;AACnE,UAAM,cAAkC;AAAA,MACtC,GAAG;AAAA,MACH,IAAI,OAAO;AAAA,MACX,UAAU,OAAO;AAAA,MACjB,KAAK,OAAO;AAAA,MACZ,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,IAAA;AAGnB,WAAO,KAAK,oBAAoB,WAAW;AAAA,EAC7C;AAAA,EAEA,oBAAoB,OAAoC;AACtD,QAAI;AACF,YAAM,UAAU,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAChE,YAAM,SAAS,yBAAyB;AAAA,QACtC;AAAA,MAAA;AAEF,WAAK,gBAAgB,MAAM;AAC3B,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,YAAM,IAAI,qBAAqB,SAAS,iBAAiB;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,SACA,SACuC;AACvC,UAAM,cAAc,MAAM,KAAK,WAAW,iBAAiB,SAAS;AAAA,MAClE,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,IAAA,CACjB;AAED,UAAM,YAA0C,CAAA;AAEhD,eAAW,WAAW,aAAa;AACjC,UAAI,QAAQ,MAAM,gBAAgB;AAChC;AAAA,MACF;AAEA,UAAI;AACF,cAAM,cAAc,KAAK,oBAAoB,OAAO;AACpD,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,oBAAoB,QAAQ;AAAA,UAC5B,gBAAgB,QAAQ;AAAA,UACxB,OAAO,QAAQ;AAAA,QAAA,CAChB;AAAA,MACH,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,aAAK,OAAO,KAAK,oCAAoC,MAAM,EAAE;AAAA,MAC/D;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEU,gBAAgB,SAAmC;AAC3D,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,QAAQ,OAAO,WAAW,MAAM,MAAM;AAC5C,QAAI,QAAQ,yBAAyB;AACnC,YAAM,IAAI;AAAA,QACR,sCAAsC,KAAK;AAAA,QAC3C;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;"}
+{"version":3,"file":"standards-sdk.es83.js","sources":["../../src/hcs-21/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { ILogger, Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21ValidationError } from './errors';\nimport {\n  HCS21_MAX_MESSAGE_BYTES,\n  HCS21Operation,\n  HCS21_PROTOCOL,\n  PackageDeclaration,\n  PackageDeclarationEnvelope,\n  PackageRegistryNamespace,\n  packageDeclarationSchema,\n} from './types';\n\nexport interface BuildDeclarationParams {\n  op: HCS21Operation;\n  registry: PackageRegistryNamespace;\n  t_id: string;\n  name: string;\n  description: string;\n  author: string;\n  tags?: string[];\n  metadata?: string;\n}\n\nexport interface FetchDeclarationsOptions {\n  limit?: number;\n  order?: 'asc' | 'desc';\n}\n\nexport class HCS21BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly logger: ILogger;\n  protected readonly mirrorNode: HederaMirrorNode;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-21' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  buildDeclaration(params: BuildDeclarationParams): PackageDeclaration {\n    const declaration: PackageDeclaration = {\n      p: HCS21_PROTOCOL,\n      op: params.op,\n      registry: params.registry,\n      t_id: params.t_id,\n      n: params.name,\n      d: params.description,\n      a: params.author,\n      tags: params.tags,\n      metadata: params.metadata,\n    };\n\n    return this.validateDeclaration(declaration);\n  }\n\n  validateDeclaration(input: unknown): PackageDeclaration {\n    try {\n      const payload = typeof input === 'string' ? JSON.parse(input) : input;\n      const parsed = packageDeclarationSchema.parse(\n        payload,\n      ) as PackageDeclaration;\n      this.assertSizeLimit(parsed);\n      return parsed;\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : 'Invalid package declaration';\n      throw new HCS21ValidationError(message, 'invalid_payload');\n    }\n  }\n\n  async fetchDeclarations(\n    topicId: string,\n    options?: FetchDeclarationsOptions,\n  ): Promise<PackageDeclarationEnvelope[]> {\n    const rawMessages = await this.mirrorNode.getTopicMessages(topicId, {\n      limit: options?.limit,\n      order: options?.order,\n    });\n\n    const envelopes: PackageDeclarationEnvelope[] = [];\n\n    for (const message of rawMessages) {\n      if (message.p !== HCS21_PROTOCOL) {\n        continue;\n      }\n\n      try {\n        const declaration = this.validateDeclaration(message);\n        envelopes.push({\n          declaration,\n          consensusTimestamp: message.consensus_timestamp,\n          sequenceNumber: message.sequence_number,\n          payer: message.payer,\n        });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : 'unknown error';\n        this.logger.warn(`Skipping invalid HCS-21 message: ${detail}`);\n      }\n    }\n\n    return envelopes;\n  }\n\n  protected assertSizeLimit(payload: PackageDeclaration): void {\n    const json = JSON.stringify(payload);\n    const bytes = Buffer.byteLength(json, 'utf8');\n    if (bytes > HCS21_MAX_MESSAGE_BYTES) {\n      throw new HCS21ValidationError(\n        `HCS-21 payload exceeds 1024 bytes (${bytes})`,\n        'size_exceeded',\n      );\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AA8BO,MAAM,gBAAgB;AAAA,EAK3B,YAAY,QAIT;AACD,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UAAU,IAAI,OAAO,EAAE,OAAO,QAAQ,QAAQ,UAAU;AACjE,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,QAAQ;AAAA,MAChE,WAAW,OAAO;AAAA,IAAA,CACnB;AAAA,EACH;AAAA,EAEA,iBAAiB,QAAoD;AACnE,UAAM,cAAkC;AAAA,MACtC,GAAG;AAAA,MACH,IAAI,OAAO;AAAA,MACX,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,GAAG,OAAO;AAAA,MACV,GAAG,OAAO;AAAA,MACV,GAAG,OAAO;AAAA,MACV,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,IAAA;AAGnB,WAAO,KAAK,oBAAoB,WAAW;AAAA,EAC7C;AAAA,EAEA,oBAAoB,OAAoC;AACtD,QAAI;AACF,YAAM,UAAU,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAChE,YAAM,SAAS,yBAAyB;AAAA,QACtC;AAAA,MAAA;AAEF,WAAK,gBAAgB,MAAM;AAC3B,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,YAAM,IAAI,qBAAqB,SAAS,iBAAiB;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,SACA,SACuC;AACvC,UAAM,cAAc,MAAM,KAAK,WAAW,iBAAiB,SAAS;AAAA,MAClE,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,IAAA,CACjB;AAED,UAAM,YAA0C,CAAA;AAEhD,eAAW,WAAW,aAAa;AACjC,UAAI,QAAQ,MAAM,gBAAgB;AAChC;AAAA,MACF;AAEA,UAAI;AACF,cAAM,cAAc,KAAK,oBAAoB,OAAO;AACpD,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,oBAAoB,QAAQ;AAAA,UAC5B,gBAAgB,QAAQ;AAAA,UACxB,OAAO,QAAQ;AAAA,QAAA,CAChB;AAAA,MACH,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,aAAK,OAAO,KAAK,oCAAoC,MAAM,EAAE;AAAA,MAC/D;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEU,gBAAgB,SAAmC;AAC3D,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,QAAQ,OAAO,WAAW,MAAM,MAAM;AAC5C,QAAI,QAAQ,yBAAyB;AACnC,YAAM,IAAI;AAAA,QACR,sCAAsC,KAAK;AAAA,QAC3C;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;"}

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

@@ -44,7 +44,7 @@ class HCS21Client extends HCS21BaseClient {
       {
         type: "buffer",
         buffer,
-        fileName: params.fileName || `hcs21-adapter-metadata-${Date.now()}.json`,
+        fileName: params.fileName || `hcs21-package-metadata-${Date.now()}.json`,
         mimeType: "application/json"
       },
       {
@@ -56,7 +56,7 @@ class HCS21Client extends HCS21BaseClient {
     );
     if (!inscription.confirmed || !inscription.inscription) {
       throw new HCS21ValidationError(
-        "Failed to inscribe adapter metadata",
+        "Failed to inscribe package metadata",
         "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  AdapterDeclaration,\n  AdapterMetadataPointer,\n  AdapterMetadataRecord,\n  HCS21MetadataPointerPattern,\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: AdapterDeclaration | BuildDeclarationParams;\n  transactionMemo?: string;\n}\n\nexport interface InscribeAdapterMetadataParams {\n  metadata: AdapterMetadataRecord;\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: InscribeAdapterMetadataParams,\n  ): Promise<AdapterMetadataPointer> {\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-adapter-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 adapter 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: 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 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  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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"}

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es85.js","sources":["../../src/hcs-21/browser.ts"],"sourcesContent":["import type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21BaseClient, BuildDeclarationParams } from './base-client';\nimport { AdapterDeclaration, AdapterDeclarationEnvelope } from './types';\n\nexport interface BrowserHCS21ClientConfig {\n  network: NetworkType;\n  hwc: HashinalsWalletConnectSDK;\n  logger?: ILogger;\n}\n\nexport class HCS21BrowserClient extends HCS21BaseClient {\n  private readonly hwc: HashinalsWalletConnectSDK;\n\n  constructor(config: BrowserHCS21ClientConfig) {\n    super({ network: config.network, logger: config.logger });\n    this.hwc = config.hwc;\n  }\n\n  async publishDeclaration(params: {\n    topicId: string;\n    declaration: AdapterDeclaration | BuildDeclarationParams;\n  }): Promise<void> {\n    const declaration =\n      'p' in params.declaration\n        ? this.validateDeclaration(params.declaration)\n        : this.buildDeclaration(params.declaration);\n\n    await this.hwc.submitMessageToTopic(\n      params.topicId,\n      JSON.stringify(declaration),\n    );\n  }\n\n  async fetchDeclarations(\n    topicId: string,\n  ): Promise<AdapterDeclarationEnvelope[]> {\n    const { messages = [] } = await this.hwc.getMessages(topicId);\n    const envelopes: AdapterDeclarationEnvelope[] = [];\n\n    for (const message of messages) {\n      try {\n        const declaration = this.validateDeclaration(message.message);\n        envelopes.push({\n          declaration,\n          consensusTimestamp: message.consensus_timestamp,\n          sequenceNumber: Number(message.sequence_number || 0),\n          payer: message.payer_account_id,\n        });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : 'unknown error';\n        this.logger.warn(`Skipping invalid HCS-21 browser message: ${detail}`);\n      }\n    }\n\n    return envelopes;\n  }\n}\n"],"names":[],"mappings":";AAYO,MAAM,2BAA2B,gBAAgB;AAAA,EAGtD,YAAY,QAAkC;AAC5C,UAAM,EAAE,SAAS,OAAO,SAAS,QAAQ,OAAO,QAAQ;AACxD,SAAK,MAAM,OAAO;AAAA,EACpB;AAAA,EAEA,MAAM,mBAAmB,QAGP;AAChB,UAAM,cACJ,OAAO,OAAO,cACV,KAAK,oBAAoB,OAAO,WAAW,IAC3C,KAAK,iBAAiB,OAAO,WAAW;AAE9C,UAAM,KAAK,IAAI;AAAA,MACb,OAAO;AAAA,MACP,KAAK,UAAU,WAAW;AAAA,IAAA;AAAA,EAE9B;AAAA,EAEA,MAAM,kBACJ,SACuC;AACvC,UAAM,EAAE,WAAW,GAAC,IAAM,MAAM,KAAK,IAAI,YAAY,OAAO;AAC5D,UAAM,YAA0C,CAAA;AAEhD,eAAW,WAAW,UAAU;AAC9B,UAAI;AACF,cAAM,cAAc,KAAK,oBAAoB,QAAQ,OAAO;AAC5D,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,oBAAoB,QAAQ;AAAA,UAC5B,gBAAgB,OAAO,QAAQ,mBAAmB,CAAC;AAAA,UACnD,OAAO,QAAQ;AAAA,QAAA,CAChB;AAAA,MACH,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,aAAK,OAAO,KAAK,4CAA4C,MAAM,EAAE;AAAA,MACvE;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-sdk.es85.js","sources":["../../src/hcs-21/browser.ts"],"sourcesContent":["import type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21BaseClient, BuildDeclarationParams } from './base-client';\nimport { PackageDeclaration, PackageDeclarationEnvelope } from './types';\n\nexport interface BrowserHCS21ClientConfig {\n  network: NetworkType;\n  hwc: HashinalsWalletConnectSDK;\n  logger?: ILogger;\n}\n\nexport class HCS21BrowserClient extends HCS21BaseClient {\n  private readonly hwc: HashinalsWalletConnectSDK;\n\n  constructor(config: BrowserHCS21ClientConfig) {\n    super({ network: config.network, logger: config.logger });\n    this.hwc = config.hwc;\n  }\n\n  async publishDeclaration(params: {\n    topicId: string;\n    declaration: PackageDeclaration | BuildDeclarationParams;\n  }): Promise<void> {\n    const declaration =\n      'p' in params.declaration\n        ? this.validateDeclaration(params.declaration)\n        : this.buildDeclaration(params.declaration);\n\n    await this.hwc.submitMessageToTopic(\n      params.topicId,\n      JSON.stringify(declaration),\n    );\n  }\n\n  async fetchDeclarations(\n    topicId: string,\n  ): Promise<PackageDeclarationEnvelope[]> {\n    const { messages = [] } = await this.hwc.getMessages(topicId);\n    const envelopes: PackageDeclarationEnvelope[] = [];\n\n    for (const message of messages) {\n      try {\n        const declaration = this.validateDeclaration(message.message);\n        envelopes.push({\n          declaration,\n          consensusTimestamp: message.consensus_timestamp,\n          sequenceNumber: Number(message.sequence_number || 0),\n          payer: message.payer_account_id,\n        });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : 'unknown error';\n        this.logger.warn(`Skipping invalid HCS-21 browser message: ${detail}`);\n      }\n    }\n\n    return envelopes;\n  }\n}\n"],"names":[],"mappings":";AAYO,MAAM,2BAA2B,gBAAgB;AAAA,EAGtD,YAAY,QAAkC;AAC5C,UAAM,EAAE,SAAS,OAAO,SAAS,QAAQ,OAAO,QAAQ;AACxD,SAAK,MAAM,OAAO;AAAA,EACpB;AAAA,EAEA,MAAM,mBAAmB,QAGP;AAChB,UAAM,cACJ,OAAO,OAAO,cACV,KAAK,oBAAoB,OAAO,WAAW,IAC3C,KAAK,iBAAiB,OAAO,WAAW;AAE9C,UAAM,KAAK,IAAI;AAAA,MACb,OAAO;AAAA,MACP,KAAK,UAAU,WAAW;AAAA,IAAA;AAAA,EAE9B;AAAA,EAEA,MAAM,kBACJ,SACuC;AACvC,UAAM,EAAE,WAAW,GAAC,IAAM,MAAM,KAAK,IAAI,YAAY,OAAO;AAC5D,UAAM,YAA0C,CAAA;AAEhD,eAAW,WAAW,UAAU;AAC9B,UAAI;AACF,cAAM,cAAc,KAAK,oBAAoB,QAAQ,OAAO;AAC5D,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,oBAAoB,QAAQ;AAAA,UAC5B,gBAAgB,OAAO,QAAQ,mBAAmB,CAAC;AAAA,UACnD,OAAO,QAAQ;AAAA,QAAA,CAChB;AAAA,MACH,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,aAAK,OAAO,KAAK,4CAA4C,MAAM,EAAE;AAAA,MACvE;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;"}