@solana/rpc-graphql 6.3.1 → 6.3.2-canary-20260313112147

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/rpc-graphql",
-  "version": "6.3.1",
+  "version": "6.3.2-canary-20260313112147",
   "description": "A library for resolving GraphQl query calls to the Solana JSON RPC API",
   "homepage": "https://www.solanakit.com/api#solanarpc-graphql",
   "exports": {
@@ -33,7 +33,8 @@
   "types": "./dist/types/index.d.ts",
   "type": "commonjs",
   "files": [
-    "./dist/"
+    "./dist/",
+    "./src/"
   ],
   "sideEffects": false,
   "keywords": [
@@ -58,8 +59,8 @@
     "@graphql-tools/schema": "^10.0.31",
     "dataloader": "^2.2.3",
     "graphql": "^16.13.1",
-    "@solana/codecs-strings": "6.3.1",
-    "@solana/fast-stable-stringify": "6.3.1"
+    "@solana/fast-stable-stringify": "6.3.2-canary-20260313112147",
+    "@solana/codecs-strings": "6.3.2-canary-20260313112147"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"

package/src/context.ts

@@ -0,0 +1,47 @@
+import type {
+    GetAccountInfoApi,
+    GetBlockApi,
+    GetMultipleAccountsApi,
+    GetProgramAccountsApi,
+    GetTransactionApi,
+    Rpc,
+} from '@solana/rpc';
+
+import {
+    createAccountLoader,
+    createBlockLoader,
+    createProgramAccountsLoader,
+    createTransactionLoader,
+    RpcGraphQLLoaders,
+} from './loaders';
+
+type Config = {
+    /**
+     * Maximum number of acceptable bytes to waste before splitting two
+     * `dataSlice` requests into two requests.
+     */
+    maxDataSliceByteRange: number;
+    /**
+     * Maximum number of accounts to fetch in a single batch.
+     * See https://docs.solana.com/api/http#getmultipleaccounts.
+     */
+    maxMultipleAccountsBatchSize: number;
+};
+
+export interface RpcGraphQLContext {
+    loaders: RpcGraphQLLoaders;
+}
+
+export function createSolanaGraphQLContext(
+    rpc: Rpc<GetAccountInfoApi & GetBlockApi & GetMultipleAccountsApi & GetProgramAccountsApi & GetTransactionApi>,
+    config: Config,
+): RpcGraphQLContext {
+    return {
+        loaders: {
+            account: createAccountLoader(rpc, config),
+            block: createBlockLoader(rpc),
+            programAccounts: createProgramAccountsLoader(rpc, config),
+            transaction: createTransactionLoader(rpc),
+        },
+    };
+}

package/src/index.ts

@@ -0,0 +1,65 @@
+import { makeExecutableSchema } from '@graphql-tools/schema';
+import { graphql } from 'graphql';
+
+import { createSolanaGraphQLContext } from './context';
+import { createSolanaGraphQLTypeDefs } from './schema/type-defs';
+import { createSolanaGraphQLTypeResolvers } from './schema/type-resolvers';
+
+export interface RpcGraphQL {
+    query(
+        source: Parameters<typeof graphql>[0]['source'],
+        variableValues?: Parameters<typeof graphql>[0]['variableValues'],
+    ): ReturnType<typeof graphql>;
+}
+
+/**
+ * Create a GraphQL RPC client resolver.
+ *
+ * @param rpc       Solana RPC client.
+ * @param schema    GraphQL schema.
+ * @param config    Optional GraphQL resolver configurations.
+ * @returns         GraphQL RPC client resolver.
+ */
+export function createRpcGraphQL(
+    rpc: Parameters<typeof createSolanaGraphQLContext>[0],
+    schema: ReturnType<typeof makeExecutableSchema>,
+    config?: Partial<Parameters<typeof createSolanaGraphQLContext>[1]>,
+): RpcGraphQL {
+    const rpcGraphQLConfig = {
+        maxDataSliceByteRange: config?.maxDataSliceByteRange ?? 200,
+        maxMultipleAccountsBatchSize: config?.maxMultipleAccountsBatchSize ?? 100,
+    };
+    return {
+        async query(source, variableValues?) {
+            const contextValue = createSolanaGraphQLContext(rpc, rpcGraphQLConfig);
+            return await graphql({
+                contextValue,
+                schema,
+                source,
+                variableValues,
+            });
+        },
+    };
+}
+
+/**
+ * Create a Solana GraphQL RPC client resolver.
+ *
+ * Configures the client resolver to use the default Solana GraphQL schema.
+ *
+ * @param rpc       Solana RPC client.
+ * @param config    Optional GraphQL resolver configurations.
+ * @returns         Solana GraphQL RPC client resolver.
+ */
+export function createSolanaRpcGraphQL(
+    rpc: Parameters<typeof createSolanaGraphQLContext>[0],
+    config?: Partial<Parameters<typeof createSolanaGraphQLContext>[1]>,
+): RpcGraphQL {
+    const schema = makeExecutableSchema({
+        resolvers: createSolanaGraphQLTypeResolvers(),
+        typeDefs: createSolanaGraphQLTypeDefs(),
+    });
+    return createRpcGraphQL(rpc, schema, config);
+}
+
+export { createSolanaGraphQLTypeDefs, createSolanaGraphQLTypeResolvers };