Metadata-Version: 2.1
Name: solana-agentkit
Version: 0.1.3
Summary: A Python toolkit for building AI agents on Solana
Home-page: https://github.com/arhansuba/solana-agentkit
Author: Arhan Subaşı
Author-email: subasiarhan3@gmail.com
Project-URL: Bug Tracker, https://github.com/arhansuba/solana-agentkit/issues
Project-URL: Documentation, https://solana-agentkit.readthedocs.io/
Project-URL: Source Code, https://github.com/arhansuba/solana-agentkit
Keywords: solana,blockchain,artificial-intelligence,ai-agents,cryptocurrency,web3,defi,nft
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: solana>=0.30.0
Requires-Dist: anchorpy>=0.14.0
Requires-Dist: base58>=2.1.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: langchain>=0.0.200
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: numpy>=1.21.0
Requires-Dist: Pillow>=9.0.0
Requires-Dist: requests>=2.26.0
Requires-Dist: pydantic>=1.8.2
Requires-Dist: web3>=6.0.0
Requires-Dist: cryptography>=3.4.0
Requires-Dist: pytest>=6.2.5
Requires-Dist: pytest-asyncio>=0.18.0
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: dev
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: isort>=5.10.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Requires-Dist: pylint>=2.12.0; extra == "dev"
Requires-Dist: pytest>=6.2.5; extra == "dev"
Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=4.5.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints>=1.18.0; extra == "docs"

# Solana AgentKit Documentation

Welcome to the Solana AgentKit documentation! This Python package provides tools and utilities for building AI agents that can interact with the Solana blockchain.

## Quick Start

### Installation

```bash
# Basic installation
pip install solana-agentkit

# With development tools
pip install solana-agentkit[dev]

# With documentation tools
pip install solana-agentkit[docs]
```

### Basic Usage

```python
from solana_agentkit import SolanaAgent
from solana_agentkit.tools import transfer_tokens, get_balance

# Initialize agent
agent = SolanaAgent(
    private_key="your_private_key",
    rpc_url="https://api.mainnet-beta.solana.com"
)

# Check balance
balance = await agent.get_balance()
print(f"Current balance: {balance} SOL")

# Transfer tokens
result = await agent.transfer(
    to="recipient_address",
    amount=1.0
)
print(f"Transfer successful: {result.signature}")
```

## Features

### Core Components

- **Agent Framework**: Build and deploy AI agents on Solana
- **Transaction Tools**: Simplified transaction creation and management
- **NFT Utilities**: Create and manage NFT collections
- **Token Tools**: Deploy and manage SPL tokens
- **Domain Management**: Register and manage .sol domains

### AI Integration

- LangChain integration for AI capabilities
- OpenAI integration for image generation
- Custom agent behaviors and personalities
- Natural language processing for commands

### Blockchain Features

- Wallet management
- Transaction building
- Priority fee handling
- Multi-signature support

## Development

### Setup Development Environment

```bash
# Clone repository
git clone https://github.com/arhansuba/solana-agentkit
cd solana-agentkit

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Unix
# or
.\venv\Scripts\activate  # Windows

# Install development dependencies
pip install -r requirements.txt
```

### Running Tests

```bash
# Run all tests
pytest tests/

# Run with coverage
pytest --cov=solana_agentkit tests/
```

### Code Style

We use Black for code formatting and isort for import sorting:

```bash
# Format code
black src/ tests/

# Sort imports
isort src/ tests/
```

## Project Structure

```
solana-agentkit/
├── docs/               # Documentation
├── src/               # Source code
│   └── solana_agentkit/
│       ├── agent/     # Agent implementations
│       ├── tools/     # Blockchain tools
│       └── utils/     # Utility functions
├── tests/             # Test suite
└── examples/          # Usage examples
```

## Missing Core Features:

plaintextCopysolana_agentkit/
├── protocols/            # New module for additional DeFi protocols
│   ├── jupiter/         # Jupiter DEX integration
│   ├── orca/           # Orca DEX integration
│   └── solend/         # Lending protocol integration
├── analytics/           # New module for on-chain analytics
│   ├── price/          # Price analysis and feeds
│   ├── volume/         # Volume analysis
│   └── metrics/        # General protocol metrics
├── security/           # New module for security features
│   ├── validation/     # Input validation
│   └── verification/   # Transaction verification
└── monitoring/         # New module for monitoring
    ├── events/         # Event monitoring
    └── alerts/         # Alert system

Missing Tool Categories:

plaintextCopysolana_agentkit/tools/
├── defi/               # DeFi-specific tools
│   ├── yield_farming.py
│   └── liquidity_mining.py
├── governance/         # Governance tools
│   ├── proposal.py
│   └── vote.py
├── analytics/          # Analytics tools
│   ├── market_analysis.py
│   └── portfolio_tracking.py
└── automation/         # Automation tools
    ├── strategy.py
    └── scheduler.py

Utility Enhancements:

plaintextCopysolana_agentkit/utils/
├── cache/             # Caching utilities
├── rate_limiting/     # Rate limiting
├── error_handling/    # Enhanced error handling
└── logging/          # Logging utilities

Testing Infrastructure:

plaintextCopytests/
├── unit/             # Unit tests
├── integration/      # Integration tests
├── e2e/             # End-to-end tests
└── fixtures/        # Test fixtures

Documentation:

plaintextCopydocs/
├── api/             # API documentation
├── tutorials/       # Usage tutorials
├── examples/        # Example implementations
└── protocols/       # Protocol documentation
Key missing features:

Protocol Integrations:


Jupiter integration for optimal routing
Orca integration for concentrated liquidity
Solend integration for lending operations
Marinade integration for liquid staking


Analytics & Monitoring:


Price feed integration
Market analytics
Portfolio tracking
Event monitoring
Alert system


Enhanced Security:


Input validation framework
Transaction simulation
Risk assessment
Rate limiting


Advanced Tools:


Yield farming strategies
Liquidity mining tools
Portfolio management
Governance integration
Automated trading strategies


Infrastructure:


Caching system
Error handling framework
Logging system
Rate limiting
Performance monitoring

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Support

- GitHub Issues: [Report bugs](https://github.com/arhansuba/solana-agentkit/issues)
- Documentation: [Read the docs](https://solana-agentkit.readthedocs.io/)
- Discord: [Join our community](#)

## Acknowledgments

- Solana Foundation
- LangChain team
- All contributors# solana-agentkit
