@thru/thru-sdk 0.0.4

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

@@ -0,0 +1,45 @@
+edition = "2023";
+
+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";
+import "thru/core/v1/transaction.proto";
+import "thru/core/v1/types.proto";
+
+option go_package = "github.com/Unto-Labs/thru-net/grpc/pkg/proto/thru/services/v1;servicesv1";
+option java_multiple_files = true;
+option java_package = "network.thru.services.v1";
+option csharp_namespace = "Thru.Services.V1";
+option ruby_package = "Thru::Services::V1";
+option objc_class_prefix = "THUS";
+option swift_prefix = "THUS";
+
+// SendTransactionRequest submits a transaction to the cluster.
+message SendTransactionRequest {
+  // Raw transaction bytes encoded according to chain specification.
+  bytes raw_transaction = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// SendTransactionResponse echoes submission metadata.
+message SendTransactionResponse {
+  thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// CommandService defines transactional RPCs that mutate state or perform
+// expensive computations.
+service CommandService {
+  option (google.api.default_host) = "api.thru.network";
+
+  // Submit a new transaction to the cluster.
+  rpc SendTransaction(SendTransactionRequest)
+      returns (SendTransactionResponse) {
+    option (google.api.http) = {
+      post: "/v1/transactions"
+      body: "*"
+    };
+  }
+}

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

@@ -0,0 +1,344 @@
+edition = "2023";
+
+package thru.services.v1;
+
+option features.field_presence = EXPLICIT;
+
+import "buf/validate/validate.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "thru/common/v1/consensus.proto";
+import "thru/common/v1/filters.proto";
+import "thru/common/v1/pagination.proto";
+import "thru/core/v1/account.proto";
+import "thru/core/v1/block.proto";
+import "thru/core/v1/state.proto";
+import "thru/core/v1/transaction.proto";
+import "thru/core/v1/types.proto";
+
+option go_package = "github.com/Unto-Labs/thru-net/grpc/pkg/proto/thru/services/v1;servicesv1";
+option java_multiple_files = true;
+option java_package = "network.thru.services.v1";
+option csharp_namespace = "Thru.Services.V1";
+option ruby_package = "Thru::Services::V1";
+option objc_class_prefix = "THUS";
+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];
+  thru.common.v1.VersionContext version_context = 3
+      [(google.api.field_behavior) = REQUIRED];
+  thru.common.v1.ConsensusStatus min_consensus = 4
+      [(google.api.field_behavior) = OPTIONAL];
+  thru.core.v1.DataSlice data_slice = 6
+      [(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];
+  thru.common.v1.VersionContext version_context = 3
+      [(google.api.field_behavior) = REQUIRED];
+  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];
+  thru.common.v1.VersionContext version_context = 3
+      [(google.api.field_behavior) = REQUIRED];
+  thru.common.v1.ConsensusStatus min_consensus = 4
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// GetRawTransactionRequest retrieves raw transaction bytes by signature.
+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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// GenerateStateProofRequest requests an account state proof.
+message GenerateStateProofRequest {
+  thru.core.v1.StateProofRequest request = 1
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// GenerateStateProofResponse contains the generated proof.
+message GenerateStateProofResponse {
+  thru.core.v1.StateProof proof = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// GetBlockRequest retrieves decoded block information by slot or hash.
+message GetBlockRequest {
+  option (buf.validate.message).cel = {
+    id: "block_selector_set"
+    message: "either slot or block_hash must be set"
+    expression: "has(this.slot) || has(this.block_hash)"
+  };
+
+  oneof selector {
+    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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// GetRawBlockRequest retrieves raw block bytes by slot or hash.
+message GetRawBlockRequest {
+  option (buf.validate.message).cel = {
+    id: "raw_block_selector_set"
+    message: "either slot or block_hash must be set"
+    expression: "has(this.slot) || has(this.block_hash)"
+  };
+
+  oneof selector {
+    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
+      [(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
+      [(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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// ListOwnedAccountsResponse contains paginated accounts.
+message ListOwnedAccountsResponse {
+  repeated thru.core.v1.Account accounts = 1
+      [(google.api.field_behavior) = 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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// ListBlocksResponse returns a page of blocks.
+message ListBlocksResponse {
+  repeated thru.core.v1.Block blocks = 1
+      [(google.api.field_behavior) = 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];
+}
+
+// ListTransactionsForAccountResponse contains transaction signatures.
+message ListTransactionsForAccountResponse {
+  repeated thru.core.v1.Signature signatures = 1
+      [(google.api.field_behavior) = OPTIONAL];
+  thru.common.v1.PageResponse page = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// GetVersionRequest fetches component version strings.
+message GetVersionRequest {}
+
+// GetVersionResponse returns version information per component.
+message GetVersionResponse {
+  map<string, string> versions = 1
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// GetEventRequest fetches an event by identifier.
+message GetEventRequest {
+  string event_id = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (buf.validate.field).string.max_len = 128
+  ];
+  thru.common.v1.VersionContext version_context = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Event represents a transaction event emitted by the chain.
+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];
+}
+
+// GetTransactionStatusRequest fetches execution status for a transaction.
+message GetTransactionStatusRequest {
+  thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// 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
+      [(google.api.field_behavior) = OPTIONAL];
+  thru.core.v1.TransactionExecutionResult execution_result = 3
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// 
+message GetHeightRequest {}
+
+// GetHeightResponse
+message GetHeightResponse {
+  uint64 finalized = 1 [(google.api.field_behavior) = REQUIRED];
+  uint64 locally_executed = 2 [(google.api.field_behavior) = REQUIRED];
+  uint64 cluster_executed = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+
+// QueryService defines unary RPCs for accessing blockchain data.
+service QueryService {
+  option (google.api.default_host) = "api.thru.network";
+
+  // Get block heights
+  rpc GetHeight(GetHeightRequest) returns (GetHeightResponse) {
+    option (google.api.http) = {
+      get: "/v1/height"
+    };
+  }
+
+  // Get account information.
+  rpc GetAccount(GetAccountRequest) returns (thru.core.v1.Account) {
+    option (google.api.http) = {
+      get: "/v1/accounts/{address.value}"
+    };
+    option (google.api.method_signature) = "address";
+  }
+
+  // Get account raw bytes.
+  rpc GetRawAccount(GetRawAccountRequest) returns (thru.core.v1.RawAccount) {
+    option (google.api.http) = {
+      get: "/v1/accounts/{address.value}:raw"
+    };
+    option (google.api.method_signature) = "address";
+  }
+
+  // Get transaction by signature.
+  rpc GetTransaction(GetTransactionRequest) returns (thru.core.v1.Transaction) {
+    option (google.api.http) = {
+      get: "/v1/transactions/{signature.value}"
+    };
+    option (google.api.method_signature) = "signature";
+  }
+
+  // Get raw transaction by signature.
+  rpc GetRawTransaction(GetRawTransactionRequest)
+      returns (thru.core.v1.RawTransaction) {
+    option (google.api.http) = {
+      get: "/v1/transactions/{signature.value}:raw"
+    };
+    option (google.api.method_signature) = "signature";
+  }
+
+  // Get block by slot or hash.
+  rpc GetBlock(GetBlockRequest) returns (thru.core.v1.Block) {
+    option (google.api.http) = {
+      get: "/v1/blocks/{slot}"
+      additional_bindings {
+        get: "/v1/blocks/by-hash/{block_hash.value}"
+      }
+    };
+  }
+
+  // Get raw block bytes.
+  rpc GetRawBlock(GetRawBlockRequest) returns (thru.core.v1.RawBlock) {
+    option (google.api.http) = {
+      get: "/v1/blocks/{slot}:raw"
+      additional_bindings {
+        get: "/v1/blocks/by-hash/{block_hash.value}:raw"
+      }
+    };
+  }
+
+  // List accounts owned by a public key.
+  rpc ListOwnedAccounts(ListOwnedAccountsRequest)
+      returns (ListOwnedAccountsResponse) {
+    option (google.api.http) = {
+      get: "/v1/accounts"
+    };
+  }
+
+  // List blocks using pagination and filtering. By default returns blocks ordered from latest slot to the first one.
+  rpc ListBlocks(ListBlocksRequest) returns (ListBlocksResponse) {
+    option (google.api.http) = {
+      get: "/v1/blocks"
+    };
+  }
+
+  // List executed transaction signatures involving an account.
+  rpc ListTransactionsForAccount(ListTransactionsForAccountRequest)
+      returns (ListTransactionsForAccountResponse) {
+    option (google.api.http) = {
+      get: "/v1/accounts/{account.value}/transactions"
+    };
+    option (google.api.method_signature) = "account";
+  }
+
+  // Get a specific event by ID.
+  rpc GetEvent(GetEventRequest) returns (Event) {
+    option (google.api.http) = {
+      get: "/v1/events/{event_id}"
+    };
+    option (google.api.method_signature) = "event_id";
+  }
+
+  // Get derived transaction status metadata.
+  rpc GetTransactionStatus(GetTransactionStatusRequest)
+      returns (TransactionStatus) {
+    option (google.api.http) = {
+      get: "/v1/transactions/{signature.value}:status"
+    };
+    option (google.api.method_signature) = "signature";
+  }
+
+  // Generate an account state proof snapshot.
+  rpc GenerateStateProof(GenerateStateProofRequest)
+      returns (GenerateStateProofResponse) {
+    option (google.api.http) = {
+      post: "/v1/stateproofs:generate"
+      body: "*"
+    };
+  }
+
+  // Get component version strings.
+  rpc GetVersion(GetVersionRequest) returns (GetVersionResponse) {
+    option (google.api.http) = {
+      get: "/v1/version"
+    };
+  }
+}

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

@@ -0,0 +1,128 @@
+edition = "2023";
+
+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";
+import "google/protobuf/timestamp.proto";
+import "thru/common/v1/consensus.proto";
+import "thru/common/v1/filters.proto";
+import "thru/core/v1/account.proto";
+import "thru/core/v1/block.proto";
+import "thru/core/v1/transaction.proto";
+import "thru/core/v1/types.proto";
+
+option go_package = "github.com/Unto-Labs/thru-net/grpc/pkg/proto/thru/services/v1;servicesv1";
+option java_multiple_files = true;
+option java_package = "network.thru.services.v1";
+option csharp_namespace = "Thru.Services.V1";
+option ruby_package = "Thru::Services::V1";
+option objc_class_prefix = "THUS";
+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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// StreamBlocksResponse delivers block updates.
+message StreamBlocksResponse {
+  thru.core.v1.Block block = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// 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];
+}
+
+// AccountUpdate describes a delta for an account.
+message AccountUpdate {
+  uint64 slot = 1 [(google.api.field_behavior) = REQUIRED];
+  thru.core.v1.AccountPage page = 2
+      [(google.api.field_behavior) = OPTIONAL];
+  thru.core.v1.AccountMeta meta = 3
+      [(google.api.field_behavior) = OPTIONAL];
+  bool delete = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// StreamAccountUpdatesResponse contains either an initial snapshot or a delta.
+message StreamAccountUpdatesResponse {
+  oneof message {
+    thru.core.v1.Account snapshot = 1;
+    AccountUpdate update = 2;
+  }
+}
+
+// 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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// StreamTransactionsResponse delivers transaction events.
+message StreamTransactionsResponse {
+  thru.core.v1.Transaction transaction = 1
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// StreamEventsRequest subscribes to chain events.
+message StreamEventsRequest {
+  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
+      [(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];
+  thru.core.v1.Signature signature = 6
+      [(google.api.field_behavior) = REQUIRED];
+  uint64 slot = 7 [(google.api.field_behavior) = REQUIRED];
+}
+
+// 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
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// TrackTransactionResponse reports status transitions for a transaction.
+message TrackTransactionResponse {
+  thru.core.v1.Signature signature = 1 [(google.api.field_behavior) = REQUIRED];
+  thru.common.v1.ConsensusStatus consensus_status = 2
+      [(google.api.field_behavior) = OPTIONAL];
+  thru.core.v1.TransactionExecutionResult execution_result = 3
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// StreamingService serves server-streaming gRPC APIs for real-time data.
+service StreamingService {
+  rpc StreamBlocks(StreamBlocksRequest)
+      returns (stream StreamBlocksResponse);
+
+  rpc StreamAccountUpdates(StreamAccountUpdatesRequest)
+      returns (stream StreamAccountUpdatesResponse);
+
+  rpc StreamTransactions(StreamTransactionsRequest)
+      returns (stream StreamTransactionsResponse);
+
+  rpc StreamEvents(StreamEventsRequest)
+      returns (stream StreamEventsResponse);
+
+  rpc TrackTransaction(TrackTransactionRequest)
+      returns (stream TrackTransactionResponse);
+}

package/thru-ts-client-sdk/core/bound-client.ts

@@ -0,0 +1,129 @@
+import type { ThruClientContext } from "./client";
+
+import * as accountsModule from "../modules/accounts";
+import * as blocksModule from "../modules/blocks";
+import * as eventsModule from "../modules/events";
+import * as heightModule from "../modules/height";
+import {
+    decodeAddress,
+    decodeSignature,
+    deriveProgramAddress,
+    encodeAddress,
+    encodeSignature,
+    toBlockHash,
+    toPubkey,
+    toSignature,
+    type DeriveProgramAddressOptions,
+    type DeriveProgramAddressResult,
+} from "../modules/helpers";
+import * as proofsModule from "../modules/proofs";
+import * as streamingModule from "../modules/streaming";
+import * as transactionsModule from "../modules/transactions";
+import { BlockHash, Pubkey, Signature } from "../proto/thru/core/v1/types_pb";
+
+type ContextualParameters<F> = F extends (ctx: ThruClientContext, ...args: infer P) => any ? P : never;
+
+type BoundFunction<F> = F extends (ctx: ThruClientContext, ...args: infer P) => infer R ? (...args: P) => R : never;
+
+function bind<F extends (ctx: ThruClientContext, ...args: any[]) => any>(
+    ctx: ThruClientContext,
+    fn: F,
+): BoundFunction<F> {
+    return ((...args: ContextualParameters<F>) => fn(ctx, ...args)) as BoundFunction<F>;
+}
+
+export interface BoundBlocks {
+    get: BoundFunction<typeof blocksModule.getBlock>;
+    getRaw: BoundFunction<typeof blocksModule.getRawBlock>;
+    list: BoundFunction<typeof blocksModule.listBlocks>;
+    getBlockHeight: BoundFunction<typeof heightModule.getBlockHeight>;
+}
+
+export interface BoundAccounts {
+    get: BoundFunction<typeof accountsModule.getAccount>;
+    getRaw: BoundFunction<typeof accountsModule.getRawAccount>;
+    listOwned: BoundFunction<typeof accountsModule.listOwnedAccounts>;
+    create: BoundFunction<typeof accountsModule.createAccount>;
+}
+
+export interface BoundTransactions {
+    get: BoundFunction<typeof transactionsModule.getTransaction>;
+    getRaw: BoundFunction<typeof transactionsModule.getRawTransaction>;
+    getStatus: BoundFunction<typeof transactionsModule.getTransactionStatus>;
+    build: BoundFunction<typeof transactionsModule.buildTransaction>;
+    buildAndSign: BoundFunction<typeof transactionsModule.buildAndSignTransaction>;
+    send: BoundFunction<typeof transactionsModule.sendTransaction>;
+    track: BoundFunction<typeof streamingModule.trackTransaction>;
+}
+
+export interface BoundEvents {
+    get: BoundFunction<typeof eventsModule.getEvent>;
+}
+
+export interface BoundProofs {
+    generate: BoundFunction<typeof proofsModule.generateStateProof>;
+}
+
+export interface Helpers {
+    toSignature(value: Uint8Array | string): Signature;
+    toPubkey(value: Uint8Array | string, field: string): Pubkey;
+    toBlockHash(value: Uint8Array | string): BlockHash;
+    encodeSignature(bytes: Uint8Array): string;
+    decodeSignature(value: string): Uint8Array;
+    encodeAddress(bytes: Uint8Array): string;
+    decodeAddress(value: string): Uint8Array;
+    deriveProgramAddress(options: DeriveProgramAddressOptions): DeriveProgramAddressResult;
+}
+
+export interface Thru {
+    ctx: ThruClientContext;
+    blocks: BoundBlocks;
+    accounts: BoundAccounts;
+    transactions: BoundTransactions;
+    events: BoundEvents;
+    proofs: BoundProofs;
+    helpers: Helpers;
+}
+
+export function createBoundThruClient(ctx: ThruClientContext): Thru {
+    return {
+        ctx,
+        blocks: {
+            get: bind(ctx, blocksModule.getBlock),
+            getRaw: bind(ctx, blocksModule.getRawBlock),
+            list: bind(ctx, blocksModule.listBlocks),
+            getBlockHeight: bind(ctx, heightModule.getBlockHeight),
+        },
+        accounts: {
+            get: bind(ctx, accountsModule.getAccount),
+            getRaw: bind(ctx, accountsModule.getRawAccount),
+            listOwned: bind(ctx, accountsModule.listOwnedAccounts),
+            create: bind(ctx, accountsModule.createAccount),
+        },
+        transactions: {
+            get: bind(ctx, transactionsModule.getTransaction),
+            getRaw: bind(ctx, transactionsModule.getRawTransaction),
+            getStatus: bind(ctx, transactionsModule.getTransactionStatus),
+            build: bind(ctx, transactionsModule.buildTransaction),
+            buildAndSign: bind(ctx, transactionsModule.buildAndSignTransaction),
+            send: bind(ctx, transactionsModule.sendTransaction),
+            track: bind(ctx, streamingModule.trackTransaction),
+        },
+        helpers: {
+            toSignature,
+            toPubkey,
+            toBlockHash,
+            encodeSignature,
+            decodeSignature,
+            encodeAddress,
+            decodeAddress,
+            deriveProgramAddress,
+        },
+        events: {
+            get: bind(ctx, eventsModule.getEvent),
+        },
+        proofs: {
+            generate: bind(ctx, proofsModule.generateStateProof),
+        },
+    };
+}

package/thru-ts-client-sdk/core/client.ts

@@ -0,0 +1,38 @@
+import { createClient } from "@connectrpc/connect";
+import { createGrpcWebTransport } from "@connectrpc/connect-web";
+
+import { DEFAULT_HOST } from "../defaults";
+import { CommandService } from "../proto/thru/services/v1/command_service_pb";
+import { QueryService } from "../proto/thru/services/v1/query_service_pb";
+import { StreamingService } from "../proto/thru/services/v1/streaming_service_pb";
+
+export interface ThruClientConfig {
+    baseUrl?: string;
+}
+
+export type QueryClient = ReturnType<typeof createClient<typeof QueryService>>;
+export type CommandClient = ReturnType<typeof createClient<typeof CommandService>>;
+export type StreamingClient = ReturnType<typeof createClient<typeof StreamingService>>;
+
+export interface ThruClientContext {
+    baseUrl: string;
+    transport: ReturnType<typeof createGrpcWebTransport>;
+    query: QueryClient;
+    command: CommandClient;
+    streaming: StreamingClient;
+}
+
+export function createThruClientContext(config: ThruClientConfig = {}): ThruClientContext {
+    const baseUrl = config.baseUrl ?? DEFAULT_HOST;
+    const transport = createGrpcWebTransport({
+        baseUrl,
+    });
+
+    return {
+        baseUrl,
+        transport,
+        query: createClient(QueryService, transport),
+        command: createClient(CommandService, transport),
+        streaming: createClient(StreamingService, transport),
+    };
+}