@thru/thru-sdk 0.1.16 → 0.1.20

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

@@ -1,38 +0,0 @@
-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;
-}
-
-type QueryClient = ReturnType<typeof createClient<typeof QueryService>>;
-type CommandClient = ReturnType<typeof createClient<typeof CommandService>>;
-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),
-    };
-}

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

@@ -1,17 +0,0 @@
-import { ConsensusStatus } from "./proto/thru/common/v1/consensus_pb";
-import { AccountView } from "./proto/thru/core/v1/account_pb";
-import { BlockView } from "./proto/thru/core/v1/block_pb";
-import { TransactionView } from "./proto/thru/core/v1/transaction_pb";
-
-export const DEFAULT_HOST = "https://grpc-web.alphanet.thruput.org";
-
-export const DEFAULT_ACCOUNT_VIEW = AccountView.FULL;
-export const DEFAULT_BLOCK_VIEW = BlockView.FULL;
-export const DEFAULT_TRANSACTION_VIEW = TransactionView.FULL;
-export const DEFAULT_MIN_CONSENSUS = ConsensusStatus.UNSPECIFIED;
-
-export const DEFAULT_FEE = 1n;
-export const DEFAULT_COMPUTE_UNITS = 300_000_000;
-export const DEFAULT_STATE_UNITS = 10_000;
-export const DEFAULT_MEMORY_UNITS = 10_000;
-export const DEFAULT_EXPIRY_AFTER = 100;

package/thru-ts-client-sdk/modules/accounts.ts

@@ -1,145 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import { BytesLike } from "@thru/helpers";
-import type { ThruClientContext } from "../core/client";
-import { DEFAULT_ACCOUNT_VIEW, DEFAULT_MIN_CONSENSUS } from "../defaults";
-import { ConsensusStatus, VersionContext } from "../proto/thru/common/v1/consensus_pb";
-import type { Filter } from "../proto/thru/common/v1/filters_pb";
-import type { PageRequest } from "../proto/thru/common/v1/pagination_pb";
-import { Account, AccountView, DataSlice, RawAccount } from "../proto/thru/core/v1/account_pb";
-import { StateProofType } from "../proto/thru/core/v1/state_pb";
-import {
-    GetAccountRequestSchema,
-    GetRawAccountRequestSchema,
-    ListOwnedAccountsRequestSchema,
-    ListOwnedAccountsResponse,
-} from "../proto/thru/services/v1/query_service_pb";
-import type { Transaction } from "../transactions/Transaction";
-import { TransactionBuilder } from "../transactions/TransactionBuilder";
-import type { TransactionHeaderInput } from "../transactions/types";
-import { mergeTransactionHeader } from "../utils/utils";
-import { getBlockHeight } from "./height";
-import { toPubkey } from "./helpers";
-import { generateStateProof } from "./proofs";
-
-export interface CreateAccountOptions {
-    /** The new account's public key (fee payer). */
-    publicKey: BytesLike;
-    /** Optional overrides for the transaction header. */
-    header?: Partial<TransactionHeaderInput>;
-}
-
-
-export interface AccountQueryOptions {
-    view?: AccountView;
-    versionContext?: VersionContext;
-    minConsensus?: ConsensusStatus;
-    dataSlice?: DataSlice;
-}
-
-export interface RawAccountQueryOptions {
-    view?: AccountView;
-    versionContext?: VersionContext;
-    minConsensus?: ConsensusStatus;
-}
-
-export interface ListOwnedAccountsOptions {
-    view?: AccountView;
-    versionContext?: VersionContext;
-    filter?: Filter;
-    page?: PageRequest;
-    minConsensus?: ConsensusStatus;
-}
-
-export function getAccount(
-    ctx: ThruClientContext,
-    address: BytesLike,
-    options: AccountQueryOptions = {},
-): Promise<Account> {
-    const request = create(GetAccountRequestSchema, {
-        address: toPubkey(address, "address"),
-        view: options.view ?? DEFAULT_ACCOUNT_VIEW,
-        versionContext: options.versionContext,
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-        dataSlice: options.dataSlice,
-    });
-    return ctx.query.getAccount(request);
-}
-
-export function getRawAccount(
-    ctx: ThruClientContext,
-    address: BytesLike,
-    options: RawAccountQueryOptions = {},
-): Promise<RawAccount> {
-    const request = create(GetRawAccountRequestSchema, {
-        address: toPubkey(address, "address"),
-        view: options.view ?? DEFAULT_ACCOUNT_VIEW,
-        versionContext: options.versionContext,
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-    });
-    return ctx.query.getRawAccount(request);
-}
-
-export function listOwnedAccounts(
-    ctx: ThruClientContext,
-    owner: BytesLike,
-    options: ListOwnedAccountsOptions = {},
-): Promise<ListOwnedAccountsResponse> {
-    const request = create(ListOwnedAccountsRequestSchema, {
-        owner: toPubkey(owner, "owner"),
-        view: options.view ?? DEFAULT_ACCOUNT_VIEW,
-        versionContext: options.versionContext,
-        filter: options.filter,
-        page: options.page,
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-    });
-    return ctx.query.listOwnedAccounts(request);
-}
-
-export async function createAccount(
-    ctx: ThruClientContext,
-    options: CreateAccountOptions,
-): Promise<Transaction> {
-    const feePayer = toPubkey(options.publicKey, "publicKey").value;
-
-    const height = await getBlockHeight(ctx);
-    const startSlot = height.finalized;
-
-    const proofResponse = await generateStateProof(ctx, {
-        address: options.publicKey,
-        proofType: StateProofType.CREATING,
-        targetSlot: startSlot,
-    });
-
-    const proofBytes = proofResponse.proof?.proof;
-    if (!proofBytes || proofBytes.length === 0) {
-        throw new Error("State proof generation returned empty proof");
-    }
-
-    const program = new Uint8Array(32);
-    program[31] = 0x02;
-
-    const builder = new TransactionBuilder();
-    const headerDefaults: TransactionHeaderInput = {
-        fee: 0n,
-        nonce: 0n,
-        startSlot,
-        expiryAfter: 100,
-        computeUnits: 10_000,
-        memoryUnits: 10_000,
-        stateUnits: 10_000,
-    };
-
-    const header = mergeTransactionHeader(headerDefaults, options.header);
-
-    const transaction = builder.build({
-        feePayer: { publicKey: feePayer },
-        program,
-        header,
-        content: {
-            proofs: { feePayerStateProof: proofBytes }
-        }
-    });
-
-    return transaction;
-}

