Add getAccountResources method to Wallet class

[Copilot]

Adds getAccountResources() method to Wallet class for querying account resources from the WP API endpoint.

Changes

• Interface (iWallet.ts): Added GetAccountResourcesOptions interface and method signature to IWallet interface
• Implementation (wallet.ts): Implemented method with options object pattern, array validation and query parameter handling in Wallet class
• Tests (wallet/getAccountResources.ts): Added unit tests covering success paths and error cases

Method Signature

async getAccountResources(params: GetAccountResourcesOptions): Promise<any>

Where GetAccountResourcesOptions is defined as:

export interface GetAccountResourcesOptions {
  addresses: string[];
  destinationAddress?: string;
}

Calls GET /accountResources with addresses as a required parameter and optional destinationAddress for computing resource deficits needed for an asset transfer.

Usage

// Access via wallet instance
const resources = await wallet.getAccountResources({ 
  addresses: ['addr1', 'addr2'] 
});

// Query with destination address to get resource deficit for a token transfer
const resources = await wallet.getAccountResources({ 
  addresses: ['TWpHQPy2CBwJ5opNF1ugRY357vMDPNLEGK'],
  destinationAddress: 'TUXzc3sUuTqNDeKCbhiKtcVUfSvgTtRpzz'
});

Example Output

Running against a testnet USDT wallet (ttrx:usdt):

{
  "resources": [
    {
      "address": "TWpHQPy2CBwJ5opNF1ugRY357vMDPNLEGK",
      "free_bandwidth_available": 600,
      "free_bandwidth_used": 0,
      "staked_bandwidth_available": 0,
      "staked_bandwidth_used": 0,
      "energy_available": 0,
      "energy_used": 0,
      "resourceDeficitForAssetTransfer": {
        "bandwidthDeficit": 0,
        "bandwidthSunRequired": "0",
        "energyDeficit": 28045,
        "energySunRequired": "1993"
      },
      "maxResourcesDelegatable": {
        "bandwidthWeight": "0",
        "energyWeight": "0"
      }
    }
  ],
  "failedAddresses": []
}

Key fields explained:

• free_bandwidth_available / staked_bandwidth_available: Bandwidth from free daily allocation and TRX staking respectively.
• energy_available: Energy the address currently has (from staking or delegation).
• resourceDeficitForAssetTransfer: The shortfall in bandwidth and energy needed for a token transfer to the destination address. Here the address needs 28,045 energy (costing 1,993 SUN ≈ 0.001993 TRX) to perform a USDT transfer, but has no bandwidth deficit.
• maxResourcesDelegatable: The maximum bandwidth/energy weight this address can delegate to others (zero here since nothing is staked).

[bhavidhingra]

@copilot We have to change the implementation a bit, this operation will not belong to a wallet. It is agnostic of a wallet.

[Copilot]

@copilot We have to change the implementation a bit, this operation will not belong to a wallet. It is agnostic of a wallet.

Moved the method from Wallet class to BaseCoin class since this operation is wallet-agnostic. The method now works at the coin level and can be accessed via coin.getAccountResources(addresses, assetName) instead of wallet.getAccountResources(). Changes in commit 215fa80.

[bhavidhingra]

@copilot Sorry, we have to pivot back to using the wallet specific API. Please revert back to using it as was done earlier.

[Copilot]

@copilot Sorry, we have to pivot back to using the wallet specific API. Please revert back to using it as was done earlier.

Reverted back to Wallet class implementation with assetName parameter. The method is now in the Wallet class as originally implemented. Changes in commit bce0ac4.

[ravibitgo]

can we type the response instead of any?

[bhavidhingra]

done