@hashgraphonline/standards-sdk 0.1.141 → 0.1.143

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

@@ -1,44 +1,128 @@
 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+$/;
+const HCS21_SAFE_MESSAGE_BYTES = 1e3;
+const HCS21ManifestPointerPattern = /^(?:hcs:\/\/1\/0\.0\.\d+|ipfs:\/\/\S+|ar:\/\/\S+|oci:\/\/\S+|https?:\/\/\S+)$/;
+const HCS21TopicIdPattern = /^0\.0\.\d+$/;
+const HCS21MetadataPointerPattern = /^(?:0\.0\.\d+|hcs:\/\/1\/0\.0\.\d+(?:\/\d+)?|ipfs:\/\/\S+|ar:\/\/\S+|oci:\/\/\S+|https?:\/\/\S+)$/;
 var HCS21TopicType = /* @__PURE__ */ ((HCS21TopicType2) => {
-  HCS21TopicType2[HCS21TopicType2["REGISTRY"] = 0] = "REGISTRY";
+  HCS21TopicType2[HCS21TopicType2["ADAPTER_REGISTRY"] = 0] = "ADAPTER_REGISTRY";
+  HCS21TopicType2[HCS21TopicType2["REGISTRY_OF_REGISTRIES"] = 1] = "REGISTRY_OF_REGISTRIES";
+  HCS21TopicType2[HCS21TopicType2["ADAPTER_CATEGORY"] = 2] = "ADAPTER_CATEGORY";
   return HCS21TopicType2;
 })(HCS21TopicType || {});
-const packageDeclarationSchema = z.object({
+const adapterPackageSchema = z.object({
+  registry: z.string().min(1),
+  name: z.string().min(1),
+  version: z.string().min(1),
+  integrity: z.string().min(1)
+});
+const adapterConfigContextSchema = z.object({
+  type: z.string().min(1),
+  account: z.string().min(1).optional(),
+  threshold: z.string().min(1).optional(),
+  ctopic: z.string().min(1).optional(),
+  ttopic: z.string().min(1).optional(),
+  stopic: z.string().min(1).optional()
+}).catchall(z.unknown());
+const adapterDeclarationSchema = z.object({
   p: z.literal(HCS21_PROTOCOL),
-  op: z.enum(["register", "update"]),
-  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>)"
-  ).optional()
+  op: z.enum(["register", "update", "delete"]),
+  adapter_id: z.string().min(1),
+  entity: z.string().min(1),
+  package: adapterPackageSchema,
+  manifest: z.string().regex(
+    HCS21ManifestPointerPattern,
+    "manifest must be an immutable pointer (hcs://1/<topicId>, ipfs://cid/path, ar://txid, oci://repo@digest, https://...#sha384-..)"
+  ),
+  manifest_sequence: z.number().int().positive().optional(),
+  config: adapterConfigContextSchema,
+  state_model: z.string().min(1).optional(),
+  signature: z.string().min(1).optional()
+});
+const adapterManifestSchema = z.object({
+  meta: z.object({
+    spec_version: z.string().min(1),
+    adapter_version: z.string().min(1),
+    minimum_version: z.string().min(1).optional(),
+    generated: z.string().min(1)
+  }),
+  adapter: z.object({
+    name: z.string().min(1),
+    id: z.string().min(1),
+    maintainers: z.array(
+      z.object({
+        name: z.string().min(1),
+        contact: z.string().min(1)
+      })
+    ).min(1),
+    license: z.string().min(1)
+  }),
+  package: z.object({
+    registry: z.string().min(1),
+    dist_tag: z.string().min(1).optional(),
+    artifacts: z.array(
+      z.object({
+        url: z.string().min(1),
+        digest: z.string().min(1),
+        signature: z.string().min(1).optional()
+      })
+    ).min(1)
+  }),
+  runtime: z.object({
+    platforms: z.array(z.string().min(1)).min(1),
+    primary: z.string().min(1),
+    entry: z.string().min(1),
+    dependencies: z.array(z.string().min(1)).optional(),
+    env: z.array(z.string().min(1)).optional()
+  }),
+  capabilities: z.object({
+    discovery: z.boolean(),
+    communication: z.boolean(),
+    protocols: z.array(z.string().min(1)),
+    discovery_tags: z.array(z.string().min(1)).optional(),
+    communication_channels: z.array(z.string().min(1)).optional(),
+    extras: z.record(z.string(), z.unknown()).optional()
+  }),
+  consensus: z.object({
+    state_model: z.string().min(1).optional(),
+    profile_uri: z.string().min(1).optional(),
+    entity_schema: z.string().min(1).optional(),
+    required_fields: z.array(z.string().min(1)),
+    hashing: z.literal("sha384")
+  })
+});
+const registryMetadataSchema = z.object({
+  version: z.string().min(1),
+  name: z.string().min(1),
+  description: z.string().min(1),
+  operator: z.object({
+    account: z.string().min(1),
+    name: z.string().optional(),
+    contact: z.string().optional()
+  }),
+  entityTypes: z.array(z.string().min(1)),
+  categories: z.array(z.string().min(1)).optional(),
+  tags: z.array(z.string().min(1)).optional(),
+  links: z.record(z.string().min(1)).optional()
 });
