List dynamic fields

POST

https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lists dynamic fields owned by a parent object.

gRPC method: sui.rpc.v2.StateService.ListDynamicFields (unary).

This is a gRPC method (HTTP/2, Protocol Buffers), not a REST endpoint. The request and response bodies below are shown in the proto3 JSON form that tools such as grpcurl and Postman accept and print. Pass your NOWNodes API key as the api-key gRPC metadata header. Proto files: sui/rpc/v2/state_service.proto.

Example grpcurl request:

Copied!

grpcurl \
  -insecure \
  -H 'api-key: YOUR_API_KEY' \
  -emit-defaults \
  -proto './sui-apis-grpc/proto/sui/rpc/v2/state_service.proto' \
  -import-path './sui-apis-grpc/proto' \
  -d '{"parent": "0xPARENT_OBJECT_ID", "pageSize": 50}' \
  'sui-grpc.nownodes.io' \
  sui.rpc.v2.StateService.ListDynamicFields

Body

application/json

Request message for NodeService.ListDynamicFields

parentstring

Required. The UID of the parent, which owns the collections of dynamic fields.

pageSizeinteger<uint32>

The maximum number of dynamic fields to return. The service may return fewer than this value. If unspecified, at most 50 entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageTokenstring<byte>

A page token, received from a previous ListDynamicFields call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListDynamicFields must match the call that provided the page token. Base64-encoded bytes.

readMaskobject

Mask specifying which fields to read. If no mask is specified, defaults to parent,field_id. Read mask: list of field paths to return, in snake_case (e.g. "object_id", "version", "digest"). Nested fields use dots (e.g. "effects.status").

Show child attributes

pathsArray<string>required

Field paths to return.

Response

200OK

Successful response.

default

gRPC error. The status code (e.g. UNAUTHENTICATED, INVALID_ARGUMENT, NOT_FOUND) is returned in the grpc-status trailer, details in grpc-message.

List dynamic fields

curl -X POST 'https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields' \
  -H 'Content-Type: application/json' \
  -d '{
    "parent": "string",
    "pageSize": 0,
    "pageToken": "dGVzdA==",
    "readMask": {
      "paths": [
        "string"
      ]
    }
  }'

const response = await fetch('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "parent": "string",
      "pageSize": 0,
      "pageToken": "dGVzdA==",
      "readMask": {
        "paths": [
          "string"
        ]
      }
    }),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "parent": "string",
    "pageSize": 0,
    "pageToken": "dGVzdA==",
    "readMask": {
      "paths": [
        "string"
      ]
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

payload = {
  "parent": "string",
  "pageSize": 0,
  "pageToken": "dGVzdA==",
  "readMask": {
    "paths": [
      "string"
    ]
  }
}

response = requests.post('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields', json=payload)
data = response.json()

const response = await fetch('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "parent": "string",
      "pageSize": 0,
      "pageToken": "dGVzdA==",
      "readMask": {
        "paths": [
          "string"
        ]
      }
    }),
});

const data = await response.json();

const endpoint = "https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({
    "parent": "string",
    "pageSize": 0,
    "pageToken": "dGVzdA==",
    "readMask": {
      "paths": [
        "string"
      ]
    }
  });
console.log(result);

const response = await fetch('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "parent": "string",
      "pageSize": 0,
      "pageToken": "dGVzdA==",
      "readMask": {
        "paths": [
          "string"
        ]
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "parent": "string",
  "pageSize": 0,
  "pageToken": "dGVzdA==",
  "readMask": {
    "paths": [
      "string"
    ]
  }
}

response = requests.post('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://sui-grpc.nownodes.io/sui.rpc.v2.StateService/ListDynamicFields')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "parent": "string",
    "pageSize": 0,
    "pageToken": "dGVzdA==",
    "readMask": {
      "paths": [
        "string"
      ]
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "parent": "0xPARENT_OBJECT_ID",
  "pageSize": 50
}