UNPKG

@substrate/api-sidecar

Version:

REST service that makes it easy to interact with blockchain nodes built using Substrate's FRAME framework.

70 lines (69 loc) 3.71 kB
import { AccountsAssetsService } from '../../services/accounts'; import AbstractController from '../AbstractController'; /** * Get asset information for an address. * * Paths: * - `address`: The address to query * * Query: * - (Optional)`at`: Block at which to retrieve runtime version information at. Block * identifier, as the block height or block hash. Defaults to most recent block. * - (Optional) `useRcBlock`: When true, treats the `at` parameter as a relay chain block * to find corresponding Asset Hub blocks. Only supported for Asset Hub endpoints. * - (Optional for `/accounts/:address/asset-balances`)`assets` * - (Required for `/accounts/:address/asset-approvals)`assetId` The assetId associated * with the `AssetApproval`. * - (Required for `/accounts/:address/asset-approvals)`delegate` The delegate associated * with the `ApprovalKey` which is tied to a `Approval`. The `ApprovalKey` consists * of an `owner` which is the `address` path parameter, and a `delegate`. * * `/accounts/:address/asset-balances` * Returns: * - When using `useRcBlock=true`: An array of response objects, one for each Asset Hub block found * in the specified relay chain block. Returns empty array `[]` if no Asset Hub blocks found. * - When using `useRcBlock=false` or omitted: A single response object. * * Response object structure: * - `at`: Block number and hash at which the call was made. * - `assets`: An array of `AssetBalance` objects which have a AssetId attached to them * - `assetId`: The identifier of the asset. * - `balance`: The balance of the asset. * - `isFrozen`: Whether the asset is frozen for non-admin transfers. * - `isSufficient`: Whether a non-zero balance of this asset is a deposit of sufficient * value to account for the state bloat associated with its balance storage. If set to * `true`, then non-zero balances may be stored without a `consumer` reference (and thus * an ED in the Balances pallet or whatever else is used to control user-account state * growth). * - `rcBlockNumber`: The relay chain block number used for the query. Only present when `useRcBlock=true`. * - `ahTimestamp`: The Asset Hub block timestamp. Only present when `useRcBlock=true`. * * `/accounts/:address/asset-approvals` * Returns: * - When using `useRcBlock=true`: An array of response objects, one for each Asset Hub block found * in the specified relay chain block. Returns empty array `[]` if no Asset Hub blocks found. * - When using `useRcBlock=false` or omitted: A single response object. * * Response object structure: * - `at`: Block number and hash at which the call was made. * - `amount`: The amount of funds approved for the balance transfer from the owner * to some delegated target. * - `deposit`: The amount reserved on the owner's account to hold this item in storage. * - `rcBlockNumber`: The relay chain block number used for the query. Only present when `useRcBlock=true`. * - `ahTimestamp`: The Asset Hub block timestamp. Only present when `useRcBlock=true`. * * Substrate Reference: * - Assets Pallet: https://crates.parity.io/pallet_assets/index.html * - `AssetBalance`: https://crates.parity.io/pallet_assets/struct.AssetBalance.html * - `ApprovalKey`: https://crates.parity.io/pallet_assets/struct.ApprovalKey.html * - `Approval`: https://crates.parity.io/pallet_assets/struct.Approval.html * */ export default class AccountsAssetsController extends AbstractController<AccountsAssetsService> { static controllerName: string; static requiredPallets: string[][]; constructor(api: string); protected initRoutes(): void; private getAssetBalances; private getAssetApprovals; }