SigningIdentityManager

Owns one wallet's active signing identity. Creation and recovery use complete SDK-issued options. Native/backup prerequisites are revalidated at execution. The encrypted database journals interrupted operations; a failed backup submission does not activate the new identity. Successful activation and initialization refresh the wallet's platform credential registration.

Keep one writable wallet instance per database. Provider extensions may read established identities.

Functions

Link copied to clipboard

Submits the same identity to an explicitly selected provider; it never invents a seed for an existing key.

Link copied to clipboard

Offers backup for an existing retained recovery secret or an explicitly exportable software key.

Link copied to clipboard
suspend fun cancelPending(identityId: String)

Removes only pending local state. Any record already accepted by a provider remains discoverable and can be deleted separately; cancellation never silently destroys a recovery copy.

Link copied to clipboard

Gives an explicit custodian an additional copy of the key. The local key is retained; this does not create a recovery record or enable remote signing.

Link copied to clipboard

Creates P-256 and did:jwk. No provider is selected and no backup is made by default.

Link copied to clipboard
suspend fun creationOptions(intent: SigningIdentityIntent = SigningIdentityIntent.WithoutRecovery, attestation: SigningIdentityAttestationRequest = SigningIdentityAttestationRequest.None): SigningIdentityCreationOptions

Offers only complete choices compatible with the host policy and current native/provider prerequisites.

Link copied to clipboard

Offers registered custody destinations only when the current policy permits private-key export.

Link copied to clipboard

Deletes a selected backup through its owning provider. Other device copies may remain outside its control.

Link copied to clipboard

Discovers safe references and failures from the same attempt. No secret leaves discovery.

Link copied to clipboard

Reopens the selected identity, or creates the recommended identity without recovery using configured defaults. Pending and unavailable states never cause replacement key generation. Use creationOptions for an explicit choice.

Link copied to clipboard

Reports each configured recovery provider, including its unmet prerequisites.

Link copied to clipboard

Validates the record, private/public key and exact DID before offering supported destinations.

Link copied to clipboard

Restores into an empty wallet, or repairs the same identity after its native key is missing/invalidated.

Link copied to clipboard

Retries a persisted backup submission, or removes an interrupted pre-activation key operation.

Link copied to clipboard

Returns established identity metadata, including an explicit unavailable or interrupted state.