@defillama/sdk 5.0.236 → 5.0.240

package/build/chains/tron.d.ts

@@ -1,45 +0,0 @@
-import { evmToTronAddress, tronToEvmAddress } from "../util/common";
-export { call, multiCall, getBalance, getBalances, unhexifyTarget, hexifyTarget } from "../abi/tron";
-export { evmToTronAddress, tronToEvmAddress };
-export declare const DEFAULT_WALLET_ENDPOINTS = "https://api.trongrid.io";
-export declare const DEFAULT_TRONSCAN_ENDPOINT = "https://apilist.tronscanapi.com";
-/** TronGrid style `wallet/*` REST endpoints, `TRON_WALLET_RPC` (comma separated) overrides */
-export declare function getWalletEndpoints(): string[];
-export declare function getTronscanEndpoint(): string;
-/** POST to a `wallet/*` endpoint (e.g. `wallet/getaccount`) with endpoint rotation */
-export declare function walletPost({ path, body }: {
-    path: string;
-    body?: any;
-}): Promise<any>;
-/** Raw account record from `wallet/getaccount` (base58 `T...` or hex `41...` address) */
-export declare function getAccount({ address }: {
-    address: string;
-}): Promise<any>;
-export declare function getAccountResource({ address }: {
-    address: string;
-}): Promise<any>;
-/**
- * TRX balance in SUN including frozen (v1 + v2) and delegated resources, as the
- * adapters helper did. Returns a string.
- */
-export declare function getTrxBalance({ address, includeFrozen }: {
-    address: string;
-    includeFrozen?: boolean;
-}): Promise<string>;
-/** Total votes received by a super representative candidate (tronscan) */
-export declare function getStakedTron({ address }: {
-    address: string;
-}): Promise<number>;
-export declare function getLatestBlock(): Promise<{
-    number: number;
-    timestamp: number;
-    hash: string;
-}>;
-export declare function getBlock({ number }: {
-    number: number;
-}): Promise<{
-    number: number;
-    timestamp: number;
-    hash: string;
-}>;
-export declare function isTronAddress(address: string): boolean;

