How to Run a Prover Node

1. Background

ZK prover nodes are one of the critical roles in Cysic Network. Their job is to generate ZK proofs of various kinds, assigned by our partners and obtain Cysic Network credits as the rewards. Operating a prover node requires a solid understanding of DevOps and high-performance hardware.

2. Hardware Requirements

Before proceeding, ensure your system meets the following minimum requirements:

• Basic understanding of command-line operations and Linux system administration

• Hardware specifications:

  • Random Access Memory (RAM): Minimum 64GB

  • Storage: Minimum 100GB of available disk space

  • Graphics Processing Unit (GPU): Minimum 16GB VRAM

  • Processor: 8 cores CPU with 64-bit architecture

• Reliable internet connection with stable low-latency access

• Supported operating system: Linux (Ubuntu 24.04 LTS or compatible distributions recommended)

3. Get Free RPC endpoint used by eth proof

1. Go the Alchemy website to register a free RPC endpoint, sign in or register

   
2. Create a new app

   

   

   

   
3. Got the RPC URL：copy the url

   

(Optional) Consider using a paid third-party RPC endpoint provider or hosting a self-built RPC server if RPC call latency significantly impacts proof generation time.

1. Although the free RPC endpoint is capable of completing the task, the latency can be substantial. We recommend using a paid RPC endpoint or, if appropriate, hosting your own RPC endpoint. The physical distance between the RPC endpoint server and the proof-calculation server significantly impacts data fetch latency.

2. To evaluate RPC endpoint latency, you can test with the following command:

1. For reference, we compared latency across several endpoints (free public endpoints vs. a self-hosted solution). The results are provided below:

4. Deploying the Prover Node

1. Launch your terminal application on Linux.

2. Execute the following command, replacing 0x-Fill-in-your-reward-address-here with your designated reward address:

3. Update the bid price field in the config.yaml file. You can adjust your bid price according to your machine price and reward policy to maximize your earnings.

   1. Lower the bid price to increase the likelihood of getting the prove task.

   2. Raise the bid price to increase the reward for completing a prove task.

      
4. Start the Prover Node service:

5. Post-Deployment Configuration

5.1 Prover Node Initialization Output

Upon successful startup of the Prover Node using the start.sh script, you will observe terminal output similar to the following:

5.2 Critical Post-Deployment Steps

After starting the Prover Node, complete the following mandatory steps:

1. Secure Key Management: Immediately backup all worker key files located in the data/assets directory. These keys are essential for node operation and reward claiming; store them in a secure, offline location.

2. Node Registration: Proceed to the Cysic Mainnet Website to reserve CYS tokens for your worker node, enabling it to participate in proof generation tasks.

5.3 Reserving CYS for Your Worker Node

A reserve of 1,000 CYS is required for each Prover Worker Node.

To activate your Prover Node, follow these steps to reserve CYS tokens:

1. Access the Cysic Mainnet Portal: Navigate to the official Cysic Mainnet Website: https://app.cysic.xyz/prover

2. Authenticate Your Account: Click the sign-in button and follow the prompts to authenticate.

   
3. Connect Your Wallet: Establish a connection between your wallet and the Cysic Mainnet Portal.

   

   

   

   

1. Connect Keplr Wallet: Select the CONNECT KEPLR button and confirm the connection request.

   
2. Reserve CYS Tokens: Scroll to the RESERVE CYS section, click the RESERVE button, select your worker node from the dropdown menu, and specify the required amount of CYS tokens to reserve.

   

   
3. Verification of Activation: After successfully reserving CYS tokens, your Prover Node terminal will display output similar to the following, indicating the node is ready to receive proof generation tasks:

Important Note: Ensure your each Prover Node worker address maintains a sufficient balance of CYS tokens to cover transaction fees when submitting proof generation results.

Appendix

(Optional) Nvidia 5090 Support

The Nvidia 5090 card is supported. If you launched the Prover prior to 2025-12-22 and encountered an error, you may use the commands below to update the binary to be compatible with the 5090 GPU. For users launching the Prover on or after 2025-12-22, this step is unnecessary, as the new binary has been incorporated into setup_prover.sh.

(Optional) Convert Reward Address to Private Key

Warning: Below command can convert the prover reward address key file to private key.

This step is only needed if you want to use the private key for other operations. Don't share the private key with anyone.

Above command will do the following task:

• Download the decryptor script to the ~/cysic-prover folder.

• Execute the decryptor script, the script will do the following steps:

  • Download the decryptor program to the ~/cysic-prover/data/assets/ folder.

  • Make the decryptor program executable.

  • Run the decryptor program(the program will try to decrypt the reward address key file in current folder and print the private key to the console. If you have other key files need to decrypt, please copy them to this folder and the program will decrypt them as well).

The output of the decryptor program will be similar to below: