spoon-toolkits 0.1.0

Comprehensive blockchain and cryptocurrency tools for SpoonAI

Spoon Toolkits

Spoon Toolkits is a comprehensive collection of blockchain and cryptocurrency tools that provides various specialized functional modules for SpoonAI. These tools cover multiple domains including security detection, price data, storage services, blockchain interaction, and more.

📁 Module Overview

🔒 GoPlusLabs - Security Detection Tools

Path: gopluslabs/

The GoPlusLabs module provides comprehensive blockchain security detection services, including:

• Token Security Detection (token_security.py)

  • Detect security risks in token contracts
  • Support for Ethereum and Solana networks
  • Detect honeypots, fake tokens, blacklisted addresses, and other risks

• Malicious Address Detection (malicious_address.py)

  • Identify known malicious addresses
  • Provide address risk assessment

• NFT Security Detection (nft_security.py)

  • NFT contract security analysis
  • Detect NFT-related risks

• DApp Security Detection (dapp_security.py)

  • Decentralized application security assessment
  • Smart contract risk analysis

• Phishing Site Detection (phishing_site.py)

  • Identify phishing websites
  • Provide website security assessment

• Rug Pull Detection (rug_pull_detection.py)

  • Detect potential rug pull risks
  • Project credibility assessment

• Approval Security Detection (approval_security.py)

  • Detect token approval risks
  • Analyze approval security

• Supported Chains (supported_chains.py)

  • Get list of supported blockchain networks
  • Chain ID and name mapping

💰 Crypto - Cryptocurrency Data Tools

Path: crypto/

Provides comprehensive cryptocurrency market data and analysis tools:

• Price Data (price_data.py)

  • Real-time token price retrieval
  • Support for DEXs like Uniswap and Raydium
  • K-line data and 24-hour statistics

• Price Alerts (price_alerts.py)

  • Price threshold monitoring
  • Liquidity range checking
  • Abnormal price movement detection

• Lending Rates (lending_rates.py)

  • DeFi lending protocol rate monitoring
  • Yield comparison analysis

• LST Arbitrage (lst_arbitrage.py)

  • Liquid staking token arbitrage opportunities
  • Cross-protocol yield analysis

• Blockchain Monitoring (blockchain_monitor.py)

  • Blockchain network status monitoring
  • Transaction pool monitoring

• Token Holder Analysis (token_holders.py)

  • Token holder distribution analysis
  • Whale address tracking

• Trading History (trading_history.py)

  • Transaction record queries
  • Historical data analysis

• Wallet Analysis (wallet_analysis.py)

  • Wallet behavior analysis
  • Portfolio analysis

• Uniswap Liquidity (uniswap_liquidity.py)

  • Uniswap liquidity pool analysis
  • LP yield calculation

🌐 Neo - Neo Blockchain Tools

Path: neo/

Specialized toolkit for Neo blockchain:

• Complete Neo N3 API Toolkit (tool_collection.py)

  • Address information queries
  • Asset information retrieval
  • Block and transaction queries
  • Smart contract interaction
  • Voting and governance functions
  • NEP-11/NEP-17 token operations

• GitHub Analysis (github_analysis.py)

  • Neo ecosystem project GitHub analysis
  • Code quality assessment

• Vote Queries (getScVoteCallByVoterAddress.py)

  • Voter address queries
  • Governance participation analysis

🌐 ThirdWeb - Web3 Development Tools

Path: third_web/

Blockchain data tools based on ThirdWeb Insight API:

• Contract Event Queries - Retrieve specific contract event logs
• Multi-chain Transfer Queries - Cross-chain transfer record queries
• Transaction Data Retrieval - Multi-chain transaction data retrieval
• Contract Transaction Analysis - Specific contract transaction analysis
• Block Data Queries - Block information retrieval
• Wallet Transaction History - Wallet address transaction records

💾 Storage - Decentralized Storage Tools

Path: storage/

Provides multiple decentralized storage solutions:

Base Storage Tools (base_storge_tool.py)

• S3-compatible storage interface
• Support for bucket operations, object upload/download
• Multipart upload support
• Pre-signed URL generation

AIOZ Storage (aioz/)

• AIOZ network storage services
• Decentralized content distribution

4EVERLAND Storage (foureverland/)

• 4EVERLAND decentralized storage
• IPFS-compatible interface

OORT Storage (oort/)

• OORT decentralized cloud storage
• Enterprise-grade storage solutions

🔄 Token Execute - Token Execution Tools

Path: token_execute/

Token operation and execution tools:

• Base Tools (base.py) - Token operation base class
• Token Transfer (token_transfer.py) - Token transfer functionality

🚀 Quick Start

Requirements

# Install dependencies
pip install -r requirements.txt

Environment Variable Configuration

# GoPlusLabs API
export GOPLUS_API_KEY="your_api_key"

# ThirdWeb
export THIRDWEB_CLIENT_ID="your_client_id"

# RPC Node
export RPC_URL="your_rpc_url"

# Storage Service Configuration
export AIOZ_ACCESS_KEY="your_access_key"
export AIOZ_SECRET_KEY="your_secret_key"
export FOUREVERLAND_ACCESS_KEY="your_access_key"
export FOUREVERLAND_SECRET_KEY="your_secret_key"
export OORT_ACCESS_KEY="your_access_key"
export OORT_SECRET_KEY="your_secret_key"

Usage Examples

1. Token Security Detection

from spoon_toolkits.gopluslabs.token_security import get_token_risk_and_security_data

# Detect Ethereum token security
result = await get_token_risk_and_security_data(
    chain_name="ethereum",
    contract_address="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
)

2. Get Token Price

from spoon_toolkits.crypto.price_data import GetTokenPriceTool

tool = GetTokenPriceTool()
result = await tool.execute(symbol="ETH-USDC", exchange="uniswap")

3. Neo Blockchain Query

from spoon_toolkits.neo.tool_collection import getAddressInfoByAddress

# Query Neo address information
address_info = getAddressInfoByAddress("NiEtVMWVYgpXrWkRTMwRaMJtJ41gD3912N")

4. Decentralized Storage

from spoon_toolkits.storage.aioz.aioz_tools import AiozStorageTool

tool = AiozStorageTool()
result = await tool.upload_file(bucket_name="my-bucket", file_path="./file.txt")

🔧 Tool Features

🛡️ Security

• Comprehensive security detection coverage
• Multi-dimensional risk assessment
• Real-time threat detection

📊 Data Richness

• Multi-chain data support
• Real-time price and market data
• Historical data analysis

🌐 Multi-chain Support

• Ethereum ecosystem
• Solana ecosystem
• Neo blockchain
• Other EVM-compatible chains

🔄 Easy Integration

• Unified tool interface
• Asynchronous operation support
• Detailed error handling

📖 API Documentation

Each module provides detailed API documentation and usage examples. Please refer to the source code comments in each module directory for specific documentation.

🤝 Contributing

1. Fork the project
2. Create a feature branch
3. Commit your changes
4. Create a Pull Request

📄 License

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

🆘 Support

For questions or suggestions, please submit an Issue or contact the development team.

---

Note: When using these tools, please ensure that you have properly configured the relevant API keys and environment variables. Some features may require paid API services.