package/thru-ts-client-sdk/modules/blocks.ts

@@ -1,75 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import type { ThruClientContext } from "../core/client";
-import { DEFAULT_BLOCK_VIEW, DEFAULT_MIN_CONSENSUS } from "../defaults";
-import { ConsensusStatus } from "../proto/thru/common/v1/consensus_pb";
-import type { Filter } from "../proto/thru/common/v1/filters_pb";
-import type { PageRequest } from "../proto/thru/common/v1/pagination_pb";
-import { Block, BlockView, RawBlock } from "../proto/thru/core/v1/block_pb";
-import {
-    GetBlockRequestSchema,
-    GetRawBlockRequestSchema,
-    ListBlocksRequestSchema,
-    ListBlocksResponse,
-} from "../proto/thru/services/v1/query_service_pb";
-import { isSlotSelector } from "../utils/utils";
-import type { BlockSelector } from "./helpers";
-import { toBlockHash } from "./helpers";
-
-export interface BlockQueryOptions {
-    view?: BlockView;
-    minConsensus?: ConsensusStatus;
-}
-
-export interface RawBlockQueryOptions {
-    minConsensus?: ConsensusStatus;
-}
-
-export interface ListBlocksOptions {
-    filter?: Filter;
-    page?: PageRequest;
-    view?: BlockView;
-    minConsensus?: ConsensusStatus;
-}
-
-export function getBlock(
-    ctx: ThruClientContext,
-    selector: BlockSelector,
-    options: BlockQueryOptions = {},
-): Promise<Block> {
-    const request = create(GetBlockRequestSchema, {
-        selector: isSlotSelector(selector)
-            ? { case: "slot", value: typeof selector.slot === "bigint" ? selector.slot : BigInt(selector.slot) }
-            : { case: "blockHash", value: toBlockHash(selector.blockHash) },
-        view: options.view ?? DEFAULT_BLOCK_VIEW,
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-    });
-    return ctx.query.getBlock(request);
-}
-
-export function getRawBlock(
-    ctx: ThruClientContext,
-    selector: BlockSelector,
-    options: RawBlockQueryOptions = {},
-): Promise<RawBlock> {
-    const request = create(GetRawBlockRequestSchema, {
-        selector: isSlotSelector(selector)
-            ? { case: "slot", value: typeof selector.slot === "bigint" ? selector.slot : BigInt(selector.slot) }
-            : { case: "blockHash", value: toBlockHash(selector.blockHash) },
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-    });
-    return ctx.query.getRawBlock(request);
-}
-
-export function listBlocks(
-    ctx: ThruClientContext,
-    options: ListBlocksOptions = {},
-): Promise<ListBlocksResponse> {
-    const request = create(ListBlocksRequestSchema, {
-        filter: options.filter,
-        page: options.page,
-        view: options.view ?? DEFAULT_BLOCK_VIEW,
-        minConsensus: options.minConsensus ?? DEFAULT_MIN_CONSENSUS,
-    });
-    return ctx.query.listBlocks(request);
-}

