@solana/plugin-interfaces 7.0.0 → 7.1.0-canary-20260812151931

package/README.md

@@ -138,6 +138,25 @@ function accountCreationPlugin() {
 }
 ```
 
+### `ClientWithFetchAccounts`
+
+Represents a client that can fetch the encoded content of accounts from their addresses. Different implementations may fetch accounts differently — for example, by calling the `getAccountInfo` and/or `getMultipleAccounts` RPC methods, or by using a locally cached value. The returned array matches the provided addresses in both length and order, using `MaybeEncodedAccount` to represent accounts that may not exist.
+
+```ts
+import { extendClient } from '@solana/plugin-core';
+import { ClientWithFetchAccounts } from '@solana/plugin-interfaces';
+
+function accountLoaderPlugin() {
+    return <T extends ClientWithFetchAccounts>(client: T) =>
+        extendClient(client, {
+            loadExistingAccounts: async (addresses: Address[]) => {
+                const accounts = await client.fetchAccounts(addresses);
+                return accounts.filter(account => account.exists);
+            },
+        });
+}
+```
+
 ### `ClientWithRpc<TRpcMethods>`
 
 Represents a client with access to a Solana RPC endpoint.

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

@@ -0,0 +1,40 @@
+import { FetchAccountsConfig, MaybeEncodedAccount } from '@solana/accounts';
+import { Address } from '@solana/addresses';
+/**
+ * Represents a client that can fetch the content of accounts from their addresses.
+ *
+ * Different implementations may fetch accounts differently — for example, by calling the
+ * `getAccountInfo` and/or `getMultipleAccounts` RPC methods, by reading from a local validator,
+ * or by using a locally cached value.
+ *
+ * Note that this interface only fetches encoded accounts. Callers that need decoded accounts should
+ * decode the returned {@link MaybeEncodedAccount | MaybeEncodedAccounts} themselves using the codec
+ * of their choice.
+ *
+ * If you have a raw `Rpc` object instead of a client, you can construct a client implementing this
+ * interface using the {@link createClientWithFetchAccountsFromRpc} helper from `@solana/kit`.
+ *
+ * @example
+ * ```ts
+ * async function fetchProgramAddresses(client: ClientWithFetchAccounts, addresses: Address[]) {
+ *     const accounts = await client.fetchAccounts(addresses);
+ *     return accounts.filter(account => account.exists).map(account => account.programAddress);
+ * }
+ * ```
+ */
+export type ClientWithFetchAccounts = {
+    /**
+     * Fetches the encoded content of the accounts at the provided addresses.
+     *
+     * The returned array matches the provided addresses in both length and order. Each item is a
+     * {@link MaybeEncodedAccount} so that missing accounts can be represented whilst keeping track
+     * of their address.
+     *
+     * @param addresses - The addresses of the accounts to fetch.
+     * @param config - Optional configuration for the fetch.
+     * @returns A promise resolving to an array of {@link MaybeEncodedAccount | MaybeEncodedAccounts}
+     *          in the same order as the provided addresses.
+     */
+    fetchAccounts: (addresses: Address[], config?: FetchAccountsConfig) => Promise<MaybeEncodedAccount[]>;
+};
+//# sourceMappingURL=fetch-accounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-accounts.d.ts","sourceRoot":"","sources":["../../src/fetch-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACzG,CAAC"}

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@
  * @packageDocumentation
  */
 export * from './airdrop';
+export * from './fetch-accounts';
 export * from './instruction-plans';
 export * from './get-minimum-balance';
 export * from './identity';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/plugin-interfaces",
-  "version": "7.0.0",
+  "version": "7.1.0-canary-20260812151931",
   "description": "TypeScript interfaces for building pluggable Solana clients",
   "homepage": "https://www.solanakit.com/api#solanaplugin-interfaces",
   "types": "./dist/types/index.d.ts",
@@ -29,13 +29,14 @@
     "maintained node versions"
   ],
   "dependencies": {
-    "@solana/addresses": "7.0.0",
-    "@solana/keys": "7.0.0",
-    "@solana/instruction-plans": "7.0.0",
-    "@solana/rpc-spec": "7.0.0",
-    "@solana/rpc-subscriptions-spec": "7.0.0",
-    "@solana/signers": "7.0.0",
-    "@solana/rpc-types": "7.0.0"
+    "@solana/accounts": "7.1.0-canary-20260812151931",
+    "@solana/addresses": "7.1.0-canary-20260812151931",
+    "@solana/instruction-plans": "7.1.0-canary-20260812151931",
+    "@solana/keys": "7.1.0-canary-20260812151931",
+    "@solana/rpc-spec": "7.1.0-canary-20260812151931",
+    "@solana/rpc-subscriptions-spec": "7.1.0-canary-20260812151931",
+    "@solana/rpc-types": "7.1.0-canary-20260812151931",
+    "@solana/signers": "7.1.0-canary-20260812151931"
   },
   "peerDependencies": {
     "typescript": ">=5.4.0"

package/src/fetch-accounts.ts

@@ -0,0 +1,40 @@
+import { FetchAccountsConfig, MaybeEncodedAccount } from '@solana/accounts';
+import { Address } from '@solana/addresses';
+
+/**
+ * Represents a client that can fetch the content of accounts from their addresses.
+ *
+ * Different implementations may fetch accounts differently — for example, by calling the
+ * `getAccountInfo` and/or `getMultipleAccounts` RPC methods, by reading from a local validator,
+ * or by using a locally cached value.
+ *
+ * Note that this interface only fetches encoded accounts. Callers that need decoded accounts should
+ * decode the returned {@link MaybeEncodedAccount | MaybeEncodedAccounts} themselves using the codec
+ * of their choice.
+ *
+ * If you have a raw `Rpc` object instead of a client, you can construct a client implementing this
+ * interface using the {@link createClientWithFetchAccountsFromRpc} helper from `@solana/kit`.
+ *
+ * @example
+ * ```ts
+ * async function fetchProgramAddresses(client: ClientWithFetchAccounts, addresses: Address[]) {
+ *     const accounts = await client.fetchAccounts(addresses);
+ *     return accounts.filter(account => account.exists).map(account => account.programAddress);
+ * }
+ * ```
+ */
+export type ClientWithFetchAccounts = {
+    /**
+     * Fetches the encoded content of the accounts at the provided addresses.
+     *
+     * The returned array matches the provided addresses in both length and order. Each item is a
+     * {@link MaybeEncodedAccount} so that missing accounts can be represented whilst keeping track
+     * of their address.
+     *
+     * @param addresses - The addresses of the accounts to fetch.
+     * @param config - Optional configuration for the fetch.
+     * @returns A promise resolving to an array of {@link MaybeEncodedAccount | MaybeEncodedAccounts}
+     *          in the same order as the provided addresses.
+     */
+    fetchAccounts: (addresses: Address[], config?: FetchAccountsConfig) => Promise<MaybeEncodedAccount[]>;
+};

package/src/index.ts

@@ -6,6 +6,7 @@
  * @packageDocumentation
  */
 export * from './airdrop';
+export * from './fetch-accounts';
 export * from './instruction-plans';
 export * from './get-minimum-balance';
 export * from './identity';