エージェントアイデンティティ

エージェントアイデンティティプログラムは、MPL CoreアセットのオンチェーンアイデンティティレコードをPDAとして登録します。

Summary

エージェントアイデンティティプログラム（1DREGFgysWYxLnRnKQnwrxnJQeSMk2HmGaC6whw2B2p）はMPL CoreアセットのPDAベースのアイデンティティレコードを作成し、Transfer、Update、Executeのライフサイクルフックを持つAgentIdentityプラグインをアタッチします。

• 単一インストラクション — RegisterIdentityV1が1つのトランザクションでPDA作成、アカウント初期化、プラグインアタッチを処理します
• 40バイトのアカウント — AgentIdentityV1 PDAはディスクリミネーター、バンプ、アセット公開鍵のみを保存します
• ライフサイクルフック — プラグインはTransfer、Update、Executeイベントのapprove、listen、rejectチェックを登録します
• 決定論的PDA — オンチェーンルックアップのためにシード["agent_identity", <asset_pubkey>]から派生します

プログラムID

インストラクション：RegisterIdentityV1

PDAを作成し、Transfer、Update、Executeのライフサイクルフックを持つAgentIdentityプラグインをMPL Coreアセットにアタッチすることでエージェントアイデンティティを登録します。

アカウント

引数

動作内容

1. シード["agent_identity", <asset>]からPDAを派生します
2. AgentIdentityV1アカウント（40バイト）を作成して初期化します
3. MPL CoreにCPIして、提供されたURIとAgentIdentityプラグインをアセットにアタッチします
4. Transfer、Update、Executeイベント（approve、listen、reject）のライフサイクルチェックを登録します

ライフサイクルチェック

AgentIdentityプラグインは3つのライフサイクルイベントにフックを登録します。

つまり、アイデンティティプラグインはアセットへのTransfer、Update、Executeの承認、観察、または拒否に参加できます。

PDA派生

シード： ["agent_identity", <asset_pubkey>]

import { findAgentIdentityV1Pda } from '@metaplex-foundation/mpl-agent-registry';

const pda = findAgentIdentityV1Pda(umi, { asset: assetPublicKey });
// [publicKey, bump]を返します

アカウント：AgentIdentityV1

40バイト、8バイトアライン、bytemuck経由のゼロコピー。

アカウントの取得

import {
  fetchAgentIdentityV1,
  safeFetchAgentIdentityV1,
  fetchAgentIdentityV1FromSeeds,
  fetchAllAgentIdentityV1,
  getAgentIdentityV1GpaBuilder,
} from '@metaplex-foundation/mpl-agent-registry';

// PDAアドレスで取得（見つからない場合はthrow）
const identity = await fetchAgentIdentityV1(umi, pda);

// セーフフェッチ（見つからない場合はnullを返す）
const identity = await safeFetchAgentIdentityV1(umi, pda);

// シードで取得（内部でPDAを派生）
const identity = await fetchAgentIdentityV1FromSeeds(umi, { asset });

// バッチ取得
const identities = await fetchAllAgentIdentityV1(umi, [pda1, pda2]);

// GPAクエリ
const results = await getAgentIdentityV1GpaBuilder(umi)
  .whereField('asset', assetPublicKey)
  .get();

エラー

Metaplexが管理 · 2026年3月最終確認 · GitHubでソースを表示