mnee/dist/index.d.ts

A simple package for interacting with the MNEE USD

import { MNEEBalance, MNEEConfig, SdkConfig, ParseTxResponse, SendMNEE, TransferResponse, TxHistoryResponse, AddressHistoryParams } from './mnee.types.js';
export * from './mnee.types.js';
export interface MneeInterface {
    config(): Promise<MNEEConfig | undefined>;
    balance(address: string): Promise<MNEEBalance>;
    balances(addresses: string[]): Promise<MNEEBalance[]>;
    validateMneeTx(rawtx: string, request?: SendMNEE[]): Promise<boolean>;
    transfer(request: SendMNEE[], wif: string): Promise<TransferResponse>;
    toAtomicAmount(amount: number): number;
    fromAtomicAmount(amount: number): number;
    recentTxHistory(address: string, fromScore?: number, limit?: number): Promise<TxHistoryResponse>;
    recentTxHistories(params: AddressHistoryParams[]): Promise<TxHistoryResponse[]>;
    parseTx(txid: string): Promise<ParseTxResponse>;
    parseTxFromRawTx(rawTxHex: string): Promise<ParseTxResponse>;
}
/**
 * Represents the Mnee class that provides methods to interact with the MNEE service.
 */
export default class Mnee implements MneeInterface {
    private service;
    constructor(config: SdkConfig);
    /**
     * Validates an MNEE transaction.
     *
     * @param rawtx - The raw transaction to validate.
     * @param request - An array of SendMNEE objects representing the transfer details. Use this parameter to validate the transaction against the specified transfer details. If it is not provided, it will only validate that the transaction is well-formed with the cosigner.
     * @returns A promise that resolves to a boolean indicating whether the transaction is valid.
     */
    validateMneeTx(rawtx: string, request?: SendMNEE[]): Promise<boolean>;
    /**
     * Converts a given amount to its atomic representation based on the specified number.
     *
     * @param amount - The amount to be converted.
     * @returns The atomic representation of the given amount.
     *
     * @example
     * ```typescript
     * toAtomicAmount(1.5); // 150000
     * ```
     */
    toAtomicAmount(amount: number): number;
    /**
     * Converts a given atomic amount to its human-readable representation.
     *
     * @param amount - The atomic amount to be converted.
     * @returns The human-readable representation of the given atomic amount.
     *
     * @example
     * ```typescript
     * fromAtomicAmount(150000); // 1.5
     * ```
     */
    fromAtomicAmount(amount: number): number;
    /**
     * Retrieves the configuration for the MNEE service.
     *
     * @returns {Promise<MNEEConfig | undefined>} A promise that resolves to the MNEE configuration object,
     * or undefined if the configuration could not be retrieved.
     */
    config(): Promise<MNEEConfig | undefined>;
    /**
     * Retrieves the balance for a given address.
     *
     * @param address - The address to retrieve the balance for.
     * @returns A promise that resolves to a `MNEEBalance` object containing the balance details.
     */
    balance(address: string): Promise<MNEEBalance>;
    /**
     * Retrieves the balances for multiple addresses.
     *
     * @param addresses - An array of addresses to retrieve the balances for.
     * @returns A promise that resolves to an array of `MNEEBalance` objects containing the balance details for each address.
     */
    balances(addresses: string[]): Promise<MNEEBalance[]>;
    /**
     * Transfers the specified MNEE tokens using the provided WIF (Wallet Import Format) key.
     *
     * @param {SendMNEE[]} request - An array of SendMNEE objects representing the transfer details.
     * @param {string} wif - The Wallet Import Format key used to authorize the transfer.
     * @returns {Promise<TransferResponse>} A promise that resolves to a TransferResponse object containing the result of the transfer.
     */
    transfer(request: SendMNEE[], wif: string): Promise<TransferResponse>;
    /**
     * Retrieves the recent transaction history for a given address.
     *
     * @param address - The address to retrieve the transaction history for.
     * @param fromScore - The starting score to retrieve the transaction history from.
     * @param limit - The maximum number of transactions to retrieve.
     * @returns A promise that resolves to a TxHistoryResponse object containing the transaction
     * history and the next score to retrieve additional transactions.
     */
    recentTxHistory(address: string, fromScore?: number, limit?: number): Promise<TxHistoryResponse>;
    /**
     * Retrieves the recent transaction histories for multiple addresses.
     *
     * @param params - An array of address parameters, each containing an address, optional fromScore, and optional limit.
     * @returns A promise that resolves to an array of TxHistoryResponse objects containing the transaction
     * history for each address with its own pagination state.
     */
    recentTxHistories(params: AddressHistoryParams[]): Promise<TxHistoryResponse[]>;
    /**
     * Parses a transaction based on the provided transaction ID.
     *
     * @param txid - The unique identifier of the transaction to be parsed.
     * @returns A promise that resolves to a `ParseTxResponse` containing the parsed transaction details.
     */
    parseTx(txid: string): Promise<ParseTxResponse>;
    /**
     * Parses a transaction from a raw transaction hex string.
     *
     * @param rawTxHex - The raw transaction hex string to be parsed.
     * @returns A promise that resolves to a `ParseTxResponse` containing the parsed transaction details.
     */
    parseTxFromRawTx(rawTxHex: string): Promise<ParseTxResponse>;
}