# Sui JSON-RPC Removal and Migration Guide

Sui removed the JSON-RPC service from full nodes in `mainnet-v1.82.3`. Dwellir's Sui full-node endpoint now uses gRPC for live node access, transaction execution, historical scans within the node's retention window, and real-time streams.

Applications that call Sui JSON-RPC methods must migrate to gRPC or GraphQL. Changing only the URL does not work because the request and response schemas differ.

## Official Timeline

Sui disabled JSON-RPC on Sui Foundation mainnet full nodes during the week of July 27, 2026. The remaining infrastructure was scheduled for full decommission, including code removal, in mid-October 2026.

- [Sui mainnet-v1.82.3 release](https://github.com/MystenLabs/sui/releases/tag/mainnet-v1.82.3)
- [Official JSON-RPC migration guide](https://docs.sui.io/develop/accessing-data/json-rpc-migration)
- [Sui gRPC documentation](https://docs.sui.io/develop/accessing-data/grpc)

## Choose gRPC or GraphQL

Use gRPC for transaction execution, recent ledger data, current state, typed clients, and live checkpoint, transaction, or event streams. Use GraphQL for joined queries, flexible filtering, and historical data beyond a full node's retention window.

| Retired JSON-RPC method          | gRPC replacement                                                                                                                              | GraphQL guidance                                       |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `sui_getCheckpoint`              | [`LedgerService.GetCheckpoint`](https://www.dwellir.com/docs/sui/grpc/ledger/get-checkpoint)                                                                         | `Query.checkpoint`                                     |
| `sui_getTransactionBlock`        | [`LedgerService.GetTransaction`](https://www.dwellir.com/docs/sui/grpc/ledger/get-transaction)                                                                       | `Query.transaction`                                    |
| `sui_multiGetTransactionBlocks`  | [`LedgerService.BatchGetTransactions`](https://www.dwellir.com/docs/sui/grpc/ledger/batch-get-transactions)                                                          | `Query.multiGetTransactions`                           |
| `sui_getObject`                  | [`LedgerService.GetObject`](https://www.dwellir.com/docs/sui/grpc/ledger/get-object)                                                                                 | `Query.object`                                         |
| `sui_multiGetObjects`            | [`LedgerService.BatchGetObjects`](https://www.dwellir.com/docs/sui/grpc/ledger/batch-get-objects)                                                                    | `Query.multiGetObjects`                                |
| `suix_getBalance`                | [`StateService.GetBalance`](https://www.dwellir.com/docs/sui/grpc/state/get-balance)                                                                                 | `Address.balance`                                      |
| `suix_getAllBalances`            | [`StateService.ListBalances`](https://www.dwellir.com/docs/sui/grpc/state/list-balances)                                                                             | `Address.balances`                                     |
| `suix_getCoins`                  | [`StateService.ListOwnedObjects`](https://www.dwellir.com/docs/sui/grpc/state/list-owned-objects) with `object_type: "0x2::coin::Coin<T>"` for coin type `T`         | `Address.objects`                                      |
| `suix_getDynamicFields`          | [`StateService.ListDynamicFields`](https://www.dwellir.com/docs/sui/grpc/state/list-dynamic-fields)                                                                  | `Object.dynamicFields`                                 |
| `suix_queryTransactionBlocks`    | [`LedgerService.ListTransactions`](https://www.dwellir.com/docs/sui/grpc/ledger/list-transactions)                                                                   | `Query.transactions`                                   |
| `suix_queryEvents`               | [`LedgerService.ListEvents`](https://www.dwellir.com/docs/sui/grpc/ledger/list-events)                                                                               | `Query.events`                                         |
| `sui_executeTransactionBlock`    | [`TransactionExecutionService.ExecuteTransaction`](https://www.dwellir.com/docs/sui/grpc/transaction/execute)                                                        | `Mutation.executeTransaction`                          |
| `sui_dryRunTransactionBlock`     | [`TransactionExecutionService.SimulateTransaction`](https://www.dwellir.com/docs/sui/grpc/state/simulate-transaction)                                                | `Query.simulateTransaction`                            |
| `sui_devInspectTransactionBlock` | [`TransactionExecutionService.SimulateTransaction`](https://www.dwellir.com/docs/sui/grpc/state/simulate-transaction), with `checks: DISABLED` and `command_outputs` | Use GraphQL simulation for equivalent inspection needs |
| `suix_getCoinMetadata`           | [`StateService.GetCoinInfo`](https://www.dwellir.com/docs/sui/grpc/state/get-coin-info), read `metadata`                                                             | Coin metadata queries                                  |
| `suix_getCommitteeInfo`          | [`LedgerService.GetEpoch`](https://www.dwellir.com/docs/sui/grpc/ledger/get-epoch), read `epoch.committee`                                                           | Epoch validator membership                             |
| `suix_getLatestSuiSystemState`   | [`LedgerService.GetEpoch`](https://www.dwellir.com/docs/sui/grpc/ledger/get-epoch), read `epoch.system_state`                                                        | Current epoch system state                             |
| `suix_getOwnedObjects`           | [`StateService.ListOwnedObjects`](https://www.dwellir.com/docs/sui/grpc/state/list-owned-objects)                                                                    | Use GraphQL for unsupported object filters             |
| `suix_getReferenceGasPrice`      | [`LedgerService.GetEpoch`](https://www.dwellir.com/docs/sui/grpc/ledger/get-epoch), read `epoch.reference_gas_price`                                                 | Current epoch gas price                                |
| `suix_getTotalSupply`            | [`StateService.GetCoinInfo`](https://www.dwellir.com/docs/sui/grpc/state/get-coin-info), read `treasury.total_supply`                                                | Coin supply queries                                    |
| `suix_getStakes`                 | No one-to-one gRPC method; query staking objects and decode their state                                                                       | Follow the official staking migration guidance         |
| `suix_getValidatorsApy`          | No direct full-node APY method; calculate from epoch data or use an indexer                                                                   | Follow the official validator APY migration guidance   |

The [official migration guide](https://docs.sui.io/develop/accessing-data/json-rpc-migration) covers staking, validator APY, normalized Move metadata, and transaction builders. Some replacements require additional decoding or computation.

## Connect to Dwellir gRPC

Use TLS on port 443 and send the API key as metadata:

```bash
grpcurl \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{}' \
  api-sui-mainnet-full.n.dwellir.com:443 \
  sui.rpc.v2.LedgerService/GetServiceInfo
```

Continue with the [Sui gRPC overview](https://www.dwellir.com/docs/sui/grpc-overview) or open the [complete gRPC method reference](https://www.dwellir.com/docs/sui#api-reference).
