@neutral-trade/sdk 0.4.4 → 0.4.5

package/dist/index.d.mts

@@ -199,6 +199,51 @@ declare function parseAmountRawToBigInt(amountRaw: string): bigint;
  */
 declare function humanFloatToAmountRawString(human: number, decimals: number): string;
 //#endregion
+//#region src/utils/bundle-fee-override.d.ts
+/** Mirrors `bundle-sc` `FEE_OVERRIDE_*` bit flags. */
+declare const FEE_OVERRIDE: {
+  readonly DEPOSIT: number;
+  readonly WITHDRAWAL: number;
+  readonly PERFORMANCE: number;
+  readonly MANAGEMENT: number;
+};
+interface EffectiveFeeBps {
+  depositFeeBps: number;
+  withdrawalFeeBps: number;
+  performanceFeeBps: number;
+  managementFeeBps: number;
+}
+/** Decimal fees matching frontend `VaultConfig` (`0.01` = 1%). */
+interface EffectiveVaultFeeDecimals {
+  dfee: number;
+  wfee: number;
+  pfee: number;
+  mfee: number;
+}
+declare function bpsToFeeDecimal(bps: number): number;
+declare function feeDecimalToBps(decimal: number): number;
+declare function vaultFeeDecimalsToBps(fees: EffectiveVaultFeeDecimals): EffectiveFeeBps;
+declare function effectiveFeeBpsToDecimals(fees: EffectiveFeeBps): EffectiveVaultFeeDecimals;
+/**
+ * Apply per-user fee override flags onto default bps (bundle or vault-config defaults).
+ */
+declare function resolveEffectiveFeeBpsFromDefaults(defaults: EffectiveFeeBps, user: UserBundleAccount): EffectiveFeeBps;
+/**
+ * Mirror on-chain `resolve_effective_fees`. Returns fee rates in bps.
+ */
+declare function resolveEffectiveFeeBps(bundle: BundleAccount, user: UserBundleAccount): EffectiveFeeBps;
+/**
+ * Resolve effective fees for UI vault config defaults + optional user bundle account.
+ * Returns decimal fees (`0.01` = 1%).
+ */
+declare function resolveEffectiveVaultFees(vaultDefaults: EffectiveVaultFeeDecimals, user?: UserBundleAccount | null): EffectiveVaultFeeDecimals;
+declare function hasAnyFeeOverride(user?: UserBundleAccount | null): boolean;
+declare function hasCustomFeeRate(effectiveFees: EffectiveVaultFeeDecimals, vaultDefaults: EffectiveVaultFeeDecimals): boolean;
+declare function computeDepositFeePreview(grossAmount: number, depositFeeDecimal: number): {
+  feeAmount: number;
+  netAmount: number;
+};
+//#endregion
 //#region src/utils/request-withdraw-shares.d.ts
 /**
  * Shares to burn for `requestWithdrawal`, from integer token raw and on-chain totals.
@@ -281,4 +326,4 @@ declare function derivePendingAuthPDA(bundlePDA: PublicKey, programId: PublicKey
  */
 declare function getVaultDepositorAddressSync(programId: PublicKey, vault: PublicKey, authority: PublicKey): PublicKey;
 //#endregion
-export { ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, BUNDLE_PROGRAM_ID_V2_MAINNET, type BuildBundleDepositInstructionsParams, type BuildBundleRequestWithdrawInstructionParams, type BundleAccount, type BundleCluster, type BundleProgram, type BundleProvider, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, DevnetVaultId, NeutralTrade, type NeutralTradeConfig, type NeutralTradeCoreContext, type OracleData, SEED_ORACLE, SEED_PENDING_AUTH, SEED_TEMP, SEED_USER, SupportedChain, SupportedToken, type Token, type UserBalanceResult, type UserBundleAccount, type UserBundleTempData, type VaultBalanceData, VaultCategory, VaultId, type VaultRegistry, type VaultRegistryEntry, VaultType, assertAllowlistedBundleProgramId, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, computeRequestWithdrawalSharesFromAmountRaw, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, tokens, vaults, vaultsDevnet };
+export { ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, BUNDLE_PROGRAM_ID_V2_MAINNET, type BuildBundleDepositInstructionsParams, type BuildBundleRequestWithdrawInstructionParams, type BundleAccount, type BundleCluster, type BundleProgram, type BundleProvider, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, DevnetVaultId, type EffectiveFeeBps, type EffectiveVaultFeeDecimals, FEE_OVERRIDE, NeutralTrade, type NeutralTradeConfig, type NeutralTradeCoreContext, type OracleData, SEED_ORACLE, SEED_PENDING_AUTH, SEED_TEMP, SEED_USER, SupportedChain, SupportedToken, type Token, type UserBalanceResult, type UserBundleAccount, type UserBundleTempData, type VaultBalanceData, VaultCategory, VaultId, type VaultRegistry, type VaultRegistryEntry, VaultType, assertAllowlistedBundleProgramId, bpsToFeeDecimal, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, computeDepositFeePreview, computeRequestWithdrawalSharesFromAmountRaw, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, effectiveFeeBpsToDecimals, feeDecimalToBps, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, hasAnyFeeOverride, hasCustomFeeRate, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, resolveEffectiveFeeBps, resolveEffectiveFeeBpsFromDefaults, resolveEffectiveVaultFees, tokens, vaultFeeDecimalsToBps, vaults, vaultsDevnet };

