BatchGetTransactions gRPC Method

参数

digests

数组

必填

正在加载...

read_mask

对象

正在加载...

paths

数组

正在加载...

退货

交易

数组

正在加载...

digest

字符串

正在加载...

交易

对象

正在加载...

bcs

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

digest

字符串

正在加载...

版本

整数

正在加载...

kind

对象

正在加载...

programmableTransaction

对象

正在加载...

inputs

数组

正在加载...

kind

字符串

正在加载...

objectId

字符串

正在加载...

mutable

布尔型

正在加载...

pure

字符串

正在加载...

版本

字符串

正在加载...

digest

字符串

正在加载...

commands

数组

正在加载...

moveCall

对象

正在加载...

package

字符串

正在加载...

module

字符串

正在加载...

函数

字符串

正在加载...

typeArguments

数组

正在加载...

arguments

数组

正在加载...

kind

字符串

正在加载...

输入

整数

正在加载...

结果

整数

正在加载...

sender

字符串

正在加载...

gasPayment

对象

正在加载...

objects

数组

正在加载...

objectId

字符串

正在加载...

版本

字符串

正在加载...

digest

字符串

正在加载...

owner

字符串

正在加载...

价格

字符串

正在加载...

budget

字符串

正在加载...

到期

对象

正在加载...

kind

字符串

正在加载...

effects

对象

正在加载...

bcs

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

digest

字符串

正在加载...

版本

整数

正在加载...

状态

对象

正在加载...

success

布尔型

正在加载...

时代

字符串

正在加载...

gasUsed

对象

正在加载...

computationCost

字符串

正在加载...

storageCost

字符串

正在加载...

storageRebate

字符串

正在加载...

nonRefundableStorageFee

字符串

正在加载...

transactionDigest

字符串

正在加载...

gasObject

对象

正在加载...

objectId

字符串

正在加载...

inputState

字符串

正在加载...

inputVersion

字符串

正在加载...

inputDigest

字符串

正在加载...

inputOwner

对象

正在加载...

kind

字符串

正在加载...

地址

字符串

正在加载...

outputState

字符串

正在加载...

outputVersion

字符串

正在加载...

outputDigest

字符串

正在加载...

outputOwner

对象

正在加载...

kind

字符串

正在加载...

地址

字符串

正在加载...

idOperation

字符串

正在加载...

eventsDigest

字符串

正在加载...

dependencies

数组

正在加载...

lamportVersion

字符串

正在加载...

changedObjects

数组

正在加载...

objectId

字符串

正在加载...

inputState

字符串

正在加载...

inputVersion

字符串

正在加载...

inputDigest

字符串

正在加载...

inputOwner

对象

正在加载...

kind

字符串

正在加载...

地址

字符串

正在加载...

outputState

字符串

正在加载...

outputVersion

字符串

正在加载...

outputDigest

字符串

正在加载...

outputOwner

对象

正在加载...

kind

字符串

正在加载...

地址

字符串

正在加载...

idOperation

字符串

正在加载...

objectType

字符串

正在加载...

unchangedConsensusObjects

数组

正在加载...

kind

字符串

正在加载...

objectId

字符串

正在加载...

版本

字符串

正在加载...

digest

字符串

正在加载...

活动

对象

正在加载...

bcs

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

digest

字符串

正在加载...

活动

数组

正在加载...

packageId

字符串

正在加载...

module

字符串

正在加载...

sender

字符串

正在加载...

eventType

字符串

正在加载...

contents

对象

正在加载...

名称

字符串

正在加载...

值

字符串

正在加载...

json

对象

正在加载...

balanceManagerId

字符串

正在加载...

baseAssetQuantityCanceled

字符串

正在加载...

clientOrderId

字符串

正在加载...

isBid

布尔型

正在加载...

订单编号

字符串

正在加载...

originalQuantity

字符串

正在加载...

poolId

字符串

正在加载...

价格

字符串

正在加载...

时间戳

字符串

正在加载...

trader

字符串

正在加载...

请求

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/ledger_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "digests": [
7
      "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
8
    ],
9
    "read_mask": {
10
      "paths": [
11
        "digest",
12
        "transaction",
13
        "effects",
14
        "events"
15
      ]
16
    }
17
  }' \
18
  docs-demo.sui-mainnet.quiknode.pro:9000 \
19
  sui.rpc.v2.LedgerService/BatchGetTransactions

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/ledger_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "digests": [
7
      "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
8
    ],
9
    "read_mask": {
10
      "paths": [
11
        "digest",
12
        "transaction",
13
        "effects",
14
        "events"
15
      ]
16
    }
17
  }' \
18
  docs-demo.sui-mainnet.quiknode.pro:9000 \
19
  sui.rpc.v2.LedgerService/BatchGetTransactions

1
包 main
2

3
导入 (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"日志"
9
	"time"
10

11
	"google.golang.org/grpc"
12
	"google.golang.org/grpc/credentials"
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    = "YOUR_TOKEN_NUMBER"
26
	endpoint = "YOUR_QN_ENDPOINT:9000"
27
)
28

