@proofofprotocol/inscribe-mcp 0.1.0

package/src/tools/layer1/identity.js

@@ -0,0 +1,120 @@
+/**
+ * identity - Trust Identity Creation Tool
+ *
+ * Create a Hedera-based identity (DID) for inscriptions.
+ */
+
+import { PrivateKey, Hbar, TransferTransaction } from '@hashgraph/sdk';
+import { getHederaClient, getOperatorId, getMirrorNodeUrl } from '../../lib/hedera.js';
+
+export const identityTool = {
+  name: 'identity',
+  description: '信頼IDを作成する（Hederaアカウント + DID）。inscribe 時の author として使用可能。',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'IDの名前（オプション、識別用）'
+      },
+      initial_balance: {
+        type: 'number',
+        description: '初期残高（HBAR）。デフォルト: 1 HBAR',
+        default: 1
+      }
+    }
+  },
+
+  handler: async ({ name, initial_balance = 1 }) => {
+    const client = getHederaClient();
+    const operatorId = getOperatorId();
+
+    // Generate new ECDSA key pair
+    const privateKey = PrivateKey.generateECDSA();
+    const publicKey = privateKey.publicKey;
+
+    // EVM Address (alias)
+    const evmAddress = publicKey.toEvmAddress();
+
+    try {
+      // Auto-create account by transferring HBAR
+      const transferTx = new TransferTransaction()
+        .addHbarTransfer(operatorId, new Hbar(-initial_balance))
+        .addHbarTransfer(evmAddress, new Hbar(initial_balance));
+
+      const response = await transferTx.execute(client);
+      await response.getReceipt(client);
+
+      // Retry logic for Mirror Node indexing delay
+      const mirrorUrl = getMirrorNodeUrl();
+      let newAccountId = null;
+
+      for (let attempt = 1; attempt <= 5; attempt++) {
+        // Wait before checking (increasing delay)
+        await new Promise(resolve => setTimeout(resolve, attempt * 2000));
+
+        // Use EVM address for lookup (more reliable than public key)
+        const mirrorResponse = await fetch(
+          `${mirrorUrl}/api/v1/accounts/0x${evmAddress}`
+        );
+
+        if (mirrorResponse.ok) {
+          const mirrorData = await mirrorResponse.json();
+          newAccountId = mirrorData.account;
+          if (newAccountId) break;
+        }
+      }
+
+      if (!newAccountId) {
+        // Account created but ID not yet indexed - still return useful info
+        const network = process.env.HEDERA_NETWORK || 'testnet';
+        return {
+          success: true,
+          partial: true,
+          identity: {
+            did: `did:hedera:${network}:${evmAddress}`,
+            account_id: null,
+            evm_address: evmAddress,
+            public_key: publicKey.toStringRaw(),
+            name: name || null
+          },
+          credentials: {
+            private_key: privateKey.toStringRaw(),
+            private_key_der: privateKey.toStringDer(),
+            warning: 'この秘密鍵は安全に保管してください。再発行できません。'
+          },
+          balance: `${initial_balance} HBAR`,
+          message: 'アカウント作成成功。Account IDは数分後にHashScanで確認できます。',
+          hashscan_url: `https://hashscan.io/${network}/account/${evmAddress}`
+        };
+      }
+
+      // DID format
+      const network = process.env.HEDERA_NETWORK || 'testnet';
+      const did = `did:hedera:${network}:${newAccountId}`;
+
+      return {
+        success: true,
+        identity: {
+          did,
+          account_id: newAccountId,
+          evm_address: evmAddress,
+          public_key: publicKey.toStringRaw(),
+          name: name || null
+        },
+        credentials: {
+          private_key: privateKey.toStringRaw(),
+          private_key_der: privateKey.toStringDer(),
+          warning: 'この秘密鍵は安全に保管してください。再発行できません。'
+        },
+        balance: `${initial_balance} HBAR`,
+        message: '信頼IDが作成されました。inscribe 時に author として使用できます。'
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: `ID作成エラー: ${error.message}`
+      };
+    }
+  }
+};

package/src/tools/layer1/inscribe.js

