@solana/client 0.0.0 → 0.1.0

package/dist/types/client/createClient.d.ts

@@ -0,0 +1,9 @@
+import type { SolanaClient, SolanaClientConfig } from '../types';
+/**
+ * Creates a Solana client instance using the provided configuration.
+ *
+ * @param config - High-level configuration supplied by integrators.
+ * @returns Fully initialized {@link SolanaClient} instance.
+ */
+export declare function createClient(config: SolanaClientConfig): SolanaClient;
+//# sourceMappingURL=createClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createClient.d.ts","sourceRoot":"","sources":["../../../src/client/createClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,YAAY,EAAE,kBAAkB,EAAuB,MAAM,UAAU,CAAC;AAQnG;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAyErE"}

package/dist/types/client/createClientHelpers.d.ts

@@ -0,0 +1,3 @@
+import type { ClientHelpers, ClientStore, SolanaClientRuntime } from '../types';
+export declare function createClientHelpers(runtime: SolanaClientRuntime, store: ClientStore): ClientHelpers;
+//# sourceMappingURL=createClientHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createClientHelpers.d.ts","sourceRoot":"","sources":["../../../src/client/createClientHelpers.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAsEhF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,WAAW,GAAG,aAAa,CAqDnG"}

package/dist/types/client/createClientStore.d.ts

@@ -0,0 +1,29 @@
+import type { Commitment } from '@solana/kit';
+import type { ClientState, ClientStore, ClusterState } from '../types';
+export type ClientStoreConfig = Readonly<{
+    commitment: Commitment;
+    endpoint: ClusterState['endpoint'];
+    websocketEndpoint?: ClusterState['websocketEndpoint'];
+}>;
+/**
+ * Creates the initial {@link ClientState} using the supplied cluster configuration.
+ *
+ * @param config - Initial cluster configuration including endpoints and commitment.
+ * @returns Deep-frozen client state snapshot.
+ */
+export declare function createInitialClientState(config: ClientStoreConfig): ClientState;
+/**
+ * Creates a Zustand store using the supplied initial state snapshot.
+ *
+ * @param initialState - State snapshot produced by {@link createInitialClientState}.
+ * @returns Zustand store instance containing the provided state.
+ */
+export declare function createClientStore(initialState: ClientState): ClientStore;
+/**
+ * Convenience helper that creates both the initial state and the store in one step.
+ *
+ * @param config - Initial cluster configuration including endpoints and commitment.
+ * @returns Zustand store instance preloaded with the initial state.
+ */
+export declare function createDefaultClientStore(config: ClientStoreConfig): ClientStore;
+//# sourceMappingURL=createClientStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createClientStore.d.ts","sourceRoot":"","sources":["../../../src/client/createClientStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAiB,MAAM,UAAU,CAAC;AAGtF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,iBAAiB,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;CACtD,CAAC,CAAC;AAWH;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAmB/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAE/E"}

package/dist/types/client/watchers.d.ts

@@ -0,0 +1,16 @@
+import { createLogger } from '../logging/logger';
+import type { ClientStore, ClientWatchers, SolanaClientRuntime } from '../types';
+type WatcherDeps = Readonly<{
+    logger?: ReturnType<typeof createLogger>;
+    runtime: SolanaClientRuntime;
+    store: ClientStore;
+}>;
+/**
+ * Creates watcher helpers that wrap RPC subscriptions and keep store metadata in sync.
+ *
+ * @param deps - Dependencies required to construct watcher helpers.
+ * @returns Collection of watcher functions.
+ */
+export declare function createWatchers({ logger: inputLogger, runtime, store }: WatcherDeps): ClientWatchers;
+export {};
+//# sourceMappingURL=watchers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watchers.d.ts","sourceRoot":"","sources":["../../../src/client/watchers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAIX,WAAW,EACX,cAAc,EAEd,mBAAmB,EAEnB,MAAM,UAAU,CAAC;AAKlB,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;CACnB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,GAAG,cAAc,CAkOnG"}

