@hashgraphonline/standards-agent-kit 0.2.122 → 0.2.124

package/src/tools/inscriber/InscribeHashinalTool.ts

@@ -54,6 +54,11 @@ const inscribeHashinalSchema = z.object({
     .string()
     .optional()
     .describe('API key for inscription service'),
+  quoteOnly: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe('If true, returns a cost quote instead of executing the inscription'),
 });
 
 
@@ -62,7 +67,7 @@ const inscribeHashinalSchema = z.object({
  */
 export class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribeHashinalSchema> {
   name = 'inscribeHashinal';
-  description = 'Inscribe content as a Hashinal NFT on the Hedera network';
+  description = 'Inscribe content as a Hashinal NFT on the Hedera network. Set quoteOnly=true to get cost estimates without executing the inscription.';
 
   get specificInputSchema() {
     return inscribeHashinalSchema;
@@ -87,13 +92,43 @@ export class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribe
       jsonFileURL: params.jsonFileURL,
       tags: params.tags,
       chunkSize: params.chunkSize,
-      waitForConfirmation: params.waitForConfirmation ?? true,
+      waitForConfirmation: params.quoteOnly ? false : (params.waitForConfirmation ?? true),
       waitMaxAttempts: 10,
       waitIntervalMs: 3000,
       apiKey: params.apiKey,
       network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',
+      quoteOnly: params.quoteOnly,
     };
 
+    if (params.quoteOnly) {
+      try {
+        const quote = await this.generateInscriptionQuote(
+          { type: 'url', url: params.url },
+          options
+        );
+        
+        return {
+          success: true,
+          quote: {
+            totalCostHbar: quote.totalCostHbar,
+            validUntil: quote.validUntil,
+            breakdown: quote.breakdown,
+          },
+          contentInfo: {
+            url: params.url,
+            name: params.name,
+            creator: params.creator,
+            type: params.type,
+          },
+          message: `Quote generated for Hashinal NFT: ${params.name}\nCreator: ${params.creator}\nTotal cost: ${quote.totalCostHbar} HBAR`,
+        };
+      } catch (error) {
+        const errorMessage =
+          error instanceof Error ? error.message : 'Failed to generate inscription quote';
+        throw new Error(`Quote generation failed: ${errorMessage}`);
+      }
+    }
+
     try {
       let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;
       
@@ -119,13 +154,15 @@ export class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribe
         );
       }
 
-      if (result.confirmed) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
+      if (result.confirmed && !result.quote) {
+        const topicId = result.inscription?.topic_id || (result.result as any).topicId;
         const network = options.network || 'testnet';
         const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
-        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!\n\nTransaction ID: ${result.result.transactionId}\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\nView inscription: ${cdnUrl}` : ''}\n\nThe Hashinal NFT is now available.`;
+        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!\n\nTransaction ID: ${(result.result as any).transactionId}\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\nView inscription: ${cdnUrl}` : ''}\n\nThe Hashinal NFT is now available.`;
+      } else if (!result.quote && !result.confirmed) {
+        return `Successfully submitted Hashinal NFT inscription to the Hedera network!\n\nTransaction ID: ${(result.result as any).transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
       } else {
-        return `Successfully submitted Hashinal NFT inscription to the Hedera network!\n\nTransaction ID: ${result.result.transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
+        return 'Inscription operation completed.';
       }
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe Hashinal NFT';

package/src/tools/inscriber/base-inscriber-tools.ts

@@ -9,6 +9,11 @@ import {
   InscriberQueryToolParams,
 } from './inscriber-tool-params';
 import type { ContentResolverInterface } from '../../types/content-resolver';
+import {
+  InscriptionInput,
+  InscriptionOptions,
+  QuoteResult,
+} from '@hashgraphonline/standards-sdk';
 import { z } from 'zod';
 
 /**
@@ -44,6 +49,47 @@ export abstract class BaseInscriberTransactionTool<
   protected getContentResolver(): ContentResolverInterface | null {
     return this.contentResolver;
   }
+
+  /**
+   * Generate a quote for an inscription without executing it
+   * @param input - The inscription input data
+   * @param options - Inscription options
+   * @returns Promise containing the quote result
+   */
+  protected async generateInscriptionQuote(
+    input: InscriptionInput,
+    options: InscriptionOptions
+  ): Promise<QuoteResult> {
+    const operatorId = this.inscriberBuilder['hederaKit'].signer.getAccountId().toString();
+    const operatorPrivateKey = this.inscriberBuilder['hederaKit'].signer?.getOperatorPrivateKey()
+      ? this.inscriberBuilder['hederaKit'].signer.getOperatorPrivateKey().toStringRaw()
+      : '';
+
+    const network = this.inscriberBuilder['hederaKit'].client.network;
+    const networkType = network.toString().includes('mainnet')
+      ? 'mainnet'
+      : 'testnet';
+
+    const clientConfig = {
+      accountId: operatorId,
+      privateKey: operatorPrivateKey,
+      network: networkType as 'mainnet' | 'testnet',
+    };
+
+    const quoteOptions = {
+      ...options,
+      quoteOnly: true,
+      network: networkType as 'mainnet' | 'testnet',
+    };
+
+    const result = await this.inscriberBuilder.inscribe(input, quoteOptions);
+    
+    if (!result.quote || result.confirmed) {
+      throw new Error('Failed to generate quote - unexpected response type');
+    }
+
+    return result.result as QuoteResult;
+  }
 }
 
 /**
@@ -79,4 +125,45 @@ export abstract class BaseInscriberQueryTool<
   protected getContentResolver(): ContentResolverInterface | null {
     return this.contentResolver;
   }
+
+  /**
+   * Generate a quote for an inscription without executing it
+   * @param input - The inscription input data
+   * @param options - Inscription options
+   * @returns Promise containing the quote result
+   */
+  protected async generateInscriptionQuote(
+    input: InscriptionInput,
+    options: InscriptionOptions
+  ): Promise<QuoteResult> {
+    const operatorId = this.inscriberBuilder['hederaKit'].signer.getAccountId().toString();
+    const operatorPrivateKey = this.inscriberBuilder['hederaKit'].signer?.getOperatorPrivateKey()
+      ? this.inscriberBuilder['hederaKit'].signer.getOperatorPrivateKey().toStringRaw()
+      : '';
+
+    const network = this.inscriberBuilder['hederaKit'].client.network;
+    const networkType = network.toString().includes('mainnet')
+      ? 'mainnet'
+      : 'testnet';
+
+    const clientConfig = {
+      accountId: operatorId,
+      privateKey: operatorPrivateKey,
+      network: networkType as 'mainnet' | 'testnet',
+    };
+
+    const quoteOptions = {
+      ...options,
+      quoteOnly: true,
+      network: networkType as 'mainnet' | 'testnet',
+    };
+
+    const result = await this.inscriberBuilder.inscribe(input, quoteOptions);
+    
+    if (!result.quote || result.confirmed) {
+      throw new Error('Failed to generate quote - unexpected response type');
+    }
+
+    return result.result as QuoteResult;
+  }
 }