Commit 28b9811
docs(kotlin-sdk): clarify opensUnderNonGatedDeviceBoundSibling's "prompt-free" scope
Addresses suggestion 3408c9d1d301 on #4060. The KDoc said the
DEVICE_BOUND sibling alias "never gates", which overstated it: a lock-bound
DEVICE_BOUND key still carries setUnlockedDeviceRequired, so a decrypt probe run
while the device is CURRENTLY LOCKED throws UserNotAuthenticatedException (a
GeneralSecurityException) and the catch returns false. "Prompt-free" was only
ever about the absence of a biometric prompt (no setUserAuthenticationRequired).
Clarified that the currently-locked case returns false ("cannot disprove") is
the conservative direction — the caller reports the blob decryptable rather than
falsely offering repair, deferring the disproof to the next unlock (the same
residual already documented for the locked FORMER-RSA path) — and that the
key-health sheet runs in-app on an unlocked device where the probe is live. Doc
only; no behavior change. :sdk compiles clean.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>1 parent 82c682c commit 28b9811
1 file changed
Lines changed: 15 additions & 3 deletions
File tree
- packages/kotlin-sdk/sdk/src/main/kotlin/org/dashfoundation/dashsdk/security
Lines changed: 15 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
234 | 234 | | |
235 | 235 | | |
236 | 236 | | |
237 | | - | |
238 | | - | |
239 | | - | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
| 241 | + | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | + | |
| 246 | + | |
| 247 | + | |
| 248 | + | |
| 249 | + | |
| 250 | + | |
| 251 | + | |
240 | 252 | | |
241 | 253 | | |
242 | 254 | | |
| |||
0 commit comments