@broxus/js-bridge-essentials/dist/esm/models/token-root-alien-tvm/TokenRootAlienTvmUtils.js

Bridge JavaScript Essentials library

import { EmptyCell, getFullContractState } from '@broxus/js-core';
import { tokenRootAlienTvmContract } from '../../models/token-root-alien-tvm/contracts';
export class TokenRootAlienTvmUtils {
    /**
     * Get alien token meta by the given TVM-like token address
     *
     * - If request passed and `base_chainId` equal to target EVM network - it means token is alien
     * for TVM and native for target EVM network.
     * - If request failed, or passed, but `base_chainId` not equal to target EVM network - it
     * means token is native for TVM and alien for target EVM network
     *
     * @param {ProviderRpcClient} connection
     * @param {Address | string} tokenAddress
     * @param {string} payload
     * @param {FullContractState} [cachedState] - optional. Full contract state of the token root alien EVM contract
     */
    static async meta(connection, tokenAddress, payload, cachedState) {
        const state = cachedState ?? await getFullContractState(connection, tokenAddress);
        const result = await tokenRootAlienTvmContract(connection, tokenAddress)
            .methods.meta({ _payload: payload ?? EmptyCell, answerId: 0 })
            .call({ cachedState: state, responsible: true });
        return {
            baseChainId: result.base_chainId,
            baseNativeProxyWallet: result.base_native_proxy_wallet,
            baseToken: result.base_token,
            decimals: result.decimals,
            name: result.name,
            payload: result.payload,
            symbol: result.symbol,
        };
    }
}