BatchGetObjects gRPC Method

参数

requests

数组

必填

正在加载...

read_mask

对象

正在加载...

paths

数组

正在加载...

退货

objects

数组

正在加载...

对象

对象

正在加载...

bcs

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

objectId

字符串

正在加载...

版本

字符串

正在加载...

摘要

字符串

正在加载...

owner

对象

正在加载...

kind

字符串

正在加载...

版本

字符串

正在加载...

objectType

字符串

正在加载...

hasPublicTransfer

布尔型

正在加载...

contents

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

previousTransaction

字符串

正在加载...

storageRebate

字符串

正在加载...

请求

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/ledger_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "requests": [
7
      { "object_id": "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8" }
8
    ],
9
    "read_mask": {
10
      "paths": [
11
        "bcs",
12
        "object_id",
13
        "version",
14
        "digest",
15
        "owner",
16
        "object_type",
17
        "has_public_transfer",
18
        "contents",
19
        "previous_transaction",
20
        "storage_rebate"
21
      ]
22
    }
23
  }' \
24
  docs-demo.mainnet.quiknode.pro:9000 \
25
  sui.rpc.v2.LedgerService/BatchGetObjects

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/ledger_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "requests": [
7
      { "object_id": "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8" }
8
    ],
9
    "read_mask": {
10
      "paths": [
11
        "bcs",
12
        "object_id",
13
        "version",
14
        "digest",
15
        "owner",
16
        "object_type",
17
        "has_public_transfer",
18
        "contents",
19
        "previous_transaction",
20
        "storage_rebate"
21
      ]
22
    }
23
  }' \
24
  docs-demo.mainnet.quiknode.pro:9000 \
25
  sui.rpc.v2.LedgerService/BatchGetObjects

1
包 main
2

3
import (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	“日志”
9
	“时间”
10

11
	"google.golang.grpc"
12
	"google.golang.grpc"
13
	"google.golang.org/protobuf/encoding/protojson"
14
	"google.golang.org/protobuf/types/known/fieldmaskpb"
15

16
	pb "sui-grpc/sui/rpc/v2"  // Your Generated .pb.go files path
17
)
18

19
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
20
// For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
21
// endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
22
// token will be : abcde123456789
23

24
var (
25
	token    = "您的令牌编号"
26
	endpoint = "您的QN端点:9000"
27
)
28

29
类型 auth 结构体 {
30
	token 字符串
31
}
32

33
func (a *auth) GetRequestMetadata(ctx 上下文.Context, uri ...字符串) (map[字符串]字符串, error) {
34
	return map[string]string{"x-token": a.token}, nil
35
}
36
func (a *auth) RequireTransportSecurity() bool {
37
	返回 true
38
}
39

40
func main() {
41
	creds := credentials.NewTLS(&tls.Config{})
42
	opts := []grpc.DialOption{
43
		grpc.WithTransportCredentials(creds)，
44
		grpc.WithPerRPCCredentials(&auth{令牌}),
45
	}
46

47
	conn, err := grpc.Dial(endpoint, opts...)
48
	如果 err != nil {
49
		log.Fatalf("连接失败：%v", err)
50
	}
51
	推迟 conn.关闭()
52

53
	client := pb.NewLedgerServiceClient(conn)
54

55
	// Object ID to fetch
56
	objectID := "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8"
57

58
	// Build request with field mask
59
	req := &pb.BatchGetObjectsRequest{
60
		Requests: []*pb.GetObjectRequest{
61
			{
62
				ObjectId: &objectID,
63
			},
64
		},
65
		ReadMask: &fieldmaskpb.FieldMask{
66
			Paths: []string{
67
				"object_id",
68
				"version",
69
				"digest",
70
				"owner",
71
				"object_type",
72
				"has_public_transfer",
73
				"contents",
74
				"previous_transaction",
75
				"storage_rebate",
76
				"bcs",
77
			},
78
		},
79
	}
80

81
	ctx, 取消 := context.带超时(context.Background(), 10*时间.第二次)
82
	推迟 取消()
83

84
	resp, err := client.BatchGetObjects(ctx, req)
85
	如果 err != nil {
86
		log.Fatalf("BatchGetObjects failed: %v", err)
87
	}
88

89
	// Pretty print the response
90
	marshaler := protojson.MarshalOptions{
91
		UseProtoNames:   true,
92
		EmitUnpopulated: true,
93
		缩进:          "  ",
94
	}
95

96
	jsonBytes, err := marshaler.Marshal(resp)
97
	如果 err != nil {
98
		log.Fatalf(“序列化失败：%v”, err)
99
	}
100

101
	var pretty map[字符串]接口{}
102
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
103
		log.Fatalf(“无法解析 JSON：%v”, err)
104
	}