package/dist/types/controllers/solTransferController.d.ts

@@ -0,0 +1,21 @@
+import type { SolTransferHelper, SolTransferPrepareConfig, SolTransferSendOptions } from '../features/sol';
+import { type AsyncState } from '../state/asyncState';
+type SolTransferSignature = Awaited<ReturnType<SolTransferHelper['sendTransfer']>>;
+type Listener = () => void;
+export type SolTransferControllerConfig = Readonly<{
+    authorityProvider?: () => SolTransferPrepareConfig['authority'] | undefined;
+    helper: SolTransferHelper;
+}>;
+export type SolTransferInput = Omit<SolTransferPrepareConfig, 'authority'> & {
+    authority?: SolTransferPrepareConfig['authority'];
+};
+export type SolTransferController = Readonly<{
+    getHelper(): SolTransferHelper;
+    getState(): AsyncState<SolTransferSignature>;
+    reset(): void;
+    send(config: SolTransferInput, options?: SolTransferSendOptions): Promise<SolTransferSignature>;
+    subscribe(listener: Listener): () => void;
+}>;
+export declare function createSolTransferController(config: SolTransferControllerConfig): SolTransferController;
+export {};
+//# sourceMappingURL=solTransferController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"solTransferController.d.ts","sourceRoot":"","sources":["../../../src/controllers/solTransferController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC3G,OAAO,EAAE,KAAK,UAAU,EAA6C,MAAM,qBAAqB,CAAC;AAEjG,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEnF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,iBAAiB,CAAC,EAAE,MAAM,wBAAwB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAC5E,MAAM,EAAE,iBAAiB,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,EAAE,WAAW,CAAC,GAAG;IAC5E,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChG,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAC1C,CAAC,CAAC;AAgBH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,GAAG,qBAAqB,CAgDtG"}

package/dist/types/controllers/splTransferController.d.ts

@@ -0,0 +1,24 @@
+import type { SolTransferSendOptions } from '../features/sol';
+import type { SplTokenHelper, SplTransferPrepareConfig } from '../features/spl';
+import { type AsyncState } from '../state/asyncState';
+type SplTransferSignature = Awaited<ReturnType<SplTokenHelper['sendTransfer']>>;
+type Listener = () => void;
+export type SplTransferInput = Omit<SplTransferPrepareConfig, 'authority' | 'sourceOwner'> & {
+    authority?: SplTransferPrepareConfig['authority'];
+    sourceOwner?: SplTransferPrepareConfig['sourceOwner'];
+};
+export type SplTransferControllerConfig = Readonly<{
+    authorityProvider?: () => SplTransferPrepareConfig['authority'] | undefined;
+    helper: SplTokenHelper;
+    sourceOwnerProvider?: () => SplTransferPrepareConfig['sourceOwner'] | undefined;
+}>;
+export type SplTransferController = Readonly<{
+    getHelper(): SplTokenHelper;
+    getState(): AsyncState<SplTransferSignature>;
+    reset(): void;
+    send(config: SplTransferInput, options?: SolTransferSendOptions): Promise<SplTransferSignature>;
+    subscribe(listener: Listener): () => void;
+}>;
+export declare function createSplTransferController(config: SplTransferControllerConfig): SplTransferController;
+export {};
+//# sourceMappingURL=splTransferController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splTransferController.d.ts","sourceRoot":"","sources":["../../../src/controllers/splTransferController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,KAAK,UAAU,EAA6C,MAAM,qBAAqB,CAAC;AAEjG,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEhF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,aAAa,CAAC,GAAG;IAC5F,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,iBAAiB,CAAC,EAAE,MAAM,wBAAwB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAC5E,MAAM,EAAE,cAAc,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,wBAAwB,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,SAAS,IAAI,cAAc,CAAC;IAC5B,QAAQ,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChG,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAC1C,CAAC,CAAC;AAsBH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,GAAG,qBAAqB,CAqDtG"}

package/dist/types/features/sol.d.ts

