@solana/kora 0.3.0-beta.0 → 0.3.0-beta.2

package/dist/src/client.d.ts

@@ -153,6 +153,11 @@ export declare class KoraClient {
      * Signs a transaction and immediately broadcasts it to the Solana network.
      * @param request - Sign and send request parameters
      * @param request.transaction - Base64-encoded transaction to sign and send
+     * @param request.respond_after - The lifecycle milestone to wait for before
+     * responding (defaults to `'confirmed'`): `'confirmed'` waits for on-chain confirmation,
+     * `'sent'` returns once the RPC node accepts the transaction, `'signed'` returns as soon
+     * as signing completes and broadcasts in the background (broadcast failures are logged
+     * server-side; rebroadcast the returned signed transaction if it never lands)
      * @returns Signature and the signed transaction
      * @throws {Error} When the RPC call fails, validation fails, or broadcast fails
      *
@@ -162,6 +167,12 @@ export declare class KoraClient {
      *   transaction: 'base64EncodedTransaction'
      * });
      * console.log('Transaction signature:', result.signature);
+     *
+     * // Lowest latency: return as soon as signing completes
+     * const fast = await client.signAndSendTransaction({
+     *   transaction: 'base64EncodedTransaction',
+     *   respond_after: 'signed'
+     * });
      * ```
      */
     signAndSendTransaction(request: SignAndSendTransactionRequest): Promise<SignAndSendTransactionResponse>;

package/dist/src/client.js

@@ -1,6 +1,7 @@
 import { assertIsAddress, isTransactionSigner } from '@solana/kit';
 import { findAssociatedTokenPda, getTransferInstruction, TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
 import crypto from 'crypto';
+import { KoraError } from './error.js';
 /**
  * Kora RPC client for interacting with the Kora paymaster service.
  *
@@ -79,8 +80,8 @@ export class KoraClient {
         });
         const json = (await response.json());
         if (json.error) {
-            const error = json.error;
-            throw new Error(`RPC Error ${error.code}: ${error.message}`);
+            const { code, message, data } = json.error;
+            throw new KoraError(code, message, data);
         }
         return json.result;
     }
@@ -217,6 +218,11 @@ export class KoraClient {
      * Signs a transaction and immediately broadcasts it to the Solana network.
      * @param request - Sign and send request parameters
      * @param request.transaction - Base64-encoded transaction to sign and send
+     * @param request.respond_after - The lifecycle milestone to wait for before
+     * responding (defaults to `'confirmed'`): `'confirmed'` waits for on-chain confirmation,
+     * `'sent'` returns once the RPC node accepts the transaction, `'signed'` returns as soon
+     * as signing completes and broadcasts in the background (broadcast failures are logged
+     * server-side; rebroadcast the returned signed transaction if it never lands)
      * @returns Signature and the signed transaction
      * @throws {Error} When the RPC call fails, validation fails, or broadcast fails
      *
@@ -226,6 +232,12 @@ export class KoraClient {
      *   transaction: 'base64EncodedTransaction'
      * });
      * console.log('Transaction signature:', result.signature);
+     *
+     * // Lowest latency: return as soon as signing completes
+     * const fast = await client.signAndSendTransaction({
+     *   transaction: 'base64EncodedTransaction',
+     *   respond_after: 'signed'
+     * });
      * ```
      */
     async signAndSendTransaction(request) {

package/dist/src/error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Stable numeric error codes for RPC responses following JSON-RPC 2.0 spec (-32000 to -32099 for server errors).
+ */
+export declare enum KoraErrorCode {
+    InvalidTransaction = -32000,
+    ValidationError = -32001,
+    UnsupportedFeeToken = -32002,
+    InsufficientFunds = -32003,
+    InvalidRequest = -32004,
+    FeeEstimationFailed = -32005,
+    TransactionExecutionFailed = -32006,
+    SigningError = -32020,
+    RateLimitExceeded = -32030,
+    UsageLimitExceeded = -32031,
+    Unauthorized = -32032,
+    SwapError = -32040,
+    TokenOperationError = -32041,
+    AccountNotFound = -32050,
+    JitoError = -32060,
+    RecaptchaError = -32061,
+    InternalServerError = -32090,
+    ConfigError = -32091,
+    SerializationError = -32092,
+    RpcError = -32093
+}
+/**
+ * Structured data returned in the JSON-RPC error object's `data` field.
+ */
+export interface KoraErrorData {
+    error_type: string;
+}
+/**
+ * Represents a structured error returned by the Kora paymaster service.
+ */
+export declare class KoraError extends Error {
+    /** The stable numeric error code */
+    readonly code: KoraErrorCode;
+    /** Optional structured data about the error */
+    readonly data?: KoraErrorData;
+    constructor(code?: number, message?: string, data?: KoraErrorData);
+}

package/dist/src/error.js

@@ -0,0 +1,54 @@
+/**
+ * Stable numeric error codes for RPC responses following JSON-RPC 2.0 spec (-32000 to -32099 for server errors).
+ */
+export var KoraErrorCode;
+(function (KoraErrorCode) {
+    // Validation errors (-32000 to -32019)
+    KoraErrorCode[KoraErrorCode["InvalidTransaction"] = -32000] = "InvalidTransaction";
+    KoraErrorCode[KoraErrorCode["ValidationError"] = -32001] = "ValidationError";
+    KoraErrorCode[KoraErrorCode["UnsupportedFeeToken"] = -32002] = "UnsupportedFeeToken";
+    KoraErrorCode[KoraErrorCode["InsufficientFunds"] = -32003] = "InsufficientFunds";
+    KoraErrorCode[KoraErrorCode["InvalidRequest"] = -32004] = "InvalidRequest";
+    KoraErrorCode[KoraErrorCode["FeeEstimationFailed"] = -32005] = "FeeEstimationFailed";
+    KoraErrorCode[KoraErrorCode["TransactionExecutionFailed"] = -32006] = "TransactionExecutionFailed";
+    // Signing errors (-32020 to -32029)
+    KoraErrorCode[KoraErrorCode["SigningError"] = -32020] = "SigningError";
+    // Auth / Rate limiting (-32030 to -32039)
+    KoraErrorCode[KoraErrorCode["RateLimitExceeded"] = -32030] = "RateLimitExceeded";
+    KoraErrorCode[KoraErrorCode["UsageLimitExceeded"] = -32031] = "UsageLimitExceeded";
+    KoraErrorCode[KoraErrorCode["Unauthorized"] = -32032] = "Unauthorized";
+    // Token / Swap (-32040 to -32049)
+    KoraErrorCode[KoraErrorCode["SwapError"] = -32040] = "SwapError";
+    KoraErrorCode[KoraErrorCode["TokenOperationError"] = -32041] = "TokenOperationError";
+    // Account errors (-32050 to -32059)
+    KoraErrorCode[KoraErrorCode["AccountNotFound"] = -32050] = "AccountNotFound";
+    // External services (-32060 to -32069)
+    KoraErrorCode[KoraErrorCode["JitoError"] = -32060] = "JitoError";
+    KoraErrorCode[KoraErrorCode["RecaptchaError"] = -32061] = "RecaptchaError";
+    // Internal errors (-32090 to -32099)
+    KoraErrorCode[KoraErrorCode["InternalServerError"] = -32090] = "InternalServerError";
+    KoraErrorCode[KoraErrorCode["ConfigError"] = -32091] = "ConfigError";
+    KoraErrorCode[KoraErrorCode["SerializationError"] = -32092] = "SerializationError";
+    KoraErrorCode[KoraErrorCode["RpcError"] = -32093] = "RpcError";
+})(KoraErrorCode || (KoraErrorCode = {}));
+/**
+ * Represents a structured error returned by the Kora paymaster service.
+ */
+export class KoraError extends Error {
+    /** The stable numeric error code */
+    code;
+    /** Optional structured data about the error */
+    data;
+    constructor(code, message, data) {
+        const finalCode = code ?? -32603;
+        const finalMessage = message ?? 'Unknown error';
+        super(`Kora Error ${finalCode}: ${finalMessage}`);
+        this.name = 'KoraError';
+        this.code = finalCode;
+        this.data = data;
+        // Ensure proper stack trace in environments that support Error.captureStackTrace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, KoraError);
+        }
+    }
+}

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
+export * from './error.js';
 export * from './types/index.js';
 export { KoraClient } from './client.js';
-export { createKitKoraClient, type KoraKitClient } from './kit/index.js';
 export { koraPlugin, type KoraApi } from './plugin.js';

package/dist/src/index.js

