ReverseLookupName

gRPC

RPC Methodsui.rpc.v2.NameService/ReverseLookupName

Performs a reverse lookup on a Sui address to find the associated SuiNS name.

Proto files required

Running the examples below requires the official Sui proto files. Download the proto files, then set the example's -import-path relative to the proto root (the -proto path in the examples is relative to the proto root).

github.com/MystenLabs/sui-apis/tree/main/proto

TransportgRPC

Request and response messages are identical for both transports. Only the wire protocol, headers, and client library differ.

Protocol: Native gRPC over HTTP/2 with TLS. Suited to server-side clients and grpcurl.
Content-Type: application/grpc
Headers: x-api-key
Streaming: Server, client, and bidirectional streaming are all supported.
Errors: grpc-status and grpc-message are delivered as HTTP/2 trailers.

Request Message

addressstringrequired

Required. The address to perform a reverse lookup for.

Response Message

The record for the SuiNS name linked to the requested address.

idstring

Record ID.

namestring

SuiNS name.

registration_nft_idstring

RegistrationNFT ID.

expiration_timestampstring

Expiration timestamp.

target_addressstring

Resolved target address.

Additional data entries.

keystring

Entry key.

valuestring

Entry value.

X-API-KEY

grpcurl

grpcurl \
  -import-path . \
  -proto sui/rpc/v2/name_service.proto \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
  "address": "0x0000000000000000000000000000000000000000000000000000000000000001"
}' \
  sui-mainnet.nodit.io:443 \
  sui.rpc.v2.NameService/ReverseLookupName