@stellar/stellar-base 14.0.4 → 14.1.0

package/types/index.d.ts

@@ -1062,6 +1062,17 @@ export class Transaction<
 export const BASE_FEE = '100';
 export const TimeoutInfinite = 0;
 
+/**
+ * Represents the fees associated with a Soroban transaction, including the number of instructions executed,
+ * the number of bytes read and written to the ledger, and the total resource fee in stroops.
+ */
+export interface SorobanFees {
+  instructions: number; 
+  readBytes: number;
+  writeBytes: number;
+  resourceFee: bigint;
+}
+
 export class TransactionBuilder {
   constructor(
     sourceAccount: Account,
@@ -1080,6 +1091,19 @@ export class TransactionBuilder {
   setMinAccountSequenceLedgerGap(gap: number): this;
   setExtraSigners(extraSigners: string[]): this;
   setSorobanData(sorobanData: string | xdr.SorobanTransactionData): this;
+  /**
+   * Creates and adds an invoke host function operation for transferring SAC tokens.
+   * This method removes the need for simulation by handling the creation of the
+   * appropriate authorization entries and ledger footprint for the transfer operation.
+   *
+   * @param destination - the address of the recipient of the SAC transfer (should be a valid Stellar address or contract ID)
+   * @param asset - the SAC asset to be transferred
+   * @param amount - the amount of tokens to be transferred in 7 decimals. IE 1 token with 7 decimals of precision would be represented as "1_0000000"
+   * @param sorobanFees - optional Soroban fees for the transaction to override the default fees used
+   *
+   * @returns the TransactionBuilder instance with the SAC transfer operation added
+   */
+  addSacTransferOperation(destination: string, asset: Asset, amount: string | bigint, sorobanFees?: SorobanFees): this;
   build(): Transaction;
   setNetworkPassphrase(networkPassphrase: string): this;