JSON-RPC Gateway

Drop-in replacement for Sui RPC nodes, powered by Inodra-managed infrastructure.

📌 Continued JSON-RPC Support

While Sui has deprecated JSON-RPC in favor of GraphQL and gRPC, Inodra's JSON-RPC gateway keeps working beyond Sui's July 31, 2026 shutdown. We maintain compatibility by translating requests to gRPC, GraphQL, or our indexed data sources behind the scenes, and we will announce any future change to JSON-RPC availability well in advance. We recommend new integrations use gRPC or GraphQL for long-term stability.

Overview

The JSON-RPC gateway provides 100% compatibility with the official Sui JSON-RPC specification. Simply replace your Sui node URL with Inodra's endpoint and add your API key.

Endpoint: https://mainnet-api.inodra.com/v1/jsonrpc

Quick Start

1. Update Your Client (SDK 2.0)

import { SuiJsonRpcClient, JsonRpcHTTPTransport } from '@mysten/sui/jsonRpc'

// Create transport with Inodra endpoint and API key
const transport = new JsonRpcHTTPTransport({
  url: 'https://mainnet-api.inodra.com/v1/jsonrpc',
  rpc: {
    headers: { 'x-api-key': 'YOUR_API_KEY' }
  }
})

const client = new SuiJsonRpcClient({
  transport,
  network: 'mainnet'
})

2. Test Connection

// All JSON-RPC methods available
const checkpoint = await client.getLatestCheckpointSequenceNumber()
const balance = await client.getBalance({ owner: '0x123...' })

Understanding the Deprecation

Sui has deprecated JSON-RPC in favor of gRPC and GraphQL. Public JSON-RPC endpoints are shut down in stages during July 2026, with full deactivation on July 31, 2026. Here's what this means for you:

What's happening:

• Sui will stop maintaining the JSON-RPC interface
• New features may only be available via gRPC
• Official Sui SDK support for JSON-RPC will end

What Inodra does:

• Currently, we route JSON-RPC requests directly to Sui nodes
• After Sui removes JSON-RPC, our gateway keeps serving it by translating requests to gRPC, GraphQL, or our indexed data - and any future change to JSON-RPC availability will be announced well in advance
• You should still plan a migration to gRPC or GraphQL, but Inodra lets you do it on your own schedule instead of Sui's

Preparing for the Future

Even if you stay on JSON-RPC now, here's how to prepare:

1. Use Inodra - We handle the translation, so you're already future-proofed
2. Isolate your RPC calls - Keep them in a service layer for easier migration
3. Read the migration guide - Understand what changes when you're ready

🚀 Ready to try it?

Get your free API key and start making requests in under 2 minutes. The same key works for JSON-RPC, gRPC, and GraphQL.