Welcome to the Gorgoroth Trials
The Ethereum Classic community is invited to participate in the Gorgoroth Trials - a comprehensive alpha testing campaign for Fukuii, a high-performance Scala 3 implementation of the Ethereum Classic protocol. This is your opportunity to help validate Fukuii's compatibility and readiness before mainnet deployment.
Named after the volcanic plateau in Mordor where Sauron trained his armies, the Gorgoroth Trials represent a crucible through which Fukuii must pass to prove its mettle alongside battle-tested clients like Core-Geth and Hyperledger Besu.
What Are the Battlenets?
The Battlenets are specialized testing environments designed to validate different aspects of Fukuii's implementation. Each Battlenet isolates a specific dimension of client behavior, allowing testers to observe how Fukuii performs under controlled but realistic protocol conditions. Together, these environments create a structured pathway for validating networking, mining, consensus, and interoperability before advancing toward mainnet readiness.
Gorgoroth — The Multi-Client Proving Ground
Gorgoroth is a private test network where Fukuii faces off against Core-Geth and Hyperledger Besu in controlled combat scenarios. Here we validate:
- •Network Communication - Can Fukuii shake hands with diverse peers?
- •Mining Compatibility - Do blocks mined by different clients achieve consensus?
- •Protocol Compatibility - Does Fukuii speak the same language as Core-Geth and Besu?
- •Faucet Service - Can testnet tokens flow to those who need them?
Configurations Available:
- •3nodes - 3 Fukuii nodes (baseline validation)
- •fukuii-geth - 3 Fukuii + 3 Core-Geth nodes
- •fukuii-besu - 3 Fukuii + 3 Besu nodes
- •mixed - 3 Fukuii + 3 Core-Geth + 3 Besu nodes (ultimate test)
Estimated time: 1–2 hours for basic validation.
Why Community Validation Matters
Community testing ensures Fukuii is evaluated under real-world conditions that no internal environment can fully replicate, revealing compatibility issues and stability concerns early. By running Fukuii on diverse machines, networks, and configurations, testers expose edge cases that only emerge outside controlled lab scenarios. This collective effort accelerates maturity, strengthens client reliability, and builds confidence ahead of broader ecosystem adoption.
The Stakes are High
Fukuii aims to join the ranks of production-ready Ethereum Classic clients. Before we can confidently recommend it for mainnet use, we need to know:
- Does it work as advertised? - Theory meets practice in the Battlenets
- Does it play well with others? - Multi-client networks are ETC's strength
- Will it survive in the wild? - Real-world conditions reveal hidden issues
- Is it ready for your infrastructure? - Different setups expose different challenges
Why Your Testing Is Essential
The Fukuii development team has done extensive internal testing, but nothing replaces the diversity of real-world scenarios that community testing provides:
- •Different Operating Systems - Your Linux, macOS, or Windows setup might reveal OS-specific issues
- •Different Network Conditions - Your internet connection, firewall rules, and ISP matter
- •Different Hardware - Your CPU, RAM, and disk configurations create unique scenarios
- •Different Use Cases - How you want to use Fukuii might differ from our assumptions
Building Trust Through Transparency
By validating Fukuii publicly and documenting the results, we:
- •Build confidence in the implementation
- •Create a knowledge base for future users
- •Identify issues before they affect production users
- •Demonstrate ETC's commitment to multi-client diversity
How to Participate in the Gorgoroth Trials
Participation is simple: choose a trial configuration, run the test suite, record your experience, and share your results to help refine the client before mainnet readiness. Before starting, ensure your environment includes Java 21, SBT for building and managing the Scala project, and Python 3 for running the supporting test scripts. Testers should also confirm they have a reliable network connection, adequate disk space, and permission to execute local scripts, as these setup factors often surface edge cases that help strengthen Fukuii’s real-world robustness.
1. Choose Your Trial
For Most Testers - Start with Gorgoroth:
# Clone the repository
git clone https://github.com/chippr-robotics/fukuii.git
cd fukuii/ops/gorgoroth
# Start a test network
fukuii-cli start 3nodes
# Wait 60 seconds for initialization
sleep 60
# Run the automated test suite
cd test-scripts
./run-test-suite.sh 3nodes
2. Document Your Experience
We need to know:
- •What worked - Success stories help us understand what's stable
- •What didn't work - Failures help us fix bugs before release
- •What was confusing - Documentation gaps need to be filled
- •What surprised you - Unexpected behavior reveals design issues
Even small details can be deeply informative.
3. Submit Your Field Report
Submitting a structured field report allows the development team to analyze results consistently, identify patterns, and prioritize fixes across different testing environments.
Option 1 — GitHub Issues with Field Report Template (Preferred)
Visit the Fukuii GitHub Issues and select the "Gorgoroth Trials Field Report" template.
This template will guide you through submitting:
- •System information
- •Test duration and configuration
- •Test results (pass/fail for each area)
- •What worked well
- •Issues encountered
- •Performance metrics
- •Suggestions for improvement
Quick Link: Submit Field Report
Option 2 — GitHub Discussions (For General Feedback)
For less formal feedback or questions, use GitHub Discussions in the "Gorgoroth Trials" category.
Option 3 — GitHub Issues (Specific Bugs)
If you discover a specific bug unrelated to your field report, create a GitHub issue:
- Go to https://github.com/chippr-robotics/fukuii/issues/new/choose
- Select "Bug report" template
- Add label: gorgoroth-trials
- Include: Steps to reproduce
Expected behavior
Actual behavior
Log snippets
System information
4. Help Other Testers
Join the Ethereum Classic Community Discord. The Gorgoroth Trials are a community effort. If you figure something out:
- •Share your solutions in discussions
- •Help troubleshoot others' issues
- •Document workarounds you discover
- •Suggest improvements to documentation
Testing Timeline
The timeline below outlines the alpha testing window and the sequence of review and refinement phases leading into the planned beta release. These milestones are part of the broader preparation for the Olympia upgrade, where reliable multi-client support becomes essential for testing EVM compatibility changes and validating BASEFEE-related improvements. As Fukuii progresses through alpha, beta, and production-readiness stages, its stability and interoperability will directly strengthen the network’s ability to adopt Olympia with confidence and maintain ETC’s commitment to a diverse and resilient client ecosystem.
Alpha Testing
Start: December 8, 2025 (00:00:00 UTC)
End: December 31, 2025 (23:59:59 UTC)
What Happens Next?
- January 1-7, 2026 - Development team analyzes all field reports
- January 8-14, 2026 - Critical bugs are addressed
- January 15, 2026 - Beta testing phase begins (if alpha is successful)
- TBD - Production release recommendation to ETC community
Your feedback during the alpha testing period directly impacts the timeline and quality of the beta release.
Documentation
Comprehensive guides and testing references are available to help you navigate the Gorgoroth Trials, troubleshoot issues, and explore advanced validation paths like Cirith Ungol.
Gorgoroth Resources
- •Gorgoroth Quick Start - Get running in 5 minutes
- •Compatibility Testing Guide - Detailed test procedures
- •Faucet Testing Guide - Test token distribution
- •Validation Status - Current progress
Cirith Ungol (Optional Advanced Trial)
- •Cirith Ungol Testing Guide - Real-world sync validation
General Documentation
- •Fukuii Documentation - Full documentation index
- •Architecture Overview - How Fukuii works
Getting Help
- •GitHub Discussions: Ask questions, share findings
- •Documentation: Check the guides linked above
- •Issue Tracker: Report bugs with reproduction steps
- •Community: Help each other succeed
Recognition for Testers
Hall of Fame. Participants who submit detailed field reports will:
- •Be included in CONTRIBUTORS.md
- •Receive recognition in release notes
- •Be acknowledged in community channels
A Note on Cirith Ungol (The Bonus Trial)
Cirith Ungol represents the next level of validation - testing Fukuii against the real Ethereum Classic network. This is optional but highly valuable:
Why Test with Cirith Ungol?
- •Validates sync performance with 20M+ real blocks
- •Tests peer diversity (public network has many client types)
- •Reveals issues that only appear with substantial state
- •Measures real-world resource usage
When to Try Cirith Ungol:
- •After successfully completing Gorgoroth trials
- •When you have 4-8 hours for sync to complete
- •If you have 100GB+ available disk space
- •If you're comfortable with longer-running tests
What We Learn:
- •SNAP sync performance and reliability
- •Fast sync completion and state verification
- •Long-term stability (24+ hour continuous operation)
- •Memory usage patterns with large state
- •Disk I/O characteristics
Even if only a handful of testers attempt Cirith Ungol, the data will be invaluable for understanding Fukuii's production readiness.
Final Thoughts
The Gorgoroth Trials are more than just testing — they are a collective statement about the values that define Ethereum Classic and the future we are building together. They showcase a community willing to roll up its sleeves, validate its own infrastructure, and ensure that every upgrade stands on a foundation of open participation and technical rigor. In helping Fukuii take shape, we reinforce the ethos that has carried ETC through a decade of challenges:
- •Decentralization - Multiple independent client implementations
- •Quality - Thorough validation before production use
- •Transparency - Open testing and public results
- •Collaboration - Community-driven development
Your participation, whether testing for 15 minutes or running week-long stability tests, contributes to a stronger, more resilient Ethereum Classic network.
The gates of Gorgoroth are open. The trials have begun.
For the glory of Ethereum Classic!
— The Fukuii Development Team