package/thru-ts-client-sdk/modules/events.ts

@@ -1,20 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import type { ThruClientContext } from "../core/client";
-import type { VersionContext } from "../proto/thru/common/v1/consensus_pb";
-import { Event, GetEventRequestSchema } from "../proto/thru/services/v1/query_service_pb";
-
-export interface GetEventOptions {
-    versionContext?: VersionContext;
-}
-
-export function getEvent(ctx: ThruClientContext, eventId: string, options: GetEventOptions = {}): Promise<Event> {
-    if (!eventId) {
-        throw new Error("eventId is required");
-    }
-    const request = create(GetEventRequestSchema, {
-        eventId,
-        versionContext: options.versionContext,
-    });
-    return ctx.query.getEvent(request);
-}

package/thru-ts-client-sdk/modules/height.ts

@@ -1,9 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import type { ThruClientContext } from "../core/client";
-import { GetHeightRequestSchema, GetHeightResponse } from "../proto/thru/services/v1/query_service_pb";
-
-export function getBlockHeight(ctx: ThruClientContext): Promise<GetHeightResponse> {
-    const request = create(GetHeightRequestSchema);
-    return ctx.query.getHeight(request);
-}

package/thru-ts-client-sdk/modules/helpers.ts

@@ -1,131 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-import { sha256 } from "@noble/hashes/sha2";
-import { BytesLike, decodeAddress, decodeBase64, decodeSignature, encodeAddress, ensureBytes, hexToBytes, isHexString } from "@thru/helpers";
-
-import { BlockHash, BlockHashSchema, Pubkey, PubkeySchema, Signature, SignatureSchema } from "../proto/thru/core/v1/types_pb";
-
-export type BlockSelector = { slot: number | bigint } | { blockHash: BytesLike };
-
-export function toSignature(value: BytesLike): Signature {
-    let bytes: Uint8Array;
-    if (value instanceof Uint8Array) {
-        if (value.length !== 64) {
-            throw new Error("signature must contain 64 bytes");
-        }
-        bytes = value;
-    } else if (typeof value === "string") {
-        bytes = value.startsWith("ts") ? decodeSignature(value) : decodeBase64(value);
-    } else {
-        throw new Error("signature is required");
-    }
-    if (bytes.length !== 64) {
-        throw new Error("signature must contain 64 bytes");
-    }
-    return create(SignatureSchema, { value: bytes });
-}
-
-export function toPubkey(value: BytesLike, field: string): Pubkey {
-    let bytes: Uint8Array;
-    if (value instanceof Uint8Array) {
-        bytes = value;
-    } else if (typeof value === "string") {
-        bytes = value.startsWith("ta") ? decodeAddress(value) : decodeBase64(value);
-    } else {
-        throw new Error(`${field} is required`);
-    }
-    if (bytes.length !== 32) {
-        throw new Error(`${field} must contain 32 bytes`);
-    }
-    return create(PubkeySchema, { value: bytes });
-}
-
-export function toBlockHash(value: BytesLike): BlockHash {
-    return create(BlockHashSchema, { value: ensureBytes(value, "blockHash") });
-}
-
-export interface DeriveProgramAddressOptions {
-    programAddress: BytesLike;
-    seed: BytesLike;
-    ephemeral?: boolean;
-}
-
-export interface DeriveProgramAddressResult {
-    bytes: Uint8Array;
-    address: string;
-}
-
-export function deriveProgramAddress(options: DeriveProgramAddressOptions): DeriveProgramAddressResult {
-    const programAddress = normalizeProgramAddress(options.programAddress);
-    const seed = normalizeSeed(options.seed);
-    const ephemeral = options.ephemeral === true;
-
-    const derivationInput = new Uint8Array(programAddress.length + 1 + seed.length);
-    derivationInput.set(programAddress, 0);
-    derivationInput[programAddress.length] = ephemeral ? 1 : 0;
-    derivationInput.set(seed, programAddress.length + 1);
-
-    const hash = sha256(derivationInput);
-    const derivedBytes = new Uint8Array(hash.slice(0, 32));
-
-    return {
-        bytes: derivedBytes,
-        address: encodeAddress(derivedBytes),
-    };
-}
-
-function normalizeProgramAddress(value: BytesLike): Uint8Array {
-    if (value instanceof Uint8Array) {
-        if (value.length !== 32) {
-            throw new Error("Program address must contain 32 bytes");
-        }
-        return new Uint8Array(value);
-    }
-    if (typeof value === "string") {
-        if (value.startsWith("ta") && value.length === 46) {
-            return decodeAddress(value);
-        }
-        if (isHexString(value)) {
-            const bytes = hexToBytes(value);
-            if (bytes.length !== 32) {
-                throw new Error("Program address hex string must decode to 32 bytes");
-            }
-            return bytes;
-        }
-    }
-    throw new Error("Program address must be a 32-byte value, ta-address, or 64-character hex string");
-}
-
-function normalizeSeed(value: BytesLike | string): Uint8Array {
-    if (value instanceof Uint8Array) {
-        if (value.length === 0) {
-            throw new Error("Seed cannot be empty");
-        }
-        if (value.length > 32) {
-            throw new Error("Seed cannot exceed 32 bytes");
-        }
-        const seed = new Uint8Array(32);
-        seed.set(value);
-        return seed;
-    }
-    if (typeof value === "string") {
-        if (value.length === 0) {
-            throw new Error("Seed cannot be empty");
-        }
-        if (isHexString(value)) {
-            const bytes = hexToBytes(value);
-            if (bytes.length !== 32) {
-                throw new Error(`Hex seed must decode to 32 bytes, got ${bytes.length}`);
-            }
-            return bytes;
-        }
-        const encoder = new TextEncoder();
-        const utf8 = encoder.encode(value);
-        if (utf8.length > 32) {
-            throw new Error(`UTF-8 seed too long: ${utf8.length} bytes (max 32)`);
-        }
-        const seed = new Uint8Array(32);
-        seed.set(utf8);
-        return seed;
-    }
-    throw new Error("Seed must be provided as Uint8Array or string");
-}

