naracli 1.0.17 → 1.0.22

package/src/config.ts

@@ -1,132 +0,0 @@
-import { Keypair, PublicKey, Transaction } from "@solana/web3.js";
-import {
-  buildCurveWithMarketCap,
-  ActivationType,
-  CollectFeeMode,
-  BaseFeeMode,
-  MigrationFeeOption,
-  MigrationOption,
-  TokenDecimal,
-  TokenType,
-  TokenUpdateAuthorityOption,
-} from "@meteora-ag/dynamic-bonding-curve-sdk";
-import { NATIVE_MINT } from "@solana/spl-token";
-import { NaraSDK } from "./client";
-
-/**
- * Options for creating configuration
- */
-export interface CreateConfigOptions {
-  /** Fee claimer wallet address */
-  feeClaimer: PublicKey;
-  /** Leftover token receiver wallet address */
-  leftoverReceiver: PublicKey;
-  /** Payer wallet address */
-  payer: PublicKey;
-  // Curve parameters (all optional with defaults)
-  /** Total token supply (default: 1,000,000,000) */
-  totalTokenSupply?: number;
-  /** Initial market cap (default: 30) */
-  initialMarketCap?: number;
-  /** Migration market cap threshold (default: 540) */
-  migrationMarketCap?: number;
-}
-
-/**
- * Return type for bonding curve config transaction creation
- */
-export interface CreateConfigResult {
-  /** Config address */
-  configAddress: string;
-  /** Unsigned transaction */
-  transaction: Transaction;
-  /** Config keypair (requires partial signature) */
-  configKeypair: Keypair;
-}
-
-/**
- * Create bonding curve config transaction (returns unsigned transaction)
- * @param sdk NaraSDK SDK instance
- * @param options Configuration options
- * @returns Config address, unsigned transaction, and config keypair
- */
-export async function createConfig(
-  sdk: NaraSDK,
-  options: CreateConfigOptions
-): Promise<CreateConfigResult> {
-  const connection = sdk.getConnection();
-  const client = sdk.getClient();
-
-  // Generate new config keypair
-  const config = Keypair.generate();
-
-  // Build bonding curve configuration
-  const curveConfig = buildCurveWithMarketCap({
-    totalTokenSupply: options.totalTokenSupply ?? 1_000_000_000, // Total token supply
-    initialMarketCap: options.initialMarketCap ?? 30, // Initial market cap
-    migrationMarketCap: options.migrationMarketCap ?? 540, // Migration market cap threshold
-    migrationOption: MigrationOption.MET_DAMM_V2, // Migration option: use Meteora DAMM V2
-    tokenBaseDecimal: TokenDecimal.SIX, // Base token decimals: 6
-    tokenQuoteDecimal: TokenDecimal.NINE, // Quote token decimals: 9 (SOL)
-    // Locked vesting parameters
-    lockedVestingParams: {
-      totalLockedVestingAmount: 0, // Total locked vesting amount
-      numberOfVestingPeriod: 0, // Number of vesting periods
-      cliffUnlockAmount: 0, // Cliff unlock amount
-      totalVestingDuration: 0, // Total vesting duration
-      cliffDurationFromMigrationTime: 0, // Cliff duration from migration time
-    },
-    // Base fee parameters
-    baseFeeParams: {
-      baseFeeMode: BaseFeeMode.FeeSchedulerLinear, // Fee mode: linear scheduler
-      feeSchedulerParam: {
-        startingFeeBps: 100, // Starting fee (basis points): 1%
-        endingFeeBps: 100, // Ending fee (basis points): 1%
-        numberOfPeriod: 0, // Number of periods
-        totalDuration: 0, // Total duration
-      },
-    },
-    dynamicFeeEnabled: true, // Enable dynamic fees
-    activationType: ActivationType.Slot, // Activation type: slot-based
-    collectFeeMode: CollectFeeMode.QuoteToken, // Fee collection mode: quote token
-    migrationFeeOption: MigrationFeeOption.FixedBps25, // Migration fee option: fixed 1%
-    tokenType: TokenType.SPL, // Token type: SPL token
-    partnerLiquidityPercentage: 0, // Partner liquidity percentage
-    creatorLiquidityPercentage: 0, // Creator liquidity percentage
-    partnerPermanentLockedLiquidityPercentage: 100, // Partner permanent locked liquidity: 100%
-    creatorPermanentLockedLiquidityPercentage: 0, // Creator permanent locked liquidity: 0%
-    creatorTradingFeePercentage: 0, // Creator trading fee percentage: 0%
-    leftover: 0, // Leftover token amount
-    tokenUpdateAuthority: TokenUpdateAuthorityOption.Immutable, // Token update authority: immutable
-    // Migration fee
-    migrationFee: {
-      feePercentage: 0, // Fee percentage
-      creatorFeePercentage: 0, // Creator fee percentage
-    },
-    poolCreationFee: 0.1, // Pool creation fee
-    enableFirstSwapWithMinFee: true, // Enable first swap with minimum fee
-  });
-
-  // Create config transaction
-  const transaction = await client.partner.createConfig({
-    config: config.publicKey, // Config public key
-    feeClaimer: options.feeClaimer, // Fee claimer
-    leftoverReceiver: options.leftoverReceiver, // Leftover receiver
-    payer: options.payer, // Payer
-    quoteMint: NATIVE_MINT, // Quote mint: native SOL
-    ...curveConfig, // Curve config parameters
-  });
-
-  // Get latest blockhash
-  const { blockhash } = await connection.getLatestBlockhash("confirmed");
-  transaction.recentBlockhash = blockhash;
-  transaction.feePayer = options.payer;
-  // Config account partial signature
-  transaction.partialSign(config);
-
-  return {
-    configAddress: config.publicKey.toBase58(), // Config address
-    transaction, // Unsigned transaction (already has config's partial signature)
-    configKeypair: config, // Config keypair
-  };
-}

