helius-mcp 1.2.0 → 2.0.0

package/dist/tools/assets.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { getHeliusClient, hasApiKey } from '../utils/helius.js';
 import { formatAddress } from '../utils/formatters.js';
 import { noApiKeyResponse } from './shared.js';
-import { mcpText, handleToolError, addressError, paginationError, notFoundError } from '../utils/errors.js';
+import { mcpText, mcpError, handleToolError, addressError, paginationError, notFoundError, missingParamError, exclusiveParamError, batchLimitError } from '../utils/errors.js';
 export function registerAssetTools(server) {
     // Get Assets by Owner (NFTs and tokens via DAS)
     server.tool('getAssetsByOwner', 'BEST FOR: listing NFTs/digital assets owned by a wallet. PREFER getTokenBalances for fungible tokens, getAsset for a specific mint. Get all NFTs and digital assets owned by a wallet. Returns asset names, types, and mint addresses. Supports regular NFTs and cNFTs. Credit cost: 10 credits (DAS API).', {
@@ -69,15 +69,15 @@ export function registerAssetTools(server) {
         const helius = getHeliusClient();
         // Validate: must provide exactly one of id or ids
         if (!id && (!ids || ids.length === 0)) {
-            return mcpText(`**Error:** Provide either "id" (single asset) or "ids" (batch of up to 1000).`);
+            return missingParamError('getAsset', 'Provide either `id` (single asset) or `ids` (batch of up to 1000).');
         }
         if (id && ids && ids.length > 0) {
-            return mcpText(`**Error:** Provide either "id" or "ids", not both.`);
+            return exclusiveParamError('getAsset', 'id', 'ids');
         }
         // --- Batch mode ---
         if (ids && ids.length > 0) {
             if (ids.length > 1000) {
-                return mcpText(`**Error:** Maximum 1000 assets per batch. You provided ${ids.length}.`);
+                return batchLimitError('getAsset', 1000, ids.length);
             }
             let assets;
             try {
@@ -254,7 +254,7 @@ export function registerAssetTools(server) {
         // General search → searchAssets
         else {
             if (name && !ownerAddress) {
-                return mcpText(`**Search Error:** Searching by name requires an owner address. Please also provide \`ownerAddress\` to search for assets named "${name}".`);
+                return mcpError(`**Search Error:** Searching by name requires an owner address. Please also provide \`ownerAddress\` to search for assets named "${name}".`, { type: 'VALIDATION', code: 'MISSING_PARAM', retryable: false, recovery: 'Provide `ownerAddress` when searching by name.' });
             }
             const params = { page, limit };
             if (ownerAddress)