nautechsystems/nautilus_trader · error

Manifest code hashes must be nonzero

Error message

Manifest code hashes must be nonzero

What it means

A contract entry in the deployment manifest has a code_hash equal to zero; a zero hash cannot attest to any real deployed bytecode, so the manifest fails the nonzero-hash integrity check.

Source

Thrown at crates/adapters/blockchain/src/rpc/verification.rs:1273

    );
    anyhow::ensure!(
        !manifest.contracts.is_empty() && !manifest.tokens.is_empty() && !manifest.pools.is_empty(),
        "Deployment manifest contracts, tokens, and pools are required"
    );
    let mut contract_addresses = HashSet::new();
    let mut roles = HashSet::new();

    for contract in &manifest.contracts {
        let address = Address::from_str(&contract.address)
            .map_err(|_| anyhow::anyhow!("Deployment manifest contains an invalid address"))?;
        anyhow::ensure!(
            contract_addresses.insert(address),
            "Deployment manifest contains a duplicate contract address"
        );
        roles.insert(contract.role);
        let code_hash = B256::from_str(&contract.runtime_code_hash)
            .map_err(|_| anyhow::anyhow!("Deployment manifest contains an invalid code hash"))?;
        anyhow::ensure!(
            code_hash != B256::ZERO,
            "Manifest code hashes must be nonzero"
        );
        anyhow::ensure!(
            matches!(contract.role, BlockchainContractRole::Implementation)
                || !contract.probes.is_empty(),
            "Every deployed contract role requires at least one identity probe"
        );

        if let Some(proxy) = &contract.proxy {
            anyhow::ensure!(
                matches!(
                    proxy.kind.as_str(),
                    "eip1967_implementation" | "zeppelinos_implementation"
                ),
                "Proxy kind is unsupported"
            );
            B256::from_str(&proxy.storage_slot)

View on GitHub (pinned to 18893faf8b)

Solutions

1. Supply the actual keccak256 runtime code hash in the manifest

When it happens

Trigger: Thrown at crates/adapters/blockchain/src/rpc/verification.rs:1273 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of nautechsystems/nautilus_trader@18893faf8b (2026-09-08). Data as JSON: /api/errors/78b466a2cea57705. Report an issue: GitHub.