@@ -0,0 +1,41 @@
+import { type Address, type Blockhash, type Commitment, type Slot, signature, signTransactionMessageWithSigners, type TransactionPlan, type TransactionSigner, type TransactionVersion } from '@solana/kit';
+import type { SolanaClientRuntime, WalletSession } from '../types';
+type BlockhashLifetime = Readonly<{
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+}>;
+type SolTransferAmount = bigint | number | string;
+type SolTransferAuthority = TransactionSigner<string> | WalletSession;
+type SignableSolTransactionMessage = Parameters<typeof signTransactionMessageWithSigners>[0];
+export type SolTransferPrepareConfig = Readonly<{
+    amount: SolTransferAmount;
+    authority: SolTransferAuthority;
+    commitment?: Commitment;
+    destination: Address | string;
+    lifetime?: BlockhashLifetime;
+    transactionVersion?: TransactionVersion;
+}>;
+export type SolTransferSendOptions = Readonly<{
+    abortSignal?: AbortSignal;
+    commitment?: Commitment;
+    maxRetries?: bigint | number;
+    minContextSlot?: Slot;
+    skipPreflight?: boolean;
+}>;
+type PreparedSolTransfer = Readonly<{
+    commitment?: Commitment;
+    lifetime: BlockhashLifetime;
+    message: SignableSolTransactionMessage;
+    mode: 'partial' | 'send';
+    signer: TransactionSigner;
+    plan?: TransactionPlan;
+}>;
+export type SolTransferHelper = Readonly<{
+    prepareTransfer(config: SolTransferPrepareConfig): Promise<PreparedSolTransfer>;
+    sendPreparedTransfer(prepared: PreparedSolTransfer, options?: SolTransferSendOptions): Promise<ReturnType<typeof signature>>;
+    sendTransfer(config: SolTransferPrepareConfig, options?: SolTransferSendOptions): Promise<ReturnType<typeof signature>>;
+}>;
+/** Creates documented helpers that build and submit System Program SOL transfers. */
+export declare function createSolTransferHelper(runtime: SolanaClientRuntime): SolTransferHelper;
+export {};
+//# sourceMappingURL=sol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sol.d.ts","sourceRoot":"","sources":["../../../src/features/sol.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,OAAO,EAGZ,KAAK,SAAS,EACd,KAAK,UAAU,EAMf,KAAK,IAAI,EAIT,SAAS,EACT,iCAAiC,EAEjC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnE,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,KAAK,oBAAoB,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;AAEtE,KAAK,6BAA6B,GAAG,UAAU,CAAC,OAAO,iCAAiC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,oBAAoB,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,KAAK,mBAAmB,GAAG,QAAQ,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,6BAA6B,CAAC;IACvC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB,CAAC,CAAC;AAiCH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,eAAe,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChF,oBAAoB,CACnB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;IACzC,YAAY,CACX,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC;AAEH,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CAyFvF"}

package/dist/types/features/spl.d.ts

