Troubleshooting

Common issues and solutions

1. Contract calls fail with EVM error: NotActivated

The contract has been compiled at a newer EVM version than supported by Alpen. Ensure the EVM version of the compiler is set to Prague.

2. I get Could Not Fetch chain ID error on my wallet

Alpen testnet was updated from Shanghai to Prague specifications on December 4, 2025, doing a network regenesis with a different chain ID. Check that your wallet is using the current chain ID.

3. Alpen CLI returns Failed to sync signet wallet error

Check that your Alpen CLI configuration file ~/.config/alpen/config.toml uses the correct endpoints from Configure the CLI, then follow the instructions to backup, restore, and scan your CLI wallet balances.

4. My full node's strata_client exits with a fork_choice_manager error

Verify that in your configuration file ~/alpen/docker/configs/config.fn.toml the parameter sync_endpoint correctly points to ws://fnclient675f9eff3a682b8c0ea7423.testnet.alpenlabs.io .

After you update the file, shut down all containers, delete the contents of ~/alpen/docker/data folder, and let it resync from zero.