ExecuteTransaction gRPC Method

Parâmetros

transação

objeto

OBRIGATÓRIO

Carregando...

signatures

matriz

Carregando...

read_mask

objeto

Carregando...

Devoluções

finality

objeto

Carregando...

certified

objeto

Carregando...

checkpointed

cadeia de caracteres

Carregando...

quorumExecuted

objeto

Carregando...

transação

objeto

Carregando...

digest

cadeia de caracteres

Carregando...

transação

objeto

Carregando...

signatures

matriz

Carregando...

effects

objeto

Carregando...

events

objeto

Carregando...

checkpoint

cadeia de caracteres

Carregando...

marca temporal

cadeia de caracteres

Carregando...

balanceChanges

matriz

Carregando...

inputObjects

matriz

Carregando...

outputObjects

matriz

Carregando...

Pedido

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/transaction_execution_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "transaction": {
7
      "bcs": "BASE64_ENCODED_TX"
8
    },
9
    "options": {
10
      "show_input": true,
11
      "show_effects": true,
12
      "show_events": true,
13
      "show_object_changes": true,
14
      "show_balance_changes": true
15
    }
16
  }' \
17
  docs-demo.sui-mainnet.quiknode.pro:9000 \
18
  sui.rpc.v2.TransactionExecutionService/ExecuteTransaction
19

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/transaction_execution_service.proto \
4
  -H "x-token: YOUR_TOKEN_VALUE" \
5
  -d '{
6
    "transaction": {
7
      "bcs": "BASE64_ENCODED_TX"
8
    },
9
    "options": {
10
      "show_input": true,
11
      "show_effects": true,
12
      "show_events": true,
13
      "show_object_changes": true,
14
      "show_balance_changes": true
15
    }
16
  }' \
17
  docs-demo.sui-mainnet.quiknode.pro:9000 \
18
  sui.rpc.v2.TransactionExecutionService/ExecuteTransaction
19

1
pacote principal
2

3
importar (
4
	"contexto"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"registo"
9
	"tempo"
10

11
	"google.golang.grpc"
12
	"google.golang.grpc"
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
var (
20
	token    = "YOUR_TOKEN_NUMBER"
21
	endpoint = "YOUR_QN_ENDPOINT:9000"
22
)
23

24
// x-token Auth implementation
25
tipo auth estrutura {
26
	token cadeia de caracteres
27
}
28

29
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]cadeia de caracteres, erro) {
30
	return map[string]string{"x-token": a.token}, nil
31
}
32
func (a *auth) RequireTransportSecurity() bool {
33
	return true
34
}
35

36
func main() {
37
	creds := credentials.NewTLS(&tls.Config{})
38
	opts := []grpc.DialOption{
39
		grpc.WithTransportCredentials(creds),
40
		grpc.WithPerRPCCredentials(&auth{token}),
41
	}
42

43
	conn, err := grpc.Dial(endpoint, opts...)
44
	se err != nil {
45
		log.Fatalf("Failed to connect: %v", err)
46
	}
47
	adiar conn.Fechar()
48

49
	client := pb.NewTransactionExecutionServiceClient(conn)
50

51
	bcsTx := []byte("YOUR_BCS_SERIALIZED_TX_BYTES")
52

53
	sig := &pb.UserSignature{
54
		Scheme:    pb.SignatureScheme_ED25519,
55
		Signature: []byte("YOUR_SIGNATURE_BYTES"),
56
		PublicKey: []byte("YOUR_PUBLIC_KEY_BYTES"),
57
	}
58

59
	// ReadMask specifies what response fields to return
60
	readMask := &fieldmaskpb.FieldMask{
61
		Paths: []string{"transaction", "finality"},
62
	}
63

64
	// Build request
65
	req := &pb.ExecuteTransactionRequest{
66
		Transaction: &pb.Transaction{
67
			Bcs: &pb.Bcs{
68
				Bytes: bcsTx,
69
			},
70
		},
71
		Signatures: []*pb.UserSignature{sig},
72
		ReadMask:   readMask,
73
	}
74

75
	// Context with timeout
76
	ctx, cancel := contexto.WithTimeout(contexto.Background(), 10*vez.Segundo)
77
	adiar cancelar()
78

79
	resp, err := client.ExecuteTransaction(ctx, req)
80
	se err != nil {
81
		log.Fatalf("ExecuteTransaction failed: %v", err)
82
	}
83

84
	// Marshal response to pretty JSON
85
	marshaler := protojson.MarshalOptions{
86
		UseProtoNames:   true,
87
		EmitUnpopulated: true,
88
		Indent:          "  ",
89
	}
90
	jsonBytes, err := marshaler.Marshal(resp)
91
	se err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	// Print result
96
	var pretty map[string]interface{}
97
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
98
		log.Fatalf("Failed to parse JSON: %v", err)
99
	}
100
	output, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(output))
102
}
103

1
pacote principal
2

