@solana/client 0.0.0 → 0.1.0

package/dist/types/rpc/createSolanaRpcClient.d.ts

@@ -0,0 +1,42 @@
+import { type ClusterUrl, type Commitment, createSolanaRpc, createSolanaRpcSubscriptions, type SendableTransaction, type Signature, type Transaction } from '@solana/kit';
+import type { TransactionWithLastValidBlockHeight } from '@solana/transaction-confirmation';
+type SolanaRpcInstance = ReturnType<typeof createSolanaRpc>;
+type SolanaRpcSubscriptionsInstance = ReturnType<typeof createSolanaRpcSubscriptions>;
+type ConfirmableTransaction = SendableTransaction & Transaction & TransactionWithLastValidBlockHeight;
+type SimulateTransactionPlan = ReturnType<SolanaRpcInstance['simulateTransaction']>;
+type SimulateTransactionConfig = Parameters<SolanaRpcInstance['simulateTransaction']>[1];
+type SimulateTransactionResult = Awaited<ReturnType<SimulateTransactionPlan['send']>>;
+export type SendAndConfirmTransactionOptions = Readonly<{
+    abortSignal?: AbortSignal;
+    commitment?: Commitment;
+    maxRetries?: bigint | number;
+    minContextSlot?: bigint | number;
+    skipPreflight?: boolean;
+}>;
+export type SimulateTransactionOptions = Readonly<{
+    abortSignal?: AbortSignal;
+    commitment?: Commitment;
+    config?: SimulateTransactionConfig;
+}>;
+export type SolanaRpcClient = Readonly<{
+    commitment: Commitment;
+    endpoint: ClusterUrl;
+    rpc: SolanaRpcInstance;
+    rpcSubscriptions: SolanaRpcSubscriptionsInstance;
+    sendAndConfirmTransaction(transaction: ConfirmableTransaction, options?: SendAndConfirmTransactionOptions): Promise<Signature>;
+    simulateTransaction(transaction: SendableTransaction & Transaction, options?: SimulateTransactionOptions): Promise<SimulateTransactionResult>;
+    websocketEndpoint: ClusterUrl;
+}>;
+export type CreateSolanaRpcClientConfig = Readonly<{
+    commitment?: Commitment;
+    endpoint: ClusterUrl;
+    rpcConfig?: Parameters<typeof createSolanaRpc>[1];
+    rpcSubscriptionsConfig?: Parameters<typeof createSolanaRpcSubscriptions>[1];
+    websocketEndpoint?: ClusterUrl;
+}>;
+/**
+ * Creates a lightweight RPC client that wires up JSON-RPC, subscriptions, and common helpers.
+ */
+export declare function createSolanaRpcClient(config: CreateSolanaRpcClientConfig): SolanaRpcClient;
+export {};
+//# sourceMappingURL=createSolanaRpcClient.d.ts.map

package/dist/types/rpc/createSolanaRpcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSolanaRpcClient.d.ts","sourceRoot":"","sources":["../../../src/rpc/createSolanaRpcClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,UAAU,EACf,KAAK,UAAU,EACf,eAAe,EACf,4BAA4B,EAE5B,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AAO5F,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC5D,KAAK,8BAA8B,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEtF,KAAK,sBAAsB,GAAG,mBAAmB,GAAG,WAAW,GAAG,mCAAmC,CAAC;AAEtG,KAAK,uBAAuB,GAAG,UAAU,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC,CAAC;AACpF,KAAK,yBAAyB,GAAG,UAAU,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzF,KAAK,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEtF,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC;IACvD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,iBAAiB,CAAC;IACvB,gBAAgB,EAAE,8BAA8B,CAAC;IACjD,yBAAyB,CACxB,WAAW,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,gCAAgC,GACxC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,mBAAmB,CAClB,WAAW,EAAE,mBAAmB,GAAG,WAAW,EAC9C,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,iBAAiB,EAAE,UAAU,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,sBAAsB,CAAC,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,iBAAiB,CAAC,EAAE,UAAU,CAAC;CAC/B,CAAC,CAAC;AAgCH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,eAAe,CA6E1F"}

