GetTransaction gRPC Method

Paramètres

digest

chaîne de caractères

OBLIGATOIRE

Chargement...

read_mask

objet

Chargement...

paths

array<string>

Chargement...

Renvoie

transaction

objet

Chargement...

digest

chaîne de caractères

Chargement...

transaction

objet

Chargement...

bcs

objet

Chargement...

nom

chaîne de caractères

Chargement...

valeur

chaîne de caractères

Chargement...

digest

chaîne de caractères

Chargement...

Version

entier

Chargement...

kind

objet

Chargement...

programmableTransaction

objet

Chargement...

inputs

tableau

Chargement...

kind

chaîne de caractères

Chargement...

objectId

chaîne de caractères

Chargement...

Version

chaîne de caractères

Chargement...

mutable

booléen

Chargement...

pure

chaîne de caractères

Chargement...

commands

tableau

Chargement...

moveCall

objet

Chargement...

package

chaîne de caractères

Chargement...

module

chaîne de caractères

Chargement...

fonction

chaîne de caractères

Chargement...

typeArguments

tableau

Chargement...

arguments

tableau

Chargement...

kind

chaîne de caractères

Chargement...

entrée

entier

Chargement...

résultat

entier

Chargement...

expéditeur

chaîne de caractères

Chargement...

gasPayment

objet

Chargement...

objects

tableau

Chargement...

objectId

chaîne de caractères

Chargement...

Version

chaîne de caractères

Chargement...

digest

chaîne de caractères

Chargement...

propriétaire

chaîne de caractères

Chargement...

prix

chaîne de caractères

Chargement...

budget

chaîne de caractères

Chargement...

expiration

objet

Chargement...

kind

chaîne de caractères

Chargement...

effects

objet

Chargement...

bcs

objet

Chargement...

nom

chaîne de caractères

Chargement...

valeur

chaîne de caractères

Chargement...

digest

chaîne de caractères

Chargement...

Version

entier

Chargement...

statut

objet

Chargement...

success

booléen

Chargement...

epoch

chaîne de caractères

Chargement...

gasUsed

objet

Chargement...

computationCost

chaîne de caractères

Chargement...

storageCost

chaîne de caractères

Chargement...

storageRebate

chaîne de caractères

Chargement...

nonRefundableStorageFee

chaîne de caractères

Chargement...

transactionDigest

chaîne de caractères

Chargement...

gasObject

objet

Chargement...

eventsDigest

chaîne de caractères

Chargement...

dependencies

tableau

Chargement...

digest

chaîne de caractères

Chargement...

lamportVersion

chaîne de caractères

Chargement...

changedObjects

tableau

Chargement...

unchangedConsensusObjects

tableau

Chargement...

unchangedSharedObjects

tableau

Chargement...

kind

chaîne de caractères

Chargement...

objectId

chaîne de caractères

Chargement...

Version

chaîne de caractères

Chargement...

digest

chaîne de caractères

Chargement...

événements

objet

Chargement...

bcs

objet

Chargement...

nom

chaîne de caractères

Chargement...

valeur

chaîne de caractères

Chargement...

digest

chaîne de caractères

Chargement...

événements

tableau

Chargement...

packageId

chaîne de caractères

Chargement...

module

chaîne de caractères

Chargement...

expéditeur

chaîne de caractères

Chargement...

eventType

chaîne de caractères

Chargement...

contents

objet

Chargement...

nom

chaîne de caractères

Chargement...

valeur

chaîne de caractères

Chargement...

json

objet

Chargement...

balanceManagerId

chaîne de caractères

Chargement...

baseAssetQuantityCanceled

chaîne de caractères

Chargement...

clientOrderId

chaîne de caractères

Chargement...

isBid

booléen

Chargement...

Identifiant de commande

chaîne de caractères

Chargement...

originalQuantity

chaîne de caractères

Chargement...

poolId

chaîne de caractères

Chargement...

prix

chaîne de caractères

Chargement...

horodatage

chaîne de caractères

Chargement...

trader

chaîne de caractères

Chargement...

horodatage

chaîne de caractères

Chargement...

Requête

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("Échec de la connexion : %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("Échec de la connexion : %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

Vous n'avez pas encore de compte ?

Créez votre endpoint Quicknode en quelques secondes et commencez à développer

Commencez gratuitement