@flashnet/sdk 0.1.1 → 0.2.0

package/README.md

@@ -1,13 +1,13 @@
 # Flashnet SDK
 
-A comprehensive SDK for interacting with Flashnet's Spark wallet and AMM (Automated Market Maker) functionality.
+A comprehensive SDK for interacting with Flashnet's Spark AMM 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
+- **Intent-Based Signing** - Transaction signing via intent
 - **Custom Signers** - Support for arbitrary signing implementations (hardware wallets, remote signers, etc.)
 - **TypeScript First** - Full type safety and IntelliSense support
 
@@ -21,6 +21,44 @@ npm install @flashnet/sdk
 yarn add @flashnet/sdk
 ```
 
+### Optional Dependencies
+
+The `@buildonspark/spark-sdk` and `@buildonspark/issuer-sdk` are now **optional peer dependencies**. You only need to install them if you're using the full `FlashnetClient` with wallet integration:
+
+```bash
+# For full wallet integration (frontend)
+bun i @flashnet/sdk @buildonspark/spark-sdk @buildonspark/issuer-sdk
+
+# For backend/lightweight usage (no wallet)
+bun i @flashnet/sdk
+```
+
+## 🆕 Modular Imports
+
+The SDK now supports modular imports for better tree-shaking and smaller bundle sizes:
+
+```typescript
+// Import only what you need - no wallet dependencies required
+import { AuthManager } from "@flashnet/sdk/auth";
+import { ApiClient } from "@flashnet/sdk/api";
+import { encodeSparkAddress } from "@flashnet/sdk/utils";
+import type { Signer } from "@flashnet/sdk/types";
+
+// Full SDK (requires wallet dependencies)
+import { FlashnetClient } from "@flashnet/sdk";
+```
+
+Available exports:
+
+- `@flashnet/sdk/auth` - Authentication utilities
+- `@flashnet/sdk/api` - API client and typed endpoints
+- `@flashnet/sdk/utils` - Utility functions (addresses, intents, etc.)
+- `@flashnet/sdk/types` - TypeScript types
+- `@flashnet/sdk/config` - Network configurations
+- `@flashnet/sdk/client` - FlashnetClient (requires wallet)
+
+For detailed modular usage examples, see [docs/modular-usage.md](docs/modular-usage.md).
+
 ## Usage Options
 
 The Flashnet SDK offers two approaches to suit different needs:
@@ -148,6 +186,7 @@ const swap = await client.executeSwap({
 import {
   ApiClient,
   AuthManager,
+  TypedAmmApi,
   getNetworkConfig,
   encodeSparkAddress,
   generatePoolSwapIntentMessage,
@@ -158,7 +197,7 @@ import {
 // Setup
 const config = getNetworkConfig("MAINNET");
 const apiClient = new ApiClient(config);
-const api = apiClient.amm; // Typed API endpoints
+const api = new TypedAmmApi(apiClient); // Create typed API wrapper
 
 // Authenticate with wallet
 const signer = createWalletSigner(wallet);
@@ -302,6 +341,8 @@ await client.addLiquidity({
   assetBAmount: 5000n,
 });
 
+await client.getLpPosition("pool-id");
+
 // Remove liquidity
 await client.removeLiquidity({
   poolId: "pool-id",
@@ -347,7 +388,8 @@ const pools = await client.ammGet("/v1/pools");
 const swapResult = await client.ammPost("/v1/swap", swapData);
 
 // Typed API wrapper
-const api = client.amm;
+import { TypedAmmApi } from "@flashnet/sdk";
+const api = new TypedAmmApi(client);
 const pools = await api.listPools({ limit: 10 });
 ```
 

package/dist/{index.d.ts → cjs/index.d.ts}

@@ -1,13 +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 { isApiError, isFlashnetError, TypedAmmApi, } from "./src/api/typed-endpoints";
+export { commonValidationRules, constantProductPoolValidationRules, ValidationError, type ValidationRule, type ValidationRules, validateBps, validateNamespace, validatePositiveAmount, validatePublicKey, validateRequest, validateSignature, } from "./src/api/validation";
+export { FlashnetClient, type FlashnetClientOptions, type TokenBalance, type WalletBalance, } from "./src/client/FlashnetClient";
 export * from "./src/config";
