@liquid-af/sdk 0.1.0

package/dist/pda/liquid-state.js

@@ -0,0 +1,79 @@
+import { PublicKey } from "@solana/web3.js";
+const SEED_USER_PROPERTIES = Buffer.from("user_properties");
+const SEED_GLOBAL_CURVE_VOLUME = Buffer.from("global_curve_volume");
+const SEED_GLOBAL_AMM_VOLUME = Buffer.from("global_amm_volume");
+const SEED_TOKEN_VOLUME = Buffer.from("token_volume");
+const SEED_CASHBACK_CONFIG = Buffer.from("cashback_config");
+const SEED_USER_SNAPSHOT = Buffer.from("user_snapshot");
+const SEED_DEAL = Buffer.from("deal");
+/**
+ * Derives the user properties PDA.
+ *
+ * @param user - User's public key
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getUserPropertiesPDA = (user, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_USER_PROPERTIES, user.toBuffer()], programId);
+};
+/**
+ * Derives the global curve volume accumulator PDA.
+ *
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getGlobalCurveVolumePDA = (programId) => {
+    return PublicKey.findProgramAddressSync([SEED_GLOBAL_CURVE_VOLUME], programId);
+};
+/**
+ * Derives the global AMM volume accumulator PDA.
+ *
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getGlobalAmmVolumePDA = (programId) => {
+    return PublicKey.findProgramAddressSync([SEED_GLOBAL_AMM_VOLUME], programId);
+};
+/**
+ * Derives the token volume accumulator PDA for a mint.
+ *
+ * @param mint - Token mint address
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getTokenVolumePDA = (mint, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_TOKEN_VOLUME, mint.toBuffer()], programId);
+};
+/**
+ * Derives the cashback config PDA.
+ *
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getCashbackConfigPDA = (programId) => {
+    return PublicKey.findProgramAddressSync([SEED_CASHBACK_CONFIG], programId);
+};
+/**
+ * Derives the user snapshot PDA for a given user and index.
+ *
+ * @param user - User's public key
+ * @param index - Snapshot index (0-based)
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getUserSnapshotPDA = (user, index, programId) => {
+    const indexBuffer = Buffer.alloc(4);
+    indexBuffer.writeUInt32LE(index);
+    return PublicKey.findProgramAddressSync([SEED_USER_SNAPSHOT, user.toBuffer(), indexBuffer], programId);
+};
+/**
+ * Derives the deal PDA for a given owner.
+ *
+ * @param owner - Deal owner's public key
+ * @param programId - Liquid State program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getDealPDA = (owner, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_DEAL, owner.toBuffer()], programId);
+};
+//# sourceMappingURL=liquid-state.js.map

package/dist/pda/liquid-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-state.js","sourceRoot":"","sources":["../../src/pda/liquid-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC5D,MAAM,wBAAwB,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AACpE,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAChE,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACtD,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC5D,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACxD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,IAAe,EACf,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,oBAAoB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACvC,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,wBAAwB,CAAC,EAC1B,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,sBAAsB,CAAC,EACxB,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,IAAe,EACf,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACpC,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,IAAe,EACf,KAAa,EACb,SAAoB,EACE,EAAE;IACxB,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,EAClD,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACzB,KAAgB,EAChB,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAC7B,SAAS,CACT,CAAC;AACH,CAAC,CAAC"}

package/dist/pda/liquid-swap.d.ts

@@ -0,0 +1,76 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Derives the swap global configuration PDA.
+ *
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getSwapGlobalConfigPDA: (programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the swap authority PDA (for vaults and LP mint).
+ *
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getSwapAuthorityPDA: (programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the pool state PDA.
+ *
+ * @param baseMint - Base token mint address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getPoolPDA: (baseMint: PublicKey, quoteMint: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the LP mint PDA for a pool.
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getPoolLpMintPDA: (poolState: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the pool vault PDA for a specific token.
+ *
+ * @param poolState - Pool state PDA address
+ * @param mint - Token mint address for this vault
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getPoolVaultPDA: (poolState: PublicKey, mint: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the observation state PDA (oracle data).
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getObservationPDA: (poolState: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the protocol fee vault PDA.
+ *
+ * @param feeRecipient - Fee recipient's public key
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getProtocolFeeVaultPDA: (feeRecipient: PublicKey, quoteMint: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the temporary WSOL PDA (for unwrapping during swaps).
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getTempWsolPDA: (poolState: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the buyback vault PDA for a pool.
+ *
+ * @param poolState - Pool state PDA address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getSwapBuybackVaultPDA: (poolState: PublicKey, quoteMint: PublicKey, programId: PublicKey) => [PublicKey, number];
+//# sourceMappingURL=liquid-swap.d.ts.map

package/dist/pda/liquid-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-swap.d.ts","sourceRoot":"","sources":["../../src/pda/liquid-swap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAClC,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAEpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAEpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACtB,UAAU,SAAS,EACnB,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC3B,WAAW,SAAS,EACpB,MAAM,SAAS,EACf,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC7B,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAClC,cAAc,SAAS,EACvB,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAC1B,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAClC,WAAW,SAAS,EACpB,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC"}

package/dist/pda/liquid-swap.js

@@ -0,0 +1,103 @@
+import { PublicKey } from "@solana/web3.js";
+const SEED_GLOBAL_CONFIG = Buffer.from("global_config");
+const AUTH_SEED = Buffer.from("vault_and_lp_mint_auth_seed");
+const POOL_SEED = Buffer.from("pool");
+const POOL_LP_MINT_SEED = Buffer.from("pool_lp_mint");
+const POOL_VAULT_SEED = Buffer.from("pool_vault");
+const OBSERVATION_SEED = Buffer.from("observation");
+const GLOBAL_FEE_SEED = Buffer.from("global_fee");
+const SEED_TEMP_WSOL = Buffer.from("temp_wsol");
+const SEED_BUYBACK_VAULT = Buffer.from("buyback_vault");
+/**
+ * Derives the swap global configuration PDA.
+ *
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getSwapGlobalConfigPDA = (programId) => {
+    return PublicKey.findProgramAddressSync([SEED_GLOBAL_CONFIG], programId);
+};
+/**
+ * Derives the swap authority PDA (for vaults and LP mint).
+ *
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getSwapAuthorityPDA = (programId) => {
+    return PublicKey.findProgramAddressSync([AUTH_SEED], programId);
+};
+/**
+ * Derives the pool state PDA.
+ *
+ * @param baseMint - Base token mint address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getPoolPDA = (baseMint, quoteMint, programId) => {
+    return PublicKey.findProgramAddressSync([POOL_SEED, baseMint.toBuffer(), quoteMint.toBuffer()], programId);
+};
+/**
+ * Derives the LP mint PDA for a pool.
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getPoolLpMintPDA = (poolState, programId) => {
+    return PublicKey.findProgramAddressSync([POOL_LP_MINT_SEED, poolState.toBuffer()], programId);
+};
+/**
+ * Derives the pool vault PDA for a specific token.
+ *
+ * @param poolState - Pool state PDA address
+ * @param mint - Token mint address for this vault
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getPoolVaultPDA = (poolState, mint, programId) => {
+    return PublicKey.findProgramAddressSync([POOL_VAULT_SEED, poolState.toBuffer(), mint.toBuffer()], programId);
+};
+/**
+ * Derives the observation state PDA (oracle data).
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getObservationPDA = (poolState, programId) => {
+    return PublicKey.findProgramAddressSync([OBSERVATION_SEED, poolState.toBuffer()], programId);
+};
+/**
+ * Derives the protocol fee vault PDA.
+ *
+ * @param feeRecipient - Fee recipient's public key
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getProtocolFeeVaultPDA = (feeRecipient, quoteMint, programId) => {
+    return PublicKey.findProgramAddressSync([GLOBAL_FEE_SEED, feeRecipient.toBuffer(), quoteMint.toBuffer()], programId);
+};
+/**
+ * Derives the temporary WSOL PDA (for unwrapping during swaps).
+ *
+ * @param poolState - Pool state PDA address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getTempWsolPDA = (poolState, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_TEMP_WSOL, poolState.toBuffer()], programId);
+};
+/**
+ * Derives the buyback vault PDA for a pool.
+ *
+ * @param poolState - Pool state PDA address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid Swap program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getSwapBuybackVaultPDA = (poolState, quoteMint, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_BUYBACK_VAULT, poolState.toBuffer(), quoteMint.toBuffer()], programId);
+};
+//# sourceMappingURL=liquid-swap.js.map

package/dist/pda/liquid-swap.js.map

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

package/dist/pda/liquid.d.ts

@@ -0,0 +1,67 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Derives the global configuration PDA for the liquid program.
+ *
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getLiquidGlobalConfigPDA: (programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the bonding curve PDA for a token mint.
+ *
+ * @param mint - Token mint address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getBondingCurvePDA: (mint: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the bonding curve SOL vault PDA.
+ *
+ * @param bondingCurve - Bonding curve PDA address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getBondingCurveSolVaultPDA: (bondingCurve: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the referral vault PDA for referral rewards.
+ *
+ * @param referrer - Referrer's public key
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getReferralVaultPDA: (referrer: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the referral token vault (ATA) for stable curve referral rewards.
+ *
+ * @param referrer - Referrer's public key
+ * @param quoteMint - Quote token mint address
+ * @returns Associated token account address
+ */
+export declare const getReferralTokenVault: (referrer: PublicKey, quoteMint: PublicKey) => PublicKey;
+/**
+ * Derives the buyback vault PDA for a bonding curve.
+ *
+ * @param bondingCurve - Bonding curve PDA address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getBuybackVaultPDA: (bondingCurve: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the token-based bonding curve PDA for a token mint and quote mint.
+ *
+ * @param mint - Token mint address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export declare const getStableBondingCurvePDA: (mint: PublicKey, quoteMint: PublicKey, programId: PublicKey) => [PublicKey, number];
+/**
+ * Derives the bonding curve's token account (ATA) for holding minted tokens.
+ * Uses Token-2022 since bonding curve mints use the Token-2022 program.
+ *
+ * @param mint - Token mint address
+ * @param programId - Liquid program ID
+ * @returns Associated token account address
+ */
+export declare const getBondingCurveTokenAccount: (mint: PublicKey, programId: PublicKey) => PublicKey;
+//# sourceMappingURL=liquid.d.ts.map

