@solana/accounts 2.0.0-experimental.a1fafee → 2.0.0-experimental.ac2c1c8

package/README.md

@@ -147,6 +147,21 @@ assertAccountExists(myAccount);
 myAccount satisfies EncodedAccount<'1234..5678'>;
 ```
 
+### `assertAccountsExist()`
+
+Given an array of `MaybeAccount`s, this function asserts that all the accounts
+exist and allows them to be used as an array of `Account`s going forward.
+
+```ts
+const myAccounts: MaybeEncodedAccount<Address>[];
+assertAccountsExist(myAccounts);
+
+// Now we can use them as an array of accounts
+for (const a of myAccounts) {
+  a satisfies EncodedAccount<Address>;
+}
+```
+
 ### `parseBase64RpcAccount()`
 
 This function parses a base64-encoded account provided by the RPC client into an `EncodedAccount` type or a `MaybeEncodedAccount` type if the raw data can be set to `null`.
@@ -252,3 +267,47 @@ const myDecoder: Decoder<MyAccountData> = getStructDecoder([
 const myDecodedAccount = decodeAccount(myAccount, myDecoder);
 myDecodedAccount satisfies Account<MyAccountData, '1234..5678'>;
 ```
+
+### `assertAccountDecoded()`
+
+This function asserts that an account stores decoded data, ie not a Uint8Array. Note that it does not check the shape of the data matches the decoded type, only that it is not a Uint8Array.
+
+```ts
+type MyAccountData = { name: string; age: number };
+
+const myAccount: Account<MyAccountData | Uint8Array, '1234..5678'>;
+assertAccountDecoded(myAccount);
+
+// now the account data can be used as MyAccountData
+account.data satisfies MyAccountData;
+```
+
+This is particularly useful for narrowing the result of fetching a JSON parsed account.
+
+
+```ts
+    const account: MaybeAccount<MockData | Uint8Array> = await fetchJsonParsedAccount<MockData>(
+        rpc, 
+        '1234..5678' as Address,
+    )
+
+    assertAccountDecoded(account);
+    // now we have a MaybeAccount<MockData>
+    account satisfies MaybeAccount<MockData>
+```
+
+### `assertAccountsDecoded`
+
+This function asserts that all input accounts store decoded data, ie not a Uint8Array. As with `assertAccountDecoded` it does not check the shape of the data matches the decoded type, only that it is not a Uint8Array.
+
+```ts
+type MyAccountData = { name: string; age: number };
+
+const myAccounts: Account<MyAccountData | Uint8Array, Address>[];
+assertAccountsDecoded(myAccounts);
+
+// now the account data can be used as MyAccountData
+for(const a of account) {
+    account.data satisfies MyAccountData;
+}
+```

package/dist/index.browser.cjs

@@ -18,6 +18,21 @@ function decodeAccount(encodedAccount, decoder) {
     throw newError;
   }
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
   if (!rpcAccount)
     return Object.freeze({ address, exists: false });
@@ -74,9 +89,19 @@ function assertAccountExists(account) {
     throw new Error(`Expected account [${account.address}] to exist.`);
   }
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
 exports.BASE_ACCOUNT_SIZE = BASE_ACCOUNT_SIZE;
+exports.assertAccountDecoded = assertAccountDecoded;
 exports.assertAccountExists = assertAccountExists;
+exports.assertAccountsDecoded = assertAccountsDecoded;
+exports.assertAccountsExist = assertAccountsExist;
 exports.decodeAccount = decodeAccount;
 exports.fetchEncodedAccount = fetchEncodedAccount;
 exports.fetchEncodedAccounts = fetchEncodedAccounts;

