에이전트 신원

에이전트 신원 프로그램은 MPL Core 자산의 온체인 신원 레코드를 PDA로 등록합니다.

Summary

에이전트 신원 프로그램(1DREGFgysWYxLnRnKQnwrxnJQeSMk2HmGaC6whw2B2p)은 MPL Core 자산을 위한 PDA 기반 신원 레코드를 생성하고 Transfer, Update, Execute 생명주기 훅이 있는 AgentIdentity 플러그인을 연결합니다.

• 단일 명령어 — RegisterIdentityV1이 하나의 트랜잭션에서 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 플러그인은 세 가지 생명주기 이벤트에 훅을 등록합니다.

즉, 신원 플러그인은 자산의 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에서 소스 보기