@shapeshiftoss/unchained-client 10.14.11 → 10.16.0

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 (61) hide show
  1. package/dist/cjs/.tsbuildinfo +1 -1
  2. package/dist/cjs/cosmossdk/thorchain/parser/__tests__/thorchain.test.js +1 -1
  3. package/dist/cjs/cosmossdk/thorchain/parser/rfox.js +1 -1
  4. package/dist/cjs/evm/arbitrum/parser/index.js +2 -2
  5. package/dist/cjs/evm/ethereum/parser/index.js +6 -0
  6. package/dist/cjs/generated/ethereum/apis/V1Api.d.ts +15 -0
  7. package/dist/cjs/generated/ethereum/apis/V1Api.js +24 -0
  8. package/dist/cjs/generated/mayachain/apis/V1Api.d.ts +1 -13
  9. package/dist/cjs/generated/mayachain/apis/V1Api.js +0 -27
  10. package/dist/cjs/generated/mayachain/models/index.d.ts +0 -2
  11. package/dist/cjs/generated/mayachain/models/index.js +0 -2
  12. package/dist/cjs/generated/thorchain/apis/V1Api.d.ts +1 -25
  13. package/dist/cjs/generated/thorchain/apis/V1Api.js +0 -54
  14. package/dist/cjs/generated/thorchain/models/index.d.ts +0 -3
  15. package/dist/cjs/generated/thorchain/models/index.js +0 -3
  16. package/dist/cjs/tron/__tests__/api.test.d.ts +1 -0
  17. package/dist/cjs/tron/__tests__/api.test.js +425 -0
  18. package/dist/cjs/tron/api.d.ts +42 -15
  19. package/dist/cjs/tron/api.js +222 -78
  20. package/dist/cjs/tron/types.d.ts +4 -0
  21. package/dist/esm/.tsbuildinfo +1 -1
  22. package/dist/esm/cosmossdk/thorchain/parser/__tests__/thorchain.test.js +2 -2
  23. package/dist/esm/cosmossdk/thorchain/parser/rfox.js +2 -2
  24. package/dist/esm/evm/arbitrum/parser/index.js +3 -3
  25. package/dist/esm/evm/ethereum/parser/index.js +7 -1
  26. package/dist/esm/generated/ethereum/apis/V1Api.d.ts +15 -0
  27. package/dist/esm/generated/ethereum/apis/V1Api.js +24 -0
  28. package/dist/esm/generated/mayachain/apis/V1Api.d.ts +1 -13
  29. package/dist/esm/generated/mayachain/apis/V1Api.js +1 -28
  30. package/dist/esm/generated/mayachain/models/index.d.ts +0 -2
  31. package/dist/esm/generated/mayachain/models/index.js +0 -2
  32. package/dist/esm/generated/thorchain/apis/V1Api.d.ts +1 -25
  33. package/dist/esm/generated/thorchain/apis/V1Api.js +1 -55
  34. package/dist/esm/generated/thorchain/models/index.d.ts +0 -3
  35. package/dist/esm/generated/thorchain/models/index.js +0 -3
  36. package/dist/esm/tron/__tests__/api.test.d.ts +1 -0
  37. package/dist/esm/tron/__tests__/api.test.js +423 -0
  38. package/dist/esm/tron/api.d.ts +42 -15
  39. package/dist/esm/tron/api.js +220 -77
  40. package/dist/esm/tron/types.d.ts +4 -0
  41. package/package.json +5 -5
  42. package/dist/cjs/generated/mayachain/models/AffiliateFee.d.ts +0 -67
  43. package/dist/cjs/generated/mayachain/models/AffiliateFee.js +0 -63
  44. package/dist/cjs/generated/mayachain/models/AffiliateFees.d.ts +0 -32
  45. package/dist/cjs/generated/mayachain/models/AffiliateFees.js +0 -52
  46. package/dist/cjs/generated/thorchain/models/AffiliateFee.d.ts +0 -67
  47. package/dist/cjs/generated/thorchain/models/AffiliateFee.js +0 -63
  48. package/dist/cjs/generated/thorchain/models/AffiliateFees.d.ts +0 -32
  49. package/dist/cjs/generated/thorchain/models/AffiliateFees.js +0 -52
  50. package/dist/cjs/generated/thorchain/models/AffiliateRevenue.d.ts +0 -45
  51. package/dist/cjs/generated/thorchain/models/AffiliateRevenue.js +0 -57
  52. package/dist/esm/generated/mayachain/models/AffiliateFee.d.ts +0 -67
  53. package/dist/esm/generated/mayachain/models/AffiliateFee.js +0 -56
  54. package/dist/esm/generated/mayachain/models/AffiliateFees.d.ts +0 -32
  55. package/dist/esm/generated/mayachain/models/AffiliateFees.js +0 -45
  56. package/dist/esm/generated/thorchain/models/AffiliateFee.d.ts +0 -67
  57. package/dist/esm/generated/thorchain/models/AffiliateFee.js +0 -56
  58. package/dist/esm/generated/thorchain/models/AffiliateFees.d.ts +0 -32
  59. package/dist/esm/generated/thorchain/models/AffiliateFees.js +0 -45
  60. package/dist/esm/generated/thorchain/models/AffiliateRevenue.d.ts +0 -45
  61. package/dist/esm/generated/thorchain/models/AffiliateRevenue.js +0 -50
