@defillama/sdk 5.0.236 → 5.0.240

package/build/chains/svm.d.ts

@@ -1,340 +0,0 @@
-/** Built-in endpoints, overridable with `<CHAIN>_RPC` (also `SDK_` / `LLAMA_SDK_` prefixed). */
-export declare const DEFAULT_ENDPOINTS: Record<string, string>;
-export declare const svmChains: string[];
-export declare function isSvmChain(chain: string): boolean;
-export interface ChainOptions {
-    /** chain key, default 'solana' */
-    chain?: string;
-}
-export interface EndpointOptions extends ChainOptions {
-    /** solana only: prefer `SOLANA_RPC_CLIENT` when set (mirrors adapters' getConnection) */
-    isClient?: boolean;
-}
-/**
- * Endpoint list for a chain: `<CHAIN>_RPC` env wins, then `DEFAULT_ENDPOINTS`.
- * For solana with `isClient`, `SOLANA_RPC_CLIENT` is checked first.
- */
-export declare function getEndpoints({ chain, isClient }?: EndpointOptions): string[];
-export declare function getEndpoint(options?: EndpointOptions): string;
-export declare const TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
-export declare const TOKEN_2022_PROGRAM_ID = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
-export declare const ASSOCIATED_TOKEN_PROGRAM_ID = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
-export declare const STAKE_PROGRAM_ID = "Stake11111111111111111111111111111111111111";
-export declare const SYSTEM_PROGRAM_ID = "11111111111111111111111111111111";
-export declare const SYSVAR_RENT_ID = "SysvarRent111111111111111111111111111111111";
-export declare const MINT_ACCOUNT_SIZE = 82;
-export declare const TOKEN_ACCOUNT_SIZE = 165;
-export declare const LAMPORTS_PER_SOL = 1000000000;
-/** Bitcoin-style base58 (leading zero bytes become leading '1's). */
-export declare function base58Encode(bytes: Uint8Array | Buffer): string;
-export declare function base58Decode(str: string): Uint8Array;
-export declare function isValidPublicKey(str: any): boolean;
-/** Little-endian u64 -> bigint, works on any Uint8Array (not only Buffer). */
-export declare function readBigUInt64LE(buffer: Uint8Array, offset?: number): bigint;
-/**
- * Fixed point I80F48 (signed i128, 48 fractional bits) -> number.
- * Accepts a bigint / decimal string, `{ val }` / `{ value }` wrappers (anchor BN
- * style) or the 16 little-endian bytes of the raw i128.
- */
-export declare function i80f48ToNumber(i80f48: {
-    val?: bigint | string | number[] | Uint8Array;
-    value?: any;
-} | bigint | string | number[] | Uint8Array): number;
-/** Little-endian I80F48 at `offset` (marginfi WrappedI80F48). */
-export declare function readI80F48(buf: Buffer, offset: number): number;
-export interface MintAccount {
-    mintAuthority: string | null;
-    supply: string;
-    decimals: number;
-    isInitialized: boolean;
-    freezeAuthority: string | null;
-}
-export interface TokenAccount {
-    mint: string;
-    owner: string;
-    amount: string;
-    delegate: string | null;
-    /** 0 uninitialized, 1 initialized, 2 frozen */
-    state: number;
-    isNative: string | null;
-    delegatedAmount: string;
-    closeAuthority: string | null;
-}
-/** Decode an SPL / Token-2022 mint account (first 82 bytes; extensions are ignored). */
-export declare function decodeMintAccount(buf: Buffer | Uint8Array): MintAccount;
-/** Decode an SPL / Token-2022 token account (first 165 bytes; extensions are ignored). */
-export declare function decodeTokenAccount(buf: Buffer | Uint8Array): TokenAccount;
-/**
- * Currently-effective UI multiplier of a Token-2022 mint with the ScaledUiAmount
- * extension, or 1 for a classic SPL mint / a mint without this extension.
- */
-export declare function readScaledUiMultiplier(data: Buffer, nowSeconds?: number): number;
-/** SPL stake pool: `total_lamports` u64 at offset 258, `pool_token_supply` u64 at 266. */
-export declare function decodeStakePool(buf: Buffer): {
-    totalLamports: string;
-    poolTokenSupply: string;
-};
-/** Read the 32-byte pubkey at `offset` of a base64 encoded account payload. */
-export declare function extractPubkey(base64Data: string, offset: number): string;
-/**
- * True when the 32 bytes decompress to a point on the ed25519 curve
- * (curve25519-dalek `CompressedEdwardsY::decompress` semantics). A PDA must be
- * off-curve so it can never have a private key.
- */
-export declare function isOnCurve(pubkey: string | Uint8Array | Buffer): boolean;
-/** True when PDA derivation is delegated to an installed `@solana/web3.js`. */
-export declare function usesWeb3js(): boolean;
-/** sha256(seeds || programId || "ProgramDerivedAddress"); throws when the result is on-curve. */
-export declare function createProgramAddress(seeds: (Buffer | Uint8Array | string)[], programId: string, bump?: number): string;
-/** Find the first off-curve address for `seeds`, walking bump 255 -> 0. */
-export declare function findProgramAddress(seeds: (Buffer | Uint8Array | string)[], programId: string): [string, number];
-export declare function getAssociatedTokenAddress({ mint, owner, programId, associatedTokenProgramId }: {
-    mint: string;
-    owner: string;
-    programId?: string;
-    associatedTokenProgramId?: string;
-}): string;
-export type Commitment = 'processed' | 'confirmed' | 'finalized';
-export type Encoding = 'base64' | 'base58' | 'base64+zstd' | 'jsonParsed';
-export interface AccountInfo<T = any> {
-    lamports: number;
-    owner: string;
-    /** `[payload, encoding]` for binary encodings, an object for `jsonParsed` */
-    data: T;
-    executable: boolean;
-    rentEpoch: number;
-    space?: number;
-}
-export interface CallOptions extends ChainOptions {
-    method: string;
-    params?: any[];
-    /** appended as `{ commitment }` to the last params object when set */
-    commitment?: Commitment;
-    timeout?: number;
-    retries?: number;
-}
-/** Raw JSON-RPC call against the chain's endpoints (rate limited per chain, retried). */
-export declare function call({ chain, method, params, commitment, timeout, retries }: CallOptions): Promise<any>;
-export declare function getSlot({ chain, commitment }?: ChainOptions & {
-    commitment?: Commitment;
-}): Promise<number>;
-export declare function getBlockTime({ chain, slot }: ChainOptions & {
-    slot: number;
-}): Promise<number | null>;
-export declare function getBlockHeight({ chain, commitment }?: ChainOptions & {
-    commitment?: Commitment;
-}): Promise<number>;
-/** Latest slot and its block time (walks back over skipped slots without a time). */
-export declare function getLatestBlock({ chain, commitment }?: ChainOptions & {
-    commitment?: Commitment;
-}): Promise<{
-    number: number;
-    timestamp: number;
-}>;
-export declare function getEpochInfo({ chain, commitment }?: ChainOptions & {
-    commitment?: Commitment;
-}): Promise<{
-    absoluteSlot: number;
-    blockHeight: number;
-    epoch: number;
-    slotIndex: number;
-    slotsInEpoch: number;
-    transactionCount?: number;
-}>;
-/** Lamport balance of a single account. */
-export declare function getBalance({ chain, account, commitment }: ChainOptions & {
-    account: string;
-    commitment?: Commitment;
-}): Promise<number>;
-/** Lamport balances of many accounts (batched `getMultipleAccounts`, 0 for missing accounts). */
-export declare function getBalances({ chain, accounts, commitment }: ChainOptions & {
-    accounts: string[];
-    commitment?: Commitment;
-}): Promise<number[]>;
-export declare function getAccountInfo({ chain, account, encoding, commitment, dataSlice }: ChainOptions & {
-    account: string;
-    encoding?: Encoding;
-    commitment?: Commitment;
-    dataSlice?: {
-        offset: number;
-        length: number;
-    };
-}): Promise<AccountInfo | null>;
-/** Base64 payload of one account as a Buffer, or null when it does not exist. */
-export declare function getAccountBuffer({ chain, account, commitment }: ChainOptions & {
-    account: string;
-    commitment?: Commitment;
-}): Promise<Buffer | null>;
-export interface GetAccountsOptions extends ChainOptions {
-    accounts: string[];
-    encoding?: Encoding;
-    commitment?: Commitment;
-    dataSlice?: {
-        offset: number;
-        length: number;
-    };
-    /** accounts per `getMultipleAccounts` call, default 99 (public node max is 100) */
-    chunkSize?: number;
-    /** parallel chunks, default 5 */
-    concurrency?: number;
-    /** ms to wait between chunks when `concurrency` is 1 */
-    sleepTime?: number;
-}
-/** Batched `getMultipleAccounts`; result is in input order with `null` for missing accounts. */
-export declare function getAccounts({ chain, accounts, encoding, commitment, dataSlice, chunkSize, concurrency, sleepTime }: GetAccountsOptions): Promise<(AccountInfo | null)[]>;
-/** Raw account payloads as Buffers, in input order (`null` for missing accounts). */
-export declare function getAccountBuffers(options: Omit<GetAccountsOptions, 'encoding'>): Promise<(Buffer | null)[]>;
-export interface ProgramAccount<T = any> {
-    pubkey: string;
-    account: AccountInfo<T>;
-}
-export interface GetProgramAccountsOptions extends ChainOptions {
-    programId: string;
-    filters?: ({
-        memcmp: {
-            offset: number;
-            bytes: string;
-            encoding?: string;
-        };
-    } | {
-        dataSize: number;
-    })[];
-    encoding?: Encoding;
-    dataSlice?: {
-        offset: number;
-        length: number;
-    };
-    commitment?: Commitment;
-    withContext?: boolean;
-    /** attempts, default 5 (public nodes rate limit this call) */
-    retries?: number;
-    timeout?: number;
-}
-export declare function getProgramAccounts(options: GetProgramAccountsOptions & {
-    withContext: true;
-}): Promise<{
-    context: {
-        slot: number;
-    };
-    value: ProgramAccount[];
-}>;
-export declare function getProgramAccounts(options: GetProgramAccountsOptions & {
-    withContext?: false;
-}): Promise<ProgramAccount[]>;
-export interface TokenSupply {
-    amount: string;
-    decimals: number;
-    uiAmount: number;
-    uiAmountString?: string;
-}
-export declare function getTokenSupply({ chain, token, commitment }: ChainOptions & {
-    token: string;
-    commitment?: Commitment;
-}): Promise<TokenSupply>;
-export interface GetTokenSuppliesOptions extends ChainOptions {
-    tokens: string[];
-    commitment?: Commitment;
-    chunkSize?: number;
-    concurrency?: number;
-    sleepTime?: number;
-    /** resolve failed / missing mints to `null` instead of throwing */
-    allowError?: boolean;
-}
-/**
- * Supplies for many mints in input order (one batched `getMultipleAccounts` +
- * `decodeMintAccount`, falling back to `getTokenSupply` for mints that fail to decode).
- */
-export declare function getTokenSupplies(options: GetTokenSuppliesOptions & {
-    allowError: true;
-}): Promise<(TokenSupply | null)[]>;
-export declare function getTokenSupplies(options: GetTokenSuppliesOptions & {
-    allowError?: false;
-}): Promise<TokenSupply[]>;
-export interface TokenAccountBalance {
-    mint: string;
-    amount: string;
-    owner: string;
-    /** only set with `withDecimals` */
-    decimals?: number;
-}
-export interface GetTokenAccountBalancesOptions extends ChainOptions {
-    tokenAccounts: string[];
-    /** return one entry per token account (input order) instead of a `{ [mint]: amount }` sum */
-    individual?: boolean;
-    /** skip missing / undecodable accounts instead of throwing (individual mode: `{ mint: 'error', amount: '0' }` placeholder keeps positions) */
-    allowError?: boolean;
-    /** individual mode: look up the mints once and fill `decimals` (one extra batched call) */
-    withDecimals?: boolean;
-    commitment?: Commitment;
-    chunkSize?: number;
-    concurrency?: number;
-    sleepTime?: number;
-}
-/** Token balances of the given token accounts, aggregated per mint (raw amount strings) or individually. */
-export declare function getTokenAccountBalances(options: GetTokenAccountBalancesOptions & {
-    individual: true;
-}): Promise<TokenAccountBalance[]>;
-export declare function getTokenAccountBalances(options: GetTokenAccountBalancesOptions & {
-    individual?: false;
-}): Promise<Record<string, string>>;
-export interface ParsedTokenAccount {
-    pubkey: string;
-    mint: string;
-    owner: string;
-    amount: string;
-    decimals: number;
-    uiAmount: number;
-    programId: string;
-    state?: string;
-}
-/**
- * Token accounts of `owner` (jsonParsed). With neither `mint` nor `programId`,
- * both the Token and Token-2022 programs are queried.
- */
-export declare function getTokenAccountsByOwner({ chain, owner, mint, programId, commitment }: ChainOptions & {
-    owner: string;
-    mint?: string;
-    programId?: string;
-    commitment?: Commitment;
-}): Promise<ParsedTokenAccount[]>;
-/** Raw token amount (string) of `mint` held by `owner`, summed over all of the owner's token accounts. */
-export declare function getTokenBalance({ chain, owner, mint, commitment }: ChainOptions & {
-    owner: string;
-    mint: string;
-    commitment?: Commitment;
-}): Promise<string>;
-export interface SignatureInfo {
-    signature: string;
-    slot: number;
-    blockTime: number | null;
-    err: any;
-    memo: string | null;
-    confirmationStatus?: string;
-}
-export declare function getSignaturesForAddress({ chain, address, before, until, limit, commitment }: ChainOptions & {
-    address: string;
-    before?: string;
-    until?: string;
-    limit?: number;
-    commitment?: Commitment;
-}): Promise<SignatureInfo[]>;
-export declare function getTransaction({ chain, signature, encoding, maxSupportedTransactionVersion, commitment }: ChainOptions & {
-    signature: string;
-    encoding?: 'json' | 'jsonParsed' | 'base64' | 'base58';
-    maxSupportedTransactionVersion?: number;
-    commitment?: Commitment;
-}): Promise<any>;
-/**
- * Lamports in all stake accounts whose stake authority (default, as in the
- * adapters helper) or withdraw authority is `address`.
- */
-export declare function getStakedSol({ chain, address, authority, commitment }: ChainOptions & {
-    address: string;
-    authority?: 'staker' | 'withdrawer';
-    commitment?: Commitment;
-}): Promise<number>;
-/** `total_lamports` of an SPL stake pool account (lamports, as number). */
-export declare function getSolBalanceFromStakePool({ chain, address, commitment }: ChainOptions & {
-    address: string;
-    commitment?: Commitment;
-}): Promise<number>;