@@ -0,0 +1,59 @@
+import { type Address, type Blockhash, type Commitment, signature, signTransactionMessageWithSigners, type TransactionPlan, type TransactionSigner, type TransactionVersion } from '@solana/kit';
+import type { SolanaClientRuntime, WalletSession } from '../types';
+import type { SolTransferSendOptions } from './sol';
+type BlockhashLifetime = Readonly<{
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+}>;
+type SplTokenAuthority = TransactionSigner<string> | WalletSession;
+type SignableSplTransactionMessage = Parameters<typeof signTransactionMessageWithSigners>[0];
+export type SplTokenHelperConfig = Readonly<{
+    associatedTokenProgram?: Address | string;
+    commitment?: Commitment;
+    decimals?: number;
+    mint: Address | string;
+    tokenProgram?: Address | string;
+}>;
+export type SplTokenBalance = Readonly<{
+    amount: bigint;
+    ataAddress: Address;
+    decimals: number;
+    exists: boolean;
+    uiAmount: string;
+}>;
+export type SplTransferPrepareConfig = Readonly<{
+    amount: bigint | number | string;
+    amountInBaseUnits?: boolean;
+    authority: SplTokenAuthority;
+    commitment?: Commitment;
+    destinationOwner: Address | string;
+    destinationToken?: Address | string;
+    ensureDestinationAta?: boolean;
+    lifetime?: BlockhashLifetime;
+    sourceOwner?: Address | string;
+    sourceToken?: Address | string;
+    transactionVersion?: TransactionVersion;
+}>;
+type PreparedSplTransfer = Readonly<{
+    amount: bigint;
+    commitment?: Commitment;
+    decimals: number;
+    destinationAta: Address;
+    lifetime: BlockhashLifetime;
+    message: SignableSplTransactionMessage;
+    mode: 'partial' | 'send';
+    signer: TransactionSigner;
+    sourceAta: Address;
+    plan?: TransactionPlan;
+}>;
+export type SplTokenHelper = Readonly<{
+    deriveAssociatedTokenAddress(owner: Address | string): Promise<Address>;
+    fetchBalance(owner: Address | string, commitment?: Commitment): Promise<SplTokenBalance>;
+    prepareTransfer(config: SplTransferPrepareConfig): Promise<PreparedSplTransfer>;
+    sendPreparedTransfer(prepared: PreparedSplTransfer, options?: SolTransferSendOptions): Promise<ReturnType<typeof signature>>;
+    sendTransfer(config: SplTransferPrepareConfig, options?: SolTransferSendOptions): Promise<ReturnType<typeof signature>>;
+}>;
+/** Creates helpers dedicated to SPL token account discovery, balances, and transfers. */
+export declare function createSplTokenHelper(runtime: SolanaClientRuntime, config: SplTokenHelperConfig): SplTokenHelper;
+export {};
+//# sourceMappingURL=spl.d.ts.map

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

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

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