3
importar (
4
	"contexto"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	"registo"
9
	"tempo"
10

11
	"google.golang.grpc"
12
	"google.golang.grpc"
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
var (
20
	token    = "YOUR_TOKEN_NUMBER"
21
	endpoint = "YOUR_QN_ENDPOINT:9000"
22
)
23

24
// x-token Auth implementation
25
tipo auth estrutura {
26
	token cadeia de caracteres
27
}
28

29
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]cadeia de caracteres, erro) {
30
	return map[string]string{"x-token": a.token}, nil
31
}
32
func (a *auth) RequireTransportSecurity() bool {
33
	return true
34
}
35

36
func main() {
37
	creds := credentials.NewTLS(&tls.Config{})
38
	opts := []grpc.DialOption{
39
		grpc.WithTransportCredentials(creds),
40
		grpc.WithPerRPCCredentials(&auth{token}),
41
	}
42

43
	conn, err := grpc.Dial(endpoint, opts...)
44
	se err != nil {
45
		log.Fatalf("Failed to connect: %v", err)
46
	}
47
	adiar conn.Fechar()
48

49
	client := pb.NewTransactionExecutionServiceClient(conn)
50

51
	bcsTx := []byte("YOUR_BCS_SERIALIZED_TX_BYTES")
52

53
	sig := &pb.UserSignature{
54
		Scheme:    pb.SignatureScheme_ED25519,
55
		Signature: []byte("YOUR_SIGNATURE_BYTES"),
56
		PublicKey: []byte("YOUR_PUBLIC_KEY_BYTES"),
57
	}
58

59
	// ReadMask specifies what response fields to return
60
	readMask := &fieldmaskpb.FieldMask{
61
		Paths: []string{"transaction", "finality"},
62
	}
63

64
	// Build request
65
	req := &pb.ExecuteTransactionRequest{
66
		Transaction: &pb.Transaction{
67
			Bcs: &pb.Bcs{
68
				Bytes: bcsTx,
69
			},
70
		},
71
		Signatures: []*pb.UserSignature{sig},
72
		ReadMask:   readMask,
73
	}
74

75
	// Context with timeout
76
	ctx, cancel := contexto.WithTimeout(contexto.Background(), 10*vez.Segundo)
77
	adiar cancelar()
78

79
	resp, err := client.ExecuteTransaction(ctx, req)
80
	se err != nil {
81
		log.Fatalf("ExecuteTransaction failed: %v", err)
82
	}
83

84
	// Marshal response to pretty JSON
85
	marshaler := protojson.MarshalOptions{
86
		UseProtoNames:   true,
87
		EmitUnpopulated: true,
88
		Indent:          "  ",
89
	}
90
	jsonBytes, err := marshaler.Marshal(resp)
91
	se err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	// Print result
96
	var pretty map[string]interface{}
97
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
98
		log.Fatalf("Failed to parse JSON: %v", err)
99
	}
100
	output, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(output))
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
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
6
// For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
7
// endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
8
// token will be : abcde123456789
9

10
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
11
const token = 'abcde123456789';
12

13
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/transaction_execution_service.proto');
14

15
// Load protobuf definitions
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

25
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
26
const TransactionExecutionService = proto.sui.rpc.v2.TransactionExecutionService;
27

28
// Create secure client
29
const client = new TransactionExecutionService(endpoint, grpc.credentials.createSsl());
30

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

35
// Placeholder request
36
const request = {
37
  transaction: {
38
    bcs: {
39
      bytes: Buffer.from('YOUR_BCS_SERIALIZED_TX_BYTES', 'base64') // Replace with actual bytes
40
    }
41
  },
42
  signatures: [
43
    {
44
      scheme: 0, // Usually 0 = ED25519
45
      signature: Buffer.from('YOUR_SIGNATURE_BYTES', 'base64'), // Replace with actual bytes
46
      public_key: Buffer.from('YOUR_PUBLIC_KEY_BYTES', 'base64') // Replace with actual bytes
47
    }
48
  ],
49
  read_mask: {
50
    paths: ['transaction', 'finality']
51
  }
52
};
53

54
// Call ExecuteTransaction
55
client.ExecuteTransaction(request, metadata, (err: grpc.ServiceError | null, response: any) => {
56
  if (err) {
57
    console.error('gRPC Error:', err.message);
58
    console.error('Details:', err.details);
59
  } else {
60
    console.log('Response:', JSON.stringify(response, null, 2));
61
  }
62
});
63

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

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

10
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
11
const token = 'abcde123456789';
12

13
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/transaction_execution_service.proto');
14

15
// Load protobuf definitions
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

25
const proto = grpc.loadPackageDefinition(packageDefinition) as any;
26
const TransactionExecutionService = proto.sui.rpc.v2.TransactionExecutionService;
27

28
// Create secure client
29
const client = new TransactionExecutionService(endpoint, grpc.credentials.createSsl());
30

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

