erc8004

ERC-8004 スキル

ERC-8004 のオンチェーンエージェント ID を一元管理するスキルです。エージェント ID の登録、ID 情報の取得、評判スコアの照会、フィードバックの送信、第三者による検証のリクエストまたは状態確認を行えます。読み取り操作にウォレットは不要です。書き込み操作にはロック解除済みのウォレットが必要です。

使用方法

bun run erc8004/erc8004.ts <subcommand> [options]

サブコマンド

register

ERC-8004 ID レジストリを使用して、新しいエージェント ID をオンチェーンに登録します。トランザクション ID が返されます。割り当てられたエージェント ID を取得するには、トランザクションの結果を確認してください。ロック解除済みのウォレットが必要です。

bun run erc8004/erc8004.ts register [--uri <uri>] [--metadata <json>] [--fee <fee>] [--sponsored]

オプション：

• --uri （任意）— エージェントのメタデータを指す URI（IPFS、HTTP など）
• --metadata （任意）— {"key": "...", "value": "<hex>"} ペアの JSON 配列（値は 16 進数でエンコードされたバッファーです）
• --fee （任意）— 手数料のプリセット（low、medium、high）または micro-STX の金額
• --sponsored （フラグ）— スポンサー付きトランザクションとして送信します

出力：

{
  "success": true,
  "txid": "0xabc...",
  "message": "Identity registration transaction submitted. Check transaction result to get your agent ID.",
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/0xabc..."
}

get-identity

ERC-8004 ID レジストリからエージェント ID の情報を取得します。所有者のアドレス、URI、設定されている場合はウォレットが返されます。ウォレットは不要です。

bun run erc8004/erc8004.ts get-identity <address>

引数：

• <address> （必須）— 照会するエージェント ID（0 以上の整数）

出力：

{
  "success": true,
  "agentId": 42,
  "owner": "SP1...",
  "uri": "ipfs://...",
  "wallet": "SP2...",
  "network": "mainnet"
}

get-reputation

エージェントの集計済み評判スコアを取得します。フィードバックの合計数と、WAD で平均化された概要値が返されます。ウォレットは不要です。

bun run erc8004/erc8004.ts get-reputation <address>

引数：

• <address> （必須）— 照会するエージェント ID（0 以上の整数）

出力：

{
  "success": true,
  "agentId": 42,
  "totalFeedback": 10,
  "summaryValue": 85,
  "summaryValueDecimals": 0,
  "network": "mainnet"
}

give-feedback

ERC-8004 評判レジストリで、エージェントにフィードバックを送信します。値は符号付き整数です。ロック解除済みのウォレットが必要です。

bun run erc8004/erc8004.ts give-feedback <address> <score> <comment> [--fee <fee>] [--sponsored]

引数：

• <address> （必須）— フィードバックを送信するエージェント ID（0 以上の整数）
• <score> （必須）— フィードバック値（符号付き整数。例：肯定的な評価は 5、否定的な評価は -2）
• <comment> （必須）— フィードバックのコメントまたはタグ（tag1 として使用されます）

オプション：

• --fee （任意）— 手数料のプリセット（low、medium、high）または micro-STX の金額
• --sponsored （フラグ）— スポンサー付きトランザクションとして送信します

出力：

{
  "success": true,
  "txid": "0xdef...",
  "message": "Feedback submitted for agent 42.",
  "agentId": 42,
  "value": 5,
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/0xdef..."
}

request-validation

検証者にエージェントの第三者検証をリクエストします。ロック解除済みのウォレットが必要です。

bun run erc8004/erc8004.ts request-validation <address> --validator <validator-address> --request-uri <uri> --request-hash <hex> [--fee <fee>] [--sponsored]

引数：

• <address> （必須）— 検証をリクエストするエージェント ID（0 以上の整数）

オプション：

• --validator （必須）— 検証者の Stacks アドレス
• --request-uri （必須）— 検証リクエストデータを指す URI
• --request-hash （必須）— リクエストデータの 32 バイト SHA-256 ハッシュを 16 進数文字列で指定します
• --fee （任意）— 手数料のプリセット（low、medium、high）または micro-STX の金額
• --sponsored （フラグ）— スポンサー付きトランザクションとして送信します

出力：

{
  "success": true,
  "txid": "0xghi...",
  "message": "Validation requested from SP3... for agent 42.",
  "validator": "SP3...",
  "agentId": 42,
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/0xghi..."
}

validation-status

32 バイトのリクエストハッシュを指定して、検証リクエストの状態を確認します。ウォレットは不要です。

bun run erc8004/erc8004.ts validation-status <request-id>

引数：

• <request-id> （必須）— 検証リクエストの 32 バイト SHA-256 ハッシュを 16 進数文字列で指定します

出力：

{
  "success": true,
  "requestHash": "abc123...",
  "validator": "SP3...",
  "agentId": 42,
  "response": 90,
  "hasResponse": true,
  "tag": "trusted",
  "lastUpdate": 12345,
  "network": "mainnet"
}

注意事項

• 読み取り操作（get-identity、get-reputation、validation-status）にウォレットは不要です
• 書き込み操作（register、give-feedback、request-validation）にはロック解除済みのウォレット（bun run wallet/wallet.ts unlock）が必要です
• エージェント ID は登録時にコントラクトによって割り当てられます。割り当てられた ID を確認するには、トランザクションの結果を確認してください
• フィードバック値は符号付き整数です。正の値は評判を高め、負の値は評判を下げます
• 検証レスポンスは、指定された検証者が送信する 0 から 100 までのスコアです