@@ -0,0 +1,132 @@
+/**
+ * inscribe - Text Inscription Tool
+ *
+ * Inscribe any text content to blockchain with timestamp proof.
+ */
+
+import { createHash } from 'crypto';
+import { TopicMessageSubmitTransaction } from '@hashgraph/sdk';
+import { getHederaClient, getOrCreateTopicId, getNetwork, getOperatorId, hasTopicId } from '../../lib/hedera.js';
+import { normalizeDid } from '../../lib/did.js';
+import { logToolExecution, createTimer } from '../../lib/logger.js';
+
+export const inscribeTool = {
+  name: 'inscribe',
+  description: '内容を刻む（存在証明・タイムスタンプ）。ブロックチェーンに永続的に記録される。',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      content: {
+        type: 'string',
+        description: '刻む内容（テキスト、ハッシュ、JSON など）'
+      },
+      type: {
+        type: 'string',
+        description: '種類（article, log, decision, contract, prediction など）',
+        default: 'general'
+      },
+      author: {
+        type: 'string',
+        description: '著者ID（DID形式、省略可）'
+      },
+      metadata: {
+        type: 'object',
+        description: '追加メタデータ（省略可）'
+      }
+    },
+    required: ['content']
+  },
+
+  handler: async ({ content, type = 'general', author, metadata }) => {
+    const timer = createTimer();
+    const client = getHederaClient();
+    const network = getNetwork();
+    const operator = getOperatorId().toString();
+
+    // Check if topic needs to be created
+    const topicWasCreated = !hasTopicId();
+
+    try {
+      // Get or create topic
+      const topicId = await getOrCreateTopicId();
+
+      // Log topic creation if it was just created
+      if (topicWasCreated) {
+        logToolExecution({
+          command: 'topic_create',
+          network,
+          topicId: topicId.toString(),
+          operator,
+          status: 'success',
+          latency: 0,
+          metadata: { autoCreated: true }
+        });
+      }
+      // Generate content hash
+      const contentHash = createHash('sha256').update(content).digest('hex');
+
+      // Normalize author DID to standard format
+      const normalizedAuthor = await normalizeDid(author);
+
+      // Build inscription data
+      const inscription = {
+        version: '1.0',
+        type,
+        content_hash: contentHash,
+        content_preview: content.substring(0, 100) + (content.length > 100 ? '...' : ''),
+        content_full: content,
+        author: normalizedAuthor,
+        metadata: metadata || {},
+        inscribed_at: new Date().toISOString()
+      };
+
+      // Submit to HCS
+      const transaction = new TopicMessageSubmitTransaction()
+        .setTopicId(topicId)
+        .setMessage(JSON.stringify(inscription));
+
+      const response = await transaction.execute(client);
+      const record = await response.getRecord(client);
+      const timestamp = record.consensusTimestamp.toString();
+      const inscriptionId = `${topicId}-${timestamp}`;
+
+      // Log success
+      logToolExecution({
+        command: 'inscribe',
+        network,
+        topicId: topicId.toString(),
+        operator,
+        status: 'success',
+        latency: timer(),
+        txId: inscriptionId,
+        metadata: { type, contentLength: content.length }
+      });
+
+      return {
+        success: true,
+        inscription_id: inscriptionId,
+        content_hash: contentHash,
+        timestamp,
+        type,
+        verify_url: `https://hashscan.io/${network}/topic/${topicId}`,
+        message: '正常に刻まれました。この記録は改ざん不可能です。'
+      };
+
+    } catch (error) {
+      // Log error
+      logToolExecution({
+        command: 'inscribe',
+        network,
+        operator,
+        status: 'error',
+        latency: timer(),
+        error: error.message
+      });
+
+      return {
+        success: false,
+        error: error.message
+      };
+    }
+  }
+};

package/src/tools/layer1/inscribe_url.js