+export type * from "./src/types";
 export { fromSmallestUnit, generateNonce, toSmallestUnit } from "./src/utils";
 export { AuthManager } from "./src/utils/auth";
+export { generateAddLiquidityIntentMessage, generateConstantProductPoolInitializationIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRegisterHostIntentMessage, generateRemoveLiquidityIntentMessage, generateWithdrawHostFeesIntentMessage, } from "./src/utils/intents";
 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/cjs/index.d.ts.map

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

package/dist/cjs/index.js

@@ -0,0 +1,56 @@
+'use strict';
+
+var client = require('./src/api/client.js');
+var typedEndpoints = require('./src/api/typed-endpoints.js');
+var validation = require('./src/api/validation.js');
+var FlashnetClient = require('./src/client/FlashnetClient.js');
+var index$1 = require('./src/config/index.js');
+var index = require('./src/utils/index.js');
+var auth = require('./src/utils/auth.js');
+var intents = require('./src/utils/intents.js');
+var signer = require('./src/utils/signer.js');
+var sparkAddress = require('./src/utils/spark-address.js');
+
+
+
+exports.ApiClient = client.ApiClient;
+exports.TypedAmmApi = typedEndpoints.TypedAmmApi;
+exports.isApiError = typedEndpoints.isApiError;
+exports.isFlashnetError = typedEndpoints.isFlashnetError;
+exports.ValidationError = validation.ValidationError;
+exports.commonValidationRules = validation.commonValidationRules;
+exports.constantProductPoolValidationRules = validation.constantProductPoolValidationRules;
+exports.validateBps = validation.validateBps;
+exports.validateNamespace = validation.validateNamespace;
+exports.validatePositiveAmount = validation.validatePositiveAmount;
+exports.validatePublicKey = validation.validatePublicKey;
+exports.validateRequest = validation.validateRequest;
+exports.validateSignature = validation.validateSignature;
+exports.FlashnetClient = FlashnetClient.FlashnetClient;
+exports.BTC_ASSET_PUBKEY = index$1.BTC_ASSET_PUBKEY;
+exports.BTC_DECIMALS = index$1.BTC_DECIMALS;
+exports.DEFAULT_HOST_NAMESPACE = index$1.DEFAULT_HOST_NAMESPACE;
+exports.DEFAULT_SLIPPAGE_BPS = index$1.DEFAULT_SLIPPAGE_BPS;
+exports.NETWORK_CONFIGS = index$1.NETWORK_CONFIGS;
+exports.getNetworkConfig = index$1.getNetworkConfig;
+exports.fromSmallestUnit = index.fromSmallestUnit;
+exports.generateNonce = index.generateNonce;
+exports.toSmallestUnit = index.toSmallestUnit;
+exports.AuthManager = auth.AuthManager;
+exports.generateAddLiquidityIntentMessage = intents.generateAddLiquidityIntentMessage;
+exports.generateConstantProductPoolInitializationIntentMessage = intents.generateConstantProductPoolInitializationIntentMessage;
+exports.generatePoolConfirmInitialDepositIntentMessage = intents.generatePoolConfirmInitialDepositIntentMessage;
+exports.generatePoolInitializationIntentMessage = intents.generatePoolInitializationIntentMessage;
+exports.generatePoolSwapIntentMessage = intents.generatePoolSwapIntentMessage;
+exports.generateRegisterHostIntentMessage = intents.generateRegisterHostIntentMessage;
+exports.generateRemoveLiquidityIntentMessage = intents.generateRemoveLiquidityIntentMessage;
+exports.generateWithdrawHostFeesIntentMessage = intents.generateWithdrawHostFeesIntentMessage;
+exports.createWalletSigner = signer.createWalletSigner;
+exports.convertSparkAddressToNetwork = sparkAddress.convertSparkAddressToNetwork;
+exports.decodeSparkAddress = sparkAddress.decodeSparkAddress;
+exports.encodeSparkAddress = sparkAddress.encodeSparkAddress;
+exports.getNetworkFromAddress = sparkAddress.getNetworkFromAddress;
+exports.isValidPublicKey = sparkAddress.isValidPublicKey;
+exports.isValidSparkAddress = sparkAddress.isValidSparkAddress;
+exports.looksLikePublicKey = sparkAddress.looksLikePublicKey;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/{src → cjs/src}/api/client.d.ts

