Starting a Node

To start your Fermah Prover Node, follow the instructions below.

Please make sure you are running Telemetry

Start

Run the command:

• Make sure the configuration file exists at ~/.fermah/prover-node.toml

fermah-prover-node start -c ~/.fermah/prover-node.toml

This command will connect you to our network using the provided key and wait for Proof Requests.

Config file for Circuit Prover

The following fields should be customized for each prover node:

• All [hardware] entries must reflect the server HW resources.

• name and instance_id might be merged in one field

name = <PROVER_NODE_NAME>
instance_id = <PROVER_NODE_INSTANCE_NAME>
network = "testnet"
fermah_core_addr = "35.222.190.25:30089"
secret = "305bb0e816e20bbf1bf6c03997d6ddef1656025684a51a385e29753b3e7ee72c1400000000000000aaef57218a5b7d1056191e183bed74ef0b61a25e332c08efc3b23392c0c24181987ab7ec67ad78b135e5bdf081a112a271b9b8e81400000000000000fce2227c56d45109af592160780d21b96406db8820000000000000007eaec9cee23795e201e96be4fbda59a0cf236b00210e36b2361e8b9da9036b642000000000000000427b7826375d8e94b71571e0afecd652dad3b3c8dda341ca4191bfecd388cb9a08000000000000000000000000000000"

[hardware]
ram = { price = "1000", resource = { size = 17179869184, type = "DDR5" } }
ssd = { price = "1000", resource = { size = 137438953472, type = "NVMeGen3" } }
cpu = { price = "1000", resource.model = "ryzen7" }

[[hardware.gpus]]
price = "1000"
[[hardware.gpus.resource.specs]]
CUDA_CC = { major = 26, minor = 7 }

[[hardware.gpus.resource.specs]]
CUDA_CC = { major = 6, minor = 71 }

[storage]
port = 3333

[telemetry]
filter = "info,ethers=debug,fermah_prover_node_machine=debug"

[telemetry.export]
endpoint = "http://localhost:4317"
timeout = "3s"

[zksync]
storage_bucket = "fermah-zksync-testnet"
root_path = "/home/fermah/.fermah/zksync"

[zksync.circuit_prover]
num_workers             = 4
max_gpu_vram_allocation = 1024

Daemonization

Systemd

If you already run other systemd services, there are no specifics for Fermah AVS binary. Keep in mind that you can use logrotate for logs:

/var/log/pn.log {
    su root adm
    daily
    missingok
    rotate 30
    maxsize 1G
    compress
    notifempty
    postrotate
        /usr/lib/rsyslog/rsyslog-rotate
    endscript
}

Additionally, you may set the absolute path to a custom Fermah config folder using FERMAH_CONFIG env var.

Docker

Docker setup is under development.

Kubernetes

Kubernetes helm chart is under development.

Headless Password

If you are using a password for your machine keystore file, you can start the process headless with no prompts, by using the env var FERMAH_KEYSTORE_PW_FILE and setting it to the absolute path to the file containing the password.

Keep in mind these security considerations:

• Set password file permissions to 600

• Ensure the keystore file has 600 permissions.

• Run the systemd service with a non root user and owning both keystore file and password file