105

106
	out， _ := json.MarshalIndent(pretty, "", "  ")
107
	fmt.Println(字符串(out))
108
}
109

1
包 main
2

3
import (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	“日志”
9
	“时间”
10

11
	"google.golang.grpc"
12
	"google.golang.grpc"
13
	"google.golang.org/protobuf/encoding/protojson"
14
	"google.golang.org/protobuf/types/known/fieldmaskpb"
15

16
	pb "sui-grpc/sui/rpc/v2"  // Your Generated .pb.go files path
17
)
18

19
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
20
// For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
21
// endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
22
// token will be : abcde123456789
23

24
var (
25
	token    = "您的令牌编号"
26
	endpoint = "您的QN端点:9000"
27
)
28

29
类型 auth 结构体 {
30
	token 字符串
31
}
32

33
func (a *auth) GetRequestMetadata(ctx 上下文.Context, uri ...字符串) (map[字符串]字符串, error) {
34
	return map[string]string{"x-token": a.token}, nil
35
}
36
func (a *auth) RequireTransportSecurity() bool {
37
	返回 true
38
}
39

40
func main() {
41
	creds := credentials.NewTLS(&tls.Config{})
42
	opts := []grpc.DialOption{
43
		grpc.WithTransportCredentials(creds)，
44
		grpc.WithPerRPCCredentials(&auth{令牌}),
45
	}
46

47
	conn, err := grpc.Dial(endpoint, opts...)
48
	如果 err != nil {
49
		log.Fatalf("连接失败：%v", err)
50
	}
51
	推迟 conn.关闭()
52

53
	client := pb.NewLedgerServiceClient(conn)
54

55
	// Object ID to fetch
56
	objectID := "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8"
57

58
	// Build request with field mask
59
	req := &pb.BatchGetObjectsRequest{
60
		Requests: []*pb.GetObjectRequest{
61
			{
62
				ObjectId: &objectID,
63
			},
64
		},
65
		ReadMask: &fieldmaskpb.FieldMask{
66
			Paths: []string{
67
				"object_id",
68
				"version",
69
				"digest",
70
				"owner",
71
				"object_type",
72
				"has_public_transfer",
73
				"contents",
74
				"previous_transaction",
75
				"storage_rebate",
76
				"bcs",
77
			},
78
		},
79
	}
80

81
	ctx, 取消 := context.带超时(context.Background(), 10*时间.第二次)
82
	推迟 取消()
83

84
	resp, err := client.BatchGetObjects(ctx, req)
85
	如果 err != nil {
86
		log.Fatalf("BatchGetObjects failed: %v", err)
87
	}
88

89
	// Pretty print the response
90
	marshaler := protojson.MarshalOptions{
91
		UseProtoNames:   true,
92
		EmitUnpopulated: true,
93
		缩进:          "  ",
94
	}
95

96
	jsonBytes, err := marshaler.Marshal(resp)
97
	如果 err != nil {
98
		log.Fatalf(“序列化失败：%v”, err)
99
	}
100

101
	var pretty map[字符串]接口{}
102
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
103
		log.Fatalf(“无法解析 JSON：%v”, err)
104
	}
105

106
	out， _ := json.MarshalIndent(pretty, "", "  ")
107
	fmt.Println(字符串(out))
108
}
109

1
import * 作为 grpc from grpc;
2
import * 作为 protoLoader from grpc;
3
import * 作为 路径 from '路径';
4

5
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/ledger_service.proto');
6

7
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
8
// For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
9
// endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
10
// token will be : abcde123456789
11

12
const endpoint = 'docs-demo.mainnet.quiknode.pro:9000';
13
const 令牌 = 'abcde123456789';
14

15
// Load protobuf definitions
16
const 包定义 = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  多头: 字符串,
19
  枚举: 字符串,
20
  默认值: true,
21
  oneofs: true,
22
  includeDirs: [路径.join(__dirname, 'protos/proto')],
23
});
24

25
const proto = grpc.loadPackageDefinition(packageDefinition) 作为 any;
26
const LedgerService = proto.sui.rpc.v2.LedgerService;
27

