web3gateway 0.1.1

Web3Gateway - A Restful Web3 Gateway Service

🌐 Web3 Restful Gateway

A multi-chain Web3 gateway service that provides unified RESTful APIs for blockchain interaction.

🚀 Features

• 🔗 Multi-Chain Support: Seamlessly interact with multiple EVM-compatible blockchains
• 🔄 Real-time Data: Live blockchain data through Infura and Etherscan V2 API
• 🛡️ Battle-tested Security: Basic auth + rate limiting
• 🎯 High Performance: Redis caching for frequently accessed data
• 📊 Gas Optimization: Smart gas estimation and transaction cost prediction

🛠️ Tech Stack

• FastAPI: High-performance async web framework
• Web3.py: Ethereum interaction library
• Etherscan V2: Multi-chain data queries
• Redis: Query result caching
• Pydantic: Data validation and settings management

🔧 Quick Start

# Clone the repo
git clone https://github.com/daboooooo/web3gateway.git
# setup the environment
cd web3_restful_gateway
./setup.sh -i
# start the server
web3gateway

# Clone the repo
git clone https://github.com/yourusername/web3_restful_gateway.git

# Install dependencies
pip install -r requirements.txt

# Set up configuration
cp config.json.example config.json
# Edit config.json with your credentials

# Start the server
uvicorn web3gateway.main:app --reload

🔥 Core APIs

Transaction Operations

POST /transaction/assemble
POST /transaction/send
POST /transaction/get_receipt

Account Operations

POST /account/balance
POST /account/token_balance
POST /account/txlist

System Operations

GET /ping

🎮 API Example

# Get account balance
curl -X POST "http://localhost:8000/account/balance" \
  -H "Content-Type: application/json" \
  -u "username:password" \
  -d '{
    "chain_id": 1,
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  }'

🔌 Supported Networks

• Ethereum Mainnet (ChainID: 1)
• Binance Smart Chain (ChainID: 56)
• Polygon (ChainID: 137)
• Arbitrum (ChainID: 42161)
• Optimism (ChainID: 10)
• And more...

⚡️ Performance

• Response Time: < 100ms (cached)
• Throughput: 1000+ TPS
• Cache Hit Ratio: ~80%

🔒 Security Features

• Basic Authentication
• Rate Limiting
• Input Validation
• Error Handling
• Response Sanitization

🤝 Contributing

PRs are welcome! Check out our contribution guidelines.

📜 License

MIT License - fork, modify and use as you wish.

⚠️ Disclaimer

This is a production-ready gateway but use at your own risk. Always verify transactions before signing.