{"record":{"id":"9646c8f65b97534a","repo":"nautechsystems/nautilus_trader","slug":"invalid-betfair-credentials-password-or-app-key-p","errorCode":null,"errorMessage":"Invalid Betfair credentials: password or app key provided but username is missing","messagePattern":"Invalid Betfair credentials: password or app key provided but username is missing","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/adapters/betfair/src/config.rs","lineNumber":77,"sourceCode":"    Ok(())\n}\n\nfn resolve_credential(\n    username: Option<SecretString>,\n    password: Option<SecretString>,\n    app_key: Option<SecretString>,\n) -> anyhow::Result<BetfairCredential> {\n    match BetfairCredential::resolve(\n        username.map(SecretString::into_inner),\n        password.map(SecretString::into_inner),\n        app_key.map(SecretString::into_inner),\n    ) {\n        Ok(Some(credential)) => Ok(credential),\n        Ok(None) => anyhow::bail!(\"Missing Betfair credentials in config and environment\"),\n        Err(e) => Err(match e {\n            CredentialError::MissingPassword => anyhow::anyhow!(\n                \"Invalid Betfair credentials: username provided but password is missing\",\n            ),\n            CredentialError::MissingUsername => anyhow::anyhow!(\n                \"Invalid Betfair credentials: password or app key provided but username is missing\",\n            ),\n            CredentialError::MissingAppKey => {\n                anyhow::anyhow!(\"Invalid Betfair credentials: app key is missing\")\n            }\n        }),\n    }\n}\n\nfn build_stream_config(\n    stream_host: &Option<String>,\n    stream_port: &Option<u16>,\n    stream_heartbeat_secs: Option<u64>,\n    stream_heartbeat_timeout_secs: Option<u64>,\n    stream_reconnect_delay_initial_ms: u64,\n    stream_reconnect_delay_max_ms: u64,\n    stream_use_tls: bool,","sourceCodeStart":59,"sourceCodeEnd":95,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/crates/adapters/betfair/src/config.rs#L59-L95","documentation":"Betfair credential resolution requires the credential set to be complete and coherent. When a password or app key is supplied but the username is absent, CredentialError::MissingUsername is mapped to this error. It prevents silent misconfiguration where half a credential is provided.","triggerScenarios":"resolve_credential (via credential()) sees a password (config or BETFAIR_PASSWORD) or app key (config or BETFAIR_APP_KEY) while username is missing from both config and BETFAIR_USERNAME.","commonSituations":"Exporting BETFAIR_PASSWORD/BETFAIR_APP_KEY but forgetting BETFAIR_USERNAME; typos like BETFAIR_USER; config file with password/app_key but no username key.","solutions":["Set username in config (betfair.username) or export BETFAIR_USERNAME","Check for env var name typos (BETFAIR_USERNAME, not BETFAIR_USER)","If the credential block is not intended, remove the orphaned password/app_key entries"],"exampleFix":"// before (toml)\n[betfair]\npassword = \"secret\"\napp_key = \"key\"\n// after\n[betfair]\nusername = \"myuser\"\npassword = \"secret\"\napp_key = \"key\"","handlingStrategy":"validation","validationCode":"if (password.is_some() || app_key.is_some()) && username.is_none() {\n    return Err(anyhow!(\"Betfair username missing\"));\n}","typeGuard":"fn has_username(u: Option<&str>, p: Option<&str>, k: Option<&str>) -> bool {\n    u.is_some() || (p.is_none() && k.is_none())\n}","tryCatchPattern":"let cred = resolve_credential(cfg)\n    .map_err(|e| anyhow::anyhow!(\"Betfair credential config invalid: {e:#}\"))?;","preventionTips":["Set all three env vars (username, password, app key) as one unit","Grep your config templates for betfair sections missing username","Validate config before launching the trading node"],"tags":["betfair","credentials","config","auth"],"backgroundTag":"missing-credentials","analyzedSha":"18893faf8b356be3320add8de2f861b0b647cf06","analyzedAt":"2026-09-08T20:49:34.690Z","contentChangedAt":"2026-09-08T20:49:34.690Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}