solagent.rs - An open-source Rust library for connecting AI agents to Solana protocols.

✍️ Features

• Basic Operations

  • Get the balance of a Solana wallet or token account
  • Transfer tokens or SOL
  • Deploy SPL tokens
  • Deploy NFT Collection
  • Mint NFT
  • Request SOL from Solana faucet

• DeFi Operations

  • Jupiter Exchange swaps
  • Jupiter Exchange stake
  • Launch Token on pump.fun

• AI Operations

  • Integrate Rig-core tools

• Utils Operations

  • Fetch price
    • By Jupiter API
    • By Pyth API
  • Get wallet address of the agent
  • Get the current transactions per second (TPS)

• More...

Quick Start

use solagent::{create_solana_tools, Config, SolanaAgentKit};

#[tokio::main]
async fn main() {
    let config = Config {
        openai_api_key: Some("your_api_key".to_string()),
        ..Default::default()
    };
    let agent = SolanaAgentKit::new("private_key", "RPC_URL", config);
    let toolset = create_solana_tools(agent);
}

Usage Examples

Deploy a New Token

let name = "my ai token".to_string();
let uri = "uri".to_string();
let symbol = "SOLA".to_string();
let decimals = 9;
let initial_supply = 1_000_000_000_u64;

let config = Config {
    openai_api_key: Some("your_api_key".to_string()),
    ..Default::default()
};
let agent = SolanaAgentKit::new("private_key", "RPC_URL", config);
let mint_pubkey = agent
    .deploy_token(name, uri, symbol, decimals, Some(initial_supply)).await;
println!("Token Mint Address: {:?}", mint_pubkey);

Create NFT Collection

let name = "solagent Collection";
let uri = "https://uri";
let royalty_basis_points = Some(500);
let creators = vec![(Pubkey::from_str_const("pubkey"), 100)];
let options = NFTMetadata::new(name, uri, royalty_basis_points, Some(creators));

let config = Config {
    openai_api_key: Some("your_api_key".to_string()),
    ..Default::default()
};
let agent = SolanaAgentKit::new("private_key", "RPC_URL", config);
let tx = agent.deploy_collection(options).await.unwrap();
println!("Mint: {:?}", tx.0);

Fetch Price Data from Pyth

let config = Config {
    openai_api_key: Some("your_api_key".to_string()),
    ..Default::default()
};
let agent = SolanaAgentKit::new("private_key", "RPC_URL", config);
let price_feed_id = agent.fetch_pyth_price_feed_id("SOL")
    .await
    .expect("fetch_pyth_price_feed_id");
let price = agent.fetch_price_by_pyth(&price_feed_id)
    .await
    .expect("fetch_price_by_pyth");
println!("Price of SOL/USD: {}", price)

More examples

More examples can be found in the examples.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contributors

Star History

License

Apache-2 License

Security

This toolkit handles private keys and transactions. Always ensure you're using it in a secure environment and never share your private keys.

Support Us

Thank you for your support of solagent.rs! Your donations will help us maintain and develop this project better.
Donation Addresses:
Solana: qsvR7V3DtbbxAEs4TkGiQL9N9Z1GccfV6Q6Vm2oHViS
Ethereum: 0x972b8d20f5847B03Df43d9A595B7e83A7bbCD951

Our Supporters

SendAI: solscan.io