Pools and swaps

const pool = await dlmmProgram.getPool(poolAddress);

await pool.refresh();

// quoteExactIn() is a thin wrapper — same internal fetch/simulate/trim as swapExactIn(), just
// returns the quote without building instructions.
const quoteOutput = await pool.quoteExactIn({ xToY: true, amountIn: 1_000_000n, slippageToleranceBps: 50 });

const { quoteOutput: sameQuote, instructions } = await pool.swapExactIn(userSigner, {
  xToY: true,
  amountIn: 1_000_000n,
  slippageToleranceBps: 50,
});

// swapExactOut()/quoteExactOut() fix the output amount instead — the trader specifies exactly
// what they want to receive, and pays whatever gross input that requires (capped by
// slippageToleranceBps via maxAmountIn on the quote output).
const { quoteOutput: exactOutQuote, instructions: exactOutInstructions } = await pool.swapExactOut(userSigner, {
  xToY: true,
  amountOut: 1_000_000n,
  slippageToleranceBps: 50,
});

// Useful before quoting/depositing against a pool whose active bin may have drifted across
// empty bins since it was last touched — sync moves the pointer without needing a real trade.
const syncIxs = await pool.sync(userSigner, targetBinId);

try {
  const quoteOutput = await pool.quoteExactIn({ xToY: true, amountIn, slippageToleranceBps: 50 });
} catch (error) {
  // error.message is one of exactly three strings:
  //   "Insufficient liquidity for swap" — the trade needs more bin-array coverage than the
  //     protocol's max traversal window (6 arrays) can supply; it must be split across
  //     multiple transactions, it isn't retriable as one swap.
  //   "Swap amount is zero" — after netting out an input-side Token-2022 transfer fee, nothing
  //     was left to swap.
  //   "Arithmetic overflow" — only reachable at extreme, effectively unreachable input sizes.
}

const { baseFeeRate, dynamicFeeRate, totalFeeRate } = await pool.getFeeRates();

const { transferFeeX, transferFeeY } = await pool.getTransferFees();