@hashgraphonline/standards-sdk 0.0.68 → 0.0.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/README.md +13 -0
  2. package/dist/es/fees/fee-config-builder.d.ts +93 -45
  3. package/dist/es/fees/fee-config-builder.d.ts.map +1 -1
  4. package/dist/es/fees/types.d.ts +14 -12
  5. package/dist/es/fees/types.d.ts.map +1 -1
  6. package/dist/es/hcs-10/base-client.d.ts +8 -1
  7. package/dist/es/hcs-10/base-client.d.ts.map +1 -1
  8. package/dist/es/hcs-10/browser.d.ts.map +1 -1
  9. package/dist/es/hcs-10/sdk.d.ts +9 -1
  10. package/dist/es/hcs-10/sdk.d.ts.map +1 -1
  11. package/dist/es/services/mirror-node.d.ts +74 -1
  12. package/dist/es/services/mirror-node.d.ts.map +1 -1
  13. package/dist/es/services/types.d.ts +29 -0
  14. package/dist/es/services/types.d.ts.map +1 -1
  15. package/dist/es/standards-sdk.es.js +2 -0
  16. package/dist/es/standards-sdk.es.js.map +1 -1
  17. package/dist/es/standards-sdk.es100.js +60 -3
  18. package/dist/es/standards-sdk.es100.js.map +1 -1
  19. package/dist/es/standards-sdk.es101.js +1286 -13
  20. package/dist/es/standards-sdk.es101.js.map +1 -1
  21. package/dist/es/standards-sdk.es102.js +147 -4
  22. package/dist/es/standards-sdk.es102.js.map +1 -1
  23. package/dist/es/standards-sdk.es103.js +91 -39
  24. package/dist/es/standards-sdk.es103.js.map +1 -1
  25. package/dist/es/standards-sdk.es104.js +80 -36
  26. package/dist/es/standards-sdk.es104.js.map +1 -1
  27. package/dist/es/standards-sdk.es105.js +31 -36
  28. package/dist/es/standards-sdk.es105.js.map +1 -1
  29. package/dist/es/standards-sdk.es106.js +6 -78
  30. package/dist/es/standards-sdk.es106.js.map +1 -1
  31. package/dist/es/standards-sdk.es107.js +159 -2282
  32. package/dist/es/standards-sdk.es107.js.map +1 -1
  33. package/dist/es/standards-sdk.es108.js +23 -3
  34. package/dist/es/standards-sdk.es108.js.map +1 -1
  35. package/dist/es/standards-sdk.es109.js +793 -2
  36. package/dist/es/standards-sdk.es109.js.map +1 -1
  37. package/dist/es/standards-sdk.es110.js +174 -2
  38. package/dist/es/standards-sdk.es110.js.map +1 -1
  39. package/dist/es/standards-sdk.es111.js +142 -33
  40. package/dist/es/standards-sdk.es111.js.map +1 -1
  41. package/dist/es/standards-sdk.es112.js +20 -32
  42. package/dist/es/standards-sdk.es112.js.map +1 -1
  43. package/dist/es/standards-sdk.es113.js +27 -9
  44. package/dist/es/standards-sdk.es113.js.map +1 -1
  45. package/dist/es/standards-sdk.es114.js +25 -33
  46. package/dist/es/standards-sdk.es114.js.map +1 -1
  47. package/dist/es/standards-sdk.es115.js +41 -0
  48. package/dist/es/standards-sdk.es115.js.map +1 -0
  49. package/dist/es/standards-sdk.es12.js +3 -3
  50. package/dist/es/standards-sdk.es14.js +1 -1
  51. package/dist/es/standards-sdk.es17.js +2 -2
  52. package/dist/es/standards-sdk.es18.js +94 -6
  53. package/dist/es/standards-sdk.es18.js.map +1 -1
  54. package/dist/es/standards-sdk.es19.js +127 -67
  55. package/dist/es/standards-sdk.es19.js.map +1 -1
  56. package/dist/es/standards-sdk.es20.js +7 -1767
  57. package/dist/es/standards-sdk.es20.js.map +1 -1
  58. package/dist/es/standards-sdk.es21.js +1767 -3
  59. package/dist/es/standards-sdk.es21.js.map +1 -1
  60. package/dist/es/standards-sdk.es22.js +36 -4167
  61. package/dist/es/standards-sdk.es22.js.map +1 -1
  62. package/dist/es/standards-sdk.es23.js +48 -5
  63. package/dist/es/standards-sdk.es23.js.map +1 -1
  64. package/dist/es/standards-sdk.es24.js +6627 -36
  65. package/dist/es/standards-sdk.es24.js.map +1 -1
  66. package/dist/es/standards-sdk.es25.js +3 -48
  67. package/dist/es/standards-sdk.es25.js.map +1 -1
  68. package/dist/es/standards-sdk.es26.js +2 -6627
  69. package/dist/es/standards-sdk.es26.js.map +1 -1
  70. package/dist/es/standards-sdk.es27.js +1041 -2
  71. package/dist/es/standards-sdk.es27.js.map +1 -1
  72. package/dist/es/standards-sdk.es28.js +4086 -960
  73. package/dist/es/standards-sdk.es28.js.map +1 -1
  74. package/dist/es/standards-sdk.es29.js +5 -419
  75. package/dist/es/standards-sdk.es29.js.map +1 -1
  76. package/dist/es/standards-sdk.es30.js +419 -2
  77. package/dist/es/standards-sdk.es30.js.map +1 -1
  78. package/dist/es/standards-sdk.es31.js +2 -120
  79. package/dist/es/standards-sdk.es31.js.map +1 -1
  80. package/dist/es/standards-sdk.es32.js +119 -3
  81. package/dist/es/standards-sdk.es32.js.map +1 -1
  82. package/dist/es/standards-sdk.es33.js +3 -2
  83. package/dist/es/standards-sdk.es33.js.map +1 -1
  84. package/dist/es/standards-sdk.es34.js +164 -3
  85. package/dist/es/standards-sdk.es34.js.map +1 -1
  86. package/dist/es/standards-sdk.es35.js +1 -161
  87. package/dist/es/standards-sdk.es35.js.map +1 -1
  88. package/dist/es/standards-sdk.es36.js +2 -2
  89. package/dist/es/standards-sdk.es38.js +5 -5
  90. package/dist/es/standards-sdk.es4.js +1 -1
  91. package/dist/es/standards-sdk.es40.js +3 -3
  92. package/dist/es/standards-sdk.es46.js +1 -1
  93. package/dist/es/standards-sdk.es5.js +20 -3
  94. package/dist/es/standards-sdk.es5.js.map +1 -1
  95. package/dist/es/standards-sdk.es50.js +1 -1
  96. package/dist/es/standards-sdk.es51.js +3 -3
  97. package/dist/es/standards-sdk.es53.js +100 -22
  98. package/dist/es/standards-sdk.es53.js.map +1 -1
  99. package/dist/es/standards-sdk.es54.js +2 -174
  100. package/dist/es/standards-sdk.es54.js.map +1 -1
  101. package/dist/es/standards-sdk.es55.js +15 -90
  102. package/dist/es/standards-sdk.es55.js.map +1 -1
  103. package/dist/es/standards-sdk.es56.js +408 -5
  104. package/dist/es/standards-sdk.es56.js.map +1 -1
  105. package/dist/es/standards-sdk.es57.js +25 -136
  106. package/dist/es/standards-sdk.es57.js.map +1 -1
  107. package/dist/es/standards-sdk.es58.js +44 -176
  108. package/dist/es/standards-sdk.es58.js.map +1 -1
  109. package/dist/es/standards-sdk.es59.js +47 -435
  110. package/dist/es/standards-sdk.es59.js.map +1 -1
  111. package/dist/es/standards-sdk.es60.js +9 -24
  112. package/dist/es/standards-sdk.es60.js.map +1 -1
  113. package/dist/es/standards-sdk.es61.js +57 -131
  114. package/dist/es/standards-sdk.es61.js.map +1 -1
  115. package/dist/es/standards-sdk.es62.js +6 -18
  116. package/dist/es/standards-sdk.es62.js.map +1 -1
  117. package/dist/es/standards-sdk.es63.js +14 -28
  118. package/dist/es/standards-sdk.es63.js.map +1 -1
  119. package/dist/es/standards-sdk.es64.js +7 -29
  120. package/dist/es/standards-sdk.es64.js.map +1 -1
  121. package/dist/es/standards-sdk.es65.js +44 -20
  122. package/dist/es/standards-sdk.es65.js.map +1 -1
  123. package/dist/es/standards-sdk.es66.js +2 -44
  124. package/dist/es/standards-sdk.es66.js.map +1 -1
  125. package/dist/es/standards-sdk.es67.js +136 -18
  126. package/dist/es/standards-sdk.es67.js.map +1 -1
  127. package/dist/es/standards-sdk.es68.js +165 -54
  128. package/dist/es/standards-sdk.es68.js.map +1 -1
  129. package/dist/es/standards-sdk.es69.js +2281 -1288
  130. package/dist/es/standards-sdk.es69.js.map +1 -1
  131. package/dist/es/standards-sdk.es7.js +96 -40
  132. package/dist/es/standards-sdk.es7.js.map +1 -1
  133. package/dist/es/standards-sdk.es70.js +13 -148
  134. package/dist/es/standards-sdk.es70.js.map +1 -1
  135. package/dist/es/standards-sdk.es71.js +13 -84
  136. package/dist/es/standards-sdk.es71.js.map +1 -1
  137. package/dist/es/standards-sdk.es72.js +30 -30
  138. package/dist/es/standards-sdk.es72.js.map +1 -1
  139. package/dist/es/standards-sdk.es73.js +13 -157
  140. package/dist/es/standards-sdk.es73.js.map +1 -1
  141. package/dist/es/standards-sdk.es74.js +3 -792
  142. package/dist/es/standards-sdk.es74.js.map +1 -1
  143. package/dist/es/standards-sdk.es75.js +3 -31
  144. package/dist/es/standards-sdk.es75.js.map +1 -1
  145. package/dist/es/standards-sdk.es76.js +14 -61
  146. package/dist/es/standards-sdk.es76.js.map +1 -1
  147. package/dist/es/standards-sdk.es77.js +4 -49
  148. package/dist/es/standards-sdk.es77.js.map +1 -1
  149. package/dist/es/standards-sdk.es78.js +39 -10
  150. package/dist/es/standards-sdk.es78.js.map +1 -1
  151. package/dist/es/standards-sdk.es79.js +33 -58
  152. package/dist/es/standards-sdk.es79.js.map +1 -1
  153. package/dist/es/standards-sdk.es8.js +17 -4
  154. package/dist/es/standards-sdk.es8.js.map +1 -1
  155. package/dist/es/standards-sdk.es80.js +36 -5
  156. package/dist/es/standards-sdk.es80.js.map +1 -1
  157. package/dist/es/standards-sdk.es81.js +76 -13
  158. package/dist/es/standards-sdk.es81.js.map +1 -1
  159. package/dist/es/standards-sdk.es82.js +3 -7
  160. package/dist/es/standards-sdk.es82.js.map +1 -1
  161. package/dist/es/standards-sdk.es83.js +2 -45
  162. package/dist/es/standards-sdk.es83.js.map +1 -1
  163. package/dist/es/standards-sdk.es84.js +2 -2
  164. package/dist/es/standards-sdk.es84.js.map +1 -1
  165. package/dist/es/standards-sdk.es85.js +2 -136
  166. package/dist/es/standards-sdk.es85.js.map +1 -1
  167. package/dist/es/standards-sdk.es86.js +30 -168
  168. package/dist/es/standards-sdk.es86.js.map +1 -1
  169. package/dist/es/standards-sdk.es87.js +32 -26
  170. package/dist/es/standards-sdk.es87.js.map +1 -1
  171. package/dist/es/standards-sdk.es88.js +9 -26
  172. package/dist/es/standards-sdk.es88.js.map +1 -1
  173. package/dist/es/standards-sdk.es89.js +33 -37
  174. package/dist/es/standards-sdk.es89.js.map +1 -1
  175. package/dist/es/standards-sdk.es9.js +1 -1
  176. package/dist/es/standards-sdk.es90.js +191 -97
  177. package/dist/es/standards-sdk.es90.js.map +1 -1
  178. package/dist/es/standards-sdk.es91.js +438 -2
  179. package/dist/es/standards-sdk.es91.js.map +1 -1
  180. package/dist/es/standards-sdk.es92.js +24 -15
  181. package/dist/es/standards-sdk.es92.js.map +1 -1
  182. package/dist/es/standards-sdk.es93.js +131 -401
  183. package/dist/es/standards-sdk.es93.js.map +1 -1
  184. package/dist/es/standards-sdk.es94.js +11 -14
  185. package/dist/es/standards-sdk.es94.js.map +1 -1
  186. package/dist/es/standards-sdk.es95.js +29 -13
  187. package/dist/es/standards-sdk.es95.js.map +1 -1
  188. package/dist/es/standards-sdk.es96.js +29 -13
  189. package/dist/es/standards-sdk.es96.js.map +1 -1
  190. package/dist/es/standards-sdk.es97.js +20 -31
  191. package/dist/es/standards-sdk.es97.js.map +1 -1
  192. package/dist/es/standards-sdk.es98.js +43 -14
  193. package/dist/es/standards-sdk.es98.js.map +1 -1
  194. package/dist/es/standards-sdk.es99.js +17 -3
  195. package/dist/es/standards-sdk.es99.js.map +1 -1
  196. package/dist/es/utils/index.d.ts +1 -0
  197. package/dist/es/utils/index.d.ts.map +1 -1
  198. package/dist/es/utils/types.d.ts +3 -0
  199. package/dist/es/utils/types.d.ts.map +1 -1
  200. package/dist/umd/fees/fee-config-builder.d.ts +93 -45
  201. package/dist/umd/fees/fee-config-builder.d.ts.map +1 -1
  202. package/dist/umd/fees/types.d.ts +14 -12
  203. package/dist/umd/fees/types.d.ts.map +1 -1
  204. package/dist/umd/hcs-10/base-client.d.ts +8 -1
  205. package/dist/umd/hcs-10/base-client.d.ts.map +1 -1
  206. package/dist/umd/hcs-10/browser.d.ts.map +1 -1
  207. package/dist/umd/hcs-10/sdk.d.ts +9 -1
  208. package/dist/umd/hcs-10/sdk.d.ts.map +1 -1
  209. package/dist/umd/services/mirror-node.d.ts +74 -1
  210. package/dist/umd/services/mirror-node.d.ts.map +1 -1
  211. package/dist/umd/services/types.d.ts +29 -0
  212. package/dist/umd/services/types.d.ts.map +1 -1
  213. package/dist/umd/standards-sdk.umd.js +1 -1
  214. package/dist/umd/standards-sdk.umd.js.map +1 -1
  215. package/dist/umd/utils/index.d.ts +1 -0
  216. package/dist/umd/utils/index.d.ts.map +1 -1
  217. package/dist/umd/utils/types.d.ts +3 -0
  218. package/dist/umd/utils/types.d.ts.map +1 -1
  219. package/package.json +2 -1
