Console

gRPCLookupName

sui-mainnet.nodit.io:443 sui.rpc.v2.NameService/LookupNameunary

Looks up a SuiNS name and returns the associated record.

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 Body
namestringrequired

Required. The SuiNS name to lookup. Supports both @name and name.sui formats.

Responses
idstring

Record ID.

namestring

SuiNS name.

registration_nft_idstring

RegistrationNFT ID.

expiration_timestampstring

Expiration timestamp.

target_addressstring

Resolved target address.

dataobject[]

Additional data entries.

keystring

Entry key.

valuestring

Entry value.

X-API-KEY
RequestCU30
grpcurl
grpcurl \
  -import-path . -proto sui/rpc/v2/name_service.proto \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -d '{
  "name": "example.sui"
}' \
  sui-mainnet.nodit.io:443 sui.rpc.v2.NameService/LookupName
Response
Example · 200
{
  "record": {}
}

Last updated