@@ -0,0 +1,423 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { getCallerEnergy, TronApi } from '../api.js';
3
+ const successResponse = {
4
+ result: { result: true },
5
+ energy_used: 64285,
6
+ energy_penalty: 49635,
7
+ constant_result: ['0000000000000000000000000000000000000000000000000000000000000000'],
8
+ transaction: { ret: [{}] },
9
+ };
10
+ // A reverted simulation still reports result.result: true - the failure is only visible on
11
+ // transaction.ret and the message
12
+ const revertResponse = {
13
+ result: { result: true, message: 'REVERT opcode executed' },
14
+ energy_used: 7896,
15
+ energy_penalty: 6079,
16
+ constant_result: [''],
17
+ transaction: { ret: [{ ret: 'FAILED' }] },
18
+ };
19
+ describe('TronApi', () => {
20
+ const api = new TronApi({ rpcUrl: 'https://tron.example' });
21
+ beforeEach(() => {
22
+ vi.spyOn(api, 'getChainPrices').mockResolvedValue({
23
+ bandwidthPrice: 1000,
24
+ energyPrice: 100,
25
+ memoFee: 1_000_000,
26
+ });
27
+ vi.spyOn(api, 'getContractEnergyShare').mockResolvedValue({
28
+ callerPercent: 100,
29
+ originEnergyLimit: 0,
30
+ originEnergyAvailable: 0,
31
+ });
32
+ });
33
+ afterEach(() => {
34
+ vi.restoreAllMocks();
35
+ vi.unstubAllGlobals();
36
+ });
37
+ describe('estimateContractCallFee', () => {
38
+ const params = {
39
+ contractAddress: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K',
40
+ from: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
41
+ data: '0x2213bc0b',
42
+ };
43
+ it('prices a successful simulation at energy_used * energyPrice', async () => {
44
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
45
+ expect(await api.estimateContractCallFee(params)).toBe('6428500');
46
+ });
47
+ it('prices the caller in full when the share lookup fails', async () => {
48
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
49
+ vi.mocked(api.getContractEnergyShare).mockRejectedValue(new Error('429'));
50
+ expect(await api.estimateContractCallFee(params)).toBe('6428500');
51
+ });
52
+ it('fails instead when the caller requires the share', async () => {
53
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
54
+ vi.mocked(api.getContractEnergyShare).mockRejectedValue(new Error('429'));
55
+ await expect(api.estimateContractCallFee({ ...params, requireEnergyShare: true })).rejects.toThrow('429');
56
+ });
57
+ it('bills the caller only their share when the deployer covers the rest', async () => {
58
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
59
+ vi.mocked(api.getContractEnergyShare).mockResolvedValue({
60
+ callerPercent: 5,
61
+ originEnergyLimit: 10_000_000,
62
+ originEnergyAvailable: 5_000_000,
63
+ });
64
+ // 64285 - floor(64285 * 0.95) = 3215
65
+ expect(await api.estimateContractCallFee(params)).toBe('321500');
66
+ });
67
+ it('throws on a reverted simulation rather than trusting the partial energy', async () => {
68
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => revertResponse }));
69
+ await expect(api.estimateContractCallFee(params)).rejects.toThrow('REVERT opcode executed');
70
+ });
71
+ it('reports a failed request as such rather than as a revert', async () => {
72
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429, json: () => ({}) }));
73
+ await expect(api.estimateContractCallFee(params)).rejects.toThrow('request failed: 429');
74
+ });
75
+ });
76
+ describe('getCallerEnergy', () => {
77
+ it('charges the caller in full when the contract sets no deployer share', () => {
78
+ const share = {
79
+ callerPercent: 100,
80
+ originEnergyLimit: 0,
81
+ originEnergyAvailable: 0,
82
+ };
83
+ expect(getCallerEnergy(901_682, share)).toBe(901_682);
84
+ });
85
+ it('charges the caller their percent when the deployer has the energy staked', () => {
86
+ const share = {
87
+ callerPercent: 5,
88
+ originEnergyLimit: 10_000_000,
89
+ originEnergyAvailable: 5_000_000,
90
+ };
91
+ expect(getCallerEnergy(901_682, share)).toBe(45_085);
92
+ });
93
+ it('charges the caller in full when the deployer has nothing staked', () => {
94
+ const share = {
95
+ callerPercent: 30,
96
+ originEnergyLimit: 10_000_000,
97
+ originEnergyAvailable: 0,
98
+ };
99
+ expect(getCallerEnergy(130_285, share)).toBe(130_285);
100
+ });
101
+ it('caps the deployer share at their per-call limit', () => {
102
+ const share = {
103
+ callerPercent: 0,
104
+ originEnergyLimit: 100_000,
105
+ originEnergyAvailable: 5_000_000,
106
+ };
107
+ expect(getCallerEnergy(300_000, share)).toBe(200_000);
108
+ });
109
+ it('caps the deployer share at what they have left', () => {
110
+ const share = {
111
+ callerPercent: 0,
112
+ originEnergyLimit: 10_000_000,
113
+ originEnergyAvailable: 40_000,
114
+ };
115
+ expect(getCallerEnergy(300_000, share)).toBe(260_000);
116
+ });
117
+ });
118
+ describe('getContractEnergyShare', () => {
119
+ const contractResponse = {
120
+ consume_user_resource_percent: 5,
121
+ origin_energy_limit: 10_000_000,
122
+ origin_address: 'TDeployer',
123
+ };
124
+ const resourceResponse = { EnergyLimit: 6_000_000, EnergyUsed: 1_000_000 };
125
+ const respond = (...bodies) => {
126
+ const fetchMock = vi.fn();
127
+ bodies.forEach(body => fetchMock.mockResolvedValueOnce({ ok: true, json: () => body }));
128
+ vi.stubGlobal('fetch', fetchMock);
129
+ return fetchMock;
130
+ };
131
+ // the contract record is cached per instance, so each case gets its own
132
+ const freshApi = () => new TronApi({ rpcUrl: 'https://tron.example' });
133
+ it('reads the caller percent, per-call limit and the unspent deployer energy', async () => {
134
+ respond(contractResponse, resourceResponse);
135
+ expect(await freshApi().getContractEnergyShare('TRouter')).toEqual({
136
+ callerPercent: 5,
137
+ originEnergyLimit: 10_000_000,
138
+ originEnergyAvailable: 5_000_000,
139
+ });
140
+ });
141
+ it('reads an omitted percent as the deployer paying everything', async () => {
142
+ respond({ origin_energy_limit: 10_000_000, origin_address: 'TDeployer' }, resourceResponse);
143
+ expect(await freshApi().getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 0 });
144
+ });
145
+ it('reads an omitted per-call limit as the creator default', async () => {
146
+ respond({ consume_user_resource_percent: 5, origin_address: 'TDeployer' }, resourceResponse);
147
+ expect(await freshApi().getContractEnergyShare('TRouter')).toMatchObject({
148
+ originEnergyLimit: 10_000_000,
149
+ });
150
+ });
151
+ it('reads a plain address as a call the caller pays in full without a resource lookup', async () => {
152
+ const fetchMock = respond({});
153
+ expect(await freshApi().getContractEnergyShare('TPlain')).toEqual({
154
+ callerPercent: 100,
155
+ originEnergyLimit: 0,
156
+ originEnergyAvailable: 0,
157
+ });
158
+ expect(fetchMock).toHaveBeenCalledTimes(1);
159
+ });
160
+ it('re-reads an empty body rather than caching it as a plain address', async () => {
161
+ const fetchMock = respond({}, contractResponse, resourceResponse);
162
+ const api = freshApi();
163
+ await api.getContractEnergyShare('TRouter');
164
+ expect(await api.getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 5 });
165
+ expect(fetchMock).toHaveBeenCalledTimes(3);
166
+ });
167
+ it('rejects a failed lookup rather than guessing the split', async () => {
168
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429 }));
169
+ await expect(freshApi().getContractEnergyShare('TRouter')).rejects.toThrow('429');
170
+ });
171
+ it('does not cache an error body the node returns with a 200', async () => {
172
+ const fetchMock = respond({ Error: 'class org.tron.core.exception' }, contractResponse, resourceResponse);
173
+ const api = freshApi();
174
+ await expect(api.getContractEnergyShare('TRouter')).rejects.toThrow('getcontract failed');
175
+ expect(await api.getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 5 });
176
+ expect(fetchMock).toHaveBeenCalledTimes(3);
177
+ });
178
+ it('reads the contract once and the deployer energy once per refresh window', async () => {
179
+ vi.useFakeTimers();
180
+ const fetchMock = respond(contractResponse, resourceResponse, resourceResponse);
181
+ const api = freshApi();
182
+ await api.getContractEnergyShare('TRouter');
183
+ await api.getContractEnergyShare('TRouter');
184
+ expect(fetchMock).toHaveBeenCalledTimes(2);
185
+ vi.advanceTimersByTime(16_000);
186
+ await api.getContractEnergyShare('TRouter');
187
+ expect(fetchMock).toHaveBeenCalledTimes(3);
188
+ const contractReads = fetchMock.mock.calls.filter(([url]) => String(url).endsWith('/wallet/getcontract'));
189
+ expect(contractReads).toHaveLength(1);
190
+ vi.useRealTimers();
191
+ });
192
+ it('re-reads the contract after a minute, since its split can change', async () => {
193
+ vi.useFakeTimers();
194
+ const fetchMock = respond(contractResponse, resourceResponse, contractResponse, resourceResponse);
195
+ const api = freshApi();
196
+ await api.getContractEnergyShare('TRouter');
197
+ vi.advanceTimersByTime(61_000);
198
+ await api.getContractEnergyShare('TRouter');
199
+ const contractReads = fetchMock.mock.calls.filter(([url]) => String(url).endsWith('/wallet/getcontract'));
200
+ expect(contractReads).toHaveLength(2);
201
+ vi.useRealTimers();
202
+ });
203
+ });
204
+ describe('getChainPrices', () => {
205
+ it('reads the energy, bandwidth and memo parameters', async () => {
206
+ vi.restoreAllMocks();
207
+ const tronWeb = api.getTronWeb();
208
+ vi.spyOn(tronWeb.trx, 'getChainParameters').mockResolvedValue([
209
+ { key: 'getTransactionFee', value: 1000 },
210
+ { key: 'getEnergyFee', value: 100 },
211
+ { key: 'getMemoFee', value: 1_000_000 },
212
+ ]);
213
+ expect(await api.getChainPrices()).toEqual({
214
+ bandwidthPrice: 1000,
215
+ energyPrice: 100,
216
+ memoFee: 1_000_000,
217
+ });
218
+ });
219
+ it('throws rather than defaulting when the node is unreachable', async () => {
220
+ vi.restoreAllMocks();
221
+ const tronWeb = api.getTronWeb();
222
+ vi.spyOn(tronWeb.trx, 'getChainParameters').mockRejectedValue(new Error('ECONNREFUSED'));
223
+ await expect(api.getChainPrices()).rejects.toThrow('ECONNREFUSED');
224
+ });
225
+ });
226
+ describe('getTrc20Balance', () => {
227
+ it('reads balanceOf(address) with a single constant call', async () => {
228
+ const tronWeb = api.getTronWeb();
229
+ const trigger = vi
230
+ .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
231
+ .mockResolvedValue({
232
+ result: { result: true },
233
+ constant_result: ['00000000000000000000000000000000000000000000000000000000028e6fb0'],
234
+ });
235
+ const actual = await api.getTrc20Balance({
236
+ contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
237
+ address: 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc',
238
+ });
239
+ expect(actual).toBe('42889136');
240
+ expect(trigger).toHaveBeenCalledWith('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t', 'balanceOf(address)', {}, [{ type: 'address', value: 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc' }], 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc');
241
+ });
242
+ });
243
+ describe('getTrc20Decimals', () => {
244
+ const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
245
+ const eighteen = '0000000000000000000000000000000000000000000000000000000000000012';
246
+ it('reads decimals() with a single constant call', async () => {
247
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
248
+ const tronWeb = freshApi.getTronWeb();
249
+ const trigger = vi
250
+ .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
251
+ .mockResolvedValue({ result: { result: true }, constant_result: [eighteen] });
252
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBe(18);
253
+ expect(trigger).toHaveBeenCalledWith(USDT, 'decimals()', {}, [], USDT);
254
+ });
255
+ it('reads a reverted decimals() as unknown', async () => {
256
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
257
+ const tronWeb = freshApi.getTronWeb();
258
+ const trigger = vi
259
+ .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
260
+ .mockResolvedValueOnce({
261
+ result: { result: true, message: 'REVERT opcode executed' },
262
+ constant_result: ['08c379a0' + '0'.repeat(56)],
263
+ transaction: { ret: [{ ret: 'FAILED' }] },
264
+ })
265
+ .mockResolvedValue({ result: { result: true }, constant_result: [eighteen] });
266
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBeUndefined();
267
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBe(18);
268
+ expect(trigger).toHaveBeenCalledTimes(2);
269
+ });
270
+ it('reads a value outside a uint8 as unknown', async () => {
271
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
272
+ const tronWeb = freshApi.getTronWeb();
273
+ vi.spyOn(tronWeb.transactionBuilder, 'triggerConstantContract').mockResolvedValue({
274
+ result: { result: true },
275
+ constant_result: ['0'.repeat(61) + '100'],
276
+ });
277
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBeUndefined();
278
+ });
279
+ it('gives up on a call that hangs', async () => {
280
+ vi.useFakeTimers();
281
+ try {
282
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
283
+ const tronWeb = freshApi.getTronWeb();
284
+ vi.spyOn(tronWeb.transactionBuilder, 'triggerConstantContract').mockReturnValue(new Promise(() => undefined));
285
+ const pending = freshApi.getTrc20Decimals({ contractAddress: USDT });
286
+ await vi.runAllTimersAsync();
287
+ expect(await pending).toBeUndefined();
288
+ }
289
+ finally {
290
+ vi.useRealTimers();
291
+ }
292
+ });
293
+ it('reads a failed call as unknown', async () => {
294
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
295
+ const tronWeb = freshApi.getTronWeb();
296
+ const trigger = vi
297
+ .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
298
+ .mockRejectedValueOnce(new Error('429'))
299
+ .mockResolvedValue({ result: { result: true }, constant_result: [eighteen] });
300
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBeUndefined();
301
+ expect(await freshApi.getTrc20Decimals({ contractAddress: USDT })).toBe(18);
302
+ expect(trigger).toHaveBeenCalledTimes(2);
303
+ });
304
+ });
305
+ describe('getTrc10Precision', () => {
306
+ const respond = (body) => {
307
+ const fetchMock = vi.fn().mockResolvedValue({ ok: true, json: () => body });
308
+ vi.stubGlobal('fetch', fetchMock);
309
+ return fetchMock;
310
+ };
311
+ it('reads the precision of an issued token', async () => {
312
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
313
+ const fetchMock = respond({ success: true, data: [{ id: '1002000', precision: 6 }] });
314
+ expect(await freshApi.getTrc10Precision({ id: '1002000' })).toBe(6);
315
+ expect(fetchMock).toHaveBeenCalledWith('https://tron.example/v1/assets/1002000', expect.objectContaining({ headers: expect.anything() }));
316
+ });
317
+ it('reads a zero precision as issued', async () => {
318
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
319
+ respond({ success: true, data: [{ id: '1000001', precision: 0 }] });
320
+ expect(await freshApi.getTrc10Precision({ id: '1000001' })).toBe(0);
321
+ });
322
+ it('reads an unknown id as unknown', async () => {
323
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
324
+ respond({ success: false, error: 'A valid account address or asset id is required.' });
325
+ expect(await freshApi.getTrc10Precision({ id: '9999999' })).toBeUndefined();
326
+ });
327
+ it('reads an empty listing as unknown', async () => {
328
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
329
+ respond({ success: true, data: [] });
330
+ expect(await freshApi.getTrc10Precision({ id: '1009999' })).toBeUndefined();
331
+ });
332
+ it('gives up on a request that hangs', async () => {
333
+ vi.useFakeTimers();
334
+ try {
335
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
336
+ vi.stubGlobal('fetch', vi.fn().mockReturnValue(new Promise(() => undefined)));
337
+ const pending = freshApi.getTrc10Precision({ id: '1002000' });
338
+ await vi.runAllTimersAsync();
339
+ expect(await pending).toBeUndefined();
340
+ }
341
+ finally {
342
+ vi.useRealTimers();
343
+ }
344
+ });
345
+ it('gives up on a response whose body stalls', async () => {
346
+ vi.useFakeTimers();
347
+ try {
348
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
349
+ const fetchMock = vi
350
+ .fn()
351
+ .mockResolvedValue({ ok: true, json: () => new Promise(() => undefined) });
352
+ vi.stubGlobal('fetch', fetchMock);
353
+ const pending = freshApi.getTrc10Precision({ id: '1002000' });
354
+ await vi.runAllTimersAsync();
355
+ expect(await pending).toBeUndefined();
356
+ expect(fetchMock).toHaveBeenCalledWith('https://tron.example/v1/assets/1002000', expect.objectContaining({ signal: expect.any(AbortSignal) }));
357
+ }
358
+ finally {
359
+ vi.useRealTimers();
360
+ }
361
+ });
362
+ it('reads a failed request as unknown', async () => {
363
+ const freshApi = new TronApi({ rpcUrl: 'https://tron.example' });
364
+ vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('429')));
365
+ expect(await freshApi.getTrc10Precision({ id: '1002000' })).toBeUndefined();
366
+ });
367
+ });
368
+ describe('getTrc20Allowance', () => {
369
+ it('reads allowance(owner, spender) with a single constant call', async () => {
370
+ const tronWeb = api.getTronWeb();
371
+ const trigger = vi
372
+ .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
373
+ .mockResolvedValue({
374
+ result: { result: true },
375
+ constant_result: ['000000000000000000000000000000000000000000000000000000000000007b'],
376
+ });
377
+ const actual = await api.getTrc20Allowance({
378
+ contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
379
+ owner: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
380
+ spender: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K',
381
+ });
382
+ expect(actual).toBe('123');
383
+ expect(trigger).toHaveBeenCalledWith('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t', 'allowance(address,address)', {}, [
384
+ { type: 'address', value: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N' },
385
+ { type: 'address', value: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K' },
386
+ ], 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N');
387
+ });
388
+ });
389
+ describe('isAccountActivated', () => {
390
+ it('is true for an account the node knows', async () => {
391
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => ({ address: '41abc', balance: 1 }) }));
392
+ expect(await api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).toBe(true);
393
+ });
394
+ it('is false for a fresh address', async () => {
395
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => ({}) }));
396
+ expect(await api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).toBe(false);
397
+ });
398
+ it('throws on an error response rather than reading it as not activated', async () => {
399
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429, json: () => ({ Error: 'throttled' }) }));
400
+ await expect(api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).rejects.toThrow('429');
401
+ });
402
+ });
403
+ describe('estimateTrc20TransferFee', () => {
404
+ const params = {
405
+ contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
406
+ from: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
407
+ to: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
408
+ amount: '1',
409
+ };
410
+ const stubTriggerConstantContract = (response) => {
411
+ const tronWeb = api.getTronWeb();
412
+ vi.spyOn(tronWeb.transactionBuilder, 'triggerConstantContract').mockResolvedValue(response);
413
+ };
414
+ it('prices a successful simulation at energy_used * energyPrice', async () => {
415
+ stubTriggerConstantContract(successResponse);
416
+ expect(await api.estimateTrc20TransferFee(params)).toBe('6428500');
417
+ });
418
+ it('throws on a reverted simulation rather than trusting the partial energy', async () => {
419
+ stubTriggerConstantContract(revertResponse);
420
+ await expect(api.estimateTrc20TransferFee(params)).rejects.toThrow('REVERT opcode executed');
421
+ });
422
+ });
423
+ });
@@ -3,10 +3,18 @@ export interface TronApiConfig {
3
3
  rpcUrl: string;
4
4
  apiKey?: string;
5
5
  }
