@neutral-trade/sdk 0.4.5 → 0.4.9

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { A as SupportedToken, B as DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, C as VaultRegistryEntry, D as UserBundleAccount, E as OracleData, F as ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, G as getDefaultBundleProgramIdByCluster, H as assertAllowlistedBundleProgramId, I as BUNDLE_PROGRAM_ID_V2_MAINNET, K as isAllowlistedBundleProgramId, L as BundleCluster, M as getSolanaTokenDecimals, N as getSolanaTokenMint, O as UserBundleTempData, P as tokens, R as BundleProgram, S as VaultRegistry, T as BundleAccount, U as createAllowlistedBundleProgram, V as DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, W as createBundleProgramById, _ as vaults, b as VaultBalanceData, d as NeutralTradeConfig, f as getBundleProgramId, g as isValidVaultAddress, h as getVaultRegistry, j as Token, k as SupportedChain, m as getVaultById, p as getVaultByAddress, t as NeutralTradeCoreContext, u as NeutralTrade, v as vaultsDevnet, w as VaultType, x as VaultCategory, y as UserBalanceResult, z as BundleProvider } from "./neutral-trade-core-BGjOiCsY.mjs";
-import { AnchorProvider, Wallet } from "@coral-xyz/anchor";
+import { A as SupportedToken, B as DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, C as VaultRegistryEntry, D as UserBundleAccount, E as OracleData, F as ALLOWLISTED_BUNDLE_PROGRAM_IDS_BY_CLUSTER, G as getDefaultBundleProgramIdByCluster, H as assertAllowlistedBundleProgramId, I as BUNDLE_PROGRAM_ID_V2_MAINNET, K as isAllowlistedBundleProgramId, L as BundleCluster, M as getSolanaTokenDecimals, N as getSolanaTokenMint, O as UserBundleTempData, P as tokens, R as BundleProgram, S as VaultRegistry, T as BundleAccount, U as createAllowlistedBundleProgram, V as DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, W as createBundleProgramById, _ as vaults$1, b as VaultBalanceData, d as NeutralTradeConfig, f as getBundleProgramId, g as isValidVaultAddress, h as getVaultRegistry, j as Token, k as SupportedChain, m as getVaultById, p as getVaultByAddress, t as NeutralTradeCoreContext, u as NeutralTrade, v as vaultsDevnet, w as VaultType, x as VaultCategory, y as UserBalanceResult, z as BundleProvider } from "./neutral-trade-core-BGjOiCsY.mjs";
+import { AnchorProvider, Program, Wallet } from "@coral-xyz/anchor";
 import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
 import BN from "bn.js";
 
@@ -199,6 +199,24 @@ declare function parseAmountRawToBigInt(amountRaw: string): bigint;
  */
 declare function humanFloatToAmountRawString(human: number, decimals: number): string;
 //#endregion
