プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Sigvara

作者:RunTimeAdminバージョン 1.0.0-alpha.22i★ 1 (リポジトリ全体のスター)iパソコンで動く公式サイト ↗
レジストリ名io.github.RunTimeAdmin/sigvara

インストール方法

What it does

Read-only checks of an AI agent's Sigvara standing, score, stake and slashes before you rely on it.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気20/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア32/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Sigvara をインストールして。https://mcp.popnx.com/i/runtimeadmin-sigvara.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Sigvara を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "sigvara": { "command": "npx", "args": [ "-y", "@sigvara/protocol-sdk" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sigvara のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "sigvara": {
          "command": "npx",
          "args": [
            "-y",
            "@sigvara/protocol-sdk"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Sigvara を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Sigvara を使っていると言うか、回答に Sigvara のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Sigvara につなげません

Sigvara はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Sigvara につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Sigvara を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user sigvara -- npx -y @sigvara/protocol-sdk 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sigvara のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user sigvara -- npx -y @sigvara/protocol-sdk
  4. Claude Code で /mcp と入力

    Sigvara が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Sigvara を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Sigvara を使っていると言うか、回答に Sigvara のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Sigvara を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "sigvara": { "command": "npx", "args": [ "-y", "@sigvara/protocol-sdk" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sigvara のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Sigvara を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Sigvara を使っていると言うか、回答に Sigvara のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Sigvara を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "sigvara": { "type": "stdio", "command": "npx", "args": [ "-y", "@sigvara/protocol-sdk" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Sigvara のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Sigvara を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Sigvara を使っていると言うか、回答に Sigvara のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Sigvara を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user sigvara -- npx -y @sigvara/protocol-sdk

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "sigvara": {
      "command": "npx",
      "args": [
        "-y",
        "@sigvara/protocol-sdk"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "sigvara": {
      "command": "npx",
      "args": [
        "-y",
        "@sigvara/protocol-sdk"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "sigvara": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sigvara/protocol-sdk"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
1 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
744/週
接続方法
パソコンで動く
最新バージョンi
1.0.0-alpha.22
カテゴリi
その他
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月18日
作者
RunTimeAdmin
パッケージ
npm: @sigvara/protocol-sdk
ウェブサイト
sigvara.xyz
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント RunTimeAdmin で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/runtimeadmin-sigvara.svg)](https://mcp.popnx.com/en/servers/runtimeadmin-sigvara)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20815件のうち0%よりスターが多い
  • このカテゴリのほかの20815件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20815件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Sigvaraは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.0.0-alpha.22)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582414 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Sigvara
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@sigvara/protocol-sdk

TypeScript SDK for the Sigvara protocol: on-chain agent identity, computed reputation, staked accountability, and Ed25519 challenge-response authentication between agents. Successor to @countersig/protocol-sdk.

npm install @sigvara/protocol-sdk

Runtime dependencies are ethers v6 and tweetnacl. Node 18 or newer.

Use 1.0.0-alpha.12 or later. On 1.0.0-alpha.9 and earlier an agent object carries its secret key in an ordinary property, so JSON.stringify(agent) or logging one includes it; never log or serialize an agent from those versions. If one was logged, serialized or sent to an error reporter, treat its key as exposed and rotate it (Key Rotation).

Upgrading from 1.0.0-alpha.11: agent.signChallenge is removed. It signed whatever it was

handed, so a verifier could get an agent to sign a challenge naming a different verifier and

present the signature there as the agent. A call does not compile in TypeScript, and in JavaScript

it throws an error that names signChallengeFor(payload, audience), which signs only a challenge

addressed to the audience you pass and works from 1.0.0-alpha.10. The exported function

signChallenge(payload, secretKey) is unchanged. Details in CHANGELOG.md.

Upgrading from 1.0.0-alpha.10: verifySignature now requires the audience, as its fifth

argument. Leaving it out used to compile and skip the check of who the agent had signed for, so a

response given to one verifier was accepted at another, and a v1 payload was accepted too. It now

does not compile in TypeScript, throws expectedAudience is required in JavaScript, and a v1 payload

is always refused. A caller that already passes the audience needs no change. Details in

CHANGELOG.md.

Upgrading from 1.0.0-alpha.9: the secret key is now a private field, so code that read it by

reaching around the type system stops working; sign with signChallengeFor. It signs only a

challenge addressed to the audience you pass, where signChallenge signed whatever it was handed

and is removed in 1.0.0-alpha.12. A gate now also checks the bond held now, so an agent

admitted at an old minimum stake and not topped up is refused as not_active. It refuses to be

built with a threshold or ttlSeconds that is not a usable number, refuses a challenge dated

more than 60 seconds ahead, and gives up on a chain read after 30 seconds (timeoutMs). The

optional maxScoreAgeSeconds refuses a score nobody has refreshed. Details in

CHANGELOG.md.

Upgrading from 1.0.0-alpha.7: generateChallenge now takes an audience as its

second argument, and every existing call site needs it.

`diff

- const challenge = generateChallenge(agentDid);

+ const challenge = generateChallenge(agentDid, 'https://your-service.example');

`

Without it, a verifier holding a valid response could present that same response to a

different verifier and be accepted as the agent. Pass the same audience to

verifySignature as its fifth argument; on 1.0.0-alpha.10 and earlier, omitting it still

compiles and still accepts the relayable older proofs. Full detail in CHANGELOG.md.

This does not make you replay-proof. The audience stops a response being reused at

a *different* verifier. Reuse at *yours* is stopped by remembering the nonce, and the

SDK cannot do that for you — see

What the SDK still needs from you.

What it does

  • Agent identity. Generate an Ed25519 keypair, derive the agent's did:sigvara: : and its on-chain didHash, and register the agent from the operator wallet, with a proof of control signed by the agent address.
  • Agent-to-agent auth. Issue a challenge to a peer, sign one with the agent's key, and verify a signature against the public key stored on chain.
  • Reads. Identity, status, six-factor reputation, meetsThreshold, stake and minimum-stake checks, and a W3C DID Document built from chain state.
  • Stake. depositStake handles the ERC-20 approval and the deposit in one call, and is what moves a newly registered agent from PendingBond to Active.
  • A gate. SigvaraGate turns the reads above into one decision: issue a challenge, admit or refuse, and say which reason applies. It owns the nonce, so replay protection is not left to the caller.
  • A check before paying or hiring. SigvaraTrustCheck asks the gate's question about a bare address. sigvaraX402Fetch puts it in front of an x402 payment, and sigvaraTrustTool and requireTrustedAgent put it in an agent framework's tools.
  • Payment outcomes. After paying an agent, sign whether the work was delivered (signPaymentOutcome), so the oracle can count it without a token, and check such a signature the way the oracle does (verifyPaymentOutcome).

Scores come in two forms. The earned score is what the oracle last finalized; the total score is the matured one, which climbs toward it over time and is what meetsThreshold checks. A newly bonded agent has earned a score before it can spend it.

Quick start

import { SigvaraAgent, SigvaraVerifier, registerAgent, depositStake, generateChallenge } from '@sigvara/protocol-sdk';

import { ethers } from 'ethers';

const RPC = 'https://rpc.testnet.arc.io'; const CHAIN_ID = 5042002; // Arc testnet const addresses = { identity: '0x…', reputation: '0x…', staking: '0x…' }; // deployments/5042002.json

// Operator side: create, register and bond an agent const { agent, privateKey } = SigvaraAgent.generate({ agentAddress: '0xAgent…', chainId: CHAIN_ID }); const operator = new ethers.Wallet(process.env.OPERATOR_KEY!, new ethers.JsonRpcProvider(RPC));

// The agent address must prove control of itself. Pass a signer for it, or // { signature } if it was signed elsewhere (HSM, Safe, any ERC-1271 contract). const agentSigner = new ethers.Wallet(process.env.AGENT_KEY!); // a signer for agent.agentAddress await registerAgent(operator, agent.agentAddress, agent.publicKeyBytes32, addresses.identity, { agentSigner });

// Registration leaves the agent PendingBond. This deposit is what activates it. await depositStake(operator, agent.didHash, 1000n * 10n ** 18n, addresses.staking);

// Counterparty side: challenge the agent, verify the signature, read status and score const verifier = new SigvaraVerifier({ rpcUrl: RPC, addresses, chainId: CHAIN_ID }); // The second argument is the audience: who is asking. Pass a stable identifier you // control, normally your own origin. It is signed, so the agent's response proves it was // talking to *you* and cannot be relayed onward by anyone who receives it. const challenge = generateChallenge(agent.did, 'https://your-service.example'); // Done by the agent, returned to the counterparty. signChallengeFor refuses a challenge that is not // addressed to the verifier the agent means to prove itself to, which is what stops a verifier from // collecting a signature meant for someone else. const signature = agent.signChallengeFor(challenge.payload, 'https://your-service.example');

// Pass the same audience back when verifying. It is required: verifySignature throws without // it, and it refuses a v1 payload, which names no audience to check. const ok = await verifier.verifySignature( agent.did, challenge.payload, signature, 300, 'https://your-service.example', ); const trusted = ok && (await verifier.isActive(agent.did)) && (await verifier.meetsThreshold(agent.did, 40));

The 40 in these examples is a placeholder. A score below roughly 60 says little on its own, so read what a fake score costs before you pick a number, and sigvara.xyz/status for how the scores spread today.

Signature validity, status and score are separate reads. Combining them correctly is easy to get subtly wrong, so there is a piece that does it.

Refusing work: SigvaraGate

import { SigvaraGate } from '@sigvara/protocol-sdk';

const gate = new SigvaraGate({ rpcUrl: RPC, addresses, chainId: CHAIN_ID, threshold: 40, audience: 'https://your-service.example', // required, and signed into every challenge });

// 1. hand the challenge to the agent const challenge = gate.challenge(agentDid);

// 2. the agent signs challenge.payload and returns the signature

// 3. decide const result = await gate.admit(agentDid, challenge, signature); if (!result.ok) { // 'bad_proof' | 'replayed' | 'not_active' | 'below_bond' | 'stale_score' | 'below_threshold' return refuse(result.reason); }

The reasons are separate because they need different responses. bad_proof means nothing was proven. replayed means a valid signature arrived twice. not_active means a real, proven agent that is unbonded, suspended or slashed, and telling that caller to earn more points would be wrong. "Unbonded" is the bond held now against the minimum stake in force now, not the status stored when the agent was admitted: a minimum raised since leaves an agent marked Active while it holds less than the contract asks, and the gate reads the bond for that reason. below_bond appears only if you set minBond, and stale_score only if you set maxScoreAgeSeconds. Only below_threshold is about reputation, and it carries the score so you can say how short they were.

A score nobody has refreshed. Nothing on chain ages a score, so one left over from an oracle outage keeps passing a threshold. Set maxScoreAgeSeconds to refuse a score written longer ago than that, or never, with stale_score. A healthy score gets to about two of your oracle's proposals apart before the next one lands (about 20 hours on Arc testnet, where an unchanged score is proposed again every 12 hours, two days on a daily epoch), so choose more than that. It is measured against your host's clock. Unset, a score is trusted however old it is. It costs one more read per admission. The same check exists on chain as SigvaraReader.isTrustedFresh, on Arc testnet at 0x2921b4eE879CdF5793FA273BbDc4E7dF01ABcef8.

More at stake than the minimum covers. Set minBond to refuse an agent holding less, with below_bond, whatever its score (from 1.0.0-alpha.16). It is in the bond token's base units, as a bigint or a string of digits. A number is refused, because a floor past what a double can hold would quietly become another floor. A floor under the protocol's minimum still needs the minimum, and an amount queued for withdrawal does not count. It compares the same number as SigvaraReader.isTrusted(agent, minScore, minBond), and costs one more read per admission.

The constructor refuses a threshold that is not a finite number of 0 or more, and a ttlSeconds or maxScoreAgeSeconds that is not a positive number. A NaN threshold, for example Number(process.env.THRESHOLD) with the variable unset, would otherwise admit every active agent that can prove its key, whatever its score.

A gate that has to say how it runs. Two of the defaults suit a test bench and not a deployment, and both fail open by being left out: instances defaults to one process, and no maxScoreAgeSeconds means no age limit. profile: 'production' (from 1.0.0-alpha.14) makes the constructor refuse to build the gate until both are set, and names everything missing in one error:

const gate = new SigvaraGate({

rpcUrl: RPC, addresses, chainId: CHAIN_ID, threshold: 40, audience: 'https://your-service.example', profile: 'production', instances: 'multiple', // or 'single' if exactly one process serves this gate nonceStore, // shared and atomic, required with 'multiple' (see below) maxScoreAgeSeconds: 86_400, // more than two of your oracle's

冒頭だけを表示しています。続きはリポジトリで読めます