perena-vault-sdk 1.0.0

package/README.md

@@ -0,0 +1,396 @@
+# Vault SDK
+
+TypeScript helpers for the Bankineco vault program. The SDK wraps PDA derivation,
+account fetching, and instruction building behind a single `VaultClient`. Every
+on-chain instruction has a **transaction builder** on `client.tx` that returns a
+`VaultTransactionPlan` you can sign and send.
+
+For runnable CLI examples, see [`scripts/README.md`](scripts/README.md).
+
+## Install
+
+From the monorepo (workspace package name is `vault`):
+
+```bash
+pnpm install
+pnpm --filter vault run build
+```
+
+In another workspace package:
+
+```json
+{
+  "dependencies": {
+    "vault": "workspace:*"
+  }
+}
+```
+
+## Quick start
+
+### Option A — `createVaultClient` (scripts and backend services)
+
+Use this when targeting deployed `test` or `prod` networks. It wires RPC,
+keypair, and program id from env vars (see [`.env.example`](.env.example)).
+
+```typescript
+import { createVaultClient } from "vault";
+
+const { client, payer, signer } = createVaultClient("test", {
+  role: "vault", // default keypair: ~/.config/solana/vault-test.json
+});
+
+const vault = "..." as Address; // vault PDA
+const vaultAccount = await client.account.fetchVault(vault);
+
+const plan = await client.tx.executeDeposit.getTx({
+  user: signer,
+  vault,
+  assetMint: vaultAccount.config.baseAssetMint,
+  shareMint: vaultAccount.config.shareMint,
+  amount: 1_000_000n, // base units (6 decimals → 1.0 UI)
+});
+
+const signature = await client.sendTransaction(payer, plan);
+console.log(signature);
+```
+
+### Option B — manual `VaultClient` (tests, custom integrations)
+
+Use this when you already have a `Connection` and signer:
+
+```typescript
+import { AnchorProvider } from "@anchor-lang/core";
+import { Connection, Keypair } from "@solana/web3.js";
+import { fromWeb3Pk } from "common";
+import { VaultClient, makeProvider } from "vault";
+
+const connection = new Connection("http://127.0.0.1:8899", "confirmed");
+const payer = Keypair.generate();
+const client = new VaultClient(makeProvider(connection, payer));
+
+const [vault] = await client.pda.deriveVaultPda(0); // vault id
+```
+
+## Creating transactions
+
+### The builder pattern
+
+Every instruction lives on `client.tx.<builderName>`. Builders follow the same
+contract:
+
+| Method | Returns | When to use |
+| --- | --- | --- |
+| `getTx(txArgs)` | `VaultTransactionPlan` | **Preferred.** Derives PDAs/ATAs, prepends setup ixs (e.g. idempotent ATA creates), and attaches cache invalidation metadata. |
+| `getIx(ixArgs)` | `Instruction` | Low-level. You supply every account address yourself. |
+
+`TxArgs` types are the high-level inputs (curator, vault, amounts as `bigint`,
+optional PDAs). `IxArgs` types are the fully-resolved account sets the program
+expects. Type definitions live in
+[`src/client/builders/args.ts`](src/client/builders/args.ts).
+
+A typical flow:
+
+```typescript
+// 1. Build a plan
+const plan = await client.tx.executeDeposit.getTx({
+  user: signer,
+  vault,
+  assetMint,
+  shareMint,
+  amount: 500_000n,
+});
+
+// 2. Send it (signs, confirms, clears relevant account cache)
+const sig = await client.sendTransaction(payer, plan);
+```
+
+`VaultTransactionPlan` contains:
+
+- `instructions` — ordered `@solana/kit` instructions (preamble + program ix)
+- `lookupTables?` — optional address lookup tables for v0 transactions
+- `postSuccessCacheInvalidations?` — vault cache keys to clear after success
+
+### Example: deposit
+
+```typescript
+const plan = await client.tx.executeDeposit.getTx({
+  user: signer,
+  vault,
+  assetMint,
+  shareMint,
+  amount: 1_000_000n,
+});
+await client.sendTransaction(payer, plan);
+```
+
+The builder automatically:
+
+- Derives `vaultOracle` from the vault PDA
+- Computes user/vault ATAs
+- Prepends idempotent ATA-create instructions where needed
+
+### Example: withdraw
+
+```typescript
+const plan = await client.tx.executeWithdraw.getTx({
+  user: signer,
+  vault,
+  assetMint,
+  shareMint,
+  shareAmount: 500_000n,
+});
+await client.sendTransaction(payer, plan);
+```
+
+For withdrawals routed through external liquidity (CPI), pass
+`externalWithdrawIxRefs`, `externalWithdrawAccounts`, and optionally
+`lookupTables` — see `ExecuteWithdrawTxArgs` in `args.ts`.
+
+### Example: vault setup (multi-step)
+
+Deploy flows compose several builders in sequence:
+
+```typescript
+const curator = fromWeb3Pk(payer.publicKey);
+
+await client.sendTransaction(
+  payer,
+  await client.tx.createVault.getTx({
+    curator,
+    shareMint,
+    strictAssetMint: assetMint,
+    assetDecimals: 6,
+  })
+);
+
+await client.sendTransaction(
+  payer,
+  await client.tx.createTrancheState.getTx({
+    curator,
+    vault,
+    juniorShareMint,
+    seniorShareMint,
+    seniorFixedApyBps: 1_000,
+  })
+);
+
+await client.sendTransaction(
+  payer,
+  await client.tx.updateConsensusSigners.getTx({
+    curator,
+    vault,
+    signers: [curator],
+  })
+);
+```
+
+### Example: tranche deposit
+
+```typescript
+const plan = await client.tx.executeTrancheDeposit.getTx({
+  user: signer,
+  vault,
+  assetMint,
+  trancheShareMint: juniorMint,
+  kind: { junior: {} }, // or { senior: {} }
+  amount: 1_000_000n,
+});
+await client.sendTransaction(payer, plan);
+```
+
+### Example: junior withdrawal queue
+
+```typescript
+// User queues a locked junior withdraw
+await client.sendTransaction(
+  payer,
+  await client.tx.requestJuniorTrancheWithdraw.getTx({
+    owner: signer,
+    vault,
+    juniorMint,
+    queueId: 0,
+    shareAmount: 100_000n,
+  })
+);
+
+// Fulfiller pays out after lockup (see WithdrawalQueueService for batch logic)
+await client.sendTransaction(
+  fulfiller,
+  await client.tx.fulfillJuniorTrancheWithdraw.getTx({
+    fulfiller: fromWeb3Pk(fulfiller.publicKey),
+    owner,
+    vault,
+    queueId: 0,
+  })
+);
+```
+
+## Sending transactions
+
+### Built-in helper
+
+`VaultClient.sendTransaction` builds a legacy `Transaction`, signs with the
+fee payer, sends, confirms, and applies cache invalidations from the plan:
+
+```typescript
+const signature = await client.sendTransaction(payer, plan);
+```
+
+### Versioned transactions (lookup tables)
+
+Some builders (e.g. `executeWithdraw`, `protocolInteraction`, `jupiterSwap`)
+return `lookupTables` on the plan. `sendTransaction` does **not** compile v0
+messages — use `sendVersionedTransaction` from `common` instead:
+
+```typescript
+import { fromKitInstruction, sendVersionedTransaction } from "common";
+
+const plan = await client.tx.protocolInteraction.getTx({ /* ... */ });
+
+const signature = await sendVersionedTransaction({
+  connection: client.provider.connection,
+  payer,
+  instructions: plan.instructions.map(fromKitInstruction),
+  lookupTables: plan.lookupTables ?? [],
+});
+
+client.applyCacheInvalidations(plan);
+```
+
+### Composing your own transaction
+
+You can merge instructions from multiple builders or mix in custom ixs:
+
+```typescript
+const depositPlan = await client.tx.executeDeposit.getTx({ /* ... */ });
+const customIx = /* your instruction */;
+
+const combined: VaultTransactionPlan = {
+  instructions: [...depositPlan.instructions, customIx],
+  postSuccessCacheInvalidations: depositPlan.postSuccessCacheInvalidations,
+};
+```
+
+Or call `getIx` directly when you only need the program instruction:
+
+```typescript
+const ix = await client.tx.executeDeposit.getIx({
+  user: signer,
+  vault,
+  vaultOracle,
+  vaultTrancheState: null,
+  assetMint,
+  shareMint,
+  amount: new BN("1000000"),
+  assetTokenProgram: TOKEN_PROGRAM_ID,
+  shareTokenProgram: TOKEN_PROGRAM_ID,
+  userAssetAta,
+  vaultAssetAta,
+  userShareAta,
+});
+```
+
+## Reading on-chain state
+
+Use `client.account` to fetch decoded vault accounts (cached by default, TTL
+60s):
+
+```typescript
+const vaultAccount = await client.account.fetchVault(vault);
+const oracle = await client.account.fetchVaultOracle(vaultOraclePda);
+const trancheState = await client.account.fetchVaultTrancheState(tranchePda);
+
+// Force a fresh read after an external tx
+const fresh = await client.account.fetchVault(vault, { fresh: true });
+client.clearAllCache();
+```
+
+Derive PDAs with `client.pda`:
+
+```typescript
+const [vault] = await client.pda.deriveVaultPda(vaultId);
+const [vaultOracle] = await client.pda.deriveVaultOraclePda(vault);
+const [trancheState] = await client.pda.deriveVaultTrancheStatePda(vault);
+const [queue] = await client.pda.deriveWithdrawalQueuePda(
+  vault,
+  owner,
+  queueId
+);
+```
+
+## Available transaction builders
+
+All builders are on `client.tx`:
+
+| Builder | Program instruction | Typical signer |
+| --- | --- | --- |
+| `createVault` | `create_vault` | Curator |
+| `createAssetHolding` | `create_asset_holding` | HW manager |
+| `removeAssetHolding` | `remove_asset_holding` | HW manager |
+| `updateConsensusSigners` | `update_consensus_signers` | Curator |
+| `createTrancheState` | `create_tranche_state` | Curator |
+| `setVaultConfig` | `set_vault_config` | Curator |
+| `updateTrancheConfig` | `update_tranche_config` | Curator |
+| `activateCircuitBreaker` | `activate_circuit_breaker` | CB trigger |
+| `disableCircuitBreaker` | `disable_circuit_breaker` | Curator |
+| `updateConsensusOracle` | `update_consensus_oracle` | Consensus signer |
+| `executeDeposit` | `execute_deposit` | User |
+| `executeTrancheDeposit` | `execute_tranche_deposit` | User |
+| `executeTrancheWithdraw` | `execute_tranche_withdraw` | User |
+| `requestJuniorTrancheWithdraw` | `request_junior_tranche_withdraw` | Owner |
+| `cancelJuniorTrancheWithdraw` | `cancel_junior_tranche_withdraw` | Owner |
+| `fulfillJuniorTrancheWithdraw` | `fulfill_junior_tranche_withdraw` | Fulfiller |
+| `executeWithdraw` | `execute_withdraw` | User |
+| `managerWithdrawAsset` | `manager_withdraw_asset` | HW manager |
+| `managerRedepositAsset` | `manager_redeposit_asset` | HW manager |
+| `protocolInteraction` | `protocol_interaction` | HW manager |
+| `jupiterSwap` | `jupiter_swap` | HW manager |
+| `setExternalLiquidity` | `set_external_liquidity` | HW manager |
+| `setAssetPriceOracle` | `set_asset_price_oracle` | Curator |
+| `updateAssetPrice` | `update_asset_price` | Oracle keeper |
+| `vaultReallocation` | `vault_reallocation` | HW manager |
+| `withdrawProtocolFees` | `withdraw_protocol_fees` | Curator |
+| `withdrawTrancheFees` | `withdraw_tranche_fees` | Curator |
+
+Argument shapes for each builder: [`src/client/builders/args.ts`](src/client/builders/args.ts).
+
+## Higher-level services
+
+For recurring backend work, prefer the services layer over reimplementing
+discovery logic in your app:
+
+- **`WithdrawalQueueService`** — scan and fulfill eligible junior withdrawal
+  queues (`src/services/withdrawalQueueService.ts`)
+- **`OracleService`** — consensus oracle / asset price updates
+  (`src/services/oracleService.ts`)
+
+These services call the same `client.tx.*.getTx` builders internally.
+
+## Environment and RPC
+
+Copy [`.env.example`](.env.example) to `.env`. RPC resolution order:
+
+1. `VAULT_RPC_URL_TEST` / `VAULT_RPC_URL_PROD`
+2. `RPC_URL`
+3. `HELIUS_API_KEY` (auto-built Helius URL)
+
+Program ids per environment: `getVaultProgramId("test" | "prod")` in
+[`src/env.ts`](src/env.ts).
+
+## CLI scripts
+
+Thin wrappers around the SDK live in [`scripts/`](scripts/). From the repo root:
+
+```bash
+pnpm deposit test <VAULT_PDA> 100
+pnpm inspect prod <VAULT_PDA>
+```
+
+See [`scripts/README.md`](scripts/README.md) for the full command list.
+
+## Types and addresses
+
+- Public keys use `@solana/kit` `Address` strings in builder args.
+- Convert from web3.js: `fromWeb3Pk(keypair.publicKey)` (from `common`).
+- Amounts in `TxArgs` are `bigint` base units unless noted otherwise.

