GetTransaction gRPC Method

매개변수

요약

문자열

필수

로딩 중...

read_mask

객체

로딩 중...

paths

array<string>

로딩 중...

반품

거래

객체

로딩 중...

요약

문자열

로딩 중...

거래

객체

로딩 중...

bcs

객체

로딩 중...

이름

문자열

로딩 중...

값

문자열

로딩 중...

요약

문자열

로딩 중...

버전

정수

로딩 중...

종류

객체

로딩 중...

programmableTransaction

객체

로딩 중...

입력값

배열

로딩 중...

종류

문자열

로딩 중...

objectId

문자열

로딩 중...

버전

문자열

로딩 중...

변경 가능

부울

로딩 중...

pure

문자열

로딩 중...

commands

배열

로딩 중...

moveCall

객체

로딩 중...

패키지

문자열

로딩 중...

모듈

문자열

로딩 중...

함수

문자열

로딩 중...

typeArguments

배열

로딩 중...

arguments

배열

로딩 중...

종류

문자열

로딩 중...

입력

정수

로딩 중...

결과

정수

로딩 중...

발신자

문자열

로딩 중...

gasPayment

객체

로딩 중...

objects

배열

로딩 중...

objectId

문자열

로딩 중...

버전

문자열

로딩 중...

요약

문자열

로딩 중...

소유자

문자열

로딩 중...

가격

문자열

로딩 중...

예산

문자열

로딩 중...

expiration

객체

로딩 중...

종류

문자열

로딩 중...

효과

객체

로딩 중...

bcs

객체

로딩 중...

이름

문자열

로딩 중...

값

문자열

로딩 중...

요약

문자열

로딩 중...

버전

정수

로딩 중...

상태

객체

로딩 중...

success

부울

로딩 중...

epoch

문자열

로딩 중...

가스 사용량

객체

로딩 중...

계산 비용

문자열

로딩 중...

저장 비용

문자열

로딩 중...

저장 할인

문자열

로딩 중...

환불 불가 보관 수수료

문자열

로딩 중...

트랜잭션 다이제스트

문자열

로딩 중...

gasObject

객체

로딩 중...

이벤트 요약

문자열

로딩 중...

dependencies

배열

로딩 중...

요약

문자열

로딩 중...

lamportVersion

문자열

로딩 중...

changedObjects

배열

로딩 중...

unchangedConsensusObjects

배열

로딩 중...

unchangedSharedObjects

배열

로딩 중...

종류

문자열

로딩 중...

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
    "digest": "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G",
7
    "read_mask": {
8
      "paths": [
9
        "digest",
10
        "transaction",
11
        "effects",
12
        "events"
13
      ]
14
    }
15
  }' \
16
  docs-demo.sui-mainnet.quiknode.pro:9000 \
17
  sui.rpc.v2.LedgerService/GetTransaction

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

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
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
	txDigest := "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
61

62
	fieldMask := &fieldmaskpb.FieldMask{
63
		Paths: []string{"events", "effects"},
64
	}
65

66
	req := &pb.GetTransactionRequest{
67
		Digest:   &txDigest,
68
		ReadMask: fieldMask,
69
	}
70

71
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
72
	defer cancel()
73

74
	resp, err := client.GetTransaction(ctx, req)
75
	만약 err != nil {
76
		log.Fatalf("GetTransaction failed: %v", err)
77
	}
78

79
	marshaler := protojson.MarshalOptions{
80
		UseProtoNames:   true,
81
		EmitUnpopulated: true,
82
		Indent:          "  ",
83
	}
84

85
	jsonBytes, err := marshaler.Marshal(resp)
86
	만약 err != nil {
87
		log.Fatalf("Failed to marshal response to JSON: %v", err)
88
	}
89

90
	var prettyJSON map[string]interface{}
91
	if err := json.Unmarshal(jsonBytes, &prettyJSON); err != nil {
92
		log.Fatalf("Failed to unmarshal JSON: %v", err)
93
	}
94

95
	prettyJSONBytes, err := json.MarshalIndent(prettyJSON, "", "  ")
96
	만약 err != nil {
97
		log.Fatalf("Failed to format JSON: %v", err)
98
	}
99

100
	fmt.Println(string(prettyJSONBytes))
101
}
102

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
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
	txDigest := "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
61

62
	fieldMask := &fieldmaskpb.FieldMask{
63
		Paths: []string{"events", "effects"},
64
	}
65

66
	req := &pb.GetTransactionRequest{
67
		Digest:   &txDigest,
68
		ReadMask: fieldMask,
69
	}
70

71
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
72
	defer cancel()
73

74
	resp, err := client.GetTransaction(ctx, req)
75
	만약 err != nil {
76
		log.Fatalf("GetTransaction failed: %v", err)
77
	}
78

79
	marshaler := protojson.MarshalOptions{
80
		UseProtoNames:   true,
81
		EmitUnpopulated: true,
82
		Indent:          "  ",
83
	}
84

85
	jsonBytes, err := marshaler.Marshal(resp)
86
	만약 err != nil {
87
		log.Fatalf("Failed to marshal response to JSON: %v", err)
88
	}
89

90
	var prettyJSON map[string]interface{}
91
	if err := json.Unmarshal(jsonBytes, &prettyJSON); err != nil {
92
		log.Fatalf("Failed to unmarshal JSON: %v", err)
93
	}
94

