BatchGetTransactions gRPC Method

Parámetros

digests

matriz

OBLIGATORIO

Cargando...

read_mask

objeto

Cargando...

paths

matriz

Cargando...

Devoluciones

transacciones

matriz

Cargando...

digest

cadena

Cargando...

transacción

objeto

Cargando...

bcs

objeto

Cargando...

nombre

cadena

Cargando...

valor

cadena

Cargando...

digest

cadena

Cargando...

versión

entero

Cargando...

kind

objeto

Cargando...

programmableTransaction

objeto

Cargando...

inputs

matriz

Cargando...

kind

cadena

Cargando...

objectId

cadena

Cargando...

mutable

booleano

Cargando...

pure

cadena

Cargando...

versión

cadena

Cargando...

digest

cadena

Cargando...

commands

matriz

Cargando...

moveCall

objeto

Cargando...

package

cadena

Cargando...

module

cadena

Cargando...

función

cadena

Cargando...

typeArguments

matriz

Cargando...

arguments

matriz

Cargando...

kind

cadena

Cargando...

entrada

entero

Cargando...

resultado

entero

Cargando...

remitente

cadena

Cargando...

gasPayment

objeto

Cargando...

objects

matriz

Cargando...

objectId

cadena

Cargando...

versión

cadena

Cargando...

digest

cadena

Cargando...

propietario

cadena

Cargando...

precio

cadena

Cargando...

budget

cadena

Cargando...

caducidad

objeto

Cargando...

kind

cadena

Cargando...

effects

objeto

Cargando...

bcs

objeto

Cargando...

nombre

cadena

Cargando...

valor

cadena

Cargando...

digest

cadena

Cargando...

versión

entero

Cargando...

estado

objeto

Cargando...

éxito

booleano

Cargando...

epoch

cadena

Cargando...

gas consumido

objeto

Cargando...

computationCost

cadena

Cargando...

storageCost

cadena

Cargando...

storageRebate

cadena

Cargando...

nonRefundableStorageFee

cadena

Cargando...

transactionDigest

cadena

Cargando...

gasObject

objeto

Cargando...

objectId

cadena

Cargando...

inputState

cadena

Cargando...

inputVersion

cadena

Cargando...

inputDigest

cadena

Cargando...

inputOwner

objeto

Cargando...

kind

cadena

Cargando...

dirección

cadena

Cargando...

outputState

cadena

Cargando...

outputVersion

cadena

Cargando...

outputDigest

cadena

Cargando...

outputOwner

objeto

Cargando...

kind

cadena

Cargando...

dirección

cadena

Cargando...

idOperation

cadena

Cargando...

eventsDigest

cadena

Cargando...

dependencies

matriz

Cargando...

lamportVersion

cadena

Cargando...

changedObjects

matriz

Cargando...

objectId

cadena

Cargando...

inputState

cadena

Cargando...

inputVersion

cadena

Cargando...

inputDigest

cadena

Cargando...

inputOwner

objeto

Cargando...

kind

cadena

Cargando...

dirección

cadena

Cargando...

outputState

cadena

Cargando...

outputVersion

cadena

Cargando...

outputDigest

cadena

Cargando...

outputOwner

objeto

Cargando...

kind

cadena

Cargando...

dirección

cadena

Cargando...

idOperation

cadena

Cargando...

objectType

cadena

Cargando...

unchangedConsensusObjects

matriz

Cargando...

kind

cadena

Cargando...

objectId

cadena

Cargando...

versión

cadena

Cargando...

digest

cadena

Cargando...

eventos

objeto

Cargando...

bcs

objeto

Cargando...

nombre

cadena

Cargando...

valor

cadena

Cargando...

digest

cadena

Cargando...

eventos

matriz

Cargando...

packageId

cadena

Cargando...

module

cadena

Cargando...

remitente

cadena

Cargando...

eventType

cadena

Cargando...

contents

objeto

Cargando...

nombre

cadena

Cargando...

valor

cadena

Cargando...

json

objeto

Cargando...

balanceManagerId

cadena

Cargando...

baseAssetQuantityCanceled

cadena

Cargando...

clientOrderId

cadena

Cargando...

isBid

booleano

Cargando...

orderId

cadena

Cargando...

originalQuantity

cadena

Cargando...

poolId

cadena

Cargando...

precio

cadena

Cargando...

marca de tiempo

cadena

Cargando...

trader

cadena

Cargando...

Solicitud

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

3
import (
4
	«contexto»
5
	«crypto/tls»
6
	«encoding/json»
7
	«fmt»
8
	«registro»
9
	«tiempo»
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    = "TU_NÚMERO_DE_TOKEN"
26
	endpoint = "YOUR_QN_ENDPOINT:9000"
27
)
28

29
// Auth structure for x-token
30
tipo autenticación estructura {
31
	token cadena
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...cadena) (mapa[cadena]cadena, error) {
35
	volver mapa[cadena]cadena{
36
		«x-token»: un.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.Con credenciales RPCC(&auth{token}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	si err != nil {
54
		registro.Fatalf(«Error al conectarse: %v», err)
55
	}
56
	aplazar conn.Cerrar()
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
	si 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
	si 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
paquete principal
2

3
import (
4
	«contexto»
5
	«crypto/tls»
6
	«encoding/json»
7
	«fmt»
8
	«registro»
9
	«tiempo»
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    = "TU_NÚMERO_DE_TOKEN"
26
	endpoint = "YOUR_QN_ENDPOINT:9000"
27
)
28

29
// Auth structure for x-token
30
tipo autenticación estructura {
31
	token cadena
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...cadena) (mapa[cadena]cadena, error) {
35
	volver mapa[cadena]cadena{
36
		«x-token»: un.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.Con credenciales RPCC(&auth{token}),
50
	}
51

52
	conn, err := grpc.Dial(endpoint, opts...)
53
	si err != nil {
54
		registro.Fatalf(«Error al conectarse: %v», err)
55
	}
56
	aplazar conn.Cerrar()
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
	si 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
	si 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 packageDefinition = 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 packageDefinition = 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
    try:
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
    try:
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

¿Aún no tienes una cuenta?

Crea tu punto de conexión de Quicknode en cuestión de segundos y empieza a desarrollar

Empieza gratis