@flashnet/sdk 0.1.1

package/dist/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/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,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,UAAU,CAAC;AAEvC;;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/src/api/typed-endpoints.js

@@ -0,0 +1,202 @@
+import { ApiClient } from "./client";
+/**
+ * Typed API endpoints for the Flashnet AMM Gateway
+ */
+export 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
+ */
+export function isFlashnetError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        "msg" in error &&
+        typeof error.code === "number" &&
+        typeof error.msg === "string");
+}
+export function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "error" in error &&
+        typeof error.error === "object");
+}
+//# sourceMappingURL=typed-endpoints.js.map

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

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

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

package/dist/src/api/validation.js

@@ -0,0 +1,128 @@
+/**
+ * Validation helpers for API requests
+ */
+/**
+ * Validates that a public key is in the correct format
+ */
+export function validatePublicKey(publicKey) {
+    // Check if it's a valid hex string of the correct length
+    // Bitcoin/Spark public keys are typically 33 bytes (66 hex chars) for compressed
+    // or 65 bytes (130 hex chars) for uncompressed
+    const hexRegex = /^[0-9a-fA-F]+$/;
+    return (hexRegex.test(publicKey) &&
+        (publicKey.length === 66 || publicKey.length === 130));
+}
+/**
+ * Validates that a signature is in the correct format
+ */
+export function validateSignature(signature) {
+    // Check if it's a valid hex string
+    // Signatures are typically 64-72 bytes (128-144 hex chars)
+    const hexRegex = /^[0-9a-fA-F]+$/;
+    return (hexRegex.test(signature) &&
+        signature.length >= 128 &&
+        signature.length <= 144);
+}
+/**
+ * Validates that an amount is positive
+ */
+export function validatePositiveAmount(amount) {
+    const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+    return !isNaN(numAmount) && numAmount > 0;
+}
+/**
+ * Validates that a BPS value is in the valid range
+ */
+export function validateBps(bps, min = 0, max = 10000) {
+    return Number.isInteger(bps) && bps >= min && bps <= max;
+}
+/**
+ * Validates a namespace string
+ */
+export function validateNamespace(namespace) {
+    // Namespace must be between 3-32 characters
+    return (namespace.length >= 3 &&
+        namespace.length <= 32 &&
+        /^[a-zA-Z0-9-_]+$/.test(namespace));
+}
+/**
+ * Common validation errors
+ */
+export class ValidationError extends Error {
+    field;
+    reason;
+    constructor(field, reason) {
+        super(`Validation failed for ${field}: ${reason}`);
+        this.field = field;
+        this.reason = reason;
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Validates a request object against a set of rules
+ */
+export function validateRequest(request, rules) {
+    for (const [field, rule] of Object.entries(rules)) {
+        const value = request[field];
+        // Check required fields
+        if (rule.required &&
+            (value === undefined || value === null || value === "")) {
+            throw new ValidationError(String(field), "field is required");
+        }
+        // Skip validation for optional fields that are not provided
+        if (!rule.required && (value === undefined || value === null)) {
+            continue;
+        }
+        // Run custom validator if provided
+        if (rule.validator && !rule.validator(value)) {
+            throw new ValidationError(String(field), rule.message || "validation failed");
+        }
+    }
+}
+/**
+ * Pre-defined validation rules for common request types
+ */
+export const commonValidationRules = {
+    publicKey: {
+        required: true,
+        validator: validatePublicKey,
+        message: "invalid public key format",
+    },
+    signature: {
+        required: true,
+        validator: validateSignature,
+        message: "invalid signature format",
+    },
+    nonce: {
+        required: true,
+        validator: (v) => typeof v === "string" && v.length > 0,
+        message: "nonce must be a non-empty string",
+    },
+    amount: {
+        required: true,
+        validator: validatePositiveAmount,
+        message: "amount must be positive",
+    },
+    bps: {
+        required: true,
+        validator: (v) => validateBps(v),
+        message: "BPS must be between 0 and 10000",
+    },
+};
+/**
+ * Validation rules for CreateConstantProductPoolRequest
+ */
+export const constantProductPoolValidationRules = {
+    poolOwnerPublicKey: commonValidationRules.publicKey,
+    assetATokenPublicKey: commonValidationRules.publicKey,
+    assetBTokenPublicKey: commonValidationRules.publicKey,
+    lpFeeRateBps: commonValidationRules.bps,
+    integratorNamespace: {
+        required: true,
+        validator: validateNamespace,
+        message: "invalid namespace format",
+    },
+    nonce: commonValidationRules.nonce,
+    signature: commonValidationRules.signature,
+};
+//# sourceMappingURL=validation.js.map

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

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