Noriに委任する

Noriへの委任は、Noriをエージェントのアセット上の実行デリゲートとして登録する1回限りのオンチェーンセットアップです。その後は、エージェントがNoriに対して行うすべてのLLM・画像・RPC呼び出しがエージェントのPDAウォレットから自動的に決済されます — 支払いの往復も、ウォレットプロンプトも、プロバイダーAPIキーも不要です。オンボーディングは無料です: Noriがトランザクション手数料を支払い、ブロックハッシュも提供するため、エージェントはキーペアにSOLを持つ必要も、自前のRPCを持つ必要もありません。

概要

Noriに実行委任を付与すると、エージェントは2往復のx402フォールバックからインラインのデリゲートペイレールに切り替わります。

• 1回限りのセットアップ — Noriのエグゼクティブプロファイルを指す単一のdelegateExecutionV1命令。Noriが無料で連署・送信します
• 呼び出しごとの決済 — NoriはMemoレシート付きのMPL Core Executeトランザクションを通じてエージェントのAsset Signer PDAに課金し、成功した呼び出しのみが対象です
• ベアラートークン認証 — 署名済みチャレンジ/ハンドシェイクで15分間有効なベアラートークンを発行し、呼び出しをデリゲートペイのレールにルーティングします
• いつでも取り消し可能 — アセットオーナーは委任を取り消すことができ、自動課金は即座にハードストップします

クイックスタート

1. Noriのエージェントカードを取得してserviceExecutiveAddressを読み取ります
2. エグゼクティブキーペアを権限、Noriをフィーペイヤーとして委任トランザクションを構築し、POST /v1/delegate/submitに送信します
3. エージェントのPDAウォレットに入金して運用に必要なSOL残高を用意します
4. /auth/challenge + /auth/handshakeでベアラートークンを発行します
5. Authorization: Bearer <token>を付けて有料呼び出しを実行します

前提条件

委任には既存のオンチェーンエージェントIDが必要です。委任トランザクションはアセットとそのID PDAを参照します。

• 登録済みエージェント — AgentIdentityレコードを持つMPL Coreアセット
• エージェントのエグゼクティブキーペア（エージェントの実行に使うキーペア。エージェントを実行でセットアップ）— 権限として委任に署名します
• @metaplex-foundation/mpl-agent-registryと@metaplex-foundation/umiのインストール
• 委任自体にはSOLもRPCエンドポイントも不要です — Noriが両方を提供します

ステップ1: Noriのエグゼクティブアドレスを取得

Noriのエージェントカードには、委任先のアドレスが宣伝されています。/.well-known/agent-card.jsonを取得し、2つのフィールドを読み取ります:

• serviceExecutiveAddress — Noriのエグゼクティブキーペアの公開鍵。そのエグゼクティブプロファイルPDAが、アセットにデリゲートとして登録する対象です。
• serviceAssetAddress — Nori自身のエージェントアセット。そのPDAが課金の支払い先であり、すべての課金をオンチェーンで検証できます。

const NORI_URL = process.env.NORI_URL; // Nori's base URL

const card = await fetch(`${NORI_URL}/.well-known/agent-card.json`).then((r) =>
  r.json(),
);

const noriExecutive = card.serviceExecutiveAddress; // delegate to this
const noriServiceAsset = card.serviceAssetAddress; // charges are paid here

ステップ2: 委任トランザクションの構築と送信

委任トランザクションには、ちょうど1つのdelegateExecutionV1命令が含まれます: エグゼクティブキーペアが権限として署名し、Noriのエグゼクティブプロファイルがデリゲート、Noriのキーペアがフィーペイヤーです。オフラインで構築・署名し（Noriの無料のGET /v1/solana/blockhashエンドポイントがブロックハッシュを提供します）、部分署名済みトランザクションをPOST /v1/delegate/submitにPOSTします。Noriはこれを検証し、フィーペイヤーとして連署して送信します。

import { createNoopSigner, publicKey } from '@metaplex-foundation/umi';
import {
  delegateExecutionV1,
  findAgentIdentityV1Pda,
  findExecutiveProfileV1Pda,
} from '@metaplex-foundation/mpl-agent-registry';

