If you discover a security vulnerability in the Avian Stratum Proxy project, please do not open a public issue. Instead, please report it responsibly by emailing the maintainers directly.
- Do not create a public GitHub issue - This could expose the vulnerability before a fix is available
- Contact the maintainers privately with:
- Description of the vulnerability
- Steps to reproduce (if applicable)
- Potential impact
- Suggested fix (if you have one)
Contact: @cdonnachie via GitHub or use GitHub's private security advisory feature
- We will acknowledge receipt of your report within 48 hours
- We will work on a fix as soon as possible
- We will keep you updated on the progress
- We will credit you in the security advisory (unless you prefer to remain anonymous)
- Once fixed, we will release a patched version
- Keep the proxy updated - Always run the latest version
- Use environment variables - Store sensitive data in
.envfiles, not in code - Secure RPC connections - Use HTTPS/TLS for RPC endpoints
- Monitor logs - Watch for unusual activity
- Network security - Run the proxy behind a firewall
- Authentication - If exposing the dashboard, add authentication
- Never commit secrets - Credentials, API keys, or tokens should never be in the repository
- Input validation - Always validate and sanitize user input
- SQL injection prevention - Use parameterized queries
- Error handling - Don't expose sensitive information in error messages
- Dependencies - Keep dependencies up to date
- Code review - Security-sensitive changes should be reviewed carefully
| Version | Supported |
|---|---|
| Latest | ✅ Yes |
| n-1 | ✅ Yes |
| < n-1 | ❌ No |
We recommend always running the latest version for security updates.
Security patches will be released as soon as they are ready and tested. We follow semantic versioning and will typically release security patches as minor or patch version updates.
- The dashboard should not be exposed to the public internet without authentication
- The proxy should only connect to trusted RPC endpoints
- Configuration files should be protected and not world-readable
- Database files should be secured with appropriate file permissions
We appreciate the security research community and believe that responsible disclosure of vulnerabilities protects all users. We will make our best effort to:
- Acknowledge the receipt of your report
- Provide a reasonable timeline for patching
- Credit researchers (with permission)
- Keep the vulnerability details confidential until a patch is available
Thank you for helping keep Avian Stratum Proxy secure!