@proofofprotocol/inscribe-mcp 0.1.0

package/src/tools/layer2/account.js

@@ -0,0 +1,155 @@
+/**
+ * Layer 2: Account Operations
+ *
+ * Advanced tools for direct account manipulation.
+ * Usually not needed - use Layer 1 tools instead.
+ */
+
+import { Hbar, TransferTransaction } from '@hashgraph/sdk';
+import { getHederaClient, getOperatorId, getMirrorNodeUrl } from '../../lib/hedera.js';
+
+/**
+ * Get HBAR Balance
+ */
+export const getBalanceTool = {
+  name: 'account_get_balance',
+  description: '[Advanced] HBAR 残高を確認する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      account_id: {
+        type: 'string',
+        description: 'アカウントID（省略時は運営アカウント）'
+      }
+    }
+  },
+
+  handler: async ({ account_id }) => {
+    const targetId = account_id || process.env.HEDERA_OPERATOR_ID;
+    const mirrorUrl = getMirrorNodeUrl();
+
+    const response = await fetch(`${mirrorUrl}/api/v1/accounts/${targetId}`);
+
+    if (!response.ok) {
+      return {
+        success: false,
+        error: `アカウント ${targetId} が見つかりません`,
+        account_id: targetId
+      };
+    }
+
+    const data = await response.json();
+    const balanceTinybars = data.balance?.balance || 0;
+    const balanceHbar = balanceTinybars / 100_000_000;
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      account_id: targetId,
+      balance_hbar: balanceHbar.toFixed(8),
+      balance_tinybars: balanceTinybars,
+      hashscan_url: `https://hashscan.io/${network}/account/${targetId}`
+    };
+  }
+};
+
+/**
+ * Send HBAR
+ */
+export const sendHbarTool = {
+  name: 'account_send_hbar',
+  description: '[Advanced] HBAR を送金する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      to_account_id: {
+        type: 'string',
+        description: '送金先アカウントID'
+      },
+      amount: {
+        type: 'number',
+        description: '送金額（HBAR）'
+      },
+      memo: {
+        type: 'string',
+        description: 'トランザクションメモ（オプション）'
+      }
+    },
+    required: ['to_account_id', 'amount']
+  },
+
+  handler: async ({ to_account_id, amount, memo }) => {
+    const client = getHederaClient();
+    const operatorId = getOperatorId();
+
+    const tx = new TransferTransaction()
+      .addHbarTransfer(operatorId, new Hbar(-amount))
+      .addHbarTransfer(to_account_id, new Hbar(amount));
+
+    if (memo) {
+      tx.setTransactionMemo(memo);
+    }
+
+    const response = await tx.execute(client);
+    const receipt = await response.getReceipt(client);
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      from: operatorId.toString(),
+      to: to_account_id,
+      amount_hbar: amount,
+      transaction_id: response.transactionId.toString(),
+      status: receipt.status.toString(),
+      hashscan_url: `https://hashscan.io/${network}/transaction/${response.transactionId.toString()}`
+    };
+  }
+};
+
+/**
+ * Get Account Info
+ */
+export const getAccountInfoTool = {
+  name: 'account_get_info',
+  description: '[Advanced] アカウント情報を取得する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      account_id: {
+        type: 'string',
+        description: 'アカウントID'
+      }
+    },
+    required: ['account_id']
+  },
+
+  handler: async ({ account_id }) => {
+    const mirrorUrl = getMirrorNodeUrl();
+
+    const response = await fetch(`${mirrorUrl}/api/v1/accounts/${account_id}`);
+
+    if (!response.ok) {
+      return {
+        success: false,
+        error: `アカウント ${account_id} が見つかりません`,
+        account_id
+      };
+    }
+
+    const data = await response.json();
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      account_id,
+      evm_address: data.evm_address,
+      key: data.key,
+      balance_hbar: (data.balance?.balance || 0) / 100_000_000,
+      created_timestamp: data.created_timestamp,
+      memo: data.memo,
+      hashscan_url: `https://hashscan.io/${network}/account/${account_id}`
+    };
+  }
+};

