@gala-chain/launchpad-mcp-server 1.5.0 → 1.6.0

package/.eslintrc.json

@@ -16,5 +16,13 @@
   "rules": {
     "@typescript-eslint/no-explicit-any": "off",
     "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }]
-  }
+  },
+  "overrides": [
+    {
+      "files": ["*.examples.ts"],
+      "rules": {
+        "@typescript-eslint/no-unused-vars": "off"
+      }
+    }
+  ]
 }

package/dist/schemas/common-schemas.d.ts

@@ -10,42 +10,75 @@
  */
 /**
  * Token name schema - used in 11+ tools
- * Generated from SDK tokenNameSchema
+ *
+ * @description Generated from SDK tokenNameSchema
+ * @pattern ^[a-zA-Z0-9]{3,20}$
+ * @minLength 3
+ * @maxLength 20
+ * @example "boba", "testtoken", "mytoken123"
  */
 export declare const TOKEN_NAME_SCHEMA: any;
 /**
  * Token symbol schema - used in creation tools
- * Generated from SDK tokenSymbolSchema
+ *
+ * @description Generated from SDK tokenSymbolSchema
+ * @pattern ^[A-Z]{1,8}$
+ * @minLength 1
+ * @maxLength 8
+ * @example "GALA", "TEST", "MTK"
  */
 export declare const TOKEN_SYMBOL_SCHEMA: any;
 /**
  * Token description schema
- * Generated from SDK tokenDescriptionSchema
+ *
+ * @description Generated from SDK tokenDescriptionSchema
+ * @minLength 1
+ * @maxLength 500
+ * @example "A revolutionary new token for decentralized gaming"
  */
 export declare const TOKEN_DESCRIPTION_SCHEMA: any;
 /**
  * Private key schema - used in 18+ tools
- * Generated from SDK privateKeySchema
+ *
+ * @description Generated from SDK privateKeySchema
+ * @pattern ^0x[a-fA-F0-9]{64}$
+ * @example "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
+ * @security Sensitive - should never be logged or exposed
  */
 export declare const PRIVATE_KEY_SCHEMA: any;
 /**
  * Wallet address schema - supports both Ethereum (0x...) and GalaChain (eth|...) formats
- * Generated from SDK flexibleAddressSchema
+ *
+ * @description Generated from SDK flexibleAddressSchema
+ * @example "0x1234567890abcdef1234567890abcdef12345678"
+ * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
 export declare const ADDRESS_SCHEMA: any;
 /**
  * Decimal amount schema - used in trading and transfer tools
- * Generated from SDK positiveDecimalStringSchema
+ *
+ * @description Generated from SDK positiveDecimalStringSchema
+ * @pattern ^\d+(\.\d+)?$
+ * @example "100", "1.5", "0.001"
+ * @note Must be positive (greater than zero)
  */
 export declare const DECIMAL_AMOUNT_SCHEMA: any;
 /**
  * Pre-buy quantity schema - used in token creation
- * Generated from SDK nonNegativeDecimalStringSchema
+ *
+ * @description Generated from SDK nonNegativeDecimalStringSchema
+ * @pattern ^\d+(\.\d+)?$
+ * @example "0", "100", "1500.5"
+ * @note Can be zero or positive (non-negative)
  */
 export declare const PRE_BUY_QUANTITY_SCHEMA: any;
 /**
  * Integer amount schema - used in token transfers
- * Pattern: positive integer string
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @pattern ^[0-9]+$
+ * @example "100", "1000", "5000000"
+ * @note Integer only (no decimals) - for token transfer operations
  */
 export declare const INTEGER_AMOUNT_SCHEMA: {
     type: "string";
@@ -54,42 +87,81 @@ export declare const INTEGER_AMOUNT_SCHEMA: {
 };
 /**
  * URL schema - used for social URLs and token images
- * Generated from SDK urlSchema
+ *
+ * @description Generated from SDK urlSchema
+ * @pattern ^https?:\/\/
+ * @format uri
+ * @example "https://example.com", "https://twitter.com/username"
+ * @note Must start with http:// or https://
  */
 export declare const URL_SCHEMA: any;
 /**
  * Comment message schema
- * Generated from SDK commentMessageSchema
+ *
+ * @description Generated from SDK commentMessageSchema
+ * @minLength 1
+ * @maxLength 500
+ * @example "Great token!", "Looking forward to this project"
  */
 export declare const COMMENT_MESSAGE_SCHEMA: any;
 /**
  * Profile name schema
- * Generated from SDK fullNameSchema
+ *
+ * @description Generated from SDK fullNameSchema
+ * @pattern ^[a-zA-Z\s]+$
+ * @minLength 1
+ * @maxLength 100
+ * @example "John Doe", "Alice Smith"
+ * @note Only letters and spaces allowed
  */
 export declare const FULL_NAME_SCHEMA: any;
 /**
  * Search query schema - used in user tools
- * Generated from SDK searchQuerySchema
+ *
+ * @description Generated from SDK searchQuerySchema
+ * @minLength 1
+ * @maxLength 100
+ * @example "dragon", "test", "my token"
+ * @note Fuzzy match - case-insensitive, partial matching
  */
 export declare const SEARCH_SCHEMA: any;
 /**
  * Transaction ID schema - used for getBundlerTransactionResult
- * Generated from SDK transactionIdSchema
+ *
+ * @description Generated from SDK transactionIdSchema
+ * @pattern ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
+ * @format uuid
+ * @example "550e8400-e29b-41d4-a716-446655440000"
+ * @note UUID v4 format - returned from buy(), sell(), launchToken()
  */
 export declare const TRANSACTION_ID_SCHEMA: any;
 /**
  * Idempotency key schema - used in transfer tools
- * Generated from SDK uniqueKeySchema
+ *
+ * @description Generated from SDK uniqueKeySchema
+ * @pattern ^galaconnect-operation-[a-z0-9-]+$
+ * @example "galaconnect-operation-abc123-def456"
+ * @note Prevents duplicate transactions - optional but recommended
  */
 export declare const UNIQUE_KEY_SCHEMA: any;
 /**
  * Date-time schema - used in trade and volume queries
- * Generated from SDK isoDateStringSchema
+ *
+ * @description Generated from SDK isoDateStringSchema
+ * @format date-time
+ * @example "2024-01-15T14:30:25", "2024-01-15T14:30:25Z"
+ * @note ISO 8601 format
  */
 export declare const DATE_TIME_SCHEMA: any;
 /**
  * Page number schema - used in ~15 tools
- * Generated from SDK pageNumberSchema
+ *
+ * @description Generated from SDK pageNumberSchema
+ * @type number
+ * @minimum 1
+ * @maximum 1000
+ * @example 1, 2, 50
+ * @note Default: 1 (first page)
  */
 export declare const PAGE_SCHEMA: any;
 /**
@@ -108,6 +180,13 @@ export declare function createLimitSchema(operationType: 'trade' | 'user' | 'poo
 };
 /**
  * Slippage tolerance factor schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type number
+ * @minimum 0
+ * @maximum 1
+ * @example 0.01 (1%), 0.05 (5%), 0.1 (10%)
+ * @note Decimal format - protects against price movements during transaction
  */
 export declare const SLIPPAGE_TOLERANCE_SCHEMA: {
     type: "number";
@@ -117,6 +196,13 @@ export declare const SLIPPAGE_TOLERANCE_SCHEMA: {
 };
 /**
  * Reverse bonding curve fee slippage schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type number
+ * @minimum 0
+ * @maximum 1
+ * @example 0.01 (1% - default), 0.02 (2%), 0.05 (5%)
+ * @note Applied to maxAcceptableReverseBondingCurveFee for additional protection
  */
 export declare const RBC_FEE_SLIPPAGE_SCHEMA: {
     type: "number";
@@ -126,6 +212,12 @@ export declare const RBC_FEE_SLIPPAGE_SCHEMA: {
 };
 /**
  * Sort order schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type string
+ * @enum ['ASC', 'DESC']
+ * @example "ASC" (oldest first), "DESC" (newest first - default)
+ * @note Default: DESC (descending, newest first)
  */
 export declare const SORT_ORDER_SCHEMA: {
     type: "string";
@@ -134,6 +226,13 @@ export declare const SORT_ORDER_SCHEMA: {
 };
 /**
  * Calculation mode schema - for calculateAmountMode parameter
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type string
+ * @enum ['local', 'external']
+ * @example "local" (instant client-side), "external" (network-based GalaChain)
+ * @note Default: SDK's calculateAmountMode setting
+ * @note Local mode: <1ms, 99.99% accurate | External mode: ~200ms, 100% accurate
  */
 export declare const CALCULATION_MODE_SCHEMA: {
     type: "string";
@@ -142,6 +241,12 @@ export declare const CALCULATION_MODE_SCHEMA: {
 };
 /**
  * Current supply schema - for performance optimization
+ *
+ * @description Extends DECIMAL_AMOUNT_SCHEMA
+ * @pattern ^\d+(\.\d+)?$
+ * @example "1000000", "5000000.5"
+ * @note Performance optimization: provide to avoid fetching pool details twice
+ * @note Only used in local calculation mode - auto-fetched if missing
  */
 export declare const CURRENT_SUPPLY_SCHEMA: any;
 //# sourceMappingURL=common-schemas.d.ts.map

package/dist/schemas/common-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkDH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA6C,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAiD,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAGpC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAG9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAuD,CAAC;AAMnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAGnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,UAAU,KAAyB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAGlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAA2C,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,aAAa,KAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAA2D,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAAmC,CAAC;AAMjE;;;GAGG;AACH,eAAO,MAAM,WAAW,KAA4D,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EACpD,YAAY,GAAE,MAAW,GACxB;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC"}
+{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/common-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkDH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,KAA6C,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,KAAiD,CAAC;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,KAGpC,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,KAG9B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,KAAuD,CAAC;AAMnF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,KAGnC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,KAAyB,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,KAGlC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,KAA2C,CAAC;AAEzE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,KAGzB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,KAA2D,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,KAAmC,CAAC;AAMjE;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,KAA4D,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EACpD,YAAY,GAAE,MAAW,GACxB;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;CAMnC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;CAMnC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAGjC,CAAC"}

package/dist/schemas/common-schemas.js

@@ -38,17 +38,31 @@ function toMCPSchema(zodSchema, customDescription) {
 // =============================================================================
 /**
  * Token name schema - used in 11+ tools
- * Generated from SDK tokenNameSchema
+ *
+ * @description Generated from SDK tokenNameSchema
+ * @pattern ^[a-zA-Z0-9]{3,20}$
+ * @minLength 3
+ * @maxLength 20
+ * @example "boba", "testtoken", "mytoken123"
  */
 exports.TOKEN_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenNameSchema, 'Token name');
 /**
  * Token symbol schema - used in creation tools
- * Generated from SDK tokenSymbolSchema
+ *
+ * @description Generated from SDK tokenSymbolSchema
+ * @pattern ^[A-Z]{1,8}$
+ * @minLength 1
+ * @maxLength 8
+ * @example "GALA", "TEST", "MTK"
  */
 exports.TOKEN_SYMBOL_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenSymbolSchema, 'Token symbol');
 /**
  * Token description schema
- * Generated from SDK tokenDescriptionSchema
+ *
+ * @description Generated from SDK tokenDescriptionSchema
+ * @minLength 1
+ * @maxLength 500
+ * @example "A revolutionary new token for decentralized gaming"
  */
 exports.TOKEN_DESCRIPTION_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenDescriptionSchema, 'Token description');
 // =============================================================================
@@ -56,12 +70,19 @@ exports.TOKEN_DESCRIPTION_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenDescriptionS
 // =============================================================================
 /**
  * Private key schema - used in 18+ tools
- * Generated from SDK privateKeySchema
+ *
+ * @description Generated from SDK privateKeySchema
+ * @pattern ^0x[a-fA-F0-9]{64}$
+ * @example "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
+ * @security Sensitive - should never be logged or exposed
  */
 exports.PRIVATE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.privateKeySchema, 'Optional private key override for this operation (format: "0x" + 64 hex characters). If provided, uses this wallet instead of the default MCP server wallet.');
 /**
  * Wallet address schema - supports both Ethereum (0x...) and GalaChain (eth|...) formats
- * Generated from SDK flexibleAddressSchema
+ *
+ * @description Generated from SDK flexibleAddressSchema
+ * @example "0x1234567890abcdef1234567890abcdef12345678"
+ * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
 exports.ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address');
 // =============================================================================
@@ -69,17 +90,29 @@ exports.ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wal
 // =============================================================================
 /**
  * Decimal amount schema - used in trading and transfer tools
- * Generated from SDK positiveDecimalStringSchema
+ *
+ * @description Generated from SDK positiveDecimalStringSchema
+ * @pattern ^\d+(\.\d+)?$
+ * @example "100", "1.5", "0.001"
+ * @note Must be positive (greater than zero)
  */
-exports.DECIMAL_AMOUNT_SCHEMA = toMCPSchema(launchpad_sdk_1.positiveDecimalStringSchema, 'Amount in standard decimal format');
+exports.DECIMAL_AMOUNT_SCHEMA = toMCPSchema(launchpad_sdk_1.positiveDecimalStringSchema, 'Amount in standard decimal format (e.g., "1" for 1 GALA)');
 /**
  * Pre-buy quantity schema - used in token creation
- * Generated from SDK nonNegativeDecimalStringSchema
+ *
+ * @description Generated from SDK nonNegativeDecimalStringSchema
+ * @pattern ^\d+(\.\d+)?$
+ * @example "0", "100", "1500.5"
+ * @note Can be zero or positive (non-negative)
  */
 exports.PRE_BUY_QUANTITY_SCHEMA = toMCPSchema(launchpad_sdk_1.nonNegativeDecimalStringSchema, 'Pre-buy quantity as decimal string (defaults to "0")');
 /**
  * Integer amount schema - used in token transfers
- * Pattern: positive integer string
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @pattern ^[0-9]+$
+ * @example "100", "1000", "5000000"
+ * @note Integer only (no decimals) - for token transfer operations
  */
 exports.INTEGER_AMOUNT_SCHEMA = {
     type: 'string',
@@ -91,37 +124,70 @@ exports.INTEGER_AMOUNT_SCHEMA = {
 // =============================================================================
 /**
  * URL schema - used for social URLs and token images
- * Generated from SDK urlSchema
+ *
+ * @description Generated from SDK urlSchema
+ * @pattern ^https?:\/\/
+ * @format uri
+ * @example "https://example.com", "https://twitter.com/username"
+ * @note Must start with http:// or https://
  */
 exports.URL_SCHEMA = toMCPSchema(launchpad_sdk_1.urlSchema);
 /**
  * Comment message schema
- * Generated from SDK commentMessageSchema
+ *
+ * @description Generated from SDK commentMessageSchema
+ * @minLength 1
+ * @maxLength 500
+ * @example "Great token!", "Looking forward to this project"
  */
 exports.COMMENT_MESSAGE_SCHEMA = toMCPSchema(launchpad_sdk_1.commentMessageSchema, 'Comment message text');
 /**
  * Profile name schema
- * Generated from SDK fullNameSchema
+ *
+ * @description Generated from SDK fullNameSchema
+ * @pattern ^[a-zA-Z\s]+$
+ * @minLength 1
+ * @maxLength 100
+ * @example "John Doe", "Alice Smith"
+ * @note Only letters and spaces allowed
  */
 exports.FULL_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.fullNameSchema, 'Full name');
 /**
  * Search query schema - used in user tools
- * Generated from SDK searchQuerySchema
+ *
+ * @description Generated from SDK searchQuerySchema
+ * @minLength 1
+ * @maxLength 100
+ * @example "dragon", "test", "my token"
+ * @note Fuzzy match - case-insensitive, partial matching
  */
 exports.SEARCH_SCHEMA = toMCPSchema(launchpad_sdk_1.searchQuerySchema, 'Optional search query (fuzzy match filter)');
 /**
  * Transaction ID schema - used for getBundlerTransactionResult
- * Generated from SDK transactionIdSchema
+ *
+ * @description Generated from SDK transactionIdSchema
+ * @pattern ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
+ * @format uuid
+ * @example "550e8400-e29b-41d4-a716-446655440000"
+ * @note UUID v4 format - returned from buy(), sell(), launchToken()
  */
 exports.TRANSACTION_ID_SCHEMA = toMCPSchema(launchpad_sdk_1.transactionIdSchema, 'Transaction ID (UUID format) from buy(), sell(), or launchToken()');
 /**
  * Idempotency key schema - used in transfer tools
- * Generated from SDK uniqueKeySchema
+ *
+ * @description Generated from SDK uniqueKeySchema
+ * @pattern ^galaconnect-operation-[a-z0-9-]+$
+ * @example "galaconnect-operation-abc123-def456"
+ * @note Prevents duplicate transactions - optional but recommended
  */
 exports.UNIQUE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.uniqueKeySchema, 'Optional idempotency key');
 /**
  * Date-time schema - used in trade and volume queries
- * Generated from SDK isoDateStringSchema
+ *
+ * @description Generated from SDK isoDateStringSchema
+ * @format date-time
+ * @example "2024-01-15T14:30:25", "2024-01-15T14:30:25Z"
+ * @note ISO 8601 format
  */
 exports.DATE_TIME_SCHEMA = toMCPSchema(launchpad_sdk_1.isoDateStringSchema);
 // =============================================================================
@@ -129,7 +195,13 @@ exports.DATE_TIME_SCHEMA = toMCPSchema(launchpad_sdk_1.isoDateStringSchema);
 // =============================================================================
 /**
  * Page number schema - used in ~15 tools
- * Generated from SDK pageNumberSchema
+ *
+ * @description Generated from SDK pageNumberSchema
+ * @type number
+ * @minimum 1
+ * @maximum 1000
+ * @example 1, 2, 50
+ * @note Default: 1 (first page)
  */
 exports.PAGE_SCHEMA = toMCPSchema(launchpad_sdk_1.pageNumberSchema, 'Page number (default: 1)');
 /**
@@ -157,6 +229,13 @@ function createLimitSchema(operationType, defaultLimit = 20) {
 // =============================================================================
 /**
  * Slippage tolerance factor schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type number
+ * @minimum 0
+ * @maximum 1
+ * @example 0.01 (1%), 0.05 (5%), 0.1 (10%)
+ * @note Decimal format - protects against price movements during transaction
  */
 exports.SLIPPAGE_TOLERANCE_SCHEMA = {
     type: 'number',
@@ -166,6 +245,13 @@ exports.SLIPPAGE_TOLERANCE_SCHEMA = {
 };
 /**
  * Reverse bonding curve fee slippage schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type number
+ * @minimum 0
+ * @maximum 1
+ * @example 0.01 (1% - default), 0.02 (2%), 0.05 (5%)
+ * @note Applied to maxAcceptableReverseBondingCurveFee for additional protection
  */
 exports.RBC_FEE_SLIPPAGE_SCHEMA = {
     type: 'number',
@@ -175,6 +261,12 @@ exports.RBC_FEE_SLIPPAGE_SCHEMA = {
 };
 /**
  * Sort order schema
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type string
+ * @enum ['ASC', 'DESC']
+ * @example "ASC" (oldest first), "DESC" (newest first - default)
+ * @note Default: DESC (descending, newest first)
  */
 exports.SORT_ORDER_SCHEMA = {
     type: 'string',
@@ -183,6 +275,13 @@ exports.SORT_ORDER_SCHEMA = {
 };
 /**
  * Calculation mode schema - for calculateAmountMode parameter
+ *
+ * @description Manual schema (not from SDK primitives)
+ * @type string
+ * @enum ['local', 'external']
+ * @example "local" (instant client-side), "external" (network-based GalaChain)
+ * @note Default: SDK's calculateAmountMode setting
+ * @note Local mode: <1ms, 99.99% accurate | External mode: ~200ms, 100% accurate
  */
 exports.CALCULATION_MODE_SCHEMA = {
     type: 'string',
@@ -193,6 +292,12 @@ Use CALCULATION_MODES.EXTERNAL for network-based GalaChain calculations.`,
 };
 /**
  * Current supply schema - for performance optimization
+ *
+ * @description Extends DECIMAL_AMOUNT_SCHEMA
+ * @pattern ^\d+(\.\d+)?$
+ * @example "1000000", "5000000.5"
+ * @note Performance optimization: provide to avoid fetching pool details twice
+ * @note Only used in local calculation mode - auto-fetched if missing
  */
 exports.CURRENT_SUPPLY_SCHEMA = {
     ...exports.DECIMAL_AMOUNT_SCHEMA,

package/dist/schemas/common-schemas.js.map

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

package/dist/scripts/test-all-prompts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Comprehensive Prompt Testing Script
+ * Tests all 14 MCP prompts with v1.5.0 enhancements
+ */
+export {};
+//# sourceMappingURL=test-all-prompts.d.ts.map

package/dist/scripts/test-all-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-all-prompts.d.ts","sourceRoot":"","sources":["../../src/scripts/test-all-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}