package/dist/pda/liquid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.d.ts","sourceRoot":"","sources":["../../src/pda/liquid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAc5C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACpC,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAEpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,MAAM,SAAS,EACf,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,cAAc,SAAS,EACvB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC/B,UAAU,SAAS,EACnB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAU,SAAS,EACnB,WAAW,SAAS,KAClB,SAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,cAAc,SAAS,EACvB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACpC,MAAM,SAAS,EACf,WAAW,SAAS,EACpB,WAAW,SAAS,KAClB,CAAC,SAAS,EAAE,MAAM,CAKpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACvC,MAAM,SAAS,EACf,WAAW,SAAS,KAClB,SAQF,CAAC"}

package/dist/pda/liquid.js

@@ -0,0 +1,91 @@
+import { PublicKey } from "@solana/web3.js";
+import { getAssociatedTokenAddressSync, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, } from "@solana/spl-token";
+const SEED_GLOBAL_CONFIG = Buffer.from("global_config");
+const SEED_BONDING_CURVE = Buffer.from("bonding_curve");
+const SEED_BONDING_CURVE_SOL_VAULT = Buffer.from("bonding_curve_sol_vault");
+const SEED_REFERRAL_VAULT = Buffer.from("referral_vault");
+const SEED_BUYBACK_VAULT = Buffer.from("buyback_vault");
+const SEED_TOKEN_BONDING_CURVE = Buffer.from("token_bonding_curve");
+/**
+ * Derives the global configuration PDA for the liquid program.
+ *
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getLiquidGlobalConfigPDA = (programId) => {
+    return PublicKey.findProgramAddressSync([SEED_GLOBAL_CONFIG], programId);
+};
+/**
+ * Derives the bonding curve PDA for a token mint.
+ *
+ * @param mint - Token mint address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getBondingCurvePDA = (mint, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_BONDING_CURVE, mint.toBuffer()], programId);
+};
+/**
+ * Derives the bonding curve SOL vault PDA.
+ *
+ * @param bondingCurve - Bonding curve PDA address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getBondingCurveSolVaultPDA = (bondingCurve, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_BONDING_CURVE_SOL_VAULT, bondingCurve.toBuffer()], programId);
+};
+/**
+ * Derives the referral vault PDA for referral rewards.
+ *
+ * @param referrer - Referrer's public key
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getReferralVaultPDA = (referrer, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_REFERRAL_VAULT, referrer.toBuffer()], programId);
+};
+/**
+ * Derives the referral token vault (ATA) for stable curve referral rewards.
+ *
+ * @param referrer - Referrer's public key
+ * @param quoteMint - Quote token mint address
+ * @returns Associated token account address
+ */
+export const getReferralTokenVault = (referrer, quoteMint) => {
+    return getAssociatedTokenAddressSync(quoteMint, referrer, false, TOKEN_PROGRAM_ID);
+};
+/**
+ * Derives the buyback vault PDA for a bonding curve.
+ *
+ * @param bondingCurve - Bonding curve PDA address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getBuybackVaultPDA = (bondingCurve, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_BUYBACK_VAULT, bondingCurve.toBuffer()], programId);
+};
+/**
+ * Derives the token-based bonding curve PDA for a token mint and quote mint.
+ *
+ * @param mint - Token mint address
+ * @param quoteMint - Quote token mint address
+ * @param programId - Liquid program ID
+ * @returns Tuple of [PDA address, bump seed]
+ */
+export const getStableBondingCurvePDA = (mint, quoteMint, programId) => {
+    return PublicKey.findProgramAddressSync([SEED_TOKEN_BONDING_CURVE, mint.toBuffer(), quoteMint.toBuffer()], programId);
+};
+/**
+ * Derives the bonding curve's token account (ATA) for holding minted tokens.
+ * Uses Token-2022 since bonding curve mints use the Token-2022 program.
+ *
+ * @param mint - Token mint address
+ * @param programId - Liquid program ID
+ * @returns Associated token account address
+ */
+export const getBondingCurveTokenAccount = (mint, programId) => {
+    const [bondingCurve] = getBondingCurvePDA(mint, programId);
+    return getAssociatedTokenAddressSync(mint, bondingCurve, true, TOKEN_2022_PROGRAM_ID);
+};
+//# sourceMappingURL=liquid.js.map

