@flashnet/sdk 0.1.1

package/dist/src/client/FlashnetClient.d.ts

@@ -0,0 +1,216 @@
+import type { IssuerSparkWallet } from "@buildonspark/issuer-sdk";
+import type { SparkWallet } from "@buildonspark/spark-sdk";
+import type { NetworkType, ListPoolsQuery, ListPoolsResponse, PoolDetailsResponse, LpPositionDetailsResponse, SimulateSwapRequest, SimulateSwapResponse, SwapResponse, SimulateAddLiquidityRequest, SimulateAddLiquidityResponse, AddLiquidityResponse, SimulateRemoveLiquidityRequest, SimulateRemoveLiquidityResponse, RemoveLiquidityResponse, CreatePoolResponse, ConfirmDepositResponse, RegisterHostResponse, GetHostResponse, WithdrawHostFeesResponse, GetPoolHostFeesResponse, ListPoolSwapsQuery, ListPoolSwapsResponse, ListGlobalSwapsQuery, ListGlobalSwapsResponse, ListUserSwapsQuery, ListUserSwapsResponse, SettlementPingResponse } from "../types";
+export interface TokenBalance {
+    balance: bigint;
+    tokenInfo?: {
+        tokenPublicKey: string;
+        tokenName: string;
+        tokenSymbol: string;
+        tokenDecimals: number;
+        maxSupply: bigint;
+    };
+}
+export interface WalletBalance {
+    balance: bigint;
+    tokenBalances: Map<string, TokenBalance>;
+}
+export interface FlashnetClientOptions {
+    autoAuthenticate?: boolean;
+}
+/**
+ * FlashnetClient - A comprehensive client for interacting with Flashnet AMM
+ *
+ * This client wraps a SparkWallet and provides:
+ * - Automatic network detection from the wallet
+ * - Automatic authentication
+ * - Balance checking before operations
+ * - All AMM operations (pools, swaps, liquidity, hosts)
+ * - Direct wallet access via client.wallet
+ */
+export declare class FlashnetClient {
+    private _wallet;
+    private apiClient;
+    private typedApi;
+    private authManager;
+    private network;
+    private publicKey;
+    private sparkAddress;
+    private isAuthenticated;
+    /**
+     * Get the underlying wallet instance for direct wallet operations
+     */
+    get wallet(): IssuerSparkWallet | SparkWallet;
+    /**
+     * Get the network type
+     */
+    get networkType(): NetworkType;
+    /**
+     * Get the wallet's public key
+     */
+    get pubkey(): string;
+    /**
+     * Get the wallet's Spark address
+     */
+    get address(): string;
+    /**
+     * Create a new FlashnetClient instance
+     * @param wallet - The SparkWallet to use
+     * @param options - Client options
+     */
+    constructor(wallet: IssuerSparkWallet | SparkWallet, options?: FlashnetClientOptions);
+    /**
+     * Initialize the client by deducing network and authenticating
+     * This is called automatically on first use if not called manually
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure the client is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Get wallet balance including BTC and token balances
+     */
+    getBalance(): Promise<WalletBalance>;
+    /**
+     * Check if wallet has sufficient balance for an operation
+     */
+    private checkBalance;
+    /**
+     * List pools with optional filters
+     */
+    listPools(query?: ListPoolsQuery): Promise<ListPoolsResponse>;
+    /**
+     * Get detailed information about a specific pool
+     */
+    getPool(poolId: string): Promise<PoolDetailsResponse>;
+    /**
+     * Get LP position details for a provider in a pool
+     */
+    getLpPosition(poolId: string, providerPublicKey?: string): Promise<LpPositionDetailsResponse>;
+    /**
+     * Create a constant product pool
+     */
+    createConstantProductPool(params: {
+        assetATokenPublicKey: string;
+        assetBTokenPublicKey: string;
+        lpFeeRateBps: number;
+        totalHostFeeRateBps: number;
+        integratorNamespace?: string;
+        initialLiquidity?: {
+            assetAAmount: bigint;
+            assetBAmount: bigint;
+        };
+    }): Promise<CreatePoolResponse>;
+    /**
+     * Create a single-sided pool with automatic initial deposit
+     *
+     * This method creates a single-sided pool and automatically handles the initial deposit.
+     * The initial reserve amount will be transferred to the pool and confirmed.
+     */
+    createSingleSidedPool(params: {
+        assetATokenPublicKey: string;
+        assetBTokenPublicKey: string;
+        assetAInitialReserve: string;
+        assetAInitialVirtualReserve: string;
+        assetBInitialVirtualReserve: string;
+        threshold: string;
+        lpFeeRateBps: number;
+        totalHostFeeRateBps: number;
+        hostNamespace?: string;
+    }): Promise<CreatePoolResponse>;
+    /**
+     * Confirm initial deposit for single-sided pool
+     *
+     * Note: This is typically handled automatically by createSingleSidedPool().
+     * Use this method only if you need to manually confirm a deposit (e.g., after a failed attempt).
+     */
+    confirmInitialDeposit(poolId: string, assetASparkTransferId: string): Promise<ConfirmDepositResponse>;
+    /**
+     * Simulate a swap without executing it
+     */
+    simulateSwap(params: SimulateSwapRequest): Promise<SimulateSwapResponse>;
+    /**
+     * Execute a swap
+     */
+    executeSwap(params: {
+        poolId: string;
+        assetInTokenPublicKey: string;
+        assetOutTokenPublicKey: string;
+        amountIn: bigint;
+        minAmountOut: bigint;
+        maxSlippageBps: number;
+    }): Promise<SwapResponse>;
+    /**
+     * Simulate adding liquidity
+     */
+    simulateAddLiquidity(params: SimulateAddLiquidityRequest): Promise<SimulateAddLiquidityResponse>;
+    /**
+     * Add liquidity to a pool
+     */
+    addLiquidity(params: {
+        poolId: string;
+        assetAAmount: bigint;
+        assetBAmount: bigint;
+    }): Promise<AddLiquidityResponse>;
+    /**
+     * Simulate removing liquidity
+     */
+    simulateRemoveLiquidity(params: SimulateRemoveLiquidityRequest): Promise<SimulateRemoveLiquidityResponse>;
+    /**
+     * Remove liquidity from a pool
+     */
+    removeLiquidity(params: {
+        poolId: string;
+        lpTokensToRemove: string;
+    }): Promise<RemoveLiquidityResponse>;
+    /**
+     * Register as a host
+     */
+    registerHost(params: {
+        namespace: string;
+        minFeeBps: number;
+        feeRecipientPublicKey?: string;
+    }): Promise<RegisterHostResponse>;
+    /**
+     * Get host information
+     */
+    getHost(namespace: string): Promise<GetHostResponse>;
+    /**
+     * Get pool host fees
+     */
+    getPoolHostFees(hostNamespace: string, poolId: string): Promise<GetPoolHostFeesResponse>;
+    /**
+     * Withdraw host fees
+     */
+    withdrawHostFees(params: {
+        lpIdentityPublicKey: string;
+        assetAAmount?: string;
+        assetBAmount?: string;
+    }): Promise<WithdrawHostFeesResponse>;
+    /**
+     * Get swaps for a specific pool
+     */
+    getPoolSwaps(lpPubkey: string, query?: ListPoolSwapsQuery): Promise<ListPoolSwapsResponse>;
+    /**
+     * Get global swaps across all pools
+     */
+    getGlobalSwaps(query?: ListGlobalSwapsQuery): Promise<ListGlobalSwapsResponse>;
+    /**
+     * Get swaps for a specific user
+     */
+    getUserSwaps(userPublicKey?: string, query?: ListUserSwapsQuery): Promise<ListUserSwapsResponse>;
+    /**
+     * Ping the settlement service
+     */
+    ping(): Promise<SettlementPingResponse>;
+    /**
+     * Helper method to add initial liquidity after pool creation
+     */
+    private addInitialLiquidity;
+    /**
+     * Clean up wallet connections
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=FlashnetClient.d.ts.map

package/dist/src/client/FlashnetClient.d.ts.map

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