Programs
Executive Delegation
Last updated April 9, 2026
What You'll Do
Manage execution delegation for registered agents:
- Register executive profiles (one-time per wallet)
- Delegate agent execution to an executive wallet
- Revoke delegations when no longer needed
Summary
The mplx agents executive commands manage execution delegation — authorizing wallets to sign transactions on behalf of registered agents. An executive must register a profile once, then the MPL Core asset owner can delegate execution to them.
- Register: One-time executive profile creation per wallet
- Delegate: Link a registered agent to an executive (owner only)
- Revoke: Remove a delegation (owner or executive can revoke)
Jump to: Register Executive Profile · Delegate Execution · Revoke Delegation · Common Errors · FAQ
Register Executive Profile
The agents executive register command creates a one-time on-chain executive profile PDA for the current wallet. This profile is required before any agent can be delegated to this wallet.
mplx agents executive register
No flags or arguments required — the profile is derived from the current signer's wallet.
Output
--------------------------------
Executive Profile: <profile_pda_address>
Authority: <wallet_address>
Signature: <transaction_signature>
Explorer: <explorer_url>
--------------------------------
Delegate Execution
The agents executive delegate command links a registered agent to an executive profile, allowing the executive to sign transactions on behalf of the agent. Only the asset owner can delegate execution.
mplx agents executive delegate <AGENT_ASSET> --executive <EXECUTIVE_WALLET>
Options
| Flag | Description | Required |
|---|---|---|
--executive <string> | The executive's wallet address (profile PDA is derived automatically) | Yes |
The executive must have already registered their profile with mplx agents executive register before delegation.
Output
--------------------------------
Agent Asset: <agent_asset_address>
Executive Profile: <profile_pda_address>
Signature: <transaction_signature>
Explorer: <explorer_url>
--------------------------------
Revoke Delegation
The agents executive revoke command removes an execution delegation, closing the delegation record and refunding rent. Either the asset owner or the executive authority can revoke.
mplx agents executive revoke <AGENT_ASSET> --executive <EXECUTIVE_WALLET>
mplx agents executive revoke <AGENT_ASSET>
Options
| Flag | Description | Required | Default |
|---|---|---|---|
--executive <string> | The executive's wallet address | No | Current signer |
--destination <string> | Wallet to receive refunded rent | No | Current signer |
Output
--------------------------------
Agent Asset: <agent_asset_address>
Executive Wallet: <executive_wallet_address>
Signature: <transaction_signature>
Explorer: <explorer_url>
--------------------------------
Common Errors
| Error | Cause | Fix |
|---|---|---|
| Executive profile already exists | Calling register a second time | Each wallet can only have one profile — it's already registered |
| Not the asset owner | Trying to delegate from a non-owner wallet | Only the asset owner can delegate execution |
| Executive profile not found | Delegating to a wallet that hasn't registered | The executive must run agents executive register first |
| Delegation not found | Revoking a delegation that doesn't exist | Verify the agent asset and executive addresses |
Notes
- Executive profiles are one-time per wallet — registering again will fail
- Each delegation is per-asset: an executive can be delegated multiple agents, but each requires a separate
delegatecall - When revoking without
--executive, the command defaults to the current signer (for executives revoking their own delegation) - Rent from closed delegation records is refunded to the
--destinationwallet (defaults to the signer)
FAQ
What is an executive profile? A one-time on-chain PDA for a wallet that enables it to receive execution delegations from registered agents.
Can a wallet have multiple executive profiles? No. Each wallet can only have one executive profile. Registration is a one-time operation.
Who can revoke a delegation? Either the asset owner or the executive authority can revoke a delegation. When the executive revokes, --executive can be omitted (defaults to current signer).