package/dist/types/serialization/json.d.ts

@@ -0,0 +1,31 @@
+import type { Lamports } from '@solana/kit';
+import { type BigintLike } from '../numeric/math';
+/**
+ * Serializes a bigint to its decimal string representation for JSON payloads.
+ *
+ * @param value - Bigint value to serialize.
+ * @returns Decimal string representation suitable for JSON.
+ */
+export declare function bigintToJson(value: bigint): string;
+/**
+ * Parses a bigint-compatible JSON value.
+ *
+ * @param value - JSON value that should contain an integer string or number.
+ * @returns Parsed bigint.
+ */
+export declare function bigintFromJson(value: BigintLike): bigint;
+/**
+ * Serializes lamports to a string since JSON cannot encode bigint directly.
+ *
+ * @param value - Lamport amount to serialize.
+ * @returns Decimal string representation of the lamport amount.
+ */
+export declare function lamportsToJson(value: Lamports): string;
+/**
+ * Parses a lamport value from JSON primitives.
+ *
+ * @param value - JSON value containing an integer string or number.
+ * @returns Parsed lamport amount.
+ */
+export declare function lamportsFromJson(value: BigintLike): Lamports;
+//# sourceMappingURL=json.d.ts.map

package/dist/types/serialization/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/serialization/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,KAAK,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAE5D"}

package/dist/types/signatures/status.d.ts

@@ -0,0 +1,12 @@
+import { type Commitment, type Signature } from '@solana/kit';
+export type SignatureLike = Signature | string;
+export type ConfirmationCommitment = Extract<Commitment, 'confirmed' | 'finalized' | 'processed'>;
+export type SignatureStatusLike = Readonly<{
+    confirmationStatus?: ConfirmationCommitment | null;
+    confirmations?: number | bigint | null;
+}> | null;
+export declare const SIGNATURE_STATUS_TIMEOUT_MS = 20000;
+export declare function normalizeSignature(input?: SignatureLike): Signature | undefined;
+export declare function deriveConfirmationStatus(status: SignatureStatusLike): ConfirmationCommitment | null;
+export declare function confirmationMeetsCommitment(confirmation: ConfirmationCommitment | null, target: ConfirmationCommitment): boolean;
+//# sourceMappingURL=status.d.ts.map

package/dist/types/signatures/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/signatures/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAA+B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAElG,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC,GAAG,IAAI,CAAC;AAQV,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,CAK/E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,IAAI,CAkBnG;AAED,wBAAgB,2BAA2B,CAC1C,YAAY,EAAE,sBAAsB,GAAG,IAAI,EAC3C,MAAM,EAAE,sBAAsB,GAC5B,OAAO,CAKT"}

package/dist/types/signers/walletTransactionSigner.d.ts

@@ -0,0 +1,33 @@
+import { type Commitment, type TransactionSigner } from '@solana/kit';
+import type { WalletSession } from '../types';
+type WalletTransactionSignerMode = 'partial' | 'send';
+export type WalletTransactionSigner = Readonly<{
+    mode: WalletTransactionSignerMode;
+    signer: TransactionSigner;
+}>;
+export type WalletTransactionSignerConfig = Readonly<{
+    commitment?: Commitment;
+}>;
+/** Type guard that determines whether the provided value is a {@link WalletSession}. */
+export declare function isWalletSession(value: unknown): value is WalletSession;
+/**
+ * Creates a {@link TransactionSigner} wrapper around a {@link WalletSession}.
+ *
+ * The returned signer implements the most capable interface supported by the underlying wallet:
+ * - if the wallet exposes `signTransaction`, a partial signer is returned;
+ * - otherwise, if the wallet only exposes `sendTransaction`, a sending signer is returned.
+ *
+ * @param session - Connected wallet session used to sign or send transactions.
+ * @param config - Optional configuration that propagates commitment preferences when the wallet sends transactions.
+ * @returns Object containing the wrapped {@link TransactionSigner} and the strategy it supports.
+ */
+export declare function createWalletTransactionSigner(session: WalletSession, config?: WalletTransactionSignerConfig): WalletTransactionSigner;
+/**
+ * Resolves the most capable signing strategy for a {@link TransactionSigner}.
+ *
+ * @param signer - Arbitrary transaction signer.
+ * @returns Strategy descriptor indicating whether the signer can partially sign transactions.
+ */
+export declare function resolveSignerMode(signer: TransactionSigner): WalletTransactionSignerMode;
+export {};
+//# sourceMappingURL=walletTransactionSigner.d.ts.map