package/dist/client/account.d.ts

@@ -0,0 +1,59 @@
+import type { Address, Rpc, SolanaRpcApi } from "@solana/kit";
+import { IdlAccounts, Program } from "@anchor-lang/core";
+import { BaseAccountClient } from "common";
+import type { Vault } from "../idl/vault";
+import type { PdaClient } from "./pda";
+export declare const VAULT_CACHE_CATEGORY = "vault";
+export declare const FEE_VAULT_CACHE_CATEGORY = "fee_vault";
+export declare const VAULT_ORACLE_CACHE_CATEGORY = "vault_oracle";
+export declare const VAULT_TRANCHE_STATE_CACHE_CATEGORY = "vault_tranche_state";
+export declare const VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY = "vault_tranche_withdrawal_queue";
+/** Decoded on-chain `Vault` account (from generated IDL types). */
+export type VaultAccountData = IdlAccounts<Vault>["vault"];
+export type FeeVaultAccountData = IdlAccounts<Vault>["feeVault"];
+export type VaultOracleAccountData = IdlAccounts<Vault>["vaultOracle"];
+export type VaultTrancheStateAccountData = IdlAccounts<Vault>["vaultTrancheState"];
+export type VaultTrancheWithdrawalQueueAccountData = IdlAccounts<Vault>["vaultWithdrawalQueue"];
+/**
+ * Account fetchers for the vault program.
+ */
+export declare class AccountClient extends BaseAccountClient {
+    private readonly program;
+    readonly pda: PdaClient;
+    constructor(program: Program<Vault>, pda: PdaClient, rpc: Rpc<SolanaRpcApi>);
+    fetchVault(vault: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultAccountData>;
+    fetchVaults(vaults: Address[]): Promise<VaultAccountData[]>;
+    fetchFeeVault(feeVault: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<FeeVaultAccountData>;
+    fetchFeeVaultForVault(vault: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<FeeVaultAccountData>;
+    fetchVaultOracle(vaultOracle: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultOracleAccountData>;
+    fetchVaultOracleForVault(vault: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultOracleAccountData>;
+    fetchVaultTrancheState(vaultTrancheState: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultTrancheStateAccountData>;
+    fetchVaultTrancheStateForVault(vault: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultTrancheStateAccountData>;
+    fetchVaultTrancheWithdrawalQueue(withdrawalQueue: Address, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultTrancheWithdrawalQueueAccountData>;
+    fetchVaultTrancheWithdrawalQueueForOwner(vault: Address, owner: Address, queueId: number, opts?: {
+        fresh?: boolean;
+    }): Promise<VaultTrancheWithdrawalQueueAccountData>;
+    fetchAllVaults(opts?: {
+        fresh?: boolean;
+    }): Promise<{
+        publicKey: Address;
+        account: VaultAccountData;
+    }[]>;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/client/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/client/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAwB,MAAM,QAAQ,CAAC;AAEjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAC1D,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AACxE,eAAO,MAAM,6CAA6C,mCACxB,CAAC;AAEnC,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;AACjE,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC;AACvE,MAAM,MAAM,4BAA4B,GACtC,WAAW,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAC1C,MAAM,MAAM,sCAAsC,GAChD,WAAW,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC;AAE7C;;GAEG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS;gBADN,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAC/B,GAAG,EAAE,SAAS,EACvB,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC;IAalB,UAAU,CACd,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,gBAAgB,CAAC;IAYtB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS3D,aAAa,CACjB,QAAQ,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAYzB,qBAAqB,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAKzB,gBAAgB,CACpB,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,sBAAsB,CAAC;IAY5B,wBAAwB,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,sBAAsB,CAAC;IAK5B,sBAAsB,CAC1B,iBAAiB,EAAE,OAAO,EAC1B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,4BAA4B,CAAC;IAkBlC,8BAA8B,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,4BAA4B,CAAC;IAOlC,gCAAgC,CACpC,eAAe,EAAE,OAAO,EACxB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,sCAAsC,CAAC;IAkB5C,wCAAwC,CAC5C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,sCAAsC,CAAC;IAU5C,cAAc,CAAC,IAAI,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,EAAE,CAAC;CAcjE"}

package/dist/client/account.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountClient = exports.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY = exports.VAULT_TRANCHE_STATE_CACHE_CATEGORY = exports.VAULT_ORACLE_CACHE_CATEGORY = exports.FEE_VAULT_CACHE_CATEGORY = exports.VAULT_CACHE_CATEGORY = void 0;
+const common_1 = require("common");
+exports.VAULT_CACHE_CATEGORY = "vault";
+exports.FEE_VAULT_CACHE_CATEGORY = "fee_vault";
+exports.VAULT_ORACLE_CACHE_CATEGORY = "vault_oracle";
+exports.VAULT_TRANCHE_STATE_CACHE_CATEGORY = "vault_tranche_state";
+exports.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY = "vault_tranche_withdrawal_queue";
+/**
+ * Account fetchers for the vault program.
+ */
+class AccountClient extends common_1.BaseAccountClient {
+    constructor(program, pda, rpc) {
+        super(rpc, {
+            categoryTtlMs: {
+                [exports.VAULT_CACHE_CATEGORY]: 60000,
+                [exports.FEE_VAULT_CACHE_CATEGORY]: 60000,
+                [exports.VAULT_ORACLE_CACHE_CATEGORY]: 60000,
+                [exports.VAULT_TRANCHE_STATE_CACHE_CATEGORY]: 60000,
+                [exports.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY]: 60000,
+            },
+        });
+        this.program = program;
+        this.pda = pda;
+    }
+    async fetchVault(vault, opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.VAULT_CACHE_CATEGORY, vault);
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.vault.fetch((0, common_1.toWeb3Pk)(vault)), exports.VAULT_CACHE_CATEGORY, vault);
+        return data;
+    }
+    async fetchVaults(vaults) {
+        const { data } = await this.dataCache.getDataBatch(() => this.program.account.vault.fetchMultiple(vaults.map(common_1.toWeb3Pk)), exports.VAULT_CACHE_CATEGORY, vaults);
+        return data;
+    }
+    async fetchFeeVault(feeVault, opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.FEE_VAULT_CACHE_CATEGORY, feeVault);
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.feeVault.fetch((0, common_1.toWeb3Pk)(feeVault)), exports.FEE_VAULT_CACHE_CATEGORY, feeVault);
+        return data;
+    }
+    async fetchFeeVaultForVault(vault, opts) {
+        const [feeVault] = await this.pda.deriveFeeAuthorityPda(vault);
+        return this.fetchFeeVault(feeVault, opts);
+    }
+    async fetchVaultOracle(vaultOracle, opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.VAULT_ORACLE_CACHE_CATEGORY, vaultOracle);
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.vaultOracle.fetch((0, common_1.toWeb3Pk)(vaultOracle)), exports.VAULT_ORACLE_CACHE_CATEGORY, vaultOracle);
+        return data;
+    }
+    async fetchVaultOracleForVault(vault, opts) {
+        const [vaultOracle] = await this.pda.deriveVaultOraclePda(vault);
+        return this.fetchVaultOracle(vaultOracle, opts);
+    }
+    async fetchVaultTrancheState(vaultTrancheState, opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.VAULT_TRANCHE_STATE_CACHE_CATEGORY, vaultTrancheState);
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.vaultTrancheState.fetch((0, common_1.toWeb3Pk)(vaultTrancheState)), exports.VAULT_TRANCHE_STATE_CACHE_CATEGORY, vaultTrancheState);
+        return data;
+    }
+    async fetchVaultTrancheStateForVault(vault, opts) {
+        const [vaultTrancheState] = await this.pda.deriveVaultTrancheStatePda(vault);
+        return this.fetchVaultTrancheState(vaultTrancheState, opts);
+    }
+    async fetchVaultTrancheWithdrawalQueue(withdrawalQueue, opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, withdrawalQueue);
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.vaultWithdrawalQueue.fetch((0, common_1.toWeb3Pk)(withdrawalQueue)), exports.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, withdrawalQueue);
+        return data;
+    }
+    async fetchVaultTrancheWithdrawalQueueForOwner(vault, owner, queueId, opts) {
+        const [withdrawalQueue] = await this.pda.deriveVaultTrancheWithdrawalQueuePda(vault, owner, queueId);
+        return this.fetchVaultTrancheWithdrawalQueue(withdrawalQueue, opts);
+    }
+    async fetchAllVaults(opts) {
+        if (opts?.fresh) {
+            this.dataCache.clearCacheEntry(exports.VAULT_CACHE_CATEGORY, "all");
+        }
+        const { data } = await this.dataCache.getDataOrThrow(() => this.program.account.vault.all(), exports.VAULT_CACHE_CATEGORY, "all");
+        return data.map((acc) => ({
+            publicKey: (0, common_1.fromWeb3Pk)(acc.publicKey),
+            account: acc.account,
+        }));
+    }
+}
+exports.AccountClient = AccountClient;
+//# sourceMappingURL=account.js.map