95
	prettyJSONBytes, err := json.MarshalIndent(prettyJSON, "", "  ")
96
	만약 err != nil {
97
		log.Fatalf("Failed to format JSON: %v", err)
98
	}
99

100
	fmt.Println(string(prettyJSONBytes))
101
}
102

1
import * as grpc from '@grpc/grpc-js';
2
import * as protoLoader from '@grpc/proto-loader';
3
import * as path from 'path';
4

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

8
// Load the proto definition
9
const 패키지 정의 = protoLoader.loadSync(PROTO_PATH, {
10
  keepCase: true,
11
  longs: String,
12
  enums: String,
13
  defaults: true,
14
  oneofs: true,
15
  includeDirs: [path.join(__dirname, 'protos/proto')],
16
});
17

18
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
19
const LedgerService = proto.sui.rpc.v2.LedgerService;
20

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

26
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
27
const token = 'abcde123456789';
28

29
// Create client with TLS
30
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
31

32
// Prepare metadata
33
const metadata = new grpc.Metadata();
34
metadata.add('x-token', token);
35

36
// Replace this with your actual transaction digest
37
const txDigest = 'HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G';
38

39
// Prepare request
40
const request = {
41
  digest: txDigest,
42
  read_mask: {
43
    paths: ['digest', 'transaction', 'effects', 'events', 'timestamp'],
44
  },
45
};
46

47
// Make the call
48
client.GetTransaction(request, metadata, (err: any, response: any) => {
49
  if (err) {
50
    console.error('Error:', err);
51
  } else {
52
    console.log('Response:', 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
// Path to the proto file
6
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/ledger_service.proto');
7

8
// Load the proto definition
9
const 패키지 정의 = protoLoader.loadSync(PROTO_PATH, {
10
  keepCase: true,
11
  longs: String,
12
  enums: String,
13
  defaults: true,
14
  oneofs: true,
15
  includeDirs: [path.join(__dirname, 'protos/proto')],
16
});
17

18
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
19
const LedgerService = proto.sui.rpc.v2.LedgerService;
20

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

26
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
27
const token = 'abcde123456789';
28

29
// Create client with TLS
30
const client = new LedgerService(endpoint, grpc.credentials.createSsl());
31

32
// Prepare metadata
33
const metadata = new grpc.Metadata();
34
metadata.add('x-token', token);
35

36
// Replace this with your actual transaction digest
37
const txDigest = 'HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G';
38

39
// Prepare request
40
const request = {
41
  digest: txDigest,
42
  read_mask: {
43
    paths: ['digest', 'transaction', 'effects', 'events', 'timestamp'],
44
  },
45
};
46

47
// Make the call
48
client.GetTransaction(request, metadata, (err: any, response: any) => {
49
  if (err) {
50
    console.error('Error:', err);
51
  } else {
52
    console.log('Response:', 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_transaction():
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
    # Specify the transaction digest you want to retrieve
21
    # Replace with an actual Sui transaction digest
22
    tx_digest = "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
23

24
    # Create a field mask to specify which fields to include in the response
25
    read_mask = FieldMask(paths=[
26
        "digest",
27
        "transaction",
28
        "effects",
29
        "events",
30
        "timestamp"
31
    ])
32

33
    # Prepare the GetTransactionRequest
34
    request = ledger_service_pb2.GetTransactionRequest(
35
        digest=tx_digest,
36
        read_mask=read_mask
37
    )
38

39
    metadata = [("x-token", token)]
40

41
    return stub.GetTransaction(request, metadata=metadata)
42

43

44
def parse_response_to_json(response):
45
    return json.dumps(
46
        MessageToDict(response, preserving_proto_field_name=True),
47
        indent=2
48
    )
49

50

51
def main():
52
    시도해 보세요:
53
        response = get_transaction()
54
        print(parse_response_to_json(response))
55
    except grpc.RpcError as e:
56
        print(f"{e.code().name}: {e.details()}")
57

58

59
if __name__ == "__main__":
60
    main()
61

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_transaction():
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
    # Specify the transaction digest you want to retrieve
21
    # Replace with an actual Sui transaction digest
22
    tx_digest = "HjuLoCGjS4wBC5KfqmExUa7GcF3yzaWRN1YoYpgxQC6G"
23

24
    # Create a field mask to specify which fields to include in the response
25
    read_mask = FieldMask(paths=[
26
        "digest",
27
        "transaction",
28
        "effects",
29
        "events",
30
        "timestamp"
31
    ])
32

33
    # Prepare the GetTransactionRequest
34
    request = ledger_service_pb2.GetTransactionRequest(
35
        digest=tx_digest,
36
        read_mask=read_mask
37
    )
38

39
    metadata = [("x-token", token)]
40

41
    return stub.GetTransaction(request, metadata=metadata)
42

43

44
def parse_response_to_json(response):
45
    return json.dumps(
46
        MessageToDict(response, preserving_proto_field_name=True),
47
        indent=2
48
    )
49

50

51
def main():
52
    시도해 보세요:
53
        response = get_transaction()
54
        print(parse_response_to_json(response))
55
    except grpc.RpcError as e:
56
        print(f"{e.code().name}: {e.details()}")
57

58

59
if __name__ == "__main__":
60
    main()
61

아직 계정이 없으신가요?

단 몇 초 만에 Quicknode 엔드포인트를 생성하고 개발을 시작하세요

지금 무료로 시작하세요