Skip to main content

Prerequisites

Before you begin, make sure you have:

Node.js

Version 18 or higher Download from nodejs.org

Solana Wallet

Phantom or Solflare You need a wallet with some SOL for transaction fees

Verified NFT

Any Verified Collection An NFT from any verified Solana collection to transform into an agent

Step 1: Installation

Choose your preferred package manager:

Step 2: Initialize the SDK

The SDK provides helper methods for common environments.

Browser / React (Wallet Adapter)

Node.js / Backend

Step 3: Create Your First Agent

Transform a verified NFT into an AI agent. This operation costs 0.05 SOL (Standard) but is FREE for Genesis collections.

Step 4: Add Affiliate Revenue (Optional)

Monetize your integration by adding your wallet as an affiliate. You earn 15-50% commission on the creation fee.

Next Steps

Explore Examples

Check out real-world examples and use cases

API Reference

Dive into the complete API documentation

Security Model

Understand the zero-knowledge architecture

Troubleshooting

Common Cause: The NFT collection is not verified on-chain. Solution: Ensure the NFT belongs to a collection where Collection.verified = true. Mainframe requires this for security.
Common Cause: Not enough SOL for the creation fee (0.05 SOL) + rent. Solution: Ensure your wallet has at least 0.06 SOL.