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.
Components
| Component | Local source | Notes |
|---|
| Program | mercurial-vault/programs/vault | Anchor program crate version 0.9.4; Anchor toolchain 0.31.1; public program ID 24Uqj9JCLxUeoC3hGfh5W3s9FM9uCHDS2SG3LYwBpyTi. |
| TypeScript SDK | vault-sdk/ts-client | Package @meteora-ag/vault-sdk version 2.3.1; web3.js v1 transaction model. |
| Rust client | vault-sdk/rust-client | CLI helper for show, get-unlocked-amount, deposit, and withdraw flows. |
| Data API | developer-guides/dynamic-vault/api-reference/openapi.json | OpenAPI 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.
Changed
| Area | Change |
|---|
| Dependencies | Removed @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.Changed
| Area | Change |
|---|
| Package | Moved to the meteora-ag organization. |
Upgrade Note
Use the package name @meteora-ag/vault-sdk for new integrations.Added
| Version | Change |
|---|
2.2.1 | Added deserializeMint utility. |
Changed
| Version | Change |
|---|
2.2.0 | Fixed tokenMint and tokenLpMint. |
2.1.1 | Optimized createMultiple and createMultiplePda RPC usage. |
2.1.0 | Updated createMultiple to take fewer parameters. |
Removed
| Version | Change |
|---|
2.2.0 | Removed lpMintPda field. |
Changed
| Version | Change |
|---|
2.0.0 | Updated @solana/spl-token to 0.4.6 and related packages. |
Fixed
| Version | Change |
|---|
2.0.1 | Fixed refreshVaultState. |
Removed
| Version | Change |
|---|
2.0.0 | Removed older direct-strategy withdrawal logic from the package. |
Source Gaps
| Gap | Impact |
|---|
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. |