29
// Auth structure for x-token
30
类型 auth 结构体 {
31
	token 字符串
32
}
33

34
func (a *auth) GetRequestMetadata(ctx 上下文.上下文, uri ...字符串) (map[字符串]字符串, error) {
35
	返回 map[字符串]字符串{
36
		“x-token”: a.令牌,
37
	}, nil
38
}
39

40
func (a *auth) RequireTransportSecurity() bool {
41
	return true
42
}
43

44
func main() {
45
	// TLS credentials and x-token auth
46
	creds := credentials.NewTLS(&tls.Config{})
47
	opts := []grpc.DialOption{
48
		grpc.WithTransportCredentials(creds),
49
		grpc.WithPerRPC凭据(&auth{令牌}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	如果 err != nil {
54
		log.Fatalf("Failed to connect: %v", err)
55
	}
56
	defer conn.Close()
57

58
	client := pb.NewLedgerServiceClient(conn)
59

60
	// Digest array
61
	digests := []string{
62
		"HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G",
63
	}
64

65
	// FieldMask to restrict returned fields
66
	readMask := &fieldmaskpb.FieldMask{
67
		Paths: []string{"digest", "transaction", "effects", "events"},
68
	}
69

70
	req := &pb.BatchGetTransactionsRequest{
71
		Digests:  digests,
72
		ReadMask: readMask,
73
	}
74

75
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
76
	defer cancel()
77

78
	resp, err := client.BatchGetTransactions(ctx, req)
79
	如果 err != nil {
80
		log.Fatalf("BatchGetTransactions failed: %v", err)
81
	}
82

83
	// Format response as pretty JSON
84
	marshaler := protojson.MarshalOptions{
85
		UseProtoNames:   true,
86
		EmitUnpopulated: true,
87
		Indent:          "  ",
88
	}
89

90
	jsonBytes, err := marshaler.Marshal(resp)
91
	如果 err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	var pretty map[string]interface{}
96
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
97
		log.Fatalf("Failed to parse JSON: %v", err)
98
	}
99

100
	formatted, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(formatted))
102
}
103

1
包 main
2

3
导入 (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"日志"
9
	"time"
10

11
	"google.golang.org/grpc"
12
	"google.golang.org/grpc/credentials"
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    = "YOUR_TOKEN_NUMBER"
26
	endpoint = "YOUR_QN_ENDPOINT:9000"
27
)
28

29
// Auth structure for x-token
30
类型 auth 结构体 {
31
	token 字符串
32
}
33

34
func (a *auth) GetRequestMetadata(ctx 上下文.上下文, uri ...字符串) (map[字符串]字符串, error) {
35
	返回 map[字符串]字符串{
36
		“x-token”: a.令牌,
37
	}, nil
38
}
39

40
func (a *auth) RequireTransportSecurity() bool {
41
	return true
42
}
43

44
func main() {
45
	// TLS credentials and x-token auth
46
	creds := credentials.NewTLS(&tls.Config{})
47
	opts := []grpc.DialOption{
48
		grpc.WithTransportCredentials(creds),
49
		grpc.WithPerRPC凭据(&auth{令牌}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	如果 err != nil {
54
		log.Fatalf("Failed to connect: %v", err)
55
	}
56
	defer conn.Close()
57

58
	client := pb.NewLedgerServiceClient(conn)
59

60
	// Digest array
61
	digests := []string{
62
		"HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G",
63
	}
64

65
	// FieldMask to restrict returned fields
66
	readMask := &fieldmaskpb.FieldMask{
67
		Paths: []string{"digest", "transaction", "effects", "events"},
68
	}
69

70
	req := &pb.BatchGetTransactionsRequest{
71
		Digests:  digests,
72
		ReadMask: readMask,
73
	}
74

75
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
76
	defer cancel()
77

78
	resp, err := client.BatchGetTransactions(ctx, req)
79
	如果 err != nil {
80
		log.Fatalf("BatchGetTransactions failed: %v", err)
81
	}
82

83
	// Format response as pretty JSON
84
	marshaler := protojson.MarshalOptions{
85
		UseProtoNames:   true,
86
		EmitUnpopulated: true,
87
		Indent:          "  ",
88
	}
89

90
	jsonBytes, err := marshaler.Marshal(resp)
91
	如果 err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	var pretty map[string]interface{}
96
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
97
		log.Fatalf("Failed to parse JSON: %v", err)
98
	}
99

100
	formatted, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(formatted))
102
}
103

1
import * as grpc from '@grpc/grpc-js';
2
import * as protoLoader from '@grpc/proto-loader';
3
import * as path from 'path';
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.sui-mainnet.quiknode.pro:9000';
13
const token = 'abcde123456789';
14

15
// Load proto definition
16
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  longs: String,
19
  enums: String,
20
  defaults: true,
21
  oneofs: true,
22
  includeDirs: [path.join(__dirname, 'protos/proto')],
23
});
24
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
25
const LedgerService = proto.sui.rpc.v2.LedgerService;
26

