@hashgraphonline/standards-sdk 0.1.144 → 0.1.146

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

@@ -1,74 +1,146 @@
-import { z } from "zod";
-const HCS20_CONSTANTS = {
-  PROTOCOL: "hcs-20",
-  PUBLIC_TOPIC_ID: "0.0.4350190",
-  REGISTRY_TOPIC_ID: "0.0.4362300",
-  MAX_NUMBER_LENGTH: 18,
-  MAX_NAME_LENGTH: 100,
-  MAX_METADATA_LENGTH: 100,
-  HEDERA_ACCOUNT_REGEX: /^(0|(?:[1-9]\d*))\.(0|(?:[1-9]\d*))\.(0|(?:[1-9]\d*))$/
-};
-const HederaAccountIdSchema = z.string().regex(
-  HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX,
-  "Invalid Hedera account ID format"
-);
-const NumberStringSchema = z.string().regex(/^\d+$/, "Must be a valid number").max(
-  HCS20_CONSTANTS.MAX_NUMBER_LENGTH,
-  `Max ${HCS20_CONSTANTS.MAX_NUMBER_LENGTH} digits`
-);
-const TickSchema = z.string().min(1, "Tick cannot be empty").transform((val) => val.toLowerCase().trim());
-const HCS20BaseMessageSchema = z.object({
-  p: z.literal("hcs-20"),
-  m: z.string().optional()
-});
-const HCS20DeployMessageSchema = HCS20BaseMessageSchema.extend({
-  op: z.literal("deploy"),
-  name: z.string().min(1).max(HCS20_CONSTANTS.MAX_NAME_LENGTH),
-  tick: TickSchema,
-  max: NumberStringSchema,
-  lim: NumberStringSchema.optional(),
-  metadata: z.string().max(HCS20_CONSTANTS.MAX_METADATA_LENGTH).optional()
-});
-const HCS20MintMessageSchema = HCS20BaseMessageSchema.extend({
-  op: z.literal("mint"),
-  tick: TickSchema,
-  amt: NumberStringSchema,
-  to: HederaAccountIdSchema
-});
-const HCS20BurnMessageSchema = HCS20BaseMessageSchema.extend({
-  op: z.literal("burn"),
-  tick: TickSchema,
-  amt: NumberStringSchema,
-  from: HederaAccountIdSchema
-});
-const HCS20TransferMessageSchema = HCS20BaseMessageSchema.extend({
-  op: z.literal("transfer"),
-  tick: TickSchema,
-  amt: NumberStringSchema,
-  from: HederaAccountIdSchema,
-  to: HederaAccountIdSchema
-});
-const HCS20RegisterMessageSchema = HCS20BaseMessageSchema.extend({
-  op: z.literal("register"),
-  name: z.string().min(1).max(HCS20_CONSTANTS.MAX_NAME_LENGTH),
-  metadata: z.string().max(HCS20_CONSTANTS.MAX_METADATA_LENGTH).optional(),
-  private: z.boolean(),
-  t_id: HederaAccountIdSchema
-});
-const HCS20MessageSchema = z.discriminatedUnion("op", [
-  HCS20DeployMessageSchema,
-  HCS20MintMessageSchema,
-  HCS20BurnMessageSchema,
-  HCS20TransferMessageSchema,
-  HCS20RegisterMessageSchema
-]);
+class HCS20Error extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "HCS20Error";
+  }
+}
+class PointsDeploymentError extends HCS20Error {
+  constructor(message, tick) {
+    super(message);
+    this.tick = tick;
+    this.name = "PointsDeploymentError";
+  }
+}
+class PointsMintError extends HCS20Error {
+  constructor(message, tick, requestedAmount, availableSupply) {
+    super(message);
+    this.tick = tick;
+    this.requestedAmount = requestedAmount;
+    this.availableSupply = availableSupply;
+    this.name = "PointsMintError";
+  }
+}
+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";
+  }
+}
+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";
+  }
+}
+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 {
-  HCS20BurnMessageSchema,
-  HCS20DeployMessageSchema,
-  HCS20MessageSchema,
-  HCS20MintMessageSchema,
-  HCS20RegisterMessageSchema,
-  HCS20TransferMessageSchema,
-  HCS20_CONSTANTS
+  HCS20Error,
+  InsufficientBalanceError,
+  InvalidAccountFormatError,
+  InvalidMessageFormatError,
+  InvalidNumberFormatError,
+  InvalidTickFormatError,
+  MintLimitExceededError,
+  PointsBurnError,
+  PointsDeploymentError,
+  PointsMintError,
+  PointsNotFoundError,
+  PointsTransferError,
+  PointsValidationError,
+  SupplyLimitExceededError,
+  TopicRegistrationError
 };
 //# sourceMappingURL=standards-sdk.es73.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es73.js","sources":["../../src/hcs-20/types.ts"],"sourcesContent":["/**\n * HCS-20 Auditable Points Standard Types\n */\n\nimport { z } from 'zod';\nimport { AccountId, TopicId, PrivateKey } from '@hashgraph/sdk';\nimport type { ILogger } from '../utils/logger';\n\n/**\n * HCS-20 Constants\n */\nexport const HCS20_CONSTANTS = {\n  PROTOCOL: 'hcs-20',\n  PUBLIC_TOPIC_ID: '0.0.4350190',\n  REGISTRY_TOPIC_ID: '0.0.4362300',\n  MAX_NUMBER_LENGTH: 18,\n  MAX_NAME_LENGTH: 100,\n  MAX_METADATA_LENGTH: 100,\n  HEDERA_ACCOUNT_REGEX:\n    /^(0|(?:[1-9]\\d*))\\.(0|(?:[1-9]\\d*))\\.(0|(?:[1-9]\\d*))$/,\n} as const;\n\n/**\n * Hedera Account ID validator\n */\nconst HederaAccountIdSchema = z\n  .string()\n  .regex(\n    HCS20_CONSTANTS.HEDERA_ACCOUNT_REGEX,\n    'Invalid Hedera account ID format',\n  );\n\n/**\n * Number string validator\n */\nconst NumberStringSchema = z\n  .string()\n  .regex(/^\\d+$/, 'Must be a valid number')\n  .max(\n    HCS20_CONSTANTS.MAX_NUMBER_LENGTH,\n    `Max ${HCS20_CONSTANTS.MAX_NUMBER_LENGTH} digits`,\n  );\n\n/**\n * Tick validator\n */\nconst TickSchema = z\n  .string()\n  .min(1, 'Tick cannot be empty')\n  .transform(val => val.toLowerCase().trim());\n\n/**\n * Base HCS-20 Message Schema\n */\nconst HCS20BaseMessageSchema = z.object({\n  p: z.literal('hcs-20'),\n  m: z.string().optional(),\n});\n\n/**\n * Deploy Points Operation Schema\n */\nexport const HCS20DeployMessageSchema = HCS20BaseMessageSchema.extend({\n  op: z.literal('deploy'),\n  name: z.string().min(1).max(HCS20_CONSTANTS.MAX_NAME_LENGTH),\n  tick: TickSchema,\n  max: NumberStringSchema,\n  lim: NumberStringSchema.optional(),\n  metadata: z.string().max(HCS20_CONSTANTS.MAX_METADATA_LENGTH).optional(),\n});\n\n/**\n * Mint Points Operation Schema\n */\nexport const HCS20MintMessageSchema = HCS20BaseMessageSchema.extend({\n  op: z.literal('mint'),\n  tick: TickSchema,\n  amt: NumberStringSchema,\n  to: HederaAccountIdSchema,\n});\n\n/**\n * Burn Points Operation Schema\n */\nexport const HCS20BurnMessageSchema = HCS20BaseMessageSchema.extend({\n  op: z.literal('burn'),\n  tick: TickSchema,\n  amt: NumberStringSchema,\n  from: HederaAccountIdSchema,\n});\n\n/**\n * Transfer Points Operation Schema\n */\nexport const HCS20TransferMessageSchema = HCS20BaseMessageSchema.extend({\n  op: z.literal('transfer'),\n  tick: TickSchema,\n  amt: NumberStringSchema,\n  from: HederaAccountIdSchema,\n  to: HederaAccountIdSchema,\n});\n\n/**\n * Register Topic Operation Schema\n */\nexport const HCS20RegisterMessageSchema = HCS20BaseMessageSchema.extend({\n  op: z.literal('register'),\n  name: z.string().min(1).max(HCS20_CONSTANTS.MAX_NAME_LENGTH),\n  metadata: z.string().max(HCS20_CONSTANTS.MAX_METADATA_LENGTH).optional(),\n  private: z.boolean(),\n  t_id: HederaAccountIdSchema,\n});\n\n/**\n * Union schema for all HCS-20 messages\n */\nexport const HCS20MessageSchema = z.discriminatedUnion('op', [\n  HCS20DeployMessageSchema,\n  HCS20MintMessageSchema,\n  HCS20BurnMessageSchema,\n  HCS20TransferMessageSchema,\n  HCS20RegisterMessageSchema,\n]);\n\n/**\n * Inferred types from schemas\n */\nexport type HCS20BaseMessage = z.infer<typeof HCS20BaseMessageSchema>;\nexport type HCS20DeployMessage = z.infer<typeof HCS20DeployMessageSchema>;\nexport type HCS20MintMessage = z.infer<typeof HCS20MintMessageSchema>;\nexport type HCS20BurnMessage = z.infer<typeof HCS20BurnMessageSchema>;\nexport type HCS20TransferMessage = z.infer<typeof HCS20TransferMessageSchema>;\nexport type HCS20RegisterMessage = z.infer<typeof HCS20RegisterMessageSchema>;\nexport type HCS20Message = z.infer<typeof HCS20MessageSchema>;\nexport type HCS20Operation = HCS20Message['op'];\n\n/**\n * Points Configuration\n */\nexport interface PointsConfig {\n  name: string;\n  tick: string;\n  maxSupply: string;\n  limitPerMint?: string;\n  metadata?: string;\n}\n\n/**\n * Points Information\n */\nexport interface PointsInfo extends PointsConfig {\n  topicId: string;\n  deployerAccountId: string;\n  currentSupply: string;\n  deploymentTimestamp: string;\n  isPrivate: boolean;\n}\n\n/**\n * Points Balance\n */\nexport interface PointsBalance {\n  tick: string;\n  accountId: string;\n  balance: string;\n  lastUpdated: string;\n}\n\n/**\n * Points Transaction\n */\nexport interface PointsTransaction {\n  id: string;\n  operation: HCS20Operation;\n  tick: string;\n  amount?: string;\n  from?: string;\n  to?: string;\n  timestamp: string;\n  sequenceNumber: number;\n  topicId: string;\n  transactionId: string;\n  memo?: string;\n}\n\n/**\n * HCS-20 Client Configuration\n */\nexport interface HCS20ClientConfig {\n  mirrorNodeUrl?: string;\n  logger?: ILogger;\n  network?: 'mainnet' | 'testnet';\n  registryTopicId?: string;\n  publicTopicId?: string;\n}\n\n/**\n * Browser-specific HCS-20 Client Configuration\n */\nexport interface BrowserHCS20ClientConfig extends HCS20ClientConfig {\n  walletConnectProjectId?: string;\n  hwcMetadata?: {\n    name: string;\n    description: string;\n    icons: string[];\n    url: string;\n  };\n}\n\n/**\n * SDK-specific HCS-20 Client Configuration\n */\nexport interface SDKHCS20ClientConfig extends HCS20ClientConfig {\n  operatorId: string | AccountId;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n}\n\n/**\n * Deploy Points Progress\n */\nexport interface DeployPointsProgress {\n  stage: 'creating-topic' | 'submitting-deploy' | 'confirming' | 'complete';\n  percentage: number;\n  topicId?: string;\n  deployTxId?: string;\n  error?: string;\n}\n\n/**\n * Deploy Points Options\n */\nexport interface DeployPointsOptions extends PointsConfig {\n  usePrivateTopic?: boolean;\n  topicMemo?: string;\n  progressCallback?: (data: DeployPointsProgress) => void;\n}\n\n/**\n * Mint Points Progress\n */\nexport interface MintPointsProgress {\n  stage: 'validating' | 'submitting' | 'confirming' | 'complete';\n  percentage: number;\n  mintTxId?: string;\n  error?: string;\n}\n\n/**\n * Mint Points Options\n */\nexport interface MintPointsOptions {\n  tick: string;\n  amount: string;\n  to: string | AccountId;\n  memo?: string;\n  topicId?: string | TopicId;\n  progressCallback?: (data: MintPointsProgress) => void;\n  disableMirrorCheck?: boolean;\n}\n\n/**\n * Transfer Points Progress\n */\nexport interface TransferPointsProgress {\n  stage: 'validating-balance' | 'submitting' | 'confirming' | 'complete';\n  percentage: number;\n  transferTxId?: string;\n  error?: string;\n}\n\n/**\n * Transfer Points Options\n */\nexport interface TransferPointsOptions {\n  tick: string;\n  amount: string;\n  from: string | AccountId;\n  to: string | AccountId;\n  memo?: string;\n  topicId?: string | TopicId;\n  progressCallback?: (data: TransferPointsProgress) => void;\n}\n\n/**\n * Burn Points Progress\n */\nexport interface BurnPointsProgress {\n  stage: 'validating-balance' | 'submitting' | 'confirming' | 'complete';\n  percentage: number;\n  burnTxId?: string;\n  error?: string;\n}\n\n/**\n * Burn Points Options\n */\nexport interface BurnPointsOptions {\n  tick: string;\n  amount: string;\n  from: string | AccountId;\n  memo?: string;\n  topicId?: string | TopicId;\n  progressCallback?: (data: BurnPointsProgress) => void;\n}\n\n/**\n * Register Topic Progress\n */\nexport interface RegisterTopicProgress {\n  stage: 'validating' | 'submitting' | 'confirming' | 'complete';\n  percentage: number;\n  registerTxId?: string;\n  error?: string;\n}\n\n/**\n * Register Topic Options\n */\nexport interface RegisterTopicOptions {\n  topicId: string | TopicId;\n  name: string;\n  metadata?: string;\n  isPrivate: boolean;\n  memo?: string;\n  progressCallback?: (data: RegisterTopicProgress) => void;\n}\n\n/**\n * Query Points Options\n */\nexport interface QueryPointsOptions {\n  tick?: string;\n  accountId?: string | AccountId;\n  topicId?: string | TopicId;\n  limit?: number;\n  order?: 'asc' | 'desc';\n}\n\n/**\n * Points Query Result\n */\nexport interface PointsQueryResult {\n  points: PointsInfo[];\n  balances?: PointsBalance[];\n  transactions?: PointsTransaction[];\n  totalCount: number;\n  hasMore: boolean;\n  nextCursor?: string;\n}\n\n/**\n * Points State\n */\nexport interface PointsState {\n  deployedPoints: Map<string, PointsInfo>;\n  balances: Map<string, Map<string, PointsBalance>>;\n  transactions: PointsTransaction[];\n  lastProcessedSequence: number;\n  lastProcessedTimestamp: string;\n}\n\n/**\n * HCS-20 Registry Entry\n */\nexport interface HCS20RegistryEntry {\n  name: string;\n  topicId: string;\n  metadata?: string;\n  isPrivate: boolean;\n  registeredAt: string;\n  registeredBy: string;\n}\n"],"names":[],"mappings":";AAWO,MAAM,kBAAkB;AAAA,EAC7B,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,sBACE;AACJ;AAKA,MAAM,wBAAwB,EAC3B,OAAA,EACA;AAAA,EACC,gBAAgB;AAAA,EAChB;AACF;AAKF,MAAM,qBAAqB,EACxB,OAAA,EACA,MAAM,SAAS,wBAAwB,EACvC;AAAA,EACC,gBAAgB;AAAA,EAChB,OAAO,gBAAgB,iBAAiB;AAC1C;AAKF,MAAM,aAAa,EAChB,OAAA,EACA,IAAI,GAAG,sBAAsB,EAC7B,UAAU,CAAA,QAAO,IAAI,YAAA,EAAc,MAAM;AAK5C,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,GAAG,EAAE,QAAQ,QAAQ;AAAA,EACrB,GAAG,EAAE,OAAA,EAAS,SAAA;AAChB,CAAC;AAKM,MAAM,2BAA2B,uBAAuB,OAAO;AAAA,EACpE,IAAI,EAAE,QAAQ,QAAQ;AAAA,EACtB,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,IAAI,gBAAgB,eAAe;AAAA,EAC3D,MAAM;AAAA,EACN,KAAK;AAAA,EACL,KAAK,mBAAmB,SAAA;AAAA,EACxB,UAAU,EAAE,OAAA,EAAS,IAAI,gBAAgB,mBAAmB,EAAE,SAAA;AAChE,CAAC;AAKM,MAAM,yBAAyB,uBAAuB,OAAO;AAAA,EAClE,IAAI,EAAE,QAAQ,MAAM;AAAA,EACpB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,IAAI;AACN,CAAC;AAKM,MAAM,yBAAyB,uBAAuB,OAAO;AAAA,EAClE,IAAI,EAAE,QAAQ,MAAM;AAAA,EACpB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AACR,CAAC;AAKM,MAAM,6BAA6B,uBAAuB,OAAO;AAAA,EACtE,IAAI,EAAE,QAAQ,UAAU;AAAA,EACxB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,IAAI;AACN,CAAC;AAKM,MAAM,6BAA6B,uBAAuB,OAAO;AAAA,EACtE,IAAI,EAAE,QAAQ,UAAU;AAAA,EACxB,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,IAAI,gBAAgB,eAAe;AAAA,EAC3D,UAAU,EAAE,OAAA,EAAS,IAAI,gBAAgB,mBAAmB,EAAE,SAAA;AAAA,EAC9D,SAAS,EAAE,QAAA;AAAA,EACX,MAAM;AACR,CAAC;AAKM,MAAM,qBAAqB,EAAE,mBAAmB,MAAM;AAAA,EAC3D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;"}
