@flashnet/sdk 0.1.1 → 0.1.2

package/dist/cjs/src/utils/spark-address.js

@@ -0,0 +1,238 @@
+'use strict';
+
+var secp256k1 = require('@noble/curves/secp256k1');
+var utils = require('@noble/hashes/utils');
+var base = require('@scure/base');
+
+const AddressNetworkPrefix = {
+    MAINNET: 'sp',
+    TESTNET: 'spt',
+    REGTEST: 'sprt',
+    SIGNET: 'sps',
+    LOCAL: 'spl',
+};
+const PrefixToNetwork = Object.fromEntries(Object.entries(AddressNetworkPrefix).map(([network, prefix]) => [
+    prefix,
+    network,
+]));
+/**
+ * Simple implementation of protobuf-style encoding for SparkAddress
+ * Field 1: identityPublicKey (bytes type)
+ */
+function encodeProto(publicKeyBytes) {
+    // Calculate the total length: tag (1 byte) + length prefix (1 byte) + key bytes
+    const length = 2 + publicKeyBytes.length;
+    const result = new Uint8Array(length);
+    // Field 1, wire type 2 (length-delimited) = tag 10 (1 << 3 | 2)
+    result[0] = 10;
+    // Length of the key bytes
+    result[1] = publicKeyBytes.length;
+    // Copy the key bytes
+    result.set(publicKeyBytes, 2);
+    return result;
+}
+/**
+ * Simple implementation of protobuf-style decoding for SparkAddress
+ */
+function decodeProto(data) {
+    let pos = 0;
+    const result = {
+        identityPublicKey: new Uint8Array(0),
+    };
+    while (pos < data.length) {
+        // Read tag
+        const tag = data[pos++];
+        // Field 1, wire type 2 (length-delimited) = tag 10
+        if (tag === 10) {
+            // Read length
+            const length = data[pos++] ?? 0;
+            // Read bytes
+            result.identityPublicKey = data.slice(pos, pos + length);
+            pos += length;
+        }
+        else {
+            // Skip unknown fields
+            // For simplicity, we only handle field 1 and assume no other fields exist
+            break;
+        }
+    }
+    // Basic validation: check if a public key was actually decoded
+    if (result.identityPublicKey.length === 0) {
+        throw new Error('Failed to decode public key from proto bytes');
+    }
+    return result;
+}
+/**
+ * Encodes a public key and network into a Spark address
+ * @param payload Object containing hex public key and network type
+ * @returns Bech32m encoded Spark address
+ */
+function encodeSparkAddress(payload) {
+    isValidPublicKey(payload.identityPublicKey);
+    // Convert hex public key to bytes
+    const publicKeyBytes = utils.hexToBytes(payload.identityPublicKey);
+    // Use proto-style encoding to match the original implementation
+    const protoEncoded = encodeProto(publicKeyBytes);
+    // Convert to bech32m words
+    const words = base.bech32m.toWords(protoEncoded);
+    // Encode with bech32m
+    const prefix = AddressNetworkPrefix[payload.network];
+    const encoded = base.bech32m.encode(prefix, words, 200);
+    return encoded;
+}
+/**
+ * Decodes a Spark address to extract the public key
+ * @param address Bech32m encoded Spark address
+ * @param network Expected network type (used to check prefix)
+ * @returns Hex-encoded public key
+ * @throws Error if address format, prefix, or decoded key is invalid
+ */
+function decodeSparkAddress(address, network) {
+    const prefix = AddressNetworkPrefix[network];
+    if (!address?.startsWith(prefix)) {
+        throw new Error(`Invalid Spark address: expected prefix ${prefix}`);
+    }
+    // Decode the bech32m address
+    const sparkAddress = address;
+    const decoded = base.bech32m.decode(sparkAddress, 200);
+    // Convert words back to bytes
+    const protoBytes = base.bech32m.fromWords(decoded.words);
+    // Decode the proto format to get the SparkAddress
+    const sparkAddressData = decodeProto(protoBytes);
+    // Convert the public key bytes back to hex
+    const publicKey = utils.bytesToHex(sparkAddressData.identityPublicKey);
+    // Validate the extracted public key
+    isValidPublicKey(publicKey);
+    return publicKey;
+}
+/**
+ * Attempts to determine the network type from a Spark address prefix.
+ * @param address The potential Spark address.
+ * @returns The NetworkType ('MAINNET', 'REGTEST', etc.) or null if the prefix is invalid.
+ */
+function getNetworkFromAddress(address) {
+    if (!address || typeof address !== 'string') {
+        return null;
+    }
+    const parts = address.split('1');
+    if (parts.length < 2) {
+        return null; // Missing separator '1'
+    }
+    const prefix = parts[0] ?? '';
+    return PrefixToNetwork[prefix] || null; // Return NetworkType or null
+}
+/**
+ * Checks if a string is a valid Spark address for *any* known network,
+ * and optionally validates against a specific network.
+ * @param address String to validate
+ * @param network Optional specific network type to check against
+ * @returns Boolean indicating validity
+ */
+function isValidSparkAddress(address, network) {
+    try {
+        if (!address?.includes('1')) {
+            return false;
+        }
+        const addressAsPossibleFormat = address;
+        const decoded = base.bech32m.decode(addressAsPossibleFormat, 200);
+        const prefix = decoded.prefix;
+        // Check if prefix is known
+        const networkFromPrefix = PrefixToNetwork[prefix];
+        if (!networkFromPrefix) {
+            return false; // Unknown prefix
+        }
+        // If a specific network is required, check if it matches
+        if (network && network !== networkFromPrefix) {
+            return false;
+        }
+        // Try to decode the payload and validate the pubkey
+        const protoBytes = base.bech32m.fromWords(decoded.words);
+        const sparkAddressData = decodeProto(protoBytes);
+        const publicKey = utils.bytesToHex(sparkAddressData.identityPublicKey);
+        isValidPublicKey(publicKey); // Throws on invalid key
+        return true; // All checks passed
+    }
+    catch (_error) {
+        return false;
+    }
+}
+/**
+ * Checks if a string looks like a valid hex-encoded public key (basic check).
+ * Does NOT validate point on curve here, use isValidPublicKey for that.
+ * @param key The potential public key hex string.
+ * @returns True if it matches the basic format, false otherwise.
+ */
+function looksLikePublicKey(key) {
+    if (!key || typeof key !== 'string') {
+        return false;
+    }
+    return key.length === 66 && /^(02|03)[0-9a-fA-F]{64}$/.test(key);
+}
+/**
+ * Validates a secp256k1 public key format and curve point.
+ * @param publicKey Hex-encoded public key
+ * @throws Error if public key is invalid
+ */
+function isValidPublicKey(publicKey) {
+    if (!looksLikePublicKey(publicKey)) {
+        throw new Error('Invalid public key format/length.');
+    }
+    try {
+        const point = secp256k1.secp256k1.ProjectivePoint.fromHex(publicKey);
+        point.assertValidity();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Invalid public key point: ${errorMessage}`);
+    }
+}
+/**
+ * Converts a Spark address to a specific network.
+ * If the address is already on the requested network, it returns the original address.
+ * Otherwise, it extracts the public key and creates a new address for the target network.
+ *
+ * @param sparkAddress The Spark address to convert
+ * @param targetNetwork The target network ('mainnet' or 'regtest')
+ * @returns The Spark address for the target network or null if conversion fails
+ */
+function convertSparkAddressToNetwork(sparkAddress, targetNetwork) {
+    try {
+        // Check if the address is valid
+        if (!isValidSparkAddress(sparkAddress)) {
+            return null;
+        }
+        // Extract the current network from the address
+        const currentNetworkType = getNetworkFromAddress(sparkAddress);
+        if (!currentNetworkType) {
+            return null;
+        }
+        // Map the input string to NetworkType
+        const targetNetworkType = targetNetwork === 'mainnet' ? 'MAINNET' : 'REGTEST';
+        // If already on the target network, return the original address
+        if (currentNetworkType === targetNetworkType) {
+            return sparkAddress;
+        }
+        // Extract the public key from the address
+        const decoded = base.bech32m.decode(sparkAddress, 200);
+        const protoBytes = base.bech32m.fromWords(decoded.words);
+        const sparkAddressData = decodeProto(protoBytes);
+        const publicKey = utils.bytesToHex(sparkAddressData.identityPublicKey);
+        // Create a new address for the target network
+        return encodeSparkAddress({
+            identityPublicKey: publicKey,
+            network: targetNetworkType,
+        });
+    }
+    catch (_error) {
+        return null;
+    }
+}
+
+exports.convertSparkAddressToNetwork = convertSparkAddressToNetwork;
+exports.decodeSparkAddress = decodeSparkAddress;
+exports.encodeSparkAddress = encodeSparkAddress;
+exports.getNetworkFromAddress = getNetworkFromAddress;
+exports.isValidPublicKey = isValidPublicKey;
+exports.isValidSparkAddress = isValidSparkAddress;
+exports.looksLikePublicKey = looksLikePublicKey;
+//# sourceMappingURL=spark-address.js.map

package/dist/cjs/src/utils/spark-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spark-address.js","sources":["../../../../../../src/utils/spark-address.ts"],"sourcesContent":[null],"names":["hexToBytes","bech32m","bytesToHex","secp256k1"],"mappings":"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"}

package/dist/{index.js → esm/index.d.ts}

@@ -1,15 +1,13 @@
-// Export API client and typed endpoints
+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, } from "./src/api/validation";
-// Export configuration
+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 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
+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/esm/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/esm/index.js

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

package/dist/esm/index.js.map

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

package/dist/esm/package.json

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

package/dist/esm/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/esm/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 → esm/src}/api/client.js

@@ -1,5 +1,6 @@
-import { TypedAmmApi } from "./typed-endpoints";
-export class ApiClient {
+import { TypedAmmApi } from './typed-endpoints.js';
+
+class ApiClient {
     config;
     authToken;
     amm;
@@ -82,4 +83,6 @@ export class ApiClient {
         return this.makeRequest(`${this.config.sparkScanUrl}${path}`, "GET", options);
     }
 }
-//# sourceMappingURL=client.js.map
+
+export { ApiClient };
+//# sourceMappingURL=client.js.map

package/dist/esm/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/esm/src/api/typed-endpoints.d.ts

@@ -0,0 +1,135 @@
+import { ApiClient } from "./client";
+import type * as Types from "../types";
+/**
+ * Typed API endpoints for the Flashnet AMM Gateway
+ */
+export declare class TypedAmmApi {
+    private client;
+    constructor(client: ApiClient);
+    /**
+     * Request authentication challenge
+     * @POST /v1/auth/challenge
+     */
+    getChallenge(request: Types.ChallengeRequest): Promise<Types.ChallengeResponse>;
+    /**
+     * Verify challenge and get access token
+     * @POST /v1/auth/verify
+     */
+    verify(request: Types.VerifyRequest): Promise<Types.VerifyResponse>;
+    /**
+     * Register a new host
+     * @POST /v1/hosts/register
+     * @requires Bearer token
+     */
+    registerHost(request: Types.RegisterHostRequest): Promise<Types.RegisterHostResponse>;
+    /**
+     * Get host information
+     * @GET /v1/hosts/{namespace}
+     */
+    getHost(namespace: string): Promise<Types.GetHostResponse>;
+    /**
+     * Withdraw host fees
+     * @POST /v1/hosts/withdraw-fees
+     * @requires Bearer token
+     */
+    withdrawHostFees(request: Types.WithdrawHostFeesRequest): Promise<Types.WithdrawHostFeesResponse>;
+    /**
+     * Get pool host fees
+     * @POST /v1/hosts/pool-fees
+     * @requires Bearer token
+     */
+    getPoolHostFees(request: Types.GetPoolHostFeesRequest): Promise<Types.GetPoolHostFeesResponse>;
+    /**
+     * Create constant product pool
+     * @POST /v1/pools/constant-product
+     * @requires Bearer token
+     */
+    createConstantProductPool(request: Types.CreateConstantProductPoolRequest): Promise<Types.CreatePoolResponse>;
+    /**
+     * Create single-sided pool
+     * @POST /v1/pools/single-sided
+     * @requires Bearer token
+     */
+    createSingleSidedPool(request: Types.CreateSingleSidedPoolRequest): Promise<Types.CreatePoolResponse>;
+    /**
+     * Confirm initial deposit for single-sided pool
+     * @POST /v1/pools/single-sided/confirm-initial-deposit
+     * @requires Bearer token
+     */
+    confirmInitialDeposit(request: Types.ConfirmInitialDepositRequest): Promise<Types.ConfirmDepositResponse>;
+    /**
+     * List pools with filters
+     * @GET /v1/pools
+     */
+    listPools(query?: Types.ListPoolsQuery): Promise<Types.ListPoolsResponse>;
+    /**
+     * Get pool details
+     * @GET /v1/pools/{poolId}
+     */
+    getPool(poolId: string): Promise<Types.PoolDetailsResponse>;
+    /**
+     * Get LP position details
+     * @GET /v1/pools/{poolId}/lp/{providerPublicKey}
+     * @requires Bearer token
+     */
+    getLpPosition(poolId: string, providerPublicKey: string): Promise<Types.LpPositionDetailsResponse>;
+    /**
+     * Add liquidity to pool
+     * @POST /v1/liquidity/add
+     * @requires Bearer token
+     */
+    addLiquidity(request: Types.AddLiquidityRequest): Promise<Types.AddLiquidityResponse>;
+    /**
+     * Simulate adding liquidity
+     * @POST /v1/liquidity/add/simulate
+     */
+    simulateAddLiquidity(request: Types.SimulateAddLiquidityRequest): Promise<Types.SimulateAddLiquidityResponse>;
+    /**
+     * Remove liquidity from pool
+     * @POST /v1/liquidity/remove
+     * @requires Bearer token
+     */
+    removeLiquidity(request: Types.RemoveLiquidityRequest): Promise<Types.RemoveLiquidityResponse>;
+    /**
+     * Simulate removing liquidity
+     * @POST /v1/liquidity/remove/simulate
+     */
+    simulateRemoveLiquidity(request: Types.SimulateRemoveLiquidityRequest): Promise<Types.SimulateRemoveLiquidityResponse>;
+    /**
+     * Execute swap
+     * @POST /v1/swap
+     * @requires Bearer token
+     */
+    executeSwap(request: Types.ExecuteSwapRequest): Promise<Types.SwapResponse>;
+    /**
+     * Simulate swap
+     * @POST /v1/swap/simulate
+     */
+    simulateSwap(request: Types.SimulateSwapRequest): Promise<Types.SimulateSwapResponse>;
+    /**
+     * Get swaps for a pool
+     * @GET /v1/pools/{lpPubkey}/swaps
+     */
+    getPoolSwaps(lpPubkey: string, query?: Types.ListPoolSwapsQuery): Promise<Types.ListPoolSwapsResponse>;
+    /**
+     * Get global swaps
+     * @GET /v1/swaps
+     */
+    getGlobalSwaps(query?: Types.ListGlobalSwapsQuery): Promise<Types.ListGlobalSwapsResponse>;
+    /**
+     * Get user swaps
+     * @GET /v1/swaps/user/{userPublicKey}
+     */
+    getUserSwaps(userPublicKey: string, query?: Types.ListUserSwapsQuery): Promise<Types.ListUserSwapsResponse>;
+    /**
+     * Ping settlement service
+     * @GET /v1/ping
+     */
+    ping(): Promise<Types.SettlementPingResponse>;
+}
+/**
+ * Error checking utilities
+ */
+export declare function isFlashnetError(error: unknown): error is Types.FlashnetErrorResponse;
+export declare function isApiError(error: unknown): error is Types.ApiErrorResponse;
+//# sourceMappingURL=typed-endpoints.d.ts.map

package/dist/esm/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":"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"}

package/dist/{src → esm/src}/api/typed-endpoints.js

@@ -1,8 +1,7 @@
-import { ApiClient } from "./client";
 /**
  * Typed API endpoints for the Flashnet AMM Gateway
  */
-export class TypedAmmApi {
+class TypedAmmApi {
     client;
     constructor(client) {
         this.client = client;
@@ -185,7 +184,7 @@ export class TypedAmmApi {
 /**
  * Error checking utilities
  */
-export function isFlashnetError(error) {
+function isFlashnetError(error) {
     return (typeof error === "object" &&
         error !== null &&
         "code" in error &&
@@ -193,10 +192,12 @@ export function isFlashnetError(error) {
         typeof error.code === "number" &&
         typeof error.msg === "string");
 }
-export function isApiError(error) {
+function isApiError(error) {
     return (typeof error === "object" &&
         error !== null &&
         "error" in error &&
         typeof error.error === "object");
 }
-//# sourceMappingURL=typed-endpoints.js.map
+
+export { TypedAmmApi, isApiError, isFlashnetError };
+//# sourceMappingURL=typed-endpoints.js.map

package/dist/esm/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/esm/src/api/validation.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Validation helpers for API requests
+ */
+/**
+ * Validates that a public key is in the correct format
+ */
+export declare function validatePublicKey(publicKey: string): boolean;
+/**
+ * Validates that a signature is in the correct format
+ */
+export declare function validateSignature(signature: string): boolean;
+/**
+ * Validates that an amount is positive
+ */
+export declare function validatePositiveAmount(amount: number | string): boolean;
+/**
+ * Validates that a BPS value is in the valid range
+ */
+export declare function validateBps(bps: number, min?: number, max?: number): boolean;
+/**
+ * Validates a namespace string
+ */
+export declare function validateNamespace(namespace: string): boolean;
+/**
+ * Common validation errors
+ */
+export declare class ValidationError extends Error {
+    field: string;
+    reason: string;
+    constructor(field: string, reason: string);
+}
+/**
+ * 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 interface ValidationRule {
+    required?: boolean;
+    validator?: (value: any) => boolean;
+    message?: string;
+}
+export type ValidationRules<T> = {
+    [K in keyof T]?: ValidationRule;
+};
+/**
+ * Pre-defined validation rules for common request types
+ */
+export declare const commonValidationRules: {
+    publicKey: {
+        required: boolean;
+        validator: typeof validatePublicKey;
+        message: string;
+    };
+    signature: {
+        required: boolean;
+        validator: typeof validateSignature;
+        message: string;
+    };
+    nonce: {
+        required: boolean;
+        validator: (v: any) => boolean;
+        message: string;
+    };
+    amount: {
+        required: boolean;
+        validator: typeof validatePositiveAmount;
+        message: string;
+    };
+    bps: {
+        required: boolean;
+        validator: (v: any) => boolean;
+        message: string;
+    };
+};
+/**
+ * Validation rules for CreateConstantProductPoolRequest
+ */
+export declare const constantProductPoolValidationRules: {
+    poolOwnerPublicKey: {
+        required: boolean;
+        validator: typeof validatePublicKey;
+        message: string;
+    };
+    assetATokenPublicKey: {
+        required: boolean;
+        validator: typeof validatePublicKey;
+        message: string;
+    };
+    assetBTokenPublicKey: {
+        required: boolean;
+        validator: typeof validatePublicKey;
+        message: string;
+    };
+    lpFeeRateBps: {
+        required: boolean;
+        validator: (v: any) => boolean;
+        message: string;
+    };
+    integratorNamespace: {
+        required: boolean;
+        validator: typeof validateNamespace;
+        message: string;
+    };
+    nonce: {
+        required: boolean;
+        validator: (v: any) => boolean;
+        message: string;
+    };
+    signature: {
+        required: boolean;
+        validator: typeof validateSignature;
+        message: string;
+    };
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/esm/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;IACrB,KAAK,EAAE,MAAM;IAAS,MAAM,EAAE,MAAM;gBAApC,KAAK,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM;CAIxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,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,GAAG,KAAK,OAAO,CAAC;IACpC,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,GAAG;;;;;;;;;;uBAUH,GAAG;;;CAGrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;uBAR5B,GAAG;;;;;;;;;;uBAVH,GAAG;;;;;;;;CA8BrB,CAAC"}