@gala-chain/launchpad 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "GalaChain Launchpad Chaincode",
   "main": "lib/src/index.js",
   "types": "lib/src/index.d.ts",
@@ -51,4 +51,4 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.3.3"
   }
-}
+}

package/src/api/types/LaunchpadBatchSubmitAuthorities.ts

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) Gala Games Inc. All rights reserved.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ChainObject } from "@gala-chain/api";
+import { Exclude } from "class-transformer";
+import { ArrayNotEmpty, IsString } from "class-validator";
+
+export class LaunchpadBatchSubmitAuthorities extends ChainObject {
+  @Exclude()
+  public static INDEX_KEY = "GCLBSA"; // GalaChain Launchpad Batch Submit Authorities
+
+  @ArrayNotEmpty()
+  @IsString({ each: true })
+  authorities: string[];
+
+  constructor(authorities: string[]) {
+    super();
+    this.authorities = authorities;
+  }
+
+  public addOrUpdateAuthorities(newAuthorities: string[]) {
+    this.authorities = newAuthorities;
+  }
+
+  public addAuthority(authority: string) {
+    if (!this.authorities.includes(authority)) {
+      this.authorities.push(authority);
+    }
+  }
+
+  public removeAuthority(authority: string) {
+    this.authorities = this.authorities.filter((auth) => auth !== authority);
+  }
+
+  public isAuthorized(authority: string): boolean {
+    return this.authorities.includes(authority);
+  }
+
+  public getAuthorities(): string[] {
+    return [...this.authorities];
+  }
+}

package/src/api/types/LaunchpadDtos.ts

