SolutioFi Token Management

Solana Agent Kit provides comprehensive integration with SolutioFi protocol for token management operations, including burning tokens, closing accounts, merging multiple tokens, and spreading tokens across different assets.

Key Features

Token burning
Account closure
Token merging
Token spreading
Priority fee management
Transaction batching
LangChain tool integration

Basic Usage

Burning Tokens

const signatures = await agent.methods.burnTokens([
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",  // USDC
  "So11111111111111111111111111111111111111112"    // SOL
]);

Closing Accounts

const signatures = await agent.methods.closeAccounts([
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",  // USDC
  "So11111111111111111111111111111111111111112"    // SOL
]);

Merging Tokens

const signatures = await agent.methods.mergeTokens(
  [
    {
      mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      inputAmount: "100",
      slippage: "1",
      onlyDirectRoutes: true
    }
  ],
  "So11111111111111111111111111111111111111112",
  "normal"
);

Spreading Tokens

const signatures = await agent.methods.spreadToken(
  {
    mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    inputAmount: "1000",
    slippage: "1",
    onlyDirectRoutes: true
  },
  [
    {
      mint: "So11111111111111111111111111111111111111112",
      percentage: 50
    },
    {
      mint: "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
      percentage: 50
    }
  ],
  "normal"
);

Input Types

Input Asset Structure

interface InputAssetStruct {
  mint: string;           // Token mint address
  inputAmount: string;    // Amount to process
  slippage: string;       // Slippage tolerance
  onlyDirectRoutes: boolean; // Use only direct routes
}

Target Token Structure

interface TargetTokenStruct {
  mint: string;           // Token mint address
  percentage: number;     // Allocation percentage
}

Priority Fee Levels

type PriorityFee = "fast" | "normal" | "slow";

LangChain Integration

Solana Agent Kit provides several LangChain tools for SolutioFi operations:

Burn Tokens Tool

import { SolanaBurnTokensTool } from 'solana-agent-kit';

const burnTokensTool = new SolanaBurnTokensTool(agent);

// Tool input format (JSON string):
const input = JSON.stringify({
  mints: [
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "So11111111111111111111111111111111111111112"
  ]
});

Close Accounts Tool

import { SolanaCloseAccountsTool } from 'solana-agent-kit';

const closeAccountsTool = new SolanaCloseAccountsTool(agent);

// Tool input format (JSON string):
const input = JSON.stringify({
  mints: [
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "So11111111111111111111111111111111111111112"
  ]
});

Merge Tokens Tool

import { SolanaMergeTokensTool } from 'solana-agent-kit';

const mergeTokensTool = new SolanaMergeTokensTool(agent);

// Tool input format (JSON string):
const input = JSON.stringify({
  inputAssets: [{
    mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    inputAmount: "100",
    slippage: "1",
    onlyDirectRoutes: true
  }],
  outputMint: "So11111111111111111111111111111111111111112",
  priorityFee: "normal"
});

Spread Token Tool

import { SolanaSpreadTokenTool } from 'solana-agent-kit';

const spreadTokenTool = new SolanaSpreadTokenTool(agent);

// Tool input format (JSON string):
const input = JSON.stringify({
  inputAsset: {
    mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    inputAmount: "1000",
    slippage: "1",
    onlyDirectRoutes: true
  },
  targetTokens: [
    {
      mint: "So11111111111111111111111111111111111111112",
      percentage: 50
    },
    {
      mint: "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
      percentage: 50
    }
  ],
  priorityFee: "normal"
});

Example Prompts

For LangChain AI tools, here are example prompts:

Token Management

"Burn these unused token accounts"
"Close all empty token accounts"
"Merge multiple USDC accounts into one"
"Split 1000 USDC equally between SOL and mSOL"

Important Notes

API Key Configuration
- Required for all operations
- Set via SOLUTIOFI_API_KEY in config
- Client authentication required before use
Transaction Batching
- Operations may generate multiple transactions
- All transactions are signed and sent sequentially
- Failed transactions are skipped
Priority Fees
- Three levels available: fast, normal, slow
- Affects transaction processing speed
- Higher fees for faster processing

Best Practices

Error Handling

try {
  const signatures = await agent.methods.burnTokens(mints);
  // Check each signature for success
} catch (error) {
  if (error.message.includes("API key")) {
    // Handle authentication issues
  } else if (error.message.includes("insufficient")) {
    // Handle insufficient balance
  }
}

Transaction Management

// Process multiple transactions
const signatures = [];
for (const tx of transactions) {
  try {
    const signature = await sendAndConfirm(tx);
    signatures.push(signature);
  } catch (error) {
    continue; // Skip failed transactions
  }
}

Input Validation

// Validate percentage allocations
const totalPercentage = targetTokens.reduce(
  (sum, token) => sum + token.percentage,
  0
);
if (totalPercentage !== 100) {
  throw new Error("Total percentage must equal 100");
}

Technical Details

Client Initialization

const client = new SolutioFi({
  apiKey: process.env.SOLUTIOFI_API_KEY
});
await client.authenticate();

Transaction Options

const TX_OPTIONS = {
  skipPreflight: false,
  preflightCommitment: "processed"
};

Common Token Addresses

const TOKENS = {
  SOL: "So11111111111111111111111111111111111111112",
  USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  mSOL: "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So"
};

Introduction

Quickstart

Plugins

Adapters

Using LLMs

Devrel Agents

Fraction Protocol

Integrations

Key Features

Basic Usage

Burning Tokens

Closing Accounts

Merging Tokens

Spreading Tokens

Input Types

Input Asset Structure

Target Token Structure

Priority Fee Levels

LangChain Integration

Burn Tokens Tool

Close Accounts Tool

Merge Tokens Tool

Spread Token Tool

Example Prompts

Token Management

Important Notes

Best Practices

Technical Details

Client Initialization

Transaction Options

Common Token Addresses

​Key Features

​Basic Usage

​Burning Tokens

​Closing Accounts

​Merging Tokens

​Spreading Tokens

​Input Types

​Input Asset Structure

​Target Token Structure

​Priority Fee Levels

​LangChain Integration

​Burn Tokens Tool

​Close Accounts Tool

​Merge Tokens Tool

​Spread Token Tool

​Example Prompts

​Token Management

​Important Notes

​Best Practices

​Technical Details

​Client Initialization

​Transaction Options

​Common Token Addresses

Key Features

Basic Usage

Burning Tokens

Closing Accounts

Merging Tokens

Spreading Tokens

Input Types

Input Asset Structure

Target Token Structure

Priority Fee Levels

LangChain Integration

Burn Tokens Tool

Close Accounts Tool

Merge Tokens Tool

Spread Token Tool

Example Prompts

Token Management

Important Notes

Best Practices

Technical Details

Client Initialization

Transaction Options

Common Token Addresses