SimulateTransaction gRPC Method

Parâmetros

transação

objeto

OBRIGATÓRIO

Carregando...

read_mask

objeto

Carregando...

checks

cadeia de caracteres

Carregando...

do_gas_selection

booleano

Carregando...

Devoluções

transação

objeto

Carregando...

digest

cadeia de caracteres

Carregando...

transação

objeto

Carregando...

effects

objeto

Carregando...

events

objeto

Carregando...

marca temporal

cadeia de caracteres

Carregando...

outputs

matriz

Carregando...

returnValues

matriz

Carregando...

mutatedByRef

matriz

Carregando...

Pedido

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/state_service.proto \
4
  -H "x-token: abcde123456789" \
5
  -d '{
6
    "transaction": {
7
      "bcs": "BASE64_TX_BYTES",
8
      "signatures": [
9
        {
10
          "scheme": "ED25519",
11
          "signature": "BASE64_SIGNATURE",
12
          "public_key": "BASE64_PUBLIC_KEY"
13
        }
14
      ]
15
    },
16
    "read_mask": { "paths": ["transaction.effects", "transaction.events"] },
17
    "checks": "ENABLED",
18
    "do_gas_selection": true
19
  }' \
20
  docs-demo.sui-mainnet.quiknode.pro:9000 \
21
  sui.rpc.v2.StateService/SimulateTransaction

1
grpcurl \
2
  -import-path . \
3
  -proto sui/rpc/v2/state_service.proto \
4
  -H "x-token: abcde123456789" \
5
  -d '{
6
    "transaction": {
7
      "bcs": "BASE64_TX_BYTES",
8
      "signatures": [
9
        {
10
          "scheme": "ED25519",
11
          "signature": "BASE64_SIGNATURE",
12
          "public_key": "BASE64_PUBLIC_KEY"
13
        }
14
      ]
15
    },
16
    "read_mask": { "paths": ["transaction.effects", "transaction.events"] },
17
    "checks": "ENABLED",
18
    "do_gas_selection": true
19
  }' \
20
  docs-demo.sui-mainnet.quiknode.pro:9000 \
21
  sui.rpc.v2.StateService/SimulateTransaction

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
// 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 cadeia de caracteres
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]cadeia de caracteres, erro) {
35
	return map[string]string{"x-token": a.token}, nil
36
}
37
func (a *auth) RequireTransportSecurity() bool {
38
	return true
39
}
40

41
func main() {
42
	creds := credentials.NewTLS(&tls.Config{})
43
	opts := []grpc.DialOption{
44
		grpc.WithTransportCredentials(creds),
45
		grpc.WithPerRPCCredentials(&auth{token}),
46
	}
47

48
	conn, err := grpc.Dial(endpoint, opts...)
49
	se err != nil {
50
		log.Fatalf("Failed to connect: %v", err)
51
	}
52
	adiar conn.Fechar()
53

54
	client := pb.NewStateServiceClient(conn)
55

56
	req := &pb.SimulateTransactionRequest{
57
		Transaction: &pb.Transaction{
58
			Bcs: &pb.BcsBytes{
59
				Bytes: []byte("YOUR_BCS_SERIALIZED_TX_BYTES"), // Replace with actual bytes
60
			},
61
		},
62
		Signatures: []*pb.Signature{
63
			{
64
				Scheme:    0, // ED25519
65
				Signature: []byte("YOUR_SIGNATURE_BYTES"), // Replace with actual bytes
66
				PublicKey: []byte("YOUR_PUBLIC_KEY_BYTES"), // Replace with actual bytes
67
			},
68
		},
69
		ReadMask: &fieldmaskpb.FieldMask{
70
			Paths: []string{
71
				"effects",
72
				"events",
73
			},
74
		},
75
	}
76

77
	ctx, cancel := contexto.WithTimeout(contexto.Background(), 10*vez.Segundo)
78
	adiar cancelar()
79

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

85
	// Pretty print the response
86
	marshaler := protojson.MarshalOptions{
87
		UseProtoNames:   true,
88
		EmitUnpopulated: true,
89
		Indent:          "  ",
90
	}
91

92
	jsonBytes, err := marshaler.Marshal(resp)
93
	se err != nil {
94
		log.Fatalf("Failed to marshal: %v", err)
95
	}
96

97
	var pretty map[string]interface{}
98
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
99
		log.Fatalf("Failed to parse JSON: %v", err)
100
	}
