BatchGetTransactions gRPC Method

パラメータ

digests

配列

必須

読み込み中...

read_mask

オブジェクト

読み込み中...

paths

配列

読み込み中...

返品

取引

配列

読み込み中...

digest

文字列

読み込み中...

取引

オブジェクト

読み込み中...

bcs

オブジェクト

読み込み中...

名前

文字列

読み込み中...

値

文字列

読み込み中...

digest

文字列

読み込み中...

バージョン

整数

読み込み中...

kind

オブジェクト

読み込み中...

programmableTransaction

オブジェクト

読み込み中...

入力

配列

読み込み中...

kind

文字列

読み込み中...

objectId

文字列

読み込み中...

可変

ブール値

読み込み中...

pure

文字列

読み込み中...

バージョン

文字列

読み込み中...

digest

文字列

読み込み中...

commands

配列

読み込み中...

moveCall

オブジェクト

読み込み中...

package

文字列

読み込み中...

module

文字列

読み込み中...

関数

文字列

読み込み中...

typeArguments

配列

読み込み中...

arguments

配列

読み込み中...

kind

文字列

読み込み中...

入力

整数

読み込み中...

結果

整数

読み込み中...

送信者

文字列

読み込み中...

gasPayment

オブジェクト

読み込み中...

objects

配列

読み込み中...

objectId

文字列

読み込み中...

バージョン

文字列

読み込み中...

digest

文字列

読み込み中...

所有者

文字列

読み込み中...

価格

文字列

読み込み中...

budget

文字列

読み込み中...

expiration

オブジェクト

読み込み中...

kind

文字列

読み込み中...

effects

オブジェクト

読み込み中...

bcs

オブジェクト

読み込み中...

名前

文字列

読み込み中...

値

文字列

読み込み中...

digest

文字列

読み込み中...

バージョン

整数

読み込み中...

ステータス

オブジェクト

読み込み中...

success

ブール値

読み込み中...

epoch

文字列

読み込み中...

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

文字列

読み込み中...

送信者

文字列

読み込み中...

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
パッケージ main
2

3
import (
4
	「文脈」
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
	もし 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
import (
4
	「文脈」
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
	もし 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のエンドポイントを作成し、開発を始めましょう

今すぐ無料で始めましょう