UNPKG

@solana/rpc-api

Version:

Defines all default Solana RPC methods as types

147 lines 7.51 kB
import type { Address } from '@solana/addresses'; import type { JsonParsedTokenAccount } from '@solana/rpc-parsed-types'; import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData, AccountInfoWithBase64EncodedZStdCompressedData, AccountInfoWithPubkey, Commitment, DataSlice, Slot, SolanaRpcResponse } from '@solana/rpc-types'; type TokenAccountInfoWithJsonData = Readonly<{ data: Readonly<{ parsed: { info: JsonParsedTokenAccount; type: 'account'; }; /** Name of the program that owns this account. */ program: Address; space: bigint; }>; }>; type GetTokenAccountsByOwnerResponse<T> = readonly AccountInfoWithPubkey<AccountInfoBase & T>[]; type MintFilter = Readonly<{ /** This filter matches when the token account's mint is equal to the address supplied. */ mint: Address; }>; type ProgramIdFilter = Readonly<{ /** * This filter matches when the token account's token program address is equal to the address * supplied. */ programId: Address; }>; type AccountsFilter = MintFilter | ProgramIdFilter; type GetTokenAccountsByOwnerApiCommonConfig = Readonly<{ /** * Fetch the details of the accounts as of the highest slot that has reached this level of * commitment. * * @defaultValue Whichever default is applied by the underlying {@link RpcApi} in use. For * example, when using an API created by a `createSolanaRpc*()` helper, the default commitment * is `"confirmed"` unless configured otherwise. Unmitigated by an API layer on the client, the * default commitment applied by the server is `"finalized"`. */ commitment?: Commitment; /** * Determines how the accounts' data should be encoded in the response. * * - `'base58'` returns a tuple whose first element is the data as a base58-encoded string. If * the account contains more than 129 bytes of data, an error will be raised. * - `'base64'` returns a tuple whose first element is the data as a base64-encoded string. * - `'base64+zstd'` returns a tuple whose first element is the * [ZStandard](https://facebook.github.io/zstd/)-compressed data as a base64-encoded string. * - `'jsonParsed'` will cause the server to attempt to process the data using a parser specific * to each account's owning program. If successful, the parsed data will be returned in the * response as JSON. Otherwise, the raw account data will be returned in the response as a * tuple whose first element is a base64-encoded string. */ encoding?: 'base58' | 'base64' | 'base64+zstd' | 'jsonParsed'; /** * Prevents accessing stale data by enforcing that the RPC node has processed transactions up to * this slot */ minContextSlot?: Slot; }>; type GetTokenAccountsByOwnerApiSliceableCommonConfig = Readonly<{ /** * Define which slice of the accounts' data you want the RPC to return. * * Use this to save network bandwidth and encoding time when you do not need the entire buffer. * * Data slicing is only available for `"base58"`, `"base64"`, and `"base64+zstd"` encodings. */ dataSlice?: DataSlice; }>; export type GetTokenAccountsByOwnerApi = { /** * Returns all SPL Token accounts owned by the supplied address. * * The accounts' data will be returned in the response as a tuple whose first element is a * base64-encoded string. * * @param filter Limits the results to either token accounts associated with a particular mint, * or token accounts owned by a certain token program. * * {@label base64} * @see https://solana.com/docs/rpc/http/gettokenaccountsbyowner */ getTokenAccountsByOwner(owner: Address, filter: AccountsFilter, config: GetTokenAccountsByOwnerApiCommonConfig & GetTokenAccountsByOwnerApiSliceableCommonConfig & Readonly<{ encoding: 'base64'; }>): SolanaRpcResponse<GetTokenAccountsByOwnerResponse<AccountInfoWithBase64EncodedData>>; /** * Returns all SPL Token accounts owned by the supplied address. * * The accounts' data will first be compressed using * [ZStandard](https://facebook.github.io/zstd/) and the result will be returned in the response * as a tuple whose first element is a base64-encoded string. * * @param filter Limits the results to either token accounts associated with a particular mint, * or token accounts owned by a certain token program. * * {@label base64-zstd-compressed} * @see https://solana.com/docs/rpc/http/gettokenaccountsbyowner */ getTokenAccountsByOwner(owner: Address, filter: AccountsFilter, config: GetTokenAccountsByOwnerApiCommonConfig & GetTokenAccountsByOwnerApiSliceableCommonConfig & Readonly<{ encoding: 'base64+zstd'; }>): SolanaRpcResponse<GetTokenAccountsByOwnerResponse<AccountInfoWithBase64EncodedZStdCompressedData>>; /** * Returns all SPL Token accounts owned by the supplied address. * * The server will attempt to process the accounts' data using a parser specific to each * account's owning token program. * * @param filter Limits the results to either token accounts associated with a particular mint, * or token accounts owned by a certain token program. * * {@label parsed} * @see https://solana.com/docs/rpc/http/gettokenaccountsbyowner */ getTokenAccountsByOwner(owner: Address, filter: AccountsFilter, config: GetTokenAccountsByOwnerApiCommonConfig & Readonly<{ encoding: 'jsonParsed'; }>): SolanaRpcResponse<GetTokenAccountsByOwnerResponse<TokenAccountInfoWithJsonData>>; /** * Returns all SPL Token accounts owned by the supplied address. * * The accounts' data will be returned in the response as a tuple whose first element is a * base58-encoded string. If any account contains more than 129 bytes of data, this method will * raise an error. * * @param filter Limits the results to either token accounts associated with a particular mint, * or token accounts owned by a certain token program. * * {@label base58} * @see https://solana.com/docs/rpc/http/gettokenaccountsbyowner */ getTokenAccountsByOwner(owner: Address, filter: AccountsFilter, config: GetTokenAccountsByOwnerApiCommonConfig & GetTokenAccountsByOwnerApiSliceableCommonConfig & Readonly<{ encoding: 'base58'; }>): SolanaRpcResponse<GetTokenAccountsByOwnerResponse<AccountInfoWithBase58EncodedData>>; /** * Returns all SPL Token accounts owned by the supplied address. * * The accounts' data will be returned in the response as a base58-encoded string. If any * account contains more than 129 bytes of data, this method will raise an error. * * @param filter Limits the results to either token accounts associated with a particular mint, * or token accounts owned by a certain token program. * * {@label base58-legacy} * @see https://solana.com/docs/rpc/http/gettokenaccountsbyowner */ getTokenAccountsByOwner(owner: Address, filter: AccountsFilter, config?: GetTokenAccountsByOwnerApiCommonConfig & GetTokenAccountsByOwnerApiSliceableCommonConfig): SolanaRpcResponse<GetTokenAccountsByOwnerResponse<AccountInfoWithBase58Bytes>>; }; export {}; //# sourceMappingURL=getTokenAccountsByOwner.d.ts.map