package/dist/types/signers/walletTransactionSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletTransactionSigner.d.ts","sourceRoot":"","sources":["../../../src/signers/walletTransactionSigner.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,UAAU,EAWf,KAAK,iBAAiB,EAGtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,KAAK,2BAA2B,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC9C,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,iBAAiB,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACpD,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC,CAAC;AAEH,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,6BAAkC,GACxC,uBAAuB,CAuFzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,2BAA2B,CASxF"}

package/dist/types/state/asyncState.d.ts

@@ -0,0 +1,12 @@
+export type AsyncStatus = 'error' | 'idle' | 'loading' | 'success';
+export type AsyncState<T> = Readonly<{
+    data?: T;
+    error?: unknown;
+    status: AsyncStatus;
+}>;
+export declare function createInitialAsyncState<T>(): AsyncState<T>;
+export declare function createAsyncState<T>(status: AsyncStatus, payload?: Readonly<{
+    data?: T;
+    error?: unknown;
+}>): AsyncState<T>;
+//# sourceMappingURL=asyncState.d.ts.map

package/dist/types/state/asyncState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncState.d.ts","sourceRoot":"","sources":["../../../src/state/asyncState.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;CACpB,CAAC,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAM,GACnD,UAAU,CAAC,CAAC,CAAC,CAMf"}

package/dist/types/transactions/base64.d.ts

@@ -0,0 +1,12 @@
+import type { Base64EncodedWireTransaction, Transaction, TransactionMessage, TransactionMessageWithFeePayer } from '@solana/kit';
+type Base64ConvertibleTransaction = (TransactionMessage & TransactionMessageWithFeePayer) | Transaction;
+/**
+ * Serializes a transaction message or fully signed transaction to a base64-encoded wire format string.
+ */
+export declare function transactionToBase64(tx: Base64ConvertibleTransaction): Base64EncodedWireTransaction;
+/**
+ * Serializes a transaction after ensuring all attached signers have produced signatures.
+ */
+export declare function transactionToBase64WithSigners(tx: Base64ConvertibleTransaction): Promise<Base64EncodedWireTransaction>;
+export {};
+//# sourceMappingURL=base64.d.ts.map

package/dist/types/transactions/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../src/transactions/base64.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,8BAA8B,EAC9B,MAAM,aAAa,CAAC;AAOrB,KAAK,4BAA4B,GAAG,CAAC,kBAAkB,GAAG,8BAA8B,CAAC,GAAG,WAAW,CAAC;AAExG;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,4BAA4B,GAAG,4BAA4B,CAKlG;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CACnD,EAAE,EAAE,4BAA4B,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAMvC"}

package/dist/types/transactions/prepareTransaction.d.ts

