@solana/kora 0.2.0-beta.1 → 0.2.0-beta.2

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import { Config, EstimateTransactionFeeRequest, EstimateTransactionFeeResponse, GetBlockhashResponse, GetSupportedTokensResponse, GetVersionResponse, SignAndSendTransactionRequest, SignAndSendTransactionResponse, SignTransactionRequest, SignTransactionResponse, SignBundleRequest, SignBundleResponse, SignAndSendBundleRequest, SignAndSendBundleResponse, TransferTransactionRequest, TransferTransactionResponse, KoraClientOptions, GetPayerSignerResponse, GetPaymentInstructionRequest, GetPaymentInstructionResponse } from './types/index.js';
+import { Config, EstimateTransactionFeeRequest, EstimateTransactionFeeResponse, EstimateBundleFeeRequest, EstimateBundleFeeResponse, GetBlockhashResponse, GetSupportedTokensResponse, GetVersionResponse, SignAndSendTransactionRequest, SignAndSendTransactionResponse, SignTransactionRequest, SignTransactionResponse, SignBundleRequest, SignBundleResponse, SignAndSendBundleRequest, SignAndSendBundleResponse, TransferTransactionRequest, TransferTransactionResponse, KoraClientOptions, GetPayerSignerResponse, GetPaymentInstructionRequest, GetPaymentInstructionResponse } from './types/index.js';
 /**
  * Kora RPC client for interacting with the Kora paymaster service.
  *
@@ -111,6 +111,25 @@ export declare class KoraClient {
      * ```
      */
     estimateTransactionFee(request: EstimateTransactionFeeRequest): Promise<EstimateTransactionFeeResponse>;
+    /**
+     * Estimates the bundle fee in both lamports and the specified token.
+     * @param request - Bundle fee estimation request parameters
+     * @param request.transactions - Array of base64-encoded transactions to estimate fees for
+     * @param request.fee_token - Mint address of the token to calculate fees in
+     * @returns Total fee amounts across all transactions in both lamports and the specified token
+     * @throws {Error} When the RPC call fails, the bundle is invalid, or the token is not supported
+     *
+     * @example
+     * ```typescript
+     * const fees = await client.estimateBundleFee({
+     *   transactions: ['base64EncodedTransaction1', 'base64EncodedTransaction2'],
+     *   fee_token: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC
+     * });
+     * console.log('Total fee in lamports:', fees.fee_in_lamports);
+     * console.log('Total fee in USDC:', fees.fee_in_token);
+     * ```
+     */
+    estimateBundleFee(request: EstimateBundleFeeRequest): Promise<EstimateBundleFeeResponse>;
     /**
      * Signs a transaction with the Kora fee payer without broadcasting it.
      * @param request - Sign request parameters

package/dist/src/client.js

@@ -167,6 +167,27 @@ export class KoraClient {
     async estimateTransactionFee(request) {
         return this.rpcRequest('estimateTransactionFee', request);
     }
+    /**
+     * Estimates the bundle fee in both lamports and the specified token.
+     * @param request - Bundle fee estimation request parameters
+     * @param request.transactions - Array of base64-encoded transactions to estimate fees for
+     * @param request.fee_token - Mint address of the token to calculate fees in
+     * @returns Total fee amounts across all transactions in both lamports and the specified token
+     * @throws {Error} When the RPC call fails, the bundle is invalid, or the token is not supported
+     *
+     * @example
+     * ```typescript
+     * const fees = await client.estimateBundleFee({
+     *   transactions: ['base64EncodedTransaction1', 'base64EncodedTransaction2'],
+     *   fee_token: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC
+     * });
+     * console.log('Total fee in lamports:', fees.fee_in_lamports);
+     * console.log('Total fee in USDC:', fees.fee_in_token);
+     * ```
+     */
+    async estimateBundleFee(request) {
+        return this.rpcRequest('estimateBundleFee', request);
+    }
     /**
      * Signs a transaction with the Kora fee payer without broadcasting it.
      * @param request - Sign request parameters
@@ -326,6 +347,9 @@ export class KoraClient {
             tokenProgram: token_program_id,
             mint: fee_token,
         });
+        if (fee_in_token === undefined) {
+            throw new Error('Fee token was specified but fee_in_token was not returned from server');
+        }
         const paymentInstruction = getTransferInstruction({
             source: sourceTokenAccount,
             destination: destinationTokenAccount,

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

@@ -69,12 +69,25 @@ export interface EstimateTransactionFeeRequest {
     /** Base64-encoded transaction to estimate fees for */
     transaction: string;
     /** Mint address of the token to calculate fees in */
-    fee_token: string;
+    fee_token?: string;
     /** Optional signer address for the transaction */
     signer_key?: string;
     /** Optional signer verification during transaction simulation (defaults to false) */
     sig_verify?: boolean;
 }
+/**
+ * Parameters for estimating bundle fees.
+ */
+export interface EstimateBundleFeeRequest {
+    /** Array of base64-encoded transactions to estimate fees for */
+    transactions: string[];
+    /** Mint address of the token to calculate fees in */
+    fee_token?: string;
+    /** Optional signer address for the transactions */
+    signer_key?: string;
+    /** Optional signer verification during transaction simulation (defaults to false) */
+    sig_verify?: boolean;
+}
 /**
  * Parameters for getting a payment instruction.
  */
@@ -182,7 +195,22 @@ export interface EstimateTransactionFeeResponse {
     /**
      * Transaction fee in the requested token (in decimals value of the token, e.g. 10^6 for USDC)
      */
-    fee_in_token: number;
+    fee_in_token?: number;
+    /** Public key of the signer used to estimate the fee */
+    signer_pubkey: string;
+    /** Public key of the payment destination */
+    payment_address: string;
+}
+/**
+ * Response containing estimated bundle fees.
+ */
+export interface EstimateBundleFeeResponse {
+    /** Total bundle fee in lamports across all transactions */
+    fee_in_lamports: number;
+    /**
+     * Total bundle fee in the requested token (in decimals value of the token, e.g. 10^6 for USDC)
+     */
+    fee_in_token?: number;
     /** Public key of the signer used to estimate the fee */
     signer_pubkey: string;
     /** Public key of the payment destination */
@@ -278,6 +306,8 @@ export interface EnabledMethods {
     liveness: boolean;
     /** Whether the estimate_transaction_fee method is enabled */
     estimate_transaction_fee: boolean;
+    /** Whether the estimate_bundle_fee method is enabled (requires bundle.enabled = true) */
+    estimate_bundle_fee: boolean;
     /** Whether the get_supported_tokens method is enabled */
     get_supported_tokens: boolean;
     /** Whether the get_payer_signer method is enabled */

package/dist/test/unit.test.js

@@ -141,6 +141,7 @@ describe('KoraClient Unit Tests', () => {
                 enabled_methods: {
                     liveness: true,
                     estimate_transaction_fee: true,
+                    estimate_bundle_fee: true,
                     get_supported_tokens: true,
                     get_payer_signer: true,
                     sign_transaction: true,
@@ -361,6 +362,7 @@ describe('KoraClient Unit Tests', () => {
             enabled_methods: {
                 liveness: true,
                 estimate_transaction_fee: true,
+                estimate_bundle_fee: true,
                 get_supported_tokens: true,
                 get_payer_signer: true,
                 sign_transaction: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/kora",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.2",
   "description": "TypeScript SDK for Kora RPC",
   "main": "dist/src/index.js",
   "type": "module",