@flashnet/sdk 0.1.1 → 0.2.0

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

@@ -0,0 +1,140 @@
+'use strict';
+
+/**
+ * Validation helpers for API requests
+ */
+/**
+ * Validates that a public key is in the correct format
+ */
+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
+ */
+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
+ */
+function validatePositiveAmount(amount) {
+    const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+    return !Number.isNaN(numAmount) && numAmount > 0;
+}
+/**
+ * Validates that a BPS value is in the valid range
+ */
+function validateBps(bps, min = 0, max = 10000) {
+    return Number.isInteger(bps) && bps >= min && bps <= max;
+}
+/**
+ * Validates a namespace string
+ */
+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
+ */
+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
+ */
+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
+ */
+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) => typeof v === "number" && validateBps(v),
+        message: "BPS must be between 0 and 10000",
+    },
+};
+/**
+ * Validation rules for CreateConstantProductPoolRequest
+ */
+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,
+};
+
+exports.ValidationError = ValidationError;
+exports.commonValidationRules = commonValidationRules;
+exports.constantProductPoolValidationRules = constantProductPoolValidationRules;
+exports.validateBps = validateBps;
+exports.validateNamespace = validateNamespace;
+exports.validatePositiveAmount = validatePositiveAmount;
+exports.validatePublicKey = validatePublicKey;
+exports.validateRequest = validateRequest;
+exports.validateSignature = validateSignature;
+//# sourceMappingURL=validation.js.map

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

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

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

@@ -1,6 +1,6 @@
 import type { IssuerSparkWallet } from "@buildonspark/issuer-sdk";
 import type { SparkWallet } from "@buildonspark/spark-sdk";
-import type { NetworkType, ListPoolsQuery, ListPoolsResponse, PoolDetailsResponse, LpPositionDetailsResponse, SimulateSwapRequest, SimulateSwapResponse, SwapResponse, SimulateAddLiquidityRequest, SimulateAddLiquidityResponse, AddLiquidityResponse, SimulateRemoveLiquidityRequest, SimulateRemoveLiquidityResponse, RemoveLiquidityResponse, CreatePoolResponse, ConfirmDepositResponse, RegisterHostResponse, GetHostResponse, WithdrawHostFeesResponse, GetPoolHostFeesResponse, ListPoolSwapsQuery, ListPoolSwapsResponse, ListGlobalSwapsQuery, ListGlobalSwapsResponse, ListUserSwapsQuery, ListUserSwapsResponse, SettlementPingResponse } from "../types";
+import { type AddLiquidityResponse, type ConfirmDepositResponse, type CreatePoolResponse, type GetHostResponse, type GetPoolHostFeesResponse, type ListGlobalSwapsQuery, type ListGlobalSwapsResponse, type ListPoolSwapsQuery, type ListPoolSwapsResponse, type ListPoolsQuery, type ListPoolsResponse, type ListUserSwapsQuery, type ListUserSwapsResponse, type LpPositionDetailsResponse, type NetworkType, type PoolDetailsResponse, type RegisterHostResponse, type RemoveLiquidityResponse, type SettlementPingResponse, type SimulateAddLiquidityRequest, type SimulateAddLiquidityResponse, type SimulateRemoveLiquidityRequest, type SimulateRemoveLiquidityResponse, type SimulateSwapRequest, type SimulateSwapResponse, type SwapResponse, type WithdrawHostFeesResponse } from "../types";
 export interface TokenBalance {
     balance: bigint;
     tokenInfo?: {
@@ -58,7 +58,7 @@ export declare class FlashnetClient {
      * @param wallet - The SparkWallet to use
      * @param options - Client options
      */
-    constructor(wallet: IssuerSparkWallet | SparkWallet, options?: FlashnetClientOptions);
+    constructor(wallet: IssuerSparkWallet | SparkWallet, _options?: FlashnetClientOptions);
     /**
      * Initialize the client by deducing network and authenticating
      * This is called automatically on first use if not called manually

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

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