package/dist/pda/liquid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.js","sourceRoot":"","sources":["../../src/pda/liquid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACN,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACxD,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACxD,MAAM,4BAA4B,GAAG,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAC5E,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAC1D,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACxD,MAAM,wBAAwB,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACvC,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CAAC,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,IAAe,EACf,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACrC,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACzC,YAAuB,EACvB,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,4BAA4B,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EACvD,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAClC,QAAmB,EACnB,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,mBAAmB,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAC1C,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,QAAmB,EACnB,SAAoB,EACR,EAAE;IACd,OAAO,6BAA6B,CACnC,SAAS,EACT,QAAQ,EACR,KAAK,EACL,gBAAgB,CAChB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,YAAuB,EACvB,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,kBAAkB,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAC7C,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACvC,IAAe,EACf,SAAoB,EACpB,SAAoB,EACE,EAAE;IACxB,OAAO,SAAS,CAAC,sBAAsB,CACtC,CAAC,wBAAwB,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EACjE,SAAS,CACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAC1C,IAAe,EACf,SAAoB,EACR,EAAE;IACd,MAAM,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3D,OAAO,6BAA6B,CACnC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,qBAAqB,CACrB,CAAC;AACH,CAAC,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,26 @@
+import { AnchorProvider } from "@coral-xyz/anchor";
+import { Connection, PublicKey, type Transaction, type VersionedTransaction } from "@solana/web3.js";
+/**
+ * A wallet that satisfies Anchor's Wallet interface via structural typing,
+ * without requiring a Keypair. Used for read-only operations (account fetching)
+ * and instruction building where no actual signing is needed.
+ */
+export declare class ReadonlyWallet {
+    readonly publicKey: PublicKey;
+    /** @throws Always throws — signing is not supported on a read-only wallet. */
+    signTransaction<T extends Transaction | VersionedTransaction>(_tx: T): Promise<T>;
+    /** @throws Always throws — signing is not supported on a read-only wallet. */
+    signAllTransactions<T extends Transaction | VersionedTransaction>(_txs: T[]): Promise<T[]>;
+}
+/**
+ * Creates an AnchorProvider for read-only operations (account fetching).
+ * Uses a real Connection but a dummy wallet that throws on sign attempts.
+ */
+export declare function createReadonlyProvider(connection: Connection): AnchorProvider;
+/**
+ * Returns a cached stub AnchorProvider for instruction building.
+ * Instruction building via `.instruction()` never hits the network,
+ * so no real Connection is needed.
+ */
+export declare function createStubProvider(): AnchorProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACN,UAAU,EACV,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,QAAQ,CAAC,SAAS,YAAqB;IAEvC,8EAA8E;IACxE,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,oBAAoB,EACjE,GAAG,EAAE,CAAC,GACJ,OAAO,CAAC,CAAC,CAAC;IAIb,8EAA8E;IACxE,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,oBAAoB,EACrE,IAAI,EAAE,CAAC,EAAE,GACP,OAAO,CAAC,CAAC,EAAE,CAAC;CAGf;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAK7E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAQnD"}

