🔗 Velvet Chain

A decentralized, EVM-compatible blockchain that anyone can mine!

🌟 Features

✅ True Decentralization - Anyone can run a node and mine
✅ EVM Compatible - Works with MetaMask and Web3 tools
✅ Fair Mining - Proof of Work with automatic difficulty adjustment
✅ Easy Setup - Get mining in under 5 minutes
✅ Beautiful Explorer - Track blocks and transactions in real-time
✅ Auto Peer Discovery - Connects to the network automatically
✅ Mining Rewards - Earn 50 VELVET per block

🚀 Quick Start

Prerequisites

Python 3.8 or higher
MetaMask wallet (optional, for sending transactions)

Installation

Clone the repository

git clone https://github.com/freedomparrot/velvet-chain.git
cd velvet-chain

Install dependencies

pip install -r requirements.txt

Start mining!

python node.py --mine --wallet YOUR_WALLET_ADDRESS

Replace YOUR_WALLET_ADDRESS with your MetaMask wallet address (e.g., 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1)

That's it! You're now mining VELVET tokens! 🎉

💻 Usage

Run a Mining Node

python node.py --mine --wallet 0xYourWalletAddress

Earns: 50 VELVET per block mined

Run a Full Node (No Mining)

python node.py

Helps secure the network and relay transactions

Custom Port

python node.py --port 8546 --mine --wallet 0xYourWalletAddress

View the Explorer

Open your browser to:

http://localhost:8545/explorer

🦊 Connect to MetaMask

Open MetaMask
Click network dropdown → "Add Network"
Enter the following details:

Field	Value
Network Name	Velvet Chain
RPC URL	http://96.126.107.7:8545
Chain ID	16523431
Currency Symbol	VELVET

Click "Save"
Your VELVET balance will appear in MetaMask!

⛏️ Mining Information

How Mining Works

Velvet Chain uses Proof of Work consensus:

Your node collects pending transactions
Creates a new block with transactions + your mining reward
Finds a valid hash by trying different nonces
Broadcasts the block to the network
You receive 50 VELVET! 💰

Mining Rewards

Block Reward: 50 VELVET per block
Target Block Time: 10 seconds
Difficulty Adjustment: Every 100 blocks
Expected Daily Earnings: ~432,000 VELVET (if mining alone)

Hardware Requirements

Minimum:

CPU: 2 cores
RAM: 2 GB
Disk: 10 GB
Internet: 5 Mbps

Recommended:

CPU: 4+ cores
RAM: 4+ GB
Disk: 50+ GB
Internet: 10+ Mbps

Note: Velvet uses CPU mining. More CPU cores = higher mining chance

🌐 Network Information

Mainnet Details

Network Name: Velvet Chain
Chain ID: 16523431
Currency: VELVET
Total Supply: 1,000,000 VELVET (initial) + mining rewards capped at 21,000,000 with halving every new era !
Block Explorer: https://explorer.velvetchain.network
Genesis Block: December 29, 2024

Bootstrap Nodes

The network automatically connects to bootstrap nodes:

https://velvet-bootstrap-1.network:8545
https://velvet-bootstrap-2.network:8545

Current Network Stats

Check live stats at: https://stats.velvetchain.network

📊 Block Explorer

The included block explorer shows:

✅ Real-time blockchain statistics
✅ Latest blocks and transactions
✅ Mining difficulty and hashrate
✅ Network peer count
✅ Your wallet balance
✅ Transaction history

Access at: http://localhost:8545/explorer

🔧 Advanced Configuration

Environment Variables

Create a .env file:

VELVET_PORT=8545
VELVET_WALLET=0xYourAddress
VELVET_BOOTSTRAP_NODES=http://node1.com:8545,http://node2.com:8545
VELVET_MAX_PEERS=25

Running as a Service (Linux)

Create /etc/systemd/system/velvet-node.service:

[Unit]
Description=Velvet Chain Node
After=network.target

[Service]
Type=simple
User=velvet
WorkingDirectory=/home/velvet/velvet-chain
ExecStart=/usr/bin/python3 node.py --mine --wallet 0xYourAddress
Restart=always

[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl enable velvet-node
sudo systemctl start velvet-node
sudo systemctl status velvet-node

Docker Support

docker build -t velvet-chain .
docker run -p 8545:8545 velvet-chain --mine --wallet 0xYourAddress

🤝 Contributing

We love contributions! Here's how to help:

Setting Up Development

git clone https://github.com/yourusername/velvet-chain.git
cd velvet-chain
pip install -r requirements-dev.txt
python -m pytest tests/

Contribution Guidelines

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

What We Need

🐛 Bug fixes
✨ New features
📝 Documentation improvements
🧪 Test coverage
🌐 Translations
🎨 UI improvements

📖 API Documentation

JSON-RPC Endpoints

Velvet Chain implements Ethereum JSON-RPC for MetaMask compatibility:

// Get chain ID
POST http://localhost:8545
{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

// Get balance
POST http://localhost:8545
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": ["0xYourAddress", "latest"],
  "id": 1
}

REST API

# Get blockchain stats
GET http://localhost:8545/api/stats

# Get latest blocks
GET http://localhost:8545/api/chain

# Get specific block
GET http://localhost:8545/api/block/123

# Get address info
GET http://localhost:8545/api/address/0xYourAddress

# Get connected peers
GET http://localhost:8545/api/peers

🔐 Security

Best Practices

✅ Never share your private keys
✅ Use a hardware wallet for large amounts
✅ Keep your node software updated
✅ Use a firewall to protect RPC port
✅ Regular backups of blockchain data

Reporting Vulnerabilities

Found a security issue? Email: security@velvetchain.network

Do not create public issues for security vulnerabilities.

🗺️ Roadmap

Phase 1: Launch (Q1 2025) ✅

Phase 2: Growth (Q2 2025)

Phase 3: Ecosystem (Q3 2025)

Phase 4: Enterprise (Q4 2025)

Private chains
Enterprise APIs
Advanced analytics
Institutional support

📜 License

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

Community Nodes

Help us grow the network! List your public node:

Open an issue with your node URL
We'll add it to the bootstrap nodes
Earn community recognition! 🏆

❓ FAQ

Q: How much can I earn mining?
A: Depends on network hashrate. With 10-second blocks, ~8,640 blocks/day × 50 VELVET = 432,000 VELVET/day (if mining alone).

Q: Can I mine on multiple computers?
A: Yes! Each computer increases your chances.

Q: Is this a scam/rugpull?
A: No! Open source, no premine (except initial supply for development), fully decentralized.

Q: What can I do with VELVET tokens?
A: Hold, trade on DEXes, use in DeFi, send to friends, or stake (coming soon).

Q: Can I run this on a Raspberry Pi?
A: Yes! Works great on ARM devices.

Q: How is this different from Bitcoin/Ethereum?
A: EVM-compatible (smart contracts), faster blocks, easier mining, modern codebase.

🙏 Acknowledgments

Built with:

Python 3
Flask
Web3.py
eth-account
And lots of ☕

Special thanks to:

The Ethereum community
Bitcoin pioneers
All our contributors
You, for mining! 🎉

📈 Stats

Made with ❤️ by the Velvet Chain Community

Website • Docs • Explorer

Name		Name	Last commit message	Last commit date
Latest commit History 45 Commits
explorer		explorer
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
QUICKSTART.md		QUICKSTART.md
README.Md		README.Md
blockchain.py		blockchain.py
docker-compose.yml		docker-compose.yml
requirements.txt		requirements.txt
setup.sh		setup.sh

License

FreedomParrot/Velvet-Chain

Folders and files

Latest commit

History

Repository files navigation