@hashgraphonline/standards-sdk 0.1.137 → 0.1.138-feat-hcs-21-package-std.canary.9db1bab.34

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 (223) hide show
  1. package/dist/cjs/hcs-21/base-client.d.ts +33 -0
  2. package/dist/cjs/hcs-21/base-client.d.ts.map +1 -0
  3. package/dist/cjs/hcs-21/browser.d.ts +20 -0
  4. package/dist/cjs/hcs-21/browser.d.ts.map +1 -0
  5. package/dist/cjs/hcs-21/errors.d.ts +6 -0
  6. package/dist/cjs/hcs-21/errors.d.ts.map +1 -0
  7. package/dist/cjs/hcs-21/index.d.ts +7 -0
  8. package/dist/cjs/hcs-21/index.d.ts.map +1 -0
  9. package/dist/cjs/hcs-21/sdk.d.ts +48 -0
  10. package/dist/cjs/hcs-21/sdk.d.ts.map +1 -0
  11. package/dist/cjs/hcs-21/tx.d.ts +20 -0
  12. package/dist/cjs/hcs-21/tx.d.ts.map +1 -0
  13. package/dist/cjs/hcs-21/types.d.ts +89 -0
  14. package/dist/cjs/hcs-21/types.d.ts.map +1 -0
  15. package/dist/cjs/index.d.ts +1 -0
  16. package/dist/cjs/index.d.ts.map +1 -1
  17. package/dist/cjs/services/registry-broker/client.d.ts.map +1 -1
  18. package/dist/cjs/services/types.d.ts +1 -1
  19. package/dist/cjs/services/types.d.ts.map +1 -1
  20. package/dist/cjs/standards-sdk.cjs +2 -2
  21. package/dist/cjs/standards-sdk.cjs.map +1 -1
  22. package/dist/es/hcs-21/base-client.d.ts +33 -0
  23. package/dist/es/hcs-21/base-client.d.ts.map +1 -0
  24. package/dist/es/hcs-21/browser.d.ts +20 -0
  25. package/dist/es/hcs-21/browser.d.ts.map +1 -0
  26. package/dist/es/hcs-21/errors.d.ts +6 -0
  27. package/dist/es/hcs-21/errors.d.ts.map +1 -0
  28. package/dist/es/hcs-21/index.d.ts +7 -0
  29. package/dist/es/hcs-21/index.d.ts.map +1 -0
  30. package/dist/es/hcs-21/sdk.d.ts +48 -0
  31. package/dist/es/hcs-21/sdk.d.ts.map +1 -0
  32. package/dist/es/hcs-21/tx.d.ts +20 -0
  33. package/dist/es/hcs-21/tx.d.ts.map +1 -0
  34. package/dist/es/hcs-21/types.d.ts +89 -0
  35. package/dist/es/hcs-21/types.d.ts.map +1 -0
  36. package/dist/es/index.d.ts +1 -0
  37. package/dist/es/index.d.ts.map +1 -1
  38. package/dist/es/services/registry-broker/client.d.ts.map +1 -1
  39. package/dist/es/services/types.d.ts +1 -1
  40. package/dist/es/services/types.d.ts.map +1 -1
  41. package/dist/es/standards-sdk.es.js +67 -48
  42. package/dist/es/standards-sdk.es.js.map +1 -1
  43. package/dist/es/standards-sdk.es10.js +2 -2
  44. package/dist/es/standards-sdk.es100.js +231 -28
  45. package/dist/es/standards-sdk.es100.js.map +1 -1
  46. package/dist/es/standards-sdk.es101.js +109 -18
  47. package/dist/es/standards-sdk.es101.js.map +1 -1
  48. package/dist/es/standards-sdk.es102.js +32 -158
  49. package/dist/es/standards-sdk.es102.js.map +1 -1
  50. package/dist/es/standards-sdk.es103.js +80 -204
  51. package/dist/es/standards-sdk.es103.js.map +1 -1
  52. package/dist/es/standards-sdk.es104.js +21 -780
  53. package/dist/es/standards-sdk.es104.js.map +1 -1
  54. package/dist/es/standards-sdk.es105.js +140 -11
  55. package/dist/es/standards-sdk.es105.js.map +1 -1
  56. package/dist/es/standards-sdk.es106.js +29 -567
  57. package/dist/es/standards-sdk.es106.js.map +1 -1
  58. package/dist/es/standards-sdk.es107.js +17 -597
  59. package/dist/es/standards-sdk.es107.js.map +1 -1
  60. package/dist/es/standards-sdk.es108.js +159 -12
  61. package/dist/es/standards-sdk.es108.js.map +1 -1
  62. package/dist/es/standards-sdk.es109.js +208 -2
  63. package/dist/es/standards-sdk.es109.js.map +1 -1
  64. package/dist/es/standards-sdk.es110.js +774 -67
  65. package/dist/es/standards-sdk.es110.js.map +1 -1
  66. package/dist/es/standards-sdk.es111.js +11 -37
  67. package/dist/es/standards-sdk.es111.js.map +1 -1
  68. package/dist/es/standards-sdk.es112.js +567 -2
  69. package/dist/es/standards-sdk.es112.js.map +1 -1
  70. package/dist/es/standards-sdk.es113.js +576 -197
  71. package/dist/es/standards-sdk.es113.js.map +1 -1
  72. package/dist/es/standards-sdk.es114.js +12 -1139
  73. package/dist/es/standards-sdk.es114.js.map +1 -1
  74. package/dist/es/standards-sdk.es115.js +2 -306
  75. package/dist/es/standards-sdk.es115.js.map +1 -1
  76. package/dist/es/standards-sdk.es116.js +79 -418
  77. package/dist/es/standards-sdk.es116.js.map +1 -1
  78. package/dist/es/standards-sdk.es117.js +35 -351
  79. package/dist/es/standards-sdk.es117.js.map +1 -1
  80. package/dist/es/standards-sdk.es118.js +2 -761
  81. package/dist/es/standards-sdk.es118.js.map +1 -1
  82. package/dist/es/standards-sdk.es119.js +204 -185
  83. package/dist/es/standards-sdk.es119.js.map +1 -1
  84. package/dist/es/standards-sdk.es12.js +1 -1
  85. package/dist/es/standards-sdk.es120.js +1055 -1482
  86. package/dist/es/standards-sdk.es120.js.map +1 -1
  87. package/dist/es/standards-sdk.es121.js +265 -2024
  88. package/dist/es/standards-sdk.es121.js.map +1 -1
  89. package/dist/es/standards-sdk.es122.js +420 -50
  90. package/dist/es/standards-sdk.es122.js.map +1 -1
  91. package/dist/es/standards-sdk.es123.js +350 -82
  92. package/dist/es/standards-sdk.es123.js.map +1 -1
  93. package/dist/es/standards-sdk.es124.js +741 -139
  94. package/dist/es/standards-sdk.es124.js.map +1 -1
  95. package/dist/es/standards-sdk.es125.js +204 -7
  96. package/dist/es/standards-sdk.es125.js.map +1 -1
  97. package/dist/es/standards-sdk.es126.js +1533 -52
  98. package/dist/es/standards-sdk.es126.js.map +1 -1
  99. package/dist/es/standards-sdk.es127.js +2077 -59
  100. package/dist/es/standards-sdk.es127.js.map +1 -1
  101. package/dist/es/standards-sdk.es128.js +52 -28
  102. package/dist/es/standards-sdk.es128.js.map +1 -1
  103. package/dist/es/standards-sdk.es129.js +80 -131
  104. package/dist/es/standards-sdk.es129.js.map +1 -1
  105. package/dist/es/standards-sdk.es13.js +1 -1
  106. package/dist/es/standards-sdk.es130.js +152 -35
  107. package/dist/es/standards-sdk.es130.js.map +1 -1
  108. package/dist/es/standards-sdk.es131.js +7 -17
  109. package/dist/es/standards-sdk.es131.js.map +1 -1
  110. package/dist/es/standards-sdk.es132.js +53 -12241
  111. package/dist/es/standards-sdk.es132.js.map +1 -1
  112. package/dist/es/standards-sdk.es133.js +65 -694
  113. package/dist/es/standards-sdk.es133.js.map +1 -1
  114. package/dist/es/standards-sdk.es134.js +28 -172
  115. package/dist/es/standards-sdk.es134.js.map +1 -1
  116. package/dist/es/standards-sdk.es135.js +115 -299
  117. package/dist/es/standards-sdk.es135.js.map +1 -1
  118. package/dist/es/standards-sdk.es136.js +36 -340
  119. package/dist/es/standards-sdk.es136.js.map +1 -1
  120. package/dist/es/standards-sdk.es137.js +12216 -395
  121. package/dist/es/standards-sdk.es137.js.map +1 -1
  122. package/dist/es/standards-sdk.es138.js +694 -331
  123. package/dist/es/standards-sdk.es138.js.map +1 -1
  124. package/dist/es/standards-sdk.es139.js +15 -74
  125. package/dist/es/standards-sdk.es139.js.map +1 -1
  126. package/dist/es/standards-sdk.es14.js +1 -1
  127. package/dist/es/standards-sdk.es141.js +1 -1
  128. package/dist/es/standards-sdk.es142.js +175 -0
  129. package/dist/es/standards-sdk.es142.js.map +1 -0
  130. package/dist/es/standards-sdk.es143.js +325 -0
  131. package/dist/es/standards-sdk.es143.js.map +1 -0
  132. package/dist/es/standards-sdk.es144.js +349 -0
  133. package/dist/es/standards-sdk.es144.js.map +1 -0
  134. package/dist/es/standards-sdk.es145.js +456 -0
  135. package/dist/es/standards-sdk.es145.js.map +1 -0
  136. package/dist/es/standards-sdk.es146.js +334 -0
  137. package/dist/es/standards-sdk.es146.js.map +1 -0
  138. package/dist/es/standards-sdk.es147.js +79 -0
  139. package/dist/es/standards-sdk.es147.js.map +1 -0
  140. package/dist/es/standards-sdk.es15.js +1 -1
  141. package/dist/es/standards-sdk.es16.js +1 -1
  142. package/dist/es/standards-sdk.es17.js +5 -5
  143. package/dist/es/standards-sdk.es19.js +12 -12
  144. package/dist/es/standards-sdk.es20.js +9 -9
  145. package/dist/es/standards-sdk.es21.js +1 -1
  146. package/dist/es/standards-sdk.es22.js +1 -1
  147. package/dist/es/standards-sdk.es23.js +1 -1
  148. package/dist/es/standards-sdk.es24.js +1 -1
  149. package/dist/es/standards-sdk.es25.js +1 -1
  150. package/dist/es/standards-sdk.es26.js +1 -1
  151. package/dist/es/standards-sdk.es27.js +1 -1
  152. package/dist/es/standards-sdk.es28.js +12 -12
  153. package/dist/es/standards-sdk.es3.js +2 -2
  154. package/dist/es/standards-sdk.es31.js +2 -2
  155. package/dist/es/standards-sdk.es32.js +4 -4
  156. package/dist/es/standards-sdk.es33.js +1 -1
  157. package/dist/es/standards-sdk.es36.js +6 -6
  158. package/dist/es/standards-sdk.es37.js +4 -4
  159. package/dist/es/standards-sdk.es38.js +2 -2
  160. package/dist/es/standards-sdk.es39.js +2 -2
  161. package/dist/es/standards-sdk.es40.js +1 -1
  162. package/dist/es/standards-sdk.es41.js +1 -1
  163. package/dist/es/standards-sdk.es42.js +2 -2
  164. package/dist/es/standards-sdk.es47.js +1 -1
  165. package/dist/es/standards-sdk.es5.js +2 -2
  166. package/dist/es/standards-sdk.es52.js +1 -1
  167. package/dist/es/standards-sdk.es54.js +1 -1
  168. package/dist/es/standards-sdk.es57.js +1 -1
  169. package/dist/es/standards-sdk.es6.js +2 -2
  170. package/dist/es/standards-sdk.es61.js +7 -7
  171. package/dist/es/standards-sdk.es65.js +2 -2
  172. package/dist/es/standards-sdk.es66.js +3 -3
  173. package/dist/es/standards-sdk.es69.js +2 -2
  174. package/dist/es/standards-sdk.es7.js +2 -2
  175. package/dist/es/standards-sdk.es70.js +3 -3
  176. package/dist/es/standards-sdk.es71.js +2 -2
  177. package/dist/es/standards-sdk.es72.js +1 -1
  178. package/dist/es/standards-sdk.es75.js +2 -2
  179. package/dist/es/standards-sdk.es77.js +2 -2
  180. package/dist/es/standards-sdk.es78.js +4 -4
  181. package/dist/es/standards-sdk.es79.js +1 -1
  182. package/dist/es/standards-sdk.es8.js +1 -1
  183. package/dist/es/standards-sdk.es80.js +41 -27
  184. package/dist/es/standards-sdk.es80.js.map +1 -1
  185. package/dist/es/standards-sdk.es81.js +6 -78
  186. package/dist/es/standards-sdk.es81.js.map +1 -1
  187. package/dist/es/standards-sdk.es82.js +27 -64
  188. package/dist/es/standards-sdk.es82.js.map +1 -1
  189. package/dist/es/standards-sdk.es83.js +69 -23
  190. package/dist/es/standards-sdk.es83.js.map +1 -1
  191. package/dist/es/standards-sdk.es84.js +165 -23
  192. package/dist/es/standards-sdk.es84.js.map +1 -1
  193. package/dist/es/standards-sdk.es85.js +31 -166
  194. package/dist/es/standards-sdk.es85.js.map +1 -1
  195. package/dist/es/standards-sdk.es86.js +24 -127
  196. package/dist/es/standards-sdk.es86.js.map +1 -1
  197. package/dist/es/standards-sdk.es87.js +65 -142
  198. package/dist/es/standards-sdk.es87.js.map +1 -1
  199. package/dist/es/standards-sdk.es88.js +52 -127
  200. package/dist/es/standards-sdk.es88.js.map +1 -1
  201. package/dist/es/standards-sdk.es89.js +26 -41
  202. package/dist/es/standards-sdk.es89.js.map +1 -1
  203. package/dist/es/standards-sdk.es90.js +23 -261
  204. package/dist/es/standards-sdk.es90.js.map +1 -1
  205. package/dist/es/standards-sdk.es91.js +162 -93
  206. package/dist/es/standards-sdk.es91.js.map +1 -1
  207. package/dist/es/standards-sdk.es92.js +112 -83
  208. package/dist/es/standards-sdk.es92.js.map +1 -1
  209. package/dist/es/standards-sdk.es93.js +156 -28
  210. package/dist/es/standards-sdk.es93.js.map +1 -1
  211. package/dist/es/standards-sdk.es94.js +133 -225
  212. package/dist/es/standards-sdk.es94.js.map +1 -1
  213. package/dist/es/standards-sdk.es95.js +40 -108
  214. package/dist/es/standards-sdk.es95.js.map +1 -1
  215. package/dist/es/standards-sdk.es96.js +253 -24
  216. package/dist/es/standards-sdk.es96.js.map +1 -1
  217. package/dist/es/standards-sdk.es97.js +96 -80
  218. package/dist/es/standards-sdk.es97.js.map +1 -1
  219. package/dist/es/standards-sdk.es98.js +91 -21
  220. package/dist/es/standards-sdk.es98.js.map +1 -1
  221. package/dist/es/standards-sdk.es99.js +28 -141
  222. package/dist/es/standards-sdk.es99.js.map +1 -1
  223. package/package.json +62 -59
