Testnet
Reporting Issues and Bugs
Pre-launch
Section
Testnet
Documentation category
Type
Guide
Technical reference
Summary
How to report testnet bugs, protocol issues, and unexpected behaviour to the SwssChain development team.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

Reporting Issues and Bugs

The SwssChain testnet period is a structured programme designed to surface and resolve issues before mainnet. Developer and validator reports of unexpected behaviour are a critical input to the SwssChain engineering process. All reported issues are reviewed by the core development team.

What to Report

Report any of the following when encountered on the SwssChain testnet:

  • Consensus Anomalies: Blocks that appear to be accepted by the network but violate expected SCP rules; forks that are not resolved within the expected time; Finality Certificates signed by fewer validators than the required threshold.
  • RPC Inconsistencies: JSON-RPC methods returning results that differ from the specified behaviour; responses that vary between RPC node instances for the same query at the same block height.
  • Deed Settlement Failures: Valid Deed settlement transactions that are rejected, produce incorrect Finality Certificate content, or fail to emit expected events.
  • Settlement Combustion Model Discrepancies: TSL amounts deducted that differ from the published formula; ERRP distributions that do not match the declared distribution ratios.
  • EVM Incompatibilities: Solidity or Yul constructs that behave differently on SwssChain compared to the reference EVM implementation at the same EVM version (Cancun).
  • SDK Bugs: SDK methods that return incorrect results, fail silently, or behave inconsistently with the documented specification.
  • Explorer Errors: Data displayed on the testnet explorer that does not match the underlying on-chain data.

How to Submit a Report

All testnet issues are submitted through the issue tracker in the SWSS DevHub dashboard. An approved developer account is required: see Developer and Validator Access. Include the following information in every report:

  1. Issue Category: Select from the predefined categories (Consensus, RPC, Deed Settlement, SCM, EVM, SDK, Explorer).
  2. Severity: Critical (network halted or funds at risk), High (significant unexpected behaviour), Medium (unexpected behaviour with workaround), Low (cosmetic or minor inconsistency).
  3. Description: A clear statement of expected behaviour and the actual observed behaviour.
  4. Reproduction Steps: The minimum steps required to reproduce the issue. Include transaction hashes, block numbers, contract addresses, and code snippets where relevant.
  5. Environment: Testnet reset number (visible in the explorer footer), SDK version, network client version if applicable.
  6. Logs: Attach relevant node logs, RPC response bodies, or explorer screenshots.

Security Vulnerabilities

If the issue represents a potential security vulnerability (one that could be exploited to steal funds, compromise validator keys, or disrupt consensus) do not submit it publicly via the issue tracker. Follow the responsible disclosure process described in the Security section of this documentation. Security vulnerability reporters who follow the responsible disclosure process are eligible for recognition in the SwssChain security acknowledgements.

Response Times

Severity Initial Response Resolution Target
Critical4 hours24 hours
High24 hours7 days
Medium72 hours30 days
Low1 weekNext release cycle

Issue Lifecycle

Submitted issues move through the following states: Submitted → Triaged → Confirmed → In Progress → Resolved → Closed. Issue reporters receive email notifications at each state transition. Confirmed issues are published in the public issue tracker with a sanitised description that does not include exploitable details for security-sensitive reports.

Recognition

Developers who report confirmed High or Critical issues during the testnet period will be recognised in the SwssChain Testnet Contributor Registry, published on SWSS DevHub and referenced in the SwssChain mainnet launch documentation.