@@ -0,0 +1,79 @@
+import type { Address, appendTransactionMessageInstruction, Blockhash, Commitment, InstructionPlan, Slot, TransactionPlan, TransactionPlannerConfig, TransactionSigner, TransactionVersion } from '@solana/kit';
+import { signature, signTransactionMessageWithSigners } from '@solana/kit';
+import { type PrepareTransactionMessage, type PrepareTransactionOptions } from '../transactions/prepareTransaction';
+import type { SolanaClientRuntime, WalletSession } from '../types';
+type BlockhashLifetime = Readonly<{
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+}>;
+type TransactionInstruction = Parameters<typeof appendTransactionMessageInstruction>[0];
+export type TransactionInstructionInput = TransactionInstruction;
+type SignableTransactionMessage = Parameters<typeof signTransactionMessageWithSigners>[0];
+type TransactionAuthority = TransactionSigner | WalletSession;
+type PrepareTransactionOverrides = Omit<PrepareTransactionOptions<PrepareTransactionMessage>, 'transaction'>;
+type TransactionRecipeMetadata = Readonly<{
+    commitment: Commitment;
+    computeUnitLimit?: bigint;
+    computeUnitPrice?: bigint;
+    feePayer: Address;
+    instructions: readonly TransactionInstruction[];
+    lifetime: BlockhashLifetime;
+    mode: 'partial' | 'send';
+    version: TransactionVersion;
+}>;
+export type TransactionRecipe = TransactionRecipeMetadata & Readonly<{
+    createTransactionMessage: TransactionPlannerConfig['createTransactionMessage'];
+    instructionPlan: InstructionPlan;
+}>;
+export type TransactionRecipeContext = Readonly<{
+    getFallbackCommitment(): Commitment;
+    runtime: SolanaClientRuntime;
+}>;
+export type TransactionPrepareRequest = Readonly<{
+    abortSignal?: AbortSignal;
+    authority?: TransactionAuthority;
+    commitment?: Commitment;
+    computeUnitLimit?: bigint | number;
+    computeUnitPrice?: bigint | number;
+    feePayer?: Address | string | TransactionSigner;
+    instructions: readonly TransactionInstruction[];
+    lifetime?: BlockhashLifetime;
+    version?: TransactionVersion | 'auto';
+}>;
+export type TransactionPrepareAndSendRequest = TransactionPrepareRequest & Readonly<{
+    prepareTransaction?: false | PrepareTransactionOverrides;
+}>;
+export type TransactionPrepared = Readonly<{
+    commitment: Commitment;
+    computeUnitLimit?: bigint;
+    computeUnitPrice?: bigint;
+    feePayer: Address;
+    instructions: readonly TransactionInstruction[];
+    lifetime: BlockhashLifetime;
+    message: SignableTransactionMessage;
+    mode: 'partial' | 'send';
+    plan?: TransactionPlan;
+    version: TransactionVersion;
+}>;
+export type TransactionSignOptions = Readonly<{
+    abortSignal?: AbortSignal;
+    minContextSlot?: Slot;
+}>;
+export type TransactionSendOptions = Readonly<{
+    abortSignal?: AbortSignal;
+    commitment?: Commitment;
+    maxRetries?: bigint | number;
+    minContextSlot?: Slot;
+    skipPreflight?: boolean;
+}>;
+export type TransactionHelper = Readonly<{
+    prepare(request: TransactionPrepareRequest): Promise<TransactionPrepared>;
+    sign(prepared: TransactionPrepared, options?: TransactionSignOptions): ReturnType<typeof signTransactionMessageWithSigners>;
+    toWire(prepared: TransactionPrepared, options?: TransactionSignOptions): Promise<string>;
+    send(prepared: TransactionPrepared, options?: TransactionSendOptions): Promise<ReturnType<typeof signature>>;
+    prepareAndSend(request: TransactionPrepareAndSendRequest, options?: TransactionSendOptions): Promise<ReturnType<typeof signature>>;
+}>;
+export declare function createTransactionRecipe(request: TransactionPrepareRequest, context: TransactionRecipeContext): Promise<TransactionRecipe>;
+export declare function createTransactionHelper(runtime: SolanaClientRuntime, getFallbackCommitment: () => Commitment): TransactionHelper;
+export {};
+//# sourceMappingURL=transactions.d.ts.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,25 @@
+export { createClient } from './client/createClient';
+export { createClientStore, createDefaultClientStore, createInitialClientState } from './client/createClientStore';
+export { createSolTransferController, type SolTransferController, type SolTransferControllerConfig, type SolTransferInput, } from './controllers/solTransferController';
+export { createSplTransferController, type SplTransferController, type SplTransferControllerConfig, type SplTransferInput, } from './controllers/splTransferController';
+export { createSolTransferHelper, type SolTransferHelper, type SolTransferPrepareConfig, type SolTransferSendOptions, } from './features/sol';
+export { createSplTokenHelper, type SplTokenBalance, type SplTokenHelper, type SplTokenHelperConfig, type SplTransferPrepareConfig, } from './features/spl';
+export { createTransactionHelper, createTransactionRecipe, type TransactionHelper, type TransactionInstructionInput, type TransactionPrepareAndSendRequest, type TransactionPrepared, type TransactionPrepareRequest, type TransactionRecipe, type TransactionRecipeContext, type TransactionSendOptions, type TransactionSignOptions, } from './features/transactions';
+export { createTokenAmount, type FormatAmountOptions, type ParseAmountOptions, type TokenAmountMath, } from './numeric/amounts';
+export { LAMPORTS_PER_SOL, lamports, lamportsFromSol, lamportsMath, lamportsToSolString } from './numeric/lamports';
+export { assertDecimals, assertNonNegative, type BigintLike, checkedAdd, checkedDivide, checkedMultiply, checkedSubtract, pow10, toBigint, } from './numeric/math';
+export { type ApplyRatioOptions, applyRatio, createRatio, type Ratio, type RoundingMode } from './numeric/rational';
+export { type CreateSolanaRpcClientConfig, createSolanaRpcClient, type SendAndConfirmTransactionOptions, type SimulateTransactionOptions, type SolanaRpcClient, } from './rpc/createSolanaRpcClient';
+export { bigintFromJson, bigintToJson, lamportsFromJson, lamportsToJson } from './serialization/json';
+export { type ConfirmationCommitment, confirmationMeetsCommitment, deriveConfirmationStatus, normalizeSignature, SIGNATURE_STATUS_TIMEOUT_MS, type SignatureLike, type SignatureStatusLike, } from './signatures/status';
+export { type AsyncState, type AsyncStatus, createAsyncState, createInitialAsyncState } from './state/asyncState';
+export { transactionToBase64, transactionToBase64WithSigners, } from './transactions/base64';
+export { type PrepareTransactionConfig, type PrepareTransactionMessage, type PrepareTransactionOptions, prepareTransaction, } from './transactions/prepareTransaction';
+export { insertReferenceKey, insertReferenceKeys } from './transactions/referenceKeys';
+export { createTransactionPoolController, type LatestBlockhashCache, type TransactionInstructionList, type TransactionPoolConfig, type TransactionPoolController, type TransactionPoolPrepareAndSendOptions, type TransactionPoolPrepareOptions, type TransactionPoolSendOptions, type TransactionPoolSignOptions, } from './transactions/transactionPoolController';
+export type { AccountCache, AccountCacheEntry, AccountWatcherConfig, BalanceWatcherConfig, ClientActions, ClientHelpers, ClientState, ClientStore, ClientWatchers, SolanaClient, SolanaClientConfig, WalletConnector, WalletConnectorMetadata, WalletRegistry, WalletSession, WalletStatus, } from './types';
+export { type AddressLike, toAddress, toAddressString } from './utils/addressLike';
+export { stableStringify } from './utils/stableStringify';
+export { createWalletRegistry } from './wallet/registry';
+export { createWalletStandardConnector, getWalletStandardConnectors, watchWalletStandardConnectors, } from './wallet/standard';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/logging/logger.d.ts