package/dist/provider.js

@@ -0,0 +1,47 @@
+import { AnchorProvider } from "@coral-xyz/anchor";
+import { Connection, PublicKey, } from "@solana/web3.js";
+/**
+ * A wallet that satisfies Anchor's Wallet interface via structural typing,
+ * without requiring a Keypair. Used for read-only operations (account fetching)
+ * and instruction building where no actual signing is needed.
+ */
+export class ReadonlyWallet {
+    constructor() {
+        this.publicKey = PublicKey.default;
+    }
+    /** @throws Always throws — signing is not supported on a read-only wallet. */
+    async signTransaction(_tx) {
+        throw new Error("Cannot sign with a readonly provider");
+    }
+    /** @throws Always throws — signing is not supported on a read-only wallet. */
+    async signAllTransactions(_txs) {
+        throw new Error("Cannot sign with a readonly provider");
+    }
+}
+const readonlyWallet = new ReadonlyWallet();
+/**
+ * Creates an AnchorProvider for read-only operations (account fetching).
+ * Uses a real Connection but a dummy wallet that throws on sign attempts.
+ */
+export function createReadonlyProvider(connection) {
+    return new AnchorProvider(connection, readonlyWallet, {
+        commitment: "confirmed",
+        preflightCommitment: "confirmed",
+    });
+}
+let stubProvider = null;
+/**
+ * Returns a cached stub AnchorProvider for instruction building.
+ * Instruction building via `.instruction()` never hits the network,
+ * so no real Connection is needed.
+ */
+export function createStubProvider() {
+    if (!stubProvider) {
+        const stubConnection = new Connection("http://stub.invalid");
+        stubProvider = new AnchorProvider(stubConnection, readonlyWallet, {
+            commitment: "confirmed",
+        });
+    }
+    return stubProvider;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACN,UAAU,EACV,SAAS,GAGT,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAA3B;QACU,cAAS,GAAG,SAAS,CAAC,OAAO,CAAC;IAexC,CAAC;IAbA,8EAA8E;IAC9E,KAAK,CAAC,eAAe,CACpB,GAAM;QAEN,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,mBAAmB,CACxB,IAAS;QAET,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;CACD;AAED,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAsB;IAC5D,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE;QACrD,UAAU,EAAE,WAAW;QACvB,mBAAmB,EAAE,WAAW;KAChC,CAAC,CAAC;AACJ,CAAC;AAED,IAAI,YAAY,GAA0B,IAAI,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IACjC,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,qBAAqB,CAAC,CAAC;QAC7D,YAAY,GAAG,IAAI,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE;YACjE,UAAU,EAAE,WAAW;SACvB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/transaction/builder.d.ts

@@ -0,0 +1,30 @@
+import { Transaction, type Connection, type PublicKey, type TransactionInstruction } from "@solana/web3.js";
+export interface BuildTransactionOptions {
+    /** The public key of the fee payer */
+    feePayer: PublicKey;
+    /** Compute unit limit (omit to let the runtime decide) */
+    computeUnits?: number;
+    /** Priority fee in micro-lamports per compute unit */
+    priorityFee?: number;
+}
+/**
+ * Prepends compute budget instructions to an instruction list.
+ * Returns a new array; does not mutate the input.
+ *
+ * @param instructions - Transaction instructions to prepend budget to
+ * @param options - Compute unit limit and/or priority fee
+ * @returns New instruction array with budget instructions prepended
+ */
+export declare function withComputeBudget(instructions: TransactionInstruction[], options: Pick<BuildTransactionOptions, "computeUnits" | "priorityFee">): TransactionInstruction[];
+/**
+ * Builds an unsigned Transaction from one or more instructions.
+ * Fetches a recent blockhash and sets the fee payer. The caller is
+ * responsible for signing.
+ *
+ * @param connection - Solana RPC connection
+ * @param instructions - Transaction instructions to include
+ * @param options - Fee payer and optional compute budget settings
+ * @returns Unsigned transaction ready for signing
+ */
+export declare function buildTransaction(connection: Connection, instructions: TransactionInstruction[], options: BuildTransactionOptions): Promise<Transaction>;
+//# sourceMappingURL=builder.d.ts.map

package/dist/transaction/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/transaction/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,WAAW,EACX,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACvC,sCAAsC;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,sBAAsB,EAAE,EACtC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,GAAG,aAAa,CAAC,GACpE,sBAAsB,EAAE,CAiB1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACrC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,sBAAsB,EAAE,EACtC,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAkBtB"}

package/dist/transaction/builder.js

@@ -0,0 +1,48 @@
+import { ComputeBudgetProgram, Transaction, } from "@solana/web3.js";
+/**
+ * Prepends compute budget instructions to an instruction list.
+ * Returns a new array; does not mutate the input.
+ *
+ * @param instructions - Transaction instructions to prepend budget to
+ * @param options - Compute unit limit and/or priority fee
+ * @returns New instruction array with budget instructions prepended
+ */
+export function withComputeBudget(instructions, options) {
+    const budget = [];
+    if (options.computeUnits !== undefined) {
+        budget.push(ComputeBudgetProgram.setComputeUnitLimit({
+            units: options.computeUnits,
+        }));
+    }
+    if (options.priorityFee !== undefined) {
+        budget.push(ComputeBudgetProgram.setComputeUnitPrice({
+            microLamports: options.priorityFee,
+        }));
+    }
+    return [...budget, ...instructions];
+}
+/**
+ * Builds an unsigned Transaction from one or more instructions.
+ * Fetches a recent blockhash and sets the fee payer. The caller is
+ * responsible for signing.
+ *
+ * @param connection - Solana RPC connection
+ * @param instructions - Transaction instructions to include
+ * @param options - Fee payer and optional compute budget settings
+ * @returns Unsigned transaction ready for signing
+ */
+export async function buildTransaction(connection, instructions, options) {
+    const { feePayer, ...budgetOptions } = options;
+    const allIxs = budgetOptions.computeUnits !== undefined ||
+        budgetOptions.priorityFee !== undefined
+        ? withComputeBudget(instructions, budgetOptions)
+        : instructions;
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+    const tx = new Transaction();
+    tx.add(...allIxs);
+    tx.recentBlockhash = blockhash;
+    tx.lastValidBlockHeight = lastValidBlockHeight;
+    tx.feePayer = feePayer;
+    return tx;
+}
+//# sourceMappingURL=builder.js.map

package/dist/transaction/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/transaction/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,WAAW,GAIX,MAAM,iBAAiB,CAAC;AAWzB;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAChC,YAAsC,EACtC,OAAsE;IAEtE,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CACV,oBAAoB,CAAC,mBAAmB,CAAC;YACxC,KAAK,EAAE,OAAO,CAAC,YAAY;SAC3B,CAAC,CACF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CACV,oBAAoB,CAAC,mBAAmB,CAAC;YACxC,aAAa,EAAE,OAAO,CAAC,WAAW;SAClC,CAAC,CACF,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,UAAsB,EACtB,YAAsC,EACtC,OAAgC;IAEhC,MAAM,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,MAAM,GACX,aAAa,CAAC,YAAY,KAAK,SAAS;QACxC,aAAa,CAAC,WAAW,KAAK,SAAS;QACtC,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC;QAChD,CAAC,CAAC,YAAY,CAAC;IAEjB,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACxC,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAEvC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAClB,EAAE,CAAC,eAAe,GAAG,SAAS,CAAC;IAC/B,EAAE,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IAC/C,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAEvB,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/transaction/index.d.ts

@@ -0,0 +1,3 @@
+export { confirmTx, sendAndConfirm } from "./send.js";
+export { withComputeBudget, buildTransaction, type BuildTransactionOptions, } from "./builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,uBAAuB,GAC5B,MAAM,cAAc,CAAC"}

package/dist/transaction/index.js

@@ -0,0 +1,3 @@
+export { confirmTx, sendAndConfirm } from "./send.js";
+export { withComputeBudget, buildTransaction, } from "./builder.js";
+//# sourceMappingURL=index.js.map

package/dist/transaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACN,iBAAiB,EACjB,gBAAgB,GAEhB,MAAM,cAAc,CAAC"}