@@ -1,5 +1,4 @@
 import type { NetworkConfig } from "../config";
-import { TypedAmmApi } from "./typed-endpoints";
 export interface RequestOptions {
     headers?: Record<string, string>;
     body?: any;
@@ -8,7 +7,6 @@ export interface RequestOptions {
 export declare class ApiClient {
     private config;
     private authToken?;
-    readonly amm: TypedAmmApi;
     constructor(config: NetworkConfig);
     setAuthToken(token: string): void;
     private makeRequest;

package/dist/cjs/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;AAE/C,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;gBAEf,MAAM,EAAE,aAAa;IAIjC,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 → cjs/src}/api/client.js

@@ -1,11 +1,10 @@
-import { TypedAmmApi } from "./typed-endpoints";
-export class ApiClient {
+'use strict';
+
+class ApiClient {
     config;
     authToken;
-    amm;
     constructor(config) {
         this.config = config;
-        this.amm = new TypedAmmApi(this);
     }
     setAuthToken(token) {
         this.authToken = token;
@@ -82,4 +81,6 @@ export class ApiClient {
         return this.makeRequest(`${this.config.sparkScanUrl}${path}`, "GET", options);
     }
 }
-//# sourceMappingURL=client.js.map
+
+exports.ApiClient = ApiClient;
+//# sourceMappingURL=client.js.map

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

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

package/dist/cjs/src/api/index.d.ts

@@ -0,0 +1,4 @@
+export type { RequestOptions } from "./client";
+export { ApiClient } from "./client";
+export { isApiError, isFlashnetError, TypedAmmApi } from "./typed-endpoints";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/{src → cjs/src}/api/typed-endpoints.d.ts

@@ -1,5 +1,5 @@
-import { ApiClient } from "./client";
 import type * as Types from "../types";
+import type { ApiClient } from "./client";
 /**
  * Typed API endpoints for the Flashnet AMM Gateway
  */

package/dist/cjs/src/api/typed-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-endpoints.d.ts","sourceRoot":"","sources":["../../../../src/api/typed-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAIrC;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAC9B,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAOnC;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;IASzE;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,KAAK,CAAC,mBAAmB,GACjC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAOtC;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;IAIhE;;;;OAIG;IACG,gBAAgB,CACpB,OAAO,EAAE,KAAK,CAAC,uBAAuB,GACrC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAO1C;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,KAAK,CAAC,sBAAsB,GACpC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC;IASzC;;;;OAIG;IACG,yBAAyB,CAC7B,OAAO,EAAE,KAAK,CAAC,gCAAgC,GAC9C,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAOpC;;;;OAIG;IACG,qBAAqB,CACzB,OAAO,EAAE,KAAK,CAAC,4BAA4B,GAC1C,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAOpC;;;;OAIG;IACG,qBAAqB,CACzB,OAAO,EAAE,KAAK,CAAC,4BAA4B,GAC1C,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAOxC;;;OAGG;IACG,SAAS,CACb,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,GAC3B,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAMnC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAIjE;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC;IAQ3C;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,KAAK,CAAC,mBAAmB,GACjC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAOtC;;;OAGG;IACG,oBAAoB,CACxB,OAAO,EAAE,KAAK,CAAC,2BAA2B,GACzC,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC;IAO9C;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,KAAK,CAAC,sBAAsB,GACpC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAOzC;;;OAGG;IACG,uBAAuB,CAC3B,OAAO,EAAE,KAAK,CAAC,8BAA8B,GAC5C,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC;IASjD;;;;OAIG;IACG,WAAW,CACf,OAAO,EAAE,KAAK,CAAC,kBAAkB,GAChC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAI9B;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,KAAK,CAAC,mBAAmB,GACjC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAOtC;;;OAGG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,CAAC,kBAAkB,GAC/B,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAOvC;;;OAGG;IACG,cAAc,CAClB,KAAK,CAAC,EAAE,KAAK,CAAC,oBAAoB,GACjC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAMzC;;;OAGG;IACG,YAAY,CAChB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,KAAK,CAAC,kBAAkB,GAC/B,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC;IASvC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;CAGpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,KAAK,CAAC,qBAAqB,CAStC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,gBAAgB,CAO1E"}

package/dist/cjs/src/api/typed-endpoints.js

@@ -0,0 +1,207 @@
+'use strict';
+
+/**
+ * Typed API endpoints for the Flashnet AMM Gateway
+ */
+class TypedAmmApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    // ===== Authentication Endpoints =====
+    /**
+     * Request authentication challenge
+     * @POST /v1/auth/challenge
+     */
+    async getChallenge(request) {
+        return this.client.ammPost("/v1/auth/challenge", request);
+    }
+    /**
+     * Verify challenge and get access token
+     * @POST /v1/auth/verify
+     */
+    async verify(request) {
+        return this.client.ammPost("/v1/auth/verify", request);
+    }
+    // ===== Host Endpoints =====
+    /**
+     * Register a new host
+     * @POST /v1/hosts/register
+     * @requires Bearer token
+     */
+    async registerHost(request) {
+        return this.client.ammPost("/v1/hosts/register", request);
+    }
+    /**
+     * Get host information
+     * @GET /v1/hosts/{namespace}
+     */
+    async getHost(namespace) {
+        return this.client.ammGet(`/v1/hosts/${namespace}`);
+    }
+    /**
+     * Withdraw host fees
+     * @POST /v1/hosts/withdraw-fees
+     * @requires Bearer token
+     */
+    async withdrawHostFees(request) {
+        return this.client.ammPost("/v1/hosts/withdraw-fees", request);
+    }
+    /**
+     * Get pool host fees
+     * @POST /v1/hosts/pool-fees
+     * @requires Bearer token
+     */
+    async getPoolHostFees(request) {
+        return this.client.ammPost("/v1/hosts/pool-fees", request);
+    }
+    // ===== Pool Endpoints =====
+    /**
+     * Create constant product pool
+     * @POST /v1/pools/constant-product
+     * @requires Bearer token
+     */
+    async createConstantProductPool(request) {
+        return this.client.ammPost("/v1/pools/constant-product", request);
+    }
+    /**
+     * Create single-sided pool
+     * @POST /v1/pools/single-sided
+     * @requires Bearer token
+     */
+    async createSingleSidedPool(request) {
+        return this.client.ammPost("/v1/pools/single-sided", request);
+    }
+    /**
+     * Confirm initial deposit for single-sided pool
+     * @POST /v1/pools/single-sided/confirm-initial-deposit
+     * @requires Bearer token
+     */
+    async confirmInitialDeposit(request) {
+        return this.client.ammPost("/v1/pools/single-sided/confirm-initial-deposit", request);
+    }
+    /**
+     * List pools with filters
+     * @GET /v1/pools
+     */
+    async listPools(query) {
+        return this.client.ammGet("/v1/pools", {
+            params: query,
+        });
+    }
+    /**
+     * Get pool details
+     * @GET /v1/pools/{poolId}
+     */
+    async getPool(poolId) {
+        return this.client.ammGet(`/v1/pools/${poolId}`);
+    }
+    /**
+     * Get LP position details
+     * @GET /v1/pools/{poolId}/lp/{providerPublicKey}
+     * @requires Bearer token
+     */
+    async getLpPosition(poolId, providerPublicKey) {
+        return this.client.ammGet(`/v1/pools/${poolId}/lp/${providerPublicKey}`);
+    }
+    // ===== Liquidity Endpoints =====
+    /**
+     * Add liquidity to pool
+     * @POST /v1/liquidity/add
+     * @requires Bearer token
+     */
+    async addLiquidity(request) {
+        return this.client.ammPost("/v1/liquidity/add", request);
+    }
+    /**
+     * Simulate adding liquidity
+     * @POST /v1/liquidity/add/simulate
+     */
+    async simulateAddLiquidity(request) {
+        return this.client.ammPost("/v1/liquidity/add/simulate", request);
+    }
+    /**
+     * Remove liquidity from pool
+     * @POST /v1/liquidity/remove
+     * @requires Bearer token
+     */
+    async removeLiquidity(request) {
+        return this.client.ammPost("/v1/liquidity/remove", request);
+    }
+    /**
+     * Simulate removing liquidity
+     * @POST /v1/liquidity/remove/simulate
+     */
+    async simulateRemoveLiquidity(request) {
+        return this.client.ammPost("/v1/liquidity/remove/simulate", request);
+    }
+    // ===== Swap Endpoints =====
+    /**
+     * Execute swap
+     * @POST /v1/swap
+     * @requires Bearer token
+     */
+    async executeSwap(request) {
+        return this.client.ammPost("/v1/swap", request);
+    }
+    /**
+     * Simulate swap
+     * @POST /v1/swap/simulate
+     */
+    async simulateSwap(request) {
+        return this.client.ammPost("/v1/swap/simulate", request);
+    }
+    /**
+     * Get swaps for a pool
+     * @GET /v1/pools/{lpPubkey}/swaps
+     */
+    async getPoolSwaps(lpPubkey, query) {
+        return this.client.ammGet(`/v1/pools/${lpPubkey}/swaps`, { params: query });
+    }
+    /**
+     * Get global swaps
+     * @GET /v1/swaps
+     */
+    async getGlobalSwaps(query) {
+        return this.client.ammGet("/v1/swaps", {
+            params: query,
+        });
+    }
+    /**
+     * Get user swaps
+     * @GET /v1/swaps/user/{userPublicKey}
+     */
+    async getUserSwaps(userPublicKey, query) {
+        return this.client.ammGet(`/v1/swaps/user/${userPublicKey}`, { params: query });
+    }
+    // ===== Status Endpoints =====
+    /**
+     * Ping settlement service
+     * @GET /v1/ping
+     */
+    async ping() {
+        return this.client.ammGet("/v1/ping");
+    }
+}
+/**
+ * Error checking utilities
+ */
+function isFlashnetError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        "msg" in error &&
+        typeof error.code === "number" &&
+        typeof error.msg === "string");
+}
+function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "error" in error &&
+        typeof error.error === "object");
+}
+
+exports.TypedAmmApi = TypedAmmApi;
+exports.isApiError = isApiError;
+exports.isFlashnetError = isFlashnetError;
+//# sourceMappingURL=typed-endpoints.js.map