28
// Create secure client
29
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
30

31
// Add token metadata
32
const 元数据 = new grpc.元数据();
33
元数据.添加('x-token', token);
34

35
// Request payload
36
const 请求 = {
37
  requests: [
38
    {
39
      object_id: '0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8',
40
    },
41
  ],
42
  read_mask: {
43
    paths: [
44
      'bcs',
45
      'object_id',
46
      'version',
47
      'digest',
48
      'owner',
49
      'object_type',
50
      'has_public_transfer',
51
      'contents',
52
      'previous_transaction',
53
      'storage_rebate',
54
    ],
55
  },
56
};
57

58
// Recursively decode Uint8Array or Buffer fields to hex
59
function decodeBytesFields(obj: any): any {
60
  if (Array.isArray(obj)) {
61
    return obj.map(decodeBytesFields);
62
  } else if (obj && typeof obj === 'object') {
63
    const result: any = {};
64
    for (const key of Object.keys(obj)) {
65
      const val = obj[key];
66
      if (val instanceof Uint8Array) {
67
        result[key] = Buffer.from(val).toString('hex');
68
      } else if (val && val.type === 'Buffer' && Array.isArray(val.data)) {
69
        result[key] = Buffer.from(val.data).toString('hex');
70
      } else {
71
        result[key] = decodeBytesFields(val);
72
      }
73
    }
74
    return result;
75
  } else {
76
    return obj;
77
  }
78
}
79

80
// Perform gRPC call
81
client.BatchGetObjects(request, metadata, (err: grpc.ServiceError | null, response: any) => {
82
  如果 (err) {
83
    console.error('gRPC Error:', {
84
      代码: err.代码,
85
      消息: err.消息,
86
      详细信息: err.详情,
87
    });
88
  } else {
89
    const decoded = decodeBytesFields(response);
90
    console.log('BatchGetObjects Response:');
91
    console.log(JSON.stringify(decoded, null, 2));
92
  }
93
});
94

1
import * 作为 grpc from grpc;
2
import * 作为 protoLoader from grpc;
3
import * 作为 路径 from '路径';
4

5
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/ledger_service.proto');
6

7
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
8
// For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
9
// endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
10
// token will be : abcde123456789
11

12
const endpoint = 'docs-demo.mainnet.quiknode.pro:9000';
13
const 令牌 = 'abcde123456789';
14

15
// Load protobuf definitions
16
const 包定义 = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  多头: 字符串,
19
  枚举: 字符串,
20
  默认值: true,
21
  oneofs: true,
22
  includeDirs: [路径.join(__dirname, 'protos/proto')],
23
});
24

25
const proto = grpc.loadPackageDefinition(packageDefinition) 作为 any;
26
const LedgerService = proto.sui.rpc.v2.LedgerService;
27

28
// Create secure client
29
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
30

31
// Add token metadata
32
const 元数据 = new grpc.元数据();
33
元数据.添加('x-token', token);
34

35
// Request payload
36
const 请求 = {
37
  requests: [
38
    {
39
      object_id: '0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8',
40
    },
41
  ],
42
  read_mask: {
43
    paths: [
44
      'bcs',
45
      'object_id',
46
      'version',
47
      'digest',
48
      'owner',
49
      'object_type',
50
      'has_public_transfer',
51
      'contents',
52
      'previous_transaction',
53
      'storage_rebate',
54
    ],
55
  },
56
};
57

58
// Recursively decode Uint8Array or Buffer fields to hex
59
function decodeBytesFields(obj: any): any {
60
  if (Array.isArray(obj)) {
61
    return obj.map(decodeBytesFields);
62
  } else if (obj && typeof obj === 'object') {
63
    const result: any = {};
64
    for (const key of Object.keys(obj)) {
65
      const val = obj[key];
66
      if (val instanceof Uint8Array) {
67
        result[key] = Buffer.from(val).toString('hex');
68
      } else if (val && val.type === 'Buffer' && Array.isArray(val.data)) {
69
        result[key] = Buffer.from(val.data).toString('hex');
70
      } else {
71
        result[key] = decodeBytesFields(val);
72
      }
73
    }
74
    return result;
75
  } else {
76
    return obj;
77
  }
78
}
79