@@ -1,4 +1,4 @@
+export * from './error.js';
 export * from './types/index.js';
 export { KoraClient } from './client.js';
-export { createKitKoraClient } from './kit/index.js';
 export { koraPlugin } from './plugin.js';

package/dist/src/kit/executor.d.ts

@@ -1,7 +1,7 @@
 import { type Address, type TransactionMessage, type TransactionMessageWithFeePayer, type TransactionSigner } from '@solana/kit';
 import { KoraClient } from '../client.js';
-import type { KoraKitClientConfig } from '../types/index.js';
-export declare function createKoraTransactionPlanExecutor(koraClient: KoraClient, config: KoraKitClientConfig, payerSigner: TransactionSigner, payment: {
+import type { KoraBundleConfig } from '../types/index.js';
+export declare function createKoraTransactionPlanExecutor(koraClient: KoraClient, config: KoraBundleConfig, userSigner: TransactionSigner, payerSigner: TransactionSigner, payment: {
     destinationTokenAccount: Address;
     sourceTokenAccount: Address;
 } | undefined, resolveProvisoryComputeUnitLimit: (<T extends TransactionMessage & TransactionMessageWithFeePayer>(transactionMessage: T) => Promise<T>) | undefined): import("@solana/kit").TransactionPlanExecutor<import("@solana/kit").TransactionPlanResultContext>;

package/dist/src/kit/executor.js

@@ -5,7 +5,7 @@ import { removePaymentInstruction, updatePaymentInstructionAmount } from './paym
 // submitting each one individually via `signAndSendTransaction`. This would let users
 // compose Jito bundles through the Kit plan/execute pipeline rather than manually encoding
 // transactions and calling `client.kora.signAndSendBundle()`.
-export function createKoraTransactionPlanExecutor(koraClient, config, payerSigner, payment, resolveProvisoryComputeUnitLimit) {
+export function createKoraTransactionPlanExecutor(koraClient, config, userSigner, payerSigner, payment, resolveProvisoryComputeUnitLimit) {
     return createTransactionPlanExecutor({
         async executeTransactionMessage(_context, transactionMessage) {
             // Kora manages blockhash validity; set max height to avoid premature client-side expiry checks
@@ -42,8 +42,8 @@ export function createKoraTransactionPlanExecutor(koraClient, config, payerSigne
                 }
                 // Replace placeholder with real fee amount, or strip it if fee is 0
                 const finalIxs = feeInToken > 0
-                    ? updatePaymentInstructionAmount(currentIxs, config.feePayerWallet, sourceTokenAccount, destinationTokenAccount, feeInToken, config.tokenProgramId)
-                    : removePaymentInstruction(currentIxs, sourceTokenAccount, destinationTokenAccount, config.feePayerWallet, config.tokenProgramId);
+                    ? updatePaymentInstructionAmount(currentIxs, userSigner, sourceTokenAccount, destinationTokenAccount, feeInToken, config.tokenProgramId)
+                    : removePaymentInstruction(currentIxs, sourceTokenAccount, destinationTokenAccount, userSigner, config.tokenProgramId);
                 const resolvedMsg = pipe(createTransactionMessage({ version: 0 }), m => setTransactionMessageFeePayerSigner(payerSigner, m), m => setTransactionMessageLifetimeUsingBlockhash({
                     blockhash: blockhash(bh),
                     lastValidBlockHeight: BigInt(Number.MAX_SAFE_INTEGER),

package/dist/src/kit/index.d.ts

@@ -1,32 +1,39 @@
-import type { KoraKitClientConfig } from '../types/index.js';
-/** The type returned by {@link createKitKoraClient}. */
-export type KoraKitClient = Awaited<ReturnType<typeof createKitKoraClient>>;
+import { type ClientWithIdentity } from '@solana/kit';
+import type { KoraBundleConfig, KoraKitClientConfig } from '../types/index.js';
 /**
- * Creates a Kora Kit client composed from Kit plugins.
+ * Kora bundle plugin.
+ *
+ * Composes RPC + payer + Kora RPC methods + transaction planning/execution into a single
+ * plugin that mirrors the shape of `solanaRpc` from `@solana/kit-plugin-rpc`.
  *
- * The returned client satisfies `ClientWithPayer`, `ClientWithTransactionPlanning`,
- * and `ClientWithTransactionSending`, making it composable with Kit program plugins.
+ * The caller's signer is read from `client.identity` — install `identity()` (or `signer()`)
+ * from `@solana/kit-plugin-signer` before this plugin. The fee payer (Kora's address) is
+ * fetched from the Kora node and installed internally as a noop signer, overriding any
+ * `payer` already on the client.
  *
  * @beta This API is experimental and may change in future releases.
  *
  * @example
- * ```typescript
- * import { createKitKoraClient } from '@solana/kora';
- * import { address } from '@solana/kit';
- *
- * const client = await createKitKoraClient({
- *   endpoint: 'https://kora.example.com',
- *   rpcUrl: 'https://api.mainnet-beta.solana.com',
- *   feeToken: address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
- *   feePayerWallet: userSigner,
- * });
- *
- * const result = await client.sendTransaction([myInstruction]);
+ * ```ts
+ * import { createClient } from '@solana/kit';
+ * import { identity } from '@solana/kit-plugin-signer';
+ * import { kora } from '@solana/kora';
+ *
+ * const client = await createClient()
+ *   .use(identity(userSigner))
+ *   .use(kora({
+ *     endpoint: 'https://kora.example.com',
+ *     rpcUrl: 'https://api.mainnet-beta.solana.com',
+ *     feeToken: address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
+ *   }));
+ *
+ * const signature = await client.sendTransaction([myInstruction]);
  * ```
  */
-export declare function createKitKoraClient(config: KoraKitClientConfig): Promise<import("@solana/kit").Client<import("@solana/kit").ClientWithTransactionPlanning & import("@solana/kit").ClientWithTransactionSending & object & {
+export declare function kora(config: KoraBundleConfig): <T extends ClientWithIdentity>(client: T) => Promise<Omit<Omit<Omit<Omit<Omit<T, "payer"> & {
+    payer: import("@solana/kit").NoopSigner<string>;
+}, "rpc"> & {
     rpc: import("@solana/kit").Rpc<import("@solana/kit").RequestAirdropApi & import("@solana/kit").GetAccountInfoApi & import("@solana/kit").GetBalanceApi & import("@solana/kit").GetBlockApi & import("@solana/kit").GetBlockCommitmentApi & import("@solana/kit").GetBlockHeightApi & import("@solana/kit").GetBlockProductionApi & import("@solana/kit").GetBlocksApi & import("@solana/kit").GetBlocksWithLimitApi & import("@solana/kit").GetBlockTimeApi & import("@solana/kit").GetClusterNodesApi & import("@solana/kit").GetEpochInfoApi & import("@solana/kit").GetEpochScheduleApi & import("@solana/kit").GetFeeForMessageApi & import("@solana/kit").GetFirstAvailableBlockApi & import("@solana/kit").GetGenesisHashApi & import("@solana/kit").GetHealthApi & import("@solana/kit").GetHighestSnapshotSlotApi & import("@solana/kit").GetIdentityApi & import("@solana/kit").GetInflationGovernorApi & import("@solana/kit").GetInflationRateApi & import("@solana/kit").GetInflationRewardApi & import("@solana/kit").GetLargestAccountsApi & import("@solana/kit").GetLatestBlockhashApi & import("@solana/kit").GetLeaderScheduleApi & import("@solana/kit").GetMaxRetransmitSlotApi & import("@solana/kit").GetMaxShredInsertSlotApi & import("@solana/kit").GetMinimumBalanceForRentExemptionApi & import("@solana/kit").GetMultipleAccountsApi & import("@solana/kit").GetProgramAccountsApi & import("@solana/kit").GetRecentPerformanceSamplesApi & import("@solana/kit").GetRecentPrioritizationFeesApi & import("@solana/kit").GetSignaturesForAddressApi & import("@solana/kit").GetSignatureStatusesApi & import("@solana/kit").GetSlotApi & import("@solana/kit").GetSlotLeaderApi & import("@solana/kit").GetSlotLeadersApi & import("@solana/kit").GetStakeMinimumDelegationApi & import("@solana/kit").GetSupplyApi & import("@solana/kit").GetTokenAccountBalanceApi & import("@solana/kit").GetTokenAccountsByDelegateApi & import("@solana/kit").GetTokenAccountsByOwnerApi & import("@solana/kit").GetTokenLargestAccountsApi & import("@solana/kit").GetTokenSupplyApi & import("@solana/kit").GetTransactionApi & import("@solana/kit").GetTransactionCountApi & import("@solana/kit").GetVersionApi & import("@solana/kit").GetVoteAccountsApi & import("@solana/kit").IsBlockhashValidApi & import("@solana/kit").MinimumLedgerSlotApi & import("@solana/kit").SendTransactionApi & import("@solana/kit").SimulateTransactionApi>;
-    rpcSubscriptions: import("@solana/kit").RpcSubscriptions<import("@solana/kit").SolanaRpcSubscriptionsApi>;
 } & {
     kora: {
         estimateBundleFee(request: import("../types/index.js").EstimateBundleFeeRequest): Promise<import("../types/index.js").KitEstimateBundleFeeResponse>;
@@ -42,12 +49,62 @@ export declare function createKitKoraClient(config: KoraKitClientConfig): Promis
         signBundle(request: import("../types/index.js").SignBundleRequest): Promise<import("../types/index.js").KitSignBundleResponse>;
         signTransaction(request: import("../types/index.js").SignTransactionRequest): Promise<import("../types/index.js").KitSignTransactionResponse>;
     };
-} & {
-    payer: import("@solana/kit").TransactionSigner;
 } & {
     paymentAddress: import("@solana/kit").Address | undefined;
-} & {
+}, "transactionPlanner"> & {
     transactionPlanner: import("@solana/kit").TransactionPlanner;
+}, "transactionPlanExecutor"> & {
+    transactionPlanExecutor: import("@solana/kit").TransactionPlanExecutor;
+}, keyof import("@solana/kit").ClientWithTransactionPlanning | keyof import("@solana/kit").ClientWithTransactionSending> & import("@solana/kit").ClientWithTransactionPlanning & import("@solana/kit").ClientWithTransactionSending>;
+/**
+ * The type returned by {@link createKitKoraClient}.
+ *
+ * @deprecated Derive the client type from your own `createClient().use(...).use(kora(...))`
+ * composition instead. Will be removed in 0.4.0.
+ */
+export type KoraKitClient = Awaited<ReturnType<typeof createKitKoraClient>>;
+/**
+ * Creates a Kora Kit client composed from Kit plugins.
+ *
+ * @beta This API is experimental and may change in future releases.
+ *
+ * @deprecated Compose with the {@link kora} plugin instead:
+ * ```ts
+ * import { createClient } from '@solana/kit';
+ * import { identity } from '@solana/kit-plugin-signer';
+ * import { kora } from '@solana/kora';
+ *
+ * const client = await createClient()
+ *   .use(identity(userSigner))
+ *   .use(kora({ endpoint, rpcUrl, feeToken }));
+ * ```
+ * Will be removed in 0.4.0.
+ */
+export declare function createKitKoraClient(config: KoraKitClientConfig): Promise<import("@solana/kit").Client<Omit<Omit<Omit<Omit<Omit<Omit<object, "identity"> & {
+    identity: import("@solana/kit").TransactionSigner;
+}, "payer"> & {
+    payer: import("@solana/kit").NoopSigner<string>;
+}, "rpc"> & {
+    rpc: import("@solana/kit").Rpc<import("@solana/kit").RequestAirdropApi & import("@solana/kit").GetAccountInfoApi & import("@solana/kit").GetBalanceApi & import("@solana/kit").GetBlockApi & import("@solana/kit").GetBlockCommitmentApi & import("@solana/kit").GetBlockHeightApi & import("@solana/kit").GetBlockProductionApi & import("@solana/kit").GetBlocksApi & import("@solana/kit").GetBlocksWithLimitApi & import("@solana/kit").GetBlockTimeApi & import("@solana/kit").GetClusterNodesApi & import("@solana/kit").GetEpochInfoApi & import("@solana/kit").GetEpochScheduleApi & import("@solana/kit").GetFeeForMessageApi & import("@solana/kit").GetFirstAvailableBlockApi & import("@solana/kit").GetGenesisHashApi & import("@solana/kit").GetHealthApi & import("@solana/kit").GetHighestSnapshotSlotApi & import("@solana/kit").GetIdentityApi & import("@solana/kit").GetInflationGovernorApi & import("@solana/kit").GetInflationRateApi & import("@solana/kit").GetInflationRewardApi & import("@solana/kit").GetLargestAccountsApi & import("@solana/kit").GetLatestBlockhashApi & import("@solana/kit").GetLeaderScheduleApi & import("@solana/kit").GetMaxRetransmitSlotApi & import("@solana/kit").GetMaxShredInsertSlotApi & import("@solana/kit").GetMinimumBalanceForRentExemptionApi & import("@solana/kit").GetMultipleAccountsApi & import("@solana/kit").GetProgramAccountsApi & import("@solana/kit").GetRecentPerformanceSamplesApi & import("@solana/kit").GetRecentPrioritizationFeesApi & import("@solana/kit").GetSignaturesForAddressApi & import("@solana/kit").GetSignatureStatusesApi & import("@solana/kit").GetSlotApi & import("@solana/kit").GetSlotLeaderApi & import("@solana/kit").GetSlotLeadersApi & import("@solana/kit").GetStakeMinimumDelegationApi & import("@solana/kit").GetSupplyApi & import("@solana/kit").GetTokenAccountBalanceApi & import("@solana/kit").GetTokenAccountsByDelegateApi & import("@solana/kit").GetTokenAccountsByOwnerApi & import("@solana/kit").GetTokenLargestAccountsApi & import("@solana/kit").GetTokenSupplyApi & import("@solana/kit").GetTransactionApi & import("@solana/kit").GetTransactionCountApi & import("@solana/kit").GetVersionApi & import("@solana/kit").GetVoteAccountsApi & import("@solana/kit").IsBlockhashValidApi & import("@solana/kit").MinimumLedgerSlotApi & import("@solana/kit").SendTransactionApi & import("@solana/kit").SimulateTransactionApi>;
 } & {
+    kora: {
+        estimateBundleFee(request: import("../types/index.js").EstimateBundleFeeRequest): Promise<import("../types/index.js").KitEstimateBundleFeeResponse>;
+        estimateTransactionFee(request: import("../types/index.js").EstimateTransactionFeeRequest): Promise<import("../types/index.js").KitEstimateFeeResponse>;
+        getBlockhash(): Promise<import("../types/index.js").KitBlockhashResponse>;
+        getConfig(): Promise<import("../types/index.js").KitConfigResponse>;
+        getPayerSigner(): Promise<import("../types/index.js").KitPayerSignerResponse>;
+        getPaymentInstruction(request: import("../types/index.js").GetPaymentInstructionRequest): Promise<import("../types/index.js").KitPaymentInstructionResponse>;
+        getSupportedTokens(): Promise<import("../types/index.js").KitSupportedTokensResponse>;
+        getVersion(): Promise<import("../types/index.js").GetVersionResponse>;
+        signAndSendBundle(request: import("../types/index.js").SignAndSendBundleRequest): Promise<import("../types/index.js").KitSignAndSendBundleResponse>;
+        signAndSendTransaction(request: import("../types/index.js").SignAndSendTransactionRequest): Promise<import("../types/index.js").KitSignAndSendTransactionResponse>;
+        signBundle(request: import("../types/index.js").SignBundleRequest): Promise<import("../types/index.js").KitSignBundleResponse>;
+        signTransaction(request: import("../types/index.js").SignTransactionRequest): Promise<import("../types/index.js").KitSignTransactionResponse>;
+    };
+} & {
+    paymentAddress: import("@solana/kit").Address | undefined;
+}, "transactionPlanner"> & {
+    transactionPlanner: import("@solana/kit").TransactionPlanner;
+}, "transactionPlanExecutor"> & {
     transactionPlanExecutor: import("@solana/kit").TransactionPlanExecutor;
-}>>;
+}, keyof import("@solana/kit").ClientWithTransactionPlanning | keyof import("@solana/kit").ClientWithTransactionSending> & import("@solana/kit").ClientWithTransactionPlanning & import("@solana/kit").ClientWithTransactionSending>>;

package/dist/src/kit/index.js

@@ -1,7 +1,7 @@
-import { address, createEmptyClient, createNoopSigner, createSolanaRpc } from '@solana/kit';
+import { address, createClient, createNoopSigner, createSolanaRpc, pipe } from '@solana/kit';
 import { planAndSendTransactions, transactionPlanExecutor as transactionPlanExecutorPlugin, transactionPlanner as transactionPlannerPlugin, } from '@solana/kit-plugin-instruction-plan';
-import { payer } from '@solana/kit-plugin-payer';
-import { rpc } from '@solana/kit-plugin-rpc';
+import { solanaRpcConnection } from '@solana/kit-plugin-rpc';
+import { identity, payer } from '@solana/kit-plugin-signer';
 import { estimateAndUpdateProvisoryComputeUnitLimitFactory, estimateComputeUnitLimitFactory, } from '@solana-program/compute-budget';
 import { KoraClient } from '../client.js';
 import { koraPlugin } from '../plugin.js';
@@ -9,67 +9,89 @@ import { createKoraTransactionPlanExecutor } from './executor.js';
 import { buildPlaceholderPaymentInstruction, koraPaymentAddress } from './payment.js';
 import { buildComputeBudgetInstructions, createKoraTransactionPlanner } from './planner.js';
 /**
- * Creates a Kora Kit client composed from Kit plugins.
+ * Kora bundle plugin.
+ *
+ * Composes RPC + payer + Kora RPC methods + transaction planning/execution into a single
+ * plugin that mirrors the shape of `solanaRpc` from `@solana/kit-plugin-rpc`.
  *
- * The returned client satisfies `ClientWithPayer`, `ClientWithTransactionPlanning`,
- * and `ClientWithTransactionSending`, making it composable with Kit program plugins.
+ * The caller's signer is read from `client.identity` — install `identity()` (or `signer()`)
+ * from `@solana/kit-plugin-signer` before this plugin. The fee payer (Kora's address) is
+ * fetched from the Kora node and installed internally as a noop signer, overriding any
+ * `payer` already on the client.
  *
  * @beta This API is experimental and may change in future releases.
  *
  * @example
- * ```typescript
- * import { createKitKoraClient } from '@solana/kora';
- * import { address } from '@solana/kit';
+ * ```ts
+ * import { createClient } from '@solana/kit';
+ * import { identity } from '@solana/kit-plugin-signer';
+ * import { kora } from '@solana/kora';
+ *
+ * const client = await createClient()
+ *   .use(identity(userSigner))
+ *   .use(kora({
+ *     endpoint: 'https://kora.example.com',
+ *     rpcUrl: 'https://api.mainnet-beta.solana.com',
+ *     feeToken: address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
+ *   }));
+ *
+ * const signature = await client.sendTransaction([myInstruction]);
+ * ```
+ */
+export function kora(config) {
+    return async (client) => {
+        const koraClient = new KoraClient({
+            apiKey: config.apiKey,
+            getRecaptchaToken: config.getRecaptchaToken,
+            hmacSecret: config.hmacSecret,
+            rpcUrl: config.endpoint,
+        });
+        const { signer_address, payment_address } = await koraClient.getPayerSigner();
+        const paymentAddr = payment_address ? address(payment_address) : undefined;
+        const payerSigner = createNoopSigner(address(signer_address));
+        const computeBudgetIxs = buildComputeBudgetInstructions(config);
+        const solanaRpc = createSolanaRpc(config.rpcUrl);
+        const hasCuEstimation = config.computeUnitLimit === undefined;
+        const resolveProvisoryComputeUnitLimit = hasCuEstimation
+            ? estimateAndUpdateProvisoryComputeUnitLimitFactory(estimateComputeUnitLimitFactory({ rpc: solanaRpc }))
+            : undefined;
+        const userSigner = client.identity;
+        const payment = paymentAddr
+            ? await buildPlaceholderPaymentInstruction(userSigner, paymentAddr, config.feeToken, config.tokenProgramId)
+            : undefined;
+        const koraTransactionPlanner = createKoraTransactionPlanner(payerSigner, computeBudgetIxs, payment?.instruction, hasCuEstimation);
+        const koraTransactionPlanExecutor = createKoraTransactionPlanExecutor(koraClient, config, userSigner, payerSigner, payment
+            ? {
+                destinationTokenAccount: payment.destinationTokenAccount,
+                sourceTokenAccount: payment.sourceTokenAccount,
+            }
+            : undefined, resolveProvisoryComputeUnitLimit);
+        return pipe(client, payer(payerSigner), solanaRpcConnection(config.rpcUrl), koraPlugin({
+            endpoint: config.endpoint,
+            koraClient,
+        }), koraPaymentAddress(paymentAddr), transactionPlannerPlugin(koraTransactionPlanner), transactionPlanExecutorPlugin(koraTransactionPlanExecutor), planAndSendTransactions());
+    };
+}
+/**
+ * Creates a Kora Kit client composed from Kit plugins.
+ *
+ * @beta This API is experimental and may change in future releases.
  *
- * const client = await createKitKoraClient({
- *   endpoint: 'https://kora.example.com',
- *   rpcUrl: 'https://api.mainnet-beta.solana.com',
- *   feeToken: address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
- *   feePayerWallet: userSigner,
- * });
+ * @deprecated Compose with the {@link kora} plugin instead:
+ * ```ts
+ * import { createClient } from '@solana/kit';
+ * import { identity } from '@solana/kit-plugin-signer';
+ * import { kora } from '@solana/kora';
  *
- * const result = await client.sendTransaction([myInstruction]);
+ * const client = await createClient()
+ *   .use(identity(userSigner))
+ *   .use(kora({ endpoint, rpcUrl, feeToken }));
  * ```
+ * Will be removed in 0.4.0.
  */
 // TODO: Bundle support — the plan/execute pipeline currently handles single transactions only.
 // For Jito bundles, users must manually encode transactions and call `client.kora.signAndSendBundle()`.
-// A future `createKitKoraBundleClient` (or a bundle-aware executor plugin) could extend this to
-// plan multiple transaction messages and submit them as a single bundle.
 export async function createKitKoraClient(config) {
-    const koraClient = new KoraClient({
-        apiKey: config.apiKey,
-        getRecaptchaToken: config.getRecaptchaToken,
-        hmacSecret: config.hmacSecret,
-        rpcUrl: config.endpoint,
-    });
-    const { signer_address, payment_address } = await koraClient.getPayerSigner();
-    const paymentAddr = payment_address ? address(payment_address) : undefined;
-    const payerSigner = createNoopSigner(address(signer_address));
-    const computeBudgetIxs = buildComputeBudgetInstructions(config);
-    const solanaRpc = createSolanaRpc(config.rpcUrl);
-    const hasCuEstimation = config.computeUnitLimit === undefined;
-    const resolveProvisoryComputeUnitLimit = hasCuEstimation
-        ? estimateAndUpdateProvisoryComputeUnitLimitFactory(estimateComputeUnitLimitFactory({ rpc: solanaRpc }))
-        : undefined;
-    const payment = paymentAddr
-        ? await buildPlaceholderPaymentInstruction(config.feePayerWallet, paymentAddr, config.feeToken, config.tokenProgramId)
-        : undefined;
-    const koraTransactionPlanner = createKoraTransactionPlanner(payerSigner, computeBudgetIxs, payment?.instruction, hasCuEstimation);
-    const koraTransactionPlanExecutor = createKoraTransactionPlanExecutor(koraClient, config, payerSigner, payment
-        ? {
-            destinationTokenAccount: payment.destinationTokenAccount,
-            sourceTokenAccount: payment.sourceTokenAccount,
-        }
-        : undefined, resolveProvisoryComputeUnitLimit);
-    return createEmptyClient()
-        .use(rpc(config.rpcUrl))
-        .use(koraPlugin({
-        endpoint: config.endpoint,
-        koraClient,
-    }))
-        .use(payer(payerSigner))
-        .use(koraPaymentAddress(paymentAddr))
-        .use(transactionPlannerPlugin(koraTransactionPlanner))
-        .use(transactionPlanExecutorPlugin(koraTransactionPlanExecutor))
-        .use(planAndSendTransactions());
+    const { feePayerWallet, ...bundleConfig } = config;
+    return await createClient().use(identity(feePayerWallet)).use(kora(bundleConfig));
 }

package/dist/src/kit/planner.d.ts

@@ -1,4 +1,4 @@
 import { type Instruction, type TransactionSigner } from '@solana/kit';
-import type { KoraKitClientConfig } from '../types/index.js';
-export declare function buildComputeBudgetInstructions(config: KoraKitClientConfig): Instruction[];
+import type { KoraBundleConfig } from '../types/index.js';
+export declare function buildComputeBudgetInstructions(config: KoraBundleConfig): Instruction[];
 export declare function createKoraTransactionPlanner(payerSigner: TransactionSigner, computeBudgetIxs: Instruction[], paymentInstruction: Instruction | undefined, hasCuEstimation: boolean): import("@solana/kit").TransactionPlanner;

package/dist/src/plugin.d.ts

@@ -4,7 +4,7 @@ import type { EstimateBundleFeeRequest, EstimateTransactionFeeRequest, GetPaymen
  *
  * The plugin exposes all Kora RPC methods with Kit-typed responses (Address, Blockhash).
  *
- * **Note:** The plugin pattern with `createEmptyClient().use()` requires `@solana/kit` v5.4.0+.
+ * **Note:** The plugin pattern with `createClient().use()` requires `@solana/kit` v6.8.0+.
  * For older kit versions, use `KoraClient` directly instead.
  *
  * @param config - Plugin configuration
@@ -15,10 +15,10 @@ import type { EstimateBundleFeeRequest, EstimateTransactionFeeRequest, GetPaymen
  *
  * @example
  * ```typescript
- * import { createEmptyClient } from '@solana/kit';
+ * import { createClient } from '@solana/kit';
  * import { koraPlugin } from '@solana/kora';
  *
- * const client = createEmptyClient()
+ * const client = createClient()
  *   .use(koraPlugin({ endpoint: 'https://kora.example.com' }));
  *
  * // All responses have Kit-typed fields

package/dist/src/plugin.js

@@ -5,7 +5,7 @@ import { KoraClient } from './client.js';
  *
  * The plugin exposes all Kora RPC methods with Kit-typed responses (Address, Blockhash).
  *
- * **Note:** The plugin pattern with `createEmptyClient().use()` requires `@solana/kit` v5.4.0+.
+ * **Note:** The plugin pattern with `createClient().use()` requires `@solana/kit` v6.8.0+.
  * For older kit versions, use `KoraClient` directly instead.
  *
  * @param config - Plugin configuration
@@ -16,10 +16,10 @@ import { KoraClient } from './client.js';
  *
  * @example
  * ```typescript
- * import { createEmptyClient } from '@solana/kit';
+ * import { createClient } from '@solana/kit';
  * import { koraPlugin } from '@solana/kora';
  *
- * const client = createEmptyClient()
+ * const client = createClient()
  *   .use(koraPlugin({ endpoint: 'https://kora.example.com' }));
  *
  * // All responses have Kit-typed fields
@@ -84,7 +84,9 @@ export function koraPlugin(config) {
                     fee_payers: result.fee_payers.map(addr => address(addr)),
                     validation_config: {
                         ...result.validation_config,
-                        allowed_programs: result.validation_config.allowed_programs.map(addr => address(addr)),
+                        allowed_programs: Array.isArray(result.validation_config.allowed_programs)
+                            ? result.validation_config.allowed_programs.map(addr => address(addr))
+                            : result.validation_config.allowed_programs,
                         allowed_spl_paid_tokens: result.validation_config.allowed_spl_paid_tokens.map(addr => address(addr)),
                         allowed_tokens: result.validation_config.allowed_tokens.map(addr => address(addr)),
                         disallowed_accounts: result.validation_config.disallowed_accounts.map(addr => address(addr)),

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

@@ -15,10 +15,20 @@ export interface SignTransactionRequest {
     /** Optional user ID for usage tracking (required when pricing is free and usage tracking is enabled) */
     user_id?: string;
 }
+/**
+ * The transaction lifecycle milestone the server waits for before responding,
+ * ordered by increasing assurance: `signed` < `sent` < `confirmed`:
+ * - `confirmed`: wait for on-chain confirmation (default)
+ * - `sent`: return once the RPC node accepts the transaction
+ * - `signed`: return as soon as signing completes and broadcast in the background
+ */
+export type RespondAfter = 'confirmed' | 'sent' | 'signed';
 /**
  * Parameters for signing and sending a transaction.
  */
 export interface SignAndSendTransactionRequest {
+    /** Optional milestone to wait for before responding (defaults to "confirmed") */
+    respond_after?: RespondAfter;
     /** Optional signer verification during transaction simulation (defaults to false) */
     sig_verify?: boolean;
     /** Optional signer address for the transaction */
@@ -234,8 +244,8 @@ export type PriceSource = 'Jupiter' | 'Mock';
  * Validation configuration for the Kora server.
  */
 export interface ValidationConfig {
-    /** List of allowed Solana program IDs */
-    allowed_programs: string[];
+    /** List of allowed Solana program IDs, or "All" to allow any program. */
+    allowed_programs: 'All' | string[];
     /** List of SPL tokens accepted for paid transactions */
     allowed_spl_paid_tokens: string[];
     /** List of allowed token mint addresses for fee payment */
@@ -430,6 +440,10 @@ export interface FeePayerPolicy {
 export interface RpcError {
     /** Error code */
     code: number;
+    /** Optional structured data about the error */
+    data?: {
+        error_type: string;
+    };
     /** Human-readable error message */
     message: string;
 }
@@ -598,8 +612,8 @@ export interface KitSignAndSendBundleResponse {
 }
 /** Plugin validation config with Kit Address types */
 export interface KitValidationConfig {
-    /** List of allowed Solana program IDs */
-    allowed_programs: Address[];
+    /** List of allowed Solana program IDs, or "All" to allow any program. */
+    allowed_programs: 'All' | Address[];
     /** List of SPL tokens accepted for paid transactions */
     allowed_spl_paid_tokens: Address[];
     /** List of allowed token mint addresses for fee payment */
@@ -622,13 +636,17 @@ export interface KitValidationConfig {
 /**
  * Kit Client Types
  */
-/** Configuration for {@link createKitKoraClient}. */
-export interface KoraKitClientConfig {
+/**
+ * Configuration for the {@link kora} bundle plugin.
+ *
+ * The user's signer is read from `client.identity` (set via `identity()` from
+ * `@solana/kit-plugin-signer`), so this config intentionally omits any signer field.
+ */
+export interface KoraBundleConfig {
     readonly apiKey?: string;
     readonly computeUnitLimit?: number;
     readonly computeUnitPrice?: MicroLamports;
     readonly endpoint: string;
-    readonly feePayerWallet: TransactionSigner;
     readonly feeToken: Address;
     readonly getRecaptchaToken?: () => Promise<string> | string;
     readonly hmacSecret?: string;
@@ -636,3 +654,11 @@ export interface KoraKitClientConfig {
     readonly tokenProgramId?: Address;
     readonly userId?: string;
 }
+/**
+ * Configuration for {@link createKitKoraClient}.
+ *
+ * @deprecated Use {@link KoraBundleConfig} with the {@link kora} plugin instead.
+ */
+export interface KoraKitClientConfig extends KoraBundleConfig {
+    readonly feePayerWallet: TransactionSigner;
+}

package/dist/test/integration.test.js

@@ -1,7 +1,8 @@
-import { address, appendTransactionMessageInstruction, compileTransaction, createTransactionMessage, getBase64Decoder, getBase64EncodedWireTransaction, getBase64Encoder, getTransactionDecoder, getTransactionEncoder, partiallySignTransaction, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, } from '@solana/kit';
+import { address, appendTransactionMessageInstruction, compileTransaction, createClient, createTransactionMessage, getBase64Decoder, getBase64EncodedWireTransaction, getBase64Encoder, getTransactionDecoder, getTransactionEncoder, partiallySignTransaction, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, } from '@solana/kit';
+import { identity } from '@solana/kit-plugin-signer';
 import { getTransferSolInstruction } from '@solana-program/system';
-import { findAssociatedTokenPda, getTransferInstruction, TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
-import { createKitKoraClient } from '../src/index.js';
+import { findAssociatedTokenPda, getTransferInstruction, TOKEN_PROGRAM_ADDRESS, tokenProgram, } from '@solana-program/token';
+import { kora } from '../src/kit/index.js';
 import { runAuthenticationTests } from './auth-setup.js';
 import setupTestSuite from './setup.js';
 function transactionFromBase64(base64) {
@@ -215,7 +216,7 @@ describe(`KoraClient Integration Tests (${AUTH_ENABLED ? 'with auth' : 'without
             expect(signResult).toBeDefined();
             expect(signResult.signed_transaction).toBeDefined();
             expect(signResult.signature).toBeDefined();
-        });
+        }, 30000);
         it('should get payment instruction', async () => {
             const { transaction } = await buildTokenTransferTransaction({
                 amount: 1000000n,
@@ -319,7 +320,7 @@ describe(`KoraClient Integration Tests (${AUTH_ENABLED ? 'with auth' : 'without
             expect(result.signer_pubkey).toBeDefined();
             expect(result.bundle_uuid).toBeDefined();
             expect(typeof result.bundle_uuid).toBe('string');
-        });
+        }, 30000);
     });
     describe('Error Handling', () => {
         it('should handle invalid transaction for signing', async () => {
@@ -334,14 +335,18 @@ describe(`KoraClient Integration Tests (${AUTH_ENABLED ? 'with auth' : 'without
     if (FREE_PRICING) {
         describe('Kit Client (free pricing)', () => {
             let freeClient;
-            beforeAll(async () => {
+            async function buildFreeClient() {
                 const koraRpcUrl = process.env.KORA_RPC_URL || 'http://127.0.0.1:8080';
-                freeClient = await createKitKoraClient({
+                return createClient()
+                    .use(identity(testWallet))
+                    .use(kora({
                     endpoint: koraRpcUrl,
                     rpcUrl: process.env.SOLANA_RPC_URL || 'http://127.0.0.1:8899',
                     feeToken: usdcMint,
-                    feePayerWallet: testWallet,
-                });
+                }));
+            }
+            beforeAll(async () => {
+                freeClient = await buildFreeClient();
             }, 30000);
             it('should send transaction without payment instruction when fee is 0', async () => {
                 const ix = getTransferSolInstruction({
@@ -364,4 +369,47 @@ describe(`KoraClient Integration Tests (${AUTH_ENABLED ? 'with auth' : 'without
             }, 30000);
         });
     }
+    (FREE_PRICING ? describe.skip : describe)('Kit Client (standard pricing)', () => {
+        let paidClient;
+        async function buildPaidClient() {
+            const koraRpcUrl = process.env.KORA_RPC_URL || 'http://127.0.0.1:8080';
+            return createClient()
+                .use(identity(testWallet))
+                .use(kora({
+                endpoint: koraRpcUrl,
+                rpcUrl: process.env.SOLANA_RPC_URL || 'http://127.0.0.1:8899',
+                feeToken: usdcMint,
+                ...(AUTH_ENABLED && {
+                    apiKey: process.env.KORA_API_KEY || 'test-api-key-123',
+                    hmacSecret: process.env.KORA_HMAC_SECRET || 'test-hmac-secret-456',
+                }),
+            }))
+                .use(tokenProgram());
+        }
+        beforeAll(async () => {
+            paidClient = await buildPaidClient();
+        }, 30000);
+        it('should send SPL token transfer with paid fee via kit client', async () => {
+            const [sourceAta] = await findAssociatedTokenPda({
+                mint: usdcMint,
+                owner: testWallet.address,
+                tokenProgram: TOKEN_PROGRAM_ADDRESS,
+            });
+            const [destinationAta] = await findAssociatedTokenPda({
+                mint: usdcMint,
+                owner: koraAddress,
+                tokenProgram: TOKEN_PROGRAM_ADDRESS,
+            });
+            const result = await paidClient.token.instructions
+                .transfer({
+                amount: 1000000n,
+                authority: testWallet,
+                destination: destinationAta,
+                source: sourceAta,
+            })
+                .sendTransaction();
+            expect(result.status).toBe('successful');
+            expect(result.context.signature).toBeDefined();
+        }, 30000);
+    });
 });

package/dist/test/kit-client.test.js

@@ -1,5 +1,6 @@
-import { createKitKoraClient } from '../src/kit/index.js';
-import { address, createNoopSigner } from '@solana/kit';
+import { createKitKoraClient, kora } from '../src/kit/index.js';
+import { address, createClient, createNoopSigner } from '@solana/kit';
+import { identity, signer } from '@solana/kit-plugin-signer';
 // Mock fetch globally
 const mockFetch = jest.fn();
 global.fetch = mockFetch;
@@ -80,7 +81,7 @@ describe('createKitKoraClient', () => {
                 rpcUrl: MOCK_RPC_URL,
                 feeToken: MOCK_FEE_TOKEN,
                 feePayerWallet: MOCK_WALLET,
-            })).rejects.toThrow('RPC Error -32000: Server error');
+            })).rejects.toThrow('Kora Error -32000: Server error');
         });
         it('should expose kora namespace for raw RPC access', async () => {
             mockRpcResponse({
@@ -489,3 +490,47 @@ describe('createKitKoraClient', () => {
         });
     });
 });
+describe('kora() bundle plugin', () => {
+    beforeEach(() => {
+        mockFetch.mockClear();
+    });
+    afterEach(() => {
+        jest.resetAllMocks();
+    });
+    it('composes with identity() and exposes the same surface as the wrapper', async () => {
+        mockRpcResponse({
+            signer_address: MOCK_PAYER_ADDRESS,
+            payment_address: MOCK_PAYMENT_ADDRESS,
+        });
+        const client = await createClient()
+            .use(identity(MOCK_WALLET))
+            .use(kora({
+            endpoint: MOCK_ENDPOINT,
+            rpcUrl: MOCK_RPC_URL,
+            feeToken: MOCK_FEE_TOKEN,
+        }));
+        expect(client.identity.address).toBe(MOCK_WALLET_ADDRESS);
+        expect(client.payer.address).toBe(MOCK_PAYER_ADDRESS);
+        expect(client.paymentAddress).toBe(MOCK_PAYMENT_ADDRESS);
+        expect(typeof client.sendTransaction).toBe('function');
+        expect(typeof client.planTransaction).toBe('function');
+        expect(client.kora).toBeDefined();
+    });
+    // TODO: re-enable once @solana/kit supports overriding an already-set field on an
+    // extended client.
+    it.skip('overrides client.payer when the caller used signer() (sets identity + payer)', async () => {
+        mockRpcResponse({
+            signer_address: MOCK_PAYER_ADDRESS,
+            payment_address: MOCK_PAYMENT_ADDRESS,
+        });
+        const client = await createClient()
+            .use(signer(MOCK_WALLET))
+            .use(kora({
+            endpoint: MOCK_ENDPOINT,
+            rpcUrl: MOCK_RPC_URL,
+            feeToken: MOCK_FEE_TOKEN,
+        }));
+        expect(client.identity.address).toBe(MOCK_WALLET_ADDRESS);
+        expect(client.payer.address).toBe(MOCK_PAYER_ADDRESS);
+    });
+});

package/dist/test/plugin.test.js

@@ -1,4 +1,4 @@
-import { createEmptyClient } from '@solana/kit';
+import { createClient } from '@solana/kit';
 import { koraPlugin } from '../src/plugin.js';
 // Mock fetch globally
 const mockFetch = jest.fn();
@@ -149,6 +149,41 @@ describe('Kora Kit Plugin', () => {
                 expect(result.validation_config.allowed_tokens).toHaveLength(1);
                 expect(result.validation_config.allowed_tokens[0]).toBe('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
             });
+            it('should pass through the "All" wildcard for allowed_programs without crashing', async () => {
+                // Regression: ProgramsConfig::All serializes as the string "All" on the wire,
+                // which would crash the kit wrapper if it called .map() unconditionally.
+                const rawResponse = {
+                    enabled_methods: {
+                        estimate_transaction_fee: true,
+                        get_blockhash: true,
+                        get_config: true,
+                        get_supported_tokens: true,
+                        liveness: true,
+                        sign_and_send_transaction: true,
+                        sign_transaction: true,
+                        transfer_transaction: true,
+                    },
+                    fee_payers: ['DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7'],
+                    validation_config: {
+                        allowed_programs: 'All',
+                        allowed_spl_paid_tokens: [],
+                        allowed_tokens: [],
+                        disallowed_accounts: [],
+                        fee_payer_policy: {},
+                        max_allowed_lamports: 1000000,
+                        max_signatures: 10,
+                        price: { margin: 0.1, type: 'margin' },
+                        price_source: 'Jupiter',
+                        token2022: {
+                            blocked_account_extensions: [],
+                            blocked_mint_extensions: [],
+                        },
+                    },
+                };
+                mockSuccessfulResponse(rawResponse);
+                const result = await kora.getConfig();
+                expect(result.validation_config.allowed_programs).toBe('All');
+            });
         });
         describe('getPayerSigner', () => {
             it('should return Kit-typed Address fields', async () => {
@@ -366,7 +401,7 @@ describe('Kora Kit Plugin', () => {
         });
         it('should propagate RPC errors', async () => {
             mockErrorResponse({ code: -32601, message: 'Method not found' });
-            await expect(kora.getConfig()).rejects.toThrow('RPC Error -32601: Method not found');
+            await expect(kora.getConfig()).rejects.toThrow('Kora Error -32601: Method not found');
         });
         it('should propagate network errors', async () => {
             mockFetch.mockRejectedValueOnce(new Error('Network error'));
@@ -383,14 +418,14 @@ describe('Kora Kit Plugin', () => {
             expect(api).toBeDefined();
         });
     });
-    describe('createEmptyClient Integration', () => {
+    describe('createClient Integration', () => {
         it('should initialize kora property on Kit client', () => {
-            const client = createEmptyClient().use(koraPlugin(mockConfig));
+            const client = createClient().use(koraPlugin(mockConfig));
             expect(client).toHaveProperty('kora');
             expect(client.kora).toBeDefined();
         });
         it('should expose all Kora RPC methods', () => {
-            const client = createEmptyClient().use(koraPlugin(mockConfig));
+            const client = createClient().use(koraPlugin(mockConfig));
             expect(typeof client.kora.getConfig).toBe('function');
             expect(typeof client.kora.getPayerSigner).toBe('function');
             expect(typeof client.kora.getBlockhash).toBe('function');
@@ -410,7 +445,7 @@ describe('Kora Kit Plugin', () => {
                 endpoint: mockEndpoint,
                 hmacSecret: 'test-hmac-secret',
             };
-            const client = createEmptyClient().use(koraPlugin(authConfig));
+            const client = createClient().use(koraPlugin(authConfig));
             expect(client.kora).toBeDefined();
             expect(typeof client.kora.getConfig).toBe('function');
         });
@@ -420,7 +455,7 @@ describe('Kora Kit Plugin', () => {
                 ...c,
                 other: { foo: () => 'bar' },
             });
-            const client = createEmptyClient().use(koraPlugin(mockConfig)).use(otherPlugin);
+            const client = createClient().use(koraPlugin(mockConfig)).use(otherPlugin);
             // Both plugins should be available
             expect(client.kora).toBeDefined();
             expect(client.other).toBeDefined();
@@ -433,7 +468,7 @@ describe('Kora Kit Plugin', () => {
                 signer_address: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
             };
             mockSuccessfulResponse(mockResponse);
-            const client = createEmptyClient().use(koraPlugin(mockConfig));
+            const client = createClient().use(koraPlugin(mockConfig));
             const result = await client.kora.getPayerSigner();
             expect(result.signer_address).toBe('DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7');
             expect(result.payment_address).toBe('PayKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7');

package/dist/test/setup.js

@@ -1,10 +1,25 @@
-import { assertIsAddress, createKeyPairSignerFromBytes, getBase58Encoder, lamports, } from '@solana/kit';
-import { createClient } from '@solana/kit-client-litesvm';
+import { assertIsAddress, createClient, createKeyPairSignerFromBytes, getBase58Encoder, lamports, } from '@solana/kit';
+import { litesvm } from '@solana/kit-plugin-litesvm';
+import { payer } from '@solana/kit-plugin-signer';
 import { tokenProgram, associatedTokenProgram } from '@solana-program/token';
 import { config } from 'dotenv';
 import path from 'path';
 import { KoraClient } from '../src/index.js';
 config({ path: path.resolve(process.cwd(), '.env') });
+// Each suite flavor (basic / auth / free) runs concurrently against the same
+// validator. Flavors use distinct wallets (funded by the rust test setup) so
+// they never submit byte-identical transactions, which the validator
+// deduplicates by signature.
+// DO NOT USE THESE KEYPAIRS IN PRODUCTION, TESTING KEYPAIRS ONLY
+const FLAVOR_WALLET_SECRETS = {
+    // 7kBPazc3KfccwopUa9dALgeBSXoYjdqtK5UEpXKCAYYH
+    auth: '5mDdF4AakwdsEMVKxQ566CNa4bxdqZCEfpWLz9HYWYt1ZjL48HAL8Q3p7ba4nJNUe8QpWrWh5n9kwLKegZm2J7vy',
+    // HhA5j2rRiPbMrpF2ZD36r69FyZf3zWmEHRNSZbbNdVjf
+    basic: 'tzgfgSWTE3KUA6qfRoFYLaSfJm59uUeZRDy4ybMrLn1JV2drA1mftiaEcVFvq1Lok6h6EX2C4Y9kSKLvQWyMpS5',
+    // HrQpAeuWRcajWzJ3FSe5UApiSX2Pp2nNdBDj7eZx4yCo
+    free: '4y8NiNNW9fLaaVVDAVxvUCobTXMTpKcZDSdwUidiYXVS8SPVTRg9hGbgUK4Tsp7vrQTK8kw4fJ1LUeHFFnthaFzB',
+};
+const SUITE_FLAVOR = process.env.ENABLE_AUTH === 'true' ? 'auth' : process.env.FREE_PRICING === 'true' ? 'free' : 'basic';
 const DEFAULTS = {
     DECIMALS: 6,
     // Make sure this matches the USDC mint in kora.toml (9BgeTKqmFsPVnfYscfM6NvsgmZxei7XfdciShQ6D3bxJ)
@@ -13,10 +28,8 @@ const DEFAULTS = {
     KORA_ADDRESS: '7AqpcUvgJ7Kh1VmJZ44rWp2XDow33vswo9VK9VqpPU2d',
     KORA_RPC_URL: 'http://localhost:8080/',
     KORA_SIGNER_TYPE: 'memory',
-    // Make sure this matches the kora-rpc signer address on launch (root .env)
-    SENDER_SECRET: 'tzgfgSWTE3KUA6qfRoFYLaSfJm59uUeZRDy4ybMrLn1JV2drA1mftiaEcVFvq1Lok6h6EX2C4Y9kSKLvQWyMpS5',
     SOL_DROP_AMOUNT: 1_000_000_000,
-    // HhA5j2rRiPbMrpF2ZD36r69FyZf3zWmEHRNSZbbNdVjf
+    // 9BgeTKqmFsPVnfYscfM6NvsgmZxei7XfdciShQ6D3bxJ
     TEST_USDC_MINT_SECRET: '59kKmXphL5UJANqpFFjtH17emEq3oRNmYsx6a3P3vSGJRmhMgVdzH77bkNEi9bArRViT45e8L2TsuPxKNFoc3Qfg',
     TOKEN_DROP_AMOUNT: 100_000, // Default signer type
 };
@@ -43,6 +56,12 @@ export function loadEnvironmentVariables() {
                     throw new Error('PRIVY_PUBLIC_KEY must be set when using Privy signer');
                 }
                 break;
+            case 'openfort':
+                koraAddress = process.env.OPENFORT_PUBLIC_KEY;
+                if (!koraAddress) {
+                    throw new Error('OPENFORT_PUBLIC_KEY must be set when using Openfort signer');
+                }
+                break;
             case 'memory':
             default:
                 koraAddress = DEFAULTS.KORA_ADDRESS;
@@ -53,7 +72,7 @@ export function loadEnvironmentVariables() {
     const tokenDecimals = Number(process.env.TOKEN_DECIMALS || DEFAULTS.DECIMALS);
     const tokenDropAmount = Number(process.env.TOKEN_DROP_AMOUNT || DEFAULTS.TOKEN_DROP_AMOUNT);
     const solDropAmount = BigInt(process.env.SOL_DROP_AMOUNT || DEFAULTS.SOL_DROP_AMOUNT);
-    const testWalletSecret = process.env.SENDER_SECRET || DEFAULTS.SENDER_SECRET;
+    const testWalletSecret = process.env.SENDER_SECRET || FLAVOR_WALLET_SECRETS[SUITE_FLAVOR];
     const testUsdcMintSecret = process.env.TEST_USDC_MINT_SECRET || DEFAULTS.TEST_USDC_MINT_SECRET;
     const destinationAddress = process.env.DESTINATION_ADDRESS || DEFAULTS.DESTINATION_ADDRESS;
     assertIsAddress(destinationAddress);
@@ -89,7 +108,11 @@ async function setupTestSuite() {
         }
         : undefined;
     const { testWallet, usdcMint, destinationAddress } = await createKeyPairSigners();
-    const client = await createClient({ payer: testWallet }).use(tokenProgram()).use(associatedTokenProgram());
+    const client = await createClient()
+        .use(payer(testWallet))
+        .use(litesvm())
+        .use(tokenProgram())
+        .use(associatedTokenProgram());
     // Airdrop SOL via LiteSVM
     await client.airdrop(koraAddress, lamports(solDropAmount));
     await client.airdrop(testWallet.address, lamports(solDropAmount));

package/dist/test/unit.test.js

@@ -1,6 +1,7 @@
 import { getTransferInstruction, TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
 import { appendTransactionMessageInstructions, createNoopSigner, createTransactionMessage, generateKeyPairSigner, partiallySignTransactionMessageWithSigners, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, } from '@solana/kit';
 import { KoraClient } from '../src/client.js';
+import { KoraError } from '../src/error.js';
 import { getInstructionsFromBase64Message } from '../src/utils/transaction.js';
 // Mock fetch globally
 const mockFetch = jest.fn();
@@ -69,7 +70,7 @@ describe('KoraClient Unit Tests', () => {
         it('should handle RPC error responses', async () => {
             const mockError = { code: -32601, message: 'Method not found' };
             mockErrorResponse(mockError);
-            await expect(client.getConfig()).rejects.toThrow('RPC Error -32601: Method not found');
+            await expect(client.getConfig()).rejects.toThrow('Kora Error -32601: Method not found');
         });
         it('should handle network errors', async () => {
             mockFetch.mockRejectedValueOnce(new Error('Network error'));
@@ -238,6 +239,18 @@ describe('KoraClient Unit Tests', () => {
             };
             await testSuccessfulRpcMethod('signAndSendTransaction', () => client.signAndSendTransaction(request), mockResponse, request);
         });
+        it('should pass the respond_after milestone through to the RPC request', async () => {
+            const request = {
+                transaction: 'base64_encoded_transaction',
+                respond_after: 'signed',
+            };
+            const mockResponse = {
+                signature: 'transaction_signature',
+                signed_transaction: 'base64_signed_transaction',
+                signer_pubkey: 'test_signer_pubkey',
+            };
+            await testSuccessfulRpcMethod('signAndSendTransaction', () => client.signAndSendTransaction(request), mockResponse, request);
+        });
     });
     describe('signBundle', () => {
         it('should sign bundle of transactions', async () => {
@@ -256,7 +269,7 @@ describe('KoraClient Unit Tests', () => {
             };
             const mockError = { code: -32000, message: 'Bundle validation failed' };
             mockErrorResponse(mockError);
-            await expect(client.signBundle(request)).rejects.toThrow('RPC Error -32000: Bundle validation failed');
+            await expect(client.signBundle(request)).rejects.toThrow('Kora Error -32000: Bundle validation failed');
         });
     });
     describe('signAndSendBundle', () => {
@@ -277,7 +290,7 @@ describe('KoraClient Unit Tests', () => {
             };
             const mockError = { code: -32000, message: 'Jito submission failed' };
             mockErrorResponse(mockError);
-            await expect(client.signAndSendBundle(request)).rejects.toThrow('RPC Error -32000: Jito submission failed');
+            await expect(client.signAndSendBundle(request)).rejects.toThrow('Kora Error -32000: Jito submission failed');
         });
     });
     describe('getPaymentInstruction', () => {
@@ -465,7 +478,7 @@ describe('KoraClient Unit Tests', () => {
                     jsonrpc: '2.0',
                 }),
             });
-            await expect(client.getPaymentInstruction(validRequest)).rejects.toThrow('RPC Error -32602: Invalid transaction');
+            await expect(client.getPaymentInstruction(validRequest)).rejects.toThrow('Kora Error -32602: Invalid transaction');
         });
         it('should handle network errors', async () => {
             mockFetch.mockRejectedValueOnce(new Error('Network error'));
@@ -564,11 +577,42 @@ describe('KoraClient Unit Tests', () => {
         it('should handle responses with an error object', async () => {
             const mockError = { code: -32602, message: 'Invalid params' };
             mockErrorResponse(mockError);
-            await expect(client.getConfig()).rejects.toThrow('RPC Error -32602: Invalid params');
+            await expect(client.getConfig()).rejects.toThrow('Kora Error -32602: Invalid params');
         });
-        it('should handle empty error object', async () => {
+        it('should handle empty error object gracefully', async () => {
             mockErrorResponse({});
-            await expect(client.getConfig()).rejects.toThrow('RPC Error undefined: undefined');
+            try {
+                await client.getConfig();
+                throw new Error('Should have thrown KoraError');
+            }
+            catch (e) {
+                expect(e).toBeInstanceOf(KoraError);
+                expect(e.code).toBe(-32603);
+                expect(e.message).toBe('Kora Error -32603: Unknown error');
+                expect(e.data).toBeUndefined();
+            }
+        });
+        it('should populate KoraError properties (code and data)', async () => {
+            const mockError = {
+                code: -32050,
+                data: {
+                    error_type: 'AccountNotFound',
+                },
+                message: 'Account not found message',
+            };
+            mockErrorResponse(mockError);
+            try {
+                await client.getConfig();
+                throw new Error('Should have thrown KoraError');
+            }
+            catch (e) {
+                expect(e).toBeInstanceOf(KoraError);
+                expect(e.code).toBe(-32050);
+                expect(e.data).toEqual({
+                    error_type: 'AccountNotFound',
+                });
+                expect(e.message).toBe('Kora Error -32050: Account not found message');
+            }
         });
     });
     describe('reCAPTCHA Authentication', () => {

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "@solana/kora",
-  "version": "0.3.0-beta.0",
+  "version": "0.3.0-beta.2",
   "description": "TypeScript SDK for Kora RPC",
   "main": "dist/src/index.js",
   "type": "module",
   "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./kit": {
+      "types": "./dist/src/kit/index.d.ts",
+      "default": "./dist/src/kit/index.js"
+    }
+  },
   "files": [
     "dist"
   ],
@@ -23,35 +33,35 @@
   },
   "peerDependencies": {
     "@solana-program/compute-budget": "^0.15.0",
-    "@solana-program/token": "^0.12.0",
-    "@solana/kit": "^6.3.0",
-    "@solana/kit-plugin-instruction-plan": "^0.7.0",
-    "@solana/kit-plugin-payer": "^0.6.0",
-    "@solana/kit-plugin-rpc": "^0.7.0"
+    "@solana-program/token": "^0.13.0",
+    "@solana/kit": "^6.8.0",
+    "@solana/kit-plugin-instruction-plan": "^0.10.0",
+    "@solana/kit-plugin-rpc": "^0.10.0",
+    "@solana/kit-plugin-signer": "^0.10.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.3",
+    "@eslint/js": "^10.0.1",
     "@solana-program/system": "^0.12.0",
     "@solana/eslint-config-solana": "6.0.0",
-    "@solana/kit-client-litesvm": "^0.7.0",
+    "@solana/kit-plugin-litesvm": "^0.10.0",
     "@solana/prettier-config-solana": "^0.0.6",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.17.27",
-    "dotenv": "^16.4.5",
-    "eslint": "^9.39.3",
-    "eslint-plugin-jest": "^29.15.0",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.1",
+    "dotenv": "^17.4.2",
+    "eslint": "^10.4.0",
+    "eslint-plugin-jest": "^29.15.2",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
     "eslint-plugin-sort-keys-fix": "^1.1.2",
     "eslint-plugin-typescript-sort-keys": "^3.3.0",
-    "globals": "^16.5.0",
-    "jest": "^29.7.0",
-    "prettier": "^3.2.5",
-    "ts-jest": "^29.1.2",
+    "globals": "^17.6.0",
+    "jest": "^30.4.2",
+    "prettier": "^3.8.3",
+    "ts-jest": "^29.4.9",
     "ts-node": "^10.9.2",
-    "typedoc": "^0.28.9",
-    "typedoc-plugin-markdown": "^4.8.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.1"
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.61.0"
   },
   "scripts": {
     "build": "tsc",
@@ -62,10 +72,11 @@
     "test:integration": "pnpm test integration.test.ts",
     "test:integration:auth": "ENABLE_AUTH=true pnpm test integration.test.ts",
     "test:integration:free": "FREE_PRICING=true pnpm test integration.test.ts",
+    "test:integration:openfort": "KORA_SIGNER_TYPE=openfort pnpm test integration.test.ts",
     "test:integration:privy": "KORA_SIGNER_TYPE=privy pnpm test integration.test.ts",
     "test:integration:turnkey": "KORA_SIGNER_TYPE=turnkey pnpm test integration.test.ts",
-    "test:unit": "pnpm test unit.test.ts",
-    "test:ci:unit": "jest test/unit.test.ts",
+    "test:unit": "pnpm test unit.test.ts kit-client.test.ts plugin.test.ts",
+    "test:ci:unit": "jest test/unit.test.ts test/kit-client.test.ts test/plugin.test.ts",
     "lint": "eslint src/",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",