27
// Create gRPC client with TLS
28
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
29

30
// Metadata for authentication
31
const metadata = new grpc.Metadata();
32
metadata.add('x-token', token);
33

34
// Request setup
35
const request = {
36
  digests: ['HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G'], // Replace with valid digests
37
  read_mask: {
38
    paths: ['digest', 'transaction', 'effects', 'events'], // FieldMask
39
  },
40
};
41

42
// Invoke BatchGetTransactions
43
client.BatchGetTransactions(request, metadata, (err: grpc.ServiceError | null, response: any) => {
44
  if (err) {
45
    console.error('gRPC Error:', {
46
      code: err.code,
47
      message: err.message,
48
      details: err.details,
49
    });
50
  } else {
51
    console.log('BatchGetTransactions Response:');
52
    console.log(JSON.stringify(response, null, 2));
53
  }
54
});
55

1
import * as grpc from '@grpc/grpc-js';
2
import * as protoLoader from '@grpc/proto-loader';
3
import * as path from 'path';
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.sui-mainnet.quiknode.pro:9000';
13
const token = 'abcde123456789';
14

15
// Load proto definition
16
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  longs: String,
19
  enums: String,
20
  defaults: true,
21
  oneofs: true,
22
  includeDirs: [path.join(__dirname, 'protos/proto')],
23
});
24
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
25
const LedgerService = proto.sui.rpc.v2.LedgerService;
26

27
// Create gRPC client with TLS
28
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
29

30
// Metadata for authentication
31
const metadata = new grpc.Metadata();
32
metadata.add('x-token', token);
33

34
// Request setup
35
const request = {
36
  digests: ['HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G'], // Replace with valid digests
37
  read_mask: {
38
    paths: ['digest', 'transaction', 'effects', 'events'], // FieldMask
39
  },
40
};
41

42
// Invoke BatchGetTransactions
43
client.BatchGetTransactions(request, metadata, (err: grpc.ServiceError | null, response: any) => {
44
  if (err) {
45
    console.error('gRPC Error:', {
46
      code: err.code,
47
      message: err.message,
48
      details: err.details,
49
    });
50
  } else {
51
    console.log('BatchGetTransactions Response:');
52
    console.log(JSON.stringify(response, null, 2));
53
  }
54
});
55

1
import grpc
2
import json
3
from google.protobuf.field_mask_pb2 import FieldMask
4
from google.protobuf.json_format import MessageToDict
5
from sui.rpc.v2 import ledger_service_pb2, ledger_service_pb2_grpc
6

7

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

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

17
    channel = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
18
    stub = ledger_service_pb2_grpc.LedgerServiceStub(channel)
19

20
    tx_digests = [
21
        "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
22
    ]
23

24
    read_mask = FieldMask(paths=[
25
        "digest",
26
        "transaction",
27
        "effects",
28
        "events"
29
    ])
30

31
    request = ledger_service_pb2.BatchGetTransactionsRequest(
32
        digests=tx_digests,
33
        read_mask=read_mask
34
    )
35

36
    metadata = [("x-token", token)]
37

38
    return stub.BatchGetTransactions(request, metadata=metadata)
39

40

41
def parse_response_to_json(response):
42
    return json.dumps(
43
        MessageToDict(response, preserving_proto_field_name=True),
44
        indent=2
45
    )
46

47

48
def main():
49
    try:
50
        response = get_batch_transactions()
51
        print(parse_response_to_json(response))
52
    except grpc.RpcError as e:
53
        print(f"{e.code().name}: {e.details()}")
54

55

56
if __name__ == "__main__":
57
    main()
58

1
import grpc
2
import json
3
from google.protobuf.field_mask_pb2 import FieldMask
4
from google.protobuf.json_format import MessageToDict
5
from sui.rpc.v2 import ledger_service_pb2, ledger_service_pb2_grpc
6

7

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

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

17
    channel = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
18
    stub = ledger_service_pb2_grpc.LedgerServiceStub(channel)
19

20
    tx_digests = [
21
        "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
22
    ]
23

24
    read_mask = FieldMask(paths=[
25
        "digest",
26
        "transaction",
27
        "effects",
28
        "events"
29
    ])
30

31
    request = ledger_service_pb2.BatchGetTransactionsRequest(
32
        digests=tx_digests,
33
        read_mask=read_mask
34
    )
35

36
    metadata = [("x-token", token)]
37

38
    return stub.BatchGetTransactions(request, metadata=metadata)
39

40

41
def parse_response_to_json(response):
42
    return json.dumps(
43
        MessageToDict(response, preserving_proto_field_name=True),
44
        indent=2
45
    )
46

47

48
def main():
49
    try:
50
        response = get_batch_transactions()
51
        print(parse_response_to_json(response))
52
    except grpc.RpcError as e:
53
        print(f"{e.code().name}: {e.details()}")
54

55

56
if __name__ == "__main__":
57
    main()
58

还没有账号吗？

只需几秒钟即可创建您的 Quicknode 端点，并开始构建

免费开始使用