@@ -0,0 +1,16 @@
+import type { GetLatestBlockhashApi, Rpc, SimulateTransactionApi, TransactionMessage, TransactionMessageWithBlockhashLifetime, TransactionMessageWithFeePayer } from '@solana/kit';
+export type PrepareTransactionMessage = TransactionMessage & TransactionMessageWithFeePayer;
+export type PrepareTransactionOptions<TMessage extends PrepareTransactionMessage> = Readonly<{
+    transaction: TMessage;
+    computeUnitLimitMultiplier?: number;
+    computeUnitLimitReset?: boolean;
+    blockhashReset?: boolean;
+    logRequest?: (payload: {
+        base64WireTransaction: string;
+    }) => void;
+}>;
+export type PrepareTransactionConfig<TMessage extends PrepareTransactionMessage> = PrepareTransactionOptions<TMessage> & Readonly<{
+    rpc: Rpc<GetLatestBlockhashApi & SimulateTransactionApi>;
+}>;
+export declare function prepareTransaction<TMessage extends PrepareTransactionMessage>(config: PrepareTransactionConfig<TMessage>): Promise<TMessage & TransactionMessageWithBlockhashLifetime>;
+//# sourceMappingURL=prepareTransaction.d.ts.map

package/dist/types/transactions/prepareTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareTransaction.d.ts","sourceRoot":"","sources":["../../../src/transactions/prepareTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,GAAG,EACH,sBAAsB,EACtB,kBAAkB,EAClB,uCAAuC,EACvC,8BAA8B,EAC9B,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,GAAG,8BAA8B,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,QAAQ,SAAS,yBAAyB,IAAI,QAAQ,CAAC;IAC5F,WAAW,EAAE,QAAQ,CAAC;IACtB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,qBAAqB,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,CAAC,QAAQ,SAAS,yBAAyB,IAAI,yBAAyB,CAAC,QAAQ,CAAC,GACrH,QAAQ,CAAC;IACR,GAAG,EAAE,GAAG,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,CAAC;CACzD,CAAC,CAAC;AAyDJ,wBAAsB,kBAAkB,CAAC,QAAQ,SAAS,yBAAyB,EAClF,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GACxC,OAAO,CAAC,QAAQ,GAAG,uCAAuC,CAAC,CAkD7D"}

package/dist/types/transactions/referenceKeys.d.ts

@@ -0,0 +1,10 @@
+import type { Address, BaseTransactionMessage } from '@solana/kit';
+/**
+ * Appends reference address metadata to the first non-memo instruction in a transaction.
+ */
+export declare function insertReferenceKey<T extends BaseTransactionMessage>(reference: Address, transaction: T): T;
+/**
+ * Appends multiple reference addresses to the first non-memo instruction in a transaction.
+ */
+export declare function insertReferenceKeys<T extends BaseTransactionMessage>(references: Address[], transaction: T): T;
+//# sourceMappingURL=referenceKeys.d.ts.map

package/dist/types/transactions/referenceKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceKeys.d.ts","sourceRoot":"","sources":["../../../src/transactions/referenceKeys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAgBnE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,sBAAsB,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAE1G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,sBAAsB,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAa9G"}

package/dist/types/transactions/transactionPoolController.d.ts