package/dist/index.mjs

@@ -184,6 +184,99 @@ let DevnetVaultId = /* @__PURE__ */ function(DevnetVaultId$1) {
 	return DevnetVaultId$1;
 }({});
 
+//#endregion
+//#region src/utils/bundle-fee-override.ts
+/** Mirrors `bundle-sc` `FEE_OVERRIDE_*` bit flags. */
+const FEE_OVERRIDE = {
+	DEPOSIT: 1,
+	WITHDRAWAL: 2,
+	PERFORMANCE: 4,
+	MANAGEMENT: 8
+};
+const FEE_EPS = 1e-9;
+function bpsToFeeDecimal(bps) {
+	return bps / 1e4;
+}
+function feeDecimalToBps(decimal) {
+	return Math.round(decimal * 1e4);
+}
+function toNum(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "bigint") return Number(value);
+	if (typeof value === "object" && value !== null && "toNumber" in value) return value.toNumber();
+	return Number(String(value ?? 0));
+}
+function bundleDefaultFeeBps(bundle) {
+	const b = bundle;
+	return {
+		depositFeeBps: toNum(b.depositFee),
+		withdrawalFeeBps: toNum(b.withdrawalFee),
+		performanceFeeBps: toNum(b.performanceFee),
+		managementFeeBps: toNum(b.managementFeeBps)
+	};
+}
+function vaultFeeDecimalsToBps(fees) {
+	return {
+		depositFeeBps: feeDecimalToBps(fees.dfee),
+		withdrawalFeeBps: feeDecimalToBps(fees.wfee),
+		performanceFeeBps: feeDecimalToBps(fees.pfee),
+		managementFeeBps: feeDecimalToBps(fees.mfee)
+	};
+}
+function effectiveFeeBpsToDecimals(fees) {
+	return {
+		dfee: bpsToFeeDecimal(fees.depositFeeBps),
+		wfee: bpsToFeeDecimal(fees.withdrawalFeeBps),
+		pfee: bpsToFeeDecimal(fees.performanceFeeBps),
+		mfee: bpsToFeeDecimal(fees.managementFeeBps)
+	};
+}
+/**
+* Apply per-user fee override flags onto default bps (bundle or vault-config defaults).
+*/
+function resolveEffectiveFeeBpsFromDefaults(defaults, user) {
+	const flags = toNum(user.feeOverrideFlags);
+	if (flags === 0) return defaults;
+	return {
+		depositFeeBps: (flags & FEE_OVERRIDE.DEPOSIT) !== 0 ? toNum(user.customDepositFeeBps) : defaults.depositFeeBps,
+		withdrawalFeeBps: (flags & FEE_OVERRIDE.WITHDRAWAL) !== 0 ? toNum(user.customWithdrawalFeeBps) : defaults.withdrawalFeeBps,
+		performanceFeeBps: (flags & FEE_OVERRIDE.PERFORMANCE) !== 0 ? toNum(user.customPerformanceFeeBps) : defaults.performanceFeeBps,
+		managementFeeBps: (flags & FEE_OVERRIDE.MANAGEMENT) !== 0 ? toNum(user.customManagementFeeBps) : defaults.managementFeeBps
+	};
+}
+/**
+* Mirror on-chain `resolve_effective_fees`. Returns fee rates in bps.
+*/
+function resolveEffectiveFeeBps(bundle, user) {
+	return resolveEffectiveFeeBpsFromDefaults(bundleDefaultFeeBps(bundle), user);
+}
+/**
+* Resolve effective fees for UI vault config defaults + optional user bundle account.
+* Returns decimal fees (`0.01` = 1%).
+*/
+function resolveEffectiveVaultFees(vaultDefaults, user) {
+	if (!user) return vaultDefaults;
+	return effectiveFeeBpsToDecimals(resolveEffectiveFeeBpsFromDefaults(vaultFeeDecimalsToBps(vaultDefaults), user));
+}
+function hasAnyFeeOverride(user) {
+	if (!user) return false;
+	return toNum(user.feeOverrideFlags) !== 0;
+}
+function hasCustomFeeRate(effectiveFees, vaultDefaults) {
+	return Math.abs(effectiveFees.dfee - vaultDefaults.dfee) > FEE_EPS || Math.abs(effectiveFees.wfee - vaultDefaults.wfee) > FEE_EPS || Math.abs(effectiveFees.pfee - vaultDefaults.pfee) > FEE_EPS || Math.abs(effectiveFees.mfee - vaultDefaults.mfee) > FEE_EPS;
+}
+function computeDepositFeePreview(grossAmount, depositFeeDecimal) {
+	if (grossAmount <= 0 || depositFeeDecimal <= 0) return {
+		feeAmount: 0,
+		netAmount: grossAmount
+	};
+	const feeAmount = grossAmount * depositFeeDecimal;
+	return {
+		feeAmount,
+		netAmount: grossAmount - feeAmount
+	};
+}
+
 //#endregion
 //#region src/utils/bundle.ts
 const SECONDS_PER_YEAR = 365n * 24n * 60n * 60n;
