ExecuteTransaction gRPC Method

参数

交易

对象

必填

正在加载...

签名

数组

正在加载...

read_mask

对象

正在加载...

退货

最终性

对象

正在加载...

certified

对象

正在加载...

checkpointed

字符串

正在加载...

quorumExecuted

对象

正在加载...

交易

对象

正在加载...

摘要

字符串

正在加载...

交易

对象

正在加载...

签名

数组

正在加载...

效果

对象

正在加载...

活动

对象

正在加载...

checkpoint

字符串

正在加载...

时间戳

字符串

正在加载...

balanceChanges

数组

正在加载...

inputObjects

数组

正在加载...

outputObjects

数组

正在加载...

请求

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.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.mainnet.quiknode.pro:9000 \
18
  sui.rpc.v2.TransactionExecutionService/ExecuteTransaction
19

1
包 main
2

3
import (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	“日志”
9
	“时间”
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" // 您生成的 .pb.go 文件路径
17
)
18

19
var (
20
	token    = "您的令牌编号"
21
	endpoint = "您的QN端点:9000"
22
)
23

24
// x-token Auth implementation
25
类型 auth 结构体 {
26
	token 字符串
27
}
28

29
func (a *auth) GetRequestMetadata(ctx 上下文.Context, uri ...字符串) (map[字符串]字符串, error) {
30
	return map[string]string{"x-token": a.token}, nil
31
}
32
func (a *auth) RequireTransportSecurity() bool {
33
	返回 true
34
}
35

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

43
	conn, err := grpc.Dial(endpoint, opts...)
44
	如果 err != nil {
45
		log.Fatalf("连接失败：%v", err)
46
	}
47
	推迟 conn.关闭()
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, 取消 := context.带超时(context.Background(), 10*时间.第二次)
77
	推迟 取消()
78

79
	resp, err := client.ExecuteTransaction(ctx, req)
80
	如果 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
		缩进:          "  ",
89
	}
90
	jsonBytes, err := marshaler.Marshal(resp)
91
	如果 err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	// Print result
96
	var pretty map[字符串]接口{}
97
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
98
		log.Fatalf(“无法解析 JSON：%v”, err)
99
	}
100
	output, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(output))
102
}
103

1
包 main
2

3
import (
4
	"上下文"
5
	"crypto/tls"
6
	"encoding/json"
7
	"fmt"
8
	“日志”
9
	“时间”
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" // 您生成的 .pb.go 文件路径
17
)
18

19
var (
20
	token    = "您的令牌编号"
21
	endpoint = "您的QN端点:9000"
22
)
23

24
// x-token Auth implementation
25
类型 auth 结构体 {
26
	token 字符串
27
}
28

29
func (a *auth) GetRequestMetadata(ctx 上下文.Context, uri ...字符串) (map[字符串]字符串, error) {
30
	return map[string]string{"x-token": a.token}, nil
31
}
32
func (a *auth) RequireTransportSecurity() bool {
33
	返回 true
34
}
35

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

43
	conn, err := grpc.Dial(endpoint, opts...)
44
	如果 err != nil {
45
		log.Fatalf("连接失败：%v", err)
46
	}
47
	推迟 conn.关闭()
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, 取消 := context.带超时(context.Background(), 10*时间.第二次)
77
	推迟 取消()
78

79
	resp, err := client.ExecuteTransaction(ctx, req)
80
	如果 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
		缩进:          "  ",
89
	}
90
	jsonBytes, err := marshaler.Marshal(resp)
91
	如果 err != nil {
92
		log.Fatalf("Failed to marshal response: %v", err)
93
	}
94

95
	// Print result
96
	var pretty map[字符串]接口{}
97
	if err := json.Unmarshal(jsonBytes, &pretty); err != nil {
98
		log.Fatalf(“无法解析 JSON：%v”, err)
99
	}
100
	output, _ := json.MarshalIndent(pretty, "", "  ")
101
	fmt.Println(string(output))
102
}
103