@@ -0,0 +1,53 @@
+import type { TransactionHelper, TransactionInstructionInput, TransactionPrepareAndSendRequest, TransactionPrepared, TransactionPrepareRequest, TransactionSendOptions, TransactionSignOptions } from '../features/transactions';
+import { type AsyncState } from '../state/asyncState';
+type Listener = () => void;
+export type TransactionInstructionList = readonly TransactionInstructionInput[];
+type TransactionSignature = Awaited<ReturnType<TransactionHelper['send']>>;
+export type LatestBlockhashCache = Readonly<{
+    updatedAt: number;
+    value: NonNullable<TransactionPrepareRequest['lifetime']>;
+}>;
+export type TransactionPoolConfig = Readonly<{
+    blockhashMaxAgeMs?: number;
+    helper: TransactionHelper;
+    initialInstructions?: TransactionInstructionList;
+}>;
+export type TransactionPoolPrepareOptions = Readonly<Partial<Omit<TransactionPrepareRequest, 'instructions'>> & {
+    instructions?: TransactionInstructionList;
+}>;
+export type TransactionPoolSignOptions = Readonly<TransactionSignOptions & {
+    prepared?: TransactionPrepared;
+}>;
+export type TransactionPoolSendOptions = Readonly<TransactionSendOptions & {
+    prepared?: TransactionPrepared;
+}>;
+export type TransactionPoolPrepareAndSendOptions = Readonly<Omit<TransactionPrepareAndSendRequest, 'instructions'> & {
+    instructions?: TransactionInstructionList;
+}>;
+export type TransactionPoolController = Readonly<{
+    addInstruction(instruction: TransactionInstructionInput): void;
+    addInstructions(instructionSet: TransactionInstructionList): void;
+    clearInstructions(): void;
+    getInstructions(): TransactionInstructionList;
+    getPrepareState(): AsyncState<TransactionPrepared>;
+    getPrepared(): TransactionPrepared | null;
+    getSendState(): AsyncState<TransactionSignature>;
+    getLatestBlockhashCache(): LatestBlockhashCache | undefined;
+    prepare(options?: TransactionPoolPrepareOptions): Promise<TransactionPrepared>;
+    prepareAndSend(request?: TransactionPoolPrepareAndSendOptions, sendOptions?: TransactionSendOptions): Promise<TransactionSignature>;
+    removeInstruction(index: number): void;
+    replaceInstructions(instructionSet: TransactionInstructionList): void;
+    reset(): void;
+    send(options?: TransactionPoolSendOptions): Promise<TransactionSignature>;
+    setLatestBlockhashCache(cache: LatestBlockhashCache | undefined): void;
+    sign(options?: TransactionPoolSignOptions): ReturnType<TransactionHelper['sign']>;
+    subscribeInstructions(listener: Listener): () => void;
+    subscribePrepareState(listener: Listener): () => void;
+    subscribePrepared(listener: Listener): () => void;
+    subscribeSendState(listener: Listener): () => void;
+    toWire(options?: TransactionPoolSignOptions): ReturnType<TransactionHelper['toWire']>;
+    get helper(): TransactionHelper;
+}>;
+export declare function createTransactionPoolController(config: TransactionPoolConfig): TransactionPoolController;
+export {};
+//# sourceMappingURL=transactionPoolController.d.ts.map

package/dist/types/transactions/transactionPoolController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionPoolController.d.ts","sourceRoot":"","sources":["../../../src/transactions/transactionPoolController.ts"],"names":[],"mappings":"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"}

package/dist/types/types.d.ts

