solana-agent 29.2.0__tar.gz → 29.2.2__tar.gz

{solana_agent-29.2.0 → solana_agent-29.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 29.2.0
+Version: 29.2.2
 Summary: AI Agents for Solana
 License: MIT
 Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
@@ -41,9 +41,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
-[![Lines of Code](https://tokei.rs/b1/github/truemagic-coder/solana-agent?type=python&category=code&style=flat)](https://github.com/truemagic-coder/solana-agent)
 [![Ruff Style](https://img.shields.io/badge/style-ruff-41B5BE)](https://github.com/astral-sh/ruff)
-[![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent)](https://libraries.io/pypi/solana-agent)
 
 ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
 
@@ -56,7 +54,7 @@ Build your AI agents in three lines of code!
 * Simple Agent Definition
 * Fast Responses
 * Multi-Vendor Support
-* Solana Ecosystem Integration
+* Solana Integration
 * Multi-Agent Swarm
 * Multi-Modal (Images & Audio & Text)
 * Conversational Memory & History
@@ -81,7 +79,7 @@ Build your AI agents in three lines of code!
 * Simple agent definition using JSON
 * Fast AI responses
 * Multi-vendor support including OpenAI, Grok, and Gemini AI services
-* Solana Ecosystem Integration via [AgentiPy](https://github.com/niceberginc/agentipy)
+* Solana Integration with transfers and swaps
 * MCP tool usage with first-class support for [Zapier](https://zapier.com/mcp)
 * Integrated observability and tracing via [Pydantic Logfire](https://pydantic.dev/logfire)
 * Designed for a multi-agent swarm 
@@ -108,7 +106,6 @@ Build your AI agents in three lines of code!
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 * [Pinecone](https://pinecone.io) - Knowledge Base (optional)
-* [AgentiPy](https://agentipy.fun) - Solana Ecosystem (optional)
 * [Zapier](https://zapier.com) - App Integrations (optional)
 * [Pydantic Logfire](https://pydantic.dev/logfire) - Observability and Tracing (optional)
 
@@ -658,36 +655,68 @@ Tools empower agents to interact with external systems, fetch data, or perform a
 
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
-* Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
-* Agents choose the best tools for the job
-* Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
-* Solana Agent tools are async functions
+### Solana Transfer
 
-### Solana
+This plugin enables Solana Agent to transfer SOL and SPL tokens from the agent's wallet to the destination wallet.
+
+Don't use tickers - but mint addresses in your user queries.
 
 `pip install sakit`
 
 ```python
 config = {
     "tools": {
-        "solana": {
-            "private_key": "your-solana-wallet-private-key", # base58 encoded string
-            "rpc_url": "your-solana-rpc-url",
+        "solana_transfer": {
+            "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
+            "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
         },
     },
     "agents": [
         {
             "name": "solana_expert",
-            "instructions": "You are an expert Solana blockchain assistant. You always use the Solana tool to perform actions on the Solana blockchain.",
-            "specialization": "Solana blockchain interaction",
-            "tools": ["solana"],  # Enable the tool for this agent
+            "instructions": "You are a Solana expert that can transfer tokens.",
+            "specialization": "Solana Blockchain",
+            "tools": ["solana_transfer"], # Enable the tool for this agent
         }
-    ]
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "Transfer 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to DzvqBkUHUhuhHtNKGWSCVEAm2rHdm9bxxdQYC6mZBZyF"):
+    print(response, end="")
+```
+
+### Solana Swap
+
+This plugin enables Solana Agent to trade (swap) tokens using Jupiter.
+
+Don't use tickers - but mint addresses in your user queries.
+
+`pip install sakit`
+
+```python
+config = {
+    "tools": {
+        "solana_swap": {
+            "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
+            "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
+            "jupiter_url": "my-custom-url" # Optional - if you are using a custom Jupiter service like Metis from QuickNode
+        },
+    },
+    "agents": [
+        {
+            "name": "solana_expert",
+            "instructions": "You are a Solana expert that can swap tokens.",
+            "specialization": "Solana Blockchain",
+            "tools": ["solana_swap"], # Enable the tool for this agent
+        }
+    ],
 }
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What is my SOL balance?"):
+async for response in solana_agent.process("user123", "Swap 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to So11111111111111111111111111111111111111112"):
     print(response, end="")
 ```
 
@@ -739,7 +768,7 @@ from solana_agent import SolanaAgent
 config = {
     "tools": {
         "mcp": {
-            "urls": ["my-zapier-mcp-url"],
+            "url": "my-zapier-mcp-url",
         }
     },
     "agents": [

{solana_agent-29.2.0 → solana_agent-29.2.2}/README.md

@@ -6,9 +6,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
-[![Lines of Code](https://tokei.rs/b1/github/truemagic-coder/solana-agent?type=python&category=code&style=flat)](https://github.com/truemagic-coder/solana-agent)
 [![Ruff Style](https://img.shields.io/badge/style-ruff-41B5BE)](https://github.com/astral-sh/ruff)
-[![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent)](https://libraries.io/pypi/solana-agent)
 
 ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
 
@@ -21,7 +19,7 @@ Build your AI agents in three lines of code!
 * Simple Agent Definition
 * Fast Responses
 * Multi-Vendor Support
-* Solana Ecosystem Integration
+* Solana Integration
 * Multi-Agent Swarm
 * Multi-Modal (Images & Audio & Text)
 * Conversational Memory & History
@@ -46,7 +44,7 @@ Build your AI agents in three lines of code!
 * Simple agent definition using JSON
 * Fast AI responses
 * Multi-vendor support including OpenAI, Grok, and Gemini AI services
-* Solana Ecosystem Integration via [AgentiPy](https://github.com/niceberginc/agentipy)
+* Solana Integration with transfers and swaps
 * MCP tool usage with first-class support for [Zapier](https://zapier.com/mcp)
 * Integrated observability and tracing via [Pydantic Logfire](https://pydantic.dev/logfire)
 * Designed for a multi-agent swarm 
@@ -73,7 +71,6 @@ Build your AI agents in three lines of code!
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 * [Pinecone](https://pinecone.io) - Knowledge Base (optional)
-* [AgentiPy](https://agentipy.fun) - Solana Ecosystem (optional)
 * [Zapier](https://zapier.com) - App Integrations (optional)
 * [Pydantic Logfire](https://pydantic.dev/logfire) - Observability and Tracing (optional)
 
@@ -623,36 +620,68 @@ Tools empower agents to interact with external systems, fetch data, or perform a
 
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
-* Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
-* Agents choose the best tools for the job
-* Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
-* Solana Agent tools are async functions
+### Solana Transfer
 
-### Solana
+This plugin enables Solana Agent to transfer SOL and SPL tokens from the agent's wallet to the destination wallet.
+
+Don't use tickers - but mint addresses in your user queries.
 
 `pip install sakit`
 
 ```python
 config = {
     "tools": {
-        "solana": {
-            "private_key": "your-solana-wallet-private-key", # base58 encoded string
-            "rpc_url": "your-solana-rpc-url",
+        "solana_transfer": {
+            "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
+            "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
         },
     },
     "agents": [
         {
             "name": "solana_expert",
-            "instructions": "You are an expert Solana blockchain assistant. You always use the Solana tool to perform actions on the Solana blockchain.",
-            "specialization": "Solana blockchain interaction",
-            "tools": ["solana"],  # Enable the tool for this agent
+            "instructions": "You are a Solana expert that can transfer tokens.",
+            "specialization": "Solana Blockchain",
+            "tools": ["solana_transfer"], # Enable the tool for this agent
         }
-    ]
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "Transfer 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to DzvqBkUHUhuhHtNKGWSCVEAm2rHdm9bxxdQYC6mZBZyF"):
+    print(response, end="")
+```
+
+### Solana Swap
+
+This plugin enables Solana Agent to trade (swap) tokens using Jupiter.
+
+Don't use tickers - but mint addresses in your user queries.
+
+`pip install sakit`
+
+```python
+config = {
+    "tools": {
+        "solana_swap": {
+            "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
+            "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
+            "jupiter_url": "my-custom-url" # Optional - if you are using a custom Jupiter service like Metis from QuickNode
+        },
+    },
+    "agents": [
+        {
+            "name": "solana_expert",
+            "instructions": "You are a Solana expert that can swap tokens.",
+            "specialization": "Solana Blockchain",
+            "tools": ["solana_swap"], # Enable the tool for this agent
+        }
+    ],
 }
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What is my SOL balance?"):
+async for response in solana_agent.process("user123", "Swap 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to So11111111111111111111111111111111111111112"):
     print(response, end="")
 ```
 
@@ -704,7 +733,7 @@ from solana_agent import SolanaAgent
 config = {
     "tools": {
         "mcp": {
-            "urls": ["my-zapier-mcp-url"],
+            "url": "my-zapier-mcp-url",
         }
     },
     "agents": [

{solana_agent-29.2.0 → solana_agent-29.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "29.2.0"
+version = "29.2.2"
 description = "AI Agents for Solana"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"

{solana_agent-29.2.0 → solana_agent-29.2.2}/solana_agent/adapters/openai_adapter.py

@@ -163,8 +163,10 @@ class OpenAIAdapter(LLMProvider):
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
         model: Optional[str] = None,
-    ) -> str:  # pragma: no cover
-        """Generate text from OpenAI models as a single string (no images)."""
+        functions: Optional[List[Dict[str, Any]]] = None,
+        function_call: Optional[Union[str, Dict[str, Any]]] = None,
+    ) -> Any:  # pragma: no cover
+        """Generate text or function call from OpenAI models."""
         messages = []
         if system_prompt:
             messages.append({"role": "system", "content": system_prompt})
@@ -174,6 +176,10 @@ class OpenAIAdapter(LLMProvider):
             "messages": messages,
             "model": model or self.text_model,
         }
+        if functions:
+            request_params["functions"] = functions
+        if function_call:
+            request_params["function_call"] = function_call
 
         if api_key and base_url:
             client = AsyncOpenAI(api_key=api_key, base_url=base_url)
@@ -185,17 +191,13 @@ class OpenAIAdapter(LLMProvider):
 
         try:
             response = await client.chat.completions.create(**request_params)
-            if response.choices and response.choices[0].message.content:
-                return response.choices[0].message.content
-            else:
-                logger.warning("Received non-streaming response with no content.")
-                return ""
-        except OpenAIError as e:  # Catch specific OpenAI errors
+            return response
+        except OpenAIError as e:
             logger.error(f"OpenAI API error during text generation: {e}")
-            return f"I apologize, but I encountered an API error: {e}"
+            return None
         except Exception as e:
             logger.exception(f"Error in generate_text: {e}")
-            return f"I apologize, but I encountered an unexpected error: {e}"
+            return None
 
     def _calculate_gpt41_image_cost(self, width: int, height: int, model: str) -> int:
         """Calculates the token cost for an image with GPT-4.1 models."""

{solana_agent-29.2.0 → solana_agent-29.2.2}/solana_agent/interfaces/providers/llm.py

@@ -1,6 +1,8 @@
 from abc import ABC, abstractmethod
 from typing import (
+    Any,
     AsyncGenerator,
+    Dict,
     List,
     Literal,
     Optional,
@@ -26,7 +28,9 @@ class LLMProvider(ABC):
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
         model: Optional[str] = None,
-    ) -> str:
+        functions: Optional[List[Dict[str, Any]]] = None,
+        function_call: Optional[Union[str, Dict[str, Any]]] = None,
+    ) -> Any:
         """Generate text from the language model."""
         pass