@hashgraphonline/standards-sdk 0.1.159 → 0.1.160

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

@@ -1,92 +1,146 @@
-import { buildMessageTx } from "./standards-sdk.es147.js";
-function buildHcs20SubmitMessageTx(params) {
-  const msg = typeof params.payload === "string" ? params.payload : JSON.stringify(params.payload);
-  return buildMessageTx({
-    topicId: params.topicId,
-    message: msg,
-    transactionMemo: params.transactionMemo
-  });
+class HCS20Error extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "HCS20Error";
+  }
 }
-function buildHcs20DeployTx(params) {
-  const payload = {
-    p: "hcs-20",
-    op: "deploy",
-    name: params.name,
-    tick: params.tick.toLowerCase().trim(),
-    max: params.max,
-    lim: params.lim,
-    metadata: params.metadata,
-    m: params.memo
-  };
-  return buildMessageTx({
-    topicId: params.topicId,
-    message: JSON.stringify(payload)
-  });
+class PointsDeploymentError extends HCS20Error {
+  constructor(message, tick) {
+    super(message);
+    this.tick = tick;
+    this.name = "PointsDeploymentError";
+  }
 }
-function buildHcs20MintTx(params) {
-  const payload = {
-    p: "hcs-20",
-    op: "mint",
-    tick: params.tick.toLowerCase().trim(),
-    amt: params.amt,
-    to: params.to,
-    m: params.memo
-  };
-  return buildMessageTx({
-    topicId: params.topicId,
-    message: JSON.stringify(payload)
-  });
+class PointsMintError extends HCS20Error {
+  constructor(message, tick, requestedAmount, availableSupply) {
+    super(message);
+    this.tick = tick;
+    this.requestedAmount = requestedAmount;
+    this.availableSupply = availableSupply;
+    this.name = "PointsMintError";
+  }
 }
-function buildHcs20TransferTx(params) {
-  const payload = {
-    p: "hcs-20",
-    op: "transfer",
-    tick: params.tick.toLowerCase().trim(),
-    amt: params.amt,
-    from: params.from,
-    to: params.to,
-    m: params.memo
-  };
-  return buildMessageTx({
-    topicId: params.topicId,
-    message: JSON.stringify(payload)
-  });
+class PointsTransferError extends HCS20Error {
+  constructor(message, tick, from, to, amount, availableBalance) {
+    super(message);
+    this.tick = tick;
+    this.from = from;
+    this.to = to;
+    this.amount = amount;
+    this.availableBalance = availableBalance;
+    this.name = "PointsTransferError";
+  }
 }
-function buildHcs20BurnTx(params) {
-  const payload = {
-    p: "hcs-20",
-    op: "burn",
-    tick: params.tick.toLowerCase().trim(),
-    amt: params.amt,
-    from: params.from,
-    m: params.memo
-  };
-  return buildMessageTx({
-    topicId: params.topicId,
-    message: JSON.stringify(payload)
-  });
+class PointsBurnError extends HCS20Error {
+  constructor(message, tick, from, amount, availableBalance) {
+    super(message);
+    this.tick = tick;
+    this.from = from;
+    this.amount = amount;
+    this.availableBalance = availableBalance;
+    this.name = "PointsBurnError";
+  }
 }
-function buildHcs20RegisterTx(params) {
-  const payload = {
-    p: "hcs-20",
-    op: "register",
-    name: params.name,
-    metadata: params.metadata,
-    private: params.isPrivate,
-    t_id: params.topicId,
-    m: params.memo
-  };
-  return buildMessageTx({
-    topicId: params.registryTopicId,
-    message: JSON.stringify(payload)
-  });
+class PointsValidationError extends HCS20Error {
+  constructor(message, validationErrors) {
+    super(message);
+    this.validationErrors = validationErrors;
+    this.name = "PointsValidationError";
+  }
+}
+class PointsNotFoundError extends HCS20Error {
+  constructor(tick) {
+    super(`Points with tick "${tick}" not found`);
+    this.tick = tick;
+    this.name = "PointsNotFoundError";
+  }
+}
+class TopicRegistrationError extends HCS20Error {
+  constructor(message, topicId) {
+    super(message);
+    this.topicId = topicId;
+    this.name = "TopicRegistrationError";
+  }
+}
+class InsufficientBalanceError extends HCS20Error {
+  constructor(accountId, tick, required, available) {
+    super(
+      `Insufficient balance for ${tick}: required ${required}, available ${available}`
+    );
+    this.accountId = accountId;
+    this.tick = tick;
+    this.required = required;
+    this.available = available;
+    this.name = "InsufficientBalanceError";
+  }
+}
+class SupplyLimitExceededError extends HCS20Error {
+  constructor(tick, requested, maxSupply, currentSupply) {
+    super(
+      `Supply limit exceeded for ${tick}: max ${maxSupply}, current ${currentSupply}, requested ${requested}`
+    );
+    this.tick = tick;
+    this.requested = requested;
+    this.maxSupply = maxSupply;
+    this.currentSupply = currentSupply;
+    this.name = "SupplyLimitExceededError";
+  }
+}
+class MintLimitExceededError extends HCS20Error {
+  constructor(tick, requested, limit) {
+    super(
+      `Mint limit exceeded for ${tick}: requested ${requested}, limit ${limit}`
+    );
+    this.tick = tick;
+    this.requested = requested;
+    this.limit = limit;
+    this.name = "MintLimitExceededError";
+  }
+}
+class InvalidMessageFormatError extends HCS20Error {
+  constructor(message, messageData) {
+    super(message);
+    this.messageData = messageData;
+    this.name = "InvalidMessageFormatError";
+  }
+}
+class InvalidAccountFormatError extends HCS20Error {
+  constructor(account) {
+    super(`Invalid Hedera account format: ${account}`);
+    this.account = account;
+    this.name = "InvalidAccountFormatError";
+  }
+}
+class InvalidTickFormatError extends HCS20Error {
+  constructor(tick) {
+    super(`Invalid tick format: ${tick}`);
+    this.tick = tick;
+    this.name = "InvalidTickFormatError";
+  }
+}
+class InvalidNumberFormatError extends HCS20Error {
+  constructor(value, field) {
+    super(`Invalid number format for ${field}: ${value}`);
+    this.value = value;
+    this.field = field;
+    this.name = "InvalidNumberFormatError";
+  }
 }
 export {
-  buildHcs20BurnTx,
-  buildHcs20DeployTx,
-  buildHcs20MintTx,
-  buildHcs20RegisterTx,
-  buildHcs20SubmitMessageTx,
-  buildHcs20TransferTx
+  HCS20Error,
+  InsufficientBalanceError,
+  InvalidAccountFormatError,
+  InvalidMessageFormatError,
+  InvalidNumberFormatError,
+  InvalidTickFormatError,
+  MintLimitExceededError,
+  PointsBurnError,
+  PointsDeploymentError,
+  PointsMintError,
+  PointsNotFoundError,
+  PointsTransferError,
+  PointsValidationError,
+  SupplyLimitExceededError,
+  TopicRegistrationError
 };
 //# sourceMappingURL=standards-sdk.es78.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es78.js","sources":["../../src/hcs-20/tx.ts"],"sourcesContent":["import { TopicMessageSubmitTransaction } from '@hashgraph/sdk';\nimport { buildMessageTx } from '../common/tx/tx-utils';\nimport type {\n  HCS20DeployMessage,\n  HCS20MintMessage,\n  HCS20TransferMessage,\n  HCS20BurnMessage,\n  HCS20RegisterMessage,\n} from './types';\n\nexport function buildHcs20SubmitMessageTx(params: {\n  topicId: string;\n  payload: object | string;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  const msg =\n    typeof params.payload === 'string'\n      ? params.payload\n      : JSON.stringify(params.payload);\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: msg,\n    transactionMemo: params.transactionMemo,\n  });\n}\n\nexport function buildHcs20DeployTx(params: {\n  topicId: string;\n  name: string;\n  tick: string;\n  max: string;\n  lim?: string;\n  metadata?: string;\n  memo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: HCS20DeployMessage = {\n    p: 'hcs-20',\n    op: 'deploy',\n    name: params.name,\n    tick: params.tick.toLowerCase().trim(),\n    max: params.max,\n    lim: params.lim,\n    metadata: params.metadata,\n    m: params.memo,\n  };\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(payload),\n  });\n}\n\nexport function buildHcs20MintTx(params: {\n  topicId: string;\n  tick: string;\n  amt: string;\n  to: string;\n  memo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: HCS20MintMessage = {\n    p: 'hcs-20',\n    op: 'mint',\n    tick: params.tick.toLowerCase().trim(),\n    amt: params.amt,\n    to: params.to,\n    m: params.memo,\n  };\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(payload),\n  });\n}\n\nexport function buildHcs20TransferTx(params: {\n  topicId: string;\n  tick: string;\n  amt: string;\n  from: string;\n  to: string;\n  memo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: HCS20TransferMessage = {\n    p: 'hcs-20',\n    op: 'transfer',\n    tick: params.tick.toLowerCase().trim(),\n    amt: params.amt,\n    from: params.from,\n    to: params.to,\n    m: params.memo,\n  };\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(payload),\n  });\n}\n\nexport function buildHcs20BurnTx(params: {\n  topicId: string;\n  tick: string;\n  amt: string;\n  from: string;\n  memo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: HCS20BurnMessage = {\n    p: 'hcs-20',\n    op: 'burn',\n    tick: params.tick.toLowerCase().trim(),\n    amt: params.amt,\n    from: params.from,\n    m: params.memo,\n  };\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(payload),\n  });\n}\n\nexport function buildHcs20RegisterTx(params: {\n  registryTopicId: string;\n  name: string;\n  topicId: string;\n  isPrivate: boolean;\n  metadata?: string;\n  memo?: string;\n}): TopicMessageSubmitTransaction {\n  const payload: HCS20RegisterMessage = {\n    p: 'hcs-20',\n    op: 'register',\n    name: params.name,\n    metadata: params.metadata,\n    private: params.isPrivate,\n    t_id: params.topicId,\n    m: params.memo,\n  };\n  return buildMessageTx({\n    topicId: params.registryTopicId,\n    message: JSON.stringify(payload),\n  });\n}\n"],"names":[],"mappings":";AAUO,SAAS,0BAA0B,QAIR;AAChC,QAAM,MACJ,OAAO,OAAO,YAAY,WACtB,OAAO,UACP,KAAK,UAAU,OAAO,OAAO;AACnC,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS;AAAA,IACT,iBAAiB,OAAO;AAAA,EAAA,CACzB;AACH;AAEO,SAAS,mBAAmB,QAQD;AAChC,QAAM,UAA8B;AAAA,IAClC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,MAAM,OAAO;AAAA,IACb,MAAM,OAAO,KAAK,YAAA,EAAc,KAAA;AAAA,IAChC,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO;AAAA,IACZ,UAAU,OAAO;AAAA,IACjB,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,EAAA,CAChC;AACH;AAEO,SAAS,iBAAiB,QAMC;AAChC,QAAM,UAA4B;AAAA,IAChC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,MAAM,OAAO,KAAK,YAAA,EAAc,KAAA;AAAA,IAChC,KAAK,OAAO;AAAA,IACZ,IAAI,OAAO;AAAA,IACX,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,EAAA,CAChC;AACH;AAEO,SAAS,qBAAqB,QAOH;AAChC,QAAM,UAAgC;AAAA,IACpC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,MAAM,OAAO,KAAK,YAAA,EAAc,KAAA;AAAA,IAChC,KAAK,OAAO;AAAA,IACZ,MAAM,OAAO;AAAA,IACb,IAAI,OAAO;AAAA,IACX,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,EAAA,CAChC;AACH;AAEO,SAAS,iBAAiB,QAMC;AAChC,QAAM,UAA4B;AAAA,IAChC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,MAAM,OAAO,KAAK,YAAA,EAAc,KAAA;AAAA,IAChC,KAAK,OAAO;AAAA,IACZ,MAAM,OAAO;AAAA,IACb,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,EAAA,CAChC;AACH;AAEO,SAAS,qBAAqB,QAOH;AAChC,QAAM,UAAgC;AAAA,IACpC,GAAG;AAAA,IACH,IAAI;AAAA,IACJ,MAAM,OAAO;AAAA,IACb,UAAU,OAAO;AAAA,IACjB,SAAS,OAAO;AAAA,IAChB,MAAM,OAAO;AAAA,IACb,GAAG,OAAO;AAAA,EAAA;AAEZ,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO;AAAA,EAAA,CAChC;AACH;"}
+{"version":3,"file":"standards-sdk.es78.js","sources":["../../src/hcs-20/errors.ts"],"sourcesContent":["/**\n * HCS-20 Specific Error Classes\n */\n\n/**\n * Base error class for HCS-20 operations\n */\nexport class HCS20Error extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'HCS20Error';\n  }\n}\n\n/**\n * Error thrown when points deployment fails\n */\nexport class PointsDeploymentError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly tick?: string,\n  ) {\n    super(message);\n    this.name = 'PointsDeploymentError';\n  }\n}\n\n/**\n * Error thrown when points minting fails\n */\nexport class PointsMintError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly tick: string,\n    public readonly requestedAmount: string,\n    public readonly availableSupply?: string,\n  ) {\n    super(message);\n    this.name = 'PointsMintError';\n  }\n}\n\n/**\n * Error thrown when points transfer fails\n */\nexport class PointsTransferError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly tick: string,\n    public readonly from: string,\n    public readonly to: string,\n    public readonly amount: string,\n    public readonly availableBalance?: string,\n  ) {\n    super(message);\n    this.name = 'PointsTransferError';\n  }\n}\n\n/**\n * Error thrown when points burn fails\n */\nexport class PointsBurnError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly tick: string,\n    public readonly from: string,\n    public readonly amount: string,\n    public readonly availableBalance?: string,\n  ) {\n    super(message);\n    this.name = 'PointsBurnError';\n  }\n}\n\n/**\n * Error thrown when points validation fails\n */\nexport class PointsValidationError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly validationErrors: string[],\n  ) {\n    super(message);\n    this.name = 'PointsValidationError';\n  }\n}\n\n/**\n * Error thrown when points are not found\n */\nexport class PointsNotFoundError extends HCS20Error {\n  constructor(public readonly tick: string) {\n    super(`Points with tick \"${tick}\" not found`);\n    this.name = 'PointsNotFoundError';\n  }\n}\n\n/**\n * Error thrown when topic registration fails\n */\nexport class TopicRegistrationError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly topicId: string,\n  ) {\n    super(message);\n    this.name = 'TopicRegistrationError';\n  }\n}\n\n/**\n * Error thrown when insufficient balance\n */\nexport class InsufficientBalanceError extends HCS20Error {\n  constructor(\n    public readonly accountId: string,\n    public readonly tick: string,\n    public readonly required: string,\n    public readonly available: string,\n  ) {\n    super(\n      `Insufficient balance for ${tick}: required ${required}, available ${available}`,\n    );\n    this.name = 'InsufficientBalanceError';\n  }\n}\n\n/**\n * Error thrown when supply limit is exceeded\n */\nexport class SupplyLimitExceededError extends HCS20Error {\n  constructor(\n    public readonly tick: string,\n    public readonly requested: string,\n    public readonly maxSupply: string,\n    public readonly currentSupply: string,\n  ) {\n    super(\n      `Supply limit exceeded for ${tick}: max ${maxSupply}, current ${currentSupply}, requested ${requested}`,\n    );\n    this.name = 'SupplyLimitExceededError';\n  }\n}\n\n/**\n * Error thrown when mint limit is exceeded\n */\nexport class MintLimitExceededError extends HCS20Error {\n  constructor(\n    public readonly tick: string,\n    public readonly requested: string,\n    public readonly limit: string,\n  ) {\n    super(\n      `Mint limit exceeded for ${tick}: requested ${requested}, limit ${limit}`,\n    );\n    this.name = 'MintLimitExceededError';\n  }\n}\n\n/**\n * Error thrown when HCS-20 message format is invalid\n */\nexport class InvalidMessageFormatError extends HCS20Error {\n  constructor(\n    message: string,\n    public readonly messageData?: any,\n  ) {\n    super(message);\n    this.name = 'InvalidMessageFormatError';\n  }\n}\n\n/**\n * Error thrown when account format is invalid\n */\nexport class InvalidAccountFormatError extends HCS20Error {\n  constructor(public readonly account: string) {\n    super(`Invalid Hedera account format: ${account}`);\n    this.name = 'InvalidAccountFormatError';\n  }\n}\n\n/**\n * Error thrown when tick format is invalid\n */\nexport class InvalidTickFormatError extends HCS20Error {\n  constructor(public readonly tick: string) {\n    super(`Invalid tick format: ${tick}`);\n    this.name = 'InvalidTickFormatError';\n  }\n}\n\n/**\n * Error thrown when number format is invalid\n */\nexport class InvalidNumberFormatError extends HCS20Error {\n  constructor(\n    public readonly value: string,\n    public readonly field: string,\n  ) {\n    super(`Invalid number format for ${field}: ${value}`);\n    this.name = 'InvalidNumberFormatError';\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,128 +1,72 @@
-import { z } from "zod";
-const HCS21_PROTOCOL = "hcs-21";
-const HCS21_MAX_MESSAGE_BYTES = 1024;
-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["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 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", "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
-]);
+import { Logger } from "./standards-sdk.es116.js";
+import { HederaMirrorNode } from "./standards-sdk.es137.js";
+import { HCS20_CONSTANTS, HCS20MessageSchema } from "./standards-sdk.es77.js";
+import { InvalidAccountFormatError } from "./standards-sdk.es78.js";
+class HCS20BaseClient {
+  constructor(config) {
+    this.logger = config.logger || new Logger({ module: "HCS20Client" });
+    this.network = config.network === "mainnet" ? "mainnet" : "testnet";
+    this.mirrorNode = new HederaMirrorNode(
+      this.network,
+      this.logger,
+      config.mirrorNodeUrl ? { customUrl: config.mirrorNodeUrl } : void 0
+    );
+    this.registryTopicId = config.registryTopicId || HCS20_CONSTANTS.REGISTRY_TOPIC_ID;
+    this.publicTopicId = config.publicTopicId || HCS20_CONSTANTS.PUBLIC_TOPIC_ID;
+  }
+  /**
+   * Validate HCS-20 message using Zod schema
+   */
+  validateMessage(message) {
+    try {
+      HCS20MessageSchema.parse(message);
+      return { valid: true };
+    } catch (error) {
+      if (error.errors) {
+        const errors = error.errors.map(
+          (e) => `${e.path.join(".")}: ${e.message}`
+        );
+        return { valid: false, errors };
+      }
+      return { valid: false, errors: [error.message] };
+    }
+  }
+  /**
+   * Normalize tick to lowercase and trimmed
+   */
+  normalizeTick(tick) {
+    return tick.toLowerCase().trim();
+  }
+  /**
+   * Convert account to string format
+   */
+  accountToString(account) {
+    if (typeof account === "string") {
+      if (!HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX.test(account)) {
+        throw new InvalidAccountFormatError(account);
+      }
+      return account;
+    }
+    return account.toString();
+  }
+  /**
+   * Convert topic to string format
+   */
+  topicToString(topic) {
+    if (typeof topic === "string") {
+      if (!HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX.test(topic)) {
+        throw new InvalidAccountFormatError(topic);
+      }
+      return topic;
+    }
+    return topic.toString();
+  }
+  /**
+   * NOTE: State queries (getPointsInfo, getBalance, etc.) require an external indexing service.
+   * The HCS-20 clients only handle message submission. Use HCS20PointsIndexer for state management.
+   */
+}
 export {
-  HCS21ManifestPointerPattern,
-  HCS21MetadataPointerPattern,
-  HCS21TopicIdPattern,
-  HCS21TopicType,
-  HCS21_MAX_MESSAGE_BYTES,
-  HCS21_PROTOCOL,
-  HCS21_SAFE_MESSAGE_BYTES,
-  adapterConfigContextSchema,
-  adapterDeclarationSchema,
-  adapterManifestSchema,
-  adapterPackageSchema,
-  metadataDocumentSchema,
-  registryMetadataSchema
+  HCS20BaseClient
 };
 //# sourceMappingURL=standards-sdk.es79.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es79.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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"}
+{"version":3,"file":"standards-sdk.es79.js","sources":["../../src/hcs-20/base-client.ts"],"sourcesContent":["/**\n * Base client for HCS-20 Auditable Points operations\n */\n\nimport { AccountId, TopicId } from '@hashgraph/sdk';\nimport { Logger, ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport type { NetworkType } from '../utils/types';\nimport {\n  HCS20ClientConfig,\n  HCS20MessageSchema,\n  PointsInfo,\n  PointsTransaction,\n  HCS20_CONSTANTS,\n  DeployPointsOptions,\n  MintPointsOptions,\n  TransferPointsOptions,\n  BurnPointsOptions,\n  RegisterTopicOptions,\n} from './types';\nimport { InvalidAccountFormatError } from './errors';\n\n/**\n * Abstract base class for HCS-20 clients\n */\nexport abstract class HCS20BaseClient {\n  protected logger: ILogger;\n  protected mirrorNode: HederaMirrorNode;\n  protected network: NetworkType;\n  protected registryTopicId: string;\n  protected publicTopicId: string;\n\n  constructor(config: HCS20ClientConfig) {\n    this.logger = config.logger || new Logger({ module: 'HCS20Client' });\n    this.network = config.network === 'mainnet' ? 'mainnet' : 'testnet';\n    this.mirrorNode = new HederaMirrorNode(\n      this.network,\n      this.logger,\n      config.mirrorNodeUrl ? { customUrl: config.mirrorNodeUrl } : undefined,\n    );\n    this.registryTopicId =\n      config.registryTopicId || HCS20_CONSTANTS.REGISTRY_TOPIC_ID;\n    this.publicTopicId =\n      config.publicTopicId || HCS20_CONSTANTS.PUBLIC_TOPIC_ID;\n  }\n\n  /**\n   * Deploy new points\n   */\n  abstract deployPoints(options: DeployPointsOptions): Promise<PointsInfo>;\n\n  /**\n   * Mint points\n   */\n  abstract mintPoints(options: MintPointsOptions): Promise<PointsTransaction>;\n\n  /**\n   * Transfer points\n   */\n  abstract transferPoints(\n    options: TransferPointsOptions,\n  ): Promise<PointsTransaction>;\n\n  /**\n   * Burn points\n   */\n  abstract burnPoints(options: BurnPointsOptions): Promise<PointsTransaction>;\n\n  /**\n   * Register a topic in the registry\n   */\n  abstract registerTopic(options: RegisterTopicOptions): Promise<void>;\n\n  /**\n   * Validate HCS-20 message using Zod schema\n   */\n  protected validateMessage(message: any): {\n    valid: boolean;\n    errors?: string[];\n  } {\n    try {\n      HCS20MessageSchema.parse(message);\n      return { valid: true };\n    } catch (error: any) {\n      if (error.errors) {\n        const errors = error.errors.map(\n          (e: any) => `${e.path.join('.')}: ${e.message}`,\n        );\n        return { valid: false, errors };\n      }\n      return { valid: false, errors: [error.message] };\n    }\n  }\n\n  /**\n   * Normalize tick to lowercase and trimmed\n   */\n  protected normalizeTick(tick: string): string {\n    return tick.toLowerCase().trim();\n  }\n\n  /**\n   * Convert account to string format\n   */\n  protected accountToString(account: string | AccountId): string {\n    if (typeof account === 'string') {\n      if (!HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX.test(account)) {\n        throw new InvalidAccountFormatError(account);\n      }\n      return account;\n    }\n    return account.toString();\n  }\n\n  /**\n   * Convert topic to string format\n   */\n  protected topicToString(topic: string | TopicId): string {\n    if (typeof topic === 'string') {\n      if (!HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX.test(topic)) {\n        throw new InvalidAccountFormatError(topic);\n      }\n      return topic;\n    }\n    return topic.toString();\n  }\n\n  /**\n   * NOTE: State queries (getPointsInfo, getBalance, etc.) require an external indexing service.\n   * The HCS-20 clients only handle message submission. Use HCS20PointsIndexer for state management.\n   */\n}\n"],"names":[],"mappings":";;;;AAyBO,MAAe,gBAAgB;AAAA,EAOpC,YAAY,QAA2B;AACrC,SAAK,SAAS,OAAO,UAAU,IAAI,OAAO,EAAE,QAAQ,eAAe;AACnE,SAAK,UAAU,OAAO,YAAY,YAAY,YAAY;AAC1D,SAAK,aAAa,IAAI;AAAA,MACpB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,OAAO,gBAAgB,EAAE,WAAW,OAAO,kBAAkB;AAAA,IAAA;AAE/D,SAAK,kBACH,OAAO,mBAAmB,gBAAgB;AAC5C,SAAK,gBACH,OAAO,iBAAiB,gBAAgB;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAgCU,gBAAgB,SAGxB;AACA,QAAI;AACF,yBAAmB,MAAM,OAAO;AAChC,aAAO,EAAE,OAAO,KAAA;AAAA,IAClB,SAAS,OAAY;AACnB,UAAI,MAAM,QAAQ;AAChB,cAAM,SAAS,MAAM,OAAO;AAAA,UAC1B,CAAC,MAAW,GAAG,EAAE,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO;AAAA,QAAA;AAE/C,eAAO,EAAE,OAAO,OAAO,OAAA;AAAA,MACzB;AACA,aAAO,EAAE,OAAO,OAAO,QAAQ,CAAC,MAAM,OAAO,EAAA;AAAA,IAC/C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKU,cAAc,MAAsB;AAC5C,WAAO,KAAK,YAAA,EAAc,KAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKU,gBAAgB,SAAqC;AAC7D,QAAI,OAAO,YAAY,UAAU;AAC/B,UAAI,CAAC,gBAAgB,qBAAqB,KAAK,OAAO,GAAG;AACvD,cAAM,IAAI,0BAA0B,OAAO;AAAA,MAC7C;AACA,aAAO;AAAA,IACT;AACA,WAAO,QAAQ,SAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKU,cAAc,OAAiC;AACvD,QAAI,OAAO,UAAU,UAAU;AAC7B,UAAI,CAAC,gBAAgB,qBAAqB,KAAK,KAAK,GAAG;AACrD,cAAM,IAAI,0BAA0B,KAAK;AAAA,MAC3C;AACA,aAAO;AAAA,IACT;AACA,WAAO,MAAM,SAAA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAMF;"}