@@ -0,0 +1,205 @@
+import type { Address, ClusterUrl, Commitment, Lamports, SendableTransaction, Signature, Transaction, TransactionMessageWithBlockhashLifetime } from '@solana/kit';
+import type { TransactionWithLastValidBlockHeight } from '@solana/transaction-confirmation';
+import type { StoreApi } from 'zustand/vanilla';
+import type { SolTransferHelper } from './features/sol';
+import type { SplTokenHelper, SplTokenHelperConfig } from './features/spl';
+import type { TransactionHelper } from './features/transactions';
+import type { SolanaRpcClient } from './rpc/createSolanaRpcClient';
+import type { PrepareTransactionMessage, PrepareTransactionOptions } from './transactions/prepareTransaction';
+type SolanaRpcInstance = ReturnType<typeof import('@solana/kit')['createSolanaRpc']>;
+type SolanaSubscriptionsInstance = ReturnType<typeof import('@solana/kit')['createSolanaRpcSubscriptions']>;
+export type LogLevel = 'debug' | 'error' | 'info' | 'warn';
+export type ClientLogger = (event: {
+    data?: Record<string, unknown>;
+    level: LogLevel;
+    message: string;
+}) => void;
+export type WalletConnectorMetadata = Readonly<{
+    canAutoConnect?: boolean;
+    icon?: string;
+    id: string;
+    name: string;
+}>;
+export type WalletAccount = Readonly<{
+    address: Address;
+    label?: string;
+    publicKey: Uint8Array;
+}>;
+export type WalletSession = Readonly<{
+    account: WalletAccount;
+    connector: WalletConnectorMetadata;
+    disconnect(): Promise<void>;
+    sendTransaction?(transaction: SendableTransaction & Transaction, config?: Readonly<{
+        commitment?: Commitment;
+    }>): Promise<Signature>;
+    signMessage?(message: Uint8Array): Promise<Uint8Array>;
+    signTransaction?(transaction: SendableTransaction & Transaction): Promise<SendableTransaction & Transaction>;
+}>;
+export type WalletConnector = WalletConnectorMetadata & {
+    connect(opts?: Readonly<{
+        autoConnect?: boolean;
+    }>): Promise<WalletSession>;
+    disconnect(): Promise<void>;
+    isSupported(): boolean;
+};
+type WalletStatusConnected = Readonly<{
+    connectorId: string;
+    session: WalletSession;
+    status: 'connected';
+}>;
+type WalletStatusConnecting = Readonly<{
+    connectorId: string;
+    status: 'connecting';
+}>;
+type WalletStatusDisconnected = Readonly<{
+    status: 'disconnected';
+}>;
+type WalletStatusError = Readonly<{
+    connectorId?: string;
+    error: unknown;
+    status: 'error';
+}>;
+export type WalletStatus = WalletStatusConnected | WalletStatusConnecting | WalletStatusDisconnected | WalletStatusError;
+type ClusterStatusConnecting = Readonly<{
+    status: 'connecting';
+}>;
+type ClusterStatusError = Readonly<{
+    error: unknown;
+    status: 'error';
+}>;
+type ClusterStatusIdle = Readonly<{
+    status: 'idle';
+}>;
+type ClusterStatusReady = Readonly<{
+    latencyMs?: number;
+    status: 'ready';
+}>;
+export type ClusterStatus = ClusterStatusConnecting | ClusterStatusError | ClusterStatusIdle | ClusterStatusReady;
+export type ClusterState = Readonly<{
+    commitment: Commitment;
+    endpoint: ClusterUrl;
+    status: ClusterStatus;
+    websocketEndpoint?: ClusterUrl;
+}>;
+export type AccountCacheEntry = Readonly<{
+    address: Address;
+    data?: unknown;
+    error?: unknown;
+    fetching: boolean;
+    lamports: Lamports | null;
+    lastFetchedAt?: number;
+    slot: bigint | null;
+}>;
+export type AccountCache = Record<string, AccountCacheEntry>;
+export type TransactionRecord = Readonly<{
+    error?: unknown;
+    lastUpdatedAt: number;
+    signature?: Signature;
+    status: 'confirmed' | 'failed' | 'idle' | 'sending' | 'waiting';
+}>;
+export type TransactionState = Record<string, TransactionRecord>;
+type SubscriptionStatusActivating = Readonly<{
+    status: 'activating';
+}>;
+type SubscriptionStatusActive = Readonly<{
+    status: 'active';
+}>;
+type SubscriptionStatusError = Readonly<{
+    error: unknown;
+    status: 'error';
+}>;
+type SubscriptionStatusInactive = Readonly<{
+    status: 'inactive';
+}>;
+export type SubscriptionStatus = SubscriptionStatusActivating | SubscriptionStatusActive | SubscriptionStatusError | SubscriptionStatusInactive;
+export type SubscriptionState = Readonly<{
+    account: Record<string, SubscriptionStatus>;
+    signature: Record<string, SubscriptionStatus>;
+}>;
+export type ClientState = Readonly<{
+    accounts: AccountCache;
+    cluster: ClusterState;
+    lastUpdatedAt: number;
+    subscriptions: SubscriptionState;
+    transactions: TransactionState;
+    wallet: WalletStatus;
+}>;
+export type ClientStore = StoreApi<ClientState>;
+export type CreateStoreFn = (state: ClientState) => ClientStore;
+export type SolanaClientConfig = Readonly<{
+    commitment?: Commitment;
+    createStore?: CreateStoreFn;
+    endpoint: ClusterUrl;
+    logger?: ClientLogger;
+    rpcClient?: SolanaRpcClient;
+    walletConnectors?: readonly WalletConnector[];
+    websocketEndpoint?: ClusterUrl;
+}>;
+export type SolanaClientRuntime = {
+    rpc: SolanaRpcInstance;
+    rpcSubscriptions: SolanaSubscriptionsInstance;
+};
+export type BalanceWatcherConfig = Readonly<{
+    address: Address;
+    commitment?: Commitment;
+}>;
+export type AccountWatcherConfig = Readonly<{
+    address: Address;
+    commitment?: Commitment;
+}>;
+export type SignatureWatcherConfig = Readonly<{
+    commitment?: Commitment;
+    enableReceivedNotification?: boolean;
+    signature: Signature;
+}>;
+export type WatchSubscription = Readonly<{
+    abort(): void;
+}>;
+export type ClientActions = Readonly<{
+    connectWallet(connectorId: string, options?: Readonly<{
+        autoConnect?: boolean;
+    }>): Promise<void>;
+    disconnectWallet(): Promise<void>;
+    fetchAccount(address: Address, commitment?: Commitment): Promise<AccountCacheEntry>;
+    fetchBalance(address: Address, commitment?: Commitment): Promise<Lamports>;
+    requestAirdrop(address: Address, lamports: Lamports): Promise<Signature>;
+    sendTransaction(transaction: SendableTransaction & Transaction & TransactionWithLastValidBlockHeight, commitment?: Commitment): Promise<Signature>;
+    setCluster(endpoint: ClusterUrl, config?: Readonly<{
+        commitment?: Commitment;
+        websocketEndpoint?: ClusterUrl;
+    }>): Promise<void>;
+}>;
+export type ClientWatchers = Readonly<{
+    watchAccount(config: AccountWatcherConfig, listener: (account: AccountCacheEntry) => void): WatchSubscription;
+    watchBalance(config: BalanceWatcherConfig, listener: (lamports: Lamports) => void): WatchSubscription;
+    watchSignature(config: SignatureWatcherConfig, listener: (notification: unknown) => void): WatchSubscription;
+}>;
+export type ClientHelpers = Readonly<{
+    solTransfer: SolTransferHelper;
+    splToken(config: SplTokenHelperConfig): SplTokenHelper;
+    transaction: TransactionHelper;
+    prepareTransaction<TMessage extends PrepareTransactionMessage>(config: PrepareTransactionOptions<TMessage>): Promise<TMessage & TransactionMessageWithBlockhashLifetime>;
+}>;
+export type WalletRegistry = Readonly<{
+    all: readonly WalletConnector[];
+    get(id: string): WalletConnector | undefined;
+}>;
+export type SolanaClient = Readonly<{
+    actions: ClientActions;
+    config: SolanaClientConfig;
+    connectors: WalletRegistry;
+    destroy(): void;
+    runtime: Readonly<SolanaClientRuntime>;
+    store: ClientStore;
+    watchers: ClientWatchers;
+    helpers: ClientHelpers;
+    solTransfer: SolTransferHelper;
+    SolTransfer: SolTransferHelper;
+    splToken(config: SplTokenHelperConfig): SplTokenHelper;
+    SplToken(config: SplTokenHelperConfig): SplTokenHelper;
+    SplHelper(config: SplTokenHelperConfig): SplTokenHelper;
+    transaction: TransactionHelper;
+    prepareTransaction: ClientHelpers['prepareTransaction'];
+}>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/addressLike.d.ts

