With the new Web3.js 2.0 comes a brand-new client-side GraphQL resolver for the Solana JSON RPC.

@solana/rpc-graphql

This GraphQL library:

• Allows developers to make requests to the Solana JSON RPC using GraphQL queries.
• Provides a full type schema around Solana's jsonParsed type spec.
• Offers highly-optimized usage of RPC requests out of the box.
• Supports the Relay server specification, enabling Relay-native web applications.

Provided here for demonstration is a web application - a basic, read-only wallet and block explorer - that aims to showcase the GraphQL library's capabilities.

• Querying the Solana RPC with GraphQL
• Accounts:
  • Querying program accounts
  • Subslicing encoded account data
  • JSON-parsed types
  • Extending account types (IDL)
• Instructions:
  • Querying transactions
  • Querying blocks
  • JSON-parsed types
  • Extending instruction types (IDL)
• RPC request optimization:
  • Request coalescing
  • Nested queries
  • Response caching
• Relay:
  • node queries
  • Connections

Requirements:

• NodeJS 20
• NPM
• Rust
• Shank CLI: cargo-install shank-cli
• Solana 1.18: sh -c "$(curl -sSfL https://release.solana.com/v1.18.12/install)"

Install the application's dependencies.

npm install

In a separate terminal, start a local test validator. Note the provided npm command will start the local validator with all of the necessary account fixtures and the BPF program.

npm run test-validator

Run the script to generate a bunch of transactions. LOCAL_VALIDATOR_RPC_ENDPOINT will default to http://127.0.0.1:8899 if not provided.

npm run generate-transactions <LOCAL_VALIDATOR_RPC_ENDPOINT>

Launch the application. Note you can define an RPC_ENDPOINT variable in a .env file in the root of the repository if you wish to use a custom endpoint. This value will default to http://127.0.0.1:8899 if not provided.

npm start