@@ -202,8 +295,9 @@ function estimatePendingBundleFeeToken({ oracleData, bundleData, userBundle, ass
 	const extra = bundleData;
 	const assetPrec = extra.assetPrecision != null ? BigInt(extra.assetPrecision.toString()) : BigInt(10 ** assetDecimals);
 	const sharePrice = totalShares > 0n ? totalAssets * assetPrec / totalShares : assetPrec;
-	const managementFeeBps = BigInt(Number(extra.managementFeeBps ?? 0));
-	const performanceFeeBps = BigInt(Number(extra.performanceFee ?? 0));
+	const effectiveFees = resolveEffectiveFeeBps(bundleData, userBundle);
+	const managementFeeBps = BigInt(effectiveFees.managementFeeBps);
+	const performanceFeeBps = BigInt(effectiveFees.performanceFeeBps);
 	const lastMgmtTs = bnToBigInt(userBundle.lastManagementFeeTimestamp);
 	const nowTs = BigInt(nowUnixSeconds);
 	let managementFeeShares = 0n;
@@ -406,4 +500,4 @@ var NeutralTrade = class NeutralTrade {
 };
 
 //#endregion
-export { ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, BUNDLE_PROGRAM_ID_V2_MAINNET, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, DevnetVaultId, NeutralTrade, SEED_ORACLE, SEED_PENDING_AUTH, SEED_TEMP, SEED_USER, SupportedChain, SupportedToken, VaultCategory, VaultId, VaultType, assertAllowlistedBundleProgramId, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, computeRequestWithdrawalSharesFromAmountRaw, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, tokens, vaults, vaultsDevnet };
+export { ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, BUNDLE_PROGRAM_ID_V2_MAINNET, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, DevnetVaultId, FEE_OVERRIDE, NeutralTrade, SEED_ORACLE, SEED_PENDING_AUTH, SEED_TEMP, SEED_USER, SupportedChain, SupportedToken, VaultCategory, VaultId, VaultType, assertAllowlistedBundleProgramId, bpsToFeeDecimal, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, computeDepositFeePreview, computeRequestWithdrawalSharesFromAmountRaw, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, effectiveFeeBpsToDecimals, feeDecimalToBps, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, hasAnyFeeOverride, hasCustomFeeRate, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, resolveEffectiveFeeBps, resolveEffectiveFeeBpsFromDefaults, resolveEffectiveVaultFees, tokens, vaultFeeDecimalsToBps, vaults, vaultsDevnet };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neutral-trade/sdk",
   "type": "module",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "SDK for Neutral Trade vaults",
   "license": "MIT",
   "homepage": "https://github.com/neutral-trade/sdk#readme",