@@ -0,0 +1,193 @@
+/**
+ * inscribe_url - URL Inscription Tool (Killer Feature)
+ *
+ * Inscribe any URL content to blockchain.
+ * Supports automatic content fetching from X/Twitter, YouTube, etc.
+ */
+
+import { createHash } from 'crypto';
+import { TopicMessageSubmitTransaction } from '@hashgraph/sdk';
+import { getHederaClient, getTopicId, getMirrorNodeUrl } from '../../lib/hedera.js';
+
+export const inscribeUrlTool = {
+  name: 'inscribe_url',
+  description: 'URLの内容を刻む。SNS投稿、ブログ記事、GitHub Issue など。自動取得できない場合は content で手動指定（目撃証言として記録）。',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: {
+        type: 'string',
+        description: '刻みたいURL（X/Twitter, YouTube, ブログなど）'
+      },
+      content: {
+        type: 'string',
+        description: '内容（自動取得できない場合、または目撃証言として手動指定）'
+      },
+      note: {
+        type: 'string',
+        description: '追加メモ（なぜ刻むのか、文脈など）'
+      }
+    },
+    required: ['url']
+  },
+
+  handler: async ({ url, content, note }) => {
+    const client = getHederaClient();
+    const topicId = getTopicId();
+
+    let fetchedContent = null;
+    let authorName = null;
+    const platform = detectPlatform(url);
+    let source = 'manual';
+
+    // Platform-specific content fetching
+    if (!content) {
+      if (platform === 'x') {
+        const result = await fetchFromX(url);
+        if (result) {
+          fetchedContent = result.content;
+          authorName = result.author;
+          source = 'oembed';
+        }
+      } else if (platform === 'youtube') {
+        const result = await fetchFromYouTube(url);
+        if (result) {
+          fetchedContent = result.content;
+          authorName = result.author;
+          source = 'oembed';
+        }
+      }
+    }
+
+    // Determine final content
+    const finalContent = content || fetchedContent;
+
+    if (!finalContent) {
+      const platformHints = {
+        x: 'ツイートの本文をコピーして content に渡してください',
+        youtube: '動画タイトルをコピーして content に渡してください',
+        github: 'Issue/PRのタイトルや内容をコピーして content に渡してください',
+        web: 'ページの重要な部分をコピーして content に渡してください'
+      };
+
+      return {
+        success: false,
+        error: '内容を自動取得できませんでした',
+        url,
+        platform,
+        hint: platformHints[platform] || platformHints.web,
+        example: `inscribe_url({ url: "${url}", content: "ここに内容を貼り付け" })`,
+        note: '手動で指定した内容は「目撃証言」として記録されます。自動取得と同じく改ざん不可能な証拠になります。'
+      };
+    }
+
+    // Generate hashes
+    const contentHash = createHash('sha256').update(finalContent).digest('hex');
+    const urlHash = createHash('sha256').update(url).digest('hex');
+
+    // Build inscription data
+    const inscription = {
+      version: '1.0',
+      type: 'url_capture',
+      platform,
+      source,
+      url,
+      url_hash: urlHash,
+      author: authorName,
+      content: finalContent,
+      content_hash: contentHash,
+      note: note || null,
+      captured_at: new Date().toISOString()
+    };
+
+    // Submit to HCS
+    const transaction = new TopicMessageSubmitTransaction()
+      .setTopicId(topicId)
+      .setMessage(JSON.stringify(inscription));
+
+    const response = await transaction.execute(client);
+    const record = await response.getRecord(client);
+    const timestamp = record.consensusTimestamp.toString();
+    const inscriptionId = `${topicId}-${timestamp}`;
+
+    const network = process.env.HEDERA_NETWORK || 'testnet';
+
+    return {
+      success: true,
+      inscription_id: inscriptionId,
+      capture: {
+        url,
+        platform,
+        source,
+        author: authorName,
+        content_preview: finalContent.substring(0, 200) + (finalContent.length > 200 ? '...' : ''),
+        content_hash: contentHash
+      },
+      timestamp,
+      verify_url: `https://hashscan.io/${network}/topic/${topicId}`,
+      message: source === 'oembed'
+        ? 'この投稿が存在した証拠を自動取得して刻みました'
+        : 'あなたの目撃証言として刻みました'
+    };
+  }
+};
+
+/**
+ * Detect platform from URL
+ */
+function detectPlatform(url) {
+  if (url.includes('x.com') || url.includes('twitter.com')) return 'x';
+  if (url.includes('youtube.com') || url.includes('youtu.be')) return 'youtube';
+  if (url.includes('github.com')) return 'github';
+  if (url.includes('note.com')) return 'note';
+  if (url.includes('zenn.dev')) return 'zenn';
+  if (url.includes('qiita.com')) return 'qiita';
+  return 'web';
+}
+
+/**
+ * Fetch content from X/Twitter using oEmbed
+ */
+async function fetchFromX(url) {
+  try {
+    const oembedUrl = `https://publish.twitter.com/oembed?url=${encodeURIComponent(url)}`;
+    const response = await fetch(oembedUrl);
+    if (!response.ok) return null;
+
+    const data = await response.json();
+
+    // Extract text from HTML
+    const htmlContent = data.html || '';
+    const textMatch = htmlContent.match(/<p[^>]*>([\s\S]*?)<\/p>/);
+    const content = textMatch
+      ? textMatch[1].replace(/<[^>]*>/g, '').replace(/&mdash;/g, '—').replace(/&amp;/g, '&').trim()
+      : null;
+
+    return content ? {
+      content,
+      author: data.author_name
+    } : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Fetch content from YouTube using oEmbed
+ */
+async function fetchFromYouTube(url) {
+  try {
+    const oembedUrl = `https://www.youtube.com/oembed?url=${encodeURIComponent(url)}&format=json`;
+    const response = await fetch(oembedUrl);
+    if (!response.ok) return null;
+
+    const data = await response.json();
+
+    return {
+      content: data.title,
+      author: data.author_name
+    };
+  } catch {
+    return null;
+  }
+}

package/src/tools/layer1/verify.js

@@ -0,0 +1,177 @@
+/**
+ * verify - Inscription Verification Tool
+ *
+ * Verify that inscribed content has not been tampered with.
+ */
+
+import { createHash } from 'crypto';
+import { getMirrorNodeUrl, getNetwork, getOperatorId } from '../../lib/hedera.js';
+import { logToolExecution, createTimer } from '../../lib/logger.js';
+
+export const verifyTool = {
+  name: 'verify',
+  description: '刻まれた内容を検証する。内容が改ざんされていないか確認。',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      inscription_id: {
+        type: 'string',
+        description: '検証する inscription ID (例: 0.0.7503789-1703412000.123456789)'
+      },
+      content: {
+        type: 'string',
+        description: '検証したい元の内容（オプション：ハッシュ照合用）'
+      }
+    },
+    required: ['inscription_id']
+  },
+
+  handler: async ({ inscription_id, content }) => {
+    const timer = createTimer();
+    const network = getNetwork();
+    const operator = getOperatorId().toString();
+
+    // Parse inscription_id to extract topic and timestamp
+    // Format: "0.0.XXXXX-TIMESTAMP.NANOS"
+    const parts = inscription_id.split('-');
+    if (parts.length < 2) {
+      logToolExecution({
+        command: 'verify',
+        network,
+        operator,
+        status: 'error',
+        latency: timer(),
+        error: '無効な inscription_id 形式'
+      });
+      return {
+        valid: false,
+        error: '無効な inscription_id 形式です',
+        inscription_id
+      };
+    }
+
+    const topicId = parts[0]; // "0.0.XXXXX"
+    const timestamp = parts.slice(1).join('-'); // "TIMESTAMP.NANOS"
+
+    // Fetch from Mirror Node
+    const mirrorUrl = getMirrorNodeUrl();
+    const apiUrl = `${mirrorUrl}/api/v1/topics/${topicId}/messages?timestamp=${timestamp}&limit=1`;
+
+    try {
+      const response = await fetch(apiUrl);
+      if (!response.ok) {
+        logToolExecution({
+          command: 'verify',
+          network,
+          topicId,
+          operator,
+          status: 'error',
+          latency: timer(),
+          error: 'Mirror Node fetch failed'
+        });
+        return {
+          valid: false,
+          error: 'Mirror Node からの取得に失敗しました',
+          inscription_id
+        };
+      }
+
+      const data = await response.json();
+
+      if (!data.messages || data.messages.length === 0) {
+        logToolExecution({
+          command: 'verify',
+          network,
+          topicId,
+          operator,
+          status: 'error',
+          latency: timer(),
+          error: 'Record not found'
+        });
+        return {
+          valid: false,
+          error: '記録が見つかりません',
+          inscription_id
+        };
+      }
+
+      const message = data.messages[0];
+      let inscriptionData;
+
+      try {
+        inscriptionData = JSON.parse(
+          Buffer.from(message.message, 'base64').toString('utf-8')
+        );
+      } catch {
+        logToolExecution({
+          command: 'verify',
+          network,
+          topicId,
+          operator,
+          status: 'error',
+          latency: timer(),
+          error: 'JSON parse failed'
+        });
+        return {
+          valid: false,
+          error: '記録データの解析に失敗しました（JSON形式ではない可能性）',
+          inscription_id
+        };
+      }
+
+      // Content verification (if provided)
+      let contentMatch = null;
+      if (content) {
+        const providedHash = createHash('sha256').update(content).digest('hex');
+        contentMatch = providedHash === inscriptionData.content_hash;
+      }
+
+      // Log success
+      logToolExecution({
+        command: 'verify',
+        network,
+        topicId,
+        operator,
+        status: 'success',
+        latency: timer(),
+        txId: inscription_id,
+        metadata: { contentMatch }
+      });
+
+      return {
+        valid: true,
+        inscription_id,
+        inscribed_at: inscriptionData.inscribed_at || inscriptionData.captured_at,
+        consensus_timestamp: message.consensus_timestamp,
+        type: inscriptionData.type,
+        content_hash: inscriptionData.content_hash,
+        content_preview: inscriptionData.content_preview || inscriptionData.content?.substring(0, 100),
+        author: inscriptionData.author,
+        platform: inscriptionData.platform || null,
+        source: inscriptionData.source || null,
+        content_match: contentMatch,
+        verify_url: `https://hashscan.io/${network}/topic/${topicId}`,
+        message: contentMatch === true
+          ? '内容が一致しました。改ざんされていません。'
+          : contentMatch === false
+            ? '警告: 内容が一致しません。改ざんの可能性があります。'
+            : '記録が見つかりました。'
+      };
+    } catch (error) {
+      logToolExecution({
+        command: 'verify',
+        network,
+        topicId,
+        operator,
+        status: 'error',
+        latency: timer(),
+        error: error.message
+      });
+      return {
+        valid: false,
+        error: `検証エラー: ${error.message}`,
+        inscription_id
+      };
+    }
+  }
+};