Troubleshooting

Build issues

protoc not found

Install protobuf tooling and ensure protoc is on PATH.

Rust version mismatch

Use Rust stable 1.95 or newer for the main Rust workspace.

Message validation

Missing owner_address

V2 messages require a canonical 20-byte owner_address.

Signer not authorized

Ordinary protocol messages require a delegated Ed25519 key registered to the acting owner_address with enough scope.

Verification claim rejected

Check that:

• ETH uses the correct VerificationClaim(owner, ethAddress, chainId, verificationType, network) payload
• SOL uses makechain:verify:<network>:<owner_address_hex>
• claim_key_type and claim_block_hash are set correctly for ERC-1271 flows

Read-model mismatch

If a deployed surface still disagrees with the spec, prefer protocol/SPECIFICATION.md and the V2 field mappings documented in RPC reference.