@neutral-trade/sdk 0.2.8 → 0.2.11

package/dist/index.d.mts

@@ -3030,10 +3030,12 @@ declare function createBundleProgramById(provider: AnchorProvider, programId: st
 //#endregion
 //#region src/constants/vault-ids.d.ts
 /**
- * Vault ID constants for backward compatibility
- * These are auto-generated from the vault registry
+ * Vault ID constants (VaultId)
+ * Auto-generated from the vault registry JSON.
  */
 declare enum VaultId {
+  /** Velox-Cross-USDC-Bundle */
+  velox_cross_usdc_bundle_78 = 78,
   /** Hyperithm-CTA-USDC-Bundle */
   hyperithm_cta_usdc_bundle_77 = 77,
   /** Master Bundle */
@@ -3192,6 +3194,16 @@ declare enum VaultId {
   jlp_delta_neutral_vault_1_0 = 0,
 }
 //#endregion
+//#region src/constants/vault-ids.devnet.d.ts
+/**
+ * Vault ID constants (DevnetVaultId)
+ * Auto-generated from the vault registry JSON.
+ */
+declare enum DevnetVaultId {
+  /** Dev1 */
+  dev1_100000001 = 100000001,
+}
+//#endregion
 //#region src/types/tokens.d.ts
 declare enum SupportedChain {
   Solana = "Solana",
@@ -3214,6 +3226,13 @@ interface Token {
   } | null };
 }
 declare const tokens: { [name in SupportedToken]: Token };
+/**
+ * Solana mint address for a supported token, keyed by bundle cluster.
+ * Devnet USDC uses the team mock mint; other tokens use mainnet table until devnet overrides exist.
+ */
+declare function getSolanaTokenMint(token: SupportedToken, cluster?: BundleCluster): string;
+/** SPL decimals for `token` (same on mainnet vs devnet for current overrides). */
+declare function getSolanaTokenDecimals(token: SupportedToken): number;
 //#endregion
 //#region src/types/bundle-types.d.ts
 type UserBundleAccount = IdlAccounts<Ntbundle>['userBundleAccount'];
@@ -3293,17 +3312,21 @@ type UserBalanceResult = Record<number, VaultBalanceData | null>;
  * Uses registry value if present, otherwise falls back to cluster default.
  */
 declare function getBundleProgramId(vault: VaultRegistryEntry, cluster?: BundleCluster): string | undefined;
+/** Mainnet registry (default; backward compatible). */
 declare const vaults: VaultRegistry;
-declare function isValidVaultAddress(address: string): boolean;
-declare function getVaultByAddress(address: string): VaultRegistryEntry | undefined;
-declare function getVaultById(vaultId: number): VaultRegistryEntry | undefined;
+/** Devnet-only vault registry (fixtures / local testing). */
+declare const vaultsDevnet: VaultRegistry;
+declare function getVaultRegistry(cluster: BundleCluster): VaultRegistry;
+declare function isValidVaultAddress(address: string, cluster?: BundleCluster): boolean;
+declare function getVaultByAddress(address: string, cluster?: BundleCluster): VaultRegistryEntry | undefined;
+declare function getVaultById(vaultId: number, cluster?: BundleCluster): VaultRegistryEntry | undefined;
 //#endregion
 //#region src/NeutralTrade.d.ts
 interface NeutralTradeConfig {
   rpcUrl: string;
   /** Bundle program cluster selector. Defaults to 'mainnet'. */
   bundleCluster?: BundleCluster;
-  /** If true, include built-in vault registry entries only when no custom registry source is provided. Defaults to true. */
+  /** If true, include built-in vault registry for `bundleCluster` (mainnet vs devnet fixtures). Defaults to true. */
   includeBuiltInVaults?: boolean;
   /** Optional local registry entries. Applied after built-in configs and before registryUrl (if provided). */
   registry?: VaultRegistryEntry[];
@@ -3322,14 +3345,14 @@ declare class NeutralTrade {
   readonly connection: Connection;
   readonly bundlePrograms: Record<string, Program<Ntbundle>>;
   readonly bundleCluster: BundleCluster;
-  /** Vault configurations after merge order: built-in < local registry < registryUrl */
+  /** Vault configurations after merge order: built-in (cluster-specific) < local registry < registryUrl */
   readonly vaults: VaultRegistry;
   /** Price map for deposit tokens */
   readonly priceMap: Map<SupportedToken, number>;
   protected constructor(connection: Connection, bundlePrograms: Record<string, Program<Ntbundle>>, bundleCluster: BundleCluster, vaults: VaultRegistry, priceMap: Map<SupportedToken, number>);
   /**
    * Create a new NeutralTrade instance
-   * Merge order: built-in (when allowed) < local registry < registryUrl
+   * Merge order: built-in catalog for `bundleCluster` (when allowed) < local registry < registryUrl
    * @throws Error if registry or registryUrl validation fails (or fetch fails for registryUrl)
    */
   protected static initCore(config: NeutralTradeConfig): Promise<NeutralTradeCoreContext>;
@@ -3447,4 +3470,4 @@ declare function derivePendingAuthPDA(bundlePDA: PublicKey, programId: PublicKey
  */
 declare function getVaultDepositorAddressSync(programId: PublicKey, vault: PublicKey, authority: PublicKey): PublicKey;
 //#endregion
-export { BUNDLE_PROGRAM_ID_V2_MAINNET, type BundleAccount, type BundleCluster, type BundleProgram, type BundleProvider, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, 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, type VaultRegistryEntry as VaultConfig, type VaultRegistry as VaultConfigRecord, VaultId, VaultType, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, isValidVaultAddress, tokens, vaults };
+export { BUNDLE_PROGRAM_ID_V2_MAINNET, 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, type VaultRegistryEntry as VaultConfig, type VaultRegistry as VaultConfigRecord, VaultId, VaultType, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, isValidVaultAddress, tokens, vaults, vaultsDevnet };

package/dist/index.mjs

@@ -11613,10 +11613,12 @@ function createBundleProgramById(provider, programId) {
 //#endregion
 //#region src/constants/vault-ids.ts
 /**
-* Vault ID constants for backward compatibility
-* These are auto-generated from the vault registry
+* Vault ID constants (VaultId)
+* Auto-generated from the vault registry JSON.
 */
 let VaultId = /* @__PURE__ */ function(VaultId$1) {
+	/** Velox-Cross-USDC-Bundle */
+	VaultId$1[VaultId$1["velox_cross_usdc_bundle_78"] = 78] = "velox_cross_usdc_bundle_78";
 	/** Hyperithm-CTA-USDC-Bundle */
 	VaultId$1[VaultId$1["hyperithm_cta_usdc_bundle_77"] = 77] = "hyperithm_cta_usdc_bundle_77";
 	/** Master Bundle */
@@ -11776,9 +11778,45 @@ let VaultId = /* @__PURE__ */ function(VaultId$1) {
 	return VaultId$1;
 }({});
 
+//#endregion
+//#region src/constants/vault-ids.devnet.ts
+/**
+* Vault ID constants (DevnetVaultId)
+* Auto-generated from the vault registry JSON.
+*/
+let DevnetVaultId = /* @__PURE__ */ function(DevnetVaultId$1) {
+	/** Dev1 */
+	DevnetVaultId$1[DevnetVaultId$1["dev1_100000001"] = 100000001] = "dev1_100000001";
+	return DevnetVaultId$1;
+}({});
+
+//#endregion
+//#region src/registry/vaults.devnet.json
+var vaults_devnet_default = [{
+	"vaultId": 100000001,
+	"name": "Dev1",
+	"type": "Bundle",
+	"category": "Market Neutral",
+	"vaultAddress": "EUs1XqK5Fr7DXxS5NTy2yYd3jehfYFJ4WYefesDf6iy3",
+	"depositToken": "USDC",
+	"bundleProgramId": "7trSyt7d1ZRnvfGh9JaQZwZMWtfAXMvMwN3UxgMzVFbv",
+	"pointsMultiplier": 1,
+	"pointsEnabled": false
+}];
+
 //#endregion
 //#region src/registry/vaults.json
 var vaults_default = [
+	{
+		"vaultId": 78,
+		"name": "Velox-Cross-USDC-Bundle",
+		"type": "Bundle",
+		"category": "Market Neutral",
+		"vaultAddress": "De47QBuMP7xukYBek5r4ScZF4HEk1kHW34ymKASz3DLt",
+		"depositToken": "USDC",
+		"pointsMultiplier": 1,
+		"pointsEnabled": true
+	},
 	{
 		"vaultId": 77,
 		"name": "Hyperithm-CTA-USDC-Bundle",
@@ -12716,6 +12754,27 @@ const tokens = {
 		}
 	}
 };
+/** Devnet SPL mint overrides (`depositToken` still uses `SupportedToken`). */
+const SOLANA_MINT_OVERRIDES_DEVNET = { [SupportedToken.USDC]: "6a8hWCCa2QDQTqzLUapZwZtgHTox8BsgataN6JVLwdo7" };
+/**
+* Solana mint address for a supported token, keyed by bundle cluster.
+* Devnet USDC uses the team mock mint; other tokens use mainnet table until devnet overrides exist.
+*/
+function getSolanaTokenMint(token, cluster = "mainnet") {
+	const row = tokens[token].onChain[SupportedChain.Solana];
+	if (!row) throw new Error(`No Solana mint configured for ${token}`);
+	if (cluster === "devnet") {
+		const override = SOLANA_MINT_OVERRIDES_DEVNET[token];
+		if (override) return override;
+	}
+	return row.address;
+}
+/** SPL decimals for `token` (same on mainnet vs devnet for current overrides). */
+function getSolanaTokenDecimals(token) {
+	const row = tokens[token].onChain[SupportedChain.Solana];
+	if (!row) throw new Error(`No Solana decimals configured for ${token}`);
+	return row.decimals;
+}
 
 //#endregion
 //#region src/types/vault-types.ts
@@ -12803,16 +12862,25 @@ function toVaultConfig(entry) {
 function toVaultRegistry(entries) {
 	return Object.fromEntries(entries.map((entry) => [entry.vaultId, toVaultConfig(entry)]));
 }
-const parsedVaults = VaultRegistryArraySchema.parse(vaults_default);
-const vaults = toVaultRegistry(parsedVaults);
-function isValidVaultAddress(address$2) {
-	return Object.values(vaults).map((vault) => vault.vaultAddress).includes(address$2);
+const parsedVaultsMainnet = VaultRegistryArraySchema.parse(vaults_default);
+const parsedVaultsDevnet = VaultRegistryArraySchema.parse(vaults_devnet_default);
+const vaultsMainnetRegistry = toVaultRegistry(parsedVaultsMainnet);
+const vaultsDevnetRegistry = toVaultRegistry(parsedVaultsDevnet);
+/** Mainnet registry (default; backward compatible). */
+const vaults = vaultsMainnetRegistry;
+/** Devnet-only vault registry (fixtures / local testing). */
+const vaultsDevnet = vaultsDevnetRegistry;
+function getVaultRegistry(cluster) {
+	return cluster === "devnet" ? vaultsDevnetRegistry : vaultsMainnetRegistry;
+}
+function isValidVaultAddress(address$2, cluster = "mainnet") {
+	return Object.values(getVaultRegistry(cluster)).map((vault) => vault.vaultAddress).includes(address$2);
 }
-function getVaultByAddress(address$2) {
-	return Object.values(vaults).find((v) => v.vaultAddress === address$2);
+function getVaultByAddress(address$2, cluster = "mainnet") {
+	return Object.values(getVaultRegistry(cluster)).find((v) => v.vaultAddress === address$2);
 }
-function getVaultById(vaultId) {
-	return vaults[vaultId];
+function getVaultById(vaultId, cluster = "mainnet") {
+	return getVaultRegistry(cluster)[vaultId];
 }
 
 //#endregion
@@ -13192,7 +13260,7 @@ var NeutralTrade = class NeutralTrade {
 	connection;
 	bundlePrograms;
 	bundleCluster;
-	/** Vault configurations after merge order: built-in < local registry < registryUrl */
+	/** Vault configurations after merge order: built-in (cluster-specific) < local registry < registryUrl */
 	vaults;
 	/** Price map for deposit tokens */
 	priceMap;
@@ -13205,14 +13273,14 @@ var NeutralTrade = class NeutralTrade {
 	}
 	/**
 	* Create a new NeutralTrade instance
-	* Merge order: built-in (when allowed) < local registry < registryUrl
+	* Merge order: built-in catalog for `bundleCluster` (when allowed) < local registry < registryUrl
 	* @throws Error if registry or registryUrl validation fails (or fetch fails for registryUrl)
 	*/
 	static async initCore(config) {
 		const connection = createConnection(config.rpcUrl);
 		const provider = createAnchorProvider(connection);
 		const cluster = config.bundleCluster ?? "mainnet";
-		let vaults$1 = config.includeBuiltInVaults !== false ? { ...vaults } : {};
+		let vaults$1 = config.includeBuiltInVaults !== false ? { ...getVaultRegistry(cluster) } : {};
 		if (config.registry) {
 			const localVaults = NeutralTrade.parseVaultRegistryEntries(config.registry, "registry");
 			vaults$1 = {
@@ -13320,4 +13388,4 @@ var NeutralTrade = class NeutralTrade {
 };
 
 //#endregion
-export { BUNDLE_PROGRAM_ID_V2_MAINNET, DEFAULT_BUNDLE_PROGRAM_ID_DEVNET, DEFAULT_BUNDLE_PROGRAM_ID_MAINNET, NeutralTrade, SEED_ORACLE, SEED_PENDING_AUTH, SEED_TEMP, SEED_USER, SupportedChain, SupportedToken, VaultCategory, VaultId, VaultType, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, isValidVaultAddress, tokens, vaults };
+export { 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, buildBundleDepositInstructions, buildBundleRequestWithdrawInstruction, createBundleProgramById, createDummyWallet, deriveOraclePDA, derivePendingAuthPDA, deriveTempDataPDA, deriveUserPDA, getBundleProgramId, getDefaultBundleProgramIdByCluster, getSolanaTokenDecimals, getSolanaTokenMint, getVaultByAddress, getVaultById, getVaultDepositorAddressSync, getVaultRegistry, isValidVaultAddress, tokens, vaults, vaultsDevnet };

package/package.json

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