package/build/chains/tron.js

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_TRONSCAN_ENDPOINT = exports.DEFAULT_WALLET_ENDPOINTS = exports.tronToEvmAddress = exports.evmToTronAddress = exports.hexifyTarget = exports.unhexifyTarget = exports.getBalances = exports.getBalance = exports.multiCall = exports.call = void 0;
-exports.getWalletEndpoints = getWalletEndpoints;
-exports.getTronscanEndpoint = getTronscanEndpoint;
-exports.walletPost = walletPost;
-exports.getAccount = getAccount;
-exports.getAccountResource = getAccountResource;
-exports.getTrxBalance = getTrxBalance;
-exports.getStakedTron = getStakedTron;
-exports.getLatestBlock = getLatestBlock;
-exports.getBlock = getBlock;
-exports.isTronAddress = isTronAddress;
-/**
- * Tron helpers that are not part of the EVM-style ABI path.
- *
- * The EVM-style contract calls (`call`, `multiCall`, `getBalance`) live in
- * `src/abi/tron.ts` and are re-exported here so `sdk.chains.tron` is the single
- * entry point.
- *
- * Replaces:
- * - DefiLlama-Adapters projects/helper/chain/tron.js (getStakedTron, getTrxBalance)
- */
-const env_1 = require("../util/env");
-const common_1 = require("../util/common");
-Object.defineProperty(exports, "evmToTronAddress", { enumerable: true, get: function () { return common_1.evmToTronAddress; } });
-Object.defineProperty(exports, "tronToEvmAddress", { enumerable: true, get: function () { return common_1.tronToEvmAddress; } });
-const rpc_1 = require("./rpc");
-var tron_1 = require("../abi/tron");
-Object.defineProperty(exports, "call", { enumerable: true, get: function () { return tron_1.call; } });
-Object.defineProperty(exports, "multiCall", { enumerable: true, get: function () { return tron_1.multiCall; } });
-Object.defineProperty(exports, "getBalance", { enumerable: true, get: function () { return tron_1.getBalance; } });
-Object.defineProperty(exports, "getBalances", { enumerable: true, get: function () { return tron_1.getBalances; } });
-Object.defineProperty(exports, "unhexifyTarget", { enumerable: true, get: function () { return tron_1.unhexifyTarget; } });
-Object.defineProperty(exports, "hexifyTarget", { enumerable: true, get: function () { return tron_1.hexifyTarget; } });
-exports.DEFAULT_WALLET_ENDPOINTS = 'https://api.trongrid.io';
-exports.DEFAULT_TRONSCAN_ENDPOINT = 'https://apilist.tronscanapi.com';
-/** TronGrid style `wallet/*` REST endpoints, `TRON_WALLET_RPC` (comma separated) overrides */
-function getWalletEndpoints() {
-    return (0, rpc_1.getEndpoints)('tron', exports.DEFAULT_WALLET_ENDPOINTS, { envKey: 'TRON_WALLET_RPC' });
-}
-function getTronscanEndpoint() {
-    return (0, rpc_1.getEndpoints)('tron', exports.DEFAULT_TRONSCAN_ENDPOINT, { envKey: 'TRONSCAN_API' })[0];
-}
-function walletHeaders() {
-    const headers = { 'Content-Type': 'application/json' };
-    const apiKey = (0, env_1.getEnvValue)('TRON_PRO_API_KEY');
-    if (apiKey)
-        headers['TRON-PRO-API-KEY'] = apiKey;
-    return headers;
-}
-function tronscanHeaders() {
-    const headers = {};
-    const apiKey = (0, env_1.getEnvValue)('TRONSCAN_API_KEY');
-    if (apiKey)
-        headers['TRON-PRO-API-KEY'] = apiKey;
-    return headers;
-}
-/** POST to a `wallet/*` endpoint (e.g. `wallet/getaccount`) with endpoint rotation */
-async function walletPost({ path, body = {} }) {
-    return (0, rpc_1.httpPost)(getWalletEndpoints(), body, { path, headers: walletHeaders() });
-}
-/** Raw account record from `wallet/getaccount` (base58 `T...` or hex `41...` address) */
-async function getAccount({ address }) {
-    return walletPost({ path: 'wallet/getaccount', body: { address, visible: !address.startsWith('41') } });
-}
-async function getAccountResource({ address }) {
-    return walletPost({ path: 'wallet/getaccountresource', body: { address, visible: !address.startsWith('41') } });
-}
-/**
- * TRX balance in SUN including frozen (v1 + v2) and delegated resources, as the
- * adapters helper did. Returns a string.
- */
-async function getTrxBalance({ address, includeFrozen = true }) {
-    var _a, _b, _c, _d, _e, _f;
-    const data = await getAccount({ address });
-    const free = Number((_a = data === null || data === void 0 ? void 0 : data.balance) !== null && _a !== void 0 ? _a : 0);
-    if (!includeFrozen)
-        return String(free);
-    const frozen = ((_b = data === null || data === void 0 ? void 0 : data.frozen) !== null && _b !== void 0 ? _b : []).reduce((t, i) => { var _a; return t + Number((_a = i.frozen_balance) !== null && _a !== void 0 ? _a : 0); }, 0);
-    const frozenV2 = ((_c = data === null || data === void 0 ? void 0 : data.frozenV2) !== null && _c !== void 0 ? _c : []).reduce((t, i) => { var _a; return t + Number((_a = i.amount) !== null && _a !== void 0 ? _a : 0); }, 0);
-    const delegatedBandwidth = Number((_d = data === null || data === void 0 ? void 0 : data.delegated_frozenV2_balance_for_bandwidth) !== null && _d !== void 0 ? _d : 0);
-    const delegatedEnergy = Number((_f = (_e = data === null || data === void 0 ? void 0 : data.account_resource) === null || _e === void 0 ? void 0 : _e.delegated_frozenV2_balance_for_energy) !== null && _f !== void 0 ? _f : 0);
-    return String(free + frozen + frozenV2 + delegatedBandwidth + delegatedEnergy);
-}
-/** Total votes received by a super representative candidate (tronscan) */
-async function getStakedTron({ address }) {
-    var _a;
-    const data = await (0, rpc_1.httpGet)(getTronscanEndpoint(), { path: 'api/vote', params: { candidate: address }, headers: tronscanHeaders() });
-    return Number((_a = data === null || data === void 0 ? void 0 : data.totalVotes) !== null && _a !== void 0 ? _a : 0);
-}
-async function getLatestBlock() {
-    const data = await walletPost({ path: 'wallet/getnowblock' });
-    return {
-        number: data.block_header.raw_data.number,
-        timestamp: Math.floor(data.block_header.raw_data.timestamp / 1000),
-        hash: data.blockID,
-    };
-}
-async function getBlock({ number }) {
-    const data = await walletPost({ path: 'wallet/getblockbynum', body: { num: number } });
-    return {
-        number: data.block_header.raw_data.number,
-        timestamp: Math.floor(data.block_header.raw_data.timestamp / 1000),
-        hash: data.blockID,
-    };
-}
-function isTronAddress(address) {
-    return /^T[1-9A-HJ-NP-Za-km-z]{33}$/.test(address) || /^41[0-9a-fA-F]{40}$/.test(address);
-}