@@ -1,793 +1,34 @@
1
- import { proto } from "@hashgraph/proto";
2
- import { Buffer } from "buffer";
3
- import { Hbar, Long, HbarUnit, Transaction } from "@hashgraph/sdk";
4
- import { ethers } from "ethers";
5
- import { TransactionParsingError } from "./standards-sdk.es105.js";
6
- import { resolveTransactionSummary } from "./standards-sdk.es106.js";
7
- import { HTSParser } from "./standards-sdk.es114.js";
8
- import { HCSParser } from "./standards-sdk.es134.js";
9
- import { FileParser } from "./standards-sdk.es135.js";
10
- import { CryptoParser } from "./standards-sdk.es136.js";
11
- import { SCSParser } from "./standards-sdk.es137.js";
12
- import { UtilParser } from "./standards-sdk.es138.js";
13
- import { ScheduleParser } from "./standards-sdk.es115.js";
14
- import { transactionParserRegistry } from "./standards-sdk.es116.js";
15
- import { getTransactionTypeFromBody, getHumanReadableTransactionType } from "./standards-sdk.es117.js";
16
- class TransactionParser {
17
- /**
18
- * Parse transaction bytes in any supported format (base64 or hex, regular or scheduled)
19
- * This is the main entry point for transaction parsing with enhanced retry logic
20
- *
21
- * @param transactionBytes - Transaction bytes in base64 or hex format
22
- * @param options - Parsing options and configuration
23
- * @returns Promise resolving to ParsedTransaction
24
- */
25
- static async parseTransactionBytes(transactionBytes, options = {}) {
26
- const {
27
- enableFallback = true,
28
- strictMode = false,
29
- includeRaw = true,
30
- maxRetries = 2
31
- } = options;
32
- const validation = this.validateTransactionBytes(transactionBytes);
33
- if (!validation.isValid && strictMode) {
34
- throw new TransactionParsingError(
35
- `Invalid transaction bytes format: ${validation.error}`,
36
- "INVALID_FORMAT",
37
- void 0,
38
- transactionBytes
39
- );
40
- }
41
- let lastError;
42
- let retryCount = 0;
43
- while (retryCount <= maxRetries) {
44
- try {
45
- const result = await this.parseTransaction(transactionBytes, options);
46
- result.formatDetection = {
47
- originalFormat: validation.format || "base64",
48
- wasConverted: validation.format === "hex",
49
- length: transactionBytes.length
50
- };
51
- return result;
52
- } catch (error) {
53
- lastError = error instanceof Error ? error : new Error(String(error));
54
- retryCount++;
55
- if (!enableFallback || retryCount > maxRetries) {
56
- if (strictMode) {
57
- throw new TransactionParsingError(
58
- "Failed to parse transaction after all attempts",
59
- "PARSING_FAILED",
60
- lastError,
61
- transactionBytes
62
- );
63
- }
64
- break;
65
- }
66
- try {
67
- const result = this.parseScheduledTransaction(
68
- transactionBytes,
69
- options
70
- );
71
- result.formatDetection = {
72
- originalFormat: validation.format || "base64",
73
- wasConverted: false,
74
- length: transactionBytes.length
75
- };
76
- return result;
77
- } catch (scheduledError) {
78
- }
79
- }
80
- }
81
- const fallbackResult = this.createFallbackResult(
82
- transactionBytes,
83
- lastError,
84
- void 0
85
- );
86
- if (fallbackResult.details) {
87
- fallbackResult.details.parseAttempts = Math.max(retryCount, 1);
88
- }
89
- return fallbackResult;
90
- }
91
- /**
92
- * Parse a Transaction object directly using unified delegation approach
93
- * This method delegates to specialized parsers for clean separation of concerns
94
- *
95
- * @param transaction - The Transaction object to parse
96
- * @param originalBytes - The original transaction bytes (optional, for protobuf parsing)
97
- * @param options - Parsing options
98
- * @returns Parsed transaction data
99
- */
100
- static parseTransactionObject(transaction, originalBytesOrOptions, options = {}) {
101
- let originalBytes;
102
- let actualOptions;
103
- if (originalBytesOrOptions && !Buffer.isBuffer(originalBytesOrOptions) && !(originalBytesOrOptions instanceof Uint8Array)) {
104
- actualOptions = originalBytesOrOptions;
105
- originalBytes = void 0;
106
- } else {
107
- originalBytes = originalBytesOrOptions;
108
- actualOptions = options;
109
- }
110
- try {
111
- const metadata = this.extractTransactionMetadata(transaction);
112
- const htsResult = HTSParser.parseFromTransactionObject(transaction);
113
- const cryptoResult = CryptoParser.parseFromTransactionObject(transaction);
114
- const hcsResult = HCSParser.parseFromTransactionObject(transaction);
115
- const fileResult = FileParser.parseFromTransactionObject(transaction);
116
- const scsResult = SCSParser.parseFromTransactionObject(transaction);
117
- const scheduleResult = ScheduleParser.parseFromTransactionObject(transaction);
118
- const utilResult = UtilParser.parseFromTransactionObject(transaction);
119
- const results = [
120
- htsResult,
121
- cryptoResult,
122
- hcsResult,
123
- fileResult,
124
- scsResult,
125
- scheduleResult,
126
- utilResult
127
- ];
128
- const primaryResult = results.find((result2) => result2.type && result2.type !== "UNKNOWN") || {};
129
- let finalType = "UNKNOWN";
130
- let finalHumanReadableType = "Unknown Transaction";
131
- let parsedTokenCreation;
132
- let protoParsingResult = {};
133
- if (originalBytes || transaction.toBytes) {
134
- try {
135
- const bytesToParse = originalBytes || transaction.toBytes();
136
- const decoded = proto.TransactionList.decode(bytesToParse);
137
- if (decoded.transactionList && decoded.transactionList.length > 0) {
138
- const tx = decoded.transactionList[0];
139
- if (tx.bodyBytes && tx.bodyBytes.length > 0) {
140
- const txBody = proto.TransactionBody.decode(tx.bodyBytes);
141
- const typeResult = this.detectTransactionTypeFromBody(txBody);
142
- finalType = typeResult.type;
143
- finalHumanReadableType = typeResult.humanReadableType;
144
- protoParsingResult = this.parseTransactionBodyDetails(
145
- txBody,
146
- finalType
147
- );
148
- if (protoParsingResult.tokenCreation) {
149
- parsedTokenCreation = protoParsingResult.tokenCreation;
150
- }
151
- } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
152
- const signedTx = proto.SignedTransaction.decode(
153
- tx.signedTransactionBytes
154
- );
155
- if (signedTx.bodyBytes) {
156
- const txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
157
- const typeResult = this.detectTransactionTypeFromBody(txBody);
158
- finalType = typeResult.type;
159
- finalHumanReadableType = typeResult.humanReadableType;
160
- protoParsingResult = this.parseTransactionBodyDetails(
161
- txBody,
162
- finalType
163
- );
164
- if (protoParsingResult.tokenCreation) {
165
- parsedTokenCreation = protoParsingResult.tokenCreation;
166
- }
167
- }
168
- }
169
- }
170
- } catch (protoError) {
171
- }
172
- }
173
- if (finalType === "UNKNOWN" && primaryResult.type) {
174
- finalType = primaryResult.type;
175
- finalHumanReadableType = primaryResult.humanReadableType || finalHumanReadableType;
176
- }
177
- const result = {
178
- type: finalType,
179
- humanReadableType: finalHumanReadableType,
180
- transfers: [],
181
- tokenTransfers: [],
182
- ...metadata,
183
- ...primaryResult,
184
- raw: actualOptions.includeRaw ? transaction._transactionBody || {} : void 0
185
- };
186
- this.mergeProtoParsingResults(
187
- result,
188
- protoParsingResult,
189
- htsResult,
190
- transaction,
191
- originalBytes
192
- );
193
- result.transfers = cryptoResult.transfers || result.transfers || [];
194
- result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
195
- return result;
196
- } catch (error) {
197
- return {
198
- type: "UNKNOWN",
199
- humanReadableType: "Unknown Transaction",
200
- transfers: [],
201
- tokenTransfers: [],
202
- raw: actualOptions.includeRaw ? {} : void 0,
203
- details: {
204
- error: `Failed to parse Transaction object: ${error instanceof Error ? error.message : String(error)}`
205
- }
206
- };
207
- }
1
+ import { Logger } from "./standards-sdk.es105.js";
2
+ import { HederaMirrorNode } from "./standards-sdk.es126.js";
3
+ class HCS18BaseClient {
4
+ constructor(config) {
5
+ this.network = config.network;
6
+ this.logger = config.logger || Logger.getInstance({ module: "HCS-18" });
7
+ this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
208
8
  }
209
9
  /**
210
- * Parse a base64 encoded transaction body using registry pattern
211
- * @param transactionBodyBase64 - The base64 encoded transaction body
212
- * @returns The parsed transaction
10
+ * Retrieves HCS-18 discovery messages from a topic, filtered to valid operations.
213
11
  */
214
- static parseTransactionBody(transactionBodyBase64) {
215
- try {
216
- const buffer = ethers.decodeBase64(transactionBodyBase64);
217
- const txBody = proto.SchedulableTransactionBody.decode(buffer);
218
- const transactionType = this.getTransactionType(txBody);
219
- const result = {
220
- type: transactionType,
221
- humanReadableType: this.getHumanReadableType(transactionType),
222
- transfers: [],
223
- tokenTransfers: [],
224
- raw: txBody
225
- };
226
- if (txBody.memo) {
227
- result.memo = txBody.memo;
228
- }
229
- if (txBody.transactionFee) {
230
- const hbarAmount = Hbar.fromTinybars(
231
- Long.fromValue(txBody.transactionFee)
232
- );
233
- result.transactionFee = hbarAmount.toString(HbarUnit.Hbar);
234
- }
235
- this.applySchedulableTransactionParsing(txBody, result);
236
- return result;
237
- } catch (error) {
238
- return {
239
- type: "UNKNOWN",
240
- humanReadableType: "Unknown Transaction",
241
- transfers: [],
242
- tokenTransfers: [],
243
- raw: void 0,
244
- details: {
245
- error: `Failed to parse transaction body: ${error instanceof Error ? error.message : String(error)}`
246
- }
247
- };
12
+ async getDiscoveryMessages(topicId, options) {
13
+ const validOps = ["announce", "propose", "respond", "complete", "withdraw"];
14
+ const messages = await this.mirrorNode.getTopicMessages(topicId, options);
15
+ if (!messages) {
16
+ return [];
248
17
  }
18
+ return messages.filter((m) => m.p === "hcs-18" && validOps.includes(m.op));
249
19
  }
250
20
  /**
251
- * Detect transaction type and human-readable type from transaction body protobuf
252
- * Uses registry pattern to eliminate massive if-else chain
253
- */
254
- static detectTransactionTypeFromBody(txBody) {
255
- return getTransactionTypeFromBody(txBody);
256
- }
257
- /**
258
- * Parse details from a complete schedule response
259
- * @param scheduleResponse - The schedule response to parse
260
- * @returns The parsed transaction
261
- */
262
- static parseScheduleResponse(scheduleResponse) {
263
- if (!scheduleResponse.transaction_body) {
264
- return {
265
- type: "UNKNOWN",
266
- humanReadableType: "Unknown Transaction",
267
- transfers: [],
268
- tokenTransfers: [],
269
- raw: void 0,
270
- details: {
271
- error: "Schedule response missing transaction_body"
272
- }
273
- };
274
- }
275
- const parsed = this.parseTransactionBody(scheduleResponse.transaction_body);
276
- if (scheduleResponse.memo) {
277
- parsed.memo = scheduleResponse.memo;
278
- }
279
- return parsed;
280
- }
281
- /**
282
- * Determine the transaction type using registry pattern
283
- * @param txBody - The transaction body to determine the type of
284
- * @returns The type of the transaction
285
- */
286
- static getTransactionType(txBody) {
287
- return getTransactionTypeFromBody(txBody).type;
288
- }
289
- /**
290
- * Convert technical transaction type to human-readable format using registry pattern
291
- * @param type - The technical transaction type
292
- * @returns The human-readable transaction type
293
- */
294
- static getHumanReadableType(type) {
295
- return getHumanReadableTransactionType(type);
296
- }
297
- /**
298
- * Get a human-readable summary of the transaction
299
- * @param parsedTx - The parsed transaction
300
- * @returns The human-readable summary of the transaction
301
- */
302
- static getTransactionSummary(parsedTx) {
303
- return resolveTransactionSummary(parsedTx);
304
- }
305
- /**
306
- * Validate transaction bytes format and encoding
307
- * Enhanced validation with better format detection
308
- */
309
- static validateTransactionBytes(transactionBytes) {
310
- if (!transactionBytes || typeof transactionBytes !== "string") {
311
- return {
312
- isValid: false,
313
- error: "Transaction bytes must be a non-empty string"
314
- };
315
- }
316
- const format = this.detectTransactionFormat(transactionBytes);
317
- const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
318
- const hexRegex = /^0x[0-9a-fA-F]+$/;
319
- let isValid = false;
320
- let error;
321
- if (format === "hex") {
322
- isValid = hexRegex.test(transactionBytes) && transactionBytes.length > 2;
323
- if (!isValid) {
324
- error = "Invalid hex format";
325
- }
326
- } else {
327
- isValid = base64Regex.test(transactionBytes) && transactionBytes.length > 0;
328
- if (!isValid) {
329
- error = "Invalid base64 format";
330
- }
331
- }
332
- return {
333
- isValid,
334
- format,
335
- error,
336
- length: transactionBytes.length
337
- };
338
- }
339
- /**
340
- * Detects the format of transaction bytes
341
- * @param transactionBytes - The transaction bytes to analyze
342
- * @returns The detected format ('base64' or 'hex')
343
- */
344
- static detectTransactionFormat(transactionBytes) {
345
- return transactionBytes.startsWith("0x") ? "hex" : "base64";
346
- }
347
- /**
348
- * Decodes transaction bytes from string to Uint8Array
349
- * @param transactionBytes - The transaction bytes string (base64 or hex)
350
- * @returns Decoded Uint8Array
351
- * @throws TransactionParsingError if decoding fails
352
- */
353
- static decodeTransactionBytes(transactionBytes) {
354
- try {
355
- const format = this.detectTransactionFormat(transactionBytes);
356
- if (format === "hex") {
357
- const hexString = transactionBytes.slice(2);
358
- return new Uint8Array(Buffer.from(hexString, "hex"));
359
- } else {
360
- return new Uint8Array(Buffer.from(transactionBytes, "base64"));
361
- }
362
- } catch (error) {
363
- throw new TransactionParsingError(
364
- "Failed to decode transaction bytes",
365
- "DECODE_ERROR",
366
- error instanceof Error ? error : void 0,
367
- transactionBytes
368
- );
369
- }
370
- }
371
- /**
372
- * Check if transaction bytes represent a valid Hedera transaction
373
- */
374
- static async isValidHederaTransaction(transactionBytes) {
375
- try {
376
- if (!this.validateTransactionBytes(transactionBytes).isValid) {
377
- return false;
378
- }
379
- const bytes = this.decodeTransactionBytes(transactionBytes);
380
- Transaction.fromBytes(bytes);
381
- return true;
382
- } catch {
383
- return false;
384
- }
385
- }
386
- /**
387
- * Legacy alias for decodeTransactionBytes - keeping for backward compatibility
388
- */
389
- static decodeBytesLegacy(transactionBytes) {
390
- return this.decodeTransactionBytes(transactionBytes);
391
- }
392
- /**
393
- * Parse transaction bytes into structured data using thin orchestration
394
- * Delegates to specialized parsers for clean separation of concerns
395
- */
396
- static async parseTransaction(transactionBytes, options = {}) {
397
- try {
398
- const bytes = this.decodeTransactionBytes(transactionBytes);
399
- const transaction = Transaction.fromBytes(bytes);
400
- const metadata = this.extractTransactionMetadataEnhanced(transaction);
401
- const parserResults = this.runAllParsers(transaction);
402
- const primaryResult = parserResults.find(
403
- (result2) => result2.type && result2.type !== "UNKNOWN"
404
- ) || {};
405
- const protoParsingResult = this.parseFromProtobuf(bytes);
406
- const finalType = protoParsingResult.type || primaryResult.type || "UNKNOWN";
407
- const finalHumanReadableType = protoParsingResult.humanReadableType || primaryResult.humanReadableType || "Unknown Transaction";
408
- const result = {
409
- type: finalType,
410
- humanReadableType: finalHumanReadableType,
411
- transfers: [],
412
- tokenTransfers: [],
413
- details: { ...metadata },
414
- memo: typeof metadata.memo === "string" ? metadata.memo : void 0,
415
- transactionId: typeof metadata.transactionId === "string" ? metadata.transactionId : void 0,
416
- nodeAccountIds: Array.isArray(metadata.nodeAccountIds) ? metadata.nodeAccountIds : [],
417
- maxTransactionFee: typeof metadata.maxTransactionFee === "string" ? metadata.maxTransactionFee : void 0,
418
- validStart: typeof metadata.validStart === "string" ? metadata.validStart : void 0,
419
- validDuration: typeof metadata.validDuration === "string" ? metadata.validDuration : void 0,
420
- raw: options.includeRaw ? {} : void 0
421
- };
422
- this.mergeAllResults(
423
- result,
424
- protoParsingResult,
425
- primaryResult,
426
- parserResults
427
- );
428
- return result;
429
- } catch (error) {
430
- throw new TransactionParsingError(
431
- "Failed to parse as regular transaction",
432
- "REGULAR_PARSING_FAILED",
433
- error instanceof Error ? error : void 0,
434
- transactionBytes
435
- );
436
- }
437
- }
438
- /**
439
- * Parse scheduled transaction body
440
- */
441
- static parseScheduledTransaction(transactionBytes, options = {}) {
442
- try {
443
- const parsedTx = this.parseTransactionBody(transactionBytes);
444
- const validation = this.validateTransactionBytes(transactionBytes);
445
- const enhancedResult = {
446
- ...parsedTx,
447
- details: {
448
- ...parsedTx.details || {},
449
- parseMethod: "scheduled",
450
- validation,
451
- parseAttempts: parsedTx.details?.parseAttempts || 1
452
- },
453
- formatDetection: {
454
- originalFormat: validation.format || "base64",
455
- wasConverted: false,
456
- length: transactionBytes.length
457
- }
458
- };
459
- return enhancedResult;
460
- } catch (error) {
461
- throw new TransactionParsingError(
462
- "Failed to parse as scheduled transaction",
463
- "SCHEDULED_PARSING_FAILED",
464
- error instanceof Error ? error : void 0,
465
- transactionBytes
466
- );
467
- }
468
- }
469
- /**
470
- * Extract metadata from Transaction object (legacy method - keeping for backward compatibility)
471
- */
472
- static extractTransactionMetadata(transaction) {
473
- return {
474
- transactionId: transaction.transactionId?.toString(),
475
- nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
476
- maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
477
- memo: transaction._transactionMemo || void 0,
478
- transfers: [],
479
- tokenTransfers: []
480
- };
481
- }
482
- /**
483
- * Extract enhanced metadata from Transaction object
484
- */
485
- static extractTransactionMetadataEnhanced(transaction) {
486
- return {
487
- transactionId: transaction.transactionId?.toString(),
488
- nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
489
- maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
490
- memo: transaction._transactionMemo || void 0,
491
- validStart: transaction._transactionValidStart?.toString(),
492
- validDuration: transaction._transactionValidDuration?.toString()
493
- };
494
- }
495
- /**
496
- * Run all available parsers on a transaction
21
+ * Determines if a proposal has sufficient acceptances to proceed.
497
22
  */
498
- static runAllParsers(transaction) {
499
- return [
500
- HTSParser.parseFromTransactionObject(transaction),
501
- CryptoParser.parseFromTransactionObject(transaction),
502
- HCSParser.parseFromTransactionObject(transaction),
503
- FileParser.parseFromTransactionObject(transaction),
504
- SCSParser.parseFromTransactionObject(transaction),
505
- ScheduleParser.parseFromTransactionObject(transaction),
506
- UtilParser.parseFromTransactionObject(transaction)
507
- ];
508
- }
509
- /**
510
- * Parse transaction from protobuf bytes
511
- */
512
- static parseFromProtobuf(bytes) {
513
- const result = {};
514
- try {
515
- const decoded = proto.TransactionList.decode(bytes);
516
- if (decoded.transactionList && decoded.transactionList.length > 0) {
517
- const tx = decoded.transactionList[0];
518
- let txBody = null;
519
- if (tx.bodyBytes && tx.bodyBytes.length > 0) {
520
- txBody = proto.TransactionBody.decode(tx.bodyBytes);
521
- } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
522
- const signedTx = proto.SignedTransaction.decode(
523
- tx.signedTransactionBytes
524
- );
525
- if (signedTx.bodyBytes) {
526
- txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
527
- }
528
- }
529
- if (txBody) {
530
- const typeResult = this.detectTransactionTypeFromBody(txBody);
531
- result.type = typeResult.type;
532
- result.humanReadableType = typeResult.humanReadableType;
533
- const details = this.parseTransactionBodyDetails(
534
- txBody,
535
- typeResult.type
536
- );
537
- Object.assign(result, details);
538
- }
539
- }
540
- } catch (error) {
541
- }
542
- return result;
543
- }
544
- /**
545
- * Intelligently merge all parsing results
546
- */
547
- static mergeAllResults(result, protoResult, primaryResult, parserResults) {
548
- const cryptoResult = parserResults.find((r) => r.transfers || r.tokenTransfers) || {};
549
- result.transfers = cryptoResult.transfers || result.transfers || [];
550
- result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
551
- Object.keys(protoResult).forEach((key) => {
552
- if (protoResult[key] !== void 0 && key !== "type" && key !== "humanReadableType") {
553
- result[key] = protoResult[key];
554
- }
555
- });
556
- Object.keys(primaryResult).forEach((key) => {
557
- if (primaryResult[key] !== void 0 && !(key in result) && key !== "type" && key !== "humanReadableType") {
558
- result[key] = primaryResult[key];
559
- }
560
- });
561
- }
562
- /**
563
- * Apply schedulable transaction parsing using registry pattern
564
- * Eliminates conditional logic in parseTransactionBody
565
- */
566
- static applySchedulableTransactionParsing(txBody, result) {
567
- if (txBody.cryptoTransfer) {
568
- CryptoParser.parseCryptoTransfers(txBody.cryptoTransfer, result);
569
- }
570
- if (txBody.cryptoDelete) {
571
- result.cryptoDelete = CryptoParser.parseCryptoDelete(txBody.cryptoDelete);
572
- }
573
- if (txBody.cryptoCreateAccount) {
574
- result.cryptoCreateAccount = CryptoParser.parseCryptoCreateAccount(
575
- txBody.cryptoCreateAccount
576
- );
577
- }
578
- if (txBody.cryptoUpdateAccount) {
579
- result.cryptoUpdateAccount = CryptoParser.parseCryptoUpdateAccount(
580
- txBody.cryptoUpdateAccount
581
- );
582
- }
583
- if (txBody.cryptoApproveAllowance) {
584
- result.cryptoApproveAllowance = CryptoParser.parseCryptoApproveAllowance(
585
- txBody.cryptoApproveAllowance
586
- );
587
- }
588
- if (txBody.cryptoDeleteAllowance) {
589
- result.cryptoDeleteAllowance = CryptoParser.parseCryptoDeleteAllowance(
590
- txBody.cryptoDeleteAllowance
591
- );
592
- }
593
- if (txBody.contractCall) {
594
- result.contractCall = SCSParser.parseContractCall(txBody.contractCall);
595
- }
596
- if (txBody.contractCreateInstance) {
597
- result.contractCreate = SCSParser.parseContractCreate(
598
- txBody.contractCreateInstance
599
- );
600
- }
601
- if (txBody.contractUpdateInstance) {
602
- result.contractUpdate = SCSParser.parseContractUpdate(
603
- txBody.contractUpdateInstance
604
- );
605
- }
606
- if (txBody.contractDeleteInstance) {
607
- result.contractDelete = SCSParser.parseContractDelete(
608
- txBody.contractDeleteInstance
609
- );
610
- }
611
- if (txBody.tokenCreation) {
612
- result.tokenCreation = HTSParser.parseTokenCreate(txBody.tokenCreation);
613
- }
614
- if (txBody.tokenMint) {
615
- result.tokenMint = HTSParser.parseTokenMint(txBody.tokenMint);
616
- }
617
- if (txBody.tokenBurn) {
618
- result.tokenBurn = HTSParser.parseTokenBurn(txBody.tokenBurn);
619
- }
620
- if (txBody.tokenUpdate) {
621
- result.tokenUpdate = HTSParser.parseTokenUpdate(txBody.tokenUpdate);
622
- }
623
- if (txBody.tokenFeeScheduleUpdate) {
624
- result.tokenFeeScheduleUpdate = HTSParser.parseTokenFeeScheduleUpdate(
625
- txBody.tokenFeeScheduleUpdate
626
- );
627
- }
628
- if (txBody.tokenFreeze) {
629
- result.tokenFreeze = HTSParser.parseTokenFreeze(txBody.tokenFreeze);
630
- }
631
- if (txBody.tokenUnfreeze) {
632
- result.tokenUnfreeze = HTSParser.parseTokenUnfreeze(txBody.tokenUnfreeze);
633
- }
634
- if (txBody.tokenGrantKyc) {
635
- result.tokenGrantKyc = HTSParser.parseTokenGrantKyc(txBody.tokenGrantKyc);
636
- }
637
- if (txBody.tokenRevokeKyc) {
638
- result.tokenRevokeKyc = HTSParser.parseTokenRevokeKyc(
639
- txBody.tokenRevokeKyc
640
- );
641
- }
642
- if (txBody.tokenPause) {
643
- result.tokenPause = HTSParser.parseTokenPause(txBody.tokenPause);
644
- }
645
- if (txBody.tokenUnpause) {
646
- result.tokenUnpause = HTSParser.parseTokenUnpause(txBody.tokenUnpause);
647
- }
648
- if (txBody.tokenWipe) {
649
- result.tokenWipeAccount = HTSParser.parseTokenWipeAccount(
650
- txBody.tokenWipe
651
- );
652
- }
653
- if (txBody.tokenDeletion) {
654
- result.tokenDelete = HTSParser.parseTokenDelete(txBody.tokenDeletion);
655
- }
656
- if (txBody.tokenAssociate) {
657
- result.tokenAssociate = HTSParser.parseTokenAssociate(
658
- txBody.tokenAssociate
659
- );
660
- }
661
- if (txBody.tokenDissociate) {
662
- result.tokenDissociate = HTSParser.parseTokenDissociate(
663
- txBody.tokenDissociate
664
- );
665
- }
666
- if (txBody.tokenAirdrop) {
667
- result.tokenAirdrop = HTSParser.parseTokenAirdropFromProto(
668
- txBody.tokenAirdrop
669
- );
670
- }
671
- if (txBody.consensusCreateTopic) {
672
- result.consensusCreateTopic = HCSParser.parseConsensusCreateTopic(
673
- txBody.consensusCreateTopic
674
- );
675
- }
676
- if (txBody.consensusSubmitMessage) {
677
- result.consensusSubmitMessage = HCSParser.parseConsensusSubmitMessage(
678
- txBody.consensusSubmitMessage
679
- );
680
- }
681
- if (txBody.consensusUpdateTopic) {
682
- result.consensusUpdateTopic = HCSParser.parseConsensusUpdateTopic(
683
- txBody.consensusUpdateTopic
684
- );
685
- }
686
- if (txBody.consensusDeleteTopic) {
687
- result.consensusDeleteTopic = HCSParser.parseConsensusDeleteTopic(
688
- txBody.consensusDeleteTopic
689
- );
690
- }
691
- if (txBody.fileCreate) {
692
- result.fileCreate = FileParser.parseFileCreate(txBody.fileCreate);
693
- }
694
- if (txBody.fileAppend) {
695
- result.fileAppend = FileParser.parseFileAppend(txBody.fileAppend);
696
- }
697
- if (txBody.fileUpdate) {
698
- result.fileUpdate = FileParser.parseFileUpdate(txBody.fileUpdate);
699
- }
700
- if (txBody.fileDelete) {
701
- result.fileDelete = FileParser.parseFileDelete(txBody.fileDelete);
702
- }
703
- if (txBody.utilPrng) {
704
- result.utilPrng = UtilParser.parseUtilPrng(txBody.utilPrng);
705
- }
706
- }
707
- /**
708
- * Parse transaction body details for all supported transaction types
709
- * Uses a scalable registry pattern instead of if-else chains
710
- */
711
- static parseTransactionBodyDetails(txBody, transactionType) {
712
- const result = {};
713
- const parserConfig = transactionParserRegistry[transactionType];
714
- if (parserConfig) {
715
- const bodyData = txBody[parserConfig.bodyField];
716
- if (bodyData) {
717
- const parserResult = parserConfig.parser(bodyData);
718
- if (parserConfig.spreadResult) {
719
- Object.assign(result, parserResult);
720
- } else {
721
- result[parserConfig.resultField] = parserResult;
722
- }
723
- }
724
- }
725
- return result;
726
- }
727
- /**
728
- * Merge protobuf parsing results with parser results using registry pattern
729
- * Eliminates transactionFields array and forEach logic
730
- */
731
- static mergeProtoParsingResults(result, protoResult, htsResult, transaction, originalBytes) {
732
- const fieldsToMerge = Object.values(transactionParserRegistry).map(
733
- (config) => config.resultField
23
+ isProposalReady(proposal) {
24
+ const acceptances = Array.from(proposal.responses.values()).filter(
25
+ (r) => r.decision === "accept"
734
26
  );
735
- for (const field of fieldsToMerge) {
736
- const protoValue = protoResult[field];
737
- const htsValue = htsResult[field];
738
- if (protoValue !== void 0) {
739
- result[field] = protoValue;
740
- } else if (htsValue !== void 0) {
741
- result[field] = htsValue;
742
- } else {
743
- this.handleSpecialFieldExtraction(result, field, transaction);
744
- }
745
- }
746
- }
747
- /**
748
- * Handle special field extraction cases using registry pattern
749
- */
750
- static handleSpecialFieldExtraction(result, field, transaction) {
751
- if (field === "tokenCreation" && result.type === "TOKENCREATE") {
752
- const extracted = HTSParser.extractTokenCreationFromTransaction(transaction);
753
- if (extracted) {
754
- result[field] = extracted;
755
- }
756
- } else if (field === "tokenAirdrop" && result.type === "TOKENAIRDROP") {
757
- const extracted = HTSParser.extractTokenAirdropFromTransaction(transaction);
758
- if (extracted) {
759
- result[field] = extracted;
760
- }
761
- }
762
- }
763
- /**
764
- * Create fallback result when all parsing methods fail
765
- */
766
- static createFallbackResult(transactionBytes, primaryError, secondaryError) {
767
- const validation = this.validateTransactionBytes(transactionBytes);
768
- return {
769
- type: "UNKNOWN",
770
- humanReadableType: "Unknown Transaction",
771
- transfers: [],
772
- tokenTransfers: [],
773
- details: {
774
- rawBytes: transactionBytes.length > 100 ? transactionBytes.substring(0, 100) + "..." : transactionBytes,
775
- primaryError: primaryError?.message,
776
- secondaryError: secondaryError?.message,
777
- parseAttempts: secondaryError ? 2 : 1,
778
- validation
779
- },
780
- formatDetection: {
781
- originalFormat: validation.format || "base64",
782
- wasConverted: false,
783
- length: transactionBytes.length
784
- },
785
- raw: {}
786
- };
27
+ const requiredResponses = proposal.data.members.length - 1;
28
+ return acceptances.length >= requiredResponses;
787
29
  }
788
30
  }
789
31
  export {
790
- TransactionParser,
791
- TransactionParsingError
32
+ HCS18BaseClient
792
33
  };
793
34
  //# sourceMappingURL=standards-sdk.es104.js.map