@@ -1,94 +1,154 @@
1
+ import { CustomFeeType } from "./standards-sdk.es20.js";
2
+ import { HederaMirrorNode } from "./standards-sdk.es18.js";
1
3
  class FeeConfigBuilder {
2
- constructor() {
3
- this.feeAmount = 0;
4
- this.decimals = 0;
5
- this.feeCollectorAccountId = "";
6
- this.exemptAccountIds = [];
4
+ constructor(options) {
5
+ this.customFees = [];
6
+ this.logger = options.logger;
7
+ this.mirrorNode = new HederaMirrorNode(options.network, options.logger);
8
+ this.defaultCollectorAccountId = options.defaultCollectorAccountId || "";
7
9
  }
8
10
  /**
9
- * Static factory method to create a fee config with HBAR amount in one line
10
- * @param hbarAmount Amount in HBAR
11
- * @param collectorAccountId Account that will receive the fees
12
- * @param exemptAccounts Optional array of exempt account IDs
13
- * @returns A configured FeeConfigBuilder
11
+ * Static factory method to create a FeeConfigBuilder with a single HBAR fee.
12
+ * @param hbarAmount Amount in HBAR.
13
+ * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
14
+ * @param network Network type ('mainnet' or 'testnet').
15
+ * @param logger Logger instance.
16
+ * @param exemptAccounts Optional array of account IDs exempt from this fee.
17
+ * @returns A configured FeeConfigBuilder instance.
14
18
  */
15
- static forHbar(hbarAmount, collectorAccountId, exemptAccounts = []) {
16
- return new FeeConfigBuilder().setHbarAmount(hbarAmount).setFeeCollector(collectorAccountId).addExemptAccounts(exemptAccounts);
19
+ static forHbar(hbarAmount, collectorAccountId, network, logger, exemptAccounts = []) {
20
+ const builder = new FeeConfigBuilder({
21
+ network,
22
+ logger,
23
+ defaultCollectorAccountId: collectorAccountId
24
+ });
25
+ return builder.addHbarFee(hbarAmount, collectorAccountId, exemptAccounts);
17
26
  }
18
27
  /**
19
- * Sets the fee amount in HBAR (convenient method)
20
- * @param hbarAmount The amount in HBAR (e.g., 5 for 5 HBAR)
21
- * @returns This builder instance for method chaining
28
+ * Static factory method to create a FeeConfigBuilder with a single token fee.
29
+ * Automatically fetches token decimals if not provided.
30
+ * @param tokenAmount Amount of tokens.
31
+ * @param feeTokenId Token ID for the fee.
32
+ * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
33
+ * @param network Network type ('mainnet' or 'testnet').
34
+ * @param logger Logger instance.
35
+ * @param exemptAccounts Optional array of account IDs exempt from this fee.
36
+ * @param decimals Optional decimals for the token (fetched if omitted).
37
+ * @returns A Promise resolving to a configured FeeConfigBuilder instance.
22
38
  */
23
- setHbarAmount(hbarAmount) {
24
- if (hbarAmount <= 0) {
25
- throw new Error("HBAR amount must be greater than zero");
26
- }
27
- this.feeAmount = hbarAmount * 1e8;
28
- this.decimals = 0;
29
- return this;
30
- }
31
- /**
32
- * Sets the amount of the fee to be collected for topic submissions
33
- * @param amount The fee amount (in tinybars or token units)
34
- * @param decimals Decimal places for fixed point representation (default: 0)
35
- * @returns This builder instance for method chaining
36
- */
37
- setFeeAmount(amount, decimals = 0) {
38
- this.feeAmount = amount;
39
- this.decimals = decimals;
40
- return this;
41
- }
42
- /**
43
- * Sets the Hedera account ID that will collect the fees
44
- * @param accountId The fee collector's account ID (e.g., '0.0.12345')
45
- * @returns This builder instance for method chaining
46
- */
47
- setFeeCollector(accountId) {
48
- this.feeCollectorAccountId = accountId;
49
- return this;
39
+ static async forToken(tokenAmount, feeTokenId, collectorAccountId, network, logger, exemptAccounts = [], decimals) {
40
+ const builder = new FeeConfigBuilder({
41
+ network,
42
+ logger,
43
+ defaultCollectorAccountId: collectorAccountId
44
+ });
45
+ await builder.addTokenFee(
46
+ tokenAmount,
47
+ feeTokenId,
48
+ collectorAccountId,
49
+ decimals,
50
+ exemptAccounts
51
+ );
52
+ return builder;
50
53
  }
51
54
  /**
52
- * Adds an account ID to the list of accounts exempt from paying fees
53
- * @param accountId The account ID to exempt from fees
54
- * @returns This builder instance for method chaining
55
+ * Adds an HBAR fee configuration to the builder.
56
+ * Allows chaining multiple fee additions.
57
+ * @param hbarAmount The amount in HBAR (e.g., 0.5).
58
+ * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
59
+ * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.
60
+ * @returns This FeeConfigBuilder instance for chaining.
55
61
  */
56
- addExemptAccount(accountId) {
57
- if (!this.exemptAccountIds.includes(accountId)) {
58
- this.exemptAccountIds.push(accountId);
62
+ addHbarFee(hbarAmount, collectorAccountId, exemptAccountIds = []) {
63
+ if (hbarAmount <= 0) {
64
+ throw new Error("HBAR amount must be greater than zero");
59
65
  }
66
+ this.customFees.push({
67
+ feeAmount: {
68
+ amount: hbarAmount * 1e8,
69
+ decimals: 0
70
+ },
71
+ feeCollectorAccountId: collectorAccountId || "",
72
+ feeTokenId: void 0,
73
+ exemptAccounts: [...exemptAccountIds],
74
+ type: CustomFeeType.FIXED_FEE
75
+ });
60
76
  return this;
61
77
  }
62
78
  /**
63
- * Adds multiple account IDs to the list of accounts exempt from paying fees
64
- * @param accountIds Array of account IDs to exempt from fees
65
- * @returns This builder instance for method chaining
79
+ * Adds a token fee configuration to the builder.
80
+ * Allows chaining multiple fee additions.
81
+ * Fetches token decimals automatically if not provided.
82
+ * @param tokenAmount The amount of the specified token.
83
+ * @param feeTokenId The ID of the token to charge the fee in.
84
+ * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
85
+ * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.
86
+ * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.
87
+ * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.
66
88
  */
67
- addExemptAccounts(accountIds) {
68
- for (const accountId of accountIds) {
69
- this.addExemptAccount(accountId);
89
+ async addTokenFee(tokenAmount, feeTokenId, collectorAccountId, decimals, exemptAccountIds = []) {
90
+ if (tokenAmount <= 0) {
91
+ throw new Error("Token amount must be greater than zero");
92
+ }
93
+ if (!feeTokenId) {
94
+ throw new Error("Fee token ID is required when adding a token fee");
70
95
  }
96
+ let finalDecimals = decimals;
97
+ if (finalDecimals === void 0) {
98
+ try {
99
+ const tokenInfo = await this.mirrorNode.getTokenInfo(feeTokenId);
100
+ if (tokenInfo?.decimals) {
101
+ finalDecimals = parseInt(tokenInfo.decimals, 10);
102
+ this.logger.info(
103
+ `Fetched decimals for ${feeTokenId}: ${finalDecimals}`
104
+ );
105
+ } else {
106
+ this.logger.warn(
107
+ `Could not fetch decimals for ${feeTokenId}, defaulting to 0.`
108
+ );
109
+ finalDecimals = 0;
110
+ }
111
+ } catch (error) {
112
+ this.logger.error(
113
+ `Error fetching decimals for ${feeTokenId}, defaulting to 0: ${error}`
114
+ );
115
+ finalDecimals = 0;
116
+ }
117
+ }
118
+ this.customFees.push({
119
+ feeAmount: {
120
+ amount: tokenAmount * 10 ** finalDecimals,
121
+ decimals: finalDecimals
122
+ },
123
+ feeCollectorAccountId: collectorAccountId || "",
124
+ feeTokenId,
125
+ exemptAccounts: [...exemptAccountIds],
126
+ type: CustomFeeType.FIXED_FEE
127
+ });
71
128
  return this;
72
129
  }
73
130
  /**
74
- * Builds and returns the final fee configuration object
75
- * @throws Error if fee collector account ID is not set or if fee amount is not positive
76
- * @returns A complete TopicFeeConfig object
131
+ * Builds the final TopicFeeConfig object.
132
+ * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.
133
+ * @throws Error if no fees have been added.
134
+ * @throws Error if more than 10 fees have been added.
77
135
  */
78
136
  build() {
79
- if (!this.feeCollectorAccountId) {
80
- throw new Error("Fee collector account ID is required");
137
+ if (this.customFees.length === 0) {
138
+ throw new Error(
139
+ "At least one fee must be added using addHbarFee/addTokenFee or created using forHbar/forToken"
140
+ );
81
141
  }
82
- if (this.feeAmount <= 0) {
83
- throw new Error("Fee amount must be greater than zero");
142
+ if (this.customFees.length > 10) {
143
+ throw new Error("Maximum of 10 custom fees per topic allowed");
84
144
  }
145
+ const allExemptAccounts = /* @__PURE__ */ new Set();
146
+ this.customFees.forEach((fee) => {
147
+ fee.exemptAccounts.forEach((account) => allExemptAccounts.add(account));
148
+ });
85
149
  return {
86
- feeAmount: {
87
- amount: this.feeAmount,
88
- decimals: this.decimals
89
- },
90
- feeCollectorAccountId: this.feeCollectorAccountId,
91
- exemptAccounts: this.exemptAccountIds
150
+ customFees: this.customFees,
151
+ exemptAccounts: Array.from(allExemptAccounts)
92
152
  };
93
153
  }
94
154
  }
@@ -1 +1 @@
1
- {"version":3,"file":"standards-sdk.es19.js","sources":["../../src/fees/fee-config-builder.ts"],"sourcesContent":["import { FeeConfigBuilderInterface, TopicFeeConfig } from './types';\n\n/**\n * FeeConfigBuilder provides a fluent interface for creating fee configurations\n * for HCS-10 topics. This makes it easy to configure fees without dealing with\n * the complexity of the underlying fee structure.\n *\n * Example usage:\n * ```typescript\n * const feeConfig = new FeeConfigBuilder()\n * .setHbarAmount(1) // 1 HBAR\n * .setFeeCollector('0.0.12345')\n * .addExemptAccount('0.0.67890')\n * .build();\n * ```\n */\nexport class FeeConfigBuilder implements FeeConfigBuilderInterface {\n private feeAmount: number = 0;\n private decimals: number = 0;\n private feeCollectorAccountId: string = '';\n private exemptAccountIds: string[] = [];\n\n /**\n * Static factory method to create a fee config with HBAR amount in one line\n * @param hbarAmount Amount in HBAR\n * @param collectorAccountId Account that will receive the fees\n * @param exemptAccounts Optional array of exempt account IDs\n * @returns A configured FeeConfigBuilder\n */\n static forHbar(\n hbarAmount: number,\n collectorAccountId: string,\n exemptAccounts: string[] = []\n ): FeeConfigBuilder {\n return new FeeConfigBuilder()\n .setHbarAmount(hbarAmount)\n .setFeeCollector(collectorAccountId)\n .addExemptAccounts(exemptAccounts);\n }\n\n /**\n * Sets the fee amount in HBAR (convenient method)\n * @param hbarAmount The amount in HBAR (e.g., 5 for 5 HBAR)\n * @returns This builder instance for method chaining\n */\n setHbarAmount(hbarAmount: number): FeeConfigBuilder {\n if (hbarAmount <= 0) {\n throw new Error('HBAR amount must be greater than zero');\n }\n\n // Convert HBAR to tinybars (1 HBAR = 100,000,000 tinybars)\n this.feeAmount = hbarAmount * 100_000_000;\n this.decimals = 0;\n return this;\n }\n\n /**\n * Sets the amount of the fee to be collected for topic submissions\n * @param amount The fee amount (in tinybars or token units)\n * @param decimals Decimal places for fixed point representation (default: 0)\n * @returns This builder instance for method chaining\n */\n setFeeAmount(amount: number, decimals: number = 0): FeeConfigBuilder {\n this.feeAmount = amount;\n this.decimals = decimals;\n return this;\n }\n\n /**\n * Sets the Hedera account ID that will collect the fees\n * @param accountId The fee collector's account ID (e.g., '0.0.12345')\n * @returns This builder instance for method chaining\n */\n setFeeCollector(accountId: string): FeeConfigBuilder {\n this.feeCollectorAccountId = accountId;\n return this;\n }\n\n /**\n * Adds an account ID to the list of accounts exempt from paying fees\n * @param accountId The account ID to exempt from fees\n * @returns This builder instance for method chaining\n */\n addExemptAccount(accountId: string): FeeConfigBuilder {\n if (!this.exemptAccountIds.includes(accountId)) {\n this.exemptAccountIds.push(accountId);\n }\n return this;\n }\n\n /**\n * Adds multiple account IDs to the list of accounts exempt from paying fees\n * @param accountIds Array of account IDs to exempt from fees\n * @returns This builder instance for method chaining\n */\n addExemptAccounts(accountIds: string[]): FeeConfigBuilder {\n for (const accountId of accountIds) {\n this.addExemptAccount(accountId);\n }\n return this;\n }\n\n /**\n * Builds and returns the final fee configuration object\n * @throws Error if fee collector account ID is not set or if fee amount is not positive\n * @returns A complete TopicFeeConfig object\n */\n build(): TopicFeeConfig {\n if (!this.feeCollectorAccountId) {\n throw new Error('Fee collector account ID is required');\n }\n\n if (this.feeAmount <= 0) {\n throw new Error('Fee amount must be greater than zero');\n }\n\n return {\n feeAmount: {\n amount: this.feeAmount,\n decimals: this.decimals,\n },\n feeCollectorAccountId: this.feeCollectorAccountId,\n exemptAccounts: this.exemptAccountIds,\n };\n }\n}\n\n/* Example usage:\n\n// Super simple one-liner with the factory method\nconst simpleFeeConfig = FeeConfigBuilder.forHbar(5, '0.0.12345');\n\n// With Agent Builder\nconst agent = new AgentBuilder()\n .setName('Fee Collector Agent')\n .setDescription('An agent that collects fees')\n .setInboundTopicType(InboundTopicType.FEE_BASED)\n .setFeeConfig(FeeConfigBuilder.forHbar(1, '0.0.12345', ['0.0.67890']))\n .setNetwork('testnet')\n .build();\n\n// Directly with client\nconst client = new HCS10Client(config);\nconst connectionFeeConfig = new FeeConfigBuilder()\n .setHbarAmount(0.5) // 0.5 HBAR (simple!)\n .setFeeCollector(client.getAccountAndSigner().accountId)\n .addExemptAccount(requestingAccountId);\n\nconst result = await client.handleConnectionRequest(\n inboundTopicId,\n requestingAccountId,\n connectionRequestId,\n connectionFeeConfig\n);\n\n*/\n"],"names":[],"mappings":"AAgBO,MAAM,iBAAsD;AAAA,EAA5D,cAAA;AACL,SAAQ,YAAoB;AAC5B,SAAQ,WAAmB;AAC3B,SAAQ,wBAAgC;AACxC,SAAQ,mBAA6B,CAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAStC,OAAO,QACL,YACA,oBACA,iBAA2B,CAAA,GACT;AACX,WAAA,IAAI,mBACR,cAAc,UAAU,EACxB,gBAAgB,kBAAkB,EAClC,kBAAkB,cAAc;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQrC,cAAc,YAAsC;AAClD,QAAI,cAAc,GAAG;AACb,YAAA,IAAI,MAAM,uCAAuC;AAAA,IAAA;AAIzD,SAAK,YAAY,aAAa;AAC9B,SAAK,WAAW;AACT,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,aAAa,QAAgB,WAAmB,GAAqB;AACnE,SAAK,YAAY;AACjB,SAAK,WAAW;AACT,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,gBAAgB,WAAqC;AACnD,SAAK,wBAAwB;AACtB,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,iBAAiB,WAAqC;AACpD,QAAI,CAAC,KAAK,iBAAiB,SAAS,SAAS,GAAG;AACzC,WAAA,iBAAiB,KAAK,SAAS;AAAA,IAAA;AAE/B,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,kBAAkB,YAAwC;AACxD,eAAW,aAAa,YAAY;AAClC,WAAK,iBAAiB,SAAS;AAAA,IAAA;AAE1B,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,QAAwB;AAClB,QAAA,CAAC,KAAK,uBAAuB;AACzB,YAAA,IAAI,MAAM,sCAAsC;AAAA,IAAA;AAGpD,QAAA,KAAK,aAAa,GAAG;AACjB,YAAA,IAAI,MAAM,sCAAsC;AAAA,IAAA;AAGjD,WAAA;AAAA,MACL,WAAW;AAAA,QACT,QAAQ,KAAK;AAAA,QACb,UAAU,KAAK;AAAA,MACjB;AAAA,MACA,uBAAuB,KAAK;AAAA,MAC5B,gBAAgB,KAAK;AAAA,IACvB;AAAA,EAAA;AAEJ;"}
1
+ {"version":3,"file":"standards-sdk.es19.js","sources":["../../src/fees/fee-config-builder.ts"],"sourcesContent":["import {\n FeeConfigBuilderInterface,\n TokenFeeConfig,\n TopicFeeConfig,\n CustomFeeType,\n} from './types';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * FeeConfigBuilder provides a fluent interface for creating fee configurations\n * for HCS-10 topics. This makes it easy to configure fees without dealing with\n * the complexity of the underlying fee structure.\n *\n * Example usage:\n *\n * // Super simple one-liner with the factory method\n * const simpleFeeConfig = FeeConfigBuilder.forHbar(5, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']);\n *\n * // With multiple fees:\n * const multipleFeeConfig = new FeeConfigBuilder({\n * network: NetworkType.TESTNET,\n * logger: new Logger(),\n * defaultCollectorAccountId: '0.0.12345',\n * defaultExemptAccountIds: ['0.0.67890']\n * })\n * .withHbarFee(1) // 1 HBAR fee\n * .withTokenFee(10, '0.0.54321') // 10 units of token 0.0.54321\n * .build();\n *\n * With Agent Builder\n * const agent = new AgentBuilder()\n * .setName('Fee Collector Agent')\n * .setDescription('An agent that collects fees')\n * .setInboundTopicType(InboundTopicType.FEE_BASED)\n * .setFeeConfig(FeeConfigBuilder.forHbar(1, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']))\n * .setNetwork('testnet')\n .build();\n\n * Directly with client\n * const client = new HCS10Client(config);\n * const connectionFeeConfig = new FeeConfigBuilder({\n * network: NetworkType.TESTNET,\n * logger: new Logger(),\n * defaultCollectorAccountId: client.getAccountAndSigner().accountId,\n * defaultExemptAccountIds: ['0.0.67890']\n * })\n * .withHbarFee(0.5) // 0.5 HBAR (simple!)\n * .build();\n\n * const result = await client.handleConnectionRequest(\n * inboundTopicId,\n * requestingAccountId,\n * connectionRequestId,\n * connectionFeeConfig\n * );\n*/\nexport interface FeeConfigBuilderOptions {\n network: NetworkType;\n logger: Logger;\n defaultCollectorAccountId?: string;\n}\n\nexport class FeeConfigBuilder implements FeeConfigBuilderInterface {\n private customFees: TokenFeeConfig[] = [];\n private mirrorNode: HederaMirrorNode;\n private logger: Logger;\n private defaultCollectorAccountId: string;\n\n constructor(options: FeeConfigBuilderOptions) {\n this.logger = options.logger;\n this.mirrorNode = new HederaMirrorNode(options.network, options.logger);\n this.defaultCollectorAccountId = options.defaultCollectorAccountId || '';\n }\n\n /**\n * Static factory method to create a FeeConfigBuilder with a single HBAR fee.\n * @param hbarAmount Amount in HBAR.\n * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n * @param network Network type ('mainnet' or 'testnet').\n * @param logger Logger instance.\n * @param exemptAccounts Optional array of account IDs exempt from this fee.\n * @returns A configured FeeConfigBuilder instance.\n */\n static forHbar(\n hbarAmount: number,\n collectorAccountId: string | undefined,\n network: NetworkType,\n logger: Logger,\n exemptAccounts: string[] = []\n ): FeeConfigBuilder {\n const builder = new FeeConfigBuilder({\n network,\n logger,\n defaultCollectorAccountId: collectorAccountId,\n });\n return builder.addHbarFee(hbarAmount, collectorAccountId, exemptAccounts);\n }\n\n /**\n * Static factory method to create a FeeConfigBuilder with a single token fee.\n * Automatically fetches token decimals if not provided.\n * @param tokenAmount Amount of tokens.\n * @param feeTokenId Token ID for the fee.\n * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n * @param network Network type ('mainnet' or 'testnet').\n * @param logger Logger instance.\n * @param exemptAccounts Optional array of account IDs exempt from this fee.\n * @param decimals Optional decimals for the token (fetched if omitted).\n * @returns A Promise resolving to a configured FeeConfigBuilder instance.\n */\n static async forToken(\n tokenAmount: number,\n feeTokenId: string,\n collectorAccountId: string | undefined,\n network: NetworkType,\n logger: Logger,\n exemptAccounts: string[] = [],\n decimals?: number\n ): Promise<FeeConfigBuilder> {\n const builder = new FeeConfigBuilder({\n network,\n logger,\n defaultCollectorAccountId: collectorAccountId,\n });\n await builder.addTokenFee(\n tokenAmount,\n feeTokenId,\n collectorAccountId,\n decimals,\n exemptAccounts\n );\n return builder;\n }\n\n /**\n * Adds an HBAR fee configuration to the builder.\n * Allows chaining multiple fee additions.\n * @param hbarAmount The amount in HBAR (e.g., 0.5).\n * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.\n * @returns This FeeConfigBuilder instance for chaining.\n */\n addHbarFee(\n hbarAmount: number,\n collectorAccountId?: string,\n exemptAccountIds: string[] = []\n ): FeeConfigBuilder {\n if (hbarAmount <= 0) {\n throw new Error('HBAR amount must be greater than zero');\n }\n\n this.customFees.push({\n feeAmount: {\n amount: hbarAmount * 100_000_000,\n decimals: 0,\n },\n feeCollectorAccountId: collectorAccountId || '',\n feeTokenId: undefined,\n exemptAccounts: [...exemptAccountIds],\n type: CustomFeeType.FIXED_FEE,\n });\n\n return this;\n }\n\n /**\n * Adds a token fee configuration to the builder.\n * Allows chaining multiple fee additions.\n * Fetches token decimals automatically if not provided.\n * @param tokenAmount The amount of the specified token.\n * @param feeTokenId The ID of the token to charge the fee in.\n * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.\n * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.\n * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.\n */\n async addTokenFee(\n tokenAmount: number,\n feeTokenId: string,\n collectorAccountId?: string,\n decimals?: number,\n exemptAccountIds: string[] = []\n ): Promise<FeeConfigBuilder> {\n if (tokenAmount <= 0) {\n throw new Error('Token amount must be greater than zero');\n }\n if (!feeTokenId) {\n throw new Error('Fee token ID is required when adding a token fee');\n }\n\n let finalDecimals = decimals;\n if (finalDecimals === undefined) {\n try {\n const tokenInfo = await this.mirrorNode.getTokenInfo(feeTokenId);\n if (tokenInfo?.decimals) {\n finalDecimals = parseInt(tokenInfo.decimals, 10);\n this.logger.info(\n `Fetched decimals for ${feeTokenId}: ${finalDecimals}`\n );\n } else {\n this.logger.warn(\n `Could not fetch decimals for ${feeTokenId}, defaulting to 0.`\n );\n finalDecimals = 0;\n }\n } catch (error) {\n this.logger.error(\n `Error fetching decimals for ${feeTokenId}, defaulting to 0: ${error}`\n );\n finalDecimals = 0;\n }\n }\n\n this.customFees.push({\n feeAmount: {\n amount: tokenAmount * 10 ** finalDecimals,\n decimals: finalDecimals,\n },\n feeCollectorAccountId: collectorAccountId || '',\n feeTokenId: feeTokenId,\n exemptAccounts: [...exemptAccountIds],\n type: CustomFeeType.FIXED_FEE,\n });\n\n return this;\n }\n\n /**\n * Builds the final TopicFeeConfig object.\n * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.\n * @throws Error if no fees have been added.\n * @throws Error if more than 10 fees have been added.\n */\n build(): TopicFeeConfig {\n if (this.customFees.length === 0) {\n throw new Error(\n 'At least one fee must be added using addHbarFee/addTokenFee or created using forHbar/forToken'\n );\n }\n\n if (this.customFees.length > 10) {\n throw new Error('Maximum of 10 custom fees per topic allowed');\n }\n\n const allExemptAccounts = new Set<string>();\n this.customFees.forEach((fee) => {\n fee.exemptAccounts.forEach((account) => allExemptAccounts.add(account));\n });\n\n return {\n customFees: this.customFees,\n exemptAccounts: Array.from(allExemptAccounts),\n };\n }\n}\n"],"names":[],"mappings":"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"}