+//#region src/utils/bundle.d.ts
+/**
+ * Estimated unpaid bundle fees in deposit token (mgmt + performance), matching on-chain `charge_user_fees`.
+ */
+declare function estimatePendingBundleFeeToken({
+  oracleData,
+  bundleData,
+  userBundle,
+  assetDecimals,
+  nowUnixSeconds
+}: {
+  oracleData: OracleData;
+  bundleData: BundleAccount;
+  userBundle: UserBundleAccount;
+  assetDecimals: number;
+  nowUnixSeconds?: number;
+}): number;
+//#endregion
 //#region src/utils/bundle-fee-override.d.ts
 /** Mirrors `bundle-sc` `FEE_OVERRIDE_*` bit flags. */
 declare const FEE_OVERRIDE: {
@@ -206,6 +224,7 @@ declare const FEE_OVERRIDE: {
   readonly WITHDRAWAL: number;
   readonly PERFORMANCE: number;
   readonly MANAGEMENT: number;
+  readonly ALL: number;
 };
 interface EffectiveFeeBps {
   depositFeeBps: number;
@@ -213,6 +232,14 @@ interface EffectiveFeeBps {
   performanceFeeBps: number;
   managementFeeBps: number;
 }
+/** Normalized per-user fee override fields (bps + flag mask). */
+interface UserFeeOverrideFields {
+  feeOverrideFlags: number;
+  customDepositFeeBps: number;
+  customWithdrawalFeeBps: number;
+  customPerformanceFeeBps: number;
+  customManagementFeeBps: number;
+}
 /** Decimal fees matching frontend `VaultConfig` (`0.01` = 1%). */
 interface EffectiveVaultFeeDecimals {
   dfee: number;
@@ -222,12 +249,22 @@ interface EffectiveVaultFeeDecimals {
 }
 declare function bpsToFeeDecimal(bps: number): number;
 declare function feeDecimalToBps(decimal: number): number;
+declare function bpsToPercentLabel(bps: number): string;
+declare function hasFeeOverrideFlag(flags: number, bit: number): boolean;
+declare function buildFeeOverrideMask(flags: {
+  deposit?: boolean;
+  withdrawal?: boolean;
+  performance?: boolean;
+  management?: boolean;
+}): number;
+declare function formatFeeOverrideFlags(flags: number): string;
+declare function readUserFeeOverrideFields(account: Record<string, unknown>): UserFeeOverrideFields;
 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;
+declare function resolveEffectiveFeeBpsFromDefaults(defaults: EffectiveFeeBps, user: UserFeeOverrideFields): EffectiveFeeBps;
 /**
  * Mirror on-chain `resolve_effective_fees`. Returns fee rates in bps.
  */
@@ -243,6 +280,11 @@ declare function computeDepositFeePreview(grossAmount: number, depositFeeDecimal
   feeAmount: number;
   netAmount: number;
 };
+/** Same linear preview as deposit: fee = gross × rate, net = gross − fee. */
+declare function computeWithdrawFeePreview(grossAmount: number, withdrawalFeeDecimal: number): {
+  feeAmount: number;
+  netAmount: number;
+};
 //#endregion
 //#region src/utils/request-withdraw-shares.d.ts
 /**
@@ -326,4 +368,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, 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 };
+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 UserFeeOverrideFields, type VaultBalanceData, VaultCategory, VaultId, type VaultRegistry, type VaultRegistryEntry, VaultType, assertAllowlistedBundleProgramId, bpsToFeeDecimal, bpsToPercentLabel, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, buildFeeOverrideMask, computeDepositFeePreview, computeRequestWithdrawalSharesFromAmountRaw, computeWithdrawFeePreview, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, effectiveFeeBpsToDecimals, estimatePendingBundleFeeToken, feeDecimalToBps, formatFeeOverrideFlags, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, hasAnyFeeOverride, hasCustomFeeRate, hasFeeOverrideFlag, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, readUserFeeOverrideFields, resolveEffectiveFeeBps, resolveEffectiveFeeBpsFromDefaults, resolveEffectiveVaultFees, tokens, vaultFeeDecimalsToBps, vaults$1 as vaults, vaultsDevnet };

package/dist/index.mjs

@@ -191,7 +191,8 @@ const FEE_OVERRIDE = {
 	DEPOSIT: 1,
 	WITHDRAWAL: 2,
 	PERFORMANCE: 4,
-	MANAGEMENT: 8
+	MANAGEMENT: 8,
+	ALL: 15
 };
 const FEE_EPS = 1e-9;
 function bpsToFeeDecimal(bps) {
@@ -200,6 +201,37 @@ function bpsToFeeDecimal(bps) {
 function feeDecimalToBps(decimal) {
 	return Math.round(decimal * 1e4);
 }
+function bpsToPercentLabel(bps) {
+	return (bps / 100).toFixed(4).replace(/\.?0+$/, "");
+}
+function hasFeeOverrideFlag(flags, bit) {
+	return (flags & bit) !== 0;
+}
+function buildFeeOverrideMask(flags) {
+	let mask = 0;
+	if (flags.deposit) mask |= FEE_OVERRIDE.DEPOSIT;
+	if (flags.withdrawal) mask |= FEE_OVERRIDE.WITHDRAWAL;
+	if (flags.performance) mask |= FEE_OVERRIDE.PERFORMANCE;
+	if (flags.management) mask |= FEE_OVERRIDE.MANAGEMENT;
+	return mask;
+}
+function formatFeeOverrideFlags(flags) {
+	const parts = [];
+	if (hasFeeOverrideFlag(flags, FEE_OVERRIDE.DEPOSIT)) parts.push("deposit");
+	if (hasFeeOverrideFlag(flags, FEE_OVERRIDE.WITHDRAWAL)) parts.push("withdrawal");
+	if (hasFeeOverrideFlag(flags, FEE_OVERRIDE.PERFORMANCE)) parts.push("performance");
+	if (hasFeeOverrideFlag(flags, FEE_OVERRIDE.MANAGEMENT)) parts.push("management");
+	return parts.length > 0 ? parts.join(", ") : "none";
+}
+function readUserFeeOverrideFields(account) {
+	return {
+		feeOverrideFlags: toNum(account.feeOverrideFlags ?? account.fee_override_flags),
+		customDepositFeeBps: toNum(account.customDepositFeeBps ?? account.custom_deposit_fee_bps),
+		customWithdrawalFeeBps: toNum(account.customWithdrawalFeeBps ?? account.custom_withdrawal_fee_bps),
+		customPerformanceFeeBps: toNum(account.customPerformanceFeeBps ?? account.custom_performance_fee_bps),
+		customManagementFeeBps: toNum(account.customManagementFeeBps ?? account.custom_management_fee_bps)
+	};
+}
 function toNum(value) {
 	if (typeof value === "number") return value;
 	if (typeof value === "bigint") return Number(value);
@@ -276,6 +308,10 @@ function computeDepositFeePreview(grossAmount, depositFeeDecimal) {
 		netAmount: grossAmount - feeAmount
 	};
 }
+/** Same linear preview as deposit: fee = gross × rate, net = gross − fee. */
+function computeWithdrawFeePreview(grossAmount, withdrawalFeeDecimal) {
+	return computeDepositFeePreview(grossAmount, withdrawalFeeDecimal);
+}
 
 //#endregion
 //#region src/utils/bundle.ts
@@ -500,4 +536,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, 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 };
+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, bpsToPercentLabel, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, buildFeeOverrideMask, computeDepositFeePreview, computeRequestWithdrawalSharesFromAmountRaw, computeWithdrawFeePreview, createAllowlistedBundleProgram, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, effectiveFeeBpsToDecimals, estimatePendingBundleFeeToken, feeDecimalToBps, formatFeeOverrideFlags, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, hasAnyFeeOverride, hasCustomFeeRate, hasFeeOverrideFlag, humanFloatToAmountRawString, isAllowlistedBundleProgramId, isValidVaultAddress, parseAmountRawToBigInt, readUserFeeOverrideFields, resolveEffectiveFeeBps, resolveEffectiveFeeBpsFromDefaults, resolveEffectiveVaultFees, tokens, vaultFeeDecimalsToBps, vaults, vaultsDevnet };

package/package.json

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