101

102
	out, _ := json.MarshalIndent(pretty, "", "  ")
103
	fmt.Println(string(out))
104
}
105

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
// 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 cadeia de caracteres
32
}
33

34
func (a *auth) GetRequestMetadata(ctx contexto.Context, uri ...string) (mapa[string]cadeia de caracteres, erro) {
35
	return map[string]string{"x-token": a.token}, nil
36
}
37
func (a *auth) RequireTransportSecurity() bool {
38
	return true
39
}
40

41
func main() {
42
	creds := credentials.NewTLS(&tls.Config{})
43
	opts := []grpc.DialOption{
44
		grpc.WithTransportCredentials(creds),
45
		grpc.WithPerRPCCredentials(&auth{token}),
46
	}
47

48
	conn, err := grpc.Dial(endpoint, opts...)
49
	se err != nil {
50
		log.Fatalf("Failed to connect: %v", err)
51
	}
52
	adiar conn.Fechar()
53

54
	client := pb.NewStateServiceClient(conn)
55

56
	req := &pb.SimulateTransactionRequest{
57
		Transaction: &pb.Transaction{
58
			Bcs: &pb.BcsBytes{
59
				Bytes: []byte("YOUR_BCS_SERIALIZED_TX_BYTES"), // Replace with actual bytes
60
			},
61
		},
62
		Signatures: []*pb.Signature{
63
			{
64
				Scheme:    0, // ED25519
65
				Signature: []byte("YOUR_SIGNATURE_BYTES"), // Replace with actual bytes
66
				PublicKey: []byte("YOUR_PUBLIC_KEY_BYTES"), // Replace with actual bytes
67
			},
68
		},
69
		ReadMask: &fieldmaskpb.FieldMask{
70
			Paths: []string{
71
				"effects",
72
				"events",
73
			},
74
		},
75
	}
76

77
	ctx, cancel := contexto.WithTimeout(contexto.Background(), 10*vez.Segundo)
78
	adiar cancelar()
79

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

85
	// Pretty print the response
86
	marshaler := protojson.MarshalOptions{
87
		UseProtoNames:   true,
88
		EmitUnpopulated: true,
89
		Indent:          "  ",
90
	}
91

92
	jsonBytes, err := marshaler.Marshal(resp)
93
	se err != nil {
94
		log.Fatalf("Failed to marshal: %v", err)
95
	}
96

97
	var pretty map[string]interface{}
98
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
99
		log.Fatalf("Failed to parse JSON: %v", err)
100
	}
101

102
	out, _ := json.MarshalIndent(pretty, "", "  ")
103
	fmt.Println(string(out))
104
}
105

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

5
// Configuration
6
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/state_service.proto');
7

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

13
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
14
const token = 'abcde123456789';
15

16
// Load protobuf definitions
17
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
18
  keepCase: true,
19
  longs: String,
20
  enums: String,
21
  defaults: true,
22
  oneofs: true,
23
  includeDirs: [path.join(__dirname, 'protos/proto')],
24
});
25

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

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

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

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

55
// Perform gRPC call
56
client.SimulateTransaction(request, metadata, (err: grpc.ServiceError | null, response: any) => {
57
  if (err) {
58
    console.error('gRPC Error:', {
59
      code: err.code,
60
      message: err.message,
61
      details: err.details,
62
    });
63
  } else {
64
    console.log('SimulateTransaction Response:');
65
    console.log(JSON.stringify(response, null, 2));
66
  }
67
});
68

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

5
// Configuration
6
const PROTO_PATH = path.join(__dirname, 'protos/proto/sui/rpc/v2/state_service.proto');
7

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

