@liquid-af/sdk 0.1.0

package/src/accounts/liquid-state.ts

@@ -0,0 +1,134 @@
+import type { Connection, PublicKey } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+import {
+	getUserPropertiesPDA,
+	getTokenVolumePDA,
+	getGlobalCurveVolumePDA,
+	getGlobalAmmVolumePDA,
+	getCashbackConfigPDA,
+	getUserSnapshotPDA,
+	getDealPDA,
+} from "../pda/liquid-state.js";
+import { getLiquidStateProgram } from "../idl/index.js";
+
+/**
+ * Fetches a user's properties (referrer, volumes, cashback state).
+ *
+ * @param connection - Solana RPC connection
+ * @param user - User's public key
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized user properties account
+ */
+export async function fetchUserProperties(
+	connection: Connection,
+	user: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getUserPropertiesPDA(user, config.liquidStateProgramId);
+	return program.account.userProperties.fetch(pda);
+}
+
+/**
+ * Fetches the token volume accumulator for a mint.
+ *
+ * @param connection - Solana RPC connection
+ * @param mint - Token mint address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized token volume accumulator account
+ */
+export async function fetchTokenVolume(
+	connection: Connection,
+	mint: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+	return program.account.tokenVolumeAccumulator.fetch(pda);
+}
+
+/**
+ * Fetches the global curve volume accumulator.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized global curve volume accumulator account
+ */
+export async function fetchGlobalCurveVolume(
+	connection: Connection,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getGlobalCurveVolumePDA(config.liquidStateProgramId);
+	return program.account.globalCurveVolumeAccumulator.fetch(pda);
+}
+
+/**
+ * Fetches the global AMM volume accumulator.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized global AMM volume accumulator account
+ */
+export async function fetchGlobalAmmVolume(
+	connection: Connection,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getGlobalAmmVolumePDA(config.liquidStateProgramId);
+	return program.account.globalAmmVolumeAccumulator.fetch(pda);
+}
+
+/**
+ * Fetches the cashback configuration.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized cashback configuration account
+ */
+export async function fetchCashbackConfig(
+	connection: Connection,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getCashbackConfigPDA(config.liquidStateProgramId);
+	return program.account.cashbackConfiguration.fetch(pda);
+}
+
+/**
+ * Fetches a user snapshot by user and index.
+ *
+ * @param connection - Solana RPC connection
+ * @param user - User's public key
+ * @param index - Snapshot index (0-based)
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized user snapshot account
+ */
+export async function fetchUserSnapshot(
+	connection: Connection,
+	user: PublicKey,
+	index: number,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getUserSnapshotPDA(user, index, config.liquidStateProgramId);
+	return program.account.userSnapshot.fetch(pda);
+}
+
+/**
+ * Fetches a deal account by its owner.
+ *
+ * @param connection - Solana RPC connection
+ * @param owner - Deal owner's public key
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized deal account
+ */
+export async function fetchDeal(
+	connection: Connection,
+	owner: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidStateProgram(connection, config);
+	const [pda] = getDealPDA(owner, config.liquidStateProgramId);
+	return program.account.deal.fetch(pda);
+}

package/src/accounts/liquid-swap.ts