package/src/constants.ts

@@ -1,35 +0,0 @@
-/**
- * SDK and CLI default constants
- *
- * Priority for all values: CLI flag > env variable > default value
- */
-
-/**
- * Default RPC URL for Nara testnet
- */
-export const DEFAULT_RPC_URL =
-  process.env.RPC_URL || "https://mainnet-api.nara.build/";
-
-/**
- * Default bonding curve config address
- */
-export const DEFAULT_DBC_CONFIG_ADDRESS =
-  process.env.DBC_CONFIG_ADDRESS || "";
-
-/**
- * Default wallet path
- */
-export const DEFAULT_WALLET_PATH =
-  process.env.WALLET_PATH || "~/.config/nara/id.json";
-
-/**
- * Default quest relay URL
- */
-export const DEFAULT_QUEST_RELAY_URL =
-  process.env.QUEST_RELAY_URL || "https://quest-api.nara.build/";
-
-/**
- * Quest program ID
- */
-export const DEFAULT_QUEST_PROGRAM_ID =
-  process.env.QUEST_PROGRAM_ID || "Quest11111111111111111111111111111111111111";

package/src/migrate.ts

@@ -1,222 +0,0 @@
-import {
-  PublicKey,
-  Transaction,
-  Keypair,
-  VersionedTransaction,
-} from "@solana/web3.js";
-import BN from "bn.js";
-import { NaraSDK } from "./client";
-import { DAMM_V2_MIGRATION_FEE_ADDRESS } from "@meteora-ag/dynamic-bonding-curve-sdk";
-
-export interface MigrateToDAMMV2Params {
-  /** Token address (baseMint) */
-  tokenAddress: string;
-  /** Payer */
-  payer: PublicKey;
-}
-
-export interface MigrateToDAMMV2Result {
-  /** Migration transaction (returns VersionedTransaction if ALT is configured) */
-  transaction: Transaction | VersionedTransaction;
-  /** First Position NFT keypair (requires signature) */
-  firstPositionNftKeypair: Keypair;
-  /** Second Position NFT keypair (requires signature) */
-  secondPositionNftKeypair: Keypair;
-  /** Pool address */
-  poolAddress: string;
-}
-
-export interface CreateLockerParams {
-  /** Token address (baseMint) */
-  tokenAddress: string;
-  /** Payer */
-  payer: PublicKey;
-}
-
-export interface CreateLockerResult {
-  /** Locker creation transaction (returns VersionedTransaction if ALT is configured) */
-  transaction: Transaction | VersionedTransaction;
-  /** Pool address */
-  poolAddress: string;
-}
-
-/**
- * Launch token pool to DAMM V2 (graduation)
- *
- * Call this function to migrate the pool to DAMM V2 after the bonding curve is complete (100%)
- *
- * Notes:
- * - dammConfig address is automatically derived from pool config's migrationFeeOption
- * - If token has locked vesting parameters, may need to call createLocker() first
- * - Requires signatures from three keypairs: payer, firstPositionNftKeypair, secondPositionNftKeypair
- *
- * @param sdk NaraSDK SDK instance
- * @param params Migration parameters
- * @returns Migration transaction, Position NFT keypairs, and pool address
- */
-export async function migrateToDAMMV2(
-  sdk: NaraSDK,
-  params: MigrateToDAMMV2Params
-): Promise<MigrateToDAMMV2Result> {
-  const connection = sdk.getConnection();
-  const client = sdk.getClient();
-  const tokenPubkey = new PublicKey(params.tokenAddress);
-
-  // Get pool account
-  const poolAccount = await client.state.getPoolByBaseMint(tokenPubkey);
-  if (!poolAccount) {
-    throw new Error(`Pool not found for token: ${params.tokenAddress}`);
-  }
-
-  // Check if pool has already been migrated
-  if (poolAccount.account.isMigrated) {
-    throw new Error("Pool has already been migrated");
-  }
-
-  // Get pool config and read migrationFeeOption
-  const virtualPool = poolAccount.account;
-  const poolConfig = await client.state.getPoolConfig(virtualPool.config);
-
-  // Get corresponding config address from DAMM_V2_MIGRATION_FEE_ADDRESS array
-  // Using 'any' type since poolConfig's migrationFeeOption is IDL-derived
-  const migrationFeeOption = (poolConfig as any).migrationFeeOption || 0;
-  const dammConfig = DAMM_V2_MIGRATION_FEE_ADDRESS[migrationFeeOption];
-
-  if (!dammConfig) {
-    throw new Error(
-      `Invalid migration fee option: ${migrationFeeOption}. Cannot determine DAMM config address.`
-    );
-  }
-
-  // Note: If the pool has locked vesting parameters, a locker might need to be created first
-  // Use createLocker() if the migration fails due to missing locker
-
-  // Call SDK's migrateToDammV2 method
-  const result = await client.migration.migrateToDammV2({
-    payer: params.payer,
-    virtualPool: poolAccount.publicKey,
-    dammConfig,
-  });
-
-  // Get latest blockhash
-  const { blockhash } = await connection.getLatestBlockhash("confirmed");
-  result.transaction.recentBlockhash = blockhash;
-  result.transaction.feePayer = params.payer;
-
-  // Compile transaction with ALT if configured
-  const compiledTx = await sdk.compileTransactionWithALT(
-    result.transaction,
-    params.payer
-  );
-
-  return {
-    transaction: compiledTx,
-    firstPositionNftKeypair: result.firstPositionNftKeypair,
-    secondPositionNftKeypair: result.secondPositionNftKeypair,
-    poolAddress: poolAccount.publicKey.toBase58(),
-  };
-}
-
-/**
- * Create Locker (for token pools with locked vesting parameters)
- *
- * If the token pool has locked vesting parameters (amountPerPeriod > 0 or cliffUnlockAmount > 0),
- * a locker must be created before migrating to DAMM V2
- *
- * @param sdk NaraSDK SDK instance
- * @param params Locker parameters
- * @returns Locker creation transaction and pool address
- */
-export async function createLocker(
-  sdk: NaraSDK,
-  params: CreateLockerParams
-): Promise<CreateLockerResult> {
-  const connection = sdk.getConnection();
-  const client = sdk.getClient();
-  const tokenPubkey = new PublicKey(params.tokenAddress);
-
-  // Get pool account
-  const poolAccount = await client.state.getPoolByBaseMint(tokenPubkey);
-  if (!poolAccount) {
-    throw new Error(`Pool not found for token: ${params.tokenAddress}`);
-  }
-
-  // Create locker
-  const transaction = await client.migration.createLocker({
-    payer: params.payer,
-    virtualPool: poolAccount.publicKey,
-  });
-
-  // Get latest blockhash
-  const { blockhash } = await connection.getLatestBlockhash("confirmed");
-  transaction.recentBlockhash = blockhash;
-  transaction.feePayer = params.payer;
-
-  // Compile transaction with ALT if configured
-  const compiledTx = await sdk.compileTransactionWithALT(
-    transaction,
-    params.payer
-  );
-
-  return {
-    transaction: compiledTx,
-    poolAddress: poolAccount.publicKey.toBase58(),
-  };
-}
-
-/**
- * Check if pool can be launched to DAMM V2
- *
- * @param sdk NaraSDK SDK instance
- * @param tokenAddress Token address (baseMint)
- * @returns Whether pool can be launched
- */
-export async function canMigrate(
-  sdk: NaraSDK,
-  tokenAddress: string
-): Promise<{
-  canMigrate: boolean;
-  reason?: string;
-  progress: number;
-}> {
-  const client = sdk.getClient();
-  const tokenPubkey = new PublicKey(tokenAddress);
-
-  // Get pool account
-  const poolAccount = await client.state.getPoolByBaseMint(tokenPubkey);
-  if (!poolAccount) {
-    return {
-      canMigrate: false,
-      reason: "Pool not found",
-      progress: 0,
-    };
-  }
-
-  // Check if already migrated
-  if (poolAccount.account.isMigrated) {
-    return {
-      canMigrate: false,
-      reason: "Pool has already been migrated",
-      progress: 1,
-    };
-  }
-
-  // Get curve progress
-  const progress = await client.state.getPoolCurveProgress(
-    poolAccount.publicKey
-  );
-
-  // Check if 100% complete
-  if (progress >= 1.0) {
-    return {
-      canMigrate: true,
-      progress,
-    };
-  }
-
-  return {
-    canMigrate: false,
-    reason: `Curve not complete. Current progress: ${(progress * 100).toFixed(2)}%`,
-    progress,
-  };
-}