80
// Perform gRPC call
81
client.BatchGetObjects(request, metadata, (err: grpc.ServiceError | null, response: any) => {
82
  如果 (err) {
83
    console.error('gRPC Error:', {
84
      代码: err.代码,
85
      消息: err.消息,
86
      详细信息: err.详情,
87
    });
88
  } else {
89
    const decoded = decodeBytesFields(response);
90
    console.log('BatchGetObjects Response:');
91
    console.log(JSON.stringify(decoded, null, 2));
92
  }
93
});
94

1
import grpc
2
导入 json
3
来源 谷歌.protobuf.field_mask_pb2 导入 FieldMask
4
来源 谷歌.protobuf.json_format import MessageToDict
5
from sui.rpc.v2 import ledger_service_pb2, ledger_service_pb2_grpc
6

7

8
def batch_get_objects():
9

10
    #Quicknode 由两个关键组成部分构成：endpoint 和相应的令牌
11
    # 例如：QNEndpoint：mainnet
12
    # endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
13
    # token will be : abcde123456789
14

15
    endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
16
    token = 'abcde123456789';
17

18
    频道 = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
19
    stub = ledger_service_pb2_grpc.LedgerServiceStub(channel)
20

21
    object_id = "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8"
22

23
    # Define valid read_mask field paths from Object message
24
    read_mask = 字段掩码(路径=[
25
        "bcs",
26
        "object_id",
27
        "version",
28
        "digest",
29
        "owner",
30
        "object_type",
31
        "has_public_transfer",
32
        "contents",
33
        "previous_transaction",
34
        "storage_rebate"
35
    ])
36

37
    request = ledger_service_pb2.BatchGetObjectsRequest(
38
        requests=[ledger_service_pb2.GetObjectRequest(object_id=object_id)],
39
        read_mask=read_mask
40
    )
41

42
    元数据 = [("x-token", token)]
43

44
    return stub.BatchGetObjects(request, metadata=metadata)
45

46

47
def parse_response_to_json(response):
48
    返回 json.dumps(
49
        MessageToDict(response, 保留_proto_字段_名称=True),
50
        缩进=2
51
    )
52

53

54
def main():
55
    试一试：
56
        response = batch_get_objects()
57
        打印(parse_response_to_json(response))
58
    除了 grpc。RpcError 作为 e:
59
        print(f"{e.code().name}: {e.details()}")
60

61

62
如果 __name__ == "__main__":
63
    主()
64

1
import grpc
2
导入 json
3
来源 谷歌.protobuf.field_mask_pb2 导入 FieldMask
4
来源 谷歌.protobuf.json_format import MessageToDict
5
from sui.rpc.v2 import ledger_service_pb2, ledger_service_pb2_grpc
6

7

8
def batch_get_objects():
9

10
    #Quicknode 由两个关键组成部分构成：endpoint 和相应的令牌
11
    # 例如：QNEndpoint：mainnet
12
    # endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
13
    # token will be : abcde123456789
14

15
    endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
16
    token = 'abcde123456789';
17

18
    频道 = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
19
    stub = ledger_service_pb2_grpc.LedgerServiceStub(channel)
20

21
    object_id = "0x27c4fdb3b846aa3ae4a65ef5127a309aa3c1f466671471a806d8912a18b253e8"
22

23
    # Define valid read_mask field paths from Object message
24
    read_mask = 字段掩码(路径=[
25
        "bcs",
26
        "object_id",
27
        "version",
28
        "digest",
29
        "owner",
30
        "object_type",
31
        "has_public_transfer",
32
        "contents",
33
        "previous_transaction",
34
        "storage_rebate"
35
    ])
36

37
    request = ledger_service_pb2.BatchGetObjectsRequest(
38
        requests=[ledger_service_pb2.GetObjectRequest(object_id=object_id)],
39
        read_mask=read_mask
40
    )
41

42
    元数据 = [("x-token", token)]
43

44
    return stub.BatchGetObjects(request, metadata=metadata)
45

46

47
def parse_response_to_json(response):
48
    返回 json.dumps(
49
        MessageToDict(response, 保留_proto_字段_名称=True),
50
        缩进=2
51
    )
52

53

54
def main():
55
    试一试：
56
        response = batch_get_objects()
57
        打印(parse_response_to_json(response))
58
    除了 grpc。RpcError 作为 e:
59
        print(f"{e.code().name}: {e.details()}")
60

61

62
如果 __name__ == "__main__":
63
    主()
64

还没有账号吗？

endpoint 几秒钟endpoint 创建您的Quicknode endpoint ，并开始构建

免费开始使用