package/thru-ts-client-sdk/modules/keys.ts

@@ -1,29 +0,0 @@
-import { getWebCrypto, ThruHDWallet } from "@thru/crypto";
-
-export interface GeneratedKeyPair {
-    address: string;
-    publicKey: Uint8Array;
-    privateKey: Uint8Array;
-}
-
-/**
- * Generates a new Ed25519 keypair using the same HD wallet pipeline as the Thru wallet.
- */
-export async function generateKeyPair(): Promise<GeneratedKeyPair> {
-    const seed = generateSeed();
-    const account = await ThruHDWallet.getAccount(seed, 0);
-    seed.fill(0);
-
-    return {
-        address: account.address,
-        publicKey: account.publicKey,
-        privateKey: account.privateKey,
-    };
-}
-
-function generateSeed(): Uint8Array {
-    const cryptoObj = getWebCrypto();
-    const bytes = new Uint8Array(64);
-    cryptoObj.getRandomValues(bytes);
-    return bytes;
-}

package/thru-ts-client-sdk/modules/proofs.ts

@@ -1,20 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import type { ThruClientContext } from "../core/client";
-import { StateProofRequestSchema } from "../proto/thru/core/v1/state_pb";
-import { GenerateStateProofRequestSchema, GenerateStateProofResponse } from "../proto/thru/services/v1/query_service_pb";
-import { GenerateStateProofOptions } from "../types/types";
-import { toPubkey } from "./helpers";
-
-export function generateStateProof(
-    ctx: ThruClientContext,
-    options: GenerateStateProofOptions,
-): Promise<GenerateStateProofResponse> {
-    const request = create(StateProofRequestSchema, {
-        address: options.address ? toPubkey(options.address, "address") : undefined,
-        proofType: options.proofType,
-        targetSlot: options.targetSlot,
-    });
-    const schemaRequest = create(GenerateStateProofRequestSchema, { request });
-    return ctx.query.generateStateProof(schemaRequest);
-}

package/thru-ts-client-sdk/modules/streaming.ts

@@ -1,34 +0,0 @@
-import { create } from "@bufbuild/protobuf";
-
-import { BytesLike } from "@thru/helpers";
-import type { ThruClientContext } from "../core/client";
-import type { TrackTransactionResponse } from "../proto/thru/services/v1/streaming_service_pb";
-import { TrackTransactionRequestSchema } from "../proto/thru/services/v1/streaming_service_pb";
-import { toSignature as toSignatureMessage } from "./helpers";
-
-export interface TrackTransactionOptions {
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-
-export function trackTransaction(
-    ctx: ThruClientContext,
-    signature: BytesLike,
-    options: TrackTransactionOptions = {},
-): AsyncIterable<TrackTransactionResponse> {
-    const timeoutMs = options.timeoutMs;
-    const request = create(TrackTransactionRequestSchema, {
-        signature: toSignatureMessage(signature),
-        timeout:
-            timeoutMs != null
-                ? {
-                    seconds: BigInt(Math.floor(timeoutMs / 1000)),
-                    nanos: (timeoutMs % 1000) * 1_000_000,
-                }
-                : undefined,
-    });
-
-    return ctx.streaming.trackTransaction(request, {
-        signal: options.signal,
-    });
-}