@@ -0,0 +1,5 @@
+import { type Address } from '@solana/kit';
+export type AddressLike = Address | string;
+export declare function toAddress(addressLike: AddressLike): Address;
+export declare function toAddressString(addressLike: AddressLike): string;
+//# sourceMappingURL=addressLike.d.ts.map

package/dist/types/utils/addressLike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressLike.d.ts","sourceRoot":"","sources":["../../../src/utils/addressLike.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA2B,MAAM,aAAa,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAE3D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEhE"}

package/dist/types/utils/stableStringify.d.ts

@@ -0,0 +1,2 @@
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=stableStringify.d.ts.map

package/dist/types/utils/stableStringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableStringify.d.ts","sourceRoot":"","sources":["../../../src/utils/stableStringify.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWtD"}

package/dist/types/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Recursively freezes a value to avoid accidental mutation of initial state snapshots.
+ *
+ * @param value - Value to freeze in place.
+ * @returns The same value with all nested objects frozen.
+ */
+export declare function deepFreeze<T>(value: T): T;
+/**
+ * Returns the current timestamp in milliseconds.
+ *
+ * @returns Millisecond timestamp provided by {@link Date.now}.
+ */
+export declare function now(): number;
+/**
+ * Converts optional errors to a serializable string for logging.
+ *
+ * @param error - Arbitrary error value to format.
+ * @returns String representation of the provided error.
+ */
+export declare function toErrorMessage(error: unknown): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAUzC;AAED;;;;GAIG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYrD"}