@@ -24,6 +24,8 @@ import {
 import BigNumber from "bignumber.js";
 import { Type } from "class-transformer";
 import {
+  ArrayNotEmpty,
+  IsArray,
   IsBoolean,
   IsNotEmpty,
   IsNumber,
@@ -275,6 +277,9 @@ export class TradeResDto {
   @IsNotEmpty()
   public inputQuantity: string;
 
+  @IsNotEmpty()
+  public totalFees: string;
+
   @IsNotEmpty()
   public outputQuantity: string;
 
@@ -328,6 +333,12 @@ export class ConfigureLaunchpadFeeAddressDto extends SubmitCallDTO {
   @IsUserAlias()
   public newPlatformFeeAddress?: UserAlias;
 
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Max(1)
+  public newFeeAmount?: number;
+
   @IsOptional()
   @IsUserAlias({ each: true })
   public newAuthorities?: UserAlias[];
@@ -355,6 +366,10 @@ export class TradeCalculationResFeesDto {
   @IsNotEmpty()
   @IsString()
   reverseBondingCurve: string;
+
+  @IsNotEmpty()
+  @IsString()
+  transactionFees: string;
 }
 
 export class TradeCalculationResDto {
@@ -366,3 +381,26 @@ export class TradeCalculationResDto {
   @Type(() => TradeCalculationResFeesDto)
   public extraFees: TradeCalculationResFeesDto;
 }
+
+export class AuthorizeBatchSubmitterDto extends SubmitCallDTO {
+  @IsArray()
+  @ArrayNotEmpty()
+  @IsString({ each: true })
+  authorities: string[];
+}
+
+export class DeauthorizeBatchSubmitterDto extends SubmitCallDTO {
+  @IsString()
+  authority: string;
+}
+
+export class FetchBatchSubmitAuthoritiesDto extends ChainCallDTO {
+  // No additional fields needed for fetching all authorities
+}
+
+export class BatchSubmitAuthoritiesResDto extends ChainCallDTO {
+  @IsArray()
+  @ArrayNotEmpty()
+  @IsString({ each: true })
+  authorities: string[];
+}

package/src/api/types/LaunchpadFeeConfig.ts

@@ -14,7 +14,7 @@
  */
 import { ChainObject, IsUserAlias, UserAlias } from "@gala-chain/api";
 import { Exclude } from "class-transformer";
-import { ArrayNotEmpty, IsNotEmpty } from "class-validator";
+import { ArrayNotEmpty, IsNotEmpty, IsNumber, Max, Min } from "class-validator";
 import { JSONSchema } from "class-validator-jsonschema";
 
 @JSONSchema({
@@ -22,24 +22,33 @@ import { JSONSchema } from "class-validator-jsonschema";
 })
 export class LaunchpadFeeConfig extends ChainObject {
   @Exclude()
-  public static INDEX_KEY = "GCLFC"; // GalaChain Launchpad Fee Configuration
+  public static INDEX_KEY = "GCLPFC"; // GalaChain Launchpad Fee Configuration
 
   @IsNotEmpty()
   @IsUserAlias()
   feeAddress: UserAlias;
 
+  @IsNotEmpty()
+  @IsNumber()
+  @Min(0)
+  @Max(1)
+  public feeAmount: number;
+
   @ArrayNotEmpty()
   @IsUserAlias({ each: true })
   authorities: UserAlias[];
 
-  constructor(feeAddress: UserAlias, authorities: UserAlias[]) {
+  constructor(feeAddress: UserAlias, feeAmount: number, authorities: UserAlias[]) {
     super();
     this.feeAddress = feeAddress;
+    this.feeAmount = feeAmount;
     this.authorities = authorities;
   }
 
-  public setNewFeeAddress(newfeeAddress: UserAlias, newAuthorities: UserAlias[]) {
+  public updateFeeConfig(newfeeAddress: UserAlias, newFeeAmount: number, newAuthorities: UserAlias[]) {
     this.feeAddress = newfeeAddress;
+    this.feeAmount = newFeeAmount;
     this.authorities = newAuthorities;
+    this.validate();
   }
 }

package/src/api/types/index.ts

@@ -17,3 +17,4 @@ export * from "./LaunchpadDtos";
 export * from "./LaunchpadFinalizeAllocation";
 export * from "./LaunchpadFeeConfig";
 export * from "./LaunchpadSale";
+export * from "./LaunchpadBatchSubmitAuthorities";

package/src/chaincode/LaunchpadContract.ts

@@ -12,21 +12,28 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { BatchDto, GalaChainResponse, UnauthorizedError } from "@gala-chain/api";
 import {
+  BatchWriteLimitExceededError,
   EVALUATE,
   Evaluate,
   GalaChainContext,
   GalaContract,
   GalaTransaction,
-  Submit
+  Submit,
+  getApiMethod
 } from "@gala-chain/chaincode";
 
 import { version } from "../../package.json";
 import {
+  AuthorizeBatchSubmitterDto,
+  BatchSubmitAuthoritiesResDto,
   ConfigureLaunchpadFeeAddressDto,
   CreateSaleResDto,
   CreateTokenSaleDTO,
+  DeauthorizeBatchSubmitterDto,
   ExactTokenQuantityDto,
+  FetchBatchSubmitAuthoritiesDto,
   FetchSaleDto,
   FinalizeTokenAllocationDto,
   LaunchpadFeeConfig,
@@ -45,6 +52,7 @@ import {
   sellWithNativeFeeGate
 } from "./dexLaunchpadFeeGate";
 import {
+  authorizeLaunchpadBatchSubmitter,
   buyExactToken,
   buyWithNative,
   calculatePreMintTokens,
@@ -54,9 +62,12 @@ import {
   callNativeTokenOut,
   configureLaunchpadFeeAddress,
   createSale,
+  deauthorizeLaunchpadBatchSubmitter,
+  fetchLaunchpadBatchSubmitAuthorities,
   fetchLaunchpadFeeConfig,
   fetchSaleDetails,
   finalizeTokenAllocation,
+  getLaunchpadBatchSubmitAuthorities,
   sellExactToken,
   sellWithNative
 } from "./launchpad";
@@ -208,4 +219,88 @@ export class LaunchpadContract extends GalaContract {
   public async FetchLaunchpadFeeConfig(ctx: GalaChainContext): Promise<LaunchpadFeeConfig> {
     return fetchLaunchpadFeeConfig(ctx);
   }
+
+  public async BatchSubmit(ctx: GalaChainContext, batchDto: BatchDto): Promise<GalaChainResponse<unknown>[]> {
+    // Check if the calling user is authorized to submit batches
+    const batchAuthorities = await fetchLaunchpadBatchSubmitAuthorities(ctx);
+    if (!batchAuthorities.isAuthorized(ctx.callingUser)) {
+      throw new UnauthorizedError(
+        `CallingUser ${ctx.callingUser} is not authorized to submit batches. ` +
+          `Authorized users: ${batchAuthorities.getAuthorities().join(", ")}`
+      );
+    }
+
+    const responses: GalaChainResponse<unknown>[] = [];
+
+    const softWritesLimit = batchDto.writesLimit ?? BatchDto.WRITES_DEFAULT_LIMIT;
+    const writesLimit = Math.min(softWritesLimit, BatchDto.WRITES_HARD_LIMIT);
+    let writesCount = ctx.stub.getWritesCount();
+
+    for (const [index, op] of batchDto.operations.entries()) {
+      // Use sandboxed context to avoid flushes of writes and deletes, and populate
+      // the stub with current writes and deletes.
+      const sandboxCtx = ctx.createReadOnlyContext(index);
+      sandboxCtx.stub.setWrites(ctx.stub.getWrites());
+      sandboxCtx.stub.setDeletes(ctx.stub.getDeletes());
+
+      // Execute the operation. Collect both successful and failed responses.
+      let response: GalaChainResponse<unknown>;
+      try {
+        if (writesCount >= writesLimit) {
+          throw new BatchWriteLimitExceededError(writesLimit);
+        }
+
+        const method = getApiMethod(this, op.method, (m) => m.isWrite && m.methodName !== "BatchSubmit");
+        response = await this[method.methodName](sandboxCtx, op.dto);
+      } catch (error) {
+        response = GalaChainResponse.Error(error);
+      }
+      responses.push(response);
+
+      // Update the current context with the writes and deletes if the operation
+      // is successful.
+      if (GalaChainResponse.isSuccess(response)) {
+        ctx.stub.setWrites(sandboxCtx.stub.getWrites());
+        ctx.stub.setDeletes(sandboxCtx.stub.getDeletes());
+        writesCount = ctx.stub.getWritesCount();
+      }
+    }
+    return responses;
+  }
+
+  @Submit({
+    in: AuthorizeBatchSubmitterDto,
+    out: BatchSubmitAuthoritiesResDto,
+    allowedOrgs: [process.env.CURATOR_ORG_MSP ?? "CuratorOrg"]
+  })
+  public async AuthorizeBatchSubmitter(
+    ctx: GalaChainContext,
+    dto: AuthorizeBatchSubmitterDto
+  ): Promise<BatchSubmitAuthoritiesResDto> {
+    return await authorizeLaunchpadBatchSubmitter(ctx, dto);
+  }
+
+  @Submit({
+    in: DeauthorizeBatchSubmitterDto,
+    out: BatchSubmitAuthoritiesResDto,
+    allowedOrgs: [process.env.CURATOR_ORG_MSP ?? "CuratorOrg"]
+  })
+  public async DeauthorizeBatchSubmitter(
+    ctx: GalaChainContext,
+    dto: DeauthorizeBatchSubmitterDto
+  ): Promise<BatchSubmitAuthoritiesResDto> {
+    return await deauthorizeLaunchpadBatchSubmitter(ctx, dto);
+  }
+
+  @GalaTransaction({
+    type: EVALUATE,
+    in: FetchBatchSubmitAuthoritiesDto,
+    out: BatchSubmitAuthoritiesResDto
+  })
+  public async GetBatchSubmitAuthorities(
+    ctx: GalaChainContext,
+    dto: FetchBatchSubmitAuthoritiesDto
+  ): Promise<BatchSubmitAuthoritiesResDto> {
+    return await getLaunchpadBatchSubmitAuthorities(ctx, dto);
+  }
 }

package/src/chaincode/launchpad/buyExactToken.ts

@@ -17,7 +17,7 @@ import { BigNumber } from "bignumber.js";
 
 import { ExactTokenQuantityDto, LaunchpadSale, TradeResDto } from "../../api/types";
 import { SlippageToleranceExceededError } from "../../api/utils/error";
-import { fetchAndValidateSale } from "../utils";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress } from "../utils";
 import { callNativeTokenIn } from "./callNativeTokenIn";
 import { finalizeSale } from "./finaliseSale";
 
@@ -53,6 +53,7 @@ export async function buyExactToken(
 
   // Calculate the required amount of native tokens to buy the specified token amount
   const callNativeTokenInResult1 = await callNativeTokenIn(ctx, buyTokenDTO);
+  let transactionFees = callNativeTokenInResult1.extraFees.transactionFees;
   let nativeTokensToBuy = new BigNumber(callNativeTokenInResult1.calculatedQuantity);
   const nativeToken = sale.fetchNativeTokenInstanceKey();
   const memeToken = sale.fetchSellingTokenInstanceKey();
@@ -62,6 +63,7 @@ export async function buyExactToken(
     buyTokenDTO.tokenQuantity = tokenLeftInVault;
     const callNativeTokenInResult2 = await callNativeTokenIn(ctx, buyTokenDTO);
     nativeTokensToBuy = new BigNumber(callNativeTokenInResult2.calculatedQuantity);
+    transactionFees = callNativeTokenInResult2.extraFees.transactionFees;
     isSaleFinalized = true;
   }
 
@@ -81,6 +83,19 @@ export async function buyExactToken(
     );
   }
 
+  // Transfer transaction fees
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
+  if (launchpadFeeAddressConfiguration && transactionFees) {
+    await transferToken(ctx, {
+      from: ctx.callingUser,
+      to: launchpadFeeAddressConfiguration.feeAddress,
+      tokenInstanceKey: nativeToken,
+      quantity: new BigNumber(transactionFees),
+      allowancesToUse: [],
+      authorizedOnBehalf: undefined
+    });
+  }
+
   // Transfer native tokens from the buyer to the vault
   await transferToken(ctx, {
     from: ctx.callingUser,
@@ -117,6 +132,7 @@ export async function buyExactToken(
   const token = await fetchTokenClass(ctx, sale.sellingToken);
   return {
     inputQuantity: nativeTokensToBuy.toFixed(),
+    totalFees: transactionFees,
     outputQuantity: buyTokenDTO.tokenQuantity.toFixed(),
     tokenName: token.name,
     tradeType: "Buy",

package/src/chaincode/launchpad/buyWithNative.ts

@@ -17,7 +17,7 @@ import { BigNumber } from "bignumber.js";
 
 import { ExactTokenQuantityDto, LaunchpadSale, NativeTokenQuantityDto, TradeResDto } from "../../api/types";
 import { SlippageToleranceExceededError } from "../../api/utils/error";
-import { fetchAndValidateSale } from "../utils";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress } from "../utils";
 import { callMemeTokenOut } from "./callMemeTokenOut";
 import { callNativeTokenIn } from "./callNativeTokenIn";
 import { finalizeSale } from "./finaliseSale";
@@ -49,22 +49,30 @@ export async function buyWithNative(
   buyTokenDTO: NativeTokenQuantityDto
 ): Promise<TradeResDto> {
   let isSaleFinalized = false;
+
+  // Fetch and validate sale state
   const sale = await fetchAndValidateSale(ctx, buyTokenDTO.vaultAddress);
   const tokensLeftInVault = new BigNumber(sale.sellingTokenQuantity);
+
+  // Calculate how many tokens the user can buy and fee info
   const callMemeTokenOutResult = await callMemeTokenOut(ctx, buyTokenDTO);
+  let transactionFees = callMemeTokenOutResult.extraFees.transactionFees;
   let tokensToBuy = new BigNumber(callMemeTokenOutResult.calculatedQuantity);
 
   const nativeToken = sale.fetchNativeTokenInstanceKey();
   const memeToken = sale.fetchSellingTokenInstanceKey();
 
+  // If vault has fewer tokens than what user wants to buy, cap the purchase
   if (tokensLeftInVault.comparedTo(tokensToBuy) <= 0) {
     tokensToBuy = tokensLeftInVault;
     const nativeTokensrequiredToBuyDto = new ExactTokenQuantityDto(buyTokenDTO.vaultAddress, tokensToBuy);
     const callNativeTokenInResult = await callNativeTokenIn(ctx, nativeTokensrequiredToBuyDto);
+    transactionFees = callMemeTokenOutResult.extraFees.transactionFees;
     buyTokenDTO.nativeTokenQuantity = new BigNumber(callNativeTokenInResult.calculatedQuantity);
     isSaleFinalized = true;
   }
 
+  // Finalize sale if market cap is reached
   if (
     buyTokenDTO.nativeTokenQuantity
       .plus(new BigNumber(sale.nativeTokenQuantity))
@@ -72,12 +80,27 @@ export async function buyWithNative(
   )
     isSaleFinalized = true;
 
+  // Check for slippage condition
   if (buyTokenDTO.expectedToken && buyTokenDTO.expectedToken.comparedTo(tokensToBuy) > 0) {
     throw new SlippageToleranceExceededError(
       "Tokens expected from this operation are more than the the actual amount that will be provided."
     );
   }
 
+  // Transfer transaction fees to launchpad fee address
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
+  if (launchpadFeeAddressConfiguration && transactionFees) {
+    await transferToken(ctx, {
+      from: ctx.callingUser,
+      to: launchpadFeeAddressConfiguration.feeAddress,
+      tokenInstanceKey: nativeToken,
+      quantity: new BigNumber(transactionFees),
+      allowancesToUse: [],
+      authorizedOnBehalf: undefined
+    });
+  }
+
+  // Transfer native tokens from buyer to vault
   await transferToken(ctx, {
     from: ctx.callingUser,
     to: buyTokenDTO.vaultAddress,
@@ -87,6 +110,7 @@ export async function buyWithNative(
     authorizedOnBehalf: undefined
   });
 
+  // Transfer meme tokens from vault to buyer
   await transferToken(ctx, {
     from: buyTokenDTO.vaultAddress,
     to: ctx.callingUser,
@@ -99,9 +123,11 @@ export async function buyWithNative(
     }
   });
 
+  // Update sale object with purchase data
   sale.buyToken(tokensToBuy, buyTokenDTO.nativeTokenQuantity);
   await putChainObject(ctx, sale);
 
+  // Finalize sale if it's complete
   if (isSaleFinalized) {
     await finalizeSale(ctx, sale);
   }
@@ -109,6 +135,7 @@ export async function buyWithNative(
   const token = await fetchTokenClass(ctx, sale.sellingToken);
   return {
     inputQuantity: buyTokenDTO.nativeTokenQuantity.toFixed(),
+    totalFees: transactionFees,
     outputQuantity: tokensToBuy.toFixed(),
     tokenName: token.name,
     tradeType: "Buy",

package/src/chaincode/launchpad/callMemeTokenIn.ts

@@ -18,8 +18,8 @@ import { BigNumber } from "bignumber.js";
 import Decimal from "decimal.js";
 
 import { LaunchpadSale, NativeTokenQuantityDto } from "../../api/types";
-import { fetchAndValidateSale, getBondingConstants } from "../utils";
-import { calculateReverseBondingCurveFee } from "./fees";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress, getBondingConstants } from "../utils";
+import { calculateReverseBondingCurveFee, calculateTransactionFee } from "./fees";
 
 BigNumber.config({
   ROUNDING_MODE: BigNumber.ROUND_UP
@@ -72,11 +72,16 @@ function calculateMemeTokensRequired(sale: LaunchpadSale, requestedNativeTokenQu
  */
 export async function callMemeTokenIn(ctx: GalaChainContext, sellTokenDTO: NativeTokenQuantityDto) {
   const sale = await fetchAndValidateSale(ctx, sellTokenDTO.vaultAddress);
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
 
   return {
     calculatedQuantity: calculateMemeTokensRequired(sale, sellTokenDTO.nativeTokenQuantity),
     extraFees: {
-      reverseBondingCurve: calculateReverseBondingCurveFee(sale, sellTokenDTO.nativeTokenQuantity).toString()
+      reverseBondingCurve: calculateReverseBondingCurveFee(sale, sellTokenDTO.nativeTokenQuantity).toString(),
+      transactionFees: calculateTransactionFee(
+        sellTokenDTO.nativeTokenQuantity,
+        launchpadFeeAddressConfiguration?.feeAmount
+      )
     }
   };
 }

package/src/chaincode/launchpad/callMemeTokenOut.ts

@@ -17,7 +17,8 @@ import { BigNumber } from "bignumber.js";
 import Decimal from "decimal.js";
 
 import { LaunchpadSale, NativeTokenQuantityDto } from "../../api/types";
-import { fetchAndValidateSale, getBondingConstants } from "../utils";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress, getBondingConstants } from "../utils";
+import { calculateTransactionFee } from "./fees";
 
 BigNumber.config({
   ROUNDING_MODE: BigNumber.ROUND_UP
@@ -71,10 +72,15 @@ export async function callMemeTokenOut(ctx: GalaChainContext, buyTokenDTO: Nativ
     roundedResult = new Decimal("1e+7").minus(new Decimal(totalTokensSold));
   }
 
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
   return {
     calculatedQuantity: roundedResult.toFixed(),
     extraFees: {
-      reverseBondingCurve: "0"
+      reverseBondingCurve: "0",
+      transactionFees: calculateTransactionFee(
+        BigNumber(nativeTokens.toFixed()),
+        launchpadFeeAddressConfiguration?.feeAmount
+      )
     }
   };
 }

package/src/chaincode/launchpad/callNativeTokenIn.ts

@@ -17,7 +17,8 @@ import { BigNumber } from "bignumber.js";
 import Decimal from "decimal.js";
 
 import { ExactTokenQuantityDto } from "../../api/types";
-import { fetchAndValidateSale, getBondingConstants } from "../utils";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress, getBondingConstants } from "../utils";
+import { calculateTransactionFee } from "./fees";
 
 BigNumber.config({
   ROUNDING_MODE: BigNumber.ROUND_UP
@@ -62,10 +63,16 @@ export async function callNativeTokenIn(ctx: GalaChainContext, buyTokenDTO: Exac
 
   const price = constantFactor.mul(differenceOfExponentials);
 
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
+  const roundedPrice = price.toDecimalPlaces(8, Decimal.ROUND_UP).toFixed();
   return {
-    calculatedQuantity: price.toDecimalPlaces(8, Decimal.ROUND_UP).toFixed(),
+    calculatedQuantity: roundedPrice,
     extraFees: {
-      reverseBondingCurve: "0"
+      reverseBondingCurve: "0",
+      transactionFees: calculateTransactionFee(
+        BigNumber(roundedPrice),
+        launchpadFeeAddressConfiguration?.feeAmount
+      )
     }
   };
 }

package/src/chaincode/launchpad/callNativeTokenOut.ts

@@ -17,8 +17,8 @@ import { BigNumber } from "bignumber.js";
 import Decimal from "decimal.js";
 
 import { ExactTokenQuantityDto, LaunchpadSale } from "../../api/types";
-import { fetchAndValidateSale, getBondingConstants } from "../utils";
-import { calculateReverseBondingCurveFee } from "./fees";
+import { fetchAndValidateSale, fetchLaunchpadFeeAddress, getBondingConstants } from "../utils";
+import { calculateReverseBondingCurveFee, calculateTransactionFee } from "./fees";
 
 BigNumber.config({
   ROUNDING_MODE: BigNumber.ROUND_UP
@@ -72,10 +72,15 @@ function calculateNativeTokensReceived(sale: LaunchpadSale, tokensToSellBn: BigN
 export async function callNativeTokenOut(ctx: GalaChainContext, sellTokenDTO: ExactTokenQuantityDto) {
   const sale = await fetchAndValidateSale(ctx, sellTokenDTO.vaultAddress);
   const nativeTokensReceived = calculateNativeTokensReceived(sale, sellTokenDTO.tokenQuantity);
+  const launchpadFeeAddressConfiguration = await fetchLaunchpadFeeAddress(ctx);
   return {
     calculatedQuantity: nativeTokensReceived,
     extraFees: {
-      reverseBondingCurve: calculateReverseBondingCurveFee(sale, BigNumber(nativeTokensReceived)).toString()
+      reverseBondingCurve: calculateReverseBondingCurveFee(sale, BigNumber(nativeTokensReceived)).toString(),
+      transactionFees: calculateTransactionFee(
+        BigNumber(nativeTokensReceived),
+        launchpadFeeAddressConfiguration?.feeAmount
+      )
     }
   };
 }

package/src/chaincode/launchpad/configureLaunchpadFeeConfig.ts

@@ -18,19 +18,35 @@ import { getObjectByKey, putChainObject } from "@gala-chain/chaincode";
 
 import { ConfigureLaunchpadFeeAddressDto, LaunchpadFeeConfig } from "../../api/types";
 
+/**
+ * Configures or updates the Launchpad platform fee settings.
+ *
+ * This function initializes or modifies the fee address, fee amount, and list of authorities
+ * responsible for managing Launchpad platform fees. Only users from the designated curator
+ * organization or authorized addresses are permitted to make these changes.
+ *
+ * @param ctx - The context object providing access to the GalaChain environment.
+ * @param dto - The data transfer object containing the new fee address, fee amount,
+ *              and optional list of new authorities.
+ * @returns A promise that resolves to the updated or newly created `LaunchpadFeeConfig` object.
+ */
 export async function configureLaunchpadFeeAddress(
   ctx: GalaChainContext,
   dto: ConfigureLaunchpadFeeAddressDto
 ): Promise<LaunchpadFeeConfig> {
-  if (!dto.newPlatformFeeAddress && !dto.newAuthorities?.length) {
+  // Validate input: at least one field must be present
+  if (!dto.newPlatformFeeAddress && !dto.newAuthorities?.length && !dto.newFeeAmount) {
     throw new ValidationFailedError("None of the input fields are present.");
   }
 
   const curatorOrgMsp = process.env.CURATOR_ORG_MSP ?? "CuratorOrg";
 
   const key = ctx.stub.createCompositeKey(LaunchpadFeeConfig.INDEX_KEY, []);
+
+  // Attempt to fetch existing config from the chain
   let platformFeeAddress = await getObjectByKey(ctx, LaunchpadFeeConfig, key).catch((e) => {
     const chainError = ChainError.from(e);
+    // Handle case where config doesn't exist yet
     if (chainError.matches(ErrorCode.NOT_FOUND)) {
       return undefined;
     } else {
@@ -38,25 +54,32 @@ export async function configureLaunchpadFeeAddress(
     }
   });
 
+  // Authorization check
   if (ctx.clientIdentity.getMSPID() !== curatorOrgMsp) {
     if (!platformFeeAddress || !platformFeeAddress.authorities.includes(ctx.callingUser)) {
       throw new UnauthorizedError(`CallingUser ${ctx.callingUser} is not authorized to create or update`);
     }
   }
 
+  // If no existing config, this is the initial setup
   if (!platformFeeAddress) {
-    if (!dto.newPlatformFeeAddress) {
+    // Require both address and fee amount on initial setup
+    if (!dto.newPlatformFeeAddress || !dto.newFeeAmount) {
       throw new ValidationFailedError(
-        "Must provide a platform fee address in the initial setup of the configuration."
+        "Must provide a launchpad platform fee address and fee amount in the initial setup of the configuration."
       );
     }
+    // Create new configuration
     platformFeeAddress = new LaunchpadFeeConfig(
       dto.newPlatformFeeAddress,
+      dto.newFeeAmount,
       dto.newAuthorities ?? [ctx.callingUser]
     );
   } else if (platformFeeAddress && platformFeeAddress.authorities.includes(ctx.callingUser)) {
-    platformFeeAddress.setNewFeeAddress(
+    // Caller is authorized and updating the existing config
+    platformFeeAddress.updateFeeConfig(
       dto.newPlatformFeeAddress ?? platformFeeAddress.feeAddress,
+      dto.newFeeAmount ?? platformFeeAddress.feeAmount,
       dto.newAuthorities ?? platformFeeAddress.authorities
     );
   } else {

package/src/chaincode/launchpad/fees.ts

@@ -56,7 +56,7 @@ export async function payReverseBondingCurveFee(
   nativeTokensToReceive: BigNumber,
   maxAcceptableFee?: BigNumber
 ) {
-  const feeAmount = await calculateReverseBondingCurveFee(sale, nativeTokensToReceive);
+  const feeAmount = calculateReverseBondingCurveFee(sale, nativeTokensToReceive);
 
   if (feeAmount.isZero()) {
     return; // No fee
@@ -103,3 +103,7 @@ export async function payReverseBondingCurveFee(
     authorizedOnBehalf: undefined
   });
 }
+
+export function calculateTransactionFee(tokensBeingTraded: BigNumber, feeAmount?: number) {
+  return tokensBeingTraded.multipliedBy(feeAmount ?? 0).toFixed(8, BigNumber.ROUND_UP);
+}