package/dist/index.browser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-core/dist/types/rpc-methods/common';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedData<unknown> };\ntype JsonParsedData<TData> = { readonly parsed: { readonly info: TData } };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';\nimport type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';\nimport type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\nimport type { Commitment } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n"]}
+{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n\nfunction accountExists<TData extends object>(account: Account<TData> | MaybeAccount<TData>): account is Account<TData> {\n    return !('exists' in account) || ('exists' in account && account.exists);\n}\n\n/** Asserts that an account has been decoded. */\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is MaybeAccount<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (accountExists(account) && account.data instanceof Uint8Array) {\n        // TODO: coded error.\n        throw new Error(`Expected account [${account.address}] to be decoded.`);\n    }\n}\n\n/** Asserts that all accounts have been decoded. */\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: Account<TData | Uint8Array, TAddress>[],\n): asserts accounts is Account<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: MaybeAccount<TData | Uint8Array, TAddress>[],\n): asserts accounts is MaybeAccount<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: (Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>)[],\n): asserts accounts is (Account<TData, TAddress> | MaybeAccount<TData, TAddress>)[] {\n    const encoded = accounts.filter(a => accountExists(a) && a.data instanceof Uint8Array);\n    if (encoded.length > 0) {\n        const encodedAddresses = encoded.map(a => a.address).join(', ');\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-types';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport type { JsonParsedDataResponse } from './rpc-api';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedDataResponse<unknown> };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Rpc } from '@solana/rpc-spec';\nimport type { Commitment, Slot } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\nimport type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>,\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n\n/** Asserts that all accounts that may or may not exist, actually all exist. */\nexport function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(\n    accounts: MaybeAccount<TData, TAddress>[],\n): asserts accounts is (Account<TData, TAddress> & { exists: true })[] {\n    const missingAccounts = accounts.filter(a => !a.exists);\n    if (missingAccounts.length > 0) {\n        const missingAddresses = missingAccounts.map(a => a.address);\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${missingAddresses.join(', ')}] to exist.`);\n    }\n}\n"]}

package/dist/index.browser.js

@@ -16,6 +16,21 @@ function decodeAccount(encodedAccount, decoder) {
     throw newError;
   }
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
   if (!rpcAccount)
     return Object.freeze({ address, exists: false });
@@ -72,7 +87,14 @@ function assertAccountExists(account) {
     throw new Error(`Expected account [${account.address}] to exist.`);
   }
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-core/dist/types/rpc-methods/common';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedData<unknown> };\ntype JsonParsedData<TData> = { readonly parsed: { readonly info: TData } };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';\nimport type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';\nimport type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\nimport type { Commitment } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n"]}
+{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n\nfunction accountExists<TData extends object>(account: Account<TData> | MaybeAccount<TData>): account is Account<TData> {\n    return !('exists' in account) || ('exists' in account && account.exists);\n}\n\n/** Asserts that an account has been decoded. */\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is MaybeAccount<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (accountExists(account) && account.data instanceof Uint8Array) {\n        // TODO: coded error.\n        throw new Error(`Expected account [${account.address}] to be decoded.`);\n    }\n}\n\n/** Asserts that all accounts have been decoded. */\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: Account<TData | Uint8Array, TAddress>[],\n): asserts accounts is Account<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: MaybeAccount<TData | Uint8Array, TAddress>[],\n): asserts accounts is MaybeAccount<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: (Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>)[],\n): asserts accounts is (Account<TData, TAddress> | MaybeAccount<TData, TAddress>)[] {\n    const encoded = accounts.filter(a => accountExists(a) && a.data instanceof Uint8Array);\n    if (encoded.length > 0) {\n        const encodedAddresses = encoded.map(a => a.address).join(', ');\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-types';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport type { JsonParsedDataResponse } from './rpc-api';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedDataResponse<unknown> };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Rpc } from '@solana/rpc-spec';\nimport type { Commitment, Slot } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\nimport type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>,\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n\n/** Asserts that all accounts that may or may not exist, actually all exist. */\nexport function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(\n    accounts: MaybeAccount<TData, TAddress>[],\n): asserts accounts is (Account<TData, TAddress> & { exists: true })[] {\n    const missingAccounts = accounts.filter(a => !a.exists);\n    if (missingAccounts.length > 0) {\n        const missingAddresses = missingAccounts.map(a => a.address);\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${missingAddresses.join(', ')}] to exist.`);\n    }\n}\n"]}

package/dist/index.native.js

@@ -16,6 +16,21 @@ function decodeAccount(encodedAccount, decoder) {
     throw newError;
   }
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
   if (!rpcAccount)
     return Object.freeze({ address, exists: false });
@@ -72,7 +87,14 @@ function assertAccountExists(account) {
     throw new Error(`Expected account [${account.address}] to exist.`);
   }
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.native.js.map

package/dist/index.native.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-core/dist/types/rpc-methods/common';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedData<unknown> };\ntype JsonParsedData<TData> = { readonly parsed: { readonly info: TData } };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';\nimport type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';\nimport type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\nimport type { Commitment } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n"]}
+{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n\nfunction accountExists<TData extends object>(account: Account<TData> | MaybeAccount<TData>): account is Account<TData> {\n    return !('exists' in account) || ('exists' in account && account.exists);\n}\n\n/** Asserts that an account has been decoded. */\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is MaybeAccount<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (accountExists(account) && account.data instanceof Uint8Array) {\n        // TODO: coded error.\n        throw new Error(`Expected account [${account.address}] to be decoded.`);\n    }\n}\n\n/** Asserts that all accounts have been decoded. */\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: Account<TData | Uint8Array, TAddress>[],\n): asserts accounts is Account<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: MaybeAccount<TData | Uint8Array, TAddress>[],\n): asserts accounts is MaybeAccount<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: (Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>)[],\n): asserts accounts is (Account<TData, TAddress> | MaybeAccount<TData, TAddress>)[] {\n    const encoded = accounts.filter(a => accountExists(a) && a.data instanceof Uint8Array);\n    if (encoded.length > 0) {\n        const encodedAddresses = encoded.map(a => a.address).join(', ');\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-types';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport type { JsonParsedDataResponse } from './rpc-api';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedDataResponse<unknown> };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Rpc } from '@solana/rpc-spec';\nimport type { Commitment, Slot } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\nimport type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>,\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n\n/** Asserts that all accounts that may or may not exist, actually all exist. */\nexport function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(\n    accounts: MaybeAccount<TData, TAddress>[],\n): asserts accounts is (Account<TData, TAddress> & { exists: true })[] {\n    const missingAccounts = accounts.filter(a => !a.exists);\n    if (missingAccounts.length > 0) {\n        const missingAddresses = missingAccounts.map(a => a.address);\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${missingAddresses.join(', ')}] to exist.`);\n    }\n}\n"]}

package/dist/index.node.cjs

@@ -18,6 +18,21 @@ function decodeAccount(encodedAccount, decoder) {
     throw newError;
   }
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
   if (!rpcAccount)
     return Object.freeze({ address, exists: false });
@@ -74,9 +89,19 @@ function assertAccountExists(account) {
     throw new Error(`Expected account [${account.address}] to exist.`);
   }
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
 exports.BASE_ACCOUNT_SIZE = BASE_ACCOUNT_SIZE;
+exports.assertAccountDecoded = assertAccountDecoded;
 exports.assertAccountExists = assertAccountExists;
+exports.assertAccountsDecoded = assertAccountsDecoded;
+exports.assertAccountsExist = assertAccountsExist;
 exports.decodeAccount = decodeAccount;
 exports.fetchEncodedAccount = fetchEncodedAccount;
 exports.fetchEncodedAccounts = fetchEncodedAccounts;

package/dist/index.node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-core/dist/types/rpc-methods/common';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedData<unknown> };\ntype JsonParsedData<TData> = { readonly parsed: { readonly info: TData } };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';\nimport type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';\nimport type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\nimport type { Commitment } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n"]}
+{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n\nfunction accountExists<TData extends object>(account: Account<TData> | MaybeAccount<TData>): account is Account<TData> {\n    return !('exists' in account) || ('exists' in account && account.exists);\n}\n\n/** Asserts that an account has been decoded. */\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is MaybeAccount<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (accountExists(account) && account.data instanceof Uint8Array) {\n        // TODO: coded error.\n        throw new Error(`Expected account [${account.address}] to be decoded.`);\n    }\n}\n\n/** Asserts that all accounts have been decoded. */\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: Account<TData | Uint8Array, TAddress>[],\n): asserts accounts is Account<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: MaybeAccount<TData | Uint8Array, TAddress>[],\n): asserts accounts is MaybeAccount<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: (Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>)[],\n): asserts accounts is (Account<TData, TAddress> | MaybeAccount<TData, TAddress>)[] {\n    const encoded = accounts.filter(a => accountExists(a) && a.data instanceof Uint8Array);\n    if (encoded.length > 0) {\n        const encodedAddresses = encoded.map(a => a.address).join(', ');\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-types';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport type { JsonParsedDataResponse } from './rpc-api';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedDataResponse<unknown> };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Rpc } from '@solana/rpc-spec';\nimport type { Commitment, Slot } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\nimport type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>,\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n\n/** Asserts that all accounts that may or may not exist, actually all exist. */\nexport function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(\n    accounts: MaybeAccount<TData, TAddress>[],\n): asserts accounts is (Account<TData, TAddress> & { exists: true })[] {\n    const missingAccounts = accounts.filter(a => !a.exists);\n    if (missingAccounts.length > 0) {\n        const missingAddresses = missingAccounts.map(a => a.address);\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${missingAddresses.join(', ')}] to exist.`);\n    }\n}\n"]}

package/dist/index.node.js

@@ -16,6 +16,21 @@ function decodeAccount(encodedAccount, decoder) {
     throw newError;
   }
 }
+function accountExists(account) {
+  return !("exists" in account) || "exists" in account && account.exists;
+}
+function assertAccountDecoded(account) {
+  if (accountExists(account) && account.data instanceof Uint8Array) {
+    throw new Error(`Expected account [${account.address}] to be decoded.`);
+  }
+}
+function assertAccountsDecoded(accounts) {
+  const encoded = accounts.filter((a) => accountExists(a) && a.data instanceof Uint8Array);
+  if (encoded.length > 0) {
+    const encodedAddresses = encoded.map((a) => a.address).join(", ");
+    throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);
+  }
+}
 function parseBase64RpcAccount(address, rpcAccount) {
   if (!rpcAccount)
     return Object.freeze({ address, exists: false });
@@ -72,7 +87,14 @@ function assertAccountExists(account) {
     throw new Error(`Expected account [${account.address}] to exist.`);
   }
 }
+function assertAccountsExist(accounts) {
+  const missingAccounts = accounts.filter((a) => !a.exists);
+  if (missingAccounts.length > 0) {
+    const missingAddresses = missingAccounts.map((a) => a.address);
+    throw new Error(`Expected accounts [${missingAddresses.join(", ")}] to exist.`);
+  }
+}
 
-export { BASE_ACCOUNT_SIZE, assertAccountExists, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
+export { BASE_ACCOUNT_SIZE, assertAccountDecoded, assertAccountExists, assertAccountsDecoded, assertAccountsExist, decodeAccount, fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":";AAIO,IAAM,oBAAoB;;;ACU1B,SAAS,cACZ,gBACA,SACwD;AACxD,MAAI;AACA,QAAI,YAAY,kBAAkB,CAAC,eAAe,QAAQ;AACtD,aAAO;AAAA,IACX;AACA,WAAO,OAAO,OAAO,EAAE,GAAG,gBAAgB,MAAM,QAAQ,OAAO,eAAe,IAAI,EAAE,CAAC;AAAA,EACzF,SAAS,OAAO;AAEZ,UAAM,WAAW,IAAI,MAAM,6BAA6B,eAAe,OAAO,IAAI;AAClF,aAAS,QAAQ;AACjB,UAAM;AAAA,EACV;AACJ;;;AC5BA,SAAS,kBAAkB,wBAAwB;AAsB5C,SAAS,sBACZ,SACA,YACwD;AACxD,MAAI,CAAC;AAAY,WAAO,OAAO,OAAO,EAAE,SAAS,QAAQ,MAAM,CAAC;AAChE,QAAM,OAAO,iBAAiB,EAAE,OAAO,WAAW,KAAK,CAAC,CAAC;AACzD,SAAO,OAAO,OAAO,EAAE,GAAG,iBAAiB,UAAU,GAAG,SAAS,MAAM,QAAQ,KAAK,CAAC;AACzF;AAaO,SAAS,sBACZ,SACA,YACwD;AACxD,MAAI,CAAC;AAAY,WAAO,OAAO,OAAO,EAAE,SAAS,QAAQ,MAAM,CAAC;AAChE,QAAM,OAAO,iBAAiB,EAAE,OAAO,OAAO,WAAW,SAAS,WAAW,WAAW,OAAO,WAAW,KAAK,CAAC,CAAC;AACjH,SAAO,OAAO,OAAO,EAAE,GAAG,iBAAiB,UAAU,GAAG,SAAS,MAAM,QAAQ,KAAK,CAAC;AACzF;AAcO,SAAS,oBACZ,SACA,YACwD;AACxD,MAAI,CAAC;AAAY,WAAO,OAAO,OAAO,EAAE,SAAS,QAAQ,MAAM,CAAC;AAChE,QAAM,OAAO,WAAW,KAAK,OAAO;AACpC,SAAO,OAAO,OAAO,EAAE,GAAG,iBAAiB,UAAU,GAAG,SAAS,MAAM,QAAQ,KAAK,CAAC;AACzF;AAEA,SAAS,iBAAiB,YAA0C;AAChE,SAAO,OAAO,OAAO;AAAA,IACjB,YAAY,WAAW;AAAA,IACvB,UAAU,WAAW;AAAA,IACrB,gBAAgB,WAAW;AAAA,EAC/B,CAAC;AACL;;;AC7DA,eAAsB,oBAClB,KACA,SACA,SAA6B,CAAC,GACQ;AACtC,QAAM,EAAE,aAAa,GAAG,UAAU,IAAI;AACtC,QAAM,WAAW,MAAM,IAAI,eAAe,SAAS,EAAE,GAAG,WAAW,UAAU,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC;AAC7G,SAAO,sBAAsB,SAAS,SAAS,KAAK;AACxD;AAGA,eAAsB,uBAClB,KACA,SACA,SAA6B,CAAC,GACwC;AACtE,QAAM,EAAE,aAAa,GAAG,UAAU,IAAI;AACtC,QAAM,EAAE,OAAO,QAAQ,IAAI,MAAM,IAC5B,eAAe,SAAS,EAAE,GAAG,WAAW,UAAU,aAAa,CAAC,EAChE,KAAK,EAAE,YAAY,CAAC;AACzB,SAAO,CAAC,CAAC,WAAW,OAAO,YAAY,YAAY,YAAY,QAAQ,OACjE,oBAAqC,SAAS,OAAoD,IAClG,sBAAgC,SAAS,OAAsD;AACzG;AAUA,eAAsB,qBAKpB,KAAkC,WAA8B,SAA8B,CAAC,GAAG;AAChG,QAAM,EAAE,aAAa,GAAG,UAAU,IAAI;AACtC,QAAM,WAAW,MAAM,IAClB,oBAAoB,WAAW,EAAE,GAAG,WAAW,UAAU,SAAS,CAAC,EACnE,KAAK,EAAE,YAAY,CAAC;AACzB,SAAO,SAAS,MAAM,IAAI,CAAC,SAAS,UAAU,sBAAsB,UAAU,KAAK,GAAG,OAAO,CAAC;AAGlG;AAGA,eAAsB,wBAMpB,KAAkC,WAA8B,SAA8B,CAAC,GAAG;AAChG,QAAM,EAAE,aAAa,GAAG,UAAU,IAAI;AACtC,QAAM,WAAW,MAAM,IAClB,oBAAoB,WAAW,EAAE,GAAG,WAAW,UAAU,aAAa,CAAC,EACvE,KAAK,EAAE,YAAY,CAAC;AACzB,SAAO,SAAS,MAAM,IAAI,CAAC,SAAS,UAAU;AAC1C,WAAO,CAAC,CAAC,WAAW,OAAO,YAAY,YAAY,YAAY,QAAQ,OACjE,oBAAoB,UAAU,KAAK,GAAG,OAAoD,IAC1F,sBAAsB,UAAU,KAAK,GAAG,OAAsD;AAAA,EACxG,CAAC;AASL;;;AC9EO,SAAS,oBACZ,SAC8D;AAC9D,MAAI,CAAC,QAAQ,QAAQ;AAEjB,UAAM,IAAI,MAAM,qBAAqB,QAAQ,OAAO,aAAa;AAAA,EACrE;AACJ","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-core/dist/types/rpc-methods/common';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedData<unknown> };\ntype JsonParsedData<TData> = { readonly parsed: { readonly info: TData } };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';\nimport type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';\nimport type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';\nimport type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';\nimport type { Commitment } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n"]}
+{"version":3,"sources":["../src/account.ts","../src/decode-account.ts","../src/parse-account.ts","../src/fetch-account.ts","../src/maybe-account.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { LamportsUnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';\n\n/** The amount of bytes required to store the base account information without its data. */\nexport const BASE_ACCOUNT_SIZE = 128;\n\n/** Describe the generic account details applicable to every account. */\nexport type BaseAccount = {\n    readonly programAddress: Address;\n    readonly executable: boolean;\n    readonly lamports: LamportsUnsafeBeyond2Pow53Minus1;\n};\n\n/** Defines a Solana account with its generic details and parsed or encoded data. */\nexport type Account<TData extends object | Uint8Array, TAddress extends string = string> = BaseAccount & {\n    readonly address: Address<TAddress>;\n    readonly data: TData;\n};\n\n/** Defines a Solana account with its generic details and encoded data. */\nexport type EncodedAccount<TAddress extends string = string> = Account<Uint8Array, TAddress>;\n","import type { Decoder } from '@solana/codecs-core';\n\nimport type { Account, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\n\n/** Decodes the data of a given account using the provided decoder. */\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): MaybeAccount<TData, TAddress>;\nexport function decodeAccount<TData extends object, TAddress extends string = string>(\n    encodedAccount: EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress>,\n    decoder: Decoder<TData>,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    try {\n        if ('exists' in encodedAccount && !encodedAccount.exists) {\n            return encodedAccount;\n        }\n        return Object.freeze({ ...encodedAccount, data: decoder.decode(encodedAccount.data) });\n    } catch (error) {\n        // TODO: Coded error.\n        const newError = new Error(`Failed to decode account [${encodedAccount.address}].`);\n        newError.cause = error;\n        throw newError;\n    }\n}\n\nfunction accountExists<TData extends object>(account: Account<TData> | MaybeAccount<TData>): account is Account<TData> {\n    return !('exists' in account) || ('exists' in account && account.exists);\n}\n\n/** Asserts that an account has been decoded. */\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is MaybeAccount<TData, TAddress>;\nexport function assertAccountDecoded<TData extends object, TAddress extends string = string>(\n    account: Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>,\n): asserts account is Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (accountExists(account) && account.data instanceof Uint8Array) {\n        // TODO: coded error.\n        throw new Error(`Expected account [${account.address}] to be decoded.`);\n    }\n}\n\n/** Asserts that all accounts have been decoded. */\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: Account<TData | Uint8Array, TAddress>[],\n): asserts accounts is Account<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: MaybeAccount<TData | Uint8Array, TAddress>[],\n): asserts accounts is MaybeAccount<TData, TAddress>[];\nexport function assertAccountsDecoded<TData extends object, TAddress extends string = string>(\n    accounts: (Account<TData | Uint8Array, TAddress> | MaybeAccount<TData | Uint8Array, TAddress>)[],\n): asserts accounts is (Account<TData, TAddress> | MaybeAccount<TData, TAddress>)[] {\n    const encoded = accounts.filter(a => accountExists(a) && a.data instanceof Uint8Array);\n    if (encoded.length > 0) {\n        const encodedAddresses = encoded.map(a => a.address).join(', ');\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${encodedAddresses}] to be decoded.`);\n    }\n}\n","import type { Address } from '@solana/addresses';\nimport { getBase58Encoder, getBase64Encoder } from '@solana/codecs-strings';\nimport type {\n    AccountInfoBase,\n    AccountInfoWithBase58Bytes,\n    AccountInfoWithBase58EncodedData,\n    AccountInfoWithBase64EncodedData,\n} from '@solana/rpc-types';\n\nimport type { Account, BaseAccount, EncodedAccount } from './account';\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport type { JsonParsedDataResponse } from './rpc-api';\n\ntype Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;\n\n/** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase64RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base64EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase64Encoder().encode(rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | AccountInfoWithBase58EncodedData);\n\n/** Parse an account object received from a base58-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount,\n): EncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): MaybeEncodedAccount<TAddress>;\nexport function parseBase58RpcAccount<TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: Base58EncodedRpcAccount | null,\n): EncodedAccount<TAddress> | MaybeEncodedAccount<TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = getBase58Encoder().encode(typeof rpcAccount.data === 'string' ? rpcAccount.data : rpcAccount.data[0]);\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\ntype JsonParsedRpcAccount = AccountInfoBase & { readonly data: JsonParsedDataResponse<unknown> };\n\n/** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount,\n): Account<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): MaybeAccount<TData, TAddress>;\nexport function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(\n    address: Address<TAddress>,\n    rpcAccount: JsonParsedRpcAccount | null,\n): Account<TData, TAddress> | MaybeAccount<TData, TAddress> {\n    if (!rpcAccount) return Object.freeze({ address, exists: false });\n    const data = rpcAccount.data.parsed.info as TData;\n    return Object.freeze({ ...parseBaseAccount(rpcAccount), address, data, exists: true });\n}\n\nfunction parseBaseAccount(rpcAccount: AccountInfoBase): BaseAccount {\n    return Object.freeze({\n        executable: rpcAccount.executable,\n        lamports: rpcAccount.lamports,\n        programAddress: rpcAccount.owner,\n    });\n}\n","import type { Address } from '@solana/addresses';\nimport type { Rpc } from '@solana/rpc-spec';\nimport type { Commitment, Slot } from '@solana/rpc-types';\n\nimport type { MaybeAccount, MaybeEncodedAccount } from './maybe-account';\nimport { parseBase64RpcAccount, parseJsonRpcAccount } from './parse-account';\nimport type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api';\n\n/** Optional configuration for fetching a singular account. */\nexport type FetchAccountConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch a base64-encoded account that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccount<TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc.getAccountInfo(address, { ...rpcConfig, encoding: 'base64' }).send({ abortSignal });\n    return parseBase64RpcAccount(address, response.value);\n}\n\n/** Fetch a json-parsed account that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccount<TData extends object, TAddress extends string = string>(\n    rpc: Rpc<GetAccountInfoApi>,\n    address: Address<TAddress>,\n    config: FetchAccountConfig = {},\n): Promise<MaybeAccount<TData, TAddress> | MaybeEncodedAccount<TAddress>> {\n    const { abortSignal, ...rpcConfig } = config;\n    const { value: account } = await rpc\n        .getAccountInfo(address, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return !!account && typeof account === 'object' && 'parsed' in account.data\n        ? parseJsonRpcAccount<TData, TAddress>(address, account as Parameters<typeof parseJsonRpcAccount>[1])\n        : parseBase64RpcAccount<TAddress>(address, account as Parameters<typeof parseBase64RpcAccount>[1]);\n}\n\n/** Optional configuration for fetching multiple accounts. */\nexport type FetchAccountsConfig = {\n    commitment?: Commitment;\n    minContextSlot?: Slot;\n    abortSignal?: AbortSignal;\n};\n\n/** Fetch multiple base64-encoded accounts that may or may not exist using an RPC client. */\nexport async function fetchEncodedAccounts<\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'base64' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => parseBase64RpcAccount(addresses[index], account)) as {\n        [P in keyof TAddresses]: MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n\n/** Fetch multiple json-parsed accounts that may or may not exist using an RPC client. */\nexport async function fetchJsonParsedAccounts<\n    TData extends object[],\n    TAddresses extends string[] = string[],\n    TWrappedAddresses extends { [P in keyof TAddresses]: Address<TAddresses[P]> } = {\n        [P in keyof TAddresses]: Address<TAddresses[P]>;\n    },\n>(rpc: Rpc<GetMultipleAccountsApi>, addresses: TWrappedAddresses, config: FetchAccountsConfig = {}) {\n    const { abortSignal, ...rpcConfig } = config;\n    const response = await rpc\n        .getMultipleAccounts(addresses, { ...rpcConfig, encoding: 'jsonParsed' })\n        .send({ abortSignal });\n    return response.value.map((account, index) => {\n        return !!account && typeof account === 'object' && 'parsed' in account.data\n            ? parseJsonRpcAccount(addresses[index], account as Parameters<typeof parseJsonRpcAccount>[1])\n            : parseBase64RpcAccount(addresses[index], account as Parameters<typeof parseBase64RpcAccount>[1]);\n    }) as {\n        [P in keyof TData]:\n            | MaybeAccount<TData[P], TAddresses[P & keyof TAddresses]>\n            | MaybeEncodedAccount<TAddresses[P & keyof TAddresses]>;\n    } & {\n        [P in keyof TAddresses]:\n            | MaybeAccount<TData[P & keyof TData], TAddresses[P]>\n            | MaybeEncodedAccount<TAddresses[P]>;\n    };\n}\n","import { Address } from '@solana/addresses';\n\nimport { Account } from './account';\n\n/** Defines a Solana account that may or may not exist after having tried to fetch it. */\nexport type MaybeAccount<TData extends object | Uint8Array, TAddress extends string = string> =\n    | ({ readonly exists: true } & Account<TData, TAddress>)\n    | { readonly exists: false; readonly address: Address<TAddress> };\n\n/** Defines a Solana account with encoded data that may or may not exist after having tried to fetch it. */\nexport type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount<Uint8Array, TAddress>;\n\n/** Asserts that an account that may or may not exists, actually exists. */\nexport function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(\n    account: MaybeAccount<TData, TAddress>,\n): asserts account is Account<TData, TAddress> & { exists: true } {\n    if (!account.exists) {\n        // TODO: Coded error.\n        throw new Error(`Expected account [${account.address}] to exist.`);\n    }\n}\n\n/** Asserts that all accounts that may or may not exist, actually all exist. */\nexport function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(\n    accounts: MaybeAccount<TData, TAddress>[],\n): asserts accounts is (Account<TData, TAddress> & { exists: true })[] {\n    const missingAccounts = accounts.filter(a => !a.exists);\n    if (missingAccounts.length > 0) {\n        const missingAddresses = missingAccounts.map(a => a.address);\n        // TODO: Coded error.\n        throw new Error(`Expected accounts [${missingAddresses.join(', ')}] to exist.`);\n    }\n}\n"]}

package/dist/types/decode-account.d.ts

@@ -4,4 +4,10 @@ import type { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
 /** Decodes the data of a given account using the provided decoder. */
 export declare function decodeAccount<TData extends object, TAddress extends string = string>(encodedAccount: EncodedAccount<TAddress>, decoder: Decoder<TData>): Account<TData, TAddress>;
 export declare function decodeAccount<TData extends object, TAddress extends string = string>(encodedAccount: MaybeEncodedAccount<TAddress>, decoder: Decoder<TData>): MaybeAccount<TData, TAddress>;
+/** Asserts that an account has been decoded. */
+export declare function assertAccountDecoded<TData extends object, TAddress extends string = string>(account: Account<TData | Uint8Array, TAddress>): asserts account is Account<TData, TAddress>;
+export declare function assertAccountDecoded<TData extends object, TAddress extends string = string>(account: MaybeAccount<TData | Uint8Array, TAddress>): asserts account is MaybeAccount<TData, TAddress>;
+/** Asserts that all accounts have been decoded. */
+export declare function assertAccountsDecoded<TData extends object, TAddress extends string = string>(accounts: Account<TData | Uint8Array, TAddress>[]): asserts accounts is Account<TData, TAddress>[];
+export declare function assertAccountsDecoded<TData extends object, TAddress extends string = string>(accounts: MaybeAccount<TData | Uint8Array, TAddress>[]): asserts accounts is MaybeAccount<TData, TAddress>[];
 //# sourceMappingURL=decode-account.d.ts.map

package/dist/types/decode-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decode-account.d.ts","sourceRoot":"","sources":["../../src/decode-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChF,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,EACxC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACxB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChF,cAAc,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAC7C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACxB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"decode-account.d.ts","sourceRoot":"","sources":["../../src/decode-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChF,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,EACxC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACxB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChF,cAAc,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAC7C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACxB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAsBjC,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACvF,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,GAC/C,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC/C,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACvF,OAAO,EAAE,YAAY,CAAC,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,GACpD,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAUpD,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACxF,QAAQ,EAAE,OAAO,CAAC,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,GAClD,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;AAClD,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACxF,QAAQ,EAAE,YAAY,CAAC,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,GACvD,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC"}

package/dist/types/fetch-account.d.ts

@@ -1,10 +1,8 @@
 import type { Address } from '@solana/addresses';
-import type { Slot } from '@solana/rpc-core/dist/types/rpc-methods/common';
-import type { GetAccountInfoApi } from '@solana/rpc-core/dist/types/rpc-methods/getAccountInfo';
-import type { GetMultipleAccountsApi } from '@solana/rpc-core/dist/types/rpc-methods/getMultipleAccounts';
-import type { Rpc } from '@solana/rpc-transport/dist/types/json-rpc-types';
-import type { Commitment } from '@solana/rpc-types';
+import type { Rpc } from '@solana/rpc-spec';
+import type { Commitment, Slot } from '@solana/rpc-types';
 import type { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
+import type { GetAccountInfoApi, GetMultipleAccountsApi } from './rpc-api/index.js';
 /** Optional configuration for fetching a singular account. */
 export type FetchAccountConfig = {
     commitment?: Commitment;

package/dist/types/fetch-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-account.d.ts","sourceRoot":"","sources":["../../src/fetch-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gDAAgD,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6DAA6D,CAAC;AAC1G,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iDAAiD,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,oFAAoF;AACpF,wBAAsB,mBAAmB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtE,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,MAAM,GAAE,kBAAuB,GAChC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAIxC;AAED,iFAAiF;AACjF,wBAAsB,sBAAsB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAC/F,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,MAAM,GAAE,kBAAuB,GAChC,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAQxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,4FAA4F;AAC5F,wBAAsB,oBAAoB,CACtC,UAAU,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACtC,iBAAiB,SAAS;KAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAC3E,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAClD,EACH,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAE,mBAAwB,6EAQjG;AAED,yFAAyF;AACzF,wBAAsB,uBAAuB,CACzC,KAAK,SAAS,MAAM,EAAE,EACtB,UAAU,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACtC,iBAAiB,SAAS;KAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAC3E,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAClD,EACH,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;OAkBjG"}
+{"version":3,"file":"fetch-account.d.ts","sourceRoot":"","sources":["../../src/fetch-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAE3E,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,oFAAoF;AACpF,wBAAsB,mBAAmB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtE,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,MAAM,GAAE,kBAAuB,GAChC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAIxC;AAED,iFAAiF;AACjF,wBAAsB,sBAAsB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EAC/F,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,MAAM,GAAE,kBAAuB,GAChC,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAQxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,4FAA4F;AAC5F,wBAAsB,oBAAoB,CACtC,UAAU,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACtC,iBAAiB,SAAS;KAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAC3E,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAClD,EACH,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAE,mBAAwB,6EAQjG;AAED,yFAAyF;AACzF,wBAAsB,uBAAuB,CACzC,KAAK,SAAS,MAAM,EAAE,EACtB,UAAU,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,EACtC,iBAAiB,SAAS;KAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAC3E,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAClD,EACH,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;OAkBjG"}

package/dist/types/maybe-account.d.ts

@@ -13,4 +13,8 @@ export type MaybeEncodedAccount<TAddress extends string = string> = MaybeAccount
 export declare function assertAccountExists<TData extends object | Uint8Array, TAddress extends string = string>(account: MaybeAccount<TData, TAddress>): asserts account is Account<TData, TAddress> & {
     exists: true;
 };
+/** Asserts that all accounts that may or may not exist, actually all exist. */
+export declare function assertAccountsExist<TData extends object | Uint8Array, TAddress extends string = string>(accounts: MaybeAccount<TData, TAddress>[]): asserts accounts is (Account<TData, TAddress> & {
+    exists: true;
+})[];
 //# sourceMappingURL=maybe-account.d.ts.map

package/dist/types/maybe-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maybe-account.d.ts","sourceRoot":"","sources":["../../src/maybe-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,yFAAyF;AACzF,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,IACtF,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,GACtD;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEtE,2GAA2G;AAC3G,MAAM,MAAM,mBAAmB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAEvG,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACnG,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,GACvC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAKhE"}
+{"version":3,"file":"maybe-account.d.ts","sourceRoot":"","sources":["../../src/maybe-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,yFAAyF;AACzF,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,IACtF,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,GACtD;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEtE,2GAA2G;AAC3G,MAAM,MAAM,mBAAmB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAEvG,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACnG,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,GACvC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAKhE;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACnG,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,GAC1C,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC,EAAE,CAOrE"}

package/dist/types/parse-account.d.ts

@@ -1,7 +1,8 @@
 import type { Address } from '@solana/addresses';
-import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData } from '@solana/rpc-core/dist/types/rpc-methods/common';
+import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData } from '@solana/rpc-types';
 import type { Account, EncodedAccount } from './account.js';
-import { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
+import type { MaybeAccount, MaybeEncodedAccount } from './maybe-account.js';
+import type { JsonParsedDataResponse } from './rpc-api/index.js';
 type Base64EncodedRpcAccount = AccountInfoBase & AccountInfoWithBase64EncodedData;
 /** Parse an account object received from a base64-encoded RPC call into an EncodedAccount or MaybeEncodedAccount type. */
 export declare function parseBase64RpcAccount<TAddress extends string = string>(address: Address<TAddress>, rpcAccount: Base64EncodedRpcAccount): EncodedAccount<TAddress>;
@@ -11,12 +12,7 @@ type Base58EncodedRpcAccount = AccountInfoBase & (AccountInfoWithBase58Bytes | A
 export declare function parseBase58RpcAccount<TAddress extends string = string>(address: Address<TAddress>, rpcAccount: Base58EncodedRpcAccount): EncodedAccount<TAddress>;
 export declare function parseBase58RpcAccount<TAddress extends string = string>(address: Address<TAddress>, rpcAccount: Base58EncodedRpcAccount | null): MaybeEncodedAccount<TAddress>;
 type JsonParsedRpcAccount = AccountInfoBase & {
-    readonly data: JsonParsedData<unknown>;
-};
-type JsonParsedData<TData> = {
-    readonly parsed: {
-        readonly info: TData;
-    };
+    readonly data: JsonParsedDataResponse<unknown>;
 };
 /** Parse an account object received from a json-parsed RPC call into an Account or MaybeAccount type. */
 export declare function parseJsonRpcAccount<TData extends object, TAddress extends string = string>(address: Address<TAddress>, rpcAccount: JsonParsedRpcAccount): Account<TData, TAddress>;

package/dist/types/parse-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-account.d.ts","sourceRoot":"","sources":["../../src/parse-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EACR,eAAe,EACf,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EACnC,MAAM,gDAAgD,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAe,cAAc,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,KAAK,uBAAuB,GAAG,eAAe,GAAG,gCAAgC,CAAC;AAElF,0HAA0H;AAC1H,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GACpC,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GAAG,IAAI,GAC3C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAUjC,KAAK,uBAAuB,GAAG,eAAe,GAAG,CAAC,0BAA0B,GAAG,gCAAgC,CAAC,CAAC;AAEjH,0HAA0H;AAC1H,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GACpC,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GAAG,IAAI,GAC3C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAUjC,KAAK,oBAAoB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AACzF,KAAK,cAAc,CAAC,KAAK,IAAI;IAAE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3E,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtF,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,oBAAoB,GACjC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtF,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,oBAAoB,GAAG,IAAI,GACxC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"parse-account.d.ts","sourceRoot":"","sources":["../../src/parse-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EACR,eAAe,EACf,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EACnC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,OAAO,EAAe,cAAc,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,KAAK,uBAAuB,GAAG,eAAe,GAAG,gCAAgC,CAAC;AAElF,0HAA0H;AAC1H,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GACpC,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GAAG,IAAI,GAC3C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAUjC,KAAK,uBAAuB,GAAG,eAAe,GAAG,CAAC,0BAA0B,GAAG,gCAAgC,CAAC,CAAC;AAEjH,0HAA0H;AAC1H,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GACpC,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,uBAAuB,GAAG,IAAI,GAC3C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAUjC,KAAK,oBAAoB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAEjG,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtF,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,oBAAoB,GACjC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC5B,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,EACtF,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,UAAU,EAAE,oBAAoB,GAAG,IAAI,GACxC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC"}

package/dist/types/rpc-api/common.d.ts

@@ -0,0 +1,10 @@
+import type { U64UnsafeBeyond2Pow53Minus1 } from '@solana/rpc-types';
+export type JsonParsedDataResponse<TData = object> = Readonly<{
+    program: string;
+    parsed: {
+        info?: TData;
+        type: string;
+    };
+    space: U64UnsafeBeyond2Pow53Minus1;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/rpc-api/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/rpc-api/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,MAAM,IAAI,QAAQ,CAAC;IAE1D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACJ,IAAI,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,EAAE,2BAA2B,CAAC;CACtC,CAAC,CAAC"}

package/dist/types/rpc-api/getAccountInfo.d.ts

@@ -0,0 +1,34 @@
+import type { Address } from '@solana/addresses';
+import type { RpcApiMethods } from '@solana/rpc-spec';
+import type { AccountInfoBase, AccountInfoWithBase58Bytes, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData, AccountInfoWithBase64EncodedZStdCompressedData, AccountInfoWithJsonData, Commitment, DataSlice, Slot, SolanaRpcResponse } from '@solana/rpc-types';
+type GetAccountInfoApiResponseBase = SolanaRpcResponse<AccountInfoBase | null>;
+type NestInRpcResponseOrNull<T> = Readonly<{
+    value: T | null;
+}>;
+type GetAccountInfoApiCommonConfig = Readonly<{
+    commitment?: Commitment;
+    minContextSlot?: Slot;
+}>;
+type GetAccountInfoApiSliceableCommonConfig = Readonly<{
+    dataSlice?: DataSlice;
+}>;
+export interface GetAccountInfoApi extends RpcApiMethods {
+    /**
+     * Returns all information associated with the account of provided public key
+     */
+    getAccountInfo(address: Address, config: GetAccountInfoApiCommonConfig & GetAccountInfoApiSliceableCommonConfig & Readonly<{
+        encoding: 'base64';
+    }>): GetAccountInfoApiResponseBase & NestInRpcResponseOrNull<AccountInfoWithBase64EncodedData>;
+    getAccountInfo(address: Address, config: GetAccountInfoApiCommonConfig & GetAccountInfoApiSliceableCommonConfig & Readonly<{
+        encoding: 'base64+zstd';
+    }>): GetAccountInfoApiResponseBase & NestInRpcResponseOrNull<AccountInfoWithBase64EncodedZStdCompressedData>;
+    getAccountInfo(address: Address, config: GetAccountInfoApiCommonConfig & Readonly<{
+        encoding: 'jsonParsed';
+    }>): GetAccountInfoApiResponseBase & NestInRpcResponseOrNull<AccountInfoWithJsonData>;
+    getAccountInfo(address: Address, config: GetAccountInfoApiCommonConfig & GetAccountInfoApiSliceableCommonConfig & Readonly<{
+        encoding: 'base58';
+    }>): GetAccountInfoApiResponseBase & NestInRpcResponseOrNull<AccountInfoWithBase58EncodedData>;
+    getAccountInfo(address: Address, config?: GetAccountInfoApiCommonConfig): GetAccountInfoApiResponseBase & NestInRpcResponseOrNull<AccountInfoWithBase58Bytes>;
+}
+export {};
+//# sourceMappingURL=getAccountInfo.d.ts.map

package/dist/types/rpc-api/getAccountInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAccountInfo.d.ts","sourceRoot":"","sources":["../../../src/rpc-api/getAccountInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EACR,eAAe,EACf,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EAChC,8CAA8C,EAC9C,uBAAuB,EACvB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,iBAAiB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,6BAA6B,GAAG,iBAAiB,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAE/E,KAAK,uBAAuB,CAAC,CAAC,IAAI,QAAQ,CAAC;IACvC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACnB,CAAC,CAAC;AAEH,KAAK,6BAA6B,GAAG,QAAQ,CAAC;IAE1C,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,cAAc,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC,CAAC;AAEH,KAAK,sCAAsC,GAAG,QAAQ,CAAC;IAEnD,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACpD;;OAEG;IACH,cAAc,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,6BAA6B,GACjC,sCAAsC,GACtC,QAAQ,CAAC;QACL,QAAQ,EAAE,QAAQ,CAAC;KACtB,CAAC,GACP,6BAA6B,GAAG,uBAAuB,CAAC,gCAAgC,CAAC,CAAC;IAC7F,cAAc,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,6BAA6B,GACjC,sCAAsC,GACtC,QAAQ,CAAC;QACL,QAAQ,EAAE,aAAa,CAAC;KAC3B,CAAC,GACP,6BAA6B,GAAG,uBAAuB,CAAC,8CAA8C,CAAC,CAAC;IAC3G,cAAc,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,6BAA6B,GACjC,QAAQ,CAAC;QACL,QAAQ,EAAE,YAAY,CAAC;KAC1B,CAAC,GACP,6BAA6B,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,CAAC;IACpF,cAAc,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,6BAA6B,GACjC,sCAAsC,GACtC,QAAQ,CAAC;QACL,QAAQ,EAAE,QAAQ,CAAC;KACtB,CAAC,GACP,6BAA6B,GAAG,uBAAuB,CAAC,gCAAgC,CAAC,CAAC;IAC7F,cAAc,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,6BAA6B,GACvC,6BAA6B,GAAG,uBAAuB,CAAC,0BAA0B,CAAC,CAAC;CAC1F"}

package/dist/types/rpc-api/getMultipleAccounts.d.ts

@@ -0,0 +1,44 @@
+import type { Address } from '@solana/addresses';
+import type { RpcApiMethods } from '@solana/rpc-spec';
+import type { AccountInfoBase, AccountInfoWithBase58EncodedData, AccountInfoWithBase64EncodedData, AccountInfoWithBase64EncodedZStdCompressedData, AccountInfoWithJsonData, Commitment, DataSlice, Slot, SolanaRpcResponse } from '@solana/rpc-types';
+type GetMultipleAccountsApiResponseBase = AccountInfoBase | null;
+type GetMultipleAccountsApiCommonConfig = Readonly<{
+    /** Defaults to `finalized` */
+    commitment?: Commitment;
+    /** The minimum slot that the request can be evaluated at */
+    minContextSlot?: Slot;
+}>;
+type GetMultipleAccountsApiSliceableCommonConfig = Readonly<{
+    /** Limit the returned account data */
+    dataSlice?: DataSlice;
+}>;
+export interface GetMultipleAccountsApi extends RpcApiMethods {
+    /**
+     * Returns the account information for a list of Pubkeys.
+     */
+    getMultipleAccounts(
+    /** An array of up to 100 Pubkeys to query */
+    addresses: Address[], config: GetMultipleAccountsApiCommonConfig & GetMultipleAccountsApiSliceableCommonConfig & Readonly<{
+        encoding: 'base64';
+    }>): SolanaRpcResponse<(GetMultipleAccountsApiResponseBase & (AccountInfoWithBase64EncodedData | null))[]>;
+    getMultipleAccounts(
+    /** An array of up to 100 Pubkeys to query */
+    addresses: Address[], config: GetMultipleAccountsApiCommonConfig & GetMultipleAccountsApiSliceableCommonConfig & Readonly<{
+        encoding: 'base64+zstd';
+    }>): SolanaRpcResponse<(GetMultipleAccountsApiResponseBase & (AccountInfoWithBase64EncodedZStdCompressedData | null))[]>;
+    getMultipleAccounts(
+    /** An array of up to 100 Pubkeys to query */
+    addresses: Address[], config: GetMultipleAccountsApiCommonConfig & Readonly<{
+        encoding: 'jsonParsed';
+    }>): SolanaRpcResponse<(GetMultipleAccountsApiResponseBase & (AccountInfoWithJsonData | null))[]>;
+    getMultipleAccounts(
+    /** An array of up to 100 Pubkeys to query */
+    addresses: Address[], config: GetMultipleAccountsApiCommonConfig & GetMultipleAccountsApiSliceableCommonConfig & Readonly<{
+        encoding: 'base58';
+    }>): SolanaRpcResponse<(GetMultipleAccountsApiResponseBase & (AccountInfoWithBase58EncodedData | null))[]>;
+    getMultipleAccounts(
+    /** An array of up to 100 Pubkeys to query */
+    addresses: Address[], config?: GetMultipleAccountsApiCommonConfig): SolanaRpcResponse<(GetMultipleAccountsApiResponseBase & (AccountInfoWithBase64EncodedData | null))[]>;
+}
+export {};
+//# sourceMappingURL=getMultipleAccounts.d.ts.map

package/dist/types/rpc-api/getMultipleAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMultipleAccounts.d.ts","sourceRoot":"","sources":["../../../src/rpc-api/getMultipleAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EACR,eAAe,EACf,gCAAgC,EAChC,gCAAgC,EAChC,8CAA8C,EAC9C,uBAAuB,EACvB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,iBAAiB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,kCAAkC,GAAG,eAAe,GAAG,IAAI,CAAC;AAEjE,KAAK,kCAAkC,GAAG,QAAQ,CAAC;IAC/C,8BAA8B;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC,CAAC;AAEH,KAAK,2CAA2C,GAAG,QAAQ,CAAC;IACxD,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IACzD;;OAEG;IACH,mBAAmB;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,kCAAkC,GACtC,2CAA2C,GAC3C,QAAQ,CAAC;QACL,QAAQ,EAAE,QAAQ,CAAC;KACtB,CAAC,GACP,iBAAiB,CAAC,CAAC,kCAAkC,GAAG,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACzG,mBAAmB;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,kCAAkC,GACtC,2CAA2C,GAC3C,QAAQ,CAAC;QACL,QAAQ,EAAE,aAAa,CAAC;KAC3B,CAAC,GACP,iBAAiB,CAChB,CAAC,kCAAkC,GAAG,CAAC,8CAA8C,GAAG,IAAI,CAAC,CAAC,EAAE,CACnG,CAAC;IACF,mBAAmB;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,kCAAkC,GACtC,QAAQ,CAAC;QACL,QAAQ,EAAE,YAAY,CAAC;KAC1B,CAAC,GACP,iBAAiB,CAAC,CAAC,kCAAkC,GAAG,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAChG,mBAAmB;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,kCAAkC,GACtC,2CAA2C,GAC3C,QAAQ,CAAC;QACL,QAAQ,EAAE,QAAQ,CAAC;KACtB,CAAC,GACP,iBAAiB,CAAC,CAAC,kCAAkC,GAAG,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACzG,mBAAmB;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,CAAC,EAAE,kCAAkC,GAC5C,iBAAiB,CAAC,CAAC,kCAAkC,GAAG,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;CAC5G"}

package/dist/types/rpc-api/index.d.ts

@@ -0,0 +1,4 @@
+export * from './common.js';
+export * from './getAccountInfo.js';
+export * from './getMultipleAccounts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/rpc-api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rpc-api/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/accounts",
-  "version": "2.0.0-experimental.a1fafee",
+  "version": "2.0.0-experimental.ac2c1c8",
   "description": "Helpers for representing, fetching and decoding Solana accounts",
   "exports": {
     "browser": {
@@ -46,33 +46,11 @@
     "maintained node versions"
   ],
   "dependencies": {
-    "@solana/addresses": "2.0.0-experimental.a1fafee",
-    "@solana/codecs-core": "2.0.0-experimental.a1fafee",
-    "@solana/codecs-strings": "2.0.0-experimental.a1fafee",
-    "@solana/rpc-core": "2.0.0-experimental.a1fafee",
-    "@solana/rpc-transport": "2.0.0-experimental.a1fafee",
-    "@solana/rpc-types": "2.0.0-experimental.a1fafee"
-  },
-  "devDependencies": {
-    "@solana/eslint-config-solana": "^1.0.2",
-    "@swc/jest": "^0.2.29",
-    "@types/jest": "^29.5.11",
-    "@typescript-eslint/eslint-plugin": "^6.13.2",
-    "@typescript-eslint/parser": "^6.3.0",
-    "agadoo": "^3.0.0",
-    "eslint": "^8.45.0",
-    "eslint-plugin-sort-keys-fix": "^1.1.2",
-    "jest": "^29.7.0",
-    "jest-runner-eslint": "^2.1.2",
-    "jest-runner-prettier": "^1.0.0",
-    "prettier": "^3.1",
-    "tsup": "^8.0.1",
-    "typescript": "^5.2.2",
-    "version-from-git": "^1.1.1",
-    "build-scripts": "0.0.0",
-    "test-config": "0.0.0",
-    "test-matchers": "0.0.0",
-    "tsconfig": "0.0.0"
+    "@solana/addresses": "2.0.0-experimental.ac2c1c8",
+    "@solana/codecs-core": "2.0.0-experimental.ac2c1c8",
+    "@solana/codecs-strings": "2.0.0-experimental.ac2c1c8",
+    "@solana/rpc-spec": "2.0.0-experimental.ac2c1c8",
+    "@solana/rpc-types": "2.0.0-experimental.ac2c1c8"
   },
   "bundlewatch": {
     "defaultCompression": "gzip",
@@ -84,17 +62,18 @@
   },
   "scripts": {
     "compile:js": "tsup --config build-scripts/tsup.config.package.ts",
-    "compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/build-scripts/add-js-extension-to-types.mjs",
-    "dev": "jest -c node_modules/test-config/jest-dev.config.ts --rootDir . --watch",
-    "publish-packages": "pnpm publish --tag experimental --access public --no-git-checks",
+    "compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/@solana/build-scripts/add-js-extension-to-types.mjs",
+    "dev": "jest -c node_modules/@solana/test-config/jest-dev.config.ts --rootDir . --watch",
+    "publish-impl": "npm view $npm_package_name@$npm_package_version > /dev/null 2>&1 || pnpm publish --tag experimental --access public --no-git-checks",
+    "publish-packages": "pnpm prepublishOnly && pnpm publish-impl",
     "style:fix": "pnpm eslint --fix src/* && pnpm prettier -w src/* package.json",
-    "test:lint": "jest -c node_modules/test-config/jest-lint.config.ts --rootDir . --silent",
-    "test:prettier": "jest -c node_modules/test-config/jest-prettier.config.ts --rootDir . --silent",
+    "test:lint": "jest -c node_modules/@solana/test-config/jest-lint.config.ts --rootDir . --silent",
+    "test:prettier": "jest -c node_modules/@solana/test-config/jest-prettier.config.ts --rootDir . --silent",
     "test:treeshakability:browser": "agadoo dist/index.browser.js",
     "test:treeshakability:native": "agadoo dist/index.native.js",
     "test:treeshakability:node": "agadoo dist/index.node.js",
     "test:typecheck": "tsc --noEmit",
-    "test:unit:browser": "jest -c node_modules/test-config/jest-unit.config.browser.ts --rootDir . --silent",
-    "test:unit:node": "jest -c node_modules/test-config/jest-unit.config.node.ts --rootDir . --silent"
+    "test:unit:browser": "jest -c node_modules/@solana/test-config/jest-unit.config.browser.ts --rootDir . --silent",
+    "test:unit:node": "jest -c node_modules/@solana/test-config/jest-unit.config.node.ts --rootDir . --silent"
   }
 }