solana-agent 29.2.2__py3-none-any.whl → 29.2.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: solana-agent
3
- Version: 29.2.2
3
+ Version: 29.2.3
4
4
  Summary: AI Agents for Solana
5
5
  License: MIT
6
6
  Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
@@ -79,7 +79,7 @@ Build your AI agents in three lines of code!
79
79
  * Simple agent definition using JSON
80
80
  * Fast AI responses
81
81
  * Multi-vendor support including OpenAI, Grok, and Gemini AI services
82
- * Solana Integration with transfers and swaps
82
+ * Solana Integration
83
83
  * MCP tool usage with first-class support for [Zapier](https://zapier.com/mcp)
84
84
  * Integrated observability and tracing via [Pydantic Logfire](https://pydantic.dev/logfire)
85
85
  * Designed for a multi-agent swarm
@@ -655,212 +655,12 @@ Tools empower agents to interact with external systems, fetch data, or perform a
655
655
 
656
656
  Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
657
657
 
658
- ### Solana Transfer
659
-
660
- This plugin enables Solana Agent to transfer SOL and SPL tokens from the agent's wallet to the destination wallet.
661
-
662
- Don't use tickers - but mint addresses in your user queries.
663
-
664
- `pip install sakit`
665
-
666
- ```python
667
- config = {
668
- "tools": {
669
- "solana_transfer": {
670
- "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
671
- "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
672
- },
673
- },
674
- "agents": [
675
- {
676
- "name": "solana_expert",
677
- "instructions": "You are a Solana expert that can transfer tokens.",
678
- "specialization": "Solana Blockchain",
679
- "tools": ["solana_transfer"], # Enable the tool for this agent
680
- }
681
- ],
682
- }
683
-
684
- solana_agent = SolanaAgent(config=config)
685
-
686
- async for response in solana_agent.process("user123", "Transfer 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to DzvqBkUHUhuhHtNKGWSCVEAm2rHdm9bxxdQYC6mZBZyF"):
687
- print(response, end="")
688
- ```
689
-
690
- ### Solana Swap
691
-
692
- This plugin enables Solana Agent to trade (swap) tokens using Jupiter.
693
-
694
- Don't use tickers - but mint addresses in your user queries.
695
-
696
- `pip install sakit`
697
-
698
- ```python
699
- config = {
700
- "tools": {
701
- "solana_swap": {
702
- "rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
703
- "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
704
- "jupiter_url": "my-custom-url" # Optional - if you are using a custom Jupiter service like Metis from QuickNode
705
- },
706
- },
707
- "agents": [
708
- {
709
- "name": "solana_expert",
710
- "instructions": "You are a Solana expert that can swap tokens.",
711
- "specialization": "Solana Blockchain",
712
- "tools": ["solana_swap"], # Enable the tool for this agent
713
- }
714
- ],
715
- }
716
-
717
- solana_agent = SolanaAgent(config=config)
718
-
719
- async for response in solana_agent.process("user123", "Swap 0.01 Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB to So11111111111111111111111111111111111111112"):
720
- print(response, end="")
721
- ```
722
-
723
- ### Internet Search
724
-
725
- `pip install sakit`
726
-
727
- ```python
728
- from solana_agent import SolanaAgent
729
-
730
- config = {
731
- "openai": {
732
- "api_key": "your-openai-api-key",
733
- },
734
- "tools": {
735
- "search_internet": {
736
- "api_key": "your-openai-api-key",
737
- },
738
- },
739
- "agents": [
740
- {
741
- "name": "news_specialist",
742
- "instructions": "You are an expert news agent. You use your search_internet tool to get the latest information.",
743
- "specialization": "News researcher and specialist",
744
- "tools": ["search_internet"], # Enable the tool for this agent
745
- }
746
- ],
747
- }
748
-
749
- solana_agent = SolanaAgent(config=config)
750
-
751
- async for response in solana_agent.process("user123", "What is the latest news on Elon Musk?"):
752
- print(response, end="")
753
- ```
754
-
755
- ### MCP
658
+ ### Solana Agent Kit
756
659
 
757
- [Zapier](https://zapier.com/mcp) MCP has been tested, works, and is supported.
758
-
759
- Zapier integrates over 7,000+ apps with 30,000+ actions that your Solana Agent can utilize.
760
-
761
- Other MCP servers may work but are not supported.
762
-
763
- `pip install sakit`
764
-
765
- ```python
766
- from solana_agent import SolanaAgent
767
-
768
- config = {
769
- "tools": {
770
- "mcp": {
771
- "url": "my-zapier-mcp-url",
772
- }
773
- },
774
- "agents": [
775
- {
776
- "name": "zapier_expert",
777
- "instructions": "You are an expert in using Zapier integrations using MCP. You always use the mcp tool to perform Zapier AI like actions.",
778
- "specialization": "Zapier service integration expert",
779
- "tools": ["mcp"], # Enable the tool for this agent
780
- }
781
- ]
782
- }
783
-
784
- solana_agent = SolanaAgent(config=config)
785
-
786
- async for response in solana_agent.process("user123", "Send an email to bob@bob.com to clean his room!"):
787
- print(response, end="")
788
- ```
789
-
790
- ### Image Generation
791
-
792
- Generate images using OpenAI, Grok, or Gemini image models and upload them to S3-compatible storage.
793
-
794
- `pip install sakit`
795
-
796
- ```python
797
- from solana_agent import SolanaAgent
798
-
799
- config = {
800
- "tools": {
801
- "image_gen": {
802
- "provider": "openai", # Required: either "openai", "grok", or "gemini"
803
- "api_key": "your-api-key", # Required: your OpenAI or Grok or Gemini API key
804
- "s3_endpoint_url": "https://your-s3-endpoint.com", # Required: e.g., https://nyc3.digitaloceanspaces.com
805
- "s3_access_key_id": "YOUR_S3_ACCESS_KEY", # Required: Your S3 access key ID
806
- "s3_secret_access_key": "YOUR_S3_SECRET_KEY", # Required: Your S3 secret access key
807
- "s3_bucket_name": "your-bucket-name", # Required: The name of your S3 bucket
808
- "s3_region_name": "your-region", # Optional: e.g., "nyc3", needed by some providers
809
- "s3_public_url_base": "https://your-cdn-or-bucket-url.com/", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.
810
- }
811
- },
812
- "agents": [
813
- {
814
- "name": "image_creator",
815
- "instructions": "You are a creative assistant that generates images based on user descriptions. Use the image_gen tool to create and store the image.",
816
- "specialization": "Image generation and storage",
817
- "tools": ["image_gen"], # Enable the tool for this agent
818
- }
819
- ]
820
- }
821
-
822
- solana_agent = SolanaAgent(config=config)
823
-
824
- async for response in solana_agent.process("user123", "Generate an image of a smiling unicorn!"):
825
- print(response, end="")
826
- ```
827
-
828
- ### Nemo Agent
829
-
830
- This plugin allows the agent to generate python programs using [Nemo Agent](https://nemo-agent.com) and uploads the files in a ZIP file to s3-compatible storage. It returns the public URL of the zip file.
831
-
832
- This has been tested using [Cloudflare R2](https://developers.cloudflare.com/r2/).
833
-
834
- ```python
835
- from solana_agent import SolanaAgent
836
-
837
- config = {
838
- "tools": {
839
- "nemo_agent": {
840
- "provider": "openai", # Required: either "openai" or "gemini"
841
- "api_key": "your-api-key", # Required: your OpenAI or Gemini API key
842
- "s3_endpoint_url": "https://your-s3-endpoint.com", # Required: e.g., https://nyc3.digitaloceanspaces.com
843
- "s3_access_key_id": "YOUR_S3_ACCESS_KEY", # Required: Your S3 access key ID
844
- "s3_secret_access_key": "YOUR_S3_SECRET_KEY", # Required: Your S3 secret access key
845
- "s3_bucket_name": "your-bucket-name", # Required: The name of your S3 bucket
846
- "s3_region_name": "your-region", # Optional: e.g., "nyc3", needed by some providers
847
- "s3_public_url_base": "https://your-cdn-or-bucket-url.com/", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.
848
- }
849
- },
850
- "agents": [
851
- {
852
- "name": "python_dev",
853
- "instructions": "You are an expert Python Developer. You always use your nemo_agent tool to generate python code.",
854
- "specialization": "Python Developer",
855
- "tools": ["nemo_agent"], # Enable the tool for this agent
856
- }
857
- ]
858
- }
859
-
860
- solana_agent = SolanaAgent(config=config)
660
+ [Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
861
661
 
862
- async for response in solana_agent.process("user123", "Generate an example leetcode medium in Python and give me the zip file."):
863
- print(response, end="")
662
+ ```bash
663
+ pip install sakit
864
664
  ```
865
665
 
866
666
  ### Inline Tool Example
@@ -36,8 +36,8 @@ solana_agent/services/agent.py,sha256=q5cYzY6Jp5HFtYgJtrqTBWp5Z2n3dXdpQ5YScSKfvP
36
36
  solana_agent/services/knowledge_base.py,sha256=ZvOPrSmcNDgUzz4bJIQ4LeRl9vMZiK9hOfs71IpB7Bk,32735
37
37
  solana_agent/services/query.py,sha256=ENUfs4WSTpODMRXppDVW-Y3li9jYn8pOfQIHIPerUdQ,18498
38
38
  solana_agent/services/routing.py,sha256=C5Ku4t9TqvY7S8wlUPMTC04HCrT4Ib3E8Q8yX0lVU_s,7137
39
- solana_agent-29.2.2.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
40
- solana_agent-29.2.2.dist-info/METADATA,sha256=cCliPjVhs1OYUrlewGZDXyRvASDLRKMgrC2g7DPzaYY,36578
41
- solana_agent-29.2.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
42
- solana_agent-29.2.2.dist-info/entry_points.txt,sha256=-AuT_mfqk8dlZ0pHuAjx1ouAWpTRjpqvEUa6YV3lmc0,53
43
- solana_agent-29.2.2.dist-info/RECORD,,
39
+ solana_agent-29.2.3.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
40
+ solana_agent-29.2.3.dist-info/METADATA,sha256=tQgYee62kteB-uJScA1UsE6GItQpJQe63AY7AR2nWJ0,28982
41
+ solana_agent-29.2.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
42
+ solana_agent-29.2.3.dist-info/entry_points.txt,sha256=-AuT_mfqk8dlZ0pHuAjx1ouAWpTRjpqvEUa6YV3lmc0,53
43
+ solana_agent-29.2.3.dist-info/RECORD,,