+const metadataDocumentSchema = z.union([
+  adapterManifestSchema,
+  registryMetadataSchema
+]);
 export {
+  HCS21ManifestPointerPattern,
   HCS21MetadataPointerPattern,
+  HCS21TopicIdPattern,
   HCS21TopicType,
   HCS21_MAX_MESSAGE_BYTES,
   HCS21_PROTOCOL,
-  HCS21_REGISTRY_NAMESPACES,
-  packageDeclarationSchema
+  HCS21_SAFE_MESSAGE_BYTES,
+  adapterConfigContextSchema,
+  adapterDeclarationSchema,
+  adapterManifestSchema,
+  adapterPackageSchema,
+  metadataDocumentSchema,
+  registryMetadataSchema
 };
 //# 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 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;"}
+{"version":3,"file":"standards-sdk.es80.js","sources":["../../src/hcs-21/types.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { QuoteResult } from '../inscribe/types';\n\nexport const HCS21_PROTOCOL = 'hcs-21';\nexport const HCS21_MAX_MESSAGE_BYTES = 1024;\nexport const HCS21_SAFE_MESSAGE_BYTES = 1000;\nexport const HCS21ManifestPointerPattern =\n  /^(?:hcs:\\/\\/1\\/0\\.0\\.\\d+|ipfs:\\/\\/\\S+|ar:\\/\\/\\S+|oci:\\/\\/\\S+|https?:\\/\\/\\S+)$/;\nexport const HCS21TopicIdPattern = /^0\\.0\\.\\d+$/;\nexport const HCS21MetadataPointerPattern =\n  /^(?:0\\.0\\.\\d+|hcs:\\/\\/1\\/0\\.0\\.\\d+(?:\\/\\d+)?|ipfs:\\/\\/\\S+|ar:\\/\\/\\S+|oci:\\/\\/\\S+|https?:\\/\\/\\S+)$/;\n\nexport type HCS21Operation = 'register' | 'update' | 'delete';\n\nexport interface AdapterPackage {\n  registry: string;\n  name: string;\n  version: string;\n  integrity: string;\n}\n\nexport interface AdapterConfigContext {\n  type: string;\n  account?: string;\n  threshold?: string;\n  ctopic?: string;\n  ttopic?: string;\n  stopic?: string;\n  [key: string]: unknown;\n}\n\nexport interface AdapterDeclaration {\n  p: typeof HCS21_PROTOCOL;\n  op: HCS21Operation;\n  adapter_id: string;\n  entity: string;\n  package: AdapterPackage;\n  manifest: string;\n  manifest_sequence?: number;\n  config: AdapterConfigContext;\n  state_model?: string;\n  signature?: string;\n}\n\nexport interface AdapterDeclarationEnvelope {\n  declaration: AdapterDeclaration;\n  consensusTimestamp?: string;\n  sequenceNumber: number;\n  payer?: string;\n}\n\nexport enum HCS21TopicType {\n  ADAPTER_REGISTRY = 0,\n  REGISTRY_OF_REGISTRIES = 1,\n  ADAPTER_CATEGORY = 2,\n}\n\nexport interface AdapterCategoryEntry {\n  adapterId: string;\n  adapterTopicId: string;\n  metadata?: string;\n  memo?: string;\n  payer?: string;\n  sequenceNumber: number;\n  consensusTimestamp?: string;\n}\n\nexport interface ManifestPointer {\n  pointer: string;\n  topicId: string;\n  sequenceNumber: number;\n  manifestSequence?: number;\n  jobId?: string;\n  transactionId?: string;\n  totalCostHbar?: string;\n  costBreakdown?: QuoteResult['breakdown'];\n}\n\nexport const adapterPackageSchema = z.object({\n  registry: z.string().min(1),\n  name: z.string().min(1),\n  version: z.string().min(1),\n  integrity: z.string().min(1),\n});\n\nexport const adapterConfigContextSchema = z\n  .object({\n    type: z.string().min(1),\n    account: z.string().min(1).optional(),\n    threshold: z.string().min(1).optional(),\n    ctopic: z.string().min(1).optional(),\n    ttopic: z.string().min(1).optional(),\n    stopic: z.string().min(1).optional(),\n  })\n  .catchall(z.unknown());\n\nexport const adapterDeclarationSchema = z.object({\n  p: z.literal(HCS21_PROTOCOL),\n  op: z.enum(['register', 'update', 'delete']),\n  adapter_id: z.string().min(1),\n  entity: z.string().min(1),\n  package: adapterPackageSchema,\n  manifest: z\n    .string()\n    .regex(\n      HCS21ManifestPointerPattern,\n      'manifest must be an immutable pointer (hcs://1/<topicId>, ipfs://cid/path, ar://txid, oci://repo@digest, https://...#sha384-..)',\n    ),\n  manifest_sequence: z.number().int().positive().optional(),\n  config: adapterConfigContextSchema,\n  state_model: z.string().min(1).optional(),\n  signature: z.string().min(1).optional(),\n});\n\nexport const adapterManifestSchema = z.object({\n  meta: z.object({\n    spec_version: z.string().min(1),\n    adapter_version: z.string().min(1),\n    minimum_version: z.string().min(1).optional(),\n    generated: z.string().min(1),\n  }),\n  adapter: z.object({\n    name: z.string().min(1),\n    id: z.string().min(1),\n    maintainers: z\n      .array(\n        z.object({\n          name: z.string().min(1),\n          contact: z.string().min(1),\n        }),\n      )\n      .min(1),\n    license: z.string().min(1),\n  }),\n  package: z.object({\n    registry: z.string().min(1),\n    dist_tag: z.string().min(1).optional(),\n    artifacts: z\n      .array(\n        z.object({\n          url: z.string().min(1),\n          digest: z.string().min(1),\n          signature: z.string().min(1).optional(),\n        }),\n      )\n      .min(1),\n  }),\n  runtime: z.object({\n    platforms: z.array(z.string().min(1)).min(1),\n    primary: z.string().min(1),\n    entry: z.string().min(1),\n    dependencies: z.array(z.string().min(1)).optional(),\n    env: z.array(z.string().min(1)).optional(),\n  }),\n  capabilities: z.object({\n    discovery: z.boolean(),\n    communication: z.boolean(),\n    protocols: z.array(z.string().min(1)),\n    discovery_tags: z.array(z.string().min(1)).optional(),\n    communication_channels: z.array(z.string().min(1)).optional(),\n    extras: z.record(z.string(), z.unknown()).optional(),\n  }),\n  consensus: z.object({\n    state_model: z.string().min(1).optional(),\n    profile_uri: z.string().min(1).optional(),\n    entity_schema: z.string().min(1).optional(),\n    required_fields: z.array(z.string().min(1)),\n    hashing: z.literal('sha384'),\n  }),\n});\n\nexport const registryMetadataSchema = z.object({\n  version: z.string().min(1),\n  name: z.string().min(1),\n  description: z.string().min(1),\n  operator: z.object({\n    account: z.string().min(1),\n    name: z.string().optional(),\n    contact: z.string().optional(),\n  }),\n  entityTypes: z.array(z.string().min(1)),\n  categories: z.array(z.string().min(1)).optional(),\n  tags: z.array(z.string().min(1)).optional(),\n  links: z.record(z.string().min(1)).optional(),\n});\n\nexport const metadataDocumentSchema = z.union([\n  adapterManifestSchema,\n  registryMetadataSchema,\n]);\n\nexport type AdapterDeclarationValidation = z.infer<\n  typeof adapterDeclarationSchema\n>;\nexport type AdapterManifest = z.infer<typeof adapterManifestSchema>;\nexport type RegistryMetadataRecord = z.infer<typeof registryMetadataSchema>;\nexport type HCS21MetadataDocument = AdapterManifest | RegistryMetadataRecord;\n"],"names":["HCS21TopicType"],"mappings":"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"}

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

