Prepare an agent mint for a Phantom/Solflare wallet to sign
prepare_agent_mintPrepare unsigned transactions for minting an on-chain AI agent. An external Solana wallet signs, pays the deploy fee, and broadcasts the signed transaction array.
Instructions
Build the exact Genesis-style mint+register flow (Metaplex Core asset + Agent Identity) for an EXTERNAL Solana wallet: Phantom, Solflare, Backpack, Ledger, anything. Needs no secret key. Returns unsigned transactions base64 in txs_base64 (already co-signed by the new asset keypair) with wallet as the fee payer: one atomic tx when it fits Solana's size limit, else create + register to sign together via signAllTransactions. The wallet signs and broadcasts, or hands the signed array to send_signed_transaction. Includes the same mainnet deploy fee as mint_onchain_agent, priced against the wallet's live $THREE balance and returned as deploy_fee_sol/deploy_fee_to before anything is signed. Broadcasts nothing itself. The blockhash expires after roughly a minute, so sign promptly and re-prepare if a wallet reports an expired transaction.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Agent name. Becomes the Core asset name and the registration name. | |
| image | No | Thumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers. | |
| owner | No | Mint the asset to this owner instead of the signing wallet. | |
| active | No | Registration active flag. Default true. | |
| wallet | Yes | The base58 address of the wallet that will sign, pay, and own the agent. | |
| network | No | Solana cluster. Defaults to the configured network (mainnet unless overridden). | |
| services | No | Services the agent offers, listed on its Metaplex agent page ({name, endpoint}). | |
| model_url | No | 3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style. | |
| attributes | No | On-chain Attributes plugin entries (real bytes in the asset account). | |
| collection | No | Mint into this Metaplex Core collection. The signer must be the collection authority. | |
| add_blocker | No | Attach AddBlocker so no further plugins can be added. Default false. | |
| description | No | What this agent is or does. Stored in the EIP-8004 registration document. | |
| external_url | No | Optional external_url in the asset metadata (e.g. the agent home page). | |
| metadata_uri | No | Full override for the asset metadata URI (https or data:). Skips the built-in metadata builder. | |
| x402_support | No | Advertise x402 payment support in the registration document. Default false. | |
| registrations | No | External registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set. | |
| permanent_burn | No | Attach PermanentBurnDelegate. Default false. | |
| supported_trust | No | Trust models the agent supports. Default ['reputation'] (Genesis style). | |
| permanent_freeze | No | Attach PermanentFreezeDelegate (unfrozen). Default false. | |
| registration_uri | No | Full override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder. | |
| royalty_creators | No | Royalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%. | |
| threews_agent_id | No | three.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}. | |
| verified_creator | No | Attach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style). | |
| immutable_metadata | No | Attach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style). | |
| permanent_transfer | No | Attach PermanentTransferDelegate. Default false. | |
| metadata_attributes | No | Off-chain attributes array inside the asset metadata JSON (trait_type/value pairs). | |
| royalty_basis_points | No | Royalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin. |