アーキテクチャ
GenKaKu が本番で動かしているものは、静的サイトかピアのプロセスのどちらかです。リクエスト経路に GenKaKu のサーバーはありません。
パッケージ
| パッケージ | 役割 |
|---|---|
@genkaku/protocol | Solana バインディング、エスクロー課金、libp2p サイドカー、Ollama ブリッジ |
@genkaku/dsh-runtime | 両方のプラグインが共有するアダプター |
@genkaku/dsh-worker-plugin@0.5.0-rc.8 | ローカルモデルを提供する |
@genkaku/dsh-user-plugin@0.5.0-rc.8 | ネットワークのモデルを利用する |
@genkaku/seed | libp2p リレーとピア発見サービス |
@genkaku/admin | シードホスト用の運営コンソール |
プロトコルの中核は DeepSeek Harness に依存しません。これは意図的です。別のアダプターがそれに手を入れる必要はないはずです。
オンチェーン
1 つのプログラムが、Solana mainnet-beta と Solana devnet の同じアドレスにデプロイされています。アドレスはウェブサイトとプラグインの netconfig.ts で公開されています。デプロイが実行されるまで、サイトのビルドはプログラム id を宣伝することを拒否します。
| アカウント | Seeds | 保持する内容 |
|---|---|---|
| RegistryConfig | ["registry"] | owner、pending owner、これまでに登録されたワーカー数 |
| Worker | ["worker", wallet] | peer id、レート、ロケーター、active、earned、settlements |
| EscrowConfig | ["escrow"] | owner、財務、guardian、vault、USDC mint、セッション上限、次のセッション id、財務への積み上げ |
| Session | ["session", id] | 利用者、ワーカー、価格、デポジット、積み上げ、分、タイムスタンプ、状態 |
エスクローの USDC は ["escrow"] PDA の関連トークンアカウントに置かれます。プログラムは転送のたびにそのアカウントの mint と owner を検査し、オンチェーンでアドレスを導出することはしません。トークンプログラムがすでに両フィールドの権威であり、バイナリはデプロイ可能な 1 回分のレント予算に収まらなければならないからです。
アカウントは 8 バイトのディスクリミネーターを持つ固定長のバイトバッファなので、読み手に IDL は不要です。getAccountInfo と文書化されたオフセットがあれば足ります。レイアウトはリポジトリの solana/LAYOUT.md に書かれ、packages/protocol/src/solana.ts にも反映されています。
プログラム内の定数
| 名前 | 値 | 意味 |
|---|---|---|
FEE_BPS | 100 | 1% の分配。設定ではなく定数 |
ABSOLUTE_SESSION_CAP | 100 USDC | 1 セッションの最悪のエクスポージャー |
CLAIM_DELAY_SECS | 600 | 利用者がまだ閉じられる窓 |
IDLE_CLOSE_SECS | 86 400 | 1 日の沈黙後、誰でも閉じられる |
MAX_PRICE_PER_MIN | 1 USDC | 打ち間違えた価格が真に受けないようにする |
データプレーン
ワーカーは次の libp2p プロトコルを提供します:
/genkaku/open/0 session open
/genkaku/token/0 auth token
/genkaku/receipt/0 signed ledger increments
/genkaku/settle/1 settle the session (the worker signs and sends it)
/genkaku/offers/0 offer board
/genkaku/policy/0 policy document
/genkaku/hello/0 identity, wallet proof, quote
すべてのハンドラーはリレー経由の接続を受け入れます(runOnLimitedConnection)。したがってセッションは直接かリレー経由のどちらかで、どちらも一級の扱いです。libp2p がストリームを暗号化するため、リレーは暗号文を転送し、メタデータだけを見ます。
このビルドには DCUtR / ホールパンチングはありません。対称 NAT の後ろのピアはリレーを使うか、到達不能かのどちらかです。
発見
2 つの独立した経路:
- オンチェーンディレクトリ — 1 回の
getProgramAccounts呼び出しがすべての Worker アカウントを返します。クライアントは非アクティブな行を除外し、各行の peer id がそのウォレットをエンコードしていることを検証し、結果をディスクにキャッシュするので、ネットワークのない起動でも何かが一覧に載ります。 - シードリレー —
https://seed.genkaku.app/seed(ステージング:staging.genkaku.app/seed)は、いま実際に有効な multiaddr をGET /peersで返し、直接接続できないピアに circuit relay を提供します。
シードのアドレスは protocol パッケージに焼き込まれていますが、GENKAKU_BOOTSTRAP_SEEDS(カンマ区切りの URL)で上書きできます。
非公開ワーカー
可視性はプログラムの属性ではなくワーカーの属性です。精算には支払い先のアカウントが必要なので、どのワーカーアカウントも行を保持します。
| 公開 | 非公開 | |
|---|---|---|
| シードへの告知 | あり | なし |
| チェーン上の行のロケーター | グローバルに到達可能なアドレスがあるとき書き込む | 常に空 |
active フラグ | 1 | 1 — open_session は inactive なワーカーを拒否する |
| ダイヤルできる相手 | peer id を見つけた全員 | 許可リストのウォレット |
ゲートは libp2p のストリームハンドラーで connection.remotePeer を検査します。これはリクエスト内の主張ではなく、トランスポートが認証した値です。walletOfPeerId() がそれを Solana アドレスに戻します。1 つの ed25519 鍵がウォレットと PeerId を兼ねられるのはそのためです。二重署名も、保存されるベアラートークンもありません。
アクセスは /genkaku/pair/0 のペアリング交換で与えます。
genkaku1.<base64url({ peerId, wallet, name, addrs, relay, secret, exp })>
ワーカーが保存するのは sha256(secret) だけで、コードごとに 1 エントリ、有効期限(15 分)と usedAt の刻印を持ちます。引き換えが結び付けるのは文字列ではなく引き換えた人のウォレットなので、漏れたコードは鍵ではなくコードにすぎません。使用済みコードを同じウォレットから再試行すると冪等に成功し、別のウォレットからは拒否されます。
非公開モードは匿名ではありません。リレーは依然として回路を運び、チェーンは依然として支払いを記録し、ワーカーの運営者は依然としてプロンプトを見ます。
クライアント設定
利用者プラグインが保存するのは、ネットワークが提供したものではなく、人が選んだものです。
| キー | 意味 |
|---|---|
selected | (worker, model) キー。最大 10 件(MAX_SELECTED_MODELS) |
seeded | 一覧が一度実体化されるまで false |
sort | 6 種類の並び順のいずれか。ピッカーも同じ順序を使う |
privatePeers | ペアリング済みの非公開ワーカー: ウォレット、peer id、addrs、relay、ラベル |
同じ ~/.dsh/genkaku ディレクトリには、ネットワークから見える設定ではなくクライアント自身の
ポリシーであるファイルが 2 つあります。
| ファイル | 意味 |
|---|---|
policy.json | SpendPolicy: 有効・名前・有効期限・利用上限・リセット周期・セッション上限・価格上限・期間の支出・累計支出・保留中の予約 |
spend.jsonl | 決済済みセッション: 時刻・micro-USDC・モデル・ワーカー・escrow id・tx。512 KiB を超えると直近 1000 行に切り詰め |
policy.json は意図的にチェーン上のアカウントではありません。チェーンは渡されたデポジット
を執行するだけで、その上の上限を知っているのはクライアントだけです。拒否のコストは、取引を
組み立てる前の HTTP 402 だけです。
selected と seeded の組み合わせが「全部チェックを外した」を再起動後も保ちます。seeded が true なら空の一覧は選択であり、ブリッジはもう埋め戻しません。上限は UI とブリッジの両方で強制します。ブリッジが唯一の書き込み者であり、HTTP クライアントは UI ではないからです。
ペアリング済みの非公開ワーカーはバックグラウンドのティッカー(20 秒)で探査します。空の盤面で戻った探査はオンラインだがモデルなしではなく拒否として扱うので、許可リストが否と言っているのにパネルが非公開ワーカーを稼働中と表示することはありません。探査が状態リクエストを待たせることはありません。
課金モデル
pricePerHour : 6-decimal USDC, set by the worker
unit : 1 minute (60 units per hour)
billed : ceil(elapsed / 1min) × ceil(pricePerHour / 60)
deposit : 10 minutes of session time, prepaid, capped at 100 USDC
切り上げは 1 回だけで、tick ごとには行いません。利用者が提示された時間単価を超えて払うことはなく、ワーカーの未請求のエクスポージャーは最大 1 分です。
有料セッションは 2 つの取引です:
open_session(worker, price, deposit)— 利用者の USDC がトークンアカウントからエスクローの vault へ移ります。settle(minutes)— ワーカーが署名: 99% が引き出し可能残高へ、1% が財務へ。続いてクライアントがセッションを閉じて残りを取り戻し、claimが最後の決済の 10 分後にワーカーへ支払います。
0 の提示はセッションなしで提供されます。だからこそ無料のワーカーは USDC がまったくないマシンでも動かせます。
運営者の接点
- パネル — DeepSeek Harness 内のプラグイン自身の UI: モデル、価格、ウォレット、請求、支払い、手動ワーカー。
- ステータスサーバー —
127.0.0.1上のローカル HTTP 面。47821〜47826 の最初の空きポートを使い、パネルとクライアントアダプターが利用します。 - Seed admin — Caddy の後ろ、
/adminにあるシード VM 上の別コンソール。シードの統計とプログラムのアカウントを読みます。ウォレットの鍵は持たず、資金も動かしません。
意図的に存在しないもの
- トークンもステーキングも信用スコアトークンもありません。
- オーケストレーションサーバーも、プロンプトのデータベースもありません。
- 自動コンテンツフィルターはありません。プロトコルには、ワーカーが見る前にプロンプトを検査するフックがありません。
- オンチェーンの価格オラクルはありません。レートはワーカーが公開する数であり、支払う価値があるかは利用者が決めます。