package/src/pool.ts

@@ -1,259 +0,0 @@
-import {
-  Keypair,
-  PublicKey,
-  Transaction,
-  VersionedTransaction,
-} from "@solana/web3.js";
-import { NATIVE_MINT } from "@solana/spl-token";
-import BN from "bn.js";
-import { deriveDbcPoolAddress } from "@meteora-ag/dynamic-bonding-curve-sdk";
-import { NaraSDK } from "./client";
-
-export interface CreatePoolParams {
-  name: string;
-  symbol: string;
-  uri: string;
-  configAddress: string;
-  payer: PublicKey;
-  poolCreator: PublicKey;
-}
-
-export interface CreatePoolResult {
-  /** Pool address */
-  poolAddress: string;
-  /** Token address (baseMint) */
-  baseMint: string;
-  /** Unsigned transaction for pool creation (returns VersionedTransaction if ALT is configured) */
-  transaction: Transaction | VersionedTransaction;
-  /** baseMint keypair (requires signature) */
-  baseMintKeypair: Keypair;
-}
-
-export interface CreatePoolWithFirstBuyParams extends CreatePoolParams {
-  /** Initial buy amount in SOL */
-  initialBuyAmountSOL: number;
-  /** Buyer (defaults to payer) */
-  buyer?: PublicKey;
-  /** Token receiver (defaults to buyer) */
-  receiver?: PublicKey;
-  /** Slippage in basis points (default 100 = 1%) */
-  slippageBps?: number;
-}
-
-export interface CreatePoolWithFirstBuyResult {
-  /** Pool address */
-  poolAddress: string;
-  /** Token address (baseMint) */
-  baseMint: string;
-  /** Pool creation transaction (returns VersionedTransaction if ALT is configured) */
-  createPoolTx: Transaction | VersionedTransaction;
-  /** First buy transaction (returns VersionedTransaction if ALT is configured) */
-  firstBuyTx: Transaction | VersionedTransaction;
-  /** baseMint keypair (requires signature) */
-  baseMintKeypair: Keypair;
-  /** Buy information */
-  buyInfo: {
-    amountIn: string;
-    minimumAmountOut: string;
-  };
-}
-
-/**
- * Create token pool transaction (returns unsigned transaction)
- *
- * Note: If you want to make an initial buy, wait for this transaction to confirm
- * before using the buyToken() function
- *
- * @param sdk NaraSDK SDK instance
- * @param params Pool parameters
- * @returns Pool address, token address, unsigned transaction, and baseMint keypair
- */
-export async function createPool(
-  sdk: NaraSDK,
-  params: CreatePoolParams
-): Promise<CreatePoolResult> {
-  const connection = sdk.getConnection();
-  const client = sdk.getClient();
-
-  const baseMint = Keypair.generate();
-  const configPubkey = new PublicKey(params.configAddress);
-
-  // Create pool transaction
-  const createPoolTx = await client.pool.createPool({
-    baseMint: baseMint.publicKey,
-    config: configPubkey,
-    name: params.name,
-    symbol: params.symbol,
-    uri: params.uri,
-    payer: params.payer,
-    poolCreator: params.poolCreator,
-  });
-
-  // Get latest blockhash
-  const { blockhash } = await connection.getLatestBlockhash("confirmed");
-  createPoolTx.recentBlockhash = blockhash;
-  createPoolTx.feePayer = params.payer;
-
-  // Derive pool address
-  const poolPubkey = deriveDbcPoolAddress(
-    NATIVE_MINT,
-    baseMint.publicKey,
-    configPubkey
-  );
-
-  // Compile transaction with ALT if configured
-  const compiledTx = await sdk.compileTransactionWithALT(
-    createPoolTx,
-    params.payer
-  );
-
-  return {
-    poolAddress: poolPubkey.toBase58(),
-    baseMint: baseMint.publicKey.toBase58(),
-    transaction: compiledTx,
-    baseMintKeypair: baseMint,
-  };
-}
-
-/**
- * Create token pool and perform first buy (one-step completion)
- *
- * Uses SDK's createPoolWithFirstBuy method to complete creation and buy in one transaction
- *
- * @param sdk NaraSDK SDK instance
- * @param params Pool and buy parameters
- * @returns Pool address, token address, unsigned transactions, and baseMint keypair
- */
-export async function createPoolWithFirstBuy(
-  sdk: NaraSDK,
-  params: CreatePoolWithFirstBuyParams
-): Promise<CreatePoolWithFirstBuyResult> {
-  const connection = sdk.getConnection();
-  const client = sdk.getClient();
-
-  const baseMint = Keypair.generate();
-  const configPubkey = new PublicKey(params.configAddress);
-  const buyer = params.buyer ?? params.payer;
-  const receiver = params.receiver ?? buyer;
-
-  // Calculate buy amount
-  const buyAmount = new BN(params.initialBuyAmountSOL * 1e9); // SOL to lamports
-  const slippageBps = params.slippageBps ?? 100;
-
-  // For first buy, use conservative minimumAmountOut
-  // Set to 0 since this is the first buy with optimal price
-  const minimumAmountOut = new BN(0);
-
-  // Use SDK's createPoolWithFirstBuy method
-  const result = await client.pool.createPoolWithFirstBuy({
-    createPoolParam: {
-      baseMint: baseMint.publicKey,
-      config: configPubkey,
-      name: params.name,
-      symbol: params.symbol,
-      uri: params.uri,
-      payer: params.payer,
-      poolCreator: params.poolCreator,
-    },
-    firstBuyParam: {
-      buyer,
-      receiver,
-      buyAmount,
-      minimumAmountOut,
-      referralTokenAccount: null,
-    },
-  });
-
-  // Get latest blockhash
-  const { blockhash } = await connection.getLatestBlockhash("confirmed");
-
-  // Combine two transactions into one
-  const combinedTx = new Transaction();
-
-  // Add pool creation instructions
-  combinedTx.add(...result.createPoolTx.instructions);
-
-  // If first buy transaction exists, add buy instructions
-  if (result.swapBuyTx) {
-    combinedTx.add(...result.swapBuyTx.instructions);
-  }
-
-  // Set transaction metadata
-  combinedTx.recentBlockhash = blockhash;
-  combinedTx.feePayer = params.payer;
-
-  // Derive pool address
-  const poolPubkey = deriveDbcPoolAddress(
-    NATIVE_MINT,
-    baseMint.publicKey,
-    configPubkey
-  );
-
-  // Compile transaction with ALT if configured
-  const compiledTx = await sdk.compileTransactionWithALT(
-    combinedTx,
-    params.payer
-  );
-
-  return {
-    poolAddress: poolPubkey.toBase58(),
-    baseMint: baseMint.publicKey.toBase58(),
-    createPoolTx: compiledTx, // Return combined transaction
-    firstBuyTx: compiledTx, // Same as createPoolTx since they are combined
-    baseMintKeypair: baseMint,
-    buyInfo: {
-      amountIn: buyAmount.toString(),
-      minimumAmountOut: minimumAmountOut.toString(),
-    },
-  };
-}
-
-/**
- * Get pool information
- * @param sdk NaraSDK SDK instance
- * @param tokenAddress Token address (baseMint)
- * @returns Pool information
- */
-export async function getPoolInfo(sdk: NaraSDK, tokenAddress: string) {
-  const client = sdk.getClient();
-  const tokenPubkey = new PublicKey(tokenAddress);
-
-  // Get pool by token (baseMint) address
-  const poolAccount = await client.state.getPoolByBaseMint(tokenPubkey);
-  if (!poolAccount) {
-    throw new Error(`Pool not found for token: ${tokenAddress}`);
-  }
-
-  return {
-    ...poolAccount.account,
-    poolAddress: poolAccount.publicKey.toBase58(),
-  };
-}
-
-/**
- * Get pool curve progress
- * @param sdk NaraSDK SDK instance
- * @param tokenAddress Token address (baseMint)
- * @returns Curve progress information
- */
-export async function getPoolProgress(sdk: NaraSDK, tokenAddress: string) {
-  const client = sdk.getClient();
-  const tokenPubkey = new PublicKey(tokenAddress);
-
-  // Get pool by token (baseMint) address
-  const poolAccount = await client.state.getPoolByBaseMint(tokenPubkey);
-  if (!poolAccount) {
-    throw new Error(`Pool not found for token: ${tokenAddress}`);
-  }
-
-  const progress = await client.state.getPoolCurveProgress(
-    poolAccount.publicKey
-  );
-  const pool = poolAccount.account;
-
-  return {
-    progress,
-    quoteReserve: pool.quoteReserve?.toString() ?? "0",
-    isMigrated: pool.isMigrated ?? false,
-  };
-}