GetTransaction gRPC Method

參數

digest

字串

必填

載入中...

read_mask

物件

載入中...

paths

array<string>

載入中...

退貨

交易

物件

載入中...

digest

字串

載入中...

交易

物件

載入中...

bcs

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

digest

字串

載入中...

版本

整數

載入中...

種類

物件

載入中...

programmableTransaction

物件

載入中...

輸入

陣列

載入中...

種類

字串

載入中...

objectId

字串

載入中...

版本

字串

載入中...

mutable

布林值

載入中...

pure

字串

載入中...

commands

陣列

載入中...

moveCall

物件

載入中...

package

字串

載入中...

module

字串

載入中...

function

字串

載入中...

typeArguments

陣列

載入中...

arguments

陣列

載入中...

種類

字串

載入中...

輸入

整數

載入中...

結果

整數

載入中...

寄件人

字串

載入中...

gasPayment

物件

載入中...

objects

陣列

載入中...

objectId

字串

載入中...

版本

字串

載入中...

digest

字串

載入中...

所有者

字串

載入中...

價格

字串

載入中...

budget

字串

載入中...

expiration

物件

載入中...

種類

字串

載入中...

effects

物件

載入中...

bcs

物件

載入中...

名稱

字串

載入中...

值

字串

載入中...

digest

字串

載入中...

版本

整數

載入中...

狀態

物件

載入中...

成功

布林值

載入中...

時代

字串

載入中...

gasUsed

物件

載入中...

computationCost

字串

載入中...

storageCost

字串

載入中...

storageRebate

字串

載入中...

nonRefundableStorageFee

字串

載入中...

transactionDigest

字串

載入中...

gasObject

物件

載入中...

eventsDigest

字串

載入中...

dependencies

陣列

載入中...

digest

字串

載入中...

lamportVersion

字串

載入中...

changedObjects

陣列

載入中...

unchangedConsensusObjects

陣列

載入中...

unchangedSharedObjects

陣列

載入中...

種類

字串

載入中...

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
    "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
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
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
	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
	if 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
	if 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
	if err != nil {
97
		log.Fatalf("Failed to format JSON: %v", err)
98
	}
99

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

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
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
	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
	if 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
	if 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
	if 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 packageDefinition = 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 packageDefinition = 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
    try:
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
    try:
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 端點，並開始建置

立即免費開始使用