TypeScript SDK

"dependencies": { "@aqueduct/sdk": "workspace:*" }

import { AqueductClient, DEPLOYMENTS } from "@aqueduct/sdk";
import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection("https://api.devnet.solana.com", "confirmed");
const client = new AqueductClient(connection, DEPLOYMENTS.devnet!);

for (const v of await client.fetchVaults()) {
  console.log(`${v.name}: ${v.totalAssets.toFixed(2)} USDC, ${v.idle.toFixed(2)} idle`);
  console.log(`  share price ${v.sharePrice.toFixed(6)}, net APY ${v.apy.toFixed(2)}% (gross ${v.grossApy.toFixed(2)}%)`);
  for (const s of v.strategies) {
    console.log(`  #${s.index} ${s.name} on ${s.chain}: ${(s.weight * 100).toFixed(1)}% of the vault at ${s.apy}% (cap ${s.maxAllocBps / 100}%)`);
  }
}

// the devnet admin, which holds the seed deposits
const owner = new PublicKey("DDVtiUetxxks7LfFUxngLj1jD5huPxmJ9urNCVUKQpvq");
const usdc = await client.fetchAssetBalance(owner);
const positions = await client.fetchPositions(owner);
console.log(`wallet holds ${usdc} test USDC`);
for (const p of positions) console.log(`${p.tier}: ${p.shares} shares worth ${p.value.toFixed(2)} USDC`);

Bedrock: 250066.39 USDC, 12502.95 idle
  share price 1.000251, net APY 3.81% (gross 4.01%)
  #0 Kamino Lend on solana: 20.0% of the vault at 4.34% (cap 40%)
  #1 Jupiter Lend on solana: 35.0% of the vault at 4.1% (cap 40%)
  …
Rapids: 100058.14 USDC, 25043.62 idle
  …
wallet holds 0 test USDC
bedrock: 250000.007372 shares worth 250062.67 USDC
rapids: 100000.00292 shares worth 100052.12 USDC

import { AqueductClient, DEPLOYMENTS } from "@aqueduct/sdk";
import { Connection, Keypair, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.devnet.solana.com", "confirmed");
const client = new AqueductClient(connection, DEPLOYMENTS.devnet!);
const user = Keypair.generate(); // fund with devnet SOL before running

// 1. mint 1,000 test USDC (devnet only, at most 10,000 per call)
await sendAndConfirmTransaction(connection, await client.buildFaucetTx(user.publicKey, 1_000), [user]);

// 2. deposit 250 USDC into Bedrock
const vault = client.vaultAddress("bedrock");
await sendAndConfirmTransaction(connection, await client.buildDepositTx(user.publicKey, vault, 250), [user]);

// 3. withdraw every share (Infinity = the whole balance, read on-chain)
await sendAndConfirmTransaction(connection, await client.buildWithdrawTx(user.publicKey, vault, Infinity), [user]);

const client = new AqueductClient(connection, DEPLOYMENTS.devnet!);
const tx = await client.buildDepositTx(wallet.publicKey, client.vaultAddress("rapids"), 100);
const signature = await wallet.sendTransaction(tx, connection);
await connection.confirmTransaction(
  { signature, blockhash: tx.recentBlockhash!, lastValidBlockHeight: (await connection.getLatestBlockhash()).lastValidBlockHeight },
  "confirmed",
);

import { PERF_FEE_BPS, STRATEGIES, TIERS, netApy, strategiesFor } from "@aqueduct/sdk/registry";

for (const s of strategiesFor("rapids")) console.log(s.index, s.id, s.name, s.chain, s.riskScore, s.maxAllocBps);
console.log(TIERS.bedrock.targetApy, STRATEGIES.length);
console.log(netApy(6, PERF_FEE_BPS.rapids)); // 5.4

import { DEPLOYMENTS, TIER_INDEX, idlePda, sharesPda, strategyPda, vaultPda } from "@aqueduct/sdk";
import { PublicKey } from "@solana/web3.js";

const devnet = DEPLOYMENTS.devnet!;
const programId = new PublicKey(devnet.programId);
const mint = new PublicKey(devnet.assetMint);
const vault = vaultPda(mint, TIER_INDEX.bedrock, programId); // equals devnet.vaults.bedrock
const shareMint = sharesPda(vault, programId);
const idle = idlePda(vault, programId);
const firstStrategy = strategyPda(vault, 0, programId);

try {
  await sendAndConfirmTransaction(connection, tx, [user]);
} catch (err) {
  const hex = /custom program error: 0x([0-9a-f]+)/i.exec(String(err))?.[1];
  const known = hex ? client.program.idl.errors?.find((e) => e.code === parseInt(hex, 16)) : undefined;
  console.log(known?.name, known?.msg); // e.g. DepositCapExceeded "Deposit would exceed the vault cap"
}