microdag 1.0.1

Ultra-lightweight DAG blockchain optimized for IoT devices and micropayments

🚀 MicroDAG

Ultra-lightweight DAG blockchain optimized for IoT devices and micropayments.

MicroDAG is a revolutionary blockchain implementation that uses a Directed Acyclic Graph (DAG) structure to achieve unprecedented efficiency and speed, making it perfect for IoT devices, micropayments, and resource-constrained environments.

✨ Key Features

• 🏃‍♂️ Ultra-fast: <100ms transaction confirmations
• 🪶 Lightweight: <50MB memory usage, 59KB codebase
• 💰 No fees: Only minimal PoW for spam protection
• 🔗 DAG structure: Parallel transaction processing
• 🤖 IoT optimized: Perfect for Raspberry Pi, ESP32, Arduino
• ⚡ High throughput: 16,800 TPS regionally, 4,200 TPS globally
• 🔒 Secure: Cryptographically secure with spam resistance

📦 Installation

pip install microdag

That's it! MicroDAG is now ready to use.

🚀 Quick Start

1. Create Account

microdag account create

Output:

✅ Account created successfully!
   Address: micro_a1b2c3d4e5f6789...
   Private key: 0d3d9339a986e381f611d384f10ab039...

⚠️  IMPORTANT: Save your private key securely!

2. Start Node

microdag node start

3. Send Transaction

microdag send micro_recipient123... 10.5

4. Check Balance

microdag balance micro_your_address...

🐍 Python SDK

from microdag import MicroDAG

# Connect to local node
dag = MicroDAG("microdag.db")

# Send transaction
tx_hash = dag.send("micro_recipient", 10.5)
print(f"Transaction: {tx_hash}")

# Check balance
balance = dag.balance("micro_your_address")
print(f"Balance: {balance} MICRO")

🤖 IoT Integration

Perfect for IoT devices and micropayments:

import microdag

# Connect (convenience function for IoT)
dag = microdag.connect()

# Micropayment for sensor data (0.1 cent)
dag.send("micro_sensor_device", 0.001)

Raspberry Pi Example

# Lightweight mode for Pi Zero
microdag node start --lightweight --max-memory 50MB

🏗️ Architecture

MicroDAG uses a Directed Acyclic Graph (DAG) structure instead of traditional blockchain:

• Parallel Processing: Multiple transactions processed simultaneously
• No Mining: Transactions confirm each other through references
• Scalable: Performance improves with network activity
• Efficient: Minimal computational and storage requirements

💡 Use Cases

🏭 Industrial IoT

• Pay for sensor data in real-time
• Machine-to-machine micropayments
• Supply chain tracking with micro-fees

🏠 Smart Home

• Device-to-device payments
• Energy trading between smart meters
• Automated service payments

🌐 Edge Computing

• Lightweight blockchain for edge devices
• Decentralized data marketplaces
• API call micropayments

💳 Micropayments

• Sub-cent transactions with minimal overhead
• Content monetization
• Gaming and virtual economies

📊 Performance

Metric	Value
Transaction Speed	<100ms confirmations
Throughput	16,800 TPS (regional)
Memory Usage	<50MB (IoT mode)
Codebase Size	59KB total
Network Overhead	7-byte message headers
Transaction Size	208 bytes fixed

🔧 Advanced Usage

CLI Commands

microdag account create          # Create new account
microdag node start [port]       # Start node (default: 7076)
microdag send <to> <amount>      # Send transaction
microdag balance [address]       # Check balance
microdag add-peer <ip:port>      # Add network peer
microdag stats                   # Show statistics

Python API

from microdag import MicroDAG, connect
from microdag.core import DAG, Transaction
from microdag.crypto.keys import generate_keypair

# Generate keypair
private_key, public_key = generate_keypair()

# Create transaction
tx = Transaction.create("micro_recipient", 10.5)

# Advanced DAG operations
dag = DAG()
dag.add_transaction(tx.hash)
stats = dag.get_stats()

🛡️ Security

• Cryptographic Security: Ed25519 signatures, Blake2b hashing
• Spam Resistance: Multi-layer defense with minimal PoW
• Network Security: P2P with Byzantine fault tolerance
• Data Integrity: Cryptographic validation of all transactions

🌟 Why MicroDAG?

Traditional Blockchain	MicroDAG
Sequential blocks	Parallel DAG
High energy usage	Minimal energy
Slow confirmations	<100ms confirmations
Large resource needs	IoT-optimized
Transaction fees	Fee-free
Limited throughput	High throughput

📚 Documentation

• Quick Start: microdag.org/docs/quick-start
• API Reference: microdag.org/docs/api
• Architecture: microdag.org/docs/architecture
• IoT Guide: microdag.org/docs/iot

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🔗 Links

• Website: microdag.org
• GitHub: github.com/microdag/microdag
• Documentation: microdag.org/docs
• PyPI: pypi.org/project/microdag

---

Built with ❤️ for the IoT and micropayments revolution.

MicroDAG: Making blockchain accessible to every device, everywhere.