package/dist/client/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/client/account.ts"],"names":[],"mappings":"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"}

package/dist/client/builders/activateCircuitBreaker.d.ts

@@ -0,0 +1,12 @@
+import { VaultBuilderBase } from "./base";
+import type { ActivateCircuitBreakerIxArgs, ActivateCircuitBreakerTxArgs } from "./args";
+export declare class ActivateCircuitBreakerBuilder extends VaultBuilderBase<ActivateCircuitBreakerIxArgs, ActivateCircuitBreakerTxArgs> {
+    getIx(args: ActivateCircuitBreakerIxArgs): Promise<import("@solana/kit").Instruction<string, readonly (import("@solana/kit").AccountLookupMeta<string, string> | import("@solana/kit").AccountMeta<string>)[]>>;
+    protected deriveIxArgs(txArgs: ActivateCircuitBreakerTxArgs): Promise<ActivateCircuitBreakerIxArgs>;
+    protected buildPlanExtras(args: ActivateCircuitBreakerIxArgs): Promise<{
+        postSuccessCacheInvalidations: {
+            vaultPda: import("@solana/kit").Address;
+        }[];
+    }>;
+}
+//# sourceMappingURL=activateCircuitBreaker.d.ts.map

package/dist/client/builders/activateCircuitBreaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activateCircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/client/builders/activateCircuitBreaker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,QAAQ,CAAC;AAEhB,qBAAa,6BAA8B,SAAQ,gBAAgB,CACjE,4BAA4B,EAC5B,4BAA4B,CAC7B;IACO,KAAK,CAAC,IAAI,EAAE,4BAA4B;cAW9B,YAAY,CAC1B,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,4BAA4B,CAAC;cAIxB,eAAe,CAAC,IAAI,EAAE,4BAA4B;;;;;CAKnE"}