// `umi` is configured with your agent's executive keypair as identity.
const agentAsset = publicKey(process.env.AGENT_ASSET_ADDRESS);

// Nori's executive profile PDA, derived from the agent card address.
const noriProfile = findExecutiveProfileV1Pda(umi, {
  authority: publicKey(noriExecutive),
});
const agentIdentity = findAgentIdentityV1Pda(umi, { asset: agentAsset });

// Free blockhash — no RPC of your own needed.
const { blockhash } = await fetch(`${NORI_URL}/v1/solana/blockhash`).then((r) =>
  r.json(),
);

// Build with Nori as fee payer (a noop signer — Nori co-signs server-side),
// sign with your executive keypair.
const tx = await delegateExecutionV1(umi, {
  agentAsset,
  agentIdentity,
  executiveProfile: noriProfile,
})
  .setFeePayer(createNoopSigner(publicKey(noriExecutive)))
  .setBlockhash(blockhash)
  .buildAndSign(umi);

// Nori validates, co-signs, and submits — free of charge.
const result = await fetch(`${NORI_URL}/v1/delegate/submit`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    transaction: Buffer.from(umi.transactions.serialize(tx)).toString('base64'),
  }),
}).then((r) => r.json());

console.log(result);
// { success: true, signature: '...', agentAsset: '...', authority: '...' }

Metaplexエージェントテンプレートからエージェントを構築する場合、このステップ全体はdelegate-to-noriツールとしてパッケージ化されています — 1回の呼び出しで、手動のトランザクション構築は不要です。

ステップ3: ベアラートークンで認証

有料呼び出しは、Sign-In-With-Solanaスタイルのハンドシェイクで発行されたベアラートークンを携えている場合にデリゲートペイのレールにルーティングされます。トークンは、エージェントアセットに登録されたデリゲートであるエグゼクティブキーペアを制御していることを証明します。有効期間は15分なので、期限切れ時にはハンドシェイクを再実行してください。

import { base58 } from '@metaplex-foundation/umi/serializers';

// 1. Get a fresh nonce.
const { nonce } = await fetch(`${NORI_URL}/auth/challenge`).then((r) => r.json());

// 2. Sign the handshake envelope with your executive keypair.
const now = Date.now();
const handshake = {
  pubkey: umi.identity.publicKey.toString(),
  agentAsset: agentAsset.toString(),
  audience: NORI_URL,
  nonce,
  issuedAt: new Date(now).toISOString(),
  expiresAt: new Date(now + 60_000).toISOString(),
};
const signature = base58.deserialize(
  await umi.identity.signMessage(
    new TextEncoder().encode(JSON.stringify(handshake)),
  ),
)[0];

// 3. Exchange for a bearer token (valid 15 minutes).
const { token } = await fetch(`${NORI_URL}/auth/handshake`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ handshake, signature }),
}).then((r) => r.json());

ステップ4: 有料呼び出しを実行

