Skip to main content
Vault operations are operationally manual unless you automate them yourself.
Voltr does not provide managed bot hosting. You are responsible for deployment, monitoring, and key management.

​
Why Automation Is Needed

TaskWhy It Needs Automation
RebalancingRates and allocations change over time
Reward claimingUnclaimed rewards leave value idle
Reward swappingClaimed rewards often need conversion back to base asset
Position monitoringStrategy-specific health can degrade without alerts
Fee harvestingAccumulated fees should be collected periodically

​
Where The Building Blocks Live

Every operation your automation needs — strategy init, allocation, reward claiming, fee harvesting — ships in one repository, sdk-scripts. You can drive it two ways:
  • Shell out to the CLI (pnpm cli -- <group>:<action> --mode execute) from a cron job or scheduler — the simplest path for periodic rebalancing and claims. See CLI & Scripts.
  • Import the operation builders into a long-running service or bot. The examples/ directory has one runnable file per action showing how to build a BuiltOperation and route it through the shared transaction processor.
For lower-level reads and custom instruction building, the underlying @voltr/vault-sdk is also available directly — the shape below uses it.

​
Basic Script Shape

import { createKeyPairSignerFromBytes, createSolanaRpc } from "@solana/kit";
import {
  fetchVault,
  getPositionAndTotalValuesForVault,
} from "@voltr/vault-sdk";

async function main() {
  const rpc = createSolanaRpc(process.env.RPC_URL!);
  const managerSigner = await createKeyPairSignerFromBytes(
    Uint8Array.from(JSON.parse(process.env.MANAGER_KEY!))
  );

  const vaultAccount = await fetchVault(rpc, vaultAddress);
  const positions = await getPositionAndTotalValuesForVault(rpc, vaultAddress);

  // 1. Read idle and deployed balances
  // 2. Pull strategy-side data
  // 3. Decide on reallocations
  // 4. Build strategy deposit/withdraw instructions

  console.log(vaultAccount.data.asset.totalValue, positions.strategies.length);
}

main().catch(console.error);

​
Operational Requirements

  • keep manager and admin wallets funded with SOL
  • add retries and alerting
  • respect RPC limits
  • make scripts idempotent where possible
  • keep signing keys isolated from application code