+{"version":3,"file":"standards-sdk.es73.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.es74.js

@@ -1,146 +1,72 @@
-class HCS20Error extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "HCS20Error";
-  }
-}
-class PointsDeploymentError extends HCS20Error {
-  constructor(message, tick) {
-    super(message);
-    this.tick = tick;
-    this.name = "PointsDeploymentError";
-  }
-}
-class PointsMintError extends HCS20Error {
-  constructor(message, tick, requestedAmount, availableSupply) {
-    super(message);
-    this.tick = tick;
-    this.requestedAmount = requestedAmount;
-    this.availableSupply = availableSupply;
-    this.name = "PointsMintError";
-  }
-}
-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";
-  }
-}
-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";
-  }
-}
-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}`
+import { Logger } from "./standards-sdk.es105.js";
+import { HederaMirrorNode } from "./standards-sdk.es126.js";
+import { HCS20_CONSTANTS, HCS20MessageSchema } from "./standards-sdk.es72.js";
+import { InvalidAccountFormatError } from "./standards-sdk.es73.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.accountId = accountId;
-    this.tick = tick;
-    this.required = required;
-    this.available = available;
-    this.name = "InsufficientBalanceError";
+    this.registryTopicId = config.registryTopicId || HCS20_CONSTANTS.REGISTRY_TOPIC_ID;
+    this.publicTopicId = config.publicTopicId || HCS20_CONSTANTS.PUBLIC_TOPIC_ID;
   }
-}
-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";
+  /**
+   * 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] };
+    }
   }
-}
-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";
+  /**
+   * Normalize tick to lowercase and trimmed
+   */
+  normalizeTick(tick) {
+    return tick.toLowerCase().trim();
   }
-}
-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";
+  /**
+   * 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();
   }
-}
-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";
+  /**
+   * 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 {
-  HCS20Error,
-  InsufficientBalanceError,
-  InvalidAccountFormatError,
-  InvalidMessageFormatError,
-  InvalidNumberFormatError,
-  InvalidTickFormatError,
-  MintLimitExceededError,
-  PointsBurnError,
-  PointsDeploymentError,
-  PointsMintError,
-  PointsNotFoundError,
-  PointsTransferError,
-  PointsValidationError,
-  SupplyLimitExceededError,
-  TopicRegistrationError
+  HCS20BaseClient
 };
 //# sourceMappingURL=standards-sdk.es74.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es74.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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"}
+{"version":3,"file":"standards-sdk.es74.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;"}