@neutral-trade/sdk 0.1.2 → 0.1.4

package/README.md

@@ -6,7 +6,7 @@
 
 TypeScript SDK for [Neutral Trade](https://neutral.trade) vaults.
 
-📚 **[Documentation](https://sdk-neutral-trade.vercel.app/)**
+📚 **[Documentation](https://sdk.neutral.trade/)**
 
 ## Installation
 

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { AnchorProvider, IdlAccounts, Program } from "@coral-xyz/anchor";
 import { AnchorProvider as AnchorProvider$1, IdlAccounts as IdlAccounts$1, Program as Program$1 } from "@coral-xyz/anchor-32";
 import { Connection, PublicKey } from "@solana/web3.js";
-import { z } from "zod";
 import { VaultClient } from "@drift-labs/vaults-sdk";
+import { z } from "zod";
 
 //#region src/idl/bundle-v1.d.ts
 interface NtbundleV1 {
@@ -4938,6 +4938,160 @@ declare enum BundleProgramId {
   V2 = "BUNDeH5A4c47bcEoAjBhN3sCjLgYnRsmt9ibMztqVkC9",
 }
 //#endregion
+//#region src/constants/vault-ids.d.ts
+/**
+ * Vault ID constants for backward compatibility
+ * These are auto-generated from the vault registry
+ */
+declare enum VaultId {
+  /** CTA-Adaptive Alpha - Atlas Research */
+  cta_adaptive_alpha_atlas_research_72 = 72,
+  /** Hyperithm Cross-Exchange Arb */
+  hyperithm_cross_exchange_arb_71 = 71,
+  /** Lighter LLP */
+  lighter_llp_70 = 70,
+  /** JLP Delta Neutral - vault-jupiter */
+  jlp_delta_neutral_vault_jupiter_69 = 69,
+  /** SOL Super Staking - Perps */
+  sol_super_staking_perps_68 = 68,
+  /** Aster Funding Arb */
+  aster_funding_arb_67 = 67,
+  /** Moon LP */
+  moon_lp_66 = 66,
+  /** JLP Delta Neutral - Vault-CEX */
+  jlp_delta_neutral_vault_cex_65 = 65,
+  /** JLP Delta Neutral - vip24 */
+  jlp_delta_neutral_vip24_64 = 64,
+  /** JLP Delta Neutral - vip23 */
+  jlp_delta_neutral_vip23_63 = 63,
+  /** JLP Delta Neutral - vip22 */
+  jlp_delta_neutral_vip22_62 = 62,
+  /** USDC Max Yield - Kamino Lending */
+  usdc_max_yield_kamino_lending_61 = 61,
+  /** NT Earn */
+  nt_earn_60 = 60,
+  /** JLP Delta Neutral - Perena */
+  jlp_delta_neutral_perena_59 = 59,
+  /** Memes ETF - Generational Wealth */
+  memes_etf_generational_wealth_58 = 58,
+  /** JLP Delta Neutral - vip21 */
+  jlp_delta_neutral_vip21_57 = 57,
+  /** BTC Dominance */
+  btc_dominance_56 = 56,
+  /** Alt Dominance */
+  alt_dominance_55 = 55,
+  /** HYPE / SOL Pairs Trade */
+  hype_sol_pairs_trade_54 = 54,
+  /** The Big Short */
+  the_big_short_53 = 53,
+  /** CTA Momentum - R* Research */
+  cta_momentum_r_research_52 = 52,
+  /** Term Max */
+  term_max_51 = 51,
+  /** ALP Delta Neutral Forest */
+  alp_delta_neutral_forest_50 = 50,
+  /** ALP Delta Neutral */
+  alp_delta_neutral_49 = 49,
+  /** Hyperliquid Funding Arb */
+  hyperliquid_funding_arb_48 = 48,
+  /** Long BONK, Short PUMP */
+  long_bonk_short_pump_47 = 47,
+  /** Hyper JLP */
+  hyper_jlp_46 = 46,
+  /** FART Dominance - Hot Air Rises */
+  fart_dominance_hot_air_rises_45 = 45,
+  /** BTC Dominance */
+  btc_dominance_44 = 44,
+  /** JLP Delta Neutral - vip team */
+  jlp_delta_neutral_vip_team_43 = 43,
+  /** BTC Savings - Drawdown Protected */
+  btc_savings_drawdown_protected_42 = 42,
+  /** ETH Savings - Drawdown Protected */
+  eth_savings_drawdown_protected_41 = 41,
+  /** SOL Savings - Drawdown Protected */
+  sol_savings_drawdown_protected_40 = 40,
+  /** USDC Savings - Drawdown Protected */
+  usdc_savings_drawdown_protected_39 = 39,
+  /** FUEL Maxi */
+  fuel_maxi_38 = 38,
+  /** Inverse JLP DN - The Big Short */
+  inverse_jlp_dn_the_big_short_37 = 37,
+  /** JLP Delta Neutral - Neutralized JLP */
+  jlp_delta_neutral_neutralized_jlp_36 = 36,
+  /** JLP Delta Neutral - vip20 */
+  jlp_delta_neutral_vip20_35 = 35,
+  /** JLP Delta Neutral - vip19 */
+  jlp_delta_neutral_vip19_34 = 34,
+  /** JLP Delta Neutral - Project Super */
+  jlp_delta_neutral_project_super_33 = 33,
+  /** JLP Delta Neutral - vip pool 1 */
+  jlp_delta_neutral_vip_pool_1_32 = 32,
+  /** JLP Delta Neutral - Drift-5 */
+  jlp_delta_neutral_drift_5_31 = 31,
+  /** Long SOL, Short ETH - Solana Flippening */
+  long_sol_short_eth_solana_flippening_30 = 30,
+  /** JLP Delta Neutral - Drift-4 */
+  jlp_delta_neutral_drift_4_29 = 29,
+  /** JLP Delta Neutral - vip18 */
+  jlp_delta_neutral_vip18_28 = 28,
+  /** JLP Delta Neutral - vip17 */
+  jlp_delta_neutral_vip17_27 = 27,
+  /** BTC Super Staking - tangem */
+  btc_super_staking_tangem_26 = 26,
+  /** JLP Delta Neutral - tangem */
+  jlp_delta_neutral_tangem_25 = 25,
+  /** JLP Delta Neutral - vip16 */
+  jlp_delta_neutral_vip16_24 = 24,
+  /** JLP Delta Neutral - vip15 */
+  jlp_delta_neutral_vip15_23 = 23,
+  /** JLP Delta Neutral - vip14 */
+  jlp_delta_neutral_vip14_22 = 22,
+  /** SOL Momentum - CTA-Marco */
+  sol_momentum_cta_marco_21 = 21,
+  /** JLP Delta Neutral - vip13 */
+  jlp_delta_neutral_vip13_20 = 20,
+  /** JLP Delta Neutral - vip12 */
+  jlp_delta_neutral_vip12_19 = 19,
+  /** JLP Delta Neutral - vip11 */
+  jlp_delta_neutral_vip11_18 = 18,
+  /** USDC Staking - vip10 */
+  usdc_staking_vip10_17 = 17,
+  /** JLP Delta Neutral - Drift-3 */
+  jlp_delta_neutral_drift_3_16 = 16,
+  /** SOL Super Staking - vip8 */
+  sol_super_staking_vip8_15 = 15,
+  /** JLP Delta Neutral - vip7 */
+  jlp_delta_neutral_vip7_14 = 14,
+  /** JLP Delta Neutral - vip6 */
+  jlp_delta_neutral_vip6_13 = 13,
+  /** JLP Delta Neutral - vip5 */
+  jlp_delta_neutral_vip5_12 = 12,
+  /** USDC Basis - Perps Basket */
+  usdc_basis_perps_basket_11 = 11,
+  /** JLP Delta Neutral - vip3 */
+  jlp_delta_neutral_vip3_10 = 10,
+  /** JLP Delta Neutral - vip2 */
+  jlp_delta_neutral_vip2_9 = 9,
+  /** Drift funding arb */
+  drift_funding_arb_8 = 8,
+  /** JLP Traders Print */
+  jlp_traders_print_7 = 7,
+  /** ETH Super Staking */
+  eth_super_staking_6 = 6,
+  /** JLP Delta Neutral - vip1 */
+  jlp_delta_neutral_vip1_5 = 5,
+  /** JLP Delta Neutral - Drift-2 */
+  jlp_delta_neutral_drift_2_4 = 4,
+  /** BTC Super Staking */
+  btc_super_staking_3 = 3,
+  /** JLP Traders Rekt */
+  jlp_traders_rekt_2 = 2,
+  /** SOL Super Staking */
+  sol_super_staking_1 = 1,
+  /** JLP Delta Neutral - vault-1 */
+  jlp_delta_neutral_vault_1_0 = 0,
+}
+//#endregion
 //#region src/types/tokens.d.ts
 declare enum SupportedChain {
   Solana = "Solana",
@@ -4961,105 +5115,37 @@ interface Token {
 }
 declare const tokens: { [name in SupportedToken]: Token };
 //#endregion
+//#region src/types/bundle-types.d.ts
+type UserBundleAccount = IdlAccounts<NtbundleV1>['userBundleAccount'] | IdlAccounts$1<NtbundleV2>['userBundleAccount'];
+type OracleData = IdlAccounts<NtbundleV1>['oracleData'] | IdlAccounts$1<NtbundleV2>['oracleData'];
+type BundleAccount = IdlAccounts<NtbundleV1>['bundle'] | IdlAccounts$1<NtbundleV2>['bundle'];
+//#endregion
 //#region src/types/vault-types.d.ts
-declare enum VaultId {
-  jlpdnv1 = 0,
-  solnl = 1,
-  rekt = 2,
-  btcnl = 3,
-  jlpdnv2 = 4,
-  vip1 = 5,
-  ethnl = 6,
-  print = 7,
-  solbasisinf = 8,
-  vip2 = 9,
-  vip3 = 10,
-  perpsbasket = 11,
-  vip5 = 12,
-  vip6 = 13,
-  vip7 = 14,
-  vip8 = 15,
-  jlpdnv3 = 16,
-  vip10 = 17,
-  vip11 = 18,
-  vip12 = 19,
-  vip13 = 20,
-  solctamarco = 21,
-  vip14 = 22,
-  vip15 = 23,
-  vip16 = 24,
-  usdctangem = 25,
-  btctangem = 26,
-  vip17 = 27,
-  vip18 = 28,
-  jlpdnv4 = 29,
-  solethflip = 30,
-  jlpdnv5 = 31,
-  vip1ag = 32,
-  usdcsuper = 33,
-  vip19 = 34,
-  vip20 = 35,
-  neutralizedjlp = 36,
-  thebigshort = 37,
-  fuelmaxi = 38,
-  usdcsavings = 39,
-  solsavings = 40,
-  ethsavings = 41,
-  btcsavings = 42,
-  jlpdnteam = 43,
-  btcdom = 44,
-  fartdom = 45,
-  hyperjlp = 46,
-  bonkpump = 47,
-  nmmjlpdn = 57,
-  memesetf = 58,
-  annafromperena = 59,
-  vip22 = 62,
-  vip23 = 63,
-  vip24 = 64,
-  solnlperps = 68,
-  hlbigshort = 53,
-  hlhypesol = 54,
-  hlaltdom = 55,
-  hlbtcdom = 56,
-  kaminolend = 61,
-  hlfundingarb = 48,
-  alpdn = 49,
-  // vip
-  alpdnforest = 50,
-  // vip
-  termmax = 51,
-  ctamomentumrresearch = 52,
-  ntearnusdc = 60,
-  jlpdnbundle = 65,
-  moonlp = 66,
-  asterfundingarb = 67,
-  jlpdnjupiter = 69,
-  lighterllp1 = 70,
-  hyperithm1 = 71,
-}
 declare enum VaultType {
   Drift = "Drift",
   Bundle = "Bundle",
   Hyperliquid = "Hyperliquid",
   Kamino = "Kamino",
 }
-interface VaultConfig {
-  vaultId: VaultId;
+/** Raw vault entry from registry JSON (without program IDs) */
+interface VaultRegistryEntry {
+  vaultId: number;
   name: string;
   subname?: string;
   type: VaultType;
   vaultAddress: string;
   depositToken: SupportedToken;
-  bundleProgramId?: BundleProgramId;
+  pfee?: number;
+}
+/** Vault config with required program IDs (transformed from registry entry) */
+interface VaultConfig extends VaultRegistryEntry {
+  /** Required for Drift vaults */
   driftProgramId?: string;
-  pfee: number;
+  /** Required for Bundle vaults */
+  bundleProgramId?: string;
 }
-//#endregion
-//#region src/types/bundle-types.d.ts
-type UserBundleAccount = IdlAccounts<NtbundleV1>['userBundleAccount'] | IdlAccounts$1<NtbundleV2>['userBundleAccount'];
-type OracleData = IdlAccounts<NtbundleV1>['oracleData'] | IdlAccounts$1<NtbundleV2>['oracleData'];
-type BundleAccount = IdlAccounts<NtbundleV1>['bundle'] | IdlAccounts$1<NtbundleV2>['bundle'];
+/** Vault registry as a record keyed by vaultId */
+type VaultConfigRecord = Record<number, VaultConfig>;
 //#endregion
 //#region src/types/index.d.ts
 interface VaultBalanceData {
@@ -5082,13 +5168,23 @@ interface VaultBalanceData {
   netDeposit?: number;
   asset: SupportedToken;
 }
-type UserBalanceResult = Record<VaultId, VaultBalanceData | null>;
+type UserBalanceResult = Record<number, VaultBalanceData | null>;
 //#endregion
 //#region src/constants/vaults.d.ts
-declare const vaults: Partial<Record<VaultId, VaultConfig>>;
+/**
+ * Get Bundle Program ID for a vault
+ * All bundle vaults use V1 except vaultId 69 and 72 which use V2
+ */
+declare function getBundleProgramId(vaultId: number): BundleProgramId;
+/**
+ * Get Drift Program ID for a vault
+ * All drift vaults use default program ID except vaultId 0
+ */
+declare function getDriftProgramPK(vaultId: number): PublicKey;
+declare const vaults: VaultConfigRecord;
 declare function isValidVaultAddress(address: string): boolean;
 declare function getVaultByAddress(address: string): VaultConfig | undefined;
-declare function getVaultById(vaultId: VaultId): VaultConfig | undefined;
+declare function getVaultById(vaultId: number): VaultConfig | undefined;
 //#endregion
 //#region src/NeutralTrade.d.ts
 interface NeutralTradeConfig {
@@ -5104,7 +5200,7 @@ declare class NeutralTrade {
   readonly bundleProgramV2: Program$1<NtbundleV2>;
   readonly driftVaultClient: VaultClient;
   /** Vault configurations (built-in merged with remote if registryUrl was provided) */
-  readonly vaults: Partial<Record<VaultId, VaultConfig>>;
+  readonly vaults: VaultConfigRecord;
   /** Price map for deposit tokens */
   readonly priceMap: Map<SupportedToken, number>;
   private constructor();
@@ -5116,6 +5212,7 @@ declare class NeutralTrade {
   static create(config: NeutralTradeConfig): Promise<NeutralTrade>;
   /**
    * Fetch vault configurations from a remote registry URL
+   * Expects JSON array format and transforms to Record<number, VaultConfig>
    * @throws Error if fetch fails or validation fails
    */
   private static fetchVaultsFromRegistry;
@@ -5126,7 +5223,7 @@ declare class NeutralTrade {
     vaultIds,
     userAddress
   }: {
-    vaultIds: VaultId[];
+    vaultIds: number[];
     userAddress: string;
   }): Promise<UserBalanceResult>;
 }
@@ -5146,4 +5243,4 @@ declare function deriveUserPDA(userKey: PublicKey, bundlePDA: PublicKey, program
  */
 declare function getVaultDepositorAddressSync(programId: PublicKey, vault: PublicKey, authority: PublicKey): PublicKey;
 //#endregion
-export { type BundleAccount, BundleProgramId, NeutralTrade, type NeutralTradeConfig, type OracleData, SupportedChain, SupportedToken, type Token, type UserBalanceResult, type UserBundleAccount, type VaultBalanceData, type VaultConfig, VaultId, VaultType, deriveOraclePDA, deriveUserPDA, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, isValidVaultAddress, tokens, vaults };
+export { type BundleAccount, BundleProgramId, NeutralTrade, type NeutralTradeConfig, type OracleData, SupportedChain, SupportedToken, type Token, type UserBalanceResult, type UserBundleAccount, type VaultBalanceData, type VaultConfig, type VaultConfigRecord, VaultId, VaultType, deriveOraclePDA, deriveUserPDA, getBundleProgramId, getDriftProgramPK, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, isValidVaultAddress, tokens, vaults };