@flashnet/sdk 0.1.1

package/README.md

@@ -0,0 +1,479 @@
+# Flashnet SDK
+
+A comprehensive SDK for interacting with Flashnet's Spark wallet and AMM (Automated Market Maker) functionality.
+
+## Features
+
+- **Spark Wallet Integration** - Full wallet functionality based on `@buildonspark/issuer-sdk` or `@buildonspark/spark-sdk`
+- **AMM Operations** - Create pools (single-sided & constant product), swap tokens, add/remove liquidity
+- **Multi-Network Support** - Works across Mainnet and Regtest
+- **Intent-Based Signing** - Secure transaction signing with intent messages
+- **Custom Signers** - Support for arbitrary signing implementations (hardware wallets, remote signers, etc.)
+- **TypeScript First** - Full type safety and IntelliSense support
+
+## Installation
+
+```bash
+bun add @flashnet/sdk
+# or
+npm install @flashnet/sdk
+# or
+yarn add @flashnet/sdk
+```
+
+## Usage Options
+
+The Flashnet SDK offers two approaches to suit different needs:
+
+### 1. Full Client (Recommended for most users)
+
+Use `FlashnetClient` for a complete, ready-to-use solution with automatic network detection, authentication, and balance checking.
+
+```typescript
+import { FlashnetClient } from "@flashnet/sdk";
+import { IssuerSparkWallet } from "@buildonspark/issuer-sdk";
+
+// Initialize wallet
+const { wallet } = await IssuerSparkWallet.initialize({
+  mnemonicOrSeed: "your-mnemonic",
+  options: { network: "MAINNET" },
+});
+
+// Create client - handles everything automatically
+const client = new FlashnetClient(wallet);
+await client.initialize(); // Auto-detects network and authenticates
+
+// Ready to use!
+const pools = await client.listPools();
+const swapResult = await client.executeSwap({
+  poolId: "pool-id",
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: "token-out",
+  amountIn: 1000000n,
+  minAmountOut: 950000n,
+  maxSlippageBps: 500,
+});
+```
+
+### 2. 🧩 Modular Components (For advanced customization)
+
+Build your own client using individual SDK components for maximum flexibility.
+
+```typescript
+import {
+  ApiClient,
+  AuthManager,
+  getNetworkConfig,
+  generatePoolSwapIntentMessage,
+  type NetworkType,
+} from "@flashnet/sdk";
+
+// Manual setup
+const network: NetworkType = "MAINNET";
+const config = getNetworkConfig(network);
+const apiClient = new ApiClient(config);
+
+// Custom authentication
+const authManager = new AuthManager(apiClient, publicKey, customSigner);
+await authManager.authenticate();
+
+// Direct API calls
+const pools = await apiClient.ammGet("/v1/pools");
+```
+
+## When to Use Each Approach
+
+### Use FlashnetClient when:
+
+- ✅ You want to get started quickly
+- ✅ You're using a standard SparkWallet
+- ✅ You want automatic network detection from wallet
+- ✅ You want built-in balance checking
+- ✅ You need all standard AMM operations
+
+### Use Modular Components when:
+
+- ✅ You need custom authentication logic
+- ✅ You're integrating with existing infrastructure
+- ✅ You want fine-grained control over API calls
+- ✅ You're building a specialized application
+- ✅ You need to mix AMM operations with other protocols
+
+## Quick Start Examples
+
+### Using FlashnetClient (Full Client)
+
+```typescript
+import { FlashnetClient } from "@flashnet/sdk";
+import { IssuerSparkWallet } from "@buildonspark/issuer-sdk";
+
+// Initialize wallet and client
+const { wallet } = await IssuerSparkWallet.initialize({
+  mnemonicOrSeed: process.env.MNEMONIC,
+});
+
+const client = new FlashnetClient(wallet);
+
+// Check balance
+const balance = await client.getBalance();
+console.log(`BTC: ${balance.balance} sats`);
+console.log(`Tokens: ${balance.tokenBalances.size}`);
+
+// Create a constant product pool with initial liquidity
+const pool = await client.createConstantProductPool({
+  assetATokenPublicKey: "token-pubkey",
+  assetBTokenPublicKey: BTC_ASSET_PUBKEY,
+  lpFeeRateBps: 30, // 0.3%
+  totalHostFeeRateBps: 10, // 0.1%
+  initialLiquidity: {
+    assetAAmount: 1000000n,
+    assetBAmount: 5000n,
+  },
+});
+
+// Execute a swap (with automatic balance checking)
+const swap = await client.executeSwap({
+  poolId: pool.poolId,
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: BTC_ASSET_PUBKEY,
+  amountIn: 100000n,
+  minAmountOut: 450n,
+  maxSlippageBps: 500, // 5% slippage tolerance
+});
+```
+
+### Using Modular Components
+
+```typescript
+import {
+  ApiClient,
+  AuthManager,
+  getNetworkConfig,
+  encodeSparkAddress,
+  generatePoolSwapIntentMessage,
+  generateNonce,
+  createWalletSigner,
+} from "@flashnet/sdk";
+
+// Setup
+const config = getNetworkConfig("MAINNET");
+const apiClient = new ApiClient(config);
+const api = apiClient.amm; // Typed API endpoints
+
+// Authenticate with wallet
+const signer = createWalletSigner(wallet);
+const authManager = new AuthManager(apiClient, publicKey, signer);
+const token = await authManager.authenticate();
+apiClient.setAuthToken(token);
+
+// Use typed endpoints
+const pools = await api.listPools({
+  limit: 10,
+  sort: "tvlDesc",
+  minTvl: 1000000, // $10k minimum
+});
+
+// Manual swap flow
+const simulation = await api.simulateSwap({
+  poolId: "pool-id",
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: "token-out",
+  amountIn: 1000000,
+});
+
+// Generate and sign intent
+const intentMessage = generatePoolSwapIntentMessage({
+  userPublicKey: publicKey,
+  lpIdentityPublicKey: poolId,
+  assetASparkTransferId: transferId,
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: "token-out",
+  amountIn: "1000000",
+  minAmountOut: "950000",
+  maxSlippageBps: "500",
+  nonce: generateNonce(),
+});
+
+const signature = await signer.signMessage(
+  await crypto.subtle.digest("SHA-256", intentMessage)
+);
+
+// Execute swap
+const swap = await api.executeSwap({
+  // ... swap parameters
+  signature: Buffer.from(signature).toString("hex"),
+});
+```
+
+## Configuration
+
+The SDK supports the following networks:
+
+- `MAINNET` - Production network
+- `REGTEST` - Regression test network
+
+Each network has preconfigured endpoints for:
+
+- AMM Gateway
+- Mempool API
+- Block Explorer
+- SparkScan (when available)
+
+## FlashnetClient API Reference
+
+The `FlashnetClient` provides a complete interface for AMM operations:
+
+### Initialization
+
+```typescript
+const client = new FlashnetClient(wallet, {
+  autoAuthenticate: true, // Default: true
+});
+
+// Properties
+client.wallet; // Access underlying SparkWallet
+client.networkType; // Get network type
+client.pubkey; // Get wallet public key
+client.address; // Get Spark address
+```
+
+### Pool Operations
+
+```typescript
+// List and search pools
+await client.listPools({ limit: 10, sort: "tvlDesc" });
+
+// Get pool details
+await client.getPool(poolId);
+
+// Get LP position
+await client.getLpPosition(poolId);
+
+// Create pools with automatic initial deposits
+await client.createConstantProductPool({
+  assetATokenPublicKey: "token-a",
+  assetBTokenPublicKey: "token-b",
+  lpFeeRateBps: 30,
+  totalHostFeeRateBps: 10,
+  initialLiquidity: {
+    // Optional
+    assetAAmount: 1000000n,
+    assetBAmount: 5000n,
+  },
+});
+
+await client.createSingleSidedPool({
+  assetATokenPublicKey: "token-a",
+  assetBTokenPublicKey: BTC_ASSET_PUBKEY,
+  assetAInitialReserve: "1000000",
+  // ... other parameters
+});
+```
+
+### Swap Operations
+
+```typescript
+// Simulate first
+const simulation = await client.simulateSwap({
+  poolId: "pool-id",
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: "token-out",
+  amountIn: 1000000,
+});
+
+// Execute with automatic balance checking
+await client.executeSwap({
+  poolId: "pool-id",
+  assetInTokenPublicKey: "token-in",
+  assetOutTokenPublicKey: "token-out",
+  amountIn: 1000000n,
+  minAmountOut: 950000n,
+  maxSlippageBps: 500,
+});
+```
+
+### Liquidity Management
+
+```typescript
+// Add liquidity
+await client.addLiquidity({
+  poolId: "pool-id",
+  assetAAmount: 1000000n,
+  assetBAmount: 5000n,
+});
+
+// Remove liquidity
+await client.removeLiquidity({
+  poolId: "pool-id",
+  lpTokensToRemove: "500000",
+});
+```
+
+### Host Operations
+
+```typescript
+// Register as host
+await client.registerHost({
+  namespace: "my-exchange",
+  minFeeBps: 50,
+  feeRecipientPublicKey: "optional-different-pubkey",
+});
+
+await client.getHost("my-exchange");
+
+await client.getPoolHostFees("my-exchange", "pool-id");
+
+// Withdraw host fees
+await client.withdrawHostFees({
+  lpIdentityPublicKey: "pool-id",
+  assetAAmount: "1000",
+  assetBAmount: "500",
+});
+```
+
+## Modular Components Reference
+
+### 1. API Client
+
+The API client handles all HTTP communication:
+
+```typescript
+import { ApiClient } from "@flashnet/sdk";
+
+const client = new ApiClient(config);
+
+// Direct endpoints
+const pools = await client.ammGet("/v1/pools");
+const swapResult = await client.ammPost("/v1/swap", swapData);
+
+// Typed API wrapper
+const api = client.amm;
+const pools = await api.listPools({ limit: 10 });
+```
+
+### 2. Authentication & Signing
+
+Support for multiple signing methods:
+
+```typescript
+// Using Spark Wallet
+const authManager = new AuthManager(apiClient, pubkey, wallet);
+
+// Using Custom Signer
+class MyCustomSigner implements Signer {
+  async signMessage(message: Uint8Array): Promise<Uint8Array> {
+    // Your signing logic
+    return signature;
+  }
+}
+
+const signer = new MyCustomSigner();
+const authManager = new AuthManager(apiClient, pubkey, signer);
+await authManager.authenticate();
+```
+
+### 3. Intent Generation
+
+Generate intent messages for operations:
+
+```typescript
+import {
+  generatePoolSwapIntentMessage,
+  generateAddLiquidityIntentMessage,
+  generateConstantProductPoolInitializationIntentMessage,
+  generateNonce,
+  BTC_ASSET_PUBKEY,
+} from "@flashnet/sdk";
+
+// Swap intent
+const swapIntent = generatePoolSwapIntentMessage({
+  userPublicKey: "userPubkey",
+  lpIdentityPublicKey: "poolPubkey",
+  assetASparkTransferId: "transferId",
+  // ... other parameters
+  nonce: generateNonce(),
+});
+```
+
+### 4. Spark Address Utilities
+
+Work with Spark addresses:
+
+```typescript
+import {
+  encodeSparkAddress,
+  decodeSparkAddress,
+  isValidSparkAddress,
+  getNetworkFromAddress,
+} from "@flashnet/sdk";
+
+// Encode public key to address
+const sparkAddress = encodeSparkAddress({
+  identityPublicKey: "02abc...",
+  network: "MAINNET",
+});
+
+// Detect network from address
+const network = getNetworkFromAddress(sparkAddress);
+```
+
+### 5. Validation Utilities
+
+Validate requests before sending:
+
+```typescript
+import {
+  validateRequest,
+  commonValidationRules,
+  ValidationError,
+} from "@flashnet/sdk";
+
+try {
+  validateRequest(swapRequest, {
+    userPublicKey: commonValidationRules.publicKey,
+    amountIn: commonValidationRules.amount,
+  });
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error(`Invalid ${error.field}: ${error.reason}`);
+  }
+}
+```
+
+## Error Handling
+
+```typescript
+import { isFlashnetError } from "@flashnet/sdk";
+
+try {
+  const result = await client.executeSwap(/* ... */);
+} catch (error) {
+  if (isFlashnetError(error)) {
+    console.error(`API Error ${error.code}: ${error.msg}`);
+  }
+  // Handle other errors
+}
+```
+
+## Types
+
+The SDK exports all necessary TypeScript types:
+
+```typescript
+import type {
+  NetworkType,
+  Pool,
+  Token,
+  SwapSimulationRequest,
+  SwapSimulationResponse,
+  ExecuteSwapRequest,
+  AddLiquidityRequest,
+  RemoveLiquidityRequest,
+  LpPosition,
+  Signer,
+} from "@flashnet/sdk";
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type * from "./src/types";
+export type { RequestOptions } from "./src/api/client";
+export { ApiClient } from "./src/api/client";
+export { TypedAmmApi, isFlashnetError, isApiError, } from "./src/api/typed-endpoints";
+export { validatePublicKey, validateSignature, validatePositiveAmount, validateBps, validateNamespace, validateRequest, ValidationError, commonValidationRules, constantProductPoolValidationRules, type ValidationRule, type ValidationRules, } from "./src/api/validation";
+export * from "./src/config";
+export { fromSmallestUnit, generateNonce, toSmallestUnit } from "./src/utils";
+export { AuthManager } from "./src/utils/auth";
+export { createWalletSigner } from "./src/utils/signer";
+export { generateAddLiquidityIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generateConstantProductPoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRemoveLiquidityIntentMessage, generateRegisterHostIntentMessage, generateWithdrawHostFeesIntentMessage, } from "./src/utils/intents";
+export { convertSparkAddressToNetwork, decodeSparkAddress, encodeSparkAddress, getNetworkFromAddress, isValidPublicKey, isValidSparkAddress, looksLikePublicKey, type SparkAddressFormat, } from "./src/utils/spark-address";
+export { FlashnetClient, type FlashnetClientOptions, type TokenBalance, type WalletBalance, } from "./src/client/FlashnetClient";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,mBAAmB,aAAa,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,eAAe,EACf,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kCAAkC,EAClC,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAG9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iCAAiC,EACjC,8CAA8C,EAC9C,uCAAuC,EACvC,sDAAsD,EACtD,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// Export API client and typed endpoints
+export { ApiClient } from "./src/api/client";
+export { TypedAmmApi, isFlashnetError, isApiError, } from "./src/api/typed-endpoints";
+export { validatePublicKey, validateSignature, validatePositiveAmount, validateBps, validateNamespace, validateRequest, ValidationError, commonValidationRules, constantProductPoolValidationRules, } from "./src/api/validation";
+// Export configuration
+export * from "./src/config";
+export { fromSmallestUnit, generateNonce, toSmallestUnit } from "./src/utils";
+export { AuthManager } from "./src/utils/auth";
+export { createWalletSigner } from "./src/utils/signer";
+export { generateAddLiquidityIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generateConstantProductPoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRemoveLiquidityIntentMessage, generateRegisterHostIntentMessage, generateWithdrawHostFeesIntentMessage, } from "./src/utils/intents";
+// Export utilities
+export { convertSparkAddressToNetwork, decodeSparkAddress, encodeSparkAddress, getNetworkFromAddress, isValidPublicKey, isValidSparkAddress, looksLikePublicKey, } from "./src/utils/spark-address";
+// Export client
+export { FlashnetClient, } from "./src/client/FlashnetClient";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,eAAe,EACf,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kCAAkC,GAGnC,MAAM,sBAAsB,CAAC;AAE9B,uBAAuB;AACvB,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iCAAiC,EACjC,8CAA8C,EAC9C,uCAAuC,EACvC,sDAAsD,EACtD,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB;AACnB,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAEnC,gBAAgB;AAChB,OAAO,EACL,cAAc,GAIf,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { NetworkConfig } from "../config";
+import { TypedAmmApi } from "./typed-endpoints";
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: any;
+    params?: Record<string, string | number>;
+}
+export declare class ApiClient {
+    private config;
+    private authToken?;
+    readonly amm: TypedAmmApi;
+    constructor(config: NetworkConfig);
+    setAuthToken(token: string): void;
+    private makeRequest;
+    ammPost<T>(path: string, body: any, options?: RequestOptions): Promise<T>;
+    ammGet<T>(path: string, options?: RequestOptions): Promise<T>;
+    mempoolGet<T>(path: string, options?: RequestOptions): Promise<T>;
+    sparkScanGet<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,SAAgB,GAAG,EAAE,WAAW,CAAC;gBAErB,MAAM,EAAE,aAAa;IAKjC,YAAY,CAAC,KAAK,EAAE,MAAM;YAIZ,WAAW;IA0EnB,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAOP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAS7D,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IASjE,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAU1E"}

package/dist/src/api/client.js

@@ -0,0 +1,85 @@
+import { TypedAmmApi } from "./typed-endpoints";
+export class ApiClient {
+    config;
+    authToken;
+    amm;
+    constructor(config) {
+        this.config = config;
+        this.amm = new TypedAmmApi(this);
+    }
+    setAuthToken(token) {
+        this.authToken = token;
+    }
+    async makeRequest(url, method, options) {
+        const headers = {
+            "Content-Type": "application/json",
+            ...options?.headers,
+        };
+        if (this.authToken) {
+            headers.Authorization = `Bearer ${this.authToken}`;
+        }
+        const requestOptions = {
+            method,
+            headers,
+        };
+        if (options?.body && method !== "GET") {
+            requestOptions.body = JSON.stringify(options.body);
+        }
+        // Add query parameters if provided
+        let finalUrl = url;
+        if (options?.params) {
+            const params = new URLSearchParams();
+            Object.entries(options.params).forEach(([key, value]) => {
+                params.append(key, value.toString());
+            });
+            finalUrl = `${url}?${params.toString()}`;
+        }
+        const response = await fetch(finalUrl, requestOptions);
+        if (!response.ok) {
+            const errorData = (await response.json().catch(() => null));
+            // Log detailed error info for debugging
+            if (response.status === 400 || response.status === 422) {
+                console.error(`\n❌ API Error (${response.status}):`);
+                console.error("URL:", finalUrl);
+                console.error("Method:", method);
+                if (options?.body) {
+                    console.error("Request body:", JSON.stringify(options.body, null, 2));
+                }
+                if (errorData) {
+                    console.error("Error response:", JSON.stringify(errorData, null, 2));
+                }
+            }
+            // Create error with additional properties
+            const error = new Error(errorData?.message ||
+                errorData?.msg ||
+                `HTTP error! status: ${response.status}`);
+            error.status = response.status;
+            error.response = { status: response.status, data: errorData };
+            error.request = { url: finalUrl, method, body: options?.body };
+            throw error;
+        }
+        return response.json();
+    }
+    // AMM Gateway endpoints
+    async ammPost(path, body, options) {
+        return this.makeRequest(`${this.config.ammGatewayUrl}${path}`, "POST", {
+            ...options,
+            body,
+        });
+    }
+    async ammGet(path, options) {
+        return this.makeRequest(`${this.config.ammGatewayUrl}${path}`, "GET", options);
+    }
+    // Mempool API endpoints
+    async mempoolGet(path, options) {
+        return this.makeRequest(`${this.config.mempoolApiUrl}${path}`, "GET", options);
+    }
+    // SparkScan API endpoints (if available)
+    async sparkScanGet(path, options) {
+        if (!this.config.sparkScanUrl) {
+            throw new Error("SparkScan URL not configured for this network");
+        }
+        return this.makeRequest(`${this.config.sparkScanUrl}${path}`, "GET", options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/api/client.js.map

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