@@ -0,0 +1,24 @@
+import type { ClientLogger, LogLevel } from '../types';
+/**
+ * Creates a logger function that falls back to console logging when no custom logger is provided.
+ *
+ * @param logger - Optional logger implementation supplied by the integrator.
+ * @returns A {@link ClientLogger} instance ready for dependency injection.
+ */
+export declare function createLogger(logger?: ClientLogger): ClientLogger;
+/**
+ * Formats an error into a structured payload for logging.
+ *
+ * @param error - Arbitrary error value that will be recorded.
+ * @returns Serializable shape containing the original error and message.
+ */
+export declare function formatError(error: unknown): Record<string, unknown>;
+/**
+ * Returns whether the provided log level is at least as severe as the threshold.
+ *
+ * @param level - Log level to evaluate.
+ * @param threshold - Minimum severity level that should pass.
+ * @returns `true` when the level meets or exceeds the threshold.
+ */
+export declare function isLevelAtLeast(level: LogLevel, threshold: LogLevel): boolean;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAUvD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAoBhE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAE5E"}

package/dist/types/numeric/amounts.d.ts

@@ -0,0 +1,30 @@
+import { type BigintLike } from './math';
+import { type ApplyRatioOptions, type Ratio, type RoundingMode } from './rational';
+export type ParseAmountOptions = Readonly<{
+    label?: string;
+    rounding?: RoundingMode;
+}>;
+export type FormatAmountOptions = Readonly<{
+    minimumFractionDigits?: number;
+    trimTrailingZeros?: boolean;
+}>;
+export type TokenAmountMath = Readonly<{
+    add(lhs: bigint, rhs: bigint): bigint;
+    compare(lhs: bigint, rhs: bigint): number;
+    decimals: number;
+    fromBaseUnits(value: BigintLike, label?: string): bigint;
+    fromDecimal(value: number | string, options?: ParseAmountOptions): bigint;
+    isZero(amount: bigint): boolean;
+    multiplyByRatio(amount: bigint, ratio: Ratio, options?: ApplyRatioOptions): bigint;
+    scale: bigint;
+    subtract(lhs: bigint, rhs: bigint): bigint;
+    toDecimalString(amount: bigint, options?: FormatAmountOptions): string;
+}>;
+/**
+ * Factory that returns integer-safe helpers for working with token amounts across arbitrary decimals.
+ *
+ * @param decimals - Token decimal precision (0-38) used to scale values.
+ * @returns Helper collection for conversions and arithmetic over bigint amounts.
+ */
+export declare function createTokenAmount(decimals: number): TokenAmountMath;
+//# sourceMappingURL=amounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.d.ts","sourceRoot":"","sources":["../../../src/numeric/amounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,UAAU,EAKf,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,KAAK,iBAAiB,EAAc,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAC1E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;CACvE,CAAC,CAAC;AA2HH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAgInE"}