6
+ export type TronContractEnergyShare = {
7
+ callerPercent: number;
8
+ originEnergyLimit: number;
9
+ originEnergyAvailable: number;
10
+ };
11
+ export declare const getCallerEnergy: (energyUsed: number, share: TronContractEnergyShare) => number;
6
12
  export declare class TronApi {
7
13
  private readonly rpcUrl;
8
14
  private readonly apiKey;
9
15
  private tronWeb;
16
+ private readonly contracts;
17
+ private readonly originEnergy;
10
18
  private requestQueue;
11
19
  private readonly minRequestInterval;
12
20
  constructor(config: TronApiConfig);
@@ -24,10 +32,22 @@ export declare class TronApi {
24
32
  balance: string;
25
33
  }[];
26
34
  }>;
27
- getTRC20Balance(params: {
35
+ getTrc20Decimals(params: {
36
+ contractAddress: string;
37
+ }): Promise<number | undefined>;
38
+ getTrc10Precision(params: {
39
+ id: string;
40
+ }): Promise<number | undefined>;
41
+ getTrc20Balance(params: {
42
+ contractAddress: string;
28
43
  address: string;
44
+ }): Promise<string>;
45
+ getTrc20Allowance(params: {
29
46
  contractAddress: string;
47
+ owner: string;
48
+ spender: string;
30
49
  }): Promise<string>;
50
+ isAccountActivated(address: string): Promise<boolean>;
31
51
  getTxHistory(_params: {
32
52
  pubkey: string;
33
53
  pageSize?: number;
@@ -47,23 +67,30 @@ export declare class TronApi {
47
67
  hex: string;
48
68
  };
49
69
  }): Promise<string>;
50
- private getChainPrices;
51
- estimateFees(params: {
52
- estimateFeesBody: {
53
- serializedTx: string;
54
- };
55
- }): Promise<string>;
56
- estimateTRC20TransferFee(params: {
70
+ getChainPrices(): Promise<{
71
+ bandwidthPrice: number;
72
+ energyPrice: number;
73
+ memoFee: number;
74
+ }>;
75
+ getContractEnergyShare(contractAddress: string): Promise<TronContractEnergyShare>;
76
+ private getContract;
77
+ private getPricingContext;
78
+ private getOriginEnergyAvailable;
79
+ private post;
80
+ estimateTrc20TransferFee(params: {
57
81
  contractAddress: string;
58
82
  from: string;
59
83
  to: string;
60
84
  amount: string;
85
+ requireEnergyShare?: boolean;
61
86
  }): Promise<string>;
62
- getPriorityFees(): Promise<{
63
- baseFee: string;
64
- fast: string;
65
- average: string;
66
- slow: string;
67
- estimatedBandwidth: string;
68
- }>;
87
+ estimateContractCallFee(params: {
88
+ contractAddress: string;
89
+ from: string;
90
+ data: string;
91
+ callValue?: string;
92
+ requireEnergyShare?: boolean;
93
+ }): Promise<string>;
94
+ private isReverted;
95
+ private getSimulatedEnergy;
69
96
  }