Agent Tools

The Agent Tools program manages executive delegation for agent assets, allowing asset owners to delegate execution permissions to executive profiles.

Program ID

The same program address is deployed on both Mainnet and Devnet.

Overview

The tools program provides two instructions:

1. RegisterExecutiveV1 — Create an executive profile that can act as an executor for agent assets
2. DelegateExecutionV1 — Grant an executive profile permission to execute on behalf of an agent asset

An executive profile is registered once per authority. Delegation is per asset — an asset owner creates a delegation record linking their agent asset to a specific executive profile.

Instruction: RegisterExecutiveV1

Creates an executive profile PDA for the given authority.

Accounts

Four accounts are required: the profile PDA to create, a payer, an optional authority, and the system program.

What It Does

1. Derives a PDA from seeds ["executive_profile", <authority>]
2. Validates the account is uninitialized
3. Creates and initializes the ExecutiveProfileV1 account (40 bytes) storing the authority

Instruction: DelegateExecutionV1

Delegates execution permission for an agent asset to an executive profile.

Accounts

Seven accounts are required, including the executive profile, the agent asset, its identity PDA, and the delegation record PDA to create.

What It Does

1. Validates the executive profile exists and is initialized
2. Validates the agent asset is a valid MPL Core asset
3. Validates the agent identity is registered for the asset
4. Validates the signer is the asset owner
5. Derives a PDA from seeds ["execution_delegate_record", <executive_profile>, <agent_asset>]
6. Creates and initializes the ExecutionDelegateRecordV1 account (104 bytes)

PDA Derivation

Both account types are PDAs derived from deterministic seeds. Use the SDK helpers to compute them.

import {
  findExecutiveProfileV1Pda,
  findExecutionDelegateRecordV1Pda,
} from '@metaplex-foundation/mpl-agent-registry';

const profilePda = findExecutiveProfileV1Pda(umi, {
  authority: authorityPublicKey,
});

const delegatePda = findExecutionDelegateRecordV1Pda(umi, {
  executiveProfile: profilePda,
  agentAsset: assetPublicKey,
});

Account: ExecutiveProfileV1

Stores the authority that owns this executive profile. 40 bytes, 8-byte aligned.

Account: ExecutionDelegateRecordV1

Links an executive profile to an agent asset, recording who is authorized to execute on its behalf. 104 bytes, 8-byte aligned.

Errors

The program returns these errors when validation fails during registration or delegation.