package/dist/types/numeric/lamports.d.ts

@@ -0,0 +1,46 @@
+import type { Lamports } from '@solana/kit';
+import { type FormatAmountOptions, type ParseAmountOptions, type TokenAmountMath } from './amounts';
+import type { ApplyRatioOptions, Ratio } from './rational';
+export declare const LAMPORTS_PER_SOL: bigint;
+export type LamportsMath = Readonly<{
+    add(lhs: Lamports, rhs: Lamports): Lamports;
+    compare(lhs: Lamports, rhs: Lamports): number;
+    decimals: number;
+    fromLamports(value: bigint | number | string, label?: string): Lamports;
+    fromSol(value: number | string, options?: ParseAmountOptions): Lamports;
+    isZero(amount: Lamports): boolean;
+    multiplyByRatio(amount: Lamports, ratio: Ratio, options?: ApplyRatioOptions): Lamports;
+    raw: TokenAmountMath;
+    scale: bigint;
+    subtract(lhs: Lamports, rhs: Lamports): Lamports;
+    toSolString(amount: Lamports, options?: FormatAmountOptions): string;
+}>;
+/**
+ * Typed helpers for working with lamport-denominated values.
+ */
+export declare const lamportsMath: LamportsMath;
+/**
+ * Shortcut for constructing lamport values from base units.
+ *
+ * @param value - Integer-like lamport amount.
+ * @param label - Optional label used for error reporting.
+ * @returns Normalized lamport bigint.
+ */
+export declare function lamports(value: bigint | number | string, label?: string): Lamports;
+/**
+ * Converts an SOL-denominated value into lamports.
+ *
+ * @param value - Decimal representation of SOL.
+ * @param options - Optional rounding and labelling configuration.
+ * @returns Lamport amount.
+ */
+export declare function lamportsFromSol(value: number | string, options?: ParseAmountOptions): Lamports;
+/**
+ * Converts lamports into a human-readable SOL string.
+ *
+ * @param amount - Lamport amount to format.
+ * @param options - Formatting preferences.
+ * @returns SOL string representation.
+ */
+export declare function lamportsToSolString(amount: Lamports, options?: FormatAmountOptions): string;
+//# sourceMappingURL=lamports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lamports.d.ts","sourceRoot":"","sources":["../../../src/numeric/lamports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAqB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AACvH,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAI3D,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5C,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC;IACxE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,QAAQ,CAAC;IACvF,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjD,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAoFzB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAE3F"}

package/dist/types/numeric/math.d.ts

