https://github.com/ztgx/solagent.rs

connect any ai agents to solana protocols in Rust.
https://github.com/ztgx/solagent.rs

agent ai defai rig-core rust solana

Last synced: 2 days ago
JSON representation

connect any ai agents to solana protocols in Rust.

• Host: GitHub
• URL: https://github.com/ztgx/solagent.rs
• Owner: zTgx
• License: apache-2.0
• Created: 2025-01-03T02:54:39.000Z (13 days ago)
• Default Branch: main
• Last Pushed: 2025-01-10T11:37:28.000Z (5 days ago)
• Last Synced: 2025-01-10T12:32:50.223Z (5 days ago)
• Topics: agent, ai, defai, rig-core, rust, solana
• Language: Rust
• Homepage:
• Size: 163 KB
• Stars: 17
• Watchers: 0
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


# solagent.rs   

  [](https://crates.io/crates/solagent)

  [](https://docs.rs/solagent)

  [](https://crates.io/crates/solagent)



An open-source toolkit for connecting AI agents to Solana protocols.


## WIP

Solagent.rs is still in the early stage of development, and its interfaces may change in the future.  

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

## ✍️  Features

- **Basic Operations**  

    - [x] Get the balance of a Solana wallet or token account

    - [x] Transfer tokens or SOL 

    - [x] Deploy SPL tokens

    - [x] Deploy NFT Collection

    - [x] Mint NFT 

    - [x] Request SOL from Solana faucet

- **DeFi Operations**

    - [x] Jupiter Exchange swaps

    - [x] Jupiter Exchange stake

    - [x] Launch Token on pump.fun

- **AI Operations**

    - [x] Integrate Rig-core tools

- **Utils Operations**

    - [x] Fetch price

        - [x] By Jupiter API

        - [x] By Pyth API

    - [x] Get wallet address of the agent

    - [x] Get the current transactions per second (TPS)

- **More...**

## 📦 Installation

```bash

[dependencies]

solagent = "0.1.4"

```

## Quick Start

```rust

use std::sync::Arc;

use solagent::create_solana_tools;

#[tokio::main]

async fn main() {

    let agent = Arc::new(SolAgent::new("private_key_bs58", "rpc_url", "openai_api_key"));

    let toolset = create_solana_tools(agent);

}

```

## Usage Examples

### Deploy a New Token

```rust

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 agent = Arc::new(SolAgent::new("private_key_bs58", "rpc_url", "openai_api_key"));

let mint_pubkey = agent

    .deploy_token(name, uri, symbol, decimals, Some(initial_supply)).await;

println!("Token Mint Address: {:?}", mint_pubkey);

```

### Create NFT Collection

```rust

let name = "solagent Collection";

let uri = "https://uri";

let royalty_basis_points = Some(500);

let creators = vec![(Pubkey::from_str_const("HHV3DX4UT4u3vBek2XCaZeAyox88zuhWfcLRJbFx1oYt"), 100)];

let options = NftMetadata::new(name, uri, royalty_basis_points, Some(creators));

let agent = Arc::new(SolAgent::new("private_key_bs58", "rpc_url", "openai_api_key"));

let tx = agent.deploy_collection(options).await.unwrap();

println!("Mint: {:?}", tx.0);

```

### Mint NFT to Collection

```rust

let name = "My First SolAgent NFT";

let uri = "https://uri.json";

let royalty_basis_points = Some(500);

let creators = vec![(Pubkey::from_str_const("8QB5VckaW3CWv4oZWiMLs1GkdrR5pVcjarAS1U6rG6Wh"), 100)];

let metadata = NftMetadata::new(name, uri, royalty_basis_points, Some(creators));

let collection = Pubkey::from_str_const("HHV3DX4UT4u3vBek2XCaZeAyox88zuhWfcLRJbFx1oYt");

let agent = Arc::new(SolAgent::new("private_key_bs58", "rpc_url", "openai_api_key"));

let deployed_data = agent.mint_nft_to_collection(collection, metadata).await.unwrap();

println!("Mint: {}", deployed_data.mint);

```

### Fetch Price Data from Pyth

```rust

let agent = Arc::new(SolAgent::new("private_key_bs58", "rpc_url", "openai_api_key"));

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](examples/).  

## 

## Contributing

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

## Contributors



  



## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=zTgx/solagent.rs&type=Date)](https://star-history.com/#zTgx/solagent.rs&Date)

## 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.