completeRegisterAlias

Complete an alias registration started with registerAlias by answering the challenge that the taldir service sent to the alias.

Request:

The request arguments are a TaldirRegistrationCompletionRequest object.

Response:

On success, the result is an empty object.

Side effects:

Completes the pending alias registration at the taldir service by submitting the challenge response over the network.

Expected errors:

The caller can handle the following errors inline: WALLET_ALIAS_REGISTRATION_FAILED, GENERIC_FORBIDDEN.

Details:

Wallet-core derives the answer sent to the service as the hash of the challenge together with the targetUri from the registration request, which protects the user against authorizing a concurrent registration of a different target URI. GENERIC_FORBIDDEN indicates that the service rejected the answer to the challenge.

interface TaldirRegistrationCompletionRequest {
  // Alias being registered.
  alias: string;

  // Type of the alias.
  aliasType: string;

  // Challenge received at the alias.
  challenge: string;

  // Base URL of the taldir service.
  taldirBaseUrl: string;

  // Target URI from the registration request.
  targetUri: string;
}