package/build/chains/utxo.d.ts

@@ -1,202 +0,0 @@
-export interface UtxoChainConfig {
-    decimals: number;
-    /** explorer base urls in fallback order, overridable with `<CHAIN>_EXPLORER_API` */
-    endpoints: string[];
-    /** max parallel explorer requests, overridable with `<CHAIN>_RPC_CONCURRENCY` */
-    concurrency: number;
-    /** pause before every request (free-tier rate limits), applied inside the limiter */
-    sleepMs?: number;
-}
-export declare const CHAINS: Record<string, UtxoChainConfig>;
-export declare const utxoChains: string[];
-/** mempool.space base url, used for the timestamp -> block lookup (`BITCOIN_MEMPOOL_API`). */
-export declare const DEFAULT_MEMPOOL_API = "https://mempool.space/api";
-/** blockchain.info multiaddr endpoint for bulk bitcoin balances (`BITCOIN_MULTIADDR_API`). */
-export declare const DEFAULT_MULTIADDR_API = "https://blockchain.info/multiaddr";
-/** blockchain.info multiaddr accepts ~100 addresses per call */
-export declare const MULTIADDR_CHUNK_SIZE = 100;
-/** pause between multiaddr chunks (blockchain.info rate limit), as in the adapters helper */
-export declare const MULTIADDR_SLEEP_MS = 10000;
-/** bitcoin cache api accepts up to 700 addresses per call */
-export declare const CACHE_API_CHUNK_SIZE = 700;
-export declare function isUtxoChain(chain: any): boolean;
-/** Explorer base urls for `chain`: env `<CHAIN>_EXPLORER_API` wins, then `CHAINS[chain].endpoints`. */
-export declare function getEndpoints({ chain }?: {
-    chain?: string;
-}): string[];
-export type NumLike = string | number | bigint;
-export interface AddressStats {
-    address?: string;
-    /** confirmed balance in base units */
-    confirmed: string;
-    /** mempool (unconfirmed) delta in base units, may be negative */
-    unconfirmed: string;
-    /** confirmed + unconfirmed */
-    total: string;
-    /** confirmed tx count */
-    txCount: number;
-}
-export interface Utxo {
-    txid: string;
-    vout: number;
-    /** value in base units */
-    value: string;
-    status: {
-        confirmed: boolean;
-        block_height?: number;
-        block_hash?: string;
-        block_time?: number;
-    };
-}
-export interface BlockInfo {
-    /** block height */
-    number: number;
-    /** unix timestamp in seconds */
-    timestamp: number;
-    hash: string;
-}
-/**
- * Basic shape check for a bitcoin mainnet address: bech32 / bech32m (`bc1...`,
- * single case) or base58 P2PKH / P2SH (`1...` / `3...`). No checksum validation.
- */
-export declare function isBitcoinAddress(str: any): boolean;
-/** Coerce integer-like values (decimal / bigint / integer number / integer string) to BigInt. */
-export declare function toBigInt(value: NumLike | null | undefined): bigint;
-/**
- * Whole-coin amount (`'1.5'`, `1.5`, `'2e-3'`) -> base units as a decimal string,
- * using string arithmetic so 8-decimal values never go through float rounding.
- * Extra fractional digits are truncated.
- */
-export declare function toBaseUnits(value: NumLike, decimals: number): string;
-/** Base units -> whole coins as a JS number (`fromBaseUnits('150000000', 8) === 1.5`). */
-export declare function fromBaseUnits(raw: NumLike, decimals: number): number;
-/**
- * Parse an esplora `/address/{addr}` response (blockstream, mempool.space,
- * litecoinspace) into base-unit strings. `confirmed` is `chain_stats.funded - spent`,
- * matching the adapters' getBalanceNow and the coins server getBtcBalanceSats.
- */
-export declare function parseBlockstreamAddressStats(json: any): AddressStats;
-/**
- * Confirmed balance in base units from any of the supported explorer dialects.
- * Shape detection is ordered so ambiguous `balance` fields (coins vs base units)
- * are only reached for providers that report base units (blockbook v2, kaspa).
- */
-export declare function parseBalanceResponse(json: any, { address, decimals }: {
-    address: string;
-    decimals: number;
-}): string;
-export interface GetBalanceOptions {
-    chain?: string;
-    address: string;
-    /** attempts per endpoint before moving to the next one, default 2 */
-    retries?: number;
-    timeout?: number;
-}
-/**
- * Confirmed balance of `address` in base units. Tries every configured endpoint in
- * order (blockstream -> mempool.space -> blockbook for bitcoin) and throws only
- * when all of them fail.
- */
-export declare function getBalance({ chain, address, retries, timeout }: GetBalanceOptions): Promise<string>;
-export interface GetBalancesOptions {
-    chain?: string;
-    addresses: string[];
-    /** bitcoin only: skip blockchain.info multiaddr and go per address, default false */
-    skipMultiaddr?: boolean;
-    retries?: number;
-    timeout?: number;
-}
-/**
- * Confirmed balances of many addresses as `{ [address]: baseUnits }`. Bitcoin
- * batches through blockchain.info `multiaddr` (100 per call, 10s between chunks)
- * and falls back to per-address explorer lookups; other chains go per address
- * under the chain limiter.
- */
-export declare function getBalances({ chain, addresses, skipMultiaddr, retries, timeout }: GetBalancesOptions): Promise<Record<string, string>>;
-/** blockchain.info `multiaddr` base url (`BITCOIN_MULTIADDR_API` overrides). */
-export declare function getMultiaddrEndpoints(): string[];
-/**
- * Bitcoin balances via blockchain.info `multiaddr?active=a|b|c` in chunks of 100.
- * `final_balance` includes unconfirmed outputs, as in the adapters helper.
- */
-export declare function getBitcoinBalancesMultiaddr({ addresses, chunkSize, sleepMs }: {
-    addresses: string[];
-    chunkSize?: number;
-    sleepMs?: number;
-}): Promise<Record<string, string>>;
-/** `BITCOIN_CACHE_API` url when configured (bulk bitcoin balance cache used by the adapters). */
-export declare function getBitcoinCacheApi(): string | undefined;
-/**
- * Sum of bitcoin balances via the `BITCOIN_CACHE_API` bulk endpoint
- * (`POST { addresses, network: 'BTC' }` -> total sats, 700 addresses per call),
- * mirroring getCachedBitcoinBalances in the adapters. Throws when the env is not set.
- */
-export declare function getCachedBitcoinTotal({ addresses, chunkSize }: {
-    addresses: string[];
-    chunkSize?: number;
-}): Promise<string>;
-export interface GetTotalBalanceOptions extends GetBalancesOptions {
-    /** bitcoin only: use `BITCOIN_CACHE_API` when set and there are more than this many addresses, default 51 */
-    cacheThreshold?: number;
-    /** bitcoin only: throw instead of falling back when the cache api fails, default false (forced above 1000 addresses) */
-    forceCacheUse?: boolean;
-}
-/**
- * Sum of confirmed balances in base units. For bitcoin with `BITCOIN_CACHE_API`
- * set and more than `cacheThreshold` addresses the bulk cache is used first
- * (the adapters' `_sumTokensBlockchain` flow), then `getBalances` is summed.
- */
-export declare function getTotalBalance({ chain, addresses, cacheThreshold, forceCacheUse, ...rest }: GetTotalBalanceOptions): Promise<string>;
-/**
- * Unspent outputs of `address` (`/address/{addr}/utxo`), values as base-unit strings.
- * Blockstream answers 400 "Too many unspent outputs" for very large utxo sets
- * (e.g. the genesis address); use `getBalance` for those.
- */
-export declare function getUtxos({ chain, address }: {
-    chain?: string;
-    address: string;
-}): Promise<Utxo[]>;
-/**
- * One page of transactions for `address`: `/address/{addr}/txs` (up to 25 mempool
- * + 25 confirmed) or, with `lastSeenTxid`, `/address/{addr}/txs/chain/{txid}`
- * (next 25 confirmed). An empty array means no more pages.
- */
-export declare function getAddressTxs({ chain, address, lastSeenTxid }: {
-    chain?: string;
-    address: string;
-    lastSeenTxid?: string;
-}): Promise<any[]>;
-/**
- * Bitcoin balance of `address` at `timestamp` (unix seconds) in base units, ported
- * from the adapters' archive getBalance: for timestamps within the last 30 minutes
- * the current utxo set is filtered by `block_time`; otherwise every confirmed tx is
- * replayed (vout adds, vin.prevout subtracts) until the page list is exhausted.
- * Unconfirmed txs (no `block_time`) are ignored.
- */
-export declare function getBitcoinBalanceAt({ chain, address, timestamp, maxPages }: {
-    chain?: string;
-    address: string;
-    timestamp: number;
-    maxPages?: number;
-}): Promise<string>;
-/** Chain tip via `/blocks/tip/height` + `/block-height/{h}` + `/block/{hash}`. */
-export declare function getLatestBlock({ chain }?: {
-    chain?: string;
-}): Promise<BlockInfo>;
-/** Block by height (`/block-height/{h}` then `/block/{hash}`). */
-export declare function getBlock({ chain, height }: {
-    chain?: string;
-    height: number;
-}): Promise<BlockInfo>;
-/** mempool.space base urls (`BITCOIN_MEMPOOL_API` overrides; falls back to any configured mempool endpoint). */
-export declare function getMempoolEndpoints(): string[];
-/**
- * Latest block mined at or before `timestamp` (unix seconds). Bitcoin asks
- * mempool.space `/v1/mining/blocks/timestamp/{ts}` first (then walks back if the
- * returned block is newer than `timestamp`); otherwise / on failure a binary
- * search over `/block-height/{h}` is used.
- */
-export declare function getBlockAtTimestamp({ chain, timestamp }: {
-    chain?: string;
-    timestamp: number;
-}): Promise<BlockInfo>;