package/dist/types/wallet/registry.d.ts

@@ -0,0 +1,9 @@
+import type { WalletConnector, WalletRegistry } from '../types';
+/**
+ * Creates an in-memory wallet registry from the provided connectors.
+ *
+ * @param connectors - Wallet connector implementations to register.
+ * @returns A registry exposing iteration and lookup helpers.
+ */
+export declare function createWalletRegistry(connectors: readonly WalletConnector[]): WalletRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/wallet/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/wallet/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,GAAG,cAAc,CAmB3F"}

package/dist/types/wallet/standard.d.ts

@@ -0,0 +1,36 @@
+import type { IdentifierString, Wallet } from '@wallet-standard/base';
+import type { WalletConnector } from '../types';
+export type WalletStandardConnectorMetadata = Readonly<{
+    canAutoConnect?: boolean;
+    defaultChain?: IdentifierString;
+    icon?: string;
+    id?: string;
+    name?: string;
+}>;
+/**
+ * Builds a connector function that adheres to the wallet standard API.
+ *
+ * @param wallet - Wallet instance compatible with Wallet Standard.
+ * @param options - Optional overrides for connector metadata.
+ * @returns A {@link WalletConnector} wrapping the provided wallet.
+ */
+export declare function createWalletStandardConnector(wallet: Wallet, options?: WalletStandardConnectorMetadata): WalletConnector;
+export type WalletStandardDiscoveryOptions = Readonly<{
+    overrides?: (wallet: Wallet) => WalletStandardConnectorMetadata | undefined;
+}>;
+/**
+ * Returns connectors for all wallets currently registered with Wallet Standard.
+ *
+ * @param options - Optional discovery configuration.
+ * @returns A deduplicated list of wallet connectors.
+ */
+export declare function getWalletStandardConnectors(options?: WalletStandardDiscoveryOptions): readonly WalletConnector[];
+/**
+ * Watches Wallet Standard registrations and emits new connector lists whenever the set changes.
+ *
+ * @param onChange - Callback invoked each time the connector set changes.
+ * @param options - Optional discovery configuration overrides.
+ * @returns Cleanup function that removes all listeners.
+ */
+export declare function watchWalletStandardConnectors(onChange: (connectors: readonly WalletConnector[]) => void, options?: WalletStandardDiscoveryOptions): () => void;
+//# sourceMappingURL=standard.d.ts.map

package/dist/types/wallet/standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../../../src/wallet/standard.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAA0C,MAAM,uBAAuB,CAAC;AAI9G,OAAO,KAAK,EAAiB,eAAe,EAA0C,MAAM,UAAU,CAAC;AAEvG,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAqFH;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,+BAAoC,GAC3C,eAAe,CA0JjB;AAgBD,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACrD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,+BAA+B,GAAG,SAAS,CAAC;CAC5E,CAAC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,8BAAmC,GAAG,SAAS,eAAe,EAAE,CAapH;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,EAC1D,OAAO,GAAE,8BAAmC,GAC1C,MAAM,IAAI,CAwBZ"}