refresh

suspend fun refresh(keyId: String): Result<ByteArray>

Rotates the keyshares of an existing key without changing its public key.

A proactive-security measure: it replaces both parties' shares while the key — and every address derived from it — stays the same, so a share captured before the refresh is useless afterward. Like keygen, it reconciles internally.

Return

the refreshed keyshare bytes, also persisted under the same keyId.

Parameters

keyId

the hex-encoded keyId to refresh; the SDK reads the current share from its StorageClient.

See also

for completing an interrupted refresh.