spoon-toolkits 0.1.3

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

🔍 Chainbase - Blockchain Data API Tools

Path: chainbase/

Comprehensive blockchain data query tools based on Chainbase API:

Chainbase Tools (chainbase_tools.py)

• GetLatestBlockNumberTool - Get the latest block height of blockchain network
• GetBlockByNumberTool - Get the block by number of blockchain network
• GetTransactionByHashTool - Get the transaction by hash of blockchain network
• GetAccountTransactionsTool - Returns the transactions from a specific wallet address
• ContractCallTool - Calls a specific function for the specified contract
• GetAccountTokensTool - Retrieve all token balances for all ERC20 tokens for a specified address
• GetAccountNFTsTool - Get the list of NFTs owned by an account
• GetAccountBalanceTool - Returns the native token balance for a specified address
• GetTokenMetadataTool - Get the metadata of a specified token

Balance Module (balance.py)

• Account Token Balances - Retrieve all ERC20 token balances for an address
• Account NFT Holdings - Get the list of NFTs owned by an account
• Native Token Balance - Query native token balance for an address

Basic Blockchain Module (basic.py)

• Block Data Queries - Get latest block number and block details
• Transaction Data - Retrieve transaction details by hash or block position
• Account Transactions - Get transaction history for an address
• Contract Function Calls - Execute read-only contract function calls

Token API Module (token_api.py)

• Token Metadata - Retrieve token contract metadata
• Token Holders Analysis - Get token holder distribution and top holders
• Token Price Data - Current and historical token price information
• Token Transfer History - Track ERC20 token transfers

💾 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"

# Chainbase API
export CHAINBASE_API_KEY="your_api_key"
export CHAINBASE_HOST="0.0.0.0"  # Optional, default is 0.0.0.0
export CHAINBASE_PORT="8000"     # Optional, default is 8000
export CHAINBASE_PATH="/sse"     # Optional, default is /sse

# 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")

5. Chainbase Tools

from spoon_toolkits.chainbase import GetLatestBlockNumberTool, GetAccountBalanceTool

# 获取以太坊最新区块
block_tool = GetLatestBlockNumberTool()
block_result = await block_tool.execute(chain_id=1)
print(f"最新区块: {block_result}")

# 获取账户ETH余额
balance_tool = GetAccountBalanceTool()
balance_result = await balance_tool.execute(
    chain_id=1,
    address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"  # vitalik.eth
)
print(f"账户余额: {balance_result}")

🔧 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.