@@ -0,0 +1,74 @@
+export type BigintLike = bigint | number | string;
+/**
+ * Raises 10 to the power of the provided non-negative integer exponent.
+ *
+ * @param exponent - Exponent that must be between 0 and 38 inclusive.
+ * @returns Power-of-ten bigint value.
+ */
+export declare function pow10(exponent: number): bigint;
+/**
+ * Ensures the provided bigint is not negative.
+ *
+ * @param value - Bigint value to validate.
+ * @param label - Optional label used in error messages.
+ * @throws When the value is negative.
+ */
+export declare function assertNonNegative(value: bigint, label?: string): void;
+/**
+ * Ensures the provided decimals value is a safe non-negative integer within typical SPL limits.
+ *
+ * @param decimals - Decimal precision to validate.
+ * @param label - Optional label used in error messages.
+ * @throws When the value is not an integer between 0 and 38 inclusive.
+ */
+export declare function assertDecimals(decimals: number, label?: string): void;
+/**
+ * Converts supported numeric inputs into bigint while enforcing integer semantics.
+ *
+ * @param value - Integer-like value to convert.
+ * @param label - Optional label used in error messages.
+ * @returns Bigint representation of the supplied value.
+ * @throws When the input is not a finite integer.
+ */
+export declare function toBigint(value: BigintLike, label?: string): bigint;
+/**
+ * Adds two bigint values while enforcing non-negative outputs.
+ *
+ * @param lhs - Left-hand side operand.
+ * @param rhs - Right-hand side operand.
+ * @param label - Optional label used in error messages.
+ * @returns Sum of the operands.
+ * @throws When the result is negative.
+ */
+export declare function checkedAdd(lhs: bigint, rhs: bigint, label?: string): bigint;
+/**
+ * Subtracts two bigint values, throwing if the operation would go negative.
+ *
+ * @param lhs - Left-hand side operand.
+ * @param rhs - Right-hand side operand.
+ * @param label - Optional label used in error messages.
+ * @returns Difference of the operands.
+ * @throws When the result is negative.
+ */
+export declare function checkedSubtract(lhs: bigint, rhs: bigint, label?: string): bigint;
+/**
+ * Multiplies two bigint values and ensures the result is non-negative.
+ *
+ * @param lhs - Left-hand side operand.
+ * @param rhs - Right-hand side operand.
+ * @param label - Optional label used in error messages.
+ * @returns Product of the operands.
+ * @throws When the result is negative.
+ */
+export declare function checkedMultiply(lhs: bigint, rhs: bigint, label?: string): bigint;
+/**
+ * Performs integer division and verifies that the divisor is non-zero and the result is non-negative.
+ *
+ * @param dividend - Value to be divided.
+ * @param divisor - Value to divide by.
+ * @param label - Optional label used in error messages.
+ * @returns Quotient of the division.
+ * @throws When the divisor is zero or the result is negative.
+ */
+export declare function checkedDivide(dividend: bigint, divisor: bigint, label?: string): bigint;
+//# sourceMappingURL=math.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/numeric/math.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAIlD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAU,GAAG,IAAI,CAItE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,IAAI,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,SAAU,GAAG,MAAM,CAmBnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAI7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAIlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAIlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAOzF"}

package/dist/types/numeric/rational.d.ts

@@ -0,0 +1,27 @@
+import { type BigintLike } from './math';
+export type RoundingMode = 'ceil' | 'floor' | 'round';
+export type Ratio = Readonly<{
+    denominator: bigint;
+    numerator: bigint;
+}>;
+/**
+ * Creates a ratio used for slippage, fee, or percentage calculations.
+ *
+ * @param numeratorInput - Numerator part of the ratio; must be non-negative.
+ * @param denominatorInput - Denominator part of the ratio; must be positive.
+ * @returns Immutable ratio descriptor.
+ */
+export declare function createRatio(numeratorInput: BigintLike, denominatorInput: BigintLike): Ratio;
+export type ApplyRatioOptions = Readonly<{
+    rounding?: RoundingMode;
+}>;
+/**
+ * Multiplies an integer amount by the provided ratio using the requested rounding strategy.
+ *
+ * @param amount - Base amount to scale; must be non-negative.
+ * @param ratio - Ratio produced by {@link createRatio}.
+ * @param options - Optional rounding configuration.
+ * @returns Scaled amount as a bigint.
+ */
+export declare function applyRatio(amount: bigint, ratio: Ratio, options?: ApplyRatioOptions): bigint;
+//# sourceMappingURL=rational.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rational.d.ts","sourceRoot":"","sources":["../../../src/numeric/rational.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAY,MAAM,QAAQ,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AA+BH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,GAAG,KAAK,CAQ3F;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAKhG"}