@@ -1,13 +1,24 @@
-import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es136.js";
-import { HCS21TopicType } from "./standards-sdk.es80.js";
+import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es137.js";
+import { HCS21TopicType, HCS21MetadataPointerPattern, HCS21_SAFE_MESSAGE_BYTES, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
+import { HCS21ValidationError } from "./standards-sdk.es81.js";
 function buildHcs21RegistryMemo(params) {
   const indexed = params.indexed ?? 0;
-  return `hcs-21:${indexed}:${params.ttl}:${HCS21TopicType.REGISTRY}`;
+  const topicType = params.type ?? HCS21TopicType.ADAPTER_REGISTRY;
+  if (params.metaTopicId && !HCS21MetadataPointerPattern.test(params.metaTopicId)) {
+    throw new HCS21ValidationError(
+      "Meta value must be a short pointer (topic ID, HRL, IPFS, Arweave, OCI, or HTTPS)",
+      "invalid_payload"
+    );
+  }
+  const metaSegment = params.metaTopicId ? `:${params.metaTopicId}` : "";
+  return `hcs-21:${indexed}:${params.ttl}:${topicType}${metaSegment}`;
 }
 function buildHcs21CreateRegistryTx(params) {
   const memo = buildHcs21RegistryMemo({
     ttl: params.ttl,
-    indexed: params.indexed
+    indexed: params.indexed,
+    type: params.type,
+    metaTopicId: params.metaTopicId
   });
   return buildTopicCreateTx({
     memo,
@@ -17,6 +28,14 @@ function buildHcs21CreateRegistryTx(params) {
   });
 }
 function buildHcs21MessageTx(params) {
+  const json = JSON.stringify(params.declaration);
+  const bytes = Buffer.byteLength(json, "utf8");
+  if (bytes > HCS21_SAFE_MESSAGE_BYTES) {
+    throw new HCS21ValidationError(
+      `HCS-21 payload exceeds safe limit of ${HCS21_SAFE_MESSAGE_BYTES} bytes (${bytes}); Hedera cap is ${HCS21_MAX_MESSAGE_BYTES}`,
+      "size_exceeded"
+    );
+  }
   return buildMessageTx({
     topicId: params.topicId,
     message: JSON.stringify(params.declaration),

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 { 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;"}
+{"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 {\n  HCS21TopicType,\n  AdapterDeclaration,\n  HCS21MetadataPointerPattern,\n  HCS21_SAFE_MESSAGE_BYTES,\n  HCS21_MAX_MESSAGE_BYTES,\n} from './types';\nimport { HCS21ValidationError } from './errors';\n\nexport function buildHcs21RegistryMemo(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n  type?: HCS21TopicType;\n  metaTopicId?: string;\n}): string {\n  const indexed = params.indexed ?? 0;\n  const topicType = params.type ?? HCS21TopicType.ADAPTER_REGISTRY;\n\n  if (\n    params.metaTopicId &&\n    !HCS21MetadataPointerPattern.test(params.metaTopicId)\n  ) {\n    throw new HCS21ValidationError(\n      'Meta value must be a short pointer (topic ID, HRL, IPFS, Arweave, OCI, or HTTPS)',\n      'invalid_payload',\n    );\n  }\n\n  const metaSegment = params.metaTopicId ? `:${params.metaTopicId}` : '';\n  return `hcs-21:${indexed}:${params.ttl}:${topicType}${metaSegment}`;\n}\n\nexport function buildHcs21CreateRegistryTx(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n  type?: HCS21TopicType;\n  metaTopicId?: string;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const memo = buildHcs21RegistryMemo({\n    ttl: params.ttl,\n    indexed: params.indexed,\n    type: params.type,\n    metaTopicId: params.metaTopicId,\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  const json = JSON.stringify(params.declaration);\n  const bytes = Buffer.byteLength(json, 'utf8');\n  if (bytes > HCS21_SAFE_MESSAGE_BYTES) {\n    throw new HCS21ValidationError(\n      `HCS-21 payload exceeds safe limit of ${HCS21_SAFE_MESSAGE_BYTES} bytes (${bytes}); Hedera cap is ${HCS21_MAX_MESSAGE_BYTES}`,\n      'size_exceeded',\n    );\n  }\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(params.declaration),\n    transactionMemo: params.transactionMemo,\n  });\n}\n"],"names":[],"mappings":";;;AAmBO,SAAS,uBAAuB,QAK5B;AACT,QAAM,UAAU,OAAO,WAAW;AAClC,QAAM,YAAY,OAAO,QAAQ,eAAe;AAEhD,MACE,OAAO,eACP,CAAC,4BAA4B,KAAK,OAAO,WAAW,GACpD;AACA,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,cAAc,OAAO,cAAc,IAAI,OAAO,WAAW,KAAK;AACpE,SAAO,UAAU,OAAO,IAAI,OAAO,GAAG,IAAI,SAAS,GAAG,WAAW;AACnE;AAEO,SAAS,2BAA2B,QAQhB;AACzB,QAAM,OAAO,uBAAuB;AAAA,IAClC,KAAK,OAAO;AAAA,IACZ,SAAS,OAAO;AAAA,IAChB,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,EAAA,CACrB;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,QAAM,OAAO,KAAK,UAAU,OAAO,WAAW;AAC9C,QAAM,QAAQ,OAAO,WAAW,MAAM,MAAM;AAC5C,MAAI,QAAQ,0BAA0B;AACpC,UAAM,IAAI;AAAA,MACR,wCAAwC,wBAAwB,WAAW,KAAK,oBAAoB,uBAAuB;AAAA,MAC3H;AAAA,IAAA;AAAA,EAEJ;AACA,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 { HederaMirrorNode } from "./standards-sdk.es127.js";
+import { Logger } from "./standards-sdk.es106.js";
 import { HCS21ValidationError } from "./standards-sdk.es81.js";
-import { HCS21_PROTOCOL, packageDeclarationSchema, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
+import { HCS21_PROTOCOL, adapterDeclarationSchema, HCS21_SAFE_MESSAGE_BYTES, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
 class HCS21BaseClient {
   constructor(params) {
     this.network = params.network;
@@ -14,26 +14,27 @@ class HCS21BaseClient {
     const declaration = {
       p: HCS21_PROTOCOL,
       op: params.op,
-      registry: params.registry,
-      t_id: params.t_id,
-      n: params.name,
-      d: params.description,
-      a: params.author,
-      tags: params.tags,
-      metadata: params.metadata
+      adapter_id: params.adapterId,
+      entity: params.entity,
+      package: params.adapterPackage,
+      manifest: params.manifest,
+      ...params.manifestSequence ? { manifest_sequence: params.manifestSequence } : {},
+      config: params.config,
+      state_model: params.stateModel,
+      signature: params.signature
     };
     return this.validateDeclaration(declaration);
   }
   validateDeclaration(input) {
     try {
       const payload = typeof input === "string" ? JSON.parse(input) : input;
-      const parsed = packageDeclarationSchema.parse(
+      const parsed = adapterDeclarationSchema.parse(
         payload
       );
       this.assertSizeLimit(parsed);
       return parsed;
     } catch (error) {
-      const message = error instanceof Error ? error.message : "Invalid package declaration";
+      const message = error instanceof Error ? error.message : "Invalid adapter declaration";
       throw new HCS21ValidationError(message, "invalid_payload");
     }
   }
@@ -62,12 +63,36 @@ class HCS21BaseClient {
     }
     return envelopes;
   }
+  async fetchCategoryEntries(topicId) {
+    const rawMessages = await this.mirrorNode.getTopicMessages(topicId);
+    const entries = [];
+    for (const message of rawMessages) {
+      if (message.p !== "hcs-2" || message.op !== "register") {
+        continue;
+      }
+      if (!message.t_id || typeof message.t_id !== "string") {
+        continue;
+      }
+      const memo = typeof message.m === "string" ? message.m : void 0;
+      const adapterId = memo?.startsWith("adapter:") ? memo.slice("adapter:".length) : memo;
+      entries.push({
+        adapterId: adapterId ?? message.t_id,
+        adapterTopicId: message.t_id,
+        metadata: message.metadata,
+        memo,
+        payer: message.payer,
+        sequenceNumber: Number(message.sequence_number ?? 0),
+        consensusTimestamp: message.consensus_timestamp
+      });
+    }
+    return entries;
+  }
   assertSizeLimit(payload) {
     const json = JSON.stringify(payload);
     const bytes = Buffer.byteLength(json, "utf8");
-    if (bytes > HCS21_MAX_MESSAGE_BYTES) {
+    if (bytes > HCS21_SAFE_MESSAGE_BYTES) {
       throw new HCS21ValidationError(
-        `HCS-21 payload exceeds 1024 bytes (${bytes})`,
+        `HCS-21 payload exceeds safe limit of ${HCS21_SAFE_MESSAGE_BYTES} bytes (${bytes}); Hedera cap is ${HCS21_MAX_MESSAGE_BYTES}`,
         "size_exceeded"
       );
     }

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  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;"}
+{"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  AdapterPackage,\n  HCS21_MAX_MESSAGE_BYTES,\n  HCS21_SAFE_MESSAGE_BYTES,\n  HCS21Operation,\n  HCS21_PROTOCOL,\n  AdapterConfigContext,\n  adapterDeclarationSchema,\n  AdapterCategoryEntry,\n  HCS21TopicType,\n} from './types';\n\nexport interface BuildDeclarationParams {\n  op: HCS21Operation;\n  adapterId: string;\n  entity: string;\n  adapterPackage: AdapterPackage;\n  manifest: string;\n  manifestSequence?: number;\n  config: AdapterConfigContext;\n  stateModel?: string;\n  signature?: 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      adapter_id: params.adapterId,\n      entity: params.entity,\n      package: params.adapterPackage,\n      manifest: params.manifest,\n      ...(params.manifestSequence\n        ? { manifest_sequence: params.manifestSequence }\n        : {}),\n      config: params.config,\n      state_model: params.stateModel,\n      signature: params.signature,\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  async fetchCategoryEntries(topicId: string): Promise<AdapterCategoryEntry[]> {\n    const rawMessages = await this.mirrorNode.getTopicMessages(topicId);\n    const entries: AdapterCategoryEntry[] = [];\n\n    for (const message of rawMessages) {\n      if (message.p !== 'hcs-2' || message.op !== 'register') {\n        continue;\n      }\n      if (!message.t_id || typeof message.t_id !== 'string') {\n        continue;\n      }\n      const memo = typeof message.m === 'string' ? message.m : undefined;\n      const adapterId = memo?.startsWith('adapter:')\n        ? memo.slice('adapter:'.length)\n        : memo;\n      entries.push({\n        adapterId: adapterId ?? message.t_id,\n        adapterTopicId: message.t_id,\n        metadata: message.metadata,\n        memo,\n        payer: message.payer,\n        sequenceNumber: Number(message.sequence_number ?? 0),\n        consensusTimestamp: message.consensus_timestamp,\n      });\n    }\n\n    return entries;\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_SAFE_MESSAGE_BYTES) {\n      throw new HCS21ValidationError(\n        `HCS-21 payload exceeds safe limit of ${HCS21_SAFE_MESSAGE_BYTES} bytes (${bytes}); Hedera cap is ${HCS21_MAX_MESSAGE_BYTES}`,\n        'size_exceeded',\n      );\n    }\n  }\n}\n"],"names":[],"mappings":"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"}