package/dist/cjs/src/api/typed-endpoints.js.map

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

package/dist/{src → cjs/src}/api/validation.d.ts

@@ -32,10 +32,10 @@ export declare class ValidationError extends Error {
 /**
  * Validates a request object against a set of rules
  */
-export declare function validateRequest<T extends Record<string, any>>(request: T, rules: ValidationRules<T>): void;
+export declare function validateRequest<T extends Record<string, unknown>>(request: T, rules: ValidationRules<T>): void;
 export interface ValidationRule {
     required?: boolean;
-    validator?: (value: any) => boolean;
+    validator?: (value: unknown) => boolean;
     message?: string;
 }
 export type ValidationRules<T> = {
@@ -57,7 +57,7 @@ export declare const commonValidationRules: {
     };
     nonce: {
         required: boolean;
-        validator: (v: any) => boolean;
+        validator: (v: unknown) => boolean;
         message: string;
     };
     amount: {
@@ -67,7 +67,7 @@ export declare const commonValidationRules: {
     };
     bps: {
         required: boolean;
-        validator: (v: any) => boolean;
+        validator: (v: unknown) => boolean;
         message: string;
     };
 };
@@ -92,7 +92,7 @@ export declare const constantProductPoolValidationRules: {
     };
     lpFeeRateBps: {
         required: boolean;
-        validator: (v: any) => boolean;
+        validator: (v: unknown) => boolean;
         message: string;
     };
     integratorNamespace: {
@@ -102,7 +102,7 @@ export declare const constantProductPoolValidationRules: {
     };
     nonce: {
         required: boolean;
-        validator: (v: any) => boolean;
+        validator: (v: unknown) => boolean;
         message: string;
     };
     signature: {

package/dist/cjs/src/api/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/api/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAU,EACf,GAAG,GAAE,MAAc,GAClB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;gBADd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;CAKxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACxB,IAAI,CA4BN;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc;CAChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;uBAaf,OAAO;;;;;;;;;;uBAUP,OAAO;;;CAGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;uBAR5B,OAAO;;;;;;;;;;uBAVP,OAAO;;;;;;;;CA8BzB,CAAC"}