ベアラートークンを添付すると、Noriはアップストリームの呼び出しを実行してから、1つのExecuteトランザクションでエージェントのPDAに課金します — レスポンスは402チャレンジなしの1往復で返ってきます。同じヘッダーがすべての/v1/*エンドポイントと/a2aで機能します。

const completion = await fetch(`${NORI_URL}/v1/chat/completions`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    model: 'anthropic/claude-sonnet-4-6',
    messages: [{ role: 'user', content: 'Hello from a delegated agent.' }],
  }),
}).then((r) => r.json());

アセットに対する最初の有料呼び出しの際、Noriは自分がまだ登録済みデリゲートであることをオンチェーンで確認します。結果は5分間キャッシュされるため、以降の呼び出しではチェーンの参照はスキップされます。各サービスを利用する完全なエージェント（OpenAI互換SDKクライアントをNoriに向ける例を含む）については、サンプルエージェントを参照してください。

エージェントPDAウォレットへの入金

課金はエージェントのAsset Signer PDAから引き落とされるため、最初の有料呼び出しの前にSOL残高が必要です。PDAはシステムのレント免除最低額（0バイトアカウントで890,880ラマポート）を上回っている必要もあります — Metaplexエージェントテンプレートは、レント未満の小さな課金が失敗しないよう、委任時に0.002 SOLをシードします。任意のウォレットからPDAにSOLを送金してください。残高が尽きると、補充するまで呼び出しはHTTP 402チャレンジにフォールバックします（ハードストップのセマンティクスを参照）。

Noriへの委任の取り消し

実行委任の取り消しはキルスイッチであり、ハードストップとして効力を発揮します。アセットオーナーがNoriのエグゼクティブプロファイルに対するExecutionDelegateRecordV1を取り消すと、次の課金試行はオンチェーンで失敗し、Noriはそのアセットのキャッシュ済みデリゲートステータスを無効化し、デリゲートペイのレールは停止します — それ以降、呼び出しは自動課金される代わりにx402の支払いチャレンジを受け取ります。5分間のデリゲートステータスキャッシュのため、取り消し直後の呼び出しはデリゲート課金を試行して（そして失敗して）しまう可能性がありますが、チェーンが拒否するため取り消し後に課金が成立することはありません。

取り消してもエージェントの登録が解除されたり、PDA残高に影響したりすることはありません — Noriの課金権限が取り除かれるだけです。ステップ2を繰り返すことで、後から再委任できます。

よくあるエラー

注意事項

• オンボーディングエンドポイント（GET /v1/solana/blockhash、POST /v1/delegate/submit）は無料かつ認証不要です。それ以外の実作業を行うものはすべて有料です
• ベアラートークンはエグゼクティブキーペア + エージェントアセットのペアごとに発行され、15分で期限切れになります — クライアントに再ハンドシェイクを組み込んでください
• デリゲートステータスのキャッシュにより、委任状態の変更（付与または取り消し）が決済レールに反映されるまで最大5分かかることがあります。オンチェーンの強制は即時です
• 委任はアセットごとです: 複数のエージェントを運用するオペレーターは、各アセットを個別に委任します
• mpl-agent-toolsの実行委任（ExecutionDelegateRecordV1）、プログラムTLREGni9ZEyGC3vnPZtqUh95xQ8oPqJSvNjvB7FGK8Sに適用されます

Metaplex Foundationが管理。最終確認日: 2026-07-08。GitHubでソースを見る。

FAQ

Noriへの委任に関するよくある質問。

Noriへの委任に費用はかかりますか？

いいえ。Noriが委任トランザクションのネットワーク手数料を支払い（フィーペイヤーとして連署します）、オンボーディングエンドポイントは無料かつ認証不要です。ただし、その後はエージェントのPDAウォレットに運用に必要なSOL残高が必要になります。呼び出しごとの課金の引き落とし元となるアカウントだからです。

委任はNoriにどのような権限を与えますか？

委任はNoriのエグゼクティブプロファイルをエージェントアセットの実行デリゲートとして登録し、NoriがエージェントのPDAウォレットからSOLを移動するMPL Core Executeトランザクションに署名できるようにします。Noriはこれを使って呼び出しごとの課金を決済し、それぞれにオンチェーンのMemoレシートが付きます。PDAには運用に必要な残高だけを置き、レシートを監査してください。

Noriによるエージェントへの課金を止めるにはどうすればいいですか？

エージェントアセット上の実行委任を取り消します。次の課金試行はオンチェーンで失敗し、Noriのキャッシュ済みデリゲートステータスは無効化され、デリゲートペイのレールはハードストップします — 以降の呼び出しは自動課金される代わりにHTTP 402のx402チャレンジを受け取ります。

委任したのに呼び出しがHTTP 402を返すのはなぜですか？

402は、その呼び出しでデリゲートペイのレールが利用できなかったことを意味します — ベアラートークンが欠落または期限切れ（トークンの有効期間は15分）、委任が取り消された、または課金自体が失敗した（通常はPDAウォレットが空）のいずれかです。ハンドシェイクを再実行し、委任レコードが存在することを確認し、PDA残高をチェックしてください。

委任せずにNoriを使うことはできますか？

はい。委任していない呼び出し元はx402フォールバックレールを使います — 最初のリクエストは支払い要件と共にHTTP 402を返し、SOLまたはUSDCで支払ってから再試行します。費用は同じですが、すべての呼び出しに支払いの往復が追加されます。一方、デリゲートペイはインラインで決済されます。