BatchGetTransactions gRPC Method

매개변수

digests

배열

필수

로딩 중...

read_mask

객체

로딩 중...

paths

배열

로딩 중...

반품

거래

배열

로딩 중...

요약

문자열

로딩 중...

거래

객체

로딩 중...

bcs

객체

로딩 중...

이름

문자열

로딩 중...

값

문자열

로딩 중...

요약

문자열

로딩 중...

버전

정수

로딩 중...

종류

객체

로딩 중...

programmableTransaction

객체

로딩 중...

입력값

배열

로딩 중...

종류

문자열

로딩 중...

objectId

문자열

로딩 중...

변경 가능

부울

로딩 중...

pure

문자열

로딩 중...

버전

문자열

로딩 중...

요약

문자열

로딩 중...

commands

배열

로딩 중...

moveCall

객체

로딩 중...

패키지

문자열

로딩 중...

모듈

문자열

로딩 중...

함수

문자열

로딩 중...

typeArguments

배열

로딩 중...

arguments

배열

로딩 중...

종류

문자열

로딩 중...

입력

정수

로딩 중...

결과

정수

로딩 중...

발신자

문자열

로딩 중...

gasPayment

객체

로딩 중...

objects

배열

로딩 중...

objectId

문자열

로딩 중...

버전

문자열

로딩 중...

요약

문자열

로딩 중...

소유자

문자열

로딩 중...

가격

문자열

로딩 중...

예산

문자열

로딩 중...

expiration

객체

로딩 중...

종류

문자열

로딩 중...

효과

객체

로딩 중...

bcs

객체

로딩 중...

이름

문자열

로딩 중...

값

문자열

로딩 중...

요약

문자열

로딩 중...

버전

정수

로딩 중...

상태

객체

로딩 중...

success

부울

로딩 중...

epoch

문자열

로딩 중...

가스 사용량

객체

로딩 중...

계산 비용

문자열

로딩 중...

저장 비용

문자열

로딩 중...

저장 할인

문자열

로딩 중...

환불 불가 보관 수수료

문자열

로딩 중...

트랜잭션 다이제스트

문자열

로딩 중...

gasObject

객체

로딩 중...

objectId

문자열

로딩 중...

inputState

문자열

로딩 중...

inputVersion

문자열

로딩 중...

inputDigest

문자열

로딩 중...

inputOwner

객체

로딩 중...

종류

문자열

로딩 중...

주소

문자열

로딩 중...

outputState

문자열

로딩 중...

outputVersion

문자열

로딩 중...

outputDigest

문자열

로딩 중...

outputOwner

객체

로딩 중...

종류

문자열

로딩 중...

주소

문자열

로딩 중...

idOperation

문자열

로딩 중...

이벤트 요약

문자열

로딩 중...

dependencies

배열

로딩 중...

lamportVersion

문자열

로딩 중...

changedObjects

배열

로딩 중...

objectId

문자열

로딩 중...

inputState

문자열

로딩 중...

inputVersion

문자열

로딩 중...

inputDigest

문자열

로딩 중...

inputOwner

객체

로딩 중...

종류

문자열

로딩 중...

주소

문자열

로딩 중...

outputState

문자열

로딩 중...

outputVersion

문자열

로딩 중...

outputDigest

문자열

로딩 중...

outputOwner

객체

로딩 중...

종류

문자열

로딩 중...

주소

문자열

로딩 중...

idOperation

문자열

로딩 중...

객체 유형

문자열

로딩 중...

unchangedConsensusObjects

배열

로딩 중...

종류

문자열

로딩 중...

objectId

문자열

로딩 중...

버전

문자열

로딩 중...

요약

문자열

로딩 중...

행사

객체

로딩 중...

bcs

객체

로딩 중...

이름

문자열

로딩 중...

값

문자열

로딩 중...

요약

문자열

로딩 중...

행사

배열

로딩 중...

packageId

문자열

로딩 중...

모듈

문자열

로딩 중...

발신자

문자열

로딩 중...

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
	"로그"
9
	"시간"
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
	"로그"
9
	"시간"
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 패키지 정의 = 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 패키지 정의 = 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
    시도해 보세요:
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
    시도해 보세요:
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 엔드포인트를 생성하고 개발을 시작하세요

지금 무료로 시작하세요