Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt

Use this file to discover all available pages before exploring further.

Track Dynamic Vault integration changes here. This page is initialized from the local vault-sdk/CHANGELOG.md and the inspected local program and Rust client sources.
Source snapshot
Program and client sources referenced for this documentation pass

Components

ComponentLocal sourceNotes
Programmercurial-vault/programs/vaultAnchor program crate version 0.9.4; Anchor toolchain 0.31.1; public program ID 24Uqj9JCLxUeoC3hGfh5W3s9FM9uCHDS2SG3LYwBpyTi.
TypeScript SDKvault-sdk/ts-clientPackage @meteora-ag/vault-sdk version 2.3.1; web3.js v1 transaction model.
Rust clientvault-sdk/rust-clientCLI helper for show, get-unlocked-amount, deposit, and withdraw flows.
Data APIdeveloper-guides/dynamic-vault/api-reference/openapi.jsonOpenAPI 0.6.0 for Dynamic Vault keeper routes.

Integration Notes

  • The current program source includes initialize_idle_vault, transfer_fee_vault, remove_strategy2, InvalidPrecisionLoss, UndeterminedError, and JupLend strategy support.
  • The checked-in TypeScript IDL in vault-sdk is older than the current program source in a few areas. Decode errors by numeric code first when source and IDL names differ.
  • The TypeScript SDK withdraw parameter named baseTokenAmount is passed to the program as LP unmint_amount; callers should pass LP token units.
@meteora-ag/vault-sdk 2.3.1
Removed token registry dependency

Changed

AreaChange
DependenciesRemoved @solana/spl-token-registry.

Upgrade Note

Pass token mint PublicKey values directly to VaultImpl.create, createMultiple, and related helpers. Do not rely on token registry TokenInfo objects for SDK initialization.
@meteora-ag/vault-sdk 2.3.0
Moved package ownership to Meteora

Changed

AreaChange
PackageMoved to the meteora-ag organization.

Upgrade Note

Use the package name @meteora-ag/vault-sdk for new integrations.
@mercurial-finance/vault-sdk 2.2.x
Batch loading and mint parsing updates

Added

VersionChange
2.2.1Added deserializeMint utility.

Changed

VersionChange
2.2.0Fixed tokenMint and tokenLpMint.
2.1.1Optimized createMultiple and createMultiplePda RPC usage.
2.1.0Updated createMultiple to take fewer parameters.

Removed

VersionChange
2.2.0Removed lpMintPda field.
@mercurial-finance/vault-sdk 2.0.x
Dependency updates and withdrawal logic change

Changed

VersionChange
2.0.0Updated @solana/spl-token to 0.4.6 and related packages.

Fixed

VersionChange
2.0.1Fixed refreshVaultState.

Removed

VersionChange
2.0.0Removed older direct-strategy withdrawal logic from the package.

Source Gaps

GapImpact
No local program changelog was found in mercurial-vault.Program changes are documented here as a source snapshot, not as versioned release notes.
Public TS IDL is older than the current program source.Low-level integrators should compare against current source or regenerated IDL before manual instruction construction.
The provided production Swagger URL serves Dynamic AMM keeper routes.Dynamic Vault API docs use the checked-in Dynamic Vault OpenAPI file and live merv2-api route checks.