Documentation (including all L1&L2 addresses)
IN-SCOPE VULNERABILITIES: WEB, API & NODE INFRASTRUCTURE
We welcome reports demonstrating a reproducible security impact on the assets explicitly listed in this program.
Web Applications, APIs & Storage
- Business logic vulnerabilities resulting in unauthorized actions or bypass of security controls.
- Broken authentication, account takeover, and exploitable session management or password reset vulnerabilities.
- Broken access control, including IDOR, privilege escalation, and unauthorized access to administrative functionality.
- Remote code execution, command injection, SQL injection, XXE, and other exploitable injection vulnerabilities.
- Server-side request forgery (SSRF).
- Local or remote file inclusion, path traversal, and arbitrary file read or write.
- Cross-site scripting (XSS) affecting other users.
- Cross-site request forgery (CSRF) resulting in security-sensitive actions.
- Exposure of sensitive non-public information, credentials, or secrets with demonstrated security impact.
- Unauthorized access to, modification of, or deletion of storage objects.
- Other vulnerabilities demonstrating a concrete impact on confidentiality, integrity, or availability.
JSON-RPC & Node Interfaces
- Unauthorized access to privileged RPC methods or node management functionality.
- Crafted requests or P2P messages that trigger a reproducible node crash, persistent synchronization failure, or disproportionate resource consumption.
- Vulnerabilities in execution-layer or consensus-layer processing that cause acceptance of invalid data, incorrect state transitions, or chain divergence.
- Security control bypasses affecting the listed RPC endpoints or explicitly listed P2P interfaces.
Vulnerabilities in third-party components are eligible where they demonstrably affect an in-scope Whitechain deployment. The presence of a dependency or a reference in the repository does not independently bring other assets into scope.
OUT-OF-SCOPE FINDINGS
- Findings affecting assets, networks, contracts, or services not explicitly included in the program scope.
- Hypothetical vulnerabilities, unverified scanner output, or version-based claims without a reproducible proof of concept.
- Missing security headers, cookie flags, TLS hardening, or other best-practice recommendations without demonstrated security impact.
- Public login panels, open ports, enabled HTTP methods, software banners, stack traces, or path disclosures without an exploitable security consequence.
- Access to intentionally public blockchain data, public RPC methods, or public storage objects.
- Exposed public identifiers or API keys without demonstrated unauthorized access or other security impact.
- Self-XSS, cosmetic content spoofing, or response modifications affecting only the researcher's own browser.
- Open redirects, clickjacking, account enumeration, or rate-limit bypasses without demonstrated additional security impact.
- Login/logout CSRF or CSRF affecting anonymous forms without a security-sensitive consequence.
- Normal faucet usage, accumulation of test tokens, or exhaustion of faucet allocations without a separate security vulnerability.
- Expected transaction reverts, invalid-input rejection, normal synchronization delays, or failures caused solely by insufficient local resources.
- Attacks requiring pre-existing administrative access, compromised private keys, physical access, or control over the victim's device, unless that access is obtained through an in-scope vulnerability.
- Mobile applications and browser extensions, unless explicitly added to the asset list.
- Known OP Stack issues, technical edge cases, structural limitations.
TESTING RULES & DENIAL OF SERVICE
Protocol-level denial-of-service vulnerabilities are eligible, but disruptive testing against shared infrastructure requires prior written authorization.
- Demonstrate availability issues on a researcher-controlled local environment or an environment explicitly designated by the Whitechain team.
- Obtain prior written authorization before attempting to crash, overload, or disrupt any shared Whitechain node or public service. Authorization must specify the targets, testing window, and traffic limits.
- Volumetric DDoS, unrestricted request flooding, transaction spam, and deliberate exhaustion of shared infrastructure are prohibited.
- Social engineering, phishing, unsolicited messaging, and destructive modification or deletion of other users' data are prohibited.
- Use researcher-controlled accounts, wallets, and data wherever possible, and stop once the impact is demonstrated.
PROOF OF CONCEPT & TESTNET IMPACT
Reports must identify the affected asset, reproduction steps, relevant software version or configuration, and demonstrated security impact.
Local proofs of concept are accepted when they reproduce the relevant in-scope software and configuration. Clearly document any differences from the Whitechain deployment.
For resource-exhaustion findings, include the attacker's required resources, the impact on the affected node, and recovery requirements.
Severity is assessed by the demonstrated security impact. Test tokens having no monetary value does not automatically invalidate a protocol vulnerability; hypothetical mainnet losses alone do not establish severity.