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#

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>
• WebAuthn claims are encoded as Makechain custody envelopes in claim_signature
• ERC-1271 claims are not supported

Read-model mismatch#

If a deployed surface disagrees with the docs, prefer the canonical protocol/SPECIFICATION.md and the field mappings in the RPC reference.