13
const endpoint = 'docs-demo.sui-mainnet.quiknode.pro:9000';
14
const token = 'abcde123456789';
15

16
// Load protobuf definitions
17
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
18
  keepCase: true,
19
  longs: String,
20
  enums: String,
21
  defaults: true,
22
  oneofs: true,
23
  includeDirs: [path.join(__dirname, 'protos/proto')],
24
});
25

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

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

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

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

55
// Perform gRPC call
56
client.SimulateTransaction(request, metadata, (err: grpc.ServiceError | null, response: any) => {
57
  if (err) {
58
    console.error('gRPC Error:', {
59
      code: err.code,
60
      message: err.message,
61
      details: err.details,
62
    });
63
  } else {
64
    console.log('SimulateTransaction Response:');
65
    console.log(JSON.stringify(response, null, 2));
66
  }
67
});
68

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 state_service_pb2, state_service_pb2_grpc
6

7

8
def simulate_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 = state_service_pb2_grpc.StateServiceStub(channel)
19

20
    read_mask = FieldMask(paths=[
21
        "effects",
22
        "events"
23
    ])
24

25
    request = state_service_pb2.SimulateTransactionRequest(
26
        transaction=state_service_pb2.Transaction(
27
            bcs=state_service_pb2.BcsBytes(
28
                bytes=b"YOUR_BCS_SERIALIZED_TX_BYTES"  # Replace with actual bytes
29
            )
30
        ),
31
        signatures=[
32
            state_service_pb2.Signature(
33
                scheme=0,  # ED25519
34
                signature=b"YOUR_SIGNATURE_BYTES",  # Replace with actual bytes
35
                public_key=b"YOUR_PUBLIC_KEY_BYTES"  # Replace with actual bytes
36
            )
37
        ],
38
        read_mask=read_mask
39
    )
40

41
    metadata = [("x-token", token)]
42

43
    return stub.SimulateTransaction(request, metadata=metadata)
44

45

46
def parse_response_to_json(response):
47
    return json.dumps(
48
        MessageToDict(response, preserving_proto_field_name=True),
49
        indent=2
50
    )
51

52

53
def main():
54
    try:
55
        response = simulate_transaction()
56
        print(parse_response_to_json(response))
57
    except grpc.RpcError as e:
58
        print(f"{e.code().name}: {e.details()}")
59

60
if __name__ == "__main__":
61
    main()
62

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 state_service_pb2, state_service_pb2_grpc
6

7

8
def simulate_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 = state_service_pb2_grpc.StateServiceStub(channel)
19

20
    read_mask = FieldMask(paths=[
21
        "effects",
22
        "events"
23
    ])
24

25
    request = state_service_pb2.SimulateTransactionRequest(
26
        transaction=state_service_pb2.Transaction(
27
            bcs=state_service_pb2.BcsBytes(
28
                bytes=b"YOUR_BCS_SERIALIZED_TX_BYTES"  # Replace with actual bytes
29
            )
30
        ),
31
        signatures=[
32
            state_service_pb2.Signature(
33
                scheme=0,  # ED25519
34
                signature=b"YOUR_SIGNATURE_BYTES",  # Replace with actual bytes
35
                public_key=b"YOUR_PUBLIC_KEY_BYTES"  # Replace with actual bytes
36
            )
37
        ],
38
        read_mask=read_mask
39
    )
40

41
    metadata = [("x-token", token)]
42

43
    return stub.SimulateTransaction(request, metadata=metadata)
44

45

46
def parse_response_to_json(response):
47
    return json.dumps(
48
        MessageToDict(response, preserving_proto_field_name=True),
49
        indent=2
50
    )
51

52

53
def main():
54
    try:
55
        response = simulate_transaction()
56
        print(parse_response_to_json(response))
57
    except grpc.RpcError as e:
58
        print(f"{e.code().name}: {e.details()}")
59

60
if __name__ == "__main__":
61
    main()
62

Ainda não tem uma conta?

Crieendpoint seuendpoint Quicknode endpoint segundos e comece a desenvolver

Comece gratuitamente