@shapeshiftoss/unchained-client 10.14.10 → 10.15.0

package/dist/esm/generated/polygon/apis/V1Api.js

@@ -13,7 +13,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import { AccountFromJSON, BaseInfoFromJSON, BaseTxHistoryTxFromJSON, DoRpcRequest200ResponseFromJSON, DoRpcRequestRequestToJSON, EstimateGasBodyToJSON, GasEstimateFromJSON, GasFeesFromJSON, SendTxBodyToJSON, TokenMetadataFromJSON, TxFromJSON, } from '../models/index.js';
+import { AccountFromJSON, BaseInfoFromJSON, BaseTxHistoryTxFromJSON, DoRpcRequest200ResponseFromJSON, DoRpcRequestRequestToJSON, EstimateGasBodyToJSON, GasEstimateFromJSON, GasFeesFromJSON, SendTxBodyToJSON, TxFromJSON, } from '../models/index.js';
 /**
  *
  */
@@ -136,45 +136,6 @@ export class V1Api extends runtime.BaseAPI {
         const response = await this.getInfoRaw(initOverrides);
         return await response.value();
     }
-    /**
-     * Get token metadata
-     */
-    async getTokenMetadataRaw(requestParameters, initOverrides) {
-        if (requestParameters.contract === null || requestParameters.contract === undefined) {
-            throw new runtime.RequiredError('contract', 'Required parameter requestParameters.contract was null or undefined when calling getTokenMetadata.');
-        }
-        if (requestParameters.id === null || requestParameters.id === undefined) {
-            throw new runtime.RequiredError('id', 'Required parameter requestParameters.id was null or undefined when calling getTokenMetadata.');
-        }
-        if (requestParameters.type === null || requestParameters.type === undefined) {
-            throw new runtime.RequiredError('type', 'Required parameter requestParameters.type was null or undefined when calling getTokenMetadata.');
-        }
-        const queryParameters = {};
-        if (requestParameters.contract !== undefined) {
-            queryParameters['contract'] = requestParameters.contract;
-        }
-        if (requestParameters.id !== undefined) {
-            queryParameters['id'] = requestParameters.id;
-        }
-        if (requestParameters.type !== undefined) {
-            queryParameters['type'] = requestParameters.type;
-        }
-        const headerParameters = {};
-        const response = await this.request({
-            path: `/api/v1/metadata/token`,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => TokenMetadataFromJSON(jsonValue));
-    }
-    /**
-     * Get token metadata
-     */
-    async getTokenMetadata(requestParameters, initOverrides) {
-        const response = await this.getTokenMetadataRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
     /**
      * Get transaction details
      */

package/dist/esm/generated/polygon/models/index.d.ts

@@ -16,9 +16,6 @@ export * from './RPCResponseError.js';
 export * from './RPCResponseId.js';
 export * from './SendTxBody.js';
 export * from './TokenBalance.js';
-export * from './TokenMetadata.js';
-export * from './TokenMetadataMedia.js';
 export * from './TokenTransfer.js';
-export * from './TokenType.js';
 export * from './Tx.js';
 export * from './ValidationError.js';

package/dist/esm/generated/polygon/models/index.js

@@ -19,9 +19,6 @@ export * from './RPCResponseError.js';
 export * from './RPCResponseId.js';
 export * from './SendTxBody.js';
 export * from './TokenBalance.js';
-export * from './TokenMetadata.js';
-export * from './TokenMetadataMedia.js';
 export * from './TokenTransfer.js';
-export * from './TokenType.js';
 export * from './Tx.js';
 export * from './ValidationError.js';

package/dist/esm/generated/thorchain/apis/V1Api.d.ts

@@ -10,21 +10,13 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import type { Account, AffiliateFees, AffiliateRevenue, EstimateGasRequest, Info, Tx, TxHistory } from '../models/index.js';
+import type { Account, EstimateGasRequest, Info, Tx, TxHistory } from '../models/index.js';
 export interface EstimateGasOperationRequest {
     body?: EstimateGasRequest;
 }
 export interface GetAccountRequest {
     pubkey: string;
 }
-export interface GetAffiliateFeesRequest {
-    start?: string;
-    end?: string;
-}
-export interface GetAffiliateRevenueRequest {
-    start?: string;
-    end?: string;
-}
 export interface GetTxRequest {
     txid: string;
 }
@@ -56,22 +48,6 @@ export declare class V1Api extends runtime.BaseAPI {
      * Get account details.
      */
     getAccount(requestParameters: GetAccountRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Account>;
-    /**
-     * Get ss affiliate fee history.
-     */
-    getAffiliateFeesRaw(requestParameters: GetAffiliateFeesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AffiliateFees>>;
-    /**
-     * Get ss affiliate fee history.
-     */
-    getAffiliateFees(requestParameters?: GetAffiliateFeesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AffiliateFees>;
-    /**
-     * Get total ss affiliate revenue earned.
-     */
-    getAffiliateRevenueRaw(requestParameters: GetAffiliateRevenueRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AffiliateRevenue>>;
-    /**
-     * Get total ss affiliate revenue earned.
-     */
-    getAffiliateRevenue(requestParameters?: GetAffiliateRevenueRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AffiliateRevenue>;
     /**
      * Get information about the running coinstack.
      */

package/dist/esm/generated/thorchain/apis/V1Api.js

@@ -13,7 +13,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import { AccountFromJSON, AffiliateFeesFromJSON, AffiliateRevenueFromJSON, EstimateGasRequestToJSON, InfoFromJSON, TxFromJSON, TxHistoryFromJSON, } from '../models/index.js';
+import { AccountFromJSON, EstimateGasRequestToJSON, InfoFromJSON, TxFromJSON, TxHistoryFromJSON, } from '../models/index.js';
 /**
  *
  */
@@ -65,60 +65,6 @@ export class V1Api extends runtime.BaseAPI {
         const response = await this.getAccountRaw(requestParameters, initOverrides);
         return await response.value();
     }
-    /**
-     * Get ss affiliate fee history.
-     */
-    async getAffiliateFeesRaw(requestParameters, initOverrides) {
-        const queryParameters = {};
-        if (requestParameters.start !== undefined) {
-            queryParameters['start'] = requestParameters.start;
-        }
-        if (requestParameters.end !== undefined) {
-            queryParameters['end'] = requestParameters.end;
-        }
-        const headerParameters = {};
-        const response = await this.request({
-            path: `/api/v1/affiliate/fees`,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => AffiliateFeesFromJSON(jsonValue));
-    }
-    /**
-     * Get ss affiliate fee history.
-     */
-    async getAffiliateFees(requestParameters = {}, initOverrides) {
-        const response = await this.getAffiliateFeesRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
-    /**
-     * Get total ss affiliate revenue earned.
-     */
-    async getAffiliateRevenueRaw(requestParameters, initOverrides) {
-        const queryParameters = {};
-        if (requestParameters.start !== undefined) {
-            queryParameters['start'] = requestParameters.start;
-        }
-        if (requestParameters.end !== undefined) {
-            queryParameters['end'] = requestParameters.end;
-        }
-        const headerParameters = {};
-        const response = await this.request({
-            path: `/api/v1/affiliate/revenue`,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => AffiliateRevenueFromJSON(jsonValue));
-    }
-    /**
-     * Get total ss affiliate revenue earned.
-     */
-    async getAffiliateRevenue(requestParameters = {}, initOverrides) {
-        const response = await this.getAffiliateRevenueRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
     /**
      * Get information about the running coinstack.
      */

package/dist/esm/generated/thorchain/models/index.d.ts

@@ -1,7 +1,4 @@
 export * from './Account.js';
-export * from './AffiliateFee.js';
-export * from './AffiliateFees.js';
-export * from './AffiliateRevenue.js';
 export * from './ApiError.js';
 export * from './Attribute.js';
 export * from './BadRequestError.js';

package/dist/esm/generated/thorchain/models/index.js

@@ -2,9 +2,6 @@
 /* tslint:disable */
 /* eslint-disable */
 export * from './Account.js';
-export * from './AffiliateFee.js';
-export * from './AffiliateFees.js';
-export * from './AffiliateRevenue.js';
 export * from './ApiError.js';
 export * from './Attribute.js';
 export * from './BadRequestError.js';

package/dist/esm/generated/zcash/models/Address.d.ts

@@ -27,6 +27,13 @@ export interface Address {
      * @memberof Address
      */
     pubkey: string;
+    /**
+     * BIP44 derivation path for the address (e.g. `m/84'/0'/0'/0/3`).
+     * Present only for xpub-derived addresses.
+     * @type {string}
+     * @memberof Address
+     */
+    path?: string;
 }
 /**
  * Check if a given object implements the Address interface.

package/dist/esm/generated/zcash/models/Address.js

@@ -12,6 +12,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { exists } from '../runtime.js';
 /**
  * Check if a given object implements the Address interface.
  */
@@ -31,6 +32,7 @@ export function AddressFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'balance': json['balance'],
         'pubkey': json['pubkey'],
+        'path': !exists(json, 'path') ? undefined : json['path'],
     };
 }
 export function AddressToJSON(value) {
@@ -43,5 +45,6 @@ export function AddressToJSON(value) {
     return {
         'balance': value.balance,
         'pubkey': value.pubkey,
+        'path': value.path,
     };
 }

package/dist/esm/solana/parser/__tests__/solana.test.js

@@ -14,9 +14,11 @@ vi.mock('../../../generated/solana', async (importActual) => {
     const actual = await importActual();
     return {
         ...actual,
-        V1Api: vi.fn().mockImplementation(() => ({
-            getToken: getTokenMock,
-        })),
+        V1Api: vi.fn().mockImplementation(function () {
+            return {
+                getToken: getTokenMock,
+            };
+        }),
     };
 });
 const txParser = new TransactionParser({

package/dist/esm/solana/parser/index.js

@@ -40,6 +40,7 @@ export class TransactionParser {
             chainId: this.chainId,
             // all transactions from unchained are finalized with at least 1 confirmation (unused throughout web)
             confirmations: 1,
+            data: parserResult?.data,
             status: this.getStatus(tx),
             trade: parserResult?.trade,
             transfers: parserResult?.transfers ?? [],

package/dist/esm/solana/parser/thorchain.d.ts

@@ -0,0 +1,9 @@
+import type { SubParser, Tx, TxSpecific } from './types.js';
+export type ParserArgs = {
+    midgardUrl: string;
+};
+export declare class Parser implements SubParser<Tx> {
+    private readonly parser;
+    constructor(args: ParserArgs);
+    parse(tx: Tx): Promise<TxSpecific | undefined>;
+}

package/dist/esm/solana/parser/thorchain.js

@@ -0,0 +1,24 @@
+import base58 from 'bs58';
+import * as thorchain from '../../parser/thorchain.js';
+const MEMO_PROGRAM_ID = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';
+export class Parser {
+    parser;
+    constructor(args) {
+        this.parser = new thorchain.Parser({ midgardUrl: args.midgardUrl });
+    }
+    async parse(tx) {
+        const memoInstruction = tx.instructions.find(ix => ix.programId === MEMO_PROGRAM_ID);
+        if (!memoInstruction)
+            return;
+        try {
+            const memo = Buffer.from(base58.decode(memoInstruction.data)).toString('utf8');
+            if (!memo)
+                return;
+            return await this.parser.parse(memo, tx.txid);
+        }
+        catch (err) {
+            console.error('Failed to decode or parse Solana THORChain memo', err);
+            return undefined;
+        }
+    }
+}

package/dist/esm/solana/parser/types.d.ts

@@ -1,10 +1,13 @@
 import type * as solana from '../../generated/solana/index.js';
+import type * as thorchain from '../../parser/thorchain.js';
 import type { StandardTx } from '../../types.js';
 export * from '../../generated/solana/index.js';
 export type Tx = solana.Tx;
+export type TxMetadata = thorchain.TxMetadata;
 export interface ParsedTx extends StandardTx {
+    data?: TxMetadata;
 }
-export type TxSpecific = Partial<Pick<ParsedTx, 'trade' | 'transfers'>>;
+export type TxSpecific = Partial<Pick<ParsedTx, 'data' | 'trade' | 'transfers'>>;
 export interface SubParser<T extends Tx, U = TxSpecific> {
     parse(tx: T, address: string): Promise<U | undefined>;
 }

package/dist/esm/tron/__tests__/api.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tron/__tests__/api.test.js

@@ -0,0 +1,298 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { getCallerEnergy, TronApi } from '../api.js';
+const successResponse = {
+    result: { result: true },
+    energy_used: 64285,
+    energy_penalty: 49635,
+    constant_result: ['0000000000000000000000000000000000000000000000000000000000000000'],
+    transaction: { ret: [{}] },
+};
+// A reverted simulation still reports result.result: true - the failure is only visible on
+// transaction.ret and the message
+const revertResponse = {
+    result: { result: true, message: 'REVERT opcode executed' },
+    energy_used: 7896,
+    energy_penalty: 6079,
+    constant_result: [''],
+    transaction: { ret: [{ ret: 'FAILED' }] },
+};
+describe('TronApi', () => {
+    const api = new TronApi({ rpcUrl: 'https://tron.example' });
+    beforeEach(() => {
+        vi.spyOn(api, 'getChainPrices').mockResolvedValue({
+            bandwidthPrice: 1000,
+            energyPrice: 100,
+            memoFee: 1_000_000,
+        });
+        vi.spyOn(api, 'getContractEnergyShare').mockResolvedValue({
+            callerPercent: 100,
+            originEnergyLimit: 0,
+            originEnergyAvailable: 0,
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    describe('estimateContractCallFee', () => {
+        const params = {
+            contractAddress: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K',
+            from: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
+            data: '0x2213bc0b',
+        };
+        it('prices a successful simulation at energy_used * energyPrice', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
+            expect(await api.estimateContractCallFee(params)).toBe('6428500');
+        });
+        it('prices the caller in full when the share lookup fails', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
+            vi.mocked(api.getContractEnergyShare).mockRejectedValue(new Error('429'));
+            expect(await api.estimateContractCallFee(params)).toBe('6428500');
+        });
+        it('fails instead when the caller requires the share', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
+            vi.mocked(api.getContractEnergyShare).mockRejectedValue(new Error('429'));
+            await expect(api.estimateContractCallFee({ ...params, requireEnergyShare: true })).rejects.toThrow('429');
+        });
+        it('bills the caller only their share when the deployer covers the rest', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => successResponse }));
+            vi.mocked(api.getContractEnergyShare).mockResolvedValue({
+                callerPercent: 5,
+                originEnergyLimit: 10_000_000,
+                originEnergyAvailable: 5_000_000,
+            });
+            // 64285 - floor(64285 * 0.95) = 3215
+            expect(await api.estimateContractCallFee(params)).toBe('321500');
+        });
+        it('throws on a reverted simulation rather than trusting the partial energy', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => revertResponse }));
+            await expect(api.estimateContractCallFee(params)).rejects.toThrow('REVERT opcode executed');
+        });
+        it('reports a failed request as such rather than as a revert', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429, json: () => ({}) }));
+            await expect(api.estimateContractCallFee(params)).rejects.toThrow('request failed: 429');
+        });
+    });
+    describe('getCallerEnergy', () => {
+        it('charges the caller in full when the contract sets no deployer share', () => {
+            const share = {
+                callerPercent: 100,
+                originEnergyLimit: 0,
+                originEnergyAvailable: 0,
+            };
+            expect(getCallerEnergy(901_682, share)).toBe(901_682);
+        });
+        it('charges the caller their percent when the deployer has the energy staked', () => {
+            const share = {
+                callerPercent: 5,
+                originEnergyLimit: 10_000_000,
+                originEnergyAvailable: 5_000_000,
+            };
+            expect(getCallerEnergy(901_682, share)).toBe(45_085);
+        });
+        it('charges the caller in full when the deployer has nothing staked', () => {
+            const share = {
+                callerPercent: 30,
+                originEnergyLimit: 10_000_000,
+                originEnergyAvailable: 0,
+            };
+            expect(getCallerEnergy(130_285, share)).toBe(130_285);
+        });
+        it('caps the deployer share at their per-call limit', () => {
+            const share = {
+                callerPercent: 0,
+                originEnergyLimit: 100_000,
+                originEnergyAvailable: 5_000_000,
+            };
+            expect(getCallerEnergy(300_000, share)).toBe(200_000);
+        });
+        it('caps the deployer share at what they have left', () => {
+            const share = {
+                callerPercent: 0,
+                originEnergyLimit: 10_000_000,
+                originEnergyAvailable: 40_000,
+            };
+            expect(getCallerEnergy(300_000, share)).toBe(260_000);
+        });
+    });
+    describe('getContractEnergyShare', () => {
+        const contractResponse = {
+            consume_user_resource_percent: 5,
+            origin_energy_limit: 10_000_000,
+            origin_address: 'TDeployer',
+        };
+        const resourceResponse = { EnergyLimit: 6_000_000, EnergyUsed: 1_000_000 };
+        const respond = (...bodies) => {
+            const fetchMock = vi.fn();
+            bodies.forEach(body => fetchMock.mockResolvedValueOnce({ ok: true, json: () => body }));
+            vi.stubGlobal('fetch', fetchMock);
+            return fetchMock;
+        };
+        // the contract record is cached per instance, so each case gets its own
+        const freshApi = () => new TronApi({ rpcUrl: 'https://tron.example' });
+        it('reads the caller percent, per-call limit and the unspent deployer energy', async () => {
+            respond(contractResponse, resourceResponse);
+            expect(await freshApi().getContractEnergyShare('TRouter')).toEqual({
+                callerPercent: 5,
+                originEnergyLimit: 10_000_000,
+                originEnergyAvailable: 5_000_000,
+            });
+        });
+        it('reads an omitted percent as the deployer paying everything', async () => {
+            respond({ origin_energy_limit: 10_000_000, origin_address: 'TDeployer' }, resourceResponse);
+            expect(await freshApi().getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 0 });
+        });
+        it('reads an omitted per-call limit as the creator default', async () => {
+            respond({ consume_user_resource_percent: 5, origin_address: 'TDeployer' }, resourceResponse);
+            expect(await freshApi().getContractEnergyShare('TRouter')).toMatchObject({
+                originEnergyLimit: 10_000_000,
+            });
+        });
+        it('reads a plain address as a call the caller pays in full without a resource lookup', async () => {
+            const fetchMock = respond({});
+            expect(await freshApi().getContractEnergyShare('TPlain')).toEqual({
+                callerPercent: 100,
+                originEnergyLimit: 0,
+                originEnergyAvailable: 0,
+            });
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+        });
+        it('re-reads an empty body rather than caching it as a plain address', async () => {
+            const fetchMock = respond({}, contractResponse, resourceResponse);
+            const api = freshApi();
+            await api.getContractEnergyShare('TRouter');
+            expect(await api.getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 5 });
+            expect(fetchMock).toHaveBeenCalledTimes(3);
+        });
+        it('rejects a failed lookup rather than guessing the split', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429 }));
+            await expect(freshApi().getContractEnergyShare('TRouter')).rejects.toThrow('429');
+        });
+        it('does not cache an error body the node returns with a 200', async () => {
+            const fetchMock = respond({ Error: 'class org.tron.core.exception' }, contractResponse, resourceResponse);
+            const api = freshApi();
+            await expect(api.getContractEnergyShare('TRouter')).rejects.toThrow('getcontract failed');
+            expect(await api.getContractEnergyShare('TRouter')).toMatchObject({ callerPercent: 5 });
+            expect(fetchMock).toHaveBeenCalledTimes(3);
+        });
+        it('reads the contract once and the deployer energy once per refresh window', async () => {
+            vi.useFakeTimers();
+            const fetchMock = respond(contractResponse, resourceResponse, resourceResponse);
+            const api = freshApi();
+            await api.getContractEnergyShare('TRouter');
+            await api.getContractEnergyShare('TRouter');
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+            vi.advanceTimersByTime(16_000);
+            await api.getContractEnergyShare('TRouter');
+            expect(fetchMock).toHaveBeenCalledTimes(3);
+            const contractReads = fetchMock.mock.calls.filter(([url]) => String(url).endsWith('/wallet/getcontract'));
+            expect(contractReads).toHaveLength(1);
+            vi.useRealTimers();
+        });
+        it('re-reads the contract after a minute, since its split can change', async () => {
+            vi.useFakeTimers();
+            const fetchMock = respond(contractResponse, resourceResponse, contractResponse, resourceResponse);
+            const api = freshApi();
+            await api.getContractEnergyShare('TRouter');
+            vi.advanceTimersByTime(61_000);
+            await api.getContractEnergyShare('TRouter');
+            const contractReads = fetchMock.mock.calls.filter(([url]) => String(url).endsWith('/wallet/getcontract'));
+            expect(contractReads).toHaveLength(2);
+            vi.useRealTimers();
+        });
+    });
+    describe('getChainPrices', () => {
+        it('reads the energy, bandwidth and memo parameters', async () => {
+            vi.restoreAllMocks();
+            const tronWeb = api.getTronWeb();
+            vi.spyOn(tronWeb.trx, 'getChainParameters').mockResolvedValue([
+                { key: 'getTransactionFee', value: 1000 },
+                { key: 'getEnergyFee', value: 100 },
+                { key: 'getMemoFee', value: 1_000_000 },
+            ]);
+            expect(await api.getChainPrices()).toEqual({
+                bandwidthPrice: 1000,
+                energyPrice: 100,
+                memoFee: 1_000_000,
+            });
+        });
+        it('throws rather than defaulting when the node is unreachable', async () => {
+            vi.restoreAllMocks();
+            const tronWeb = api.getTronWeb();
+            vi.spyOn(tronWeb.trx, 'getChainParameters').mockRejectedValue(new Error('ECONNREFUSED'));
+            await expect(api.getChainPrices()).rejects.toThrow('ECONNREFUSED');
+        });
+    });
+    describe('getTrc20Balance', () => {
+        it('reads balanceOf(address) with a single constant call', async () => {
+            const tronWeb = api.getTronWeb();
+            const trigger = vi
+                .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
+                .mockResolvedValue({
+                result: { result: true },
+                constant_result: ['00000000000000000000000000000000000000000000000000000000028e6fb0'],
+            });
+            const actual = await api.getTrc20Balance({
+                contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
+                address: 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc',
+            });
+            expect(actual).toBe('42889136');
+            expect(trigger).toHaveBeenCalledWith('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t', 'balanceOf(address)', {}, [{ type: 'address', value: 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc' }], 'TE6oHVdTbcp1Q9XBYx5VzjWbZEg3t3Jrnc');
+        });
+    });
+    describe('getTrc20Allowance', () => {
+        it('reads allowance(owner, spender) with a single constant call', async () => {
+            const tronWeb = api.getTronWeb();
+            const trigger = vi
+                .spyOn(tronWeb.transactionBuilder, 'triggerConstantContract')
+                .mockResolvedValue({
+                result: { result: true },
+                constant_result: ['000000000000000000000000000000000000000000000000000000000000007b'],
+            });
+            const actual = await api.getTrc20Allowance({
+                contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
+                owner: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
+                spender: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K',
+            });
+            expect(actual).toBe('123');
+            expect(trigger).toHaveBeenCalledWith('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t', 'allowance(address,address)', {}, [
+                { type: 'address', value: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N' },
+                { type: 'address', value: 'TAfbit1ENsRmtZbPQfYU3srURpfYuWYS7K' },
+            ], 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N');
+        });
+    });
+    describe('isAccountActivated', () => {
+        it('is true for an account the node knows', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => ({ address: '41abc', balance: 1 }) }));
+            expect(await api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).toBe(true);
+        });
+        it('is false for a fresh address', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: () => ({}) }));
+            expect(await api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).toBe(false);
+        });
+        it('throws on an error response rather than reading it as not activated', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 429, json: () => ({ Error: 'throttled' }) }));
+            await expect(api.isAccountActivated('TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N')).rejects.toThrow('429');
+        });
+    });
+    describe('estimateTrc20TransferFee', () => {
+        const params = {
+            contractAddress: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
+            from: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
+            to: 'TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N',
+            amount: '1',
+        };
+        const stubTriggerConstantContract = (response) => {
+            const tronWeb = api.getTronWeb();
+            vi.spyOn(tronWeb.transactionBuilder, 'triggerConstantContract').mockResolvedValue(response);
+        };
+        it('prices a successful simulation at energy_used * energyPrice', async () => {
+            stubTriggerConstantContract(successResponse);
+            expect(await api.estimateTrc20TransferFee(params)).toBe('6428500');
+        });
+        it('throws on a reverted simulation rather than trusting the partial energy', async () => {
+            stubTriggerConstantContract(revertResponse);
+            await expect(api.estimateTrc20TransferFee(params)).rejects.toThrow('REVERT opcode executed');
+        });
+    });
+});