@@ -0,0 +1,79 @@
+import type { Connection, PublicKey } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+import {
+	getSwapGlobalConfigPDA,
+	getPoolPDA,
+	getObservationPDA,
+} from "../pda/liquid-swap.js";
+import { getLiquidSwapProgram } from "../idl/index.js";
+
+/**
+ * Fetches the AMM global configuration.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized AMM configuration account
+ */
+export async function fetchAmmConfig(
+	connection: Connection,
+	config: LiquidConfig
+) {
+	const program = getLiquidSwapProgram(connection, config);
+	const [pda] = getSwapGlobalConfigPDA(config.liquidSwapProgramId);
+	return program.account.ammConfig.fetch(pda);
+}
+
+/**
+ * Fetches an AMM pool state by base and quote mint.
+ *
+ * @param connection - Solana RPC connection
+ * @param baseMint - Base token mint address
+ * @param quoteMint - Quote token mint address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized pool state account
+ */
+export async function fetchPoolState(
+	connection: Connection,
+	baseMint: PublicKey,
+	quoteMint: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidSwapProgram(connection, config);
+	const [pda] = getPoolPDA(baseMint, quoteMint, config.liquidSwapProgramId);
+	return program.account.poolState.fetch(pda);
+}
+
+/**
+ * Fetches a pool state by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param poolAddress - The pool state PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized pool state account
+ */
+export async function fetchPoolStateByAddress(
+	connection: Connection,
+	poolAddress: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidSwapProgram(connection, config);
+	return program.account.poolState.fetch(poolAddress);
+}
+
+/**
+ * Fetches the observation state (oracle) for a pool.
+ *
+ * @param connection - Solana RPC connection
+ * @param poolAddress - The pool state PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized observation state account
+ */
+export async function fetchObservationState(
+	connection: Connection,
+	poolAddress: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidSwapProgram(connection, config);
+	const [pda] = getObservationPDA(poolAddress, config.liquidSwapProgramId);
+	return program.account.observationState.fetch(pda);
+}

package/src/accounts/liquid.ts

@@ -0,0 +1,100 @@
+import type { Connection, PublicKey } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+import {
+	getLiquidGlobalConfigPDA,
+	getBondingCurvePDA,
+	getStableBondingCurvePDA,
+} from "../pda/liquid.js";
+import { getLiquidProgram } from "../idl/index.js";
+
+/**
+ * Fetches the global configuration for the bonding curve program.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized global configuration account
+ */
+export async function fetchLiquidGlobalConfig(
+	connection: Connection,
+	config: LiquidConfig
+) {
+	const program = getLiquidProgram(connection, config);
+	const [pda] = getLiquidGlobalConfigPDA(config.liquidProgramId);
+	return program.account.globalConfiguration.fetch(pda);
+}
+
+/**
+ * Fetches a bonding curve account by mint address.
+ *
+ * @param connection - Solana RPC connection
+ * @param mint - Token mint address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized bonding curve account
+ */
+export async function fetchNativeBondingCurve(
+	connection: Connection,
+	mint: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidProgram(connection, config);
+	const [pda] = getBondingCurvePDA(mint, config.liquidProgramId);
+	return program.account.nativeBondingCurve.fetch(pda);
+}
+
+/**
+ * Fetches a bonding curve account by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param bondingCurveAddress - The bonding curve PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized bonding curve account
+ */
+export async function fetchNativeBondingCurveByAddress(
+	connection: Connection,
+	bondingCurveAddress: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidProgram(connection, config);
+	return program.account.nativeBondingCurve.fetch(bondingCurveAddress);
+}
+
+/**
+ * Fetches a token bonding curve account by mint and quote mint addresses.
+ *
+ * @param connection - Solana RPC connection
+ * @param mint - Token mint address (base token)
+ * @param quoteMint - Quote token mint address (e.g., USDC)
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized token bonding curve account
+ */
+export async function fetchStableBondingCurve(
+	connection: Connection,
+	mint: PublicKey,
+	quoteMint: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidProgram(connection, config);
+	const [pda] = getStableBondingCurvePDA(
+		mint,
+		quoteMint,
+		config.liquidProgramId
+	);
+	return program.account.stableBondingCurve.fetch(pda);
+}
+
+/**
+ * Fetches a token bonding curve account by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param stableBondingCurveAddress - The token bonding curve PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized token bonding curve account
+ */
+export async function fetchStableBondingCurveByAddress(
+	connection: Connection,
+	stableBondingCurveAddress: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidProgram(connection, config);
+	return program.account.stableBondingCurve.fetch(stableBondingCurveAddress);
+}