Aithra Toolkit : Enables Eliza OS Agents to tokenize any data in real-time

Screenshots

In this example we will transform audio tracks and music images into NFT music playlists with just a few lines of code! This plugin simplifies the process of creating and minting music Solana Compressed NFTs (cNFTs) by handling all the complex operations behind the scenes for data storage and tokenization.

Note: You'll need SOL in your wallet to cover the costs of decentralized storage and cNFT minting on the Solana blockchain.

Features

• Simple API for creating NFTs that represent real-world data
• Support for single and multiple file uploads
• Custom playlist (multiple files packaged as one) metadata handling
• Automatic animation file processing (to act as the NFT image)
• Built-in storage management
• Simple payment module (agents pay with SOL and all micropayments for storage and tokenization handled by the plugin)

Quick Start (Audio Playlist Example)

Note: We are currently working to submit the Plugin to the Official ElizaOS Plugin Marketplace so you can integrate it directly -- until this is finalized, you need to manually copy this plugin into your ElizaOS code repo (into the packages section). Open a Github ticket if you need help.

// Initialize the service
const aithraService = runtime.getService(ServiceType.AITHRA_TOOLKIT);
await aithraService.initialize(runtime, "./temp");

// Load your audio and image files
const audioBuffer = await fs.promises.readFile("./path/to/audio.mp3");
const imageBuffer = await fs.promises.readFile("./path/to/cover.png");
const animationBuffer = await fs.promises.readFile("./path/to/animation.jpg");

// Generate cover image
const base64Image = await generateImage(
  {
    prompt: coverPromt,
    width: 512,
    height: 512,
    count: 1,
  },
  runtime
);

const imageBuffer = Buffer.from(base64Image, "base64");

const base64Animation = await generateImage(
  {
    prompt: animationPrompt,
    width: 512,
    height: 512,
    count: 1,
  },
  runtime
);

const animationBuffer = Buffer.from(base64Animation, "base64");

// Store a single track
await aithraService.storeTrackToFolder({
  track: {
    data: audioBuffer,
    metadata: {
      artist: "Artist Name",
      album: "Album Name",
      title: "Track Title",
      category: "Music Category",
    },
    image: imageBuffer,
  },
});

const animationPath = await aithraService.storeAnimationToFolder({
  animation: animationBuffer,
  extension: "jpg",
});

// Create and mint your NFT playlist
const response = await aithraService.buildUploadMintMusicNFTs({
  playlist: {
    name: "My Awesome Playlist",
    creator: "Creator Name",
  },
  nft: {
    tokenName: "AWESOME_NFT",
    sellerFeeBasisPoints: 50,
    quantity: 1,
    name: "Awesome Music Collection",
    description: "A unique collection of amazing tracks",
  },
  animation: {
    animationFile: animationPath,
  },
});

Detailed Usage

1. Initializing the Service

const aithraService = runtime.getService(ServiceType.AITHRA_TOOLKIT);
await aithraService.initialize(runtime, "./temp");

2. Storing Tracks

Single Track

await aithraService.storeTrackToFolder({
  track: {
    data: audioBuffer,
    metadata: {
      artist: "Artist Name",
      album: "Album Name",
      title: "Track Title",
      category: "Category",
    },
    image: imageBuffer,
  },
});

Multiple Tracks

await aithraService.storeTracksToFolder({
  tracks: [
    {
      data: audioBuffer,
      metadata: {
        artist: "Artist Name",
        album: "Album Name",
        title: "Track Title",
        category: "Category",
      },
      image: imageBuffer,
    },
  ],
});

3. Storing Animation

const animationPath = await aithraService.storeAnimationToFolder({
  animation: animationBuffer,
  extension: "jpg",
});

4. Creating and Minting NFT Playlist

const response = await aithraService.buildUploadMintMusicNFTs({
  playlist: {
    name: "Playlist Name",
    creator: "Creator Name",
  },
  nft: {
    tokenName: "UNIQUE_TOKEN_NAME",
    sellerFeeBasisPoints: 50, // 0.5% seller fee
    quantity: 1,
    name: "NFT Display Name",
    description: "NFT Description",
  },
  animation: {
    animationFile: animationPath,
  },
});