package/src/tools/layer2/hcs.js

@@ -0,0 +1,163 @@
+/**
+ * Layer 2: HCS Direct Operations
+ *
+ * Advanced tools for direct HCS manipulation.
+ * Usually not needed - use Layer 1 tools instead.
+ */
+
+import { TopicCreateTransaction, TopicMessageSubmitTransaction, TopicId } from '@hashgraph/sdk';
+import { getHederaClient, getMirrorNodeUrl } from '../../lib/hedera.js';
+
+/**
+ * Create HCS Topic
+ */
+export const createTopicTool = {
+  name: 'hcs_create_topic',
+  description: '[Advanced] HCS トピックを直接作成する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      memo: {
+        type: 'string',
+        description: 'トピックのメモ（説明）'
+      }
+    }
+  },
+
+  handler: async ({ memo }) => {
+    const client = getHederaClient();
+
+    const tx = new TopicCreateTransaction();
+    if (memo) {
+      tx.setTopicMemo(memo);
+    }
+
+    const response = await tx.execute(client);
+    const receipt = await response.getReceipt(client);
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      topic_id: receipt.topicId.toString(),
+      memo: memo || null,
+      hashscan_url: `https://hashscan.io/${network}/topic/${receipt.topicId.toString()}`
+    };
+  }
+};
+
+/**
+ * Submit HCS Message
+ */
+export const submitMessageTool = {
+  name: 'hcs_submit_message',
+  description: '[Advanced] HCS にメッセージを直接送信する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      topic_id: {
+        type: 'string',
+        description: 'トピックID (例: 0.0.7503789)'
+      },
+      message: {
+        type: 'string',
+        description: 'メッセージ内容'
+      }
+    },
+    required: ['topic_id', 'message']
+  },
+
+  handler: async ({ topic_id, message }) => {
+    const client = getHederaClient();
+
+    const tx = new TopicMessageSubmitTransaction()
+      .setTopicId(TopicId.fromString(topic_id))
+      .setMessage(message);
+
+    const response = await tx.execute(client);
+    const record = await response.getRecord(client);
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      topic_id,
+      timestamp: record.consensusTimestamp.toString(),
+      message_preview: message.substring(0, 100) + (message.length > 100 ? '...' : ''),
+      hashscan_url: `https://hashscan.io/${network}/transaction/${response.transactionId.toString()}`
+    };
+  }
+};
+
+/**
+ * Get HCS Messages
+ */
+export const getMessagesTool = {
+  name: 'hcs_get_messages',
+  description: '[Advanced] HCS メッセージを取得する',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      topic_id: {
+        type: 'string',
+        description: 'トピックID'
+      },
+      limit: {
+        type: 'number',
+        description: '取得件数（デフォルト: 10）',
+        default: 10
+      },
+      order: {
+        type: 'string',
+        description: '並び順（asc / desc）',
+        default: 'desc'
+      }
+    },
+    required: ['topic_id']
+  },
+
+  handler: async ({ topic_id, limit = 10, order = 'desc' }) => {
+    const mirrorUrl = getMirrorNodeUrl();
+    const apiUrl = `${mirrorUrl}/api/v1/topics/${topic_id}/messages?limit=${limit}&order=${order}`;
+
+    const response = await fetch(apiUrl);
+    if (!response.ok) {
+      return {
+        success: false,
+        error: `トピック ${topic_id} が見つかりません`,
+        topic_id,
+        messages: []
+      };
+    }
+
+    const data = await response.json();
+
+    const messages = (data.messages || []).map(m => {
+      let content;
+      try {
+        content = Buffer.from(m.message, 'base64').toString('utf-8');
+        // Try to parse as JSON
+        const parsed = JSON.parse(content);
+        content = parsed;
+      } catch {
+        // Keep as string if not JSON
+      }
+
+      return {
+        timestamp: m.consensus_timestamp,
+        sequence_number: m.sequence_number,
+        content
+      };
+    });
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      topic_id,
+      count: messages.length,
+      messages,
+      hashscan_url: `https://hashscan.io/${network}/topic/${topic_id}`
+    };
+  }
+};