Skip to content

Security: reservebtc/app.reservebtc.io

Security

SECURITY.md

ReserveBTC Security Policy

Security Tests Vulnerabilities Production Ready

Supported Versions

Version Security Support
v2.2.x ✅ Full support
v2.1.x ✅ Full support
v2.0.x ⚠️ Security updates only
< v2.0 ❌ No longer supported

Reporting a Vulnerability

If you discover a security vulnerability in ReserveBTC, please help us protect our users by following responsible disclosure:

Contact Information

📧 Email: reservebtcproof@gmail.com
⏱️ Response Time: Within 24 hours
🔒 Encryption: PGP key available on request

What to Include

When reporting a vulnerability, please provide:

  1. Description - Clear explanation of the vulnerability
  2. Impact - Potential consequences if exploited
  3. Steps to Reproduce - Detailed reproduction steps
  4. Proof of Concept - Code or screenshots (if applicable)
  5. Suggested Fix - Your recommendations (optional)

What NOT to Do

Do NOT open a public GitHub issue for security vulnerabilities
Do NOT exploit the vulnerability on production systems
Do NOT publicly disclose before we've had time to fix it


Security Features

Smart Contract Security

  • Reentrancy Protection - All state-changing functions protected
  • Access Control - Committee-based multi-signature authorization
  • Integer Overflow - Solidity 0.8+ built-in protection
  • CEI Pattern - Checks-Effects-Interactions enforced
  • Gas Optimization - Production-ready efficiency
  • Emergency Pause - Circuit breaker mechanism

BIP-322 Implementation Security

  • 32 security tests covering all attack vectors
  • Cryptographic attack prevention (8 tests)
  • Injection attack blocking (7 tests)
  • Input validation (12 tests)
  • Protocol compliance (3 tests)
  • DoS prevention (1 test)
  • Valid signature acceptance (1 test)

Oracle Security

  • 24/7 Monitoring - 99.9% uptime
  • Multi-source Verification - 3 independent sources
  • Consensus Mechanism - 2/3 sources must agree
  • Emergency Burns - Automatic protection when fees < 0.001 ETH
  • Spike Protection - Large balance change validation
  • State Persistence - Zero data loss on restart

Data Protection

  • AES-256-GCM Encryption - All sensitive data encrypted
  • User Privacy - Address hashing for anonymity
  • Audit Trail - Complete operation logging
  • GDPR Compliance - Privacy-first design

Security Test Coverage

Overall Statistics

Category Tests Status
Frontend 67 ✅ 100% PASS
Smart Contracts 206 ✅ 100% PASS
BIP-322 Security 32 ✅ 100% PASS
Bitcoin Provider 45 ✅ 100% PASS
TOTAL 350 ✅ 100% PASS

Detailed Breakdown

Smart Contract Security:

  • Oracle Tests: 45 tests
  • RBTCSynth Tests: 28 tests
  • FeeVault Tests: 31 tests
  • VaultWrBTC Tests: 25 tests
  • FeePolicy Tests: 31 tests
  • E2E Tests: 30 tests
  • Security Canary: 16 tests

BIP-322 Security:

  • Cryptographic Attacks: 8 tests
  • Injection Attacks: 7 tests
  • Input Validation: 12 tests
  • Protocol Attacks: 3 tests
  • DoS Prevention: 1 test
  • Legitimate Operations: 1 test

Vulnerability Severity Levels

Critical (P0)

Response Time: < 1 hour
Examples:

  • Smart contract vulnerabilities allowing fund loss
  • Oracle committee private key compromise
  • Multi-source consensus failure
  • Emergency burn system malfunction

High (P1)

Response Time: < 4 hours
Examples:

  • Oracle malfunction causing incorrect minting
  • Fee system exploitation
  • Access control bypass
  • Single source verification failure

Medium (P2)

Response Time: < 24 hours
Examples:

  • Non-critical smart contract bugs
  • Performance degradation
  • Documentation security issues
  • Minor UI/UX vulnerabilities

Low (P3)

Response Time: < 1 week
Examples:

  • Code quality improvements
  • Minor optimization opportunities
  • Documentation updates

Supported Address Types

ReserveBTC implements complete BIP-322 verification for all standard Bitcoin address types:

Mainnet

  • ✅ Native SegWit (P2WPKH) - bc1q...
  • ✅ Taproot (P2TR) - bc1p...
  • ✅ SegWit (P2SH-P2WPKH) - 3...
  • ✅ Legacy (P2PKH) - 1...

Testnet

  • ✅ Native SegWit - tb1q...
  • ✅ Taproot - tb1p...
  • ✅ SegWit - 2...
  • ✅ Legacy - m..., n...

Security Audit History

Date Version Auditor Status Critical Issues
Oct 2025 v2.2 Internal ✅ PASS 0
Sep 2025 v2.1 Internal ✅ PASS 0
Aug 2025 v2.0 Internal ✅ PASS 0

Latest Audit Report: SECURITY_AUDIT_REPORT.md


Bug Bounty Program

Status: Not currently available

We're planning to launch a bug bounty program in the future. Check back for updates.

For now, please report vulnerabilities directly to our security team.


Security Best Practices for Users

For Bitcoin Holders

  1. Never share your Bitcoin private keys - ReserveBTC never asks for them
  2. Verify signatures yourself - Use your own Bitcoin wallet
  3. Monitor your FeeVault balance - Keep at least 0.001 ETH to prevent emergency burns
  4. Check Oracle status - Visit oracle.reservebtc.io/status

For Developers

  1. Use environment variables - Never hardcode secrets
  2. Validate all inputs - Client and server-side
  3. Follow CEI pattern - Checks-Effects-Interactions
  4. Test thoroughly - Run all 350 security tests
  5. Monitor production - Watch for unusual patterns

For Partners

  1. Secure API keys - Rotate regularly
  2. Rate limiting - Implement on your side
  3. Error handling - Don't expose sensitive data
  4. Audit logs - Keep complete records

Security Documentation

Document Description
Security Audit Report Complete smart contract audit
BIP-322 Security Audit BIP-322 implementation security
Test Status Detailed test results
Oracle Security Live Oracle monitoring

Incident Response

In case of a security incident, our team will:

  1. Acknowledge within 1 hour for critical issues
  2. Investigate root cause and impact
  3. Contain the incident to prevent further damage
  4. Fix the vulnerability with tested patch
  5. Communicate with affected users transparently
  6. Post-mortem document lessons learned

Security Updates

Subscribe to security updates:

  1. Watch this repository on GitHub
  2. Enable security alerts (Settings → Security alerts)
  3. Follow us on Twitter @reserveBTC
  4. Email reservebtcproof@gmail.com to join security mailing list

Acknowledgments

We thank the following for improving our security:

  • Bitcoin Core developers for BIP-322 specification
  • MegaETH team for infrastructure support
  • OpenZeppelin for security best practices
  • Our community for responsible disclosure

Report issues responsibly and help us keep ReserveBTC secure for everyone.


Last Updated: October 2025
Protocol Version: v2.2
Network: MegaETH Testnet
Security Status: 🟢 PRODUCTION READY

ReserveBTC Protocol — Security-First Bitcoin DeFi

There aren't any published security advisories