@thru/thru-sdk 0.1.11 → 0.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thru/thru-sdk",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "type": "module",
   "main": "./dist/sdk.js",
   "types": "./dist/sdk.d.ts",
@@ -21,8 +21,8 @@
     "@connectrpc/connect-web": "^2.1.0",
     "@noble/ed25519": "^2.3.0",
     "@noble/hashes": "^1.4.0",
-    "@thru/crypto": "0.1.11",
-    "@thru/helpers": "0.1.11"
+    "@thru/crypto": "0.1.12",
+    "@thru/helpers": "0.1.12"
   },
   "devDependencies": {
     "@bufbuild/buf": "^1.58.0",

package/proto/thru/common/v1/consensus.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.common.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";

package/proto/thru/common/v1/errors.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.common.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
@@ -52,15 +50,15 @@ message ErrorDetail {
   ];
 
   // Optional retention window expressed in slots when applicable.
-  uint64 retention_window_slots = 3
+  optional uint64 retention_window_slots = 3
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional retention cutoff timestamp when applicable.
-  google.protobuf.Timestamp retention_cutoff = 4
+  optional google.protobuf.Timestamp retention_cutoff = 4
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional name of the field associated with the error.
-  string field_name = 5 [
+  optional string field_name = 5 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 128
   ];

package/proto/thru/common/v1/filters.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.common.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 
@@ -18,13 +16,25 @@ option swift_prefix = "THU";
 // Filter represents a CEL-based expression applied to query or stream results.
 message Filter {
   // CEL expression applied server-side. Empty expressions are treated as no-op.
-  string expression = 1 [
+  optional string expression = 1 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 4096
   ];
 
   // Named parameter bindings for expression parameterization.
-  map<string, string> params = 2 [(google.api.field_behavior) = OPTIONAL];
+  map<string, FilterParamValue> params = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// FilterParamValue carries strongly-typed CEL parameter bindings.
+message FilterParamValue {
+  oneof kind {
+    string string_value = 1 [(google.api.field_behavior) = OPTIONAL];
+    bytes bytes_value = 2 [(google.api.field_behavior) = OPTIONAL];
+    bool bool_value = 3 [(google.api.field_behavior) = OPTIONAL];
+    sint64 int_value = 4 [(google.api.field_behavior) = OPTIONAL];
+    double double_value = 5 [(google.api.field_behavior) = OPTIONAL];
+  }
 }
 
 // CelFilterValidation describes the validation configuration returned to
@@ -43,7 +53,7 @@ message CelFilterValidation {
   ];
 
   // Maximum AST node count permitted for a CEL expression.
-  uint32 max_complexity = 3 [
+  optional uint32 max_complexity = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).uint32.lte = 1000
   ];

package/proto/thru/common/v1/pagination.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.common.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 
@@ -18,20 +16,20 @@ option swift_prefix = "THU";
 // PageRequest contains pagination parameters for listing RPCs.
 message PageRequest {
   // Maximum number of items to return in a single response.
-  uint32 page_size = 1 [
+  optional uint32 page_size = 1 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).uint32.gte = 1,
     (buf.validate.field).uint32.lte = 1000
   ];
 
   // Token identifying the position to resume from.
-  string page_token = 2 [
+  optional string page_token = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 512
   ];
 
   // Optional ordering specification in "field [asc|desc]" form.
-  string order_by = 3 [
+  optional string order_by = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 256
   ];
@@ -40,8 +38,8 @@ message PageRequest {
 // PageResponse captures pagination metadata returned with list results.
 message PageResponse {
   // Token to retrieve the next page of results, if any.
-  string next_page_token = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional string next_page_token = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Total number of items available when known.
-  uint64 total_size = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional uint64 total_size = 2 [(google.api.field_behavior) = OPTIONAL];
 }

package/proto/thru/core/v1/account.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.core.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
@@ -38,13 +36,13 @@ enum AccountView {
 
 // AccountFlags enumerates boolean account capability flags.
 message AccountFlags {
-  bool is_program = 1 [(google.api.field_behavior) = OPTIONAL];
-  bool is_privileged = 2 [(google.api.field_behavior) = OPTIONAL];
-  bool is_uncompressable = 3 [(google.api.field_behavior) = OPTIONAL];
-  bool is_ephemeral = 4 [(google.api.field_behavior) = OPTIONAL];
-  bool is_deleted = 5 [(google.api.field_behavior) = OPTIONAL];
-  bool is_new = 6 [(google.api.field_behavior) = OPTIONAL];
-  bool is_compressed = 7 [(google.api.field_behavior) = OPTIONAL];
+  bool is_program = 1 [(google.api.field_behavior) = REQUIRED];
+  bool is_privileged = 2 [(google.api.field_behavior) = REQUIRED];
+  bool is_uncompressable = 3 [(google.api.field_behavior) = REQUIRED];
+  bool is_ephemeral = 4 [(google.api.field_behavior) = REQUIRED];
+  bool is_deleted = 5 [(google.api.field_behavior) = REQUIRED];
+  bool is_new = 6 [(google.api.field_behavior) = REQUIRED];
+  bool is_compressed = 7 [(google.api.field_behavior) = REQUIRED];
 }
 
 // AccountMeta captures metadata associated with an account.
@@ -53,22 +51,23 @@ message AccountMeta {
     (google.api.field_behavior) = REQUIRED,
     (buf.validate.field).uint32.gte = 1
   ];
-  AccountFlags flags = 2 [(google.api.field_behavior) = OPTIONAL];
+  AccountFlags flags = 2 [(google.api.field_behavior) = REQUIRED];
   uint32 data_size = 3 [(google.api.field_behavior) = REQUIRED];
-  uint64 state_counter = 4 [(google.api.field_behavior) = OPTIONAL];
+  // Account sequence number
+  uint64 seq = 4 [(google.api.field_behavior) = REQUIRED];
   Pubkey owner = 5 [(google.api.field_behavior) = REQUIRED];
-  uint64 balance = 6 [(google.api.field_behavior) = OPTIONAL];
-  uint64 nonce = 7 [(google.api.field_behavior) = OPTIONAL];
+  uint64 balance = 6 [(google.api.field_behavior) = REQUIRED];
+  uint64 nonce = 7 [(google.api.field_behavior) = REQUIRED];
 }
 
 // AccountData contains account data payloads.
 message AccountData {
-  bytes data = 1 [
+  optional bytes data = 1 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).bytes.max_len = 16777216
   ];
-  bool compressed = 2 [(google.api.field_behavior) = OPTIONAL];
-  string compression_algorithm = 3 [
+  optional bool compressed = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional string compression_algorithm = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 64
   ];
@@ -97,8 +96,8 @@ message AccountPage {
     (google.api.field_behavior) = REQUIRED,
     (buf.validate.field).bytes.max_len = 4096
   ];
-  bool compressed = 4 [(google.api.field_behavior) = OPTIONAL];
-  string compression_algorithm = 5 [
+  optional bool compressed = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional string compression_algorithm = 5 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).string.max_len = 64
   ];
@@ -106,19 +105,19 @@ message AccountPage {
 
 // VersionContextMetadata captures context for a returned account state.
 message VersionContextMetadata {
-  uint64 slot = 1 [(google.api.field_behavior) = OPTIONAL];
-  google.protobuf.Timestamp block_timestamp = 2
+  optional uint64 slot = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional google.protobuf.Timestamp block_timestamp = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Account models a fully decoded account resource.
 message Account {
   Pubkey address = 1 [(google.api.field_behavior) = REQUIRED];
-  AccountMeta meta = 2 [(google.api.field_behavior) = OPTIONAL];
-  AccountData data = 3 [(google.api.field_behavior) = OPTIONAL];
-  VersionContextMetadata version_context = 4
+  optional AccountMeta meta = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional AccountData data = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional VersionContextMetadata version_context = 4
       [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus consensus_status = 5
+  optional thru.common.v1.ConsensusStatus consensus_status = 5
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -129,10 +128,10 @@ message RawAccount {
     (google.api.field_behavior) = REQUIRED,
     (buf.validate.field).bytes.max_len = 4096
   ];
-  bytes raw_data = 3 [
+  optional bytes raw_data = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).bytes.max_len = 16777216
   ];
-  VersionContextMetadata version_context = 4
+  optional VersionContextMetadata version_context = 4
       [(google.api.field_behavior) = OPTIONAL];
 }

package/proto/thru/core/v1/block.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.core.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
@@ -35,13 +33,13 @@ message BlockHeader {
   uint32 version = 4 [(google.api.field_behavior) = REQUIRED];
   Pubkey producer = 5 [(google.api.field_behavior) = REQUIRED];
   google.protobuf.Timestamp expiry_timestamp = 6
-      [(google.api.field_behavior) = OPTIONAL];
-  uint64 start_slot = 7 [(google.api.field_behavior) = OPTIONAL];
-  uint32 expiry_after = 8 [(google.api.field_behavior) = OPTIONAL];
-  uint32 max_block_size = 9 [(google.api.field_behavior) = OPTIONAL];
-  uint64 max_compute_units = 10 [(google.api.field_behavior) = OPTIONAL];
-  uint32 max_state_units = 11 [(google.api.field_behavior) = OPTIONAL];
-  uint64 price = 12 [(google.api.field_behavior) = OPTIONAL];
+      [(google.api.field_behavior) = REQUIRED];
+  uint64 start_slot = 7 [(google.api.field_behavior) = REQUIRED];
+  uint32 expiry_after = 8 [(google.api.field_behavior) = REQUIRED];
+  uint32 max_block_size = 9 [(google.api.field_behavior) = REQUIRED];
+  uint64 max_compute_units = 10 [(google.api.field_behavior) = REQUIRED];
+  uint32 max_state_units = 11 [(google.api.field_behavior) = REQUIRED];
+  uint64 price = 12 [(google.api.field_behavior) = REQUIRED];
 }
 
 // ExecutionStatus enumerates block execution results.
@@ -56,19 +54,19 @@ enum ExecutionStatus {
 message BlockFooter {
   Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
   ExecutionStatus status = 2 [(google.api.field_behavior) = REQUIRED];
-  uint64 consumed_compute_units = 3 [(google.api.field_behavior) = OPTIONAL];
-  uint32 consumed_state_units = 4 [(google.api.field_behavior) = OPTIONAL];
+  uint64 consumed_compute_units = 3 [(google.api.field_behavior) = REQUIRED];
+  uint32 consumed_state_units = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Block represents a fully decoded block resource.
 message Block {
   BlockHeader header = 1 [(google.api.field_behavior) = REQUIRED];
-  BlockFooter footer = 2 [(google.api.field_behavior) = OPTIONAL];
-  bytes body = 3 [
+  optional BlockFooter footer = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional bytes body = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).bytes.max_len = 33554432
   ];
-  thru.common.v1.ConsensusStatus consensus_status = 4
+  optional thru.common.v1.ConsensusStatus consensus_status = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 

package/proto/thru/core/v1/state.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.core.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "google/api/field_behavior.proto";
 import "thru/core/v1/types.proto";
 
@@ -27,7 +25,7 @@ enum StateProofType {
 message StateProofRequest {
   Pubkey address = 1 [(google.api.field_behavior) = REQUIRED];
   StateProofType proof_type = 2 [(google.api.field_behavior) = REQUIRED];
-  uint64 target_slot = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional uint64 target_slot = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // StateProof returns binary proof data along with context.

package/proto/thru/core/v1/transaction.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.core.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "thru/core/v1/types.proto";
@@ -25,36 +23,79 @@ enum TransactionView {
   TRANSACTION_VIEW_FULL = 4;
 }
 
+// TransactionVmError enumerates runtime error codes returned by the executor.
+enum TransactionVmError {
+  TRANSACTION_VM_EXECUTE_SUCCESS = 0; // TN_RUNTIME_TXN_EXECUTE_SUCCESS
+  TRANSACTION_VM_ERROR_INVALID_FORMAT = -255;  // TN_RUNTIME_TXN_ERR_INVALID_FORMAT
+  TRANSACTION_VM_ERROR_INVALID_VERSION = -254;  // TN_RUNTIME_TXN_ERR_INVALID_VERSION
+  TRANSACTION_VM_ERROR_INVALID_FLAGS = -253;  // TN_RUNTIME_TXN_ERR_INVALID_FLAGS
+  TRANSACTION_VM_ERROR_INVALID_SIGNATURE = -252;  // TN_RUNTIME_TXN_ERR_INVALID_SIGNATURE
+  TRANSACTION_VM_ERROR_DUPLICATE_ACCOUNT = -251;  // TN_RUNTIME_TXN_ERR_DUPLICATE_ACCOUNT
+  TRANSACTION_VM_ERROR_UNSORTED_ACCOUNTS = -250;  // TN_RUNTIME_TXN_ERR_UNSORTED_ACCOUNTS
+  TRANSACTION_VM_ERROR_UNSORTED_READWRITE_ACCOUNTS =
+      -249;  // TN_RUNTIME_TXN_ERR_UNSORTED_READWRITE_ACCOUNTS
+  TRANSACTION_VM_ERROR_UNSORTED_READONLY_ACCOUNTS =
+      -248;  // TN_RUNTIME_TXN_ERR_UNSORTED_READONLY_ACCOUNTS
+  TRANSACTION_VM_ERROR_ACCOUNT_COUNT_LIMIT_EXCEEDED =
+      -247;  // TN_RUNTIME_TXN_ERR_ACCOUNT_COUNT_LIMIT_EXCEEDED
+  TRANSACTION_VM_ERROR_NONCE_TOO_LOW = -511;  // TN_RUNTIME_TXN_ERR_NONCE_TOO_LOW
+  TRANSACTION_VM_ERROR_NONCE_TOO_HIGH = -510;  // TN_RUNTIME_TXN_ERR_NONCE_TOO_HIGH
+  TRANSACTION_VM_ERROR_INSUFFICIENT_FEE_PAYER_BALANCE =
+      -509;  // TN_RUNTIME_TXN_ERR_INSUFFICIENT_FEE_PAYER_BALANCE
+  TRANSACTION_VM_ERROR_FEE_PAYER_ACCOUNT_DOES_NOT_EXIST =
+    -508;  // TN_RUNTIME_TXN_ERR_FEE_PAYER_ACCOUNT_DOES_NOT_EXIST
+  TRANSACTION_VM_ERROR_NOT_LIVE_YET = -507;  // TN_RUNTIME_TXN_ERR_NOT_LIVE_YET
+  TRANSACTION_VM_ERROR_EXPIRED = -506;       // TN_RUNTIME_TXN_ERR_EXPIRED
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_STATE_PROOF =
+      -505;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_STATE_PROOF
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_STATE_PROOF_TYPE =
+      -504;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_STATE_PROOF_TYPE
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_STATE_PROOF_SLOT =
+      -503;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_STATE_PROOF_SLOT
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_ACCOUNT_OWNER =
+      -502;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_ACCOUNT_OWNER
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_STATE_PROOF_ACCOUNT_OWNER =
+      -501;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_STATE_PROOF_ACCOUNT_OWNER
+  TRANSACTION_VM_ERROR_INVALID_FEE_PAYER_STATE_PROOF_ACCOUNT_META_DATA_SZ =
+      -500;  // TN_RUNTIME_TXN_ERR_INVALID_FEE_PAYER_STATE_PROOF_ACCOUNT_META_DATA_SZ
+  TRANSACTION_VM_ERROR_VM_FAILED = -767;  // TN_RUNTIME_TXN_ERR_VM_FAILED
+  TRANSACTION_VM_ERROR_INVALID_PROGRAM_ACCOUNT =
+      -766;                                     // TN_RUNTIME_TXN_ERR_INVALID_PROGRAM_ACCOUNT
+  TRANSACTION_VM_ERROR_VM_REVERT = -765;        // TN_RUNTIME_TXN_ERR_VM_REVERT
+  TRANSACTION_VM_ERROR_CU_EXHAUSTED = -764;     // TN_RUNTIME_TXN_ERR_CU_EXHAUSTED
+  TRANSACTION_VM_ERROR_SU_EXHAUSTED = -763;     // TN_RUNTIME_TXN_ERR_SU_EXHAUSTED
+}
+
 // TransactionHeader carries structured metadata for a transaction.
 message TransactionHeader {
   Signature fee_payer_signature = 1 [(google.api.field_behavior) = REQUIRED];
   uint32 version = 2 [(google.api.field_behavior) = REQUIRED];
-  uint32 flags = 3 [(google.api.field_behavior) = OPTIONAL];
-  uint32 readwrite_accounts_count = 4 [(google.api.field_behavior) = OPTIONAL];
-  uint32 readonly_accounts_count = 5 [(google.api.field_behavior) = OPTIONAL];
-  uint32 instruction_data_size = 6 [(google.api.field_behavior) = OPTIONAL];
-  uint32 requested_compute_units = 7 [(google.api.field_behavior) = OPTIONAL];
-  uint32 requested_state_units = 8 [(google.api.field_behavior) = OPTIONAL];
-  uint32 requested_memory_units = 9 [(google.api.field_behavior) = OPTIONAL];
-  uint32 expiry_after = 10 [(google.api.field_behavior) = OPTIONAL];
-  uint64 fee = 11 [(google.api.field_behavior) = OPTIONAL];
-  uint64 nonce = 12 [(google.api.field_behavior) = OPTIONAL];
-  uint64 start_slot = 13 [(google.api.field_behavior) = OPTIONAL];
-  Pubkey fee_payer_pubkey = 14 [(google.api.field_behavior) = OPTIONAL];
-  Pubkey program_pubkey = 15 [(google.api.field_behavior) = OPTIONAL];
+  uint32 flags = 3 [(google.api.field_behavior) = REQUIRED];
+  uint32 readwrite_accounts_count = 4 [(google.api.field_behavior) = REQUIRED];
+  uint32 readonly_accounts_count = 5 [(google.api.field_behavior) = REQUIRED];
+  uint32 instruction_data_size = 6 [(google.api.field_behavior) = REQUIRED];
+  uint32 requested_compute_units = 7 [(google.api.field_behavior) = REQUIRED];
+  uint32 requested_state_units = 8 [(google.api.field_behavior) = REQUIRED];
+  uint32 requested_memory_units = 9 [(google.api.field_behavior) = REQUIRED];
+  uint32 expiry_after = 10 [(google.api.field_behavior) = REQUIRED];
+  uint64 fee = 11 [(google.api.field_behavior) = REQUIRED];
+  uint64 nonce = 12 [(google.api.field_behavior) = REQUIRED];
+  uint64 start_slot = 13 [(google.api.field_behavior) = REQUIRED];
+  Pubkey fee_payer_pubkey = 14 [(google.api.field_behavior) = REQUIRED];
+  Pubkey program_pubkey = 15 [(google.api.field_behavior) = REQUIRED];
 }
 
 // TransactionExecutionResult captures execution outcomes.
 message TransactionExecutionResult {
-  uint32 consumed_compute_units = 1 [(google.api.field_behavior) = OPTIONAL];
-  uint32 consumed_memory_units = 2 [(google.api.field_behavior) = OPTIONAL];
-  uint32 consumed_state_units = 3 [(google.api.field_behavior) = OPTIONAL];
-  uint64 user_error_code = 4 [(google.api.field_behavior) = OPTIONAL];
-  uint32 vm_error = 5 [(google.api.field_behavior) = OPTIONAL];
-  uint64 execution_result = 6 [(google.api.field_behavior) = OPTIONAL];
-  uint32 pages_used = 7 [(google.api.field_behavior) = OPTIONAL];
-  uint32 events_count = 8 [(google.api.field_behavior) = OPTIONAL];
-  uint32 events_size = 9 [(google.api.field_behavior) = OPTIONAL];
+  uint32 consumed_compute_units = 1 [(google.api.field_behavior) = REQUIRED];
+  uint32 consumed_memory_units = 2 [(google.api.field_behavior) = REQUIRED];
+  uint32 consumed_state_units = 3 [(google.api.field_behavior) = REQUIRED];
+  uint64 user_error_code = 4 [(google.api.field_behavior) = REQUIRED];
+  TransactionVmError vm_error = 5 [(google.api.field_behavior) = REQUIRED];
+  uint64 execution_result = 6 [(google.api.field_behavior) = REQUIRED];
+  uint32 pages_used = 7 [(google.api.field_behavior) = REQUIRED];
+  uint32 events_count = 8 [(google.api.field_behavior) = REQUIRED];
+  uint32 events_size = 9 [(google.api.field_behavior) = REQUIRED];
   repeated Pubkey readwrite_accounts = 10
       [(google.api.field_behavior) = OPTIONAL];
   repeated Pubkey readonly_accounts = 11
@@ -64,25 +105,25 @@ message TransactionExecutionResult {
 }
 // TransactionEvent describes an event emitted during transaction execution.
 message TransactionEvent {
-  string event_id = 1 [(google.api.field_behavior) = OPTIONAL];
-  uint32 call_idx = 2 [(google.api.field_behavior) = OPTIONAL];
-  uint32 program_idx = 3 [(google.api.field_behavior) = OPTIONAL];
-  Pubkey program = 4 [(google.api.field_behavior) = OPTIONAL];
-  bytes payload = 5 [(google.api.field_behavior) = OPTIONAL];
+  string event_id = 1 [(google.api.field_behavior) = REQUIRED];
+  uint32 call_idx = 2 [(google.api.field_behavior) = REQUIRED];
+  uint32 program_idx = 3 [(google.api.field_behavior) = REQUIRED];
+  Pubkey program = 4 [(google.api.field_behavior) = REQUIRED];
+  bytes payload = 5 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Transaction describes a fully decoded transaction resource.
 message Transaction {
   Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
-  TransactionHeader header = 2 [(google.api.field_behavior) = OPTIONAL];
-  bytes body = 3 [
+  TransactionHeader header = 2 [(google.api.field_behavior) = REQUIRED];
+  optional bytes body = 3 [
     (google.api.field_behavior) = OPTIONAL,
     (buf.validate.field).bytes.max_len = 16777216
   ];
-  TransactionExecutionResult execution_result = 4
+  optional TransactionExecutionResult execution_result = 4
       [(google.api.field_behavior) = OPTIONAL];
-  uint64 slot = 5 [(google.api.field_behavior) = OPTIONAL];
-  uint32 block_offset = 6 [(google.api.field_behavior) = OPTIONAL];
+  optional uint64 slot = 5 [(google.api.field_behavior) = OPTIONAL];
+  optional uint32 block_offset = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // RawTransaction provides direct access to serialized transaction bytes.

package/proto/thru/core/v1/types.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.core.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 

package/proto/thru/services/v1/command_service.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.services.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
@@ -29,6 +27,24 @@ message SendTransactionResponse {
   thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
+// BatchSendTransactionsRequest submits multiple transactions to the cluster.
+message BatchSendTransactionsRequest {
+  // List of raw transaction bytes encoded according to chain specification.
+  repeated bytes raw_transactions = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Number of retries for each transaction if not accepted by UDS (defaults to 0).
+  int32 num_retries = 2;
+}
+
+// BatchSendTransactionsResponse returns submission results for each transaction.
+message BatchSendTransactionsResponse {
+  // Signatures for each transaction (in same order as request).
+  repeated thru.core.v1.Signature signatures = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Acceptance status for each transaction (true if accepted, false if not).
+  repeated bool accepted = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
 // CommandService defines transactional RPCs that mutate state or perform
 // expensive computations.
 service CommandService {
@@ -42,4 +58,13 @@ service CommandService {
       body: "*"
     };
   }
+
+  // Submit multiple transactions to the cluster in batch.
+  rpc BatchSendTransactions(BatchSendTransactionsRequest)
+      returns (BatchSendTransactionsResponse) {
+    option (google.api.http) = {
+      post: "/v1/transactions/batch"
+      body: "*"
+    };
+  }
 }

package/proto/thru/services/v1/query_service.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.services.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/annotations.proto";
 import "google/api/client.proto";
@@ -28,35 +26,32 @@ option swift_prefix = "THUS";
 // GetAccountRequest retrieves a decoded account by public key.
 message GetAccountRequest {
   thru.core.v1.Pubkey address = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
   thru.common.v1.VersionContext version_context = 3
       [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
-  thru.core.v1.DataSlice data_slice = 6
+  optional thru.core.v1.DataSlice data_slice = 5
       [(google.api.field_behavior) = OPTIONAL];
-
-  reserved 5;
-  reserved skip_data;
 }
 
 // GetRawAccountRequest retrieves raw account bytes by public key.
 message GetRawAccountRequest {
   thru.core.v1.Pubkey address = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
   thru.common.v1.VersionContext version_context = 3
       [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 
 // GetTransactionRequest retrieves a decoded transaction by signature.
 message GetTransactionRequest {
   thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.TransactionView view = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.TransactionView view = 2 [(google.api.field_behavior) = OPTIONAL];
   thru.common.v1.VersionContext version_context = 3
       [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -65,7 +60,7 @@ message GetRawTransactionRequest {
   thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
   thru.common.v1.VersionContext version_context = 2
       [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.ConsensusStatus min_consensus = 3
+  optional thru.common.v1.ConsensusStatus min_consensus = 3
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -92,8 +87,8 @@ message GetBlockRequest {
     uint64 slot = 1 [(google.api.field_behavior) = OPTIONAL];
     thru.core.v1.BlockHash block_hash = 2 [(google.api.field_behavior) = OPTIONAL];
   }
-  thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -109,36 +104,40 @@ message GetRawBlockRequest {
     uint64 slot = 1 [(google.api.field_behavior) = OPTIONAL];
     thru.core.v1.BlockHash block_hash = 2 [(google.api.field_behavior) = OPTIONAL];
   }
-  thru.common.v1.ConsensusStatus min_consensus = 3
+  optional thru.common.v1.ConsensusStatus min_consensus = 3
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// ListOwnedAccountsRequest lists accounts for a given owner public key.
-message ListOwnedAccountsRequest {
-  thru.core.v1.Pubkey owner = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.VersionContext version_context = 3
+// ListAccountsRequest lists accounts using CEL filters.
+message ListAccountsRequest {
+  optional thru.core.v1.AccountView view = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.VersionContext version_context = 2
       [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.Filter filter = 4 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.PageRequest page = 5 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus min_consensus = 6
+
+  // Optional CEL filter applied server-side. To emulate the legacy
+  // ListOwnedAccounts RPC, set:
+  //   filter.expression = "meta.owner.value == params.owner_bytes"
+  //   filter.params["owner_bytes"].bytes_value = <32-byte owner pubkey>
+  optional thru.common.v1.Filter filter = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.PageRequest page = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.ConsensusStatus min_consensus = 5
       [(google.api.field_behavior) = OPTIONAL];
 }
 
-// ListOwnedAccountsResponse contains paginated accounts.
-message ListOwnedAccountsResponse {
+// ListAccountsResponse contains paginated accounts.
+message ListAccountsResponse {
   repeated thru.core.v1.Account accounts = 1
       [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.PageResponse page = 2
+  optional thru.common.v1.PageResponse page = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ListBlocksRequest lists blocks with pagination and filtering.
 message ListBlocksRequest {
-  thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.PageRequest page = 2 [(google.api.field_behavior) = OPTIONAL];
-  thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.PageRequest page = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -146,21 +145,23 @@ message ListBlocksRequest {
 message ListBlocksResponse {
   repeated thru.core.v1.Block blocks = 1
       [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.PageResponse page = 2
+  optional thru.common.v1.PageResponse page = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ListTransactionsForAccountRequest lists transaction signatures involving an account.
 message ListTransactionsForAccountRequest {
   thru.core.v1.Pubkey account = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.PageRequest page = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.PageRequest page = 2 [(google.api.field_behavior) = OPTIONAL];
+  // Optional CEL filter applied after the account constraint.
+  optional thru.common.v1.Filter filter = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ListTransactionsForAccountResponse contains transaction signatures.
 message ListTransactionsForAccountResponse {
   repeated thru.core.v1.Signature signatures = 1
       [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.PageResponse page = 2
+  optional thru.common.v1.PageResponse page = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -179,7 +180,7 @@ message GetEventRequest {
     (google.api.field_behavior) = REQUIRED,
     (buf.validate.field).string.max_len = 128
   ];
-  thru.common.v1.VersionContext version_context = 2
+  optional thru.common.v1.VersionContext version_context = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -188,12 +189,12 @@ message Event {
   string event_id = 1 [(google.api.field_behavior) = REQUIRED];
   thru.core.v1.Signature transaction_signature = 2
       [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.Pubkey program = 3 [(google.api.field_behavior) = OPTIONAL];
-  bytes payload = 4 [(google.api.field_behavior) = OPTIONAL];
-  uint64 slot = 5 [(google.api.field_behavior) = OPTIONAL];
-  uint32 call_idx = 6 [(google.api.field_behavior) = OPTIONAL];
-  uint32 program_idx = 7 [(google.api.field_behavior) = OPTIONAL];
-  uint32 payload_size = 8 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.Pubkey program = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional bytes payload = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional uint64 slot = 5 [(google.api.field_behavior) = OPTIONAL];
+  optional uint32 call_idx = 6 [(google.api.field_behavior) = OPTIONAL];
+  optional uint32 program_idx = 7 [(google.api.field_behavior) = OPTIONAL];
+  optional uint32 payload_size = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // GetTransactionStatusRequest fetches execution status for a transaction.
@@ -204,9 +205,9 @@ message GetTransactionStatusRequest {
 // TransactionStatus captures status metadata for a transaction.
 message TransactionStatus {
   thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.common.v1.ConsensusStatus consensus_status = 2
+  optional thru.common.v1.ConsensusStatus consensus_status = 2
       [(google.api.field_behavior) = OPTIONAL];
-  thru.core.v1.TransactionExecutionResult execution_result = 3
+  optional thru.core.v1.TransactionExecutionResult execution_result = 3
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -285,9 +286,8 @@ service QueryService {
     };
   }
 
-  // List accounts owned by a public key.
-  rpc ListOwnedAccounts(ListOwnedAccountsRequest)
-      returns (ListOwnedAccountsResponse) {
+  // List accounts using CEL-based filtering.
+  rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse) {
     option (google.api.http) = {
       get: "/v1/accounts"
     };

package/proto/thru/services/v1/streaming_service.proto

@@ -1,9 +1,7 @@
-edition = "2023";
+syntax = "proto3";
 
 package thru.services.v1;
 
-option features.field_presence = EXPLICIT;
-
 import "buf/validate/validate.proto";
 import "google/api/field_behavior.proto";
 import "google/protobuf/duration.proto";
@@ -25,10 +23,10 @@ option swift_prefix = "THUS";
 
 // StreamBlocksRequest subscribes to real-time block updates.
 message StreamBlocksRequest {
-  uint64 start_slot = 1 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.Filter filter = 2 [(google.api.field_behavior) = OPTIONAL];
-  thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus min_consensus = 4
+  optional uint64 start_slot = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.Filter filter = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.BlockView view = 3 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.ConsensusStatus min_consensus = 4
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -40,18 +38,18 @@ message StreamBlocksResponse {
 // StreamAccountUpdatesRequest subscribes to account delta events.
 message StreamAccountUpdatesRequest {
   thru.core.v1.Pubkey address = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.Filter filter = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.core.v1.AccountView view = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.Filter filter = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // AccountUpdate describes a delta for an account.
 message AccountUpdate {
   uint64 slot = 1 [(google.api.field_behavior) = REQUIRED];
-  thru.core.v1.AccountPage page = 2
+  optional thru.core.v1.AccountPage page = 2
       [(google.api.field_behavior) = OPTIONAL];
-  thru.core.v1.AccountMeta meta = 3
+  optional thru.core.v1.AccountMeta meta = 3
       [(google.api.field_behavior) = OPTIONAL];
-  bool delete = 4 [(google.api.field_behavior) = OPTIONAL];
+  optional bool delete = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // StreamAccountUpdatesResponse contains either an initial snapshot or a delta.
@@ -64,8 +62,8 @@ message StreamAccountUpdatesResponse {
 
 // StreamTransactionsRequest subscribes to transaction confirmations.
 message StreamTransactionsRequest {
-  thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
-  thru.common.v1.ConsensusStatus min_consensus = 2
+  optional thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.ConsensusStatus min_consensus = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -77,14 +75,14 @@ message StreamTransactionsResponse {
 
 // StreamEventsRequest subscribes to chain events.
 message StreamEventsRequest {
-  thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
+  optional thru.common.v1.Filter filter = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // StreamEventsResponse delivers event payloads.
 message StreamEventsResponse {
   string event_id = 1 [(google.api.field_behavior) = REQUIRED];
-  bytes payload = 2 [(google.api.field_behavior) = OPTIONAL];
-  google.protobuf.Timestamp timestamp = 3
+  optional bytes payload = 2 [(google.api.field_behavior) = OPTIONAL];
+  optional google.protobuf.Timestamp timestamp = 3
       [(google.api.field_behavior) = OPTIONAL];
   thru.core.v1.Pubkey program = 4 [(google.api.field_behavior) = REQUIRED];
   uint32 call_idx = 5 [(google.api.field_behavior) = REQUIRED];
@@ -96,7 +94,7 @@ message StreamEventsResponse {
 // TrackTransactionRequest subscribes to status updates for a transaction.
 message TrackTransactionRequest {
   thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
-  google.protobuf.Duration timeout = 2
+  optional google.protobuf.Duration timeout = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
 

package/thru-ts-client-sdk/test-scripts/create-account.ts

@@ -1,3 +1,4 @@
+import { bytesToHex } from "@noble/hashes/utils";
 import { createThruClient } from "../client";
 import { ConsensusStatus } from "../proto/thru/common/v1/consensus_pb";
 
@@ -12,6 +13,11 @@ const keypair = await sdk.keys.generateKeyPair()
 const targetAccountAddress = keypair.address
 const targetAccountPrivateKey = keypair.privateKey
 
+console.log("Target account address:", targetAccountAddress);
+console.log("Target account private key:", targetAccountPrivateKey);
+const targetAccountPrivateKeyHex = bytesToHex(targetAccountPrivateKey);
+console.log("Target account private key hex:", targetAccountPrivateKeyHex);
+
 async function fetchAccountSnapshot(label: string, address: string): Promise<void> {
     try {
         const account = await sdk.accounts.get(address);