1
import * 作为 grpc from grpc;
2
import * 作为 protoLoader from grpc;
3
import * 作为 路径 from '路径';
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.mainnet.quiknode.pro:9000';
11
const 令牌 = '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 包定义 = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  多头: 字符串,
19
  枚举: 字符串,
20
  默认值: true,
21
  oneofs: true,
22
  includeDirs: [路径.join(__dirname, 'protos/proto')],
23
});
24

25
const proto = grpc.loadPackageDefinition(packageDefinition) 作为 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 元数据 = new grpc.元数据();
33
元数据.添加('x-token', token);
34

35
// Placeholder request
36
const 请求 = {
37
  transaction: {
38
    bcs: {
39
      字节: 缓冲区.来自('YOUR_BCS_SERIALIZED_TX_BYTES', 'base64') // 替换为实际的字节数
40
    }
41
  },
42
  签名: [
43
    {
44
      方案: 0, // 通常 0 = ED25519
45
      签名: 缓冲区.来源('YOUR_SIGNATURE_BYTES', 'base64'), // 替换为实际字节
46
      公钥: 缓冲区.来自('YOUR_PUBLIC_KEY_BYTES', 'base64') // 替换为实际的字节数组
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
  如果 (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 from grpc;
2
import * 作为 protoLoader from grpc;
3
import * 作为 路径 from '路径';
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.mainnet.quiknode.pro:9000';
11
const 令牌 = '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 包定义 = protoLoader.loadSync(PROTO_PATH, {
17
  keepCase: true,
18
  多头: 字符串,
19
  枚举: 字符串,
20
  默认值: true,
21
  oneofs: true,
22
  includeDirs: [路径.join(__dirname, 'protos/proto')],
23
});
24

25
const proto = grpc.loadPackageDefinition(packageDefinition) 作为 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 元数据 = new grpc.元数据();
33
元数据.添加('x-token', token);
34

35
// Placeholder request
36
const 请求 = {
37
  transaction: {
38
    bcs: {
39
      字节: 缓冲区.来自('YOUR_BCS_SERIALIZED_TX_BYTES', 'base64') // 替换为实际的字节数
40
    }
41
  },
42
  签名: [
43
    {
44
      方案: 0, // 通常 0 = ED25519
45
      签名: 缓冲区.来源('YOUR_SIGNATURE_BYTES', 'base64'), // 替换为实际字节
46
      公钥: 缓冲区.来自('YOUR_PUBLIC_KEY_BYTES', 'base64') // 替换为实际的字节数组
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
  如果 (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
导入 json
3
来源 谷歌.protobuf.field_mask_pb2 导入 FieldMask
4
来源 谷歌.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 由两个关键组成部分构成：endpoint 和相应的令牌
14
# 例如：QNEndpoint：mainnet
15
# endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
16
# 令牌将为：abcde123456789
17

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

21
def execute_transaction():
22
    频道 = 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
    元数据 = [("x-token", token)]
47

48
    试一试：
49
        response = stub.ExecuteTransaction(request, metadata=metadata)
50
        return MessageToDict(response, preserving_proto_field_name=True)
51
    除了 grpc。RpcError 作为 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
如果 __name__ == "__main__":
64
    主()
65

1
import grpc
2
导入 json
3
来源 谷歌.protobuf.field_mask_pb2 导入 FieldMask
4
来源 谷歌.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 由两个关键组成部分构成：endpoint 和相应的令牌
14
# 例如：QNEndpoint：mainnet
15
# endpoint will be: docs-demo.sui-mainnet.quiknode.pro:9000  {9000 is the port number for Sui gRPC}
16
# 令牌将为：abcde123456789
17

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

21
def execute_transaction():
22
    频道 = 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
    元数据 = [("x-token", token)]
47

48
    试一试：
49
        response = stub.ExecuteTransaction(request, metadata=metadata)
50
        return MessageToDict(response, preserving_proto_field_name=True)
51
    除了 grpc。RpcError 作为 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
如果 __name__ == "__main__":
64
    主()
65

还没有账号吗？

endpoint 几秒钟endpoint 创建您的Quicknode endpoint ，并开始构建

免费开始使用