Reference
Troubleshooting
Diagnose authentication failures, configuration errors, and network mismatches at the correct layer.
AuthenticationFailed
- Confirm the proof was built for the KeyVault address, not the wallet proxy.
- Confirm chainId, target, function selector, and parameter hashing match the contract.
- Confirm the proof format matches the active authenticator.
- Check deadline, minute bucket, token TTL, and token scope.
- Do not reuse a proof after changing any protected function argument.
Wallet creation fails
- Fund the connected signer with ROSE on the selected Sapphire network.
- Confirm the authenticator is factory-allowlisted.
- Encode authConfig for the selected authenticator, not another strategy.
- Ensure the normalized username is not already registered.
ChainNotConfigured
Configure chain-specific base keys with setChainBaseKeys before deriving or signing with Solana HD accounts.