fairdraw

fairdraw

誰も結果をうのみにする必要のない抽選です。fairdraw は、公開されている drand の乱数ビーコンから当選者を選びます。当選者の名前は、公開された drand ラウンドの乱数と応募者リストのみから決まるため、抽選後は誰でも手作業で順位を再計算し、発表された当選者がビーコンによって実際に選ばれた人であることを確認できます。

結果の決定方法：

1. 応募者リストから重複を削除し、並べ替えます。
2. 各応募者のスコアを sha256(randomness + "|" + entrant)（16 進ダイジェスト）で計算します。
3. スコアの低い順に応募者を順位付けします。スコアが最も低い人から、順位順に当選します。

3 つのツール：

• pick_winner_now — 最新の drand ラウンドを使ってすぐに抽選し、当選者（または複数の当選者）を直ちに取得します。結果にはラウンド番号と乱数の冒頭部分が含まれるため、抽選結果を再確認できます。
• create_scheduled_draw — 将来の公開に向けて抽選を確定します。抽選を作成した瞬間に、チェーンのタイミングに基づいて drand ラウンドが確定します。対象となるのは、乱数が now + delay_sec 以降に利用可能になる最初のラウンドです。応答には抽選 ID が含まれます。
• verify_draw — ID でスケジュール済み抽選を検索します。ラウンドがまだ公開されていない間は、確定済みのラウンドを示す保留メッセージが返されます。ラウンドが公開されると、そのラウンドの乱数から再計算した当選者が、検証済みとして返されます。

スケジュール済み抽選はサーバープロセスのメモリに保存されます。プロセスが実行中の間だけ存在し、抽選 ID は作成したプロセス内でのみ有効です。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドです。

npx @reneturcios/fairdraw pick_winner_now '{"entrants":["alice","bob","carol"],"winners":2}'
npx @reneturcios/fairdraw create_scheduled_draw '{"title":"Spring raffle","entrants":["alice","bob"],"delay_sec":3600}'
npx @reneturcios/fairdraw verify_draw '{"id":"<draw id>"}'
npx @reneturcios/fairdraw --version

出力はツールの結果テキストです。終了コード：成功時は 0、実行時エラー（検証エラーや drand の失敗を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/fairdraw mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "fairdraw": {
      "command": "npx",
      "args": ["-y", "@reneturcios/fairdraw", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/fairdraw
docker run --rm ghcr.io/cloudcorprecords/fairdraw pick_winner_now '{"entrants":["alice","bob"]}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake clock, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios