@hashgraphonline/standards-agent-kit/src/tools/hcs6/UpdateDynamicHashinalTool.ts

A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication. https://hol.org

import { z } from 'zod';
import { BaseHCS6QueryTool } from './base-hcs6-tools';
import { isWalletBytesResponse } from '../../types/tx-results';
import { HCS6QueryToolParams } from './hcs6-tool-params';
import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';

/**
 * Schema for updating a dynamic hashinal
 */
const UpdateDynamicHashinalSchema = z.object({
  registryTopicId: z.string()
    .describe('The registry topic ID that tracks this dynamic hashinal'),
  metadata: z.record(z.unknown())
    .describe('Updated metadata object for the hashinal'),
  data: z.object({
    base64: z.string().optional().describe('Base64 encoded data for the updated hashinal'),
    url: z.string().optional().describe('URL to fetch updated data from'),
    mimeType: z.string().optional().describe('MIME type of the data'),
  }).optional()
    .describe('Updated data to inscribe'),
  memo: z.string()
    .optional()
    .describe('Optional memo for the update (e.g., "Level up", "Version 2.0")'),
  submitKey: z.string()
    .describe('Submit key for the registry (required to update)'),
});

export type UpdateDynamicHashinalInput = z.infer<typeof UpdateDynamicHashinalSchema>;

/**
 * Tool for updating dynamic hashinals
 */
export class UpdateDynamicHashinalTool extends BaseHCS6QueryTool<typeof UpdateDynamicHashinalSchema> {
  name = 'updateDynamicHashinal';
  description = 'Update an existing dynamic hashinal with new content while maintaining the same registry';

  get specificInputSchema() {
    return UpdateDynamicHashinalSchema;
  }

  constructor(params: HCS6QueryToolParams) {
    super(params);
  }

  protected async executeQuery(
    params: UpdateDynamicHashinalInput,
    _runManager?: CallbackManagerForToolRun
  ): Promise<unknown> {

    const result = await this.hcs6Builder.register({
      metadata: params.metadata,
      data: params.data,
      memo: params.memo,
      registryTopicId: params.registryTopicId,
      submitKey: params.submitKey,
    });

    if (!('success' in result) || !result.success) {
      throw new Error((result as any).error || 'Failed to update dynamic hashinal');
    }

    if (isWalletBytesResponse(result as any)) {
      const txBytes = (result as any).transactionBytes as string;
      return {
        message: 'I prepared an unsigned transaction to update a dynamic hashinal. Please review and approve to submit.',
        transactionBytes: txBytes,
        metadata: {
          transactionBytes: txBytes,
          pendingApproval: true,
          description: `Update dynamic hashinal (registry ${params.registryTopicId})${params.memo ? ` (Memo: ${params.memo})` : ''}`,
        },
      };
    }

    return `Successfully updated dynamic hashinal!\n\nRegistry Topic ID: ${params.registryTopicId}\nInscription Topic ID: ${(result as any).inscriptionTopicId}${params.memo ? `\nUpdate Memo: ${params.memo}` : ''}\n\nThe dynamic hashinal has been updated with new content.`;
  }
}