35
// Placeholder request
36
const request = {
37
  transaction: {
38
    bcs: {
39
      bytes: Buffer.from('YOUR_BCS_SERIALIZED_TX_BYTES', 'base64') // Replace with actual bytes
40
    }
41
  },
42
  signatures: [
43
    {
44
      scheme: 0, // Usually 0 = ED25519
45
      signature: Buffer.from('YOUR_SIGNATURE_BYTES', 'base64'), // Replace with actual bytes
46
      public_key: Buffer.from('YOUR_PUBLIC_KEY_BYTES', 'base64') // Replace with actual bytes
47
    }
48
  ],
49
  read_mask: {
50
    paths: ['transaction', 'finality']
51
  }
52
};
53

54
// Call ExecuteTransaction
55
client.ExecuteTransaction(request, metadata, (err: grpc.ServiceError | null, response: any) => {
56
  if (err) {
57
    console.error('gRPC Error:', err.message);
58
    console.error('Details:', err.details);
59
  } else {
60
    console.log('Response:', JSON.stringify(response, null, 2));
61
  }
62
});
63

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 (
6
    transaction_execution_service_pb2,
7
    transaction_execution_service_pb2_grpc,
8
    transaction_pb2,
9
    signature_pb2,
10
    bcs_pb2
11
)
12

13
# Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
14
# For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
15
# endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
16
# token will be: abcde123456789
17

18
endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
19
token = 'abcde123456789';
20

21
def execute_transaction():
22
    channel = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
23
    stub = transaction_execution_service_pb2_grpc.TransactionExecutionServiceStub(channel)
24

25
    # === PLACEHOLDER: BCS-serialized transaction ===
26
    transaction = transaction_pb2.Transaction(
27
        bcs=bcs_pb2.Bcs(
28
            bytes=b"YOUR_BCS_SERIALIZED_TX_BYTES"
29
        )
30
    )
31

32
    signature = signature_pb2.UserSignature(
33
        scheme=0,  # e.g., 0 = ED25519
34
        signature=b"YOUR_SIGNATURE_BYTES",
35
        public_key=b"YOUR_PUBLIC_KEY_BYTES"
36
    )
37

38
    read_mask = FieldMask(paths=["transaction", "finality"])
39

40
    request = transaction_execution_service_pb2.ExecuteTransactionRequest(
41
        transaction=transaction,
42
        signatures=[signature],
43
        read_mask=read_mask
44
    )
45

46
    metadata = [("x-token", token)]
47

48
    try:
49
        response = stub.ExecuteTransaction(request, metadata=metadata)
50
        return MessageToDict(response, preserving_proto_field_name=True)
51
    except grpc.RpcError as e:
52
        return {
53
            "error": e.code().name,
54
            "details": e.details()
55
        }
56

57

58
def main():
59
    result = execute_transaction()
60
    print(json.dumps(result, indent=2))
61

62

63
if __name__ == "__main__":
64
    main()
65

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 (
6
    transaction_execution_service_pb2,
7
    transaction_execution_service_pb2_grpc,
8
    transaction_pb2,
9
    signature_pb2,
10
    bcs_pb2
11
)
12

13
# Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
14
# For eg: QN Endpoint: https://docs-demo.sui-mainnet.quiknode.pro/abcde123456789
15
# endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
16
# token will be: abcde123456789
17

18
endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
19
token = 'abcde123456789';
20

21
def execute_transaction():
22
    channel = grpc.secure_channel(endpoint, grpc.ssl_channel_credentials())
23
    stub = transaction_execution_service_pb2_grpc.TransactionExecutionServiceStub(channel)
24

25
    # === PLACEHOLDER: BCS-serialized transaction ===
26
    transaction = transaction_pb2.Transaction(
27
        bcs=bcs_pb2.Bcs(
28
            bytes=b"YOUR_BCS_SERIALIZED_TX_BYTES"
29
        )
30
    )
31

32
    signature = signature_pb2.UserSignature(
33
        scheme=0,  # e.g., 0 = ED25519
34
        signature=b"YOUR_SIGNATURE_BYTES",
35
        public_key=b"YOUR_PUBLIC_KEY_BYTES"
36
    )
37

38
    read_mask = FieldMask(paths=["transaction", "finality"])
39

40
    request = transaction_execution_service_pb2.ExecuteTransactionRequest(
41
        transaction=transaction,
42
        signatures=[signature],
43
        read_mask=read_mask
44
    )
45

46
    metadata = [("x-token", token)]
47

48
    try:
49
        response = stub.ExecuteTransaction(request, metadata=metadata)
50
        return MessageToDict(response, preserving_proto_field_name=True)
51
    except grpc.RpcError as e:
52
        return {
53
            "error": e.code().name,
54
            "details": e.details()
55
        }
56

57

58
def main():
59
    result = execute_transaction()
60
    print(json.dumps(result, indent=2))
61

62

63
if __name__ == "__main__":
64
    main()
65

Ainda não tem uma conta?

Crieendpoint seuendpoint Quicknode endpoint segundos e comece a desenvolver

Comece gratuitamente