BatchGetTransactions gRPC Method

參數

digests

陣列

必填

載入中...

read_mask

物件

載入中...

paths

陣列

載入中...

退貨

交易

陣列

載入中...

digest

字串

載入中...

交易

物件

載入中...

bcs

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

digest

字串

載入中...

版本

整數

載入中...

種類

物件

載入中...

programmableTransaction

物件

載入中...

輸入

陣列

載入中...

種類

字串

載入中...

objectId

字串

載入中...

mutable

布林值

載入中...

pure

字串

載入中...

版本

字串

載入中...

digest

字串

載入中...

commands

陣列

載入中...

moveCall

物件

載入中...

package

字串

載入中...

module

字串

載入中...

function

字串

載入中...

typeArguments

陣列

載入中...

arguments

陣列

載入中...

種類

字串

載入中...

輸入

整數

載入中...

結果

整數

載入中...

寄件人

字串

載入中...

gasPayment

物件

載入中...

objects

陣列

載入中...

objectId

字串

載入中...

版本

字串

載入中...

digest

字串

載入中...

所有者

字串

載入中...

價格

字串

載入中...

budget

字串

載入中...

expiration

物件

載入中...

種類

字串

載入中...

effects

物件

載入中...

bcs

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

digest

字串

載入中...

版本

整數

載入中...

狀態

物件

載入中...

成功

布林值

載入中...

時代

字串

載入中...

gasUsed

物件

載入中...

computationCost

字串

載入中...

storageCost

字串

載入中...

storageRebate

字串

載入中...

nonRefundableStorageFee

字串

載入中...

transactionDigest

字串

載入中...

gasObject

物件

載入中...

objectId

字串

載入中...

inputState

字串

載入中...

inputVersion

字串

載入中...

inputDigest

字串

載入中...

inputOwner

物件

載入中...

種類

字串

載入中...

地址

字串

載入中...

outputState

字串

載入中...

outputVersion

字串

載入中...

outputDigest

字串

載入中...

outputOwner

物件

載入中...

種類

字串

載入中...

地址

字串

載入中...

idOperation

字串

載入中...

eventsDigest

字串

載入中...

dependencies

陣列

載入中...

lamportVersion

字串

載入中...

changedObjects

陣列

載入中...

objectId

字串

載入中...

inputState

字串

載入中...

inputVersion

字串

載入中...

inputDigest

字串

載入中...

inputOwner

物件

載入中...

種類

字串

載入中...

地址

字串

載入中...

outputState

字串

載入中...

outputVersion

字串

載入中...

outputDigest

字串

載入中...

outputOwner

物件

載入中...

種類

字串

載入中...

地址

字串

載入中...

idOperation

字串

載入中...

objectType

字串

載入中...

unchangedConsensusObjects

陣列

載入中...

種類

字串

載入中...

objectId

字串

載入中...

版本

字串

載入中...

digest

字串

載入中...

活動

物件

載入中...

bcs

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

digest

字串

載入中...

活動

陣列

載入中...

packageId

字串

載入中...

module

字串

載入中...

寄件人

字串

載入中...

eventType

字串

載入中...

contents

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

json

物件

載入中...

balanceManagerId

字串

載入中...

baseAssetQuantityCanceled

字串

載入中...

clientOrderId

字串

載入中...

isBid

布林值

載入中...

orderId

字串

載入中...

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
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"log"
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
type auth struct {
31
	token string
32
}
33

34
func (a *auth) GetRequestMetadata(ctx context.Context, uri ...string) (map[string]string, error) {
35
	return map[string]string{
36
		"x-token": a.token,
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.WithPerRPCCredentials(&auth{token}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	if 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
	if 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
	if 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
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"log"
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
type auth struct {
31
	token string
32
}
33

34
func (a *auth) GetRequestMetadata(ctx context.Context, uri ...string) (map[string]string, error) {
35
	return map[string]string{
36
		"x-token": a.token,
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.WithPerRPCCredentials(&auth{token}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	if 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
	if 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
	if 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 端點，並開始建置

立即免費開始使用