● Satoshi Machine Admin Extension v0.0.1 - Initial Release
🎉 Introducing Satoshi Machine Admin
The Satoshi Machine Admin Extension brings automated Dollar Cost Averaging (DCA) to your LNBits
instance through seamless Lamassu ATM integration. Transform your Bitcoin ATM into a DCA
distribution hub that automatically allocates Bitcoin purchases to registered clients based on
their deposit balances.
✨ Core Features
🏦 DCA Client Management
- Client Registration System - View and manage DCA clients registered via the companion client
extension - Dual DCA Modes - Support for both "flow" (proportional) and "fixed" (daily limit) distribution
modes - Real-time Balance Tracking - Monitor client deposit balances and remaining DCA funds
- User-friendly Interface - Display client usernames instead of cryptic user IDs
💰 Deposit Administration
- Quick Deposit Creation - Streamlined interface for adding client deposits
- Confirmation Workflow - Track deposit status from pending to confirmed
- Bulk Operations - Efficient management of multiple client deposits
- Comprehensive Notes - Document deposit details for audit purposes
🔄 Lamassu ATM Integration
- Real-time Transaction Polling - Automatic hourly monitoring of Lamassu database
- Secure SSH Tunneling - Enterprise-grade security for remote database access
- Smart Commission Handling - Configurable commission rates with discount support
- Proportional Distribution - Automatic Bitcoin allocation based on client balance ratios
📊 Complete Audit Trail
- Transaction History - Full record of processed Lamassu transactions
- Distribution Breakdown - Click any transaction to see exact client allocations
- Commission Tracking - Detailed commission calculations with discount application
- Export Capabilities - CSV export for accounting and compliance
⚙️ Advanced Configuration
- Database Connectivity - Secure connection to Lamassu PostgreSQL database
- Wallet Management - Configurable source and commission wallets
- SSH Security - Support for both password and private key authentication
- Connection Testing - Built-in tools to verify database and SSH connectivity
🛠️ Technical Architecture
Backend (Python/FastAPI)
- Modern API Design - RESTful endpoints with OpenAPI documentation
- Robust Database Layer - PostgreSQL with optimized queries and transactions
- Secure Polling System - Background tasks with error recovery and retry logic
- Commission Engine - Sophisticated calculation system supporting discounts and tiered rates
Frontend (Vue.js 3 + Quasar)
- Responsive Design - Works seamlessly on desktop and mobile devices
- Real-time Updates - Live data refresh during manual polling and testing
- Intuitive UX - Clean, professional interface designed for daily use
- Interactive Tables - Sortable, filterable data with export functionality
Security & Reliability
- SSH Tunnel Support - Secure database access without exposing PostgreSQL to internet
- Read-only Database Access - Minimal permissions for maximum security
- Error Handling - Comprehensive logging and graceful failure recovery
- Data Validation - Input sanitization and type checking throughout
💡 How It Works
- Setup - Configure your Lamassu database connection with optional SSH tunnel
- Client Registration - Clients use the companion extension to register for DCA
- Deposit Management - Admins add and confirm fiat deposits for clients
- Automatic Distribution - System polls Lamassu hourly, distributing Bitcoin proportionally
- Audit & Monitoring - View complete transaction history and distribution details
🔧 Installation & Setup
Requirements
- LNBits instance (v1.0.0+)
- Access to Lamassu PostgreSQL database
- SSH access to Lamassu server (recommended)
Quick Start
- Install the Satoshi Machine Admin extension in LNBits
- Navigate to the extension and click "Configure Database"
- Enter your Lamassu database credentials and SSH details
- Test the connection and start managing your DCA system!
📋 Database Schema
The extension creates a clean, optimized database schema:
- dca_clients - Client registration and DCA mode settings
- dca_deposits - Fiat deposit tracking and confirmation
- dca_payments - Bitcoin payment records and distribution history
- lamassu_config - Database connection and polling configuration
- lamassu_transactions - Complete audit trail of processed ATM transactions
🎯 Use Cases
Bitcoin Circular Economy
- Enable community members to automatically DCA from local ATM usage
- Create sustainable Bitcoin acquisition without active trading
Business Operations
- Offer DCA services to customers using your Lamassu ATM
- Generate commission revenue while providing valuable service
Educational Initiatives
- Teach Dollar Cost Averaging principles through practical implementation
- Demonstrate Bitcoin's utility beyond speculation
🔮 Roadmap
Future releases will include:
- Advanced Analytics - Detailed DCA performance metrics and reporting
- Multi-Currency Support - Handle different fiat currencies automatically
- Webhook Integration - Real-time notifications for transactions and distributions
- Batch Processing - Enhanced performance for high-volume operations
🤝 Contributing
This extension represents a collaborative effort between:
- Atitlan Community - R&D and real-world testing venue
- AtitlanIO - Core development and architecture
- LNBits - Platform and integration support
- Claude AI - Code generation and optimization
📄 License
Released under MIT License - see LICENSE file for details.
🆘 Support
- Documentation - Complete setup and configuration guide included
- Troubleshooting - Built-in connection testing and detailed error reporting
- Community - Join the LNBits Telegram for support and discussions
Transform your Lamassu ATM into a DCA distribution powerhouse with Satoshi Machine Admin! 🚀
Ready to democratize Bitcoin accumulation through automated Dollar Cost Averaging.