GetTransaction gRPC Method

Parâmetros

digest

cadeia de caracteres

OBRIGATÓRIO

A carregar...

read_mask

objeto

A carregar...

paths

array<string>

A carregar...

Devoluções

transação

objeto

A carregar...

digest

cadeia de caracteres

A carregar...

transação

objeto

A carregar...

bcs

objeto

A carregar...

nome

cadeia de caracteres

A carregar...

valor

cadeia de caracteres

A carregar...

digest

cadeia de caracteres

A carregar...

versão

número inteiro

A carregar...

kind

objeto

A carregar...

programmableTransaction

objeto

A carregar...

inputs

matriz

A carregar...

kind

cadeia de caracteres

A carregar...

objectId

cadeia de caracteres

A carregar...

versão

cadeia de caracteres

A carregar...

mutable

booleano

A carregar...

pure

cadeia de caracteres

A carregar...

commands

matriz

A carregar...

moveCall

objeto

A carregar...

package

cadeia de caracteres

A carregar...

module

cadeia de caracteres

A carregar...

function

cadeia de caracteres

A carregar...

typeArguments

matriz

A carregar...

arguments

matriz

A carregar...

kind

cadeia de caracteres

A carregar...

entrada

número inteiro

A carregar...

resultado

número inteiro

A carregar...

sender

cadeia de caracteres

A carregar...

gasPayment

objeto

A carregar...

objects

matriz

A carregar...

objectId

cadeia de caracteres

A carregar...

versão

cadeia de caracteres

A carregar...

digest

cadeia de caracteres

A carregar...

proprietário

cadeia de caracteres

A carregar...

preço

cadeia de caracteres

A carregar...

budget

cadeia de caracteres

A carregar...

expiration

objeto

A carregar...

kind

cadeia de caracteres

A carregar...

effects

objeto

A carregar...

bcs

objeto

A carregar...

nome

cadeia de caracteres

A carregar...

valor

cadeia de caracteres

A carregar...

digest

cadeia de caracteres

A carregar...

versão

número inteiro

A carregar...

estado

objeto

A carregar...

sucesso

booleano

A carregar...

epoch

cadeia de caracteres

A carregar...

gasUsed

objeto

A carregar...

computationCost

cadeia de caracteres

A carregar...

storageCost

cadeia de caracteres

A carregar...

storageRebate

cadeia de caracteres

A carregar...

nonRefundableStorageFee

cadeia de caracteres

A carregar...

transactionDigest

cadeia de caracteres

A carregar...

gasObject

objeto

A carregar...

eventsDigest

cadeia de caracteres

A carregar...

dependencies

matriz

A carregar...

digest

cadeia de caracteres

A carregar...

lamportVersion

cadeia de caracteres

A carregar...

changedObjects

matriz

A carregar...

unchangedConsensusObjects

matriz

A carregar...

unchangedSharedObjects

matriz

A carregar...

kind

cadeia de caracteres

A carregar...

objectId

cadeia de caracteres

A carregar...

versão

cadeia de caracteres

A carregar...

digest

cadeia de caracteres

A carregar...

eventos

objeto

A carregar...

bcs

objeto

A carregar...

nome

cadeia de caracteres

A carregar...

valor

cadeia de caracteres

A carregar...

digest

cadeia de caracteres

A carregar...

eventos

matriz

A carregar...

packageId

cadeia de caracteres

A carregar...

module

cadeia de caracteres

A carregar...

sender

cadeia de caracteres

A carregar...

eventType

cadeia de caracteres

A carregar...

contents

objeto

A carregar...

nome

cadeia de caracteres

A carregar...

valor

cadeia de caracteres

A carregar...

json

objeto

A carregar...

balanceManagerId

cadeia de caracteres

A carregar...

baseAssetQuantityCanceled

cadeia de caracteres

A carregar...

clientOrderId

cadeia de caracteres

A carregar...

isBid

booleano

A carregar...

orderId

cadeia de caracteres

A carregar...

originalQuantity

cadeia de caracteres

A carregar...

poolId

cadeia de caracteres

A carregar...

preço

cadeia de caracteres

A carregar...

data e hora

cadeia de caracteres

A carregar...

trader

cadeia de caracteres

A carregar...

data e hora

cadeia de caracteres

A carregar...

Pedido

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
pacote principal
2

3
importar (
4
	"contexto"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"registo"
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
tipo auth estrutura {
31
	token string
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]string, erro) {
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
pacote principal
2

3
importar (
4
	"contexto"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"registo"
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
tipo auth estrutura {
31
	token string
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]string, erro) {
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

Ainda não tem uma conta?

Crie o seu ponto de extremidade Quicknode em segundos e comece a desenvolver

Comece gratuitamente