@hashgraphonline/standards-sdk 0.1.137 → 0.1.138

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es81.js","sources":["../../src/hcs-15/sdk.ts"],"sourcesContent":["import {\n  AccountId,\n  Client,\n  Hbar,\n  PrivateKey,\n  PublicKey,\n  TransactionReceipt,\n} from '@hashgraph/sdk';\nimport { NetworkType } from '../utils/types';\nimport {\n  createNodeOperatorContext,\n  type NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport {\n  buildHcs15BaseAccountCreateTx,\n  buildHcs15PetalAccountCreateTx,\n} from './tx';\nimport type { SDKHCS15ClientConfig } from './types';\nimport { HCS15BaseClient } from './base-client';\n\nexport class HCS15Client extends HCS15BaseClient {\n  private readonly operatorCtx: NodeOperatorContext;\n  private readonly client: Client;\n  private readonly operatorId: AccountId;\n\n  constructor(config: SDKHCS15ClientConfig) {\n    super(config);\n    this.operatorId = AccountId.fromString(config.operatorId);\n    this.operatorCtx = createNodeOperatorContext({\n      network: this.network,\n      operatorId: this.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client:\n        this.network === 'mainnet' ? Client.forMainnet() : Client.forTestnet(),\n    });\n    this.client = this.operatorCtx.client;\n  }\n\n  public getKeyType(): 'ed25519' | 'ecdsa' {\n    return this.operatorCtx.keyType;\n  }\n\n  public async close(): Promise<void> {\n    try {\n      this.client.close();\n    } catch {}\n  }\n\n  /**\n   * Create a new base account with a newly generated ECDSA key and EVM alias.\n   */\n  async createBaseAccount(options?: {\n    initialBalance?: number;\n    maxAutomaticTokenAssociations?: number;\n    accountMemo?: string;\n  }): Promise<{\n    accountId: string;\n    privateKey: PrivateKey;\n    privateKeyHex: string;\n    publicKey: PublicKey;\n    evmAddress: string;\n    receipt: TransactionReceipt;\n  }> {\n    const priv = PrivateKey.generateECDSA();\n    const pub = priv.publicKey;\n    const tx = buildHcs15BaseAccountCreateTx({\n      publicKey: pub,\n      initialBalance: new Hbar(options?.initialBalance ?? 10),\n      maxAutomaticTokenAssociations: options?.maxAutomaticTokenAssociations,\n      accountMemo: options?.accountMemo,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    if (!receipt.accountId) {\n      throw new Error('HCS-15 BASE_ACCOUNT_CREATE_FAILED');\n    }\n    const accountId = receipt.accountId.toString();\n    const evmAddress = `0x${pub.toEvmAddress()}`;\n    this.logger.info('Created HCS-15 base account', { accountId, evmAddress });\n    return {\n      accountId,\n      privateKey: priv,\n      privateKeyHex: priv.toStringRaw(),\n      publicKey: pub,\n      evmAddress,\n      receipt,\n    };\n  }\n\n  /**\n   * Create a Petal account that reuses the base account ECDSA key (no alias).\n   */\n  async createPetalAccount(params: {\n    basePrivateKey: string | PrivateKey;\n    initialBalance?: number;\n    maxAutomaticTokenAssociations?: number;\n    accountMemo?: string;\n  }): Promise<{ accountId: string; receipt: TransactionReceipt }> {\n    const baseKey =\n      typeof params.basePrivateKey === 'string'\n        ? PrivateKey.fromStringECDSA(params.basePrivateKey)\n        : params.basePrivateKey;\n    const pub = baseKey.publicKey;\n    const tx = buildHcs15PetalAccountCreateTx({\n      publicKey: pub,\n      initialBalance: new Hbar(params.initialBalance ?? 1),\n      maxAutomaticTokenAssociations: params.maxAutomaticTokenAssociations,\n      accountMemo: params.accountMemo,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    if (!receipt.accountId) {\n      throw new Error('HCS-15 PETAL_ACCOUNT_CREATE_FAILED');\n    }\n    const accountId = receipt.accountId.toString();\n    this.logger.info('Created HCS-15 petal account', { accountId });\n    return { accountId, receipt };\n  }\n}\n"],"names":[],"mappings":";;;;AAoBO,MAAM,oBAAoB,gBAAgB;AAAA,EAK/C,YAAY,QAA8B;AACxC,UAAM,MAAM;AACZ,SAAK,aAAa,UAAU,WAAW,OAAO,UAAU;AACxD,SAAK,cAAc,0BAA0B;AAAA,MAC3C,SAAS,KAAK;AAAA,MACd,YAAY,KAAK;AAAA,MACjB,aAAa,OAAO;AAAA,MACpB,SAAS,OAAO;AAAA,MAChB,YAAY,KAAK;AAAA,MACjB,QAAQ,KAAK;AAAA,MACb,QACE,KAAK,YAAY,YAAY,OAAO,WAAA,IAAe,OAAO,WAAA;AAAA,IAAW,CACxE;AACD,SAAK,SAAS,KAAK,YAAY;AAAA,EACjC;AAAA,EAEO,aAAkC;AACvC,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA,EAEA,MAAa,QAAuB;AAClC,QAAI;AACF,WAAK,OAAO,MAAA;AAAA,IACd,QAAQ;AAAA,IAAC;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBAAkB,SAWrB;AACD,UAAM,OAAO,WAAW,cAAA;AACxB,UAAM,MAAM,KAAK;AACjB,UAAM,KAAK,8BAA8B;AAAA,MACvC,WAAW;AAAA,MACX,gBAAgB,IAAI,KAAK,SAAS,kBAAkB,EAAE;AAAA,MACtD,+BAA+B,SAAS;AAAA,MACxC,aAAa,SAAS;AAAA,IAAA,CACvB;AACD,UAAM,OAAO,MAAM,GAAG,QAAQ,KAAK,MAAM;AACzC,UAAM,UAAU,MAAM,KAAK,WAAW,KAAK,MAAM;AACjD,QAAI,CAAC,QAAQ,WAAW;AACtB,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD;AACA,UAAM,YAAY,QAAQ,UAAU,SAAA;AACpC,UAAM,aAAa,KAAK,IAAI,aAAA,CAAc;AAC1C,SAAK,OAAO,KAAK,+BAA+B,EAAE,WAAW,YAAY;AACzE,WAAO;AAAA,MACL;AAAA,MACA,YAAY;AAAA,MACZ,eAAe,KAAK,YAAA;AAAA,MACpB,WAAW;AAAA,MACX;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAmB,QAKuC;AAC9D,UAAM,UACJ,OAAO,OAAO,mBAAmB,WAC7B,WAAW,gBAAgB,OAAO,cAAc,IAChD,OAAO;AACb,UAAM,MAAM,QAAQ;AACpB,UAAM,KAAK,+BAA+B;AAAA,MACxC,WAAW;AAAA,MACX,gBAAgB,IAAI,KAAK,OAAO,kBAAkB,CAAC;AAAA,MACnD,+BAA+B,OAAO;AAAA,MACtC,aAAa,OAAO;AAAA,IAAA,CACrB;AACD,UAAM,OAAO,MAAM,GAAG,QAAQ,KAAK,MAAM;AACzC,UAAM,UAAU,MAAM,KAAK,WAAW,KAAK,MAAM;AACjD,QAAI,CAAC,QAAQ,WAAW;AACtB,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AACA,UAAM,YAAY,QAAQ,UAAU,SAAA;AACpC,SAAK,OAAO,KAAK,gCAAgC,EAAE,WAAW;AAC9D,WAAO,EAAE,WAAW,QAAA;AAAA,EACtB;AACF;"}
+{"version":3,"file":"standards-sdk.es81.js","sources":["../../src/hcs-21/errors.ts"],"sourcesContent":["export type HCS21ErrorCode =\n  | 'size_exceeded'\n  | 'invalid_payload'\n  | 'missing_signature'\n  | 'verification_failed';\n\nexport class HCS21ValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly code: HCS21ErrorCode,\n  ) {\n    super(message);\n    this.name = 'HCS21ValidationError';\n  }\n}\n"],"names":[],"mappings":"AAMO,MAAM,6BAA6B,MAAM;AAAA,EAC9C,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}

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

@@ -1,68 +1,31 @@
-import { PrivateKey, Hbar } from "@hashgraph/sdk";
-import { HCS15BaseClient } from "./standards-sdk.es83.js";
-import { buildHcs15BaseAccountCreateTx, buildHcs15PetalAccountCreateTx } from "./standards-sdk.es80.js";
-class HCS15BrowserClient extends HCS15BaseClient {
-  constructor(config) {
-    super(config);
-    this.signer = config.signer || config.hwc?.dAppConnector?.signers?.[0];
-  }
-  requireSigner() {
-    if (!this.signer) {
-      throw new Error("HCS-15 Browser client requires an active DAppSigner");
-    }
-    return this.signer;
-  }
-  /**
-   * Create a new base account with a new ECDSA key and EVM alias using a connected wallet signer.
-   */
-  async createBaseAccount(options) {
-    const signer = this.requireSigner();
-    const priv = PrivateKey.generateECDSA();
-    const pub = priv.publicKey;
-    const tx = buildHcs15BaseAccountCreateTx({
-      publicKey: pub,
-      initialBalance: new Hbar(options?.initialBalance ?? 10),
-      maxAutomaticTokenAssociations: options?.maxAutomaticTokenAssociations,
-      accountMemo: options?.accountMemo
-    });
-    const frozen = await tx.freezeWithSigner(signer);
-    const res = await frozen.executeWithSigner(signer);
-    const receipt = await res.getReceiptWithSigner(signer);
-    const accountId = receipt?.accountId?.toString?.();
-    const evmAddress = `0x${pub.toEvmAddress()}`;
-    this.logger.info("Created HCS-15 base account (browser)", {
-      accountId,
-      evmAddress
-    });
-    return {
-      accountId,
-      privateKey: priv,
-      privateKeyHex: priv.toStringRaw(),
-      publicKey: pub,
-      evmAddress
-    };
-  }
-  /**
-   * Create a petal account reusing a base ECDSA key, via wallet signer.
-   */
-  async createPetalAccount(params) {
-    const signer = this.requireSigner();
-    const baseKey = typeof params.basePrivateKey === "string" ? PrivateKey.fromStringECDSA(params.basePrivateKey) : params.basePrivateKey;
-    const tx = buildHcs15PetalAccountCreateTx({
-      publicKey: baseKey.publicKey,
-      initialBalance: new Hbar(params.initialBalance ?? 1),
-      maxAutomaticTokenAssociations: params.maxAutomaticTokenAssociations,
-      accountMemo: params.accountMemo
-    });
-    const frozen = await tx.freezeWithSigner(signer);
-    const res = await frozen.executeWithSigner(signer);
-    const receipt = await res.getReceiptWithSigner(signer);
-    const accountId = receipt?.accountId?.toString?.();
-    this.logger.info("Created HCS-15 petal account (browser)", { accountId });
-    return { accountId };
-  }
+import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es136.js";
+import { HCS21TopicType } from "./standards-sdk.es80.js";
+function buildHcs21RegistryMemo(params) {
+  const indexed = params.indexed ?? 0;
+  return `hcs-21:${indexed}:${params.ttl}:${HCS21TopicType.REGISTRY}`;
+}
+function buildHcs21CreateRegistryTx(params) {
+  const memo = buildHcs21RegistryMemo({
+    ttl: params.ttl,
+    indexed: params.indexed
+  });
+  return buildTopicCreateTx({
+    memo,
+    adminKey: params.adminKey,
+    submitKey: params.submitKey,
+    operatorPublicKey: params.operatorPublicKey
+  });
+}
+function buildHcs21MessageTx(params) {
+  return buildMessageTx({
+    topicId: params.topicId,
+    message: JSON.stringify(params.declaration),
+    transactionMemo: params.transactionMemo
+  });
 }
 export {
-  HCS15BrowserClient
+  buildHcs21CreateRegistryTx,
+  buildHcs21MessageTx,
+  buildHcs21RegistryMemo
 };
 //# sourceMappingURL=standards-sdk.es82.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es82.js","sources":["../../src/hcs-15/browser.ts"],"sourcesContent":["import type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport type {\n  PublicKey,\n  PrivateKey,\n  TransactionResponse,\n} from '@hashgraph/sdk';\nimport { PrivateKey as SDKPrivateKey, Hbar } from '@hashgraph/sdk';\nimport type { BrowserHCS15ClientConfig } from './types';\n\nimport { HCS15BaseClient } from './base-client';\nimport {\n  buildHcs15BaseAccountCreateTx,\n  buildHcs15PetalAccountCreateTx,\n} from './tx';\n\nexport class HCS15BrowserClient extends HCS15BaseClient {\n  private readonly signer?: DAppSigner;\n\n  constructor(config: BrowserHCS15ClientConfig) {\n    super(config);\n    this.signer = config.signer || config.hwc?.dAppConnector?.signers?.[0];\n  }\n\n  private requireSigner(): DAppSigner {\n    if (!this.signer) {\n      throw new Error('HCS-15 Browser client requires an active DAppSigner');\n    }\n    return this.signer as DAppSigner;\n  }\n\n  /**\n   * Create a new base account with a new ECDSA key and EVM alias using a connected wallet signer.\n   */\n  async createBaseAccount(options?: {\n    initialBalance?: number;\n    maxAutomaticTokenAssociations?: number;\n    accountMemo?: string;\n  }): Promise<{\n    accountId?: string;\n    privateKey: PrivateKey;\n    privateKeyHex: string;\n    publicKey: PublicKey;\n    evmAddress: string;\n  }> {\n    const signer = this.requireSigner();\n    const priv = SDKPrivateKey.generateECDSA();\n    const pub = priv.publicKey;\n    const tx = buildHcs15BaseAccountCreateTx({\n      publicKey: pub,\n      initialBalance: new Hbar(options?.initialBalance ?? 10),\n      maxAutomaticTokenAssociations: options?.maxAutomaticTokenAssociations,\n      accountMemo: options?.accountMemo,\n    });\n    const frozen = await tx.freezeWithSigner(signer);\n    const res: TransactionResponse = await frozen.executeWithSigner(signer);\n    const receipt = await res.getReceiptWithSigner(signer as any);\n    const accountId = receipt?.accountId?.toString?.();\n    const evmAddress = `0x${pub.toEvmAddress()}`;\n    this.logger.info('Created HCS-15 base account (browser)', {\n      accountId,\n      evmAddress,\n    });\n    return {\n      accountId,\n      privateKey: priv,\n      privateKeyHex: priv.toStringRaw(),\n      publicKey: pub,\n      evmAddress,\n    };\n  }\n\n  /**\n   * Create a petal account reusing a base ECDSA key, via wallet signer.\n   */\n  async createPetalAccount(params: {\n    basePrivateKey: string | PrivateKey;\n    initialBalance?: number;\n    maxAutomaticTokenAssociations?: number;\n    accountMemo?: string;\n  }): Promise<{ accountId?: string }> {\n    const signer = this.requireSigner();\n    const baseKey =\n      typeof params.basePrivateKey === 'string'\n        ? SDKPrivateKey.fromStringECDSA(params.basePrivateKey)\n        : params.basePrivateKey;\n    const tx = buildHcs15PetalAccountCreateTx({\n      publicKey: baseKey.publicKey,\n      initialBalance: new Hbar(params.initialBalance ?? 1),\n      maxAutomaticTokenAssociations: params.maxAutomaticTokenAssociations,\n      accountMemo: params.accountMemo,\n    });\n    const frozen = await tx.freezeWithSigner(signer);\n    const res: TransactionResponse = await frozen.executeWithSigner(signer);\n    const receipt = await res.getReceiptWithSigner(signer as any);\n    const accountId = receipt?.accountId?.toString?.();\n    this.logger.info('Created HCS-15 petal account (browser)', { accountId });\n    return { accountId };\n  }\n}\n"],"names":["SDKPrivateKey"],"mappings":";;;AAeO,MAAM,2BAA2B,gBAAgB;AAAA,EAGtD,YAAY,QAAkC;AAC5C,UAAM,MAAM;AACZ,SAAK,SAAS,OAAO,UAAU,OAAO,KAAK,eAAe,UAAU,CAAC;AAAA,EACvE;AAAA,EAEQ,gBAA4B;AAClC,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBAAkB,SAUrB;AACD,UAAM,SAAS,KAAK,cAAA;AACpB,UAAM,OAAOA,WAAc,cAAA;AAC3B,UAAM,MAAM,KAAK;AACjB,UAAM,KAAK,8BAA8B;AAAA,MACvC,WAAW;AAAA,MACX,gBAAgB,IAAI,KAAK,SAAS,kBAAkB,EAAE;AAAA,MACtD,+BAA+B,SAAS;AAAA,MACxC,aAAa,SAAS;AAAA,IAAA,CACvB;AACD,UAAM,SAAS,MAAM,GAAG,iBAAiB,MAAM;AAC/C,UAAM,MAA2B,MAAM,OAAO,kBAAkB,MAAM;AACtE,UAAM,UAAU,MAAM,IAAI,qBAAqB,MAAa;AAC5D,UAAM,YAAY,SAAS,WAAW,WAAA;AACtC,UAAM,aAAa,KAAK,IAAI,aAAA,CAAc;AAC1C,SAAK,OAAO,KAAK,yCAAyC;AAAA,MACxD;AAAA,MACA;AAAA,IAAA,CACD;AACD,WAAO;AAAA,MACL;AAAA,MACA,YAAY;AAAA,MACZ,eAAe,KAAK,YAAA;AAAA,MACpB,WAAW;AAAA,MACX;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAmB,QAKW;AAClC,UAAM,SAAS,KAAK,cAAA;AACpB,UAAM,UACJ,OAAO,OAAO,mBAAmB,WAC7BA,WAAc,gBAAgB,OAAO,cAAc,IACnD,OAAO;AACb,UAAM,KAAK,+BAA+B;AAAA,MACxC,WAAW,QAAQ;AAAA,MACnB,gBAAgB,IAAI,KAAK,OAAO,kBAAkB,CAAC;AAAA,MACnD,+BAA+B,OAAO;AAAA,MACtC,aAAa,OAAO;AAAA,IAAA,CACrB;AACD,UAAM,SAAS,MAAM,GAAG,iBAAiB,MAAM;AAC/C,UAAM,MAA2B,MAAM,OAAO,kBAAkB,MAAM;AACtE,UAAM,UAAU,MAAM,IAAI,qBAAqB,MAAa;AAC5D,UAAM,YAAY,SAAS,WAAW,WAAA;AACtC,SAAK,OAAO,KAAK,0CAA0C,EAAE,WAAW;AACxE,WAAO,EAAE,UAAA;AAAA,EACX;AACF;"}
+{"version":3,"file":"standards-sdk.es82.js","sources":["../../src/hcs-21/tx.ts"],"sourcesContent":["import {\n  PublicKey,\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n} from '@hashgraph/sdk';\nimport {\n  buildTopicCreateTx,\n  buildMessageTx,\n  MaybeKey,\n} from '../common/tx/tx-utils';\nimport { AdapterDeclaration, HCS21TopicType } from './types';\n\nexport function buildHcs21RegistryMemo(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n}): string {\n  const indexed = params.indexed ?? 0;\n  return `hcs-21:${indexed}:${params.ttl}:${HCS21TopicType.REGISTRY}`;\n}\n\nexport function buildHcs21CreateRegistryTx(params: {\n  ttl: number;\n  indexed?: 0 | 1;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const memo = buildHcs21RegistryMemo({\n    ttl: params.ttl,\n    indexed: params.indexed,\n  });\n  return buildTopicCreateTx({\n    memo,\n    adminKey: params.adminKey,\n    submitKey: params.submitKey,\n    operatorPublicKey: params.operatorPublicKey,\n  });\n}\n\nexport function buildHcs21MessageTx(params: {\n  topicId: string;\n  declaration: AdapterDeclaration;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  return buildMessageTx({\n    topicId: params.topicId,\n    message: JSON.stringify(params.declaration),\n    transactionMemo: params.transactionMemo,\n  });\n}\n"],"names":[],"mappings":";;AAYO,SAAS,uBAAuB,QAG5B;AACT,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO,UAAU,OAAO,IAAI,OAAO,GAAG,IAAI,eAAe,QAAQ;AACnE;AAEO,SAAS,2BAA2B,QAMhB;AACzB,QAAM,OAAO,uBAAuB;AAAA,IAClC,KAAK,OAAO;AAAA,IACZ,SAAS,OAAO;AAAA,EAAA,CACjB;AACD,SAAO,mBAAmB;AAAA,IACxB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,mBAAmB,OAAO;AAAA,EAAA,CAC3B;AACH;AAEO,SAAS,oBAAoB,QAIF;AAChC,SAAO,eAAe;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,SAAS,KAAK,UAAU,OAAO,WAAW;AAAA,IAC1C,iBAAiB,OAAO;AAAA,EAAA,CACzB;AACH;"}

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

@@ -1,33 +1,77 @@
-import { HederaMirrorNode } from "./standards-sdk.es120.js";
-import { Logger } from "./standards-sdk.es99.js";
-class HCS15BaseClient {
-  constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger || new Logger({
-      module: "HCS-15",
-      level: config.logLevel || "info"
-    });
+import { HederaMirrorNode } from "./standards-sdk.es126.js";
+import { Logger } from "./standards-sdk.es105.js";
+import { HCS21ValidationError } from "./standards-sdk.es81.js";
+import { HCS21_PROTOCOL, adapterDeclarationSchema, HCS21_MAX_MESSAGE_BYTES } from "./standards-sdk.es80.js";
+class HCS21BaseClient {
+  constructor(params) {
+    this.network = params.network;
+    this.logger = params.logger || new Logger({ level: "info", module: "HCS-21" });
     this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {
-      customUrl: config.mirrorNodeUrl
+      customUrl: params.mirrorNodeUrl
     });
   }
-  /**
-   * Verify that a petal account shares the same public key as the base account.
-   */
-  async verifyPetalAccount(petalAccountId, baseAccountId) {
+  buildDeclaration(params) {
+    const declaration = {
+      p: HCS21_PROTOCOL,
+      op: params.op,
+      registry: params.registry,
+      pkg: params.pkg,
+      name: params.name,
+      kind: params.kind,
+      metadata: params.metadata
+    };
+    return this.validateDeclaration(declaration);
+  }
+  validateDeclaration(input) {
     try {
-      const petalInfo = await this.mirrorNode.requestAccount(petalAccountId);
-      const baseInfo = await this.mirrorNode.requestAccount(baseAccountId);
-      const petalKey = petalInfo?.key?.key || "";
-      const baseKey = baseInfo?.key?.key || "";
-      return petalKey !== "" && petalKey === baseKey;
-    } catch (e) {
-      this.logger.warn("verifyPetalAccount failed", { error: String(e) });
-      return false;
+      const payload = typeof input === "string" ? JSON.parse(input) : input;
+      const parsed = adapterDeclarationSchema.parse(
+        payload
+      );
+      this.assertSizeLimit(parsed);
+      return parsed;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Invalid adapter declaration";
+      throw new HCS21ValidationError(message, "invalid_payload");
+    }
+  }
+  async fetchDeclarations(topicId, options) {
+    const rawMessages = await this.mirrorNode.getTopicMessages(topicId, {
+      limit: options?.limit,
+      order: options?.order
+    });
+    const envelopes = [];
+    for (const message of rawMessages) {
+      if (message.p !== HCS21_PROTOCOL) {
+        continue;
+      }
+      try {
+        const declaration = this.validateDeclaration(message);
+        envelopes.push({
+          declaration,
+          consensusTimestamp: message.consensus_timestamp,
+          sequenceNumber: message.sequence_number,
+          payer: message.payer
+        });
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : "unknown error";
+        this.logger.warn(`Skipping invalid HCS-21 message: ${detail}`);
+      }
+    }
+    return envelopes;
+  }
+  assertSizeLimit(payload) {
+    const json = JSON.stringify(payload);
+    const bytes = Buffer.byteLength(json, "utf8");
+    if (bytes > HCS21_MAX_MESSAGE_BYTES) {
+      throw new HCS21ValidationError(
+        `HCS-21 payload exceeds 1024 bytes (${bytes})`,
+        "size_exceeded"
+      );
     }
   }
 }
 export {
-  HCS15BaseClient
+  HCS21BaseClient
 };
 //# sourceMappingURL=standards-sdk.es83.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es83.js","sources":["../../src/hcs-15/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { Logger, ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Base client for HCS‑15 shared functionality across Node and Browser clients.\n */\nexport class HCS15BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly mirrorNode: HederaMirrorNode;\n  protected readonly logger: ILogger;\n\n  constructor(config: {\n    network: NetworkType;\n    mirrorNodeUrl?: string;\n    logger?: Logger;\n    logLevel?: Parameters<Logger['setLogLevel']>[0];\n  }) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      new Logger({\n        module: 'HCS-15',\n        level: (config.logLevel as any) || 'info',\n      });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: config.mirrorNodeUrl,\n    });\n  }\n\n  /**\n   * Verify that a petal account shares the same public key as the base account.\n   */\n  public async verifyPetalAccount(\n    petalAccountId: string,\n    baseAccountId: string,\n  ): Promise<boolean> {\n    try {\n      const petalInfo = await this.mirrorNode.requestAccount(petalAccountId);\n      const baseInfo = await this.mirrorNode.requestAccount(baseAccountId);\n      const petalKey = petalInfo?.key?.key || '';\n      const baseKey = baseInfo?.key?.key || '';\n      return petalKey !== '' && petalKey === baseKey;\n    } catch (e) {\n      this.logger.warn('verifyPetalAccount failed', { error: String(e) });\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":";;AAOO,MAAM,gBAAgB;AAAA,EAK3B,YAAY,QAKT;AACD,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,IAAI,OAAO;AAAA,MACT,QAAQ;AAAA,MACR,OAAQ,OAAO,YAAoB;AAAA,IAAA,CACpC;AACH,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,QAAQ;AAAA,MAChE,WAAW,OAAO;AAAA,IAAA,CACnB;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,mBACX,gBACA,eACkB;AAClB,QAAI;AACF,YAAM,YAAY,MAAM,KAAK,WAAW,eAAe,cAAc;AACrE,YAAM,WAAW,MAAM,KAAK,WAAW,eAAe,aAAa;AACnE,YAAM,WAAW,WAAW,KAAK,OAAO;AACxC,YAAM,UAAU,UAAU,KAAK,OAAO;AACtC,aAAO,aAAa,MAAM,aAAa;AAAA,IACzC,SAAS,GAAG;AACV,WAAK,OAAO,KAAK,6BAA6B,EAAE,OAAO,OAAO,CAAC,GAAG;AAClE,aAAO;AAAA,IACT;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  AdapterOperation,\n  AdapterPackageRegistry,\n  AdapterPlatformKind,\n  HCS21_MAX_MESSAGE_BYTES,\n  HCS21_PROTOCOL,\n  adapterDeclarationSchema,\n} from './types';\n\nexport interface BuildDeclarationParams {\n  op: AdapterOperation;\n  registry: AdapterPackageRegistry;\n  pkg: string;\n  name: string;\n  kind: AdapterPlatformKind;\n  metadata?: string;\n}\n\nexport interface FetchDeclarationsOptions {\n  limit?: number;\n  order?: 'asc' | 'desc';\n}\n\nexport class HCS21BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly logger: ILogger;\n  protected readonly mirrorNode: HederaMirrorNode;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-21' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  buildDeclaration(params: BuildDeclarationParams): AdapterDeclaration {\n    const declaration: AdapterDeclaration = {\n      p: HCS21_PROTOCOL,\n      op: params.op,\n      registry: params.registry,\n      pkg: params.pkg,\n      name: params.name,\n      kind: params.kind,\n      metadata: params.metadata,\n    };\n\n    return this.validateDeclaration(declaration);\n  }\n\n  validateDeclaration(input: unknown): AdapterDeclaration {\n    try {\n      const payload = typeof input === 'string' ? JSON.parse(input) : input;\n      const parsed = adapterDeclarationSchema.parse(\n        payload,\n      ) as AdapterDeclaration;\n      this.assertSizeLimit(parsed);\n      return parsed;\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : 'Invalid adapter declaration';\n      throw new HCS21ValidationError(message, 'invalid_payload');\n    }\n  }\n\n  async fetchDeclarations(\n    topicId: string,\n    options?: FetchDeclarationsOptions,\n  ): Promise<AdapterDeclarationEnvelope[]> {\n    const rawMessages = await this.mirrorNode.getTopicMessages(topicId, {\n      limit: options?.limit,\n      order: options?.order,\n    });\n\n    const envelopes: AdapterDeclarationEnvelope[] = [];\n\n    for (const message of rawMessages) {\n      if (message.p !== HCS21_PROTOCOL) {\n        continue;\n      }\n\n      try {\n        const declaration = this.validateDeclaration(message);\n        envelopes.push({\n          declaration,\n          consensusTimestamp: message.consensus_timestamp,\n          sequenceNumber: message.sequence_number,\n          payer: message.payer,\n        });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : 'unknown error';\n        this.logger.warn(`Skipping invalid HCS-21 message: ${detail}`);\n      }\n    }\n\n    return envelopes;\n  }\n\n  protected assertSizeLimit(payload: AdapterDeclaration): void {\n    const json = JSON.stringify(payload);\n    const bytes = Buffer.byteLength(json, 'utf8');\n    if (bytes > HCS21_MAX_MESSAGE_BYTES) {\n      throw new HCS21ValidationError(\n        `HCS-21 payload exceeds 1024 bytes (${bytes})`,\n        'size_exceeded',\n      );\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AA6BO,MAAM,gBAAgB;AAAA,EAK3B,YAAY,QAIT;AACD,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UAAU,IAAI,OAAO,EAAE,OAAO,QAAQ,QAAQ,UAAU;AACjE,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,QAAQ;AAAA,MAChE,WAAW,OAAO;AAAA,IAAA,CACnB;AAAA,EACH;AAAA,EAEA,iBAAiB,QAAoD;AACnE,UAAM,cAAkC;AAAA,MACtC,GAAG;AAAA,MACH,IAAI,OAAO;AAAA,MACX,UAAU,OAAO;AAAA,MACjB,KAAK,OAAO;AAAA,MACZ,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,IAAA;AAGnB,WAAO,KAAK,oBAAoB,WAAW;AAAA,EAC7C;AAAA,EAEA,oBAAoB,OAAoC;AACtD,QAAI;AACF,YAAM,UAAU,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAChE,YAAM,SAAS,yBAAyB;AAAA,QACtC;AAAA,MAAA;AAEF,WAAK,gBAAgB,MAAM;AAC3B,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,YAAM,IAAI,qBAAqB,SAAS,iBAAiB;AAAA,IAC3D;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,SACA,SACuC;AACvC,UAAM,cAAc,MAAM,KAAK,WAAW,iBAAiB,SAAS;AAAA,MAClE,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,IAAA,CACjB;AAED,UAAM,YAA0C,CAAA;AAEhD,eAAW,WAAW,aAAa;AACjC,UAAI,QAAQ,MAAM,gBAAgB;AAChC;AAAA,MACF;AAEA,UAAI;AACF,cAAM,cAAc,KAAK,oBAAoB,OAAO;AACpD,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,oBAAoB,QAAQ;AAAA,UAC5B,gBAAgB,QAAQ;AAAA,UACxB,OAAO,QAAQ;AAAA,QAAA,CAChB;AAAA,MACH,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AACxD,aAAK,OAAO,KAAK,oCAAoC,MAAM,EAAE;AAAA,MAC/D;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEU,gBAAgB,SAAmC;AAC3D,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,QAAQ,OAAO,WAAW,MAAM,MAAM;AAC5C,QAAI,QAAQ,yBAAyB;AACnC,YAAM,IAAI;AAAA,QACR,sCAAsC,KAAK;AAAA,QAC3C;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;"}

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

@@ -1,28 +1,170 @@
-var FloraTopicType = /* @__PURE__ */ ((FloraTopicType2) => {
-  FloraTopicType2[FloraTopicType2["COMMUNICATION"] = 0] = "COMMUNICATION";
-  FloraTopicType2[FloraTopicType2["TRANSACTION"] = 1] = "TRANSACTION";
-  FloraTopicType2[FloraTopicType2["STATE"] = 2] = "STATE";
-  return FloraTopicType2;
-})(FloraTopicType || {});
-var FloraOperation = /* @__PURE__ */ ((FloraOperation2) => {
-  FloraOperation2["FLORA_CREATED"] = "flora_created";
-  FloraOperation2["TRANSACTION"] = "transaction";
-  FloraOperation2["STATE_UPDATE"] = "state_update";
-  FloraOperation2["FLORA_JOIN_REQUEST"] = "flora_join_request";
-  FloraOperation2["FLORA_JOIN_VOTE"] = "flora_join_vote";
-  FloraOperation2["FLORA_JOIN_ACCEPTED"] = "flora_join_accepted";
-  return FloraOperation2;
-})(FloraOperation || {});
-class FloraError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "FloraError";
+import { Client, Status } from "@hashgraph/sdk";
+import { createNodeOperatorContext } from "./standards-sdk.es135.js";
+import { Logger } from "./standards-sdk.es105.js";
+import { HCS21BaseClient } from "./standards-sdk.es83.js";
+import { HCS21MetadataPointerPattern } from "./standards-sdk.es80.js";
+import { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from "./standards-sdk.es82.js";
+import { HCS21ValidationError } from "./standards-sdk.es81.js";
+import { inscribe } from "./standards-sdk.es124.js";
+import { getTopicId } from "./standards-sdk.es114.js";
+class HCS21Client extends HCS21BaseClient {
+  constructor(config) {
+    const logger = config.logger || new Logger({ level: config.logLevel || "info", module: "HCS-21" });
+    super({
+      network: config.network,
+      logger,
+      mirrorNodeUrl: config.mirrorNodeUrl
+    });
+    const baseClient = config.network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
+    this.operatorCtx = createNodeOperatorContext({
+      network: config.network,
+      operatorId: config.operatorId,
+      operatorKey: config.operatorKey,
+      keyType: config.keyType,
+      mirrorNode: this.mirrorNode,
+      logger: this.logger,
+      client: baseClient
+    });
+    void this.operatorCtx.ensureInitialized();
+    this.client = this.operatorCtx.client;
+  }
+  async inscribeMetadata(params) {
+    await this.operatorCtx.ensureInitialized();
+    const metadataJson = JSON.stringify(params.metadata, null, 2);
+    const buffer = Buffer.from(metadataJson, "utf8");
+    const inscriptionOptions = {
+      waitForConfirmation: true,
+      ...params.inscriptionOptions || {},
+      metadata: {
+        ...params.inscriptionOptions?.metadata || {},
+        ...params.metadata
+      }
+    };
+    const inscription = await inscribe(
+      {
+        type: "buffer",
+        buffer,
+        fileName: params.fileName || `hcs21-adapter-metadata-${Date.now()}.json`,
+        mimeType: "application/json"
+      },
+      {
+        accountId: this.operatorCtx.operatorId.toString(),
+        privateKey: this.operatorCtx.operatorKey,
+        network: this.network
+      },
+      inscriptionOptions
+    );
+    if (!inscription.confirmed || !inscription.inscription) {
+      throw new HCS21ValidationError(
+        "Failed to inscribe adapter metadata",
+        "invalid_payload"
+      );
+    }
+    const topicId = inscription.inscription.jsonTopicId || inscription.inscription.topic_id || getTopicId(inscription.inscription);
+    if (!topicId) {
+      throw new HCS21ValidationError(
+        "Metadata inscription did not return a topic ID",
+        "invalid_payload"
+      );
+    }
+    const rawSequence = inscription.inscription.sequence_number ?? inscription.inscription.sequenceNumber;
+    const pointerResult = await this.resolveMetadataPointer(
+      topicId,
+      rawSequence
+    );
+    const resultDetails = inscription.result && "jobId" in inscription.result ? {
+      jobId: inscription.result.jobId,
+      transactionId: inscription.result.transactionId
+    } : {};
+    return {
+      pointer: pointerResult.pointer,
+      topicId,
+      sequenceNumber: pointerResult.sequenceNumber,
+      ...resultDetails
+    };
+  }
+  async createRegistryTopic(params) {
+    await this.operatorCtx.ensureInitialized();
+    const tx = buildHcs21CreateRegistryTx({
+      ttl: params.ttl,
+      indexed: params.indexed,
+      adminKey: params.adminKey,
+      submitKey: params.submitKey,
+      operatorPublicKey: this.operatorCtx.operatorKey.publicKey
+    });
+    if (params.transactionMemo) {
+      tx.setTransactionMemo(params.transactionMemo);
+    }
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success || !receipt.topicId) {
+      throw new HCS21ValidationError(
+        "Failed to create HCS-21 registry topic",
+        "invalid_payload"
+      );
+    }
+    return receipt.topicId.toString();
+  }
+  async publishDeclaration(params) {
+    await this.operatorCtx.ensureInitialized();
+    const declaration = this.normalizeDeclarationInput(params.declaration);
+    const tx = buildHcs21MessageTx({
+      topicId: params.topicId,
+      declaration,
+      transactionMemo: params.transactionMemo
+    });
+    const response = await tx.execute(this.client);
+    const receipt = await response.getReceipt(this.client);
+    if (receipt.status !== Status.Success) {
+      throw new HCS21ValidationError(
+        "Failed to submit HCS-21 declaration",
+        "invalid_payload"
+      );
+    }
+    return {
+      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),
+      transactionId: response.transactionId.toString()
+    };
+  }
+  normalizeDeclarationInput(declaration) {
+    if ("p" in declaration) {
+      return this.validateDeclaration(declaration);
+    }
+    return this.buildDeclaration(declaration);
+  }
+  async resolveMetadataPointer(topicId, sequence) {
+    const numericSequence = typeof sequence === "string" ? Number(sequence) : sequence;
+    let resolvedSequence = typeof numericSequence === "number" && Number.isFinite(numericSequence) ? numericSequence : void 0;
+    if (!resolvedSequence) {
+      const [latest] = await this.mirrorNode.getTopicMessages(topicId, {
+        limit: 1,
+        order: "desc"
+      });
+      if (!latest || !latest.sequence_number) {
+        throw new HCS21ValidationError(
+          "Unable to resolve metadata sequence number",
+          "invalid_payload"
+        );
+      }
+      resolvedSequence = Number(latest.sequence_number);
+    }
+    if (!Number.isFinite(resolvedSequence)) {
+      throw new HCS21ValidationError(
+        "Invalid metadata sequence number",
+        "invalid_payload"
+      );
+    }
+    const pointer = `hcs://1/${topicId}/${resolvedSequence}`;
+    if (!HCS21MetadataPointerPattern.test(pointer)) {
+      throw new HCS21ValidationError(
+        "Metadata pointer format is invalid",
+        "invalid_payload"
+      );
+    }
+    return { pointer, sequenceNumber: resolvedSequence };
   }
 }
 export {
-  FloraError,
-  FloraOperation,
-  FloraTopicType
+  HCS21Client
 };
 //# sourceMappingURL=standards-sdk.es84.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es84.js","sources":["../../src/hcs-16/types.ts"],"sourcesContent":["import {\n  AccountId,\n  TopicId,\n  PublicKey,\n  Key,\n  PrivateKey,\n  KeyList,\n  TokenId,\n} from '@hashgraph/sdk';\nimport { BaseProfile, SocialLink } from '../hcs-11/types';\n\n/**\n * HCS-16 Topic type enums\n */\nexport enum FloraTopicType {\n  COMMUNICATION = 0,\n  TRANSACTION = 1,\n  STATE = 2,\n}\n\n/**\n * HCS-16 Flora member\n */\nexport interface FloraMember {\n  accountId: string;\n  publicKey?: PublicKey | string;\n  privateKey?: string;\n  weight?: number;\n}\n\n/**\n * HCS-16 Flora topics\n */\nexport interface FloraTopics {\n  communication: TopicId;\n  transaction: TopicId;\n  state: TopicId;\n  custom?: Array<{\n    name: string;\n    topicId: string;\n    description?: string;\n  }>;\n}\n\n/**\n * HCS-16 Flora configuration\n */\nexport interface FloraConfig {\n  displayName: string;\n  bio?: string;\n  members: FloraMember[];\n  threshold: number;\n  initialBalance?: number;\n  maxAutomaticTokenAssociations?: number;\n  policies?: {\n    membershipChange?: string;\n    scheduleTxApproval?: string;\n  };\n  customFees?: {\n    amount: number;\n    feeCollectorAccountId: string;\n  }[];\n  metadata?: Record<string, any>;\n}\n\n/**\n * HCS-16 Flora creation result\n */\nexport interface FloraCreationResult {\n  floraAccountId: AccountId;\n  topics: FloraTopics;\n  keyList: Key;\n  transactionId: string;\n}\n\n/**\n * HCS-16 Message protocol operations\n */\nexport enum FloraOperation {\n  FLORA_CREATED = 'flora_created',\n  TRANSACTION = 'transaction',\n  STATE_UPDATE = 'state_update',\n  FLORA_JOIN_REQUEST = 'flora_join_request',\n  FLORA_JOIN_VOTE = 'flora_join_vote',\n  FLORA_JOIN_ACCEPTED = 'flora_join_accepted',\n}\n\n/**\n * HCS-16 Message envelope\n */\nexport interface FloraMessage {\n  p: 'hcs-16';\n  op: FloraOperation;\n  operator_id: string;\n  m?: string;\n  [key: string]: unknown;\n}\n\n/**\n * HCS-16 Flora profile (extends HCS-11)\n */\nexport interface FloraProfile extends BaseProfile {\n  version: string;\n  type: 3;\n  display_name: string;\n  members: FloraMember[];\n  threshold: number;\n  topics: {\n    communication: string;\n    transaction: string;\n    state: string;\n    custom?: Array<{\n      name: string;\n      topicId: string;\n      description?: string;\n    }>;\n  };\n  alias?: string;\n  bio?: string;\n  socials?: SocialLink[];\n  profileImage?: string;\n  properties?: Record<string, unknown>;\n  inboundTopicId: string;\n  outboundTopicId: string;\n  policies?: Record<string, string>;\n  metadata?: Record<string, any>;\n}\n\n/**\n * HCS-16 errors\n */\nexport class FloraError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'FloraError';\n  }\n}\n\n/**\n * Flora state update message\n */\nexport interface FloraStateUpdate {\n  p: 'hcs-16';\n  op: 'state_update';\n  operator_id: string;\n  hash: string;\n  epoch?: number;\n  members?: string[];\n  timestamp: string;\n}\n\n/**\n * HIP-991 Custom fee configuration for transaction topics\n */\nexport interface TransactionTopicFee {\n  amount: number;\n  feeCollectorAccountId: string;\n  denominatingTokenId?: string;\n}\n\n/**\n * Configuration for creating HCS-16 transaction topics with HIP-991 support\n */\nexport interface TransactionTopicConfig {\n  memo: string;\n  adminKey?: PrivateKey | KeyList;\n  submitKey?: PrivateKey | KeyList;\n  feeScheduleKey?: PrivateKey | KeyList;\n  customFees?: TransactionTopicFee[];\n  feeExemptKeys?: Key[];\n}\n\n/** credit_purchase not part of HCS-16 specification; no message type defined. */\n"],"names":["FloraTopicType","FloraOperation"],"mappings":"AAcO,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,mBAAgB,CAAA,IAAhB;AACAA,kBAAAA,gBAAA,iBAAc,CAAA,IAAd;AACAA,kBAAAA,gBAAA,WAAQ,CAAA,IAAR;AAHU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAgEL,IAAK,mCAAAC,oBAAL;AACLA,kBAAA,eAAA,IAAgB;AAChBA,kBAAA,aAAA,IAAc;AACdA,kBAAA,cAAA,IAAe;AACfA,kBAAA,oBAAA,IAAqB;AACrBA,kBAAA,iBAAA,IAAkB;AAClBA,kBAAA,qBAAA,IAAsB;AANZ,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAqDL,MAAM,mBAAmB,MAAM;AAAA,EACpC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"standards-sdk.es84.js","sources":["../../src/hcs-21/sdk.ts"],"sourcesContent":["import {\n  Client,\n  PrivateKey,\n  Status,\n  TopicCreateTransaction,\n} from '@hashgraph/sdk';\nimport {\n  createNodeOperatorContext,\n  NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport { Logger, ILogger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { HCS21BaseClient, BuildDeclarationParams } from './base-client';\nimport {\n  AdapterDeclaration,\n  AdapterMetadataPointer,\n  AdapterMetadataRecord,\n  HCS21MetadataPointerPattern,\n} from './types';\nimport { buildHcs21CreateRegistryTx, buildHcs21MessageTx } from './tx';\nimport { HCS21ValidationError } from './errors';\nimport { MaybeKey } from '../common/tx/tx-utils';\nimport { inscribe } from '../inscribe/inscriber';\nimport type { InscriptionOptions } from '../inscribe/types';\nimport { getTopicId } from '../utils/topic-id-utils';\n\nexport interface HCS21ClientConfig {\n  network: NetworkType;\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n  logLevel?: LogLevel;\n  logger?: ILogger;\n  mirrorNodeUrl?: string;\n}\n\nexport interface CreateRegistryTopicParams {\n  ttl: number;\n  indexed?: 0 | 1;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  transactionMemo?: string;\n}\n\nexport interface PublishDeclarationResult {\n  sequenceNumber?: number;\n  transactionId: string;\n}\n\nexport interface PublishDeclarationParams {\n  topicId: string;\n  declaration: AdapterDeclaration | BuildDeclarationParams;\n  transactionMemo?: string;\n}\n\nexport interface InscribeAdapterMetadataParams {\n  metadata: AdapterMetadataRecord;\n  fileName?: string;\n  inscriptionOptions?: InscriptionOptions;\n}\n\nexport class HCS21Client extends HCS21BaseClient {\n  private readonly client: Client;\n  private readonly operatorCtx: NodeOperatorContext;\n\n  constructor(config: HCS21ClientConfig) {\n    const logger =\n      config.logger ||\n      new Logger({ level: config.logLevel || 'info', module: 'HCS-21' });\n    super({\n      network: config.network,\n      logger,\n      mirrorNodeUrl: config.mirrorNodeUrl,\n    });\n\n    const baseClient =\n      config.network === 'mainnet' ? Client.forMainnet() : Client.forTestnet();\n\n    this.operatorCtx = createNodeOperatorContext({\n      network: config.network,\n      operatorId: config.operatorId,\n      operatorKey: config.operatorKey,\n      keyType: config.keyType,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client: baseClient,\n    });\n\n    void this.operatorCtx.ensureInitialized();\n    this.client = this.operatorCtx.client;\n  }\n\n  async inscribeMetadata(\n    params: InscribeAdapterMetadataParams,\n  ): Promise<AdapterMetadataPointer> {\n    await this.operatorCtx.ensureInitialized();\n\n    const metadataJson = JSON.stringify(params.metadata, null, 2);\n    const buffer = Buffer.from(metadataJson, 'utf8');\n    const inscriptionOptions: InscriptionOptions = {\n      waitForConfirmation: true,\n      ...(params.inscriptionOptions || {}),\n      metadata: {\n        ...(params.inscriptionOptions?.metadata || {}),\n        ...params.metadata,\n      },\n    };\n\n    const inscription = await inscribe(\n      {\n        type: 'buffer',\n        buffer,\n        fileName:\n          params.fileName || `hcs21-adapter-metadata-${Date.now()}.json`,\n        mimeType: 'application/json',\n      },\n      {\n        accountId: this.operatorCtx.operatorId.toString(),\n        privateKey: this.operatorCtx.operatorKey,\n        network: this.network,\n      },\n      inscriptionOptions,\n    );\n\n    if (!inscription.confirmed || !inscription.inscription) {\n      throw new HCS21ValidationError(\n        'Failed to inscribe adapter metadata',\n        'invalid_payload',\n      );\n    }\n\n    const topicId =\n      (inscription.inscription as { jsonTopicId?: string }).jsonTopicId ||\n      (inscription.inscription as { topic_id?: string }).topic_id ||\n      getTopicId(inscription.inscription);\n\n    if (!topicId) {\n      throw new HCS21ValidationError(\n        'Metadata inscription did not return a topic ID',\n        'invalid_payload',\n      );\n    }\n\n    const rawSequence =\n      (inscription.inscription as { sequence_number?: number })\n        .sequence_number ??\n      (inscription.inscription as { sequenceNumber?: number }).sequenceNumber;\n\n    const pointerResult = await this.resolveMetadataPointer(\n      topicId,\n      rawSequence,\n    );\n\n    const resultDetails =\n      inscription.result && 'jobId' in inscription.result\n        ? {\n            jobId: inscription.result.jobId,\n            transactionId: inscription.result.transactionId,\n          }\n        : {};\n\n    return {\n      pointer: pointerResult.pointer,\n      topicId,\n      sequenceNumber: pointerResult.sequenceNumber,\n      ...resultDetails,\n    };\n  }\n\n  async createRegistryTopic(\n    params: CreateRegistryTopicParams,\n  ): Promise<string> {\n    await this.operatorCtx.ensureInitialized();\n\n    const tx: TopicCreateTransaction = buildHcs21CreateRegistryTx({\n      ttl: params.ttl,\n      indexed: params.indexed,\n      adminKey: params.adminKey,\n      submitKey: params.submitKey,\n      operatorPublicKey: this.operatorCtx.operatorKey.publicKey,\n    });\n\n    if (params.transactionMemo) {\n      tx.setTransactionMemo(params.transactionMemo);\n    }\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success || !receipt.topicId) {\n      throw new HCS21ValidationError(\n        'Failed to create HCS-21 registry topic',\n        'invalid_payload',\n      );\n    }\n\n    return receipt.topicId.toString();\n  }\n\n  async publishDeclaration(\n    params: PublishDeclarationParams,\n  ): Promise<PublishDeclarationResult> {\n    await this.operatorCtx.ensureInitialized();\n\n    const declaration = this.normalizeDeclarationInput(params.declaration);\n    const tx = buildHcs21MessageTx({\n      topicId: params.topicId,\n      declaration,\n      transactionMemo: params.transactionMemo,\n    });\n\n    const response = await tx.execute(this.client);\n    const receipt = await response.getReceipt(this.client);\n\n    if (receipt.status !== Status.Success) {\n      throw new HCS21ValidationError(\n        'Failed to submit HCS-21 declaration',\n        'invalid_payload',\n      );\n    }\n\n    return {\n      sequenceNumber: receipt.topicSequenceNumber?.toNumber(),\n      transactionId: response.transactionId.toString(),\n    };\n  }\n\n  private normalizeDeclarationInput(\n    declaration: AdapterDeclaration | BuildDeclarationParams,\n  ): AdapterDeclaration {\n    if ('p' in declaration) {\n      return this.validateDeclaration(declaration);\n    }\n    return this.buildDeclaration(declaration);\n  }\n\n  private async resolveMetadataPointer(\n    topicId: string,\n    sequence?: number,\n  ): Promise<{ pointer: string; sequenceNumber: number }> {\n    const numericSequence =\n      typeof sequence === 'string' ? Number(sequence) : sequence;\n    let resolvedSequence =\n      typeof numericSequence === 'number' && Number.isFinite(numericSequence)\n        ? numericSequence\n        : undefined;\n\n    if (!resolvedSequence) {\n      const [latest] = await this.mirrorNode.getTopicMessages(topicId, {\n        limit: 1,\n        order: 'desc',\n      });\n\n      if (!latest || !latest.sequence_number) {\n        throw new HCS21ValidationError(\n          'Unable to resolve metadata sequence number',\n          'invalid_payload',\n        );\n      }\n\n      resolvedSequence = Number(latest.sequence_number);\n    }\n\n    if (!Number.isFinite(resolvedSequence)) {\n      throw new HCS21ValidationError(\n        'Invalid metadata sequence number',\n        'invalid_payload',\n      );\n    }\n\n    const pointer = `hcs://1/${topicId}/${resolvedSequence}`;\n\n    if (!HCS21MetadataPointerPattern.test(pointer)) {\n      throw new HCS21ValidationError(\n        'Metadata pointer format is invalid',\n        'invalid_payload',\n      );\n    }\n\n    return { pointer, sequenceNumber: resolvedSequence };\n  }\n}\n"],"names":[],"mappings":"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"}