blot-sdk 0.1.2__tar.gz

blot_sdk-0.1.2/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 BLOT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

blot_sdk-0.1.2/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: blot-sdk
+Version: 0.1.2
+Summary: Autonomous trading bots SDK for Solana - Self-replicating, AI-powered trading infrastructure
+Author-email: BLOT Team <dev@blot.cloud>
+License: MIT
+Project-URL: Homepage, https://blot.cloud
+Project-URL: Documentation, https://blot.cloud/docs
+Project-URL: PyPI, https://pypi.org/project/blot-sdk
+Keywords: solana,trading,bot,defi,cryptocurrency,autonomous,ai,openclaw
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: solana>=0.30.0
+Requires-Dist: solders>=0.18.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: websockets>=11.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# BLOT SDK
+
+**Autonomous trading bots for Solana** — Self-replicating, AI-powered trading infrastructure.
+
+[![PyPI version](https://badge.fury.io/py/blot-sdk.svg)](https://badge.fury.io/py/blot-sdk)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **AI-Powered** — Integrated with OpenClaw for intelligent decision making
+- **24/7 Autonomous** — Bots run continuously without human intervention
+- **Self-Cloning** — Automatic replication across distributed nodes for maximum resilience
+- **Zero-Logging** — Complete privacy, no transaction data stored
+- **High Speed** — Sub-50ms execution on Solana
+- **Easy to Use** — Simple Python API for complex trading strategies
+
+## Installation
+
+```bash
+pip install blot-sdk
+```
+
+## Quick Start
+
+```python
+from blot_sdk import Bot, SniperBot, DCABot
+
+# Initialize with your wallet
+bot = Bot(
+    private_key="your_private_key",
+    rpc_url="https://api.mainnet-beta.solana.com"
+)
+
+# Create a sniper bot
+sniper = SniperBot(
+    target="new",           # Snipe all new tokens
+    buy_amount=0.5,         # Buy with 0.5 SOL
+    take_profit=[2.0, 5.0], # Sell at 2x and 5x
+    stop_loss=0.5,          # Stop loss at -50%
+)
+
+# Deploy to BLOT infrastructure
+bot.deploy(sniper, duration_days=30)
+```
+
+## Available Bots
+
+### Sniper Bot
+Instantly purchase tokens the moment liquidity is added.
+
+```python
+from blot_sdk import SniperBot
+
+bot = SniperBot(
+    target="new",
+    buy_amount=0.5,
+    min_liquidity=10,
+    take_profit=[2.0, 5.0, 10.0],
+    stop_loss=0.5,
+    check_honeypot=True,
+    check_rug=True,
+)
+```
+
+### DCA Bot
+Dollar-cost averaging into any Solana token.
+
+```python
+from blot_sdk import DCABot
+
+bot = DCABot(
+    token="SOL",
+    amount=100,              # USDC per purchase
+    frequency="daily",
+    time="09:00",
+    buy_only_below=150,      # Only buy if SOL < $150
+)
+```
+
+### Copy Trade Bot
+Mirror the trades of successful wallets.
+
+```python
+from blot_sdk import CopyTradeBot
+
+bot = CopyTradeBot(
+    wallets=["wallet1...", "wallet2..."],
+    size_mode="percentage",
+    size_value=10,           # 10% of their trade size
+    copy_sells=True,
+)
+```
+
+### Grid Bot
+Profit from sideways markets with automated grid trading.
+
+```python
+from blot_sdk import GridBot
+
+bot = GridBot(
+    base_token="SOL",
+    quote_token="USDC",
+    lower_price=120,
+    upper_price=180,
+    grid_count=20,
+    total_investment=100,
+)
+```
+
+## Autonomy & Self-Preservation
+
+BLOT bots operate 24/7 without downtime, automatically clone themselves across distributed nodes, and execute trades with zero human intervention:
+
+```python
+from blot_sdk import Bot
+
+bot = Bot(private_key="...")
+
+# Enable 24/7 autonomous operation
+bot.enable_autonomy(
+    mode="persistent",
+    auto_restart=True,
+    health_checks=True
+)
+
+# Enable self-cloning on threat detection
+bot.enable_self_cloning(
+    trigger="on_threat",
+    target_nodes=3,
+    regions=["us", "eu", "asia"]
+)
+
+# Zero-logging mode for privacy
+bot.set_logging(enabled=False)
+
+# Auto-migrate if node goes down
+bot.on_node_failure(action="migrate", priority="immediate")
+```
+
+## Self-Cloning
+
+BLOT bots automatically clone themselves across distributed nodes:
+
+```python
+from blot_sdk import SniperBot
+
+bot = SniperBot(
+    # ... config ...
+    clone_count=5,                    # Minimum active clones
+    regions=["us", "eu", "asia"],     # Geographic distribution
+    failover_timeout=100,             # ms before electing new leader
+)
+```
+
+## AI Integration
+
+Leverage OpenClaw AI for intelligent trading decisions:
+
+```python
+from blot_sdk import Bot, AI
+
+bot = Bot(private_key="...")
+
+# AI-powered market analysis
+analysis = await bot.ai.analyze_token("JUP")
+print(analysis.sentiment)      # bullish/bearish
+print(analysis.risk_score)     # 0-100
+print(analysis.recommendation) # buy/sell/hold
+
+# AI-filtered copy trading
+copy_bot = CopyTradeBot(
+    wallets=["..."],
+    ai_filter=True,
+    ai_confidence_threshold=0.7,
+)
+```
+
+## Documentation
+
+Full documentation available at [blot.cloud/docs](https://blot.cloud/docs)
+
+## Requirements
+
+- Python 3.9+
+- Solana wallet with SOL for transaction fees
+- $BLOT tokens for runtime access
+
+## Links
+
+- Website: [blot.cloud](https://blot.cloud)
+- Documentation: [blot.cloud/docs](https://blot.cloud/docs)
+- PyPI: [pypi.org/project/blot-sdk](https://pypi.org/project/blot-sdk)
+- X: [@bloboratory](https://x.com/bloboratory)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

blot_sdk-0.1.2/README.md

@@ -0,0 +1,198 @@
+# BLOT SDK
+
+**Autonomous trading bots for Solana** — Self-replicating, AI-powered trading infrastructure.
+
+[![PyPI version](https://badge.fury.io/py/blot-sdk.svg)](https://badge.fury.io/py/blot-sdk)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **AI-Powered** — Integrated with OpenClaw for intelligent decision making
+- **24/7 Autonomous** — Bots run continuously without human intervention
+- **Self-Cloning** — Automatic replication across distributed nodes for maximum resilience
+- **Zero-Logging** — Complete privacy, no transaction data stored
+- **High Speed** — Sub-50ms execution on Solana
+- **Easy to Use** — Simple Python API for complex trading strategies
+
+## Installation
+
+```bash
+pip install blot-sdk
+```
+
+## Quick Start
+
+```python
+from blot_sdk import Bot, SniperBot, DCABot
+
+# Initialize with your wallet
+bot = Bot(
+    private_key="your_private_key",
+    rpc_url="https://api.mainnet-beta.solana.com"
+)
+
+# Create a sniper bot
+sniper = SniperBot(
+    target="new",           # Snipe all new tokens
+    buy_amount=0.5,         # Buy with 0.5 SOL
+    take_profit=[2.0, 5.0], # Sell at 2x and 5x
+    stop_loss=0.5,          # Stop loss at -50%
+)
+
+# Deploy to BLOT infrastructure
+bot.deploy(sniper, duration_days=30)
+```
+
+## Available Bots
+
+### Sniper Bot
+Instantly purchase tokens the moment liquidity is added.
+
+```python
+from blot_sdk import SniperBot
+
+bot = SniperBot(
+    target="new",
+    buy_amount=0.5,
+    min_liquidity=10,
+    take_profit=[2.0, 5.0, 10.0],
+    stop_loss=0.5,
+    check_honeypot=True,
+    check_rug=True,
+)
+```
+
+### DCA Bot
+Dollar-cost averaging into any Solana token.
+
+```python
+from blot_sdk import DCABot
+
+bot = DCABot(
+    token="SOL",
+    amount=100,              # USDC per purchase
+    frequency="daily",
+    time="09:00",
+    buy_only_below=150,      # Only buy if SOL < $150
+)
+```
+
+### Copy Trade Bot
+Mirror the trades of successful wallets.
+
+```python
+from blot_sdk import CopyTradeBot
+
+bot = CopyTradeBot(
+    wallets=["wallet1...", "wallet2..."],
+    size_mode="percentage",
+    size_value=10,           # 10% of their trade size
+    copy_sells=True,
+)
+```
+
+### Grid Bot
+Profit from sideways markets with automated grid trading.
+
+```python
+from blot_sdk import GridBot
+
+bot = GridBot(
+    base_token="SOL",
+    quote_token="USDC",
+    lower_price=120,
+    upper_price=180,
+    grid_count=20,
+    total_investment=100,
+)
+```
+
+## Autonomy & Self-Preservation
+
+BLOT bots operate 24/7 without downtime, automatically clone themselves across distributed nodes, and execute trades with zero human intervention:
+
+```python
+from blot_sdk import Bot
+
+bot = Bot(private_key="...")
+
+# Enable 24/7 autonomous operation
+bot.enable_autonomy(
+    mode="persistent",
+    auto_restart=True,
+    health_checks=True
+)
+
+# Enable self-cloning on threat detection
+bot.enable_self_cloning(
+    trigger="on_threat",
+    target_nodes=3,
+    regions=["us", "eu", "asia"]
+)
+
+# Zero-logging mode for privacy
+bot.set_logging(enabled=False)
+
+# Auto-migrate if node goes down
+bot.on_node_failure(action="migrate", priority="immediate")
+```
+
+## Self-Cloning
+
+BLOT bots automatically clone themselves across distributed nodes:
+
+```python
+from blot_sdk import SniperBot
+
+bot = SniperBot(
+    # ... config ...
+    clone_count=5,                    # Minimum active clones
+    regions=["us", "eu", "asia"],     # Geographic distribution
+    failover_timeout=100,             # ms before electing new leader
+)
+```
+
+## AI Integration
+
+Leverage OpenClaw AI for intelligent trading decisions:
+
+```python
+from blot_sdk import Bot, AI
+
+bot = Bot(private_key="...")
+
+# AI-powered market analysis
+analysis = await bot.ai.analyze_token("JUP")
+print(analysis.sentiment)      # bullish/bearish
+print(analysis.risk_score)     # 0-100
+print(analysis.recommendation) # buy/sell/hold
+
+# AI-filtered copy trading
+copy_bot = CopyTradeBot(
+    wallets=["..."],
+    ai_filter=True,
+    ai_confidence_threshold=0.7,
+)
+```
+
+## Documentation
+
+Full documentation available at [blot.cloud/docs](https://blot.cloud/docs)
+
+## Requirements
+
+- Python 3.9+
+- Solana wallet with SOL for transaction fees
+- $BLOT tokens for runtime access
+
+## Links
+
+- Website: [blot.cloud](https://blot.cloud)
+- Documentation: [blot.cloud/docs](https://blot.cloud/docs)
+- PyPI: [pypi.org/project/blot-sdk](https://pypi.org/project/blot-sdk)
+- X: [@bloboratory](https://x.com/bloboratory)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

blot_sdk-0.1.2/blot/__init__.py

@@ -0,0 +1,28 @@
+"""
+BLOT SDK - Autonomous Trading Bots for Solana
+
+Self-replicating, AI-powered trading infrastructure.
+"""
+
+__version__ = "0.1.0"
+__author__ = "BLOT Team"
+
+from blot.bot import Bot
+from blot.bots.sniper import SniperBot
+from blot.bots.dca import DCABot
+from blot.bots.copy_trade import CopyTradeBot
+from blot.bots.grid import GridBot
+from blot.ai import AI
+from blot.config import Config
+
+__all__ = [
+    "Bot",
+    "SniperBot",
+    "DCABot",
+    "CopyTradeBot",
+    "GridBot",
+    "AI",
+    "Config",
+    "__version__",
+]
+

blot_sdk-0.1.2/blot/ai.py

@@ -0,0 +1,161 @@
+"""AI integration for BLOT SDK - Powered by OpenClaw."""
+
+from dataclasses import dataclass
+from typing import Optional, Literal
+from enum import Enum
+
+from blot.config import Config
+
+
+class Sentiment(str, Enum):
+    """Market sentiment."""
+    BULLISH = "bullish"
+    BEARISH = "bearish"
+    NEUTRAL = "neutral"
+
+
+class Recommendation(str, Enum):
+    """Trading recommendation."""
+    BUY = "buy"
+    SELL = "sell"
+    HOLD = "hold"
+
+
+@dataclass
+class TokenAnalysis:
+    """Result of AI token analysis."""
+    
+    token: str
+    sentiment: Sentiment
+    risk_score: int  # 0-100
+    recommendation: Recommendation
+    confidence: float  # 0-1
+    reasons: list[str]
+    
+    @property
+    def is_promising(self) -> bool:
+        """Check if token looks promising based on analysis."""
+        return (
+            self.sentiment == Sentiment.BULLISH
+            and self.risk_score < 50
+            and self.confidence > 0.7
+        )
+
+
+@dataclass
+class MarketAnalysis:
+    """Result of AI market analysis."""
+    
+    token: str
+    signal: Literal["BUY", "SELL", "HOLD"]
+    strength: float  # 0-1
+    support_level: Optional[float]
+    resistance_level: Optional[float]
+    trend: Literal["up", "down", "sideways"]
+
+
+class AI:
+    """AI assistant for market analysis - Powered by OpenClaw.
+    
+    Example:
+        ```python
+        from blot import Bot
+        
+        bot = Bot(private_key="...")
+        
+        # Analyze a token
+        analysis = await bot.ai.analyze_token("JUP")
+        print(analysis.sentiment)      # bullish/bearish
+        print(analysis.risk_score)     # 0-100
+        print(analysis.recommendation) # buy/sell/hold
+        
+        # Check if token is promising
+        if analysis.is_promising:
+            print("Token looks good!")
+        ```
+    """
+    
+    def __init__(self, config: Optional[Config] = None):
+        self.config = config or Config()
+    
+    async def analyze_token(self, token: str) -> TokenAnalysis:
+        """Analyze a token using AI.
+        
+        Args:
+            token: Token symbol or address.
+            
+        Returns:
+            TokenAnalysis with AI insights.
+        """
+        # TODO: Implement actual AI analysis via OpenClaw API
+        return TokenAnalysis(
+            token=token,
+            sentiment=Sentiment.NEUTRAL,
+            risk_score=50,
+            recommendation=Recommendation.HOLD,
+            confidence=0.5,
+            reasons=["Analysis pending - connect to BLOT infrastructure"],
+        )
+    
+    async def analyze_market(self, token: str) -> MarketAnalysis:
+        """Analyze market conditions for a token.
+        
+        Args:
+            token: Token symbol or address.
+            
+        Returns:
+            MarketAnalysis with trading signals.
+        """
+        # TODO: Implement actual market analysis
+        return MarketAnalysis(
+            token=token,
+            signal="HOLD",
+            strength=0.5,
+            support_level=None,
+            resistance_level=None,
+            trend="sideways",
+        )
+    
+    async def check_honeypot(self, token_address: str) -> bool:
+        """Check if a token is a honeypot.
+        
+        Args:
+            token_address: Token contract address.
+            
+        Returns:
+            True if token appears to be a honeypot.
+        """
+        # TODO: Implement honeypot detection
+        return False
+    
+    async def check_rug_risk(self, token_address: str) -> float:
+        """Assess rug pull risk for a token.
+        
+        Args:
+            token_address: Token contract address.
+            
+        Returns:
+            Risk score from 0.0 (safe) to 1.0 (high risk).
+        """
+        # TODO: Implement rug pull detection
+        return 0.5
+    
+    async def analyze_wallet(self, wallet_address: str) -> dict:
+        """Analyze a wallet's trading performance.
+        
+        Args:
+            wallet_address: Wallet address to analyze.
+            
+        Returns:
+            Dict with wallet statistics and performance metrics.
+        """
+        # TODO: Implement wallet analysis
+        return {
+            "address": wallet_address,
+            "win_rate": 0.0,
+            "total_trades": 0,
+            "profit_loss": 0.0,
+            "avg_hold_time": "unknown",
+            "top_tokens": [],
+        }
+