メインコンテンツまでスキップ

アーキテクチャ

GenKaKu が本番で動かしているものは、静的サイトかピアのプロセスのどちらかです。リクエスト経路に GenKaKu のサーバーはありません。

パッケージ​

パッケージ役割
@genkaku/protocolSolana バインディング、エスクロー課金、libp2p サイドカー、Ollama ブリッジ
@genkaku/dsh-runtime両方のプラグインが共有するアダプター
@genkaku/dsh-worker-plugin@0.5.0-rc.8ローカルモデルを提供する
@genkaku/dsh-user-plugin@0.5.0-rc.8ネットワークのモデルを利用する
@genkaku/seedlibp2p リレーとピア発見サービス
@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_BPS1001% の分配。設定ではなく定数
ABSOLUTE_SESSION_CAP100 USDC1 セッションの最悪のエクスポージャー
CLAIM_DELAY_SECS600利用者がまだ閉じられる窓
IDLE_CLOSE_SECS86 4001 日の沈黙後、誰でも閉じられる
MAX_PRICE_PER_MIN1 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. オンチェーンディレクトリ — 1 回の getProgramAccounts 呼び出しがすべての Worker アカウントを返します。クライアントは非アクティブな行を除外し、各行の peer id がそのウォレットをエンコードしていることを検証し、結果をディスクにキャッシュするので、ネットワークのない起動でも何かが一覧に載ります。
  2. シードリレー — https://seed.genkaku.app/seed(ステージング: staging.genkaku.app/seed)は、いま実際に有効な multiaddr を GET /peers で返し、直接接続できないピアに circuit relay を提供します。

シードのアドレスは protocol パッケージに焼き込まれていますが、GENKAKU_BOOTSTRAP_SEEDS(カンマ区切りの URL)で上書きできます。

非公開ワーカー​

可視性はプログラムの属性ではなくワーカーの属性です。精算には支払い先のアカウントが必要なので、どのワーカーアカウントも行を保持します。

公開非公開
シードへの告知ありなし
チェーン上の行のロケーターグローバルに到達可能なアドレスがあるとき書き込む常に空
active フラグ11 — 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
sort6 種類の並び順のいずれか。ピッカーも同じ順序を使う
privatePeersペアリング済みの非公開ワーカー: ウォレット、peer id、addrs、relay、ラベル

同じ ~/.dsh/genkaku ディレクトリには、ネットワークから見える設定ではなくクライアント自身の ポリシーであるファイルが 2 つあります。

ファイル意味
policy.jsonSpendPolicy: 有効・名前・有効期限・利用上限・リセット周期・セッション上限・価格上限・期間の支出・累計支出・保留中の予約
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 つの取引です:

  1. open_session(worker, price, deposit) — 利用者の USDC がトークンアカウントからエスクローの vault へ移ります。
  2. settle(minutes) — ワーカーが署名: 99% が引き出し可能残高へ、1% が財務へ。続いてクライアントがセッションを閉じて残りを取り戻し、claim が最後の決済の 10 分後にワーカーへ支払います。

0 の提示はセッションなしで提供されます。だからこそ無料のワーカーは USDC がまったくないマシンでも動かせます。

運営者の接点​

  • パネル — DeepSeek Harness 内のプラグイン自身の UI: モデル、価格、ウォレット、請求、支払い、手動ワーカー。
  • ステータスサーバー — 127.0.0.1 上のローカル HTTP 面。47821〜47826 の最初の空きポートを使い、パネルとクライアントアダプターが利用します。
  • Seed admin — Caddy の後ろ、/admin にあるシード VM 上の別コンソール。シードの統計とプログラムのアカウントを読みます。ウォレットの鍵は持たず、資金も動かしません。

意図的に存在しないもの​

  • トークンもステーキングも信用スコアトークンもありません。
  • オーケストレーションサーバーも、プロンプトのデータベースもありません。
  • 自動コンテンツフィルターはありません。プロトコルには、ワーカーが見る前にプロンプトを検査するフックがありません。
  • オンチェーンの価格オラクルはありません。レートはワーカーが公開する数であり、支払う価値があるかは利用者が決めます。