> ## Documentation Index
> Fetch the complete documentation index at: https://lightprotocol-migration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# JSON RPC Methods
> Overview of all available ZK compression JSON RPC endpoints on Solana, best practices, and error codes.
[Helius Labs](https://github.com/helius-labs) maintains the canonical RPC API and [Photon indexer implementation](https://github.com/helius-labs/photon).
Interact with compressed accounts directly with the ZK Compression JSON RPC API. It's a thin wrapper extending [Solana's web3.js `Connection` class](https://solana-labs.github.io/solana-web3.js/classes/Connection.html) with compression-related endpoints.
The API exposed by the indexer closely mirrors existing RPC calls, with one-to-one mapping:
| Solana RPC | Photon RPC Calls |
| :---------------------- | :-------------------------------- |
| getAccountInfo | getCompressedAccount |
| getBalance | getCompressedBalance |
| getTokenAccountsByOwner | getCompressedTokenAccountsByOwner |
| getProgramAccounts | getCompressedAccountsByOwner |
### Creating an RPC Connection
Ask anything about the ZK Compression RPC API via
Connect to a specific RPC endpoint
```typescript highlight={6-7} theme={null}
import {
Rpc,
createRpc,
} from "@lightprotocol/stateless.js";
// Helius exposes Solana and Photon RPC endpoints through a single URL
const RPC_ENDPOINT = "https://mainnet.helius-rpc.com?api-key=";
const PHOTON_ENDPOINT = RPC_ENDPOINT;
const PROVER_ENDPOINT = RPC_ENDPOINT;
const connection: Rpc = createRpc(RPC_ENDPOINT, PHOTON_ENDPOINT, PROVER_ENDPOINT)
console.log("connection", connection);
```
```typescript highlight={6-7} theme={null}
import {
Rpc,
createRpc,
} from "@lightprotocol/stateless.js";
// Helius exposes Solana and Photon RPC endpoints through a single URL
const RPC_ENDPOINT = "https://devnet.helius-rpc.com?api-key=";
const PHOTON_ENDPOINT = RPC_ENDPOINT;
const PROVER_ENDPOINT = RPC_ENDPOINT;
const connection: Rpc = createRpc(RPC_ENDPOINT, PHOTON_ENDPOINT, PROVER_ENDPOINT)
console.log("connection", connection);
```
#### Best Practices
| Best Practice | Description |
| :-------------------- | :------------------------------------------------------------------------------------------------------------ |
| **Commitment Levels** | Use appropriate commitment levels: `processed` (fastest), `confirmed` (balanced), `finalized` (most reliable) |
| **Rate Limiting** | Implement retry logic and respect rate limits. Public endpoints: 100 req/s, Private: 1000+ req/s |
| **Batch Requests** | Use batch requests when possible to improve efficiency and reduce API calls |
| **Caching** | Cache frequently accessed data to reduce API calls and improve performance |
#### Error Codes
| Code | Message | Description |
| :----- | :------------------- | :------------------------------------------- |
| -32600 | Invalid Request | The JSON sent is not a valid Request object |
| -32601 | Method not found | The method does not exist / is not available |
| -32602 | Invalid params | Invalid method parameter(s) |
| -32603 | Internal error | Internal JSON-RPC error |
| -32000 | Account not found | The compressed account was not found |
| -32001 | Invalid account hash | The provided account hash is invalid |
### Mainnet ZK Compression JSON RPC Methods
Retrieves information about a specific compressed account by its address or hash.
Returns all compressed accounts owned by a specific address.
Retrieves the balance of a compressed account.
Gets the total balance of all compressed accounts owned by an address.
Lists all holders of a specific compressed token mint.
Retrieves the token balance of a compressed token account.
Returns all compressed token accounts delegated to a specific address.
Lists all compressed token accounts owned by a specific address.
Retrieves all token balances for compressed accounts owned by an address.
Returns signatures for transactions involving a compressed account.
Retrieves signatures for transactions involving a specific address.
Returns signatures for transactions where an address is the owner.
Lists signatures for transactions involving tokens owned by an address.
Returns the health status of the compression indexer.
Retrieves the current slot of the compression indexer.
Returns the most recent transaction signatures related to compression.
Retrieves recent non-voting transaction signatures.
Retrieves multiple compressed accounts in a single request.
Returns proofs that the new addresses are not taken already and can be created.
Returns transaction details with additional compression-related information.
Retrieves a validity proof for compressed data.