package/dist/client/builders/activateCircuitBreaker.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivateCircuitBreakerBuilder = void 0;
+const common_1 = require("common");
+const base_1 = require("./base");
+class ActivateCircuitBreakerBuilder extends base_1.VaultBuilderBase {
+    async getIx(args) {
+        return this.program.methods
+            .activateCircuitBreaker()
+            .accountsPartial({
+            cbTrigger: (0, common_1.toWeb3Pk)(args.cbTrigger),
+            vault: (0, common_1.toWeb3Pk)(args.vault),
+        })
+            .instruction()
+            .then(common_1.toKitInstruction);
+    }
+    async deriveIxArgs(txArgs) {
+        return txArgs;
+    }
+    async buildPlanExtras(args) {
+        return {
+            postSuccessCacheInvalidations: [{ vaultPda: args.vault }],
+        };
+    }
+}
+exports.ActivateCircuitBreakerBuilder = ActivateCircuitBreakerBuilder;
+//# sourceMappingURL=activateCircuitBreaker.js.map

package/dist/client/builders/activateCircuitBreaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activateCircuitBreaker.js","sourceRoot":"","sources":["../../../src/client/builders/activateCircuitBreaker.ts"],"names":[],"mappings":";;;AAAA,mCAAoD;AAEpD,iCAA0C;AAM1C,MAAa,6BAA8B,SAAQ,uBAGlD;IACC,KAAK,CAAC,KAAK,CAAC,IAAkC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;aACxB,sBAAsB,EAAE;aACxB,eAAe,CAAC;YACf,SAAS,EAAE,IAAA,iBAAQ,EAAC,IAAI,CAAC,SAAS,CAAC;YACnC,KAAK,EAAE,IAAA,iBAAQ,EAAC,IAAI,CAAC,KAAK,CAAC;SAC5B,CAAC;aACD,WAAW,EAAE;aACb,IAAI,CAAC,yBAAgB,CAAC,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,YAAY,CAC1B,MAAoC;QAEpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,eAAe,CAAC,IAAkC;QAChE,OAAO;YACL,6BAA6B,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC;CACF;AA1BD,sEA0BC"}

