@neutral-trade/sdk 0.1.2 → 0.1.3

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,150 @@ 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,
+  /** 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,
+  /** NT Earn */
+  nt_earn_60 = 60,
+  /** 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,
+  /** JLP Delta Neutral - vault-1 */
+  jlp_delta_neutral_vault_1_0 = 0,
+  /** SOL Super Staking */
+  sol_super_staking_1 = 1,
+  /** JLP Traders Rekt */
+  jlp_traders_rekt_2 = 2,
+  /** BTC Super Staking */
+  btc_super_staking_3 = 3,
+  /** JLP Delta Neutral - Drift-2 */
+  jlp_delta_neutral_drift_2_4 = 4,
+  /** JLP Delta Neutral - vip1 */
+  jlp_delta_neutral_vip1_5 = 5,
+  /** ETH Super Staking */
+  eth_super_staking_6 = 6,
+  /** JLP Traders Print */
+  jlp_traders_print_7 = 7,
+  /** Drift funding arb */
+  drift_funding_arb_8 = 8,
+  /** JLP Delta Neutral - vip2 */
+  jlp_delta_neutral_vip2_9 = 9,
+  /** JLP Delta Neutral - vip3 */
+  jlp_delta_neutral_vip3_10 = 10,
+  /** USDC Basis - Perps Basket */
+  usdc_basis_perps_basket_11 = 11,
+  /** JLP Delta Neutral - vip5 */
+  jlp_delta_neutral_vip5_12 = 12,
+  /** JLP Delta Neutral - vip6 */
+  jlp_delta_neutral_vip6_13 = 13,
+  /** JLP Delta Neutral - vip7 */
+  jlp_delta_neutral_vip7_14 = 14,
+  /** SOL Super Staking - vip8 */
+  sol_super_staking_vip8_15 = 15,
+  /** JLP Delta Neutral - Drift-3 */
+  jlp_delta_neutral_drift_3_16 = 16,
+  /** USDC Staking - vip10 */
+  usdc_staking_vip10_17 = 17,
+  /** JLP Delta Neutral - vip11 */
+  jlp_delta_neutral_vip11_18 = 18,
+  /** JLP Delta Neutral - vip12 */
+  jlp_delta_neutral_vip12_19 = 19,
+  /** JLP Delta Neutral - vip13 */
+  jlp_delta_neutral_vip13_20 = 20,
+  /** SOL Momentum - CTA-Marco */
+  sol_momentum_cta_marco_21 = 21,
+  /** JLP Delta Neutral - vip14 */
+  jlp_delta_neutral_vip14_22 = 22,
+  /** JLP Delta Neutral - vip15 */
+  jlp_delta_neutral_vip15_23 = 23,
+  /** JLP Delta Neutral - vip16 */
+  jlp_delta_neutral_vip16_24 = 24,
+  /** JLP Delta Neutral - tangem */
+  jlp_delta_neutral_tangem_25 = 25,
+  /** BTC Super Staking - tangem */
+  btc_super_staking_tangem_26 = 26,
+  /** JLP Delta Neutral - vip17 */
+  jlp_delta_neutral_vip17_27 = 27,
+  /** JLP Delta Neutral - vip18 */
+  jlp_delta_neutral_vip18_28 = 28,
+  /** JLP Delta Neutral - Drift-4 */
+  jlp_delta_neutral_drift_4_29 = 29,
+  /** Long SOL, Short ETH - Solana Flippening */
+  long_sol_short_eth_solana_flippening_30 = 30,
+  /** JLP Delta Neutral - Drift-5 */
+  jlp_delta_neutral_drift_5_31 = 31,
+  /** JLP Delta Neutral - vip pool 1 */
+  jlp_delta_neutral_vip_pool_1_32 = 32,
+  /** JLP Delta Neutral - Project Super */
+  jlp_delta_neutral_project_super_33 = 33,
+  /** JLP Delta Neutral - vip19 */
+  jlp_delta_neutral_vip19_34 = 34,
+  /** JLP Delta Neutral - vip20 */
+  jlp_delta_neutral_vip20_35 = 35,
+  /** JLP Delta Neutral - Neutralized JLP */
+  jlp_delta_neutral_neutralized_jlp_36 = 36,
+  /** Inverse JLP DN - The Big Short */
+  inverse_jlp_dn_the_big_short_37 = 37,
+  /** FUEL Maxi */
+  fuel_maxi_38 = 38,
+  /** USDC Savings - Drawdown Protected */
+  usdc_savings_drawdown_protected_39 = 39,
+  /** SOL Savings - Drawdown Protected */
+  sol_savings_drawdown_protected_40 = 40,
+  /** ETH Savings - Drawdown Protected */
+  eth_savings_drawdown_protected_41 = 41,
+  /** BTC Savings - Drawdown Protected */
+  btc_savings_drawdown_protected_42 = 42,
+  /** JLP Delta Neutral - vip team */
+  jlp_delta_neutral_vip_team_43 = 43,
+  /** BTC Dominance */
+  btc_dominance_44 = 44,
+  /** FART Dominance - Hot Air Rises */
+  fart_dominance_hot_air_rises_45 = 45,
+  /** Hyper JLP */
+  hyper_jlp_46 = 46,
+  /** Long BONK, Short PUMP */
+  long_bonk_short_pump_47 = 47,
+  /** JLP Delta Neutral - vip21 */
+  jlp_delta_neutral_vip21_57 = 57,
+  /** Memes ETF - Generational Wealth */
+  memes_etf_generational_wealth_58 = 58,
+  /** JLP Delta Neutral - Perena */
+  jlp_delta_neutral_perena_59 = 59,
+  /** JLP Delta Neutral - vip22 */
+  jlp_delta_neutral_vip22_62 = 62,
+  /** JLP Delta Neutral - vip23 */
+  jlp_delta_neutral_vip23_63 = 63,
+  /** JLP Delta Neutral - vip24 */
+  jlp_delta_neutral_vip24_64 = 64,
+  /** SOL Super Staking - Perps */
+  sol_super_staking_perps_68 = 68,
+}
+//#endregion
 //#region src/types/tokens.d.ts
 declare enum SupportedChain {
   Solana = "Solana",
@@ -4961,105 +5105,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 +5158,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 +5190,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 +5202,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 +5213,7 @@ declare class NeutralTrade {
     vaultIds,
     userAddress
   }: {
-    vaultIds: VaultId[];
+    vaultIds: number[];
     userAddress: string;
   }): Promise<UserBalanceResult>;
 }
@@ -5146,4 +5233,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 };