package/dist/client/builders/anchorArgs.d.ts

@@ -0,0 +1,59 @@
+import { BN } from "@anchor-lang/core";
+import type { Address } from "@solana/kit";
+import type { ConsensusAssetUpdate, CreateVaultParams } from "./args";
+export declare function toAnchorCreateVaultParams(params: CreateVaultParams): {
+    hwManager: import("@solana/web3.js").PublicKey;
+    cbTrigger: import("@solana/web3.js").PublicKey;
+    feeCollector: import("@solana/web3.js").PublicKey;
+    baseAssetMint: import("@solana/web3.js").PublicKey;
+    basePriceOracleAccount: import("@solana/web3.js").PublicKey;
+    vaultId: number;
+    assetDecimals: number;
+    mintFeeBps: number;
+    burnFeeBps: number;
+    performanceFeeBps: number;
+    fixedApyBps: number;
+    maxApyBps: number;
+    tvlLimit: BN;
+    lossesEnabled: boolean;
+    initialMintSharePrice: BN | null;
+    basePriceOracleType: number;
+    basePrice: BN;
+    forMigration: boolean;
+};
+export declare function toAnchorSetVaultConfigArgs(args: {
+    manager: Address | null;
+    hwManager: Address | null;
+    cbTrigger: Address | null;
+    fulfiller: Address | null;
+    feeCollector: Address | null;
+    mintFeeBps: number | null;
+    burnFeeBps: number | null;
+    performanceFeeBps: number | null;
+    fixedApyBps: number | null;
+    maxApyBps: number | null;
+    tvlLimit: BN | null;
+    lossesEnabled: boolean | null;
+    priceStalenessThresholdSecs: BN | null;
+}): {
+    manager: import("@solana/web3.js").PublicKey | null;
+    hwManager: import("@solana/web3.js").PublicKey | null;
+    cbTrigger: import("@solana/web3.js").PublicKey | null;
+    fulfiller: import("@solana/web3.js").PublicKey | null;
+    feeCollector: import("@solana/web3.js").PublicKey | null;
+    mintFeeBps: number | null;
+    burnFeeBps: number | null;
+    performanceFeeBps: number | null;
+    fixedApyBps: number | null;
+    maxApyBps: number | null;
+    tvlLimit: BN | null;
+    lossesEnabled: boolean | null;
+    priceStalenessThresholdSecs: BN | null;
+};
+export declare function toAnchorConsensusUpdates(updates: ConsensusAssetUpdate[]): {
+    holdingIndex: number;
+    mint: import("@solana/web3.js").PublicKey | null;
+    price: BN;
+    externalAmount: BN;
+}[];
+//# sourceMappingURL=anchorArgs.d.ts.map

package/dist/client/builders/anchorArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorArgs.d.ts","sourceRoot":"","sources":["../../../src/client/builders/anchorArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEtE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;EASlE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,2BAA2B,EAAE,EAAE,GAAG,IAAI,CAAC;CACxC;;;;;;;;;;;;;;EAgBA;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,EAAE;;;;;IAOvE"}