# 메서드

Wepin Android Login Library에서 제공하는 메서드 입니다.

## loginWithOauthProvider

```java
wepinLogin.loginWithOauthProvider(params)
```

In-app browser가 열리고 OAuth provider에 로그인 합니다. Firebase 로그인 정보를 가져오려면 loginWithIdToken() 또는 loginWithAccessToken() 메서드를 호출해야 합니다.

**Parameters**

* `params` \<LoginOauth2Params>
  * `provider` <'google'|'naver'|'discord'|'apple'> - Provider for login
  * `clientId` \<String>

**Returns**

* CompletableFuture\<LoginOauthResult>
  * `provider` \<String> - login provider
  * `token` \<String> - accessToken (if provider is "naver" or "discord") or idToken (if provider is "google" or "apple")
  * `type` \<OauthTokenType> - type of token

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
LoginOauth2Params loginOption = new LoginOauth2Params(
                    provider = "discord",
                    clientId = getString(R.string.default_discord_client_id),
                  )
CompletableFuture<LoginOauthResult> res = wepinLogin.loginWithOauthProvider(loginOption);
res.whenComplete((loginResponse, error) -> {
    if (error == null) {
        System.out.println("loginResponse: " + loginResponse);
        String privateKey = "private key for wepin id/access Token"
        // token sign 
        String sign = wepinLogin.getSignForLogin(loginResponse.token, privateKey)
        //call loginWithIdToken() or loginWithAccessToken()
    } else {
        // render error UI
        System.out.println("login error" + error.getMessage())
    }
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val loginOption = LoginOauth2Params(
                  provider = "discord",
                  clientId = getString(R.string.default_discord_client_id),
                )
wepinLogin.loginWithOauthProvider(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
      // render logged in UI
      println(loginResponse)
      val privateKey = "private key for wepin id/access Token"
      // token sign 
      wepinLogin.getSignForLogin(loginResponse.token, privateKey)
      //call loginWithIdToken() or loginWithAccessToken()
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## signUpWithEmailAndPassword

```java
wepinLogin.signUpWithEmailAndPassword(params)
```

이메일과 비밀번호로 Wepin Firebase에 회원가입을 합니다. 가입되지 않은 사용자의 경우 검증 이메일이 전송되며, `REQUIRED_EMAIL_VERIFIED` 오류가 발생합니다. 이미 가입된 사용자의 경우, `EXISTED_EMAIL` 오류가 발생하며 [loginWithEmailAndPassword](#loginwithemailandpassword)를 호출하여 로그인 프로세스를 진행합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

**Parameters**

* `params` \<LoginWithEmailParams>
  * `email` \<String> - User email
  * `password` \<String> - User password
  * `locale` \<String> - **optional** Language for the verification email (default value: "en")

**Returns**

* CompletableFuture\<LoginResult>
  * `provider` \<Providers.EMAIL>
  * `token` \<FBToken>
    * `idToken` \<String> - wepin firebase idToken
    * `refreshToken` \` - wepin firebase refreshToken

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
LoginWithEmailParams loginOption = new LoginWithEmailParams(
                    "abc@defg.com",
                    "abcdef123&",
                    "ko"
                  )
CompletableFuture<LoginResult> res = wepinLogin.signUpWithEmailAndPassword(loginOption);
res.whenComplete((loginResponse, error) -> {
    if (error == null) {
        System.out.println("loginResponse: " + loginResponse);
    } else {
        // render error UI
        System.out.println("login error" + error.getMessage())
    }
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val loginOption = LoginWithEmailParams(
                  email = "abc@defg.com",
                  password = "abcdef123&",
                  language = "ko"
                )
wepinLogin.signUpWithEmailAndPassword(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
      // render logged in UI
      println(loginResponse)
      
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## loginWithEmailAndPassword

```java
wepinLogin.loginWithEmailAndPassword(params)
```

이메일과 비밀번호를 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

**Parameters**

* `params` \<LoginWithEmailParams>
  * `email` \<String> - User email
  * `password` \<String> - User password

**Returns**

* CompletableFuture\<LoginResult>
  * `provider` \<Providers.EMAIL>
  * `token` \<FBToken>
    * `idToken` \<String> - wepin firebase idToken
    * `refreshToken` \` - wepin firebase refreshToken

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

<pre class="language-java"><code class="lang-java"><strong>LoginWithEmailParams loginOption = new LoginWithEmailParams(
</strong>                    "abc@defg.com",
                    "abcdef123&#x26;",
                  )
CompletableFuture&#x3C;LoginResult> res = wepinLogin.loginWithEmailAndPassword(loginOption);
res.whenComplete((loginResponse, error) -> {
    if (error == null) {
        System.out.println("loginResponse: " + loginResponse);
    } else {
        // render error UI
        System.out.println("login error" + error.getMessage())
    }
});
</code></pre>

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val loginOption = LoginWithEmailParams(
                  email = "abc@defg.com",
                  password = "abcdef123&",
                  language = "ko"
                )
wepinLogin.loginWithEmailAndPassword(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
      // render logged in UI
      println(loginResponse)
      
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## loginWithIdToken

```java
wepinLogin.loginWithIdToken(params)
```

외부 ID 토큰을 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

**Parameters**

* `params` \<LoginOauthIdTokenRequest>
  * `token` \<String> - ID token value to be used for login
  * `sign` \<String> - token 에 대한 서명값입니다. (Returned value of [getSignForLogin()](#getsignforlogin)).&#x20;

{% hint style="warning" %}
Note

WepinLogin 버전 1.0.0부터는 `sign` 값이 선택 사항입니다.

[Wepin Workspace](https://workspace.wepin.io/) 에서 발급된 인증 키를 제거하는 경우, `sign` 값을 사용하지 않아도 됩니다.

(Wepin Workspace > 개발 도구 메뉴 > 로그인 탭 > 인증 키 > 삭제)

> 인증 키 메뉴는 이전에 인증 키를 발급한 경우에만 표시됩니다.

WepinLogin 버전 1.1.0부터는 `sign` 값이 제거되었습니다.

WepinLogin 버전 1.1.0 을 사용하는 경우 반드시 [Wepin Workspace](https://workspace.wepin.io/) 에서 발급된 인증 키를 제거해야 합니다.
{% endhint %}

**Returns**

* CompletableFuture\<LoginResult>
  * `provider` \<Providers.EXTERNAL\_TOKEN>
  * `token` \<FBToken>
    * `idToken` \<String> - wepin firebase idToken
    * `refreshToken` \` - wepin firebase refreshToken

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

<pre class="language-java"><code class="lang-java"><strong>String token = "eyJHGciO....adQssw5c"
</strong>String sign = "9753d4dc...c63466b9"
LoginWithEmailParams loginOption = new LoginOauthIdTokenRequest(token, sign)
CompletableFuture&#x3C;LoginResult> res = wepinLogin.loginWithIdToken(loginOption);
res.whenComplete((loginResponse, error) -> {
    if (error == null) {
        System.out.println("loginResponse: " + loginResponse);
    } else {
        // render error UI
        System.out.println("login error" + error.getMessage())
    }
});

</code></pre>

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val token = "eyJHGciO....adQssw5c"
val sign = "9753d4dc...c63466b9"
val loginOption = new LoginOauthIdTokenRequest(token, sign)
wepinLogin.loginWithIdToken(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
      // render logged in UI
      println(loginResponse)
      
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## loginWithAccessToken

```java
wepinLogin.loginWithAccessToken(params)
```

외부 Access Token을 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

**Parameters**

* `params` \<LoginOauthAccessTokenRequest>
  * `provider` <"naver"|"discord"> - Provider that issued the access token
  * `accessToken` \<String> - Access token value to be used for login
  * `sign` \<String> -  accessToken에 대한 서명값입니다. (Returned value of [getSignForLogin()](#getsignforlogin)).&#x20;

{% hint style="warning" %}
Note

WepinLogin 버전 1.0.0부터는 `sign` 값이 선택 사항입니다.

[Wepin Workspace](https://workspace.wepin.io/) 에서 발급된 인증 키를 제거하는 경우, `sign` 값을 사용하지 않아도 됩니다.

(Wepin Workspace > 개발 도구 메뉴 > 로그인 탭 > 인증 키 > 삭제)

> 인증 키 메뉴는 이전에 인증 키를 발급한 경우에만 표시됩니다.

WepinLogin 버전 1.1.0부터는 `sign` 값이 제거되었습니다.

WepinLogin 버전 1.1.0 을 사용하는 경우 반드시 [Wepin Workspace](https://workspace.wepin.io/) 에서 발급된 인증 키를 제거해야 합니다.
{% endhint %}

**Returns**

* CompletableFuture\<LoginResult>
  * `provider` \<Providers.EXTERNAL\_TOKEN>
  * `token` \<FBToken>
    * `idToken` \<String> - wepin firebase idToken
    * `refreshToken` \` - wepin firebase refreshToken

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
String accessToken = "eyJHGciO....adQssw5c"
String sign = "9753d4dc...c63466b9"
LoginOauthAccessTokenRequest loginOption = new LoginOauthAccessTokenRequest("discord", accessToken, sign)
CompletableFuture<LoginResult> res = wepinLogin.loginWithAccessToken(loginOption);
res.whenComplete((loginResponse, error) -> {
    if (error == null) {
        System.out.println("loginResponse: " + loginResponse);
    } else {
        // render error UI
        System.out.println("login error" + error.getMessage())
    }
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val accessToken = "eyJHGciO....adQssw5c"
val sign = "9753d4dc...c63466b9"
val loginOption = LoginOauthAccessTokenRequest(
  provider = "discord",
  accessToken = accessToken, sign = sign
)
wepinLogin.loginWithAccessToken(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
    // render logged in UI
    println(loginResponse) 
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## getRefreshFirebaseToken

```java
wepinLogin.getRefreshFirebaseToken()
```

현재 Wepin Firebase 토큰의 정보를 가져옵니다.

**Parameters**

* void

**Returns**

* CompletableFuture\<LoginResult>
  * `provider` \<Providers>
  * `token` \<FBToken>
    * `idToken` \<String> - wepin firebase idToken
    * `refreshToken` \` - wepin firebase refreshToken

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
CompletableFuture<WepinUser> res = wepinLogin.getRefreshFirebaseToken();
res.whenComplete((firebaseResponse, error) -> {
  if (error == null) {
      System.out.println("firebaseResponse: " + firebaseResponse);
      // render logged in UI
        println(firebaseResponse)
  } else {
      // render error UI
      System.out.println("login error: " + error.getMessage());
  }
});
```

{% endtab %}

{% tab title="Kotlin" %}

<pre class="language-kotlin"><code class="lang-kotlin">wepinLogin.getRefreshFirebaseToken().whenComplete { firebaseResponse, error ->
<strong>  if (error == null) {
</strong>    println(firebaseResponse)
    // render logged in UI
  } else {
    println("login error - ${error.message}")
    // render error UI
  }
}
</code></pre>

{% endtab %}
{% endtabs %}

## loginWepin

```java
wepinLogin.loginWepin(param)
```

지정된 프로바이더와 토큰을 사용하여 사용자를 위핀에 로그인합니다.

**Parameters**

매개변수는 이 모듈 내에서 loginWithEmailAndPassword(), loginWithIdToken(), loginWithAccessToken() 메서드의 반환 값을 활용해야 합니다.

* \<LoginResult>
  * provider \<Providers>
  * token \<FBToken>
    * idToken \<String> - Wepin Firebase idToken
    * refreshToken\<String> - Wepin Firebase refreshToken

**Returns**

* CompletableFuture\<WepinUser> - A promise that resolves to an object containing the user's login status and information. The object includes:
  * status <'success'|'fail'> - The login status.
  * userInfo \<UserInfo> **optional** - The user's information, including:
    * userId \<String> - The user's ID.
    * email \<String> - The user's email.
    * provider <'google'|'apple'|'naver'|'discord'|'email'|'external\_token'> - The login provider.
    * use2FA \<Boolean> - Whether the user uses two-factor authentication.
  * walletId \<String> = The user's wallet ID.
  * userStatus: \<UserStatus> - The user's status of wepin login. including:
    * loginStats: <'complete' | 'pinRequired' | 'registerRequired'> - If the user's loginStatus value is not complete, it must be registered in the wepin.
    * pinRequired?:
  * token: \<Token> - The user's token of wepin.
    * accessToken: \<String>
    * refreshToken \<String>

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
String accessToken = "eyJHGciO....adQssw5c"
String sign = "9753d4dc...c63466b9"
LoginOauthAccessTokenRequest loginOption = new LoginOauthAccessTokenRequest("discord", accessToken, sign)
CompletableFuture<LoginResult> res = wepinLogin.loginWithAccessToken(loginOption);
res.whenComplete((loginResponse, error) -> {
  if (error == null) {
      System.out.println("loginResponse: " + loginResponse);
      CompletableFuture<LoginResult> resWepin = wepinLogin.loginWepin(loginResponse);
      resWepin.whenComplete((loginWepinResponse, error) -> {
        if (error == null) {
            System.out.println("loginWepinResponse: " + loginWepinResponse);
            if(loginWepinResponse.loginStatus === WepinLoginStatus.PIN_REQUIRED||loginWepinResponse.loginStatus === WepinLoginStatus.REGISTER_REQUIRED) {
                // wepin registration
            }else {
              // render logged in UI
            }                
        } else {
            // render error UI
            System.out.println("login error" + error.getMessage())
        }
      })
  } else {
      // render error UI
      System.out.println("login error" + error.getMessage())
}
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val accessToken = "eyJHGciO....adQssw5c"
val sign = "9753d4dc...c63466b9"
val loginOption = LoginOauthAccessTokenRequest(
  provider = "discord",
  accessToken = accessToken, sign = sign
)
wepinLogin.loginWithAccessToken(loginOption).whenComplete { loginResponse, error ->
  if (error == null) {
      println(loginResponse)
      wepinLogin.loginWepin(loginResponse).whenComplete { loginWepinResponse, err ->
        if (err == null) {
            println(loginWepinResponse)
            if(loginWepinResponse.loginStatus === WepinLoginStatus.PIN_REQUIRED||loginWepinResponse.loginStatus === WepinLoginStatus.REGISTER_REQUIRED) {
              // wepin registration
          }else {
            // render logged in UI
          }                 
        } else {
            println("login err - ${err.message}")
            // render error UI
        }
    }   
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## getCurrentWepinUser

```java
wepinLogin.getCurrentWepinUser()
```

이 메서드는 위핀에 현재 로그인한 사용자의 정보를 가져옵니다.

**Parameters**

* void

**Returns**

* CompletableFuture\<WepinUser> - A promise that resolves to an object containing the user's login status and information. The object includes:
  * status <'success'|'fail'> - The login status.
  * userInfo \<UserInfo> **optional** - The user's information, including:
    * userId \<String> - The user's ID.
    * email \<String> - The user's email.
    * provider <'google'|'apple'|'naver'|'discord'|'email'|'external\_token'> - The login provider.
    * use2FA \<Boolean> - Whether the user uses two-factor authentication.
  * walletId \<String> = The user's wallet ID.
  * userStatus: \<UserStatus> - The user's status of wepin login. including:
    * loginStats: <'complete' | 'pinRequired' | 'registerRequired'> - If the user's loginStatus value is not complete, it must be registered in the wepin.
    * pinRequired?:
  * token: \<Token> - The user's token of wepin.
    * accessToken: \<String>
    * refreshToken \<String>

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

<pre class="language-java"><code class="lang-java"><strong>CompletableFuture&#x3C;WepinUser> res = wepinLogin.getCurrentWepinUser();
</strong>res.whenComplete((wepinUserResponse, error) -> {
  if (error == null) {
      System.out.println("wepinUserResponse: " + wepinUserResponse);
      if (wepinUserResponse.loginStatus == WepinLoginStatus.PIN_REQUIRED || wepinUserResponse.loginStatus == WepinLoginStatus.REGISTER_REQUIRED) {
          // wepin registration
      } else {
          // render logged in UI
      }
  } else {
      // render error UI
      System.out.println("login error: " + error.getMessage());
  }
});
</code></pre>

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
wepinLogin.getCurrentWepinUser().whenComplete { wepinUserResponse, error ->
  if (error == null) {
      println(wepinUserResponse)
      if (wepinUserResponse.loginStatus == WepinLoginStatus.PIN_REQUIRED || wepinUserResponse.loginStatus == WepinLoginStatus.REGISTER_REQUIRED) {
          // wepin registration
      } else {
          // render logged in UI
      }
  } else {
      println("login error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## logoutWepin

```java
wepinLogin.logoutWepin()
```

위핀에 로그인한 사용자를 로그아웃합니다.

**Parameters**

* void

**Returns**

* CompletableFuture\<Boolean>

**Exception**

* [Wepin Error](#wepin-error)

**Example**

{% tabs %}
{% tab title="Java" %}

```java
CompletableFuture<Boolean> res = wepinLogin.logoutWepin();
res.whenComplete((logoutResponse, error) -> {
  if (error == null) {
      System.out.println("logoutResponse: " + logoutResponse);
  } else {
      // render error UI
      System.out.println("logout error" + error.getMessage())
  }
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
wepinLogin.logoutWepin().whenComplete { logoutResponse, error ->
  if (error == null) {
      println(logoutResponse)
  } else {
      println("logout error - ${error.message}")
      // render error UI
  }
}
```

{% endtab %}
{% endtabs %}

## getSignForLogin(Deprecated)

{% hint style="danger" %}
🔄 `getSignForLogin`은 더 이상 지원되지 않습니다\
• v1.1.0부터 `getSignForLogin()` 함수는 로그인 프로세스에서 `sign` 파라미터가 제거됨에 따라 더 이상 지원되지 않습니다.\
• 서명 없이 로그인하려면, **Wepin Workspace > 개발 도구 메뉴 > 로그인 탭 > 인증 키 > 삭제**에서 인증키를 삭제해 주세요.\
• 인증키 메뉴는 이전에 키를 생성한 경우에만 표시됩니다.
{% endhint %}

발급자를 확인하기 위한 서명을 생성합니다. 주로 ID Token 및 Access Token과 같은 로그인 관련 정보를 위한 서명을 생성하는 데 사용됩니다.

```kotlin
wepinLogin.getSignForLogin(privKey, message);
```

**Parameters**

* `privKey` \<String> - The authentication key used for signature generation.
* `message` \<String> - The message or payload to be signed.

**Returns**

* String - The generated signature.

{% hint style="warning" %}
인증 키(privKey)는 안전하게 저장되어야 하며 외부에 노출되어서는 안 됩니다. 보안과 민감한 정보 보호를 강화하기 위해 getSignForLogin() 메서드는 프론트엔드가 아닌 백엔드에서 실행하는 것이 권장됩니다.
{% endhint %}

**Example**

{% tabs %}
{% tab title="Java" %}

```java
String privKey = '0400112233445566778899001122334455667788990011223344556677889900'
String idToken = 'idtokenabcdef'
String sign = wepinLogin.getSignForLogin(privKey, idToken)
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
val privKey = '0400112233445566778899001122334455667788990011223344556677889900'
val idToken = 'idtokenabcdef'
val sign = wepinLogin.getSignForLogin(privKey, idToken)
```

{% endtab %}
{% endtabs %}

## finalize

```java
wepinLogin.finalize()
```

Wepin Login Library 를 종료 합니다.

**Parameters**

* void

**Returns**

* void

**Example**

{% tabs %}
{% tab title="Java" %}

```java
wepinLogin.finalize()
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
wepinLogin.finalize()
```

{% endtab %}
{% endtabs %}

## Wepin Error

| Error Code                  | Error Message                     | Error Description                                                                                                                                                                                    |
| --------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_APP_KEY`           | "Invalid app key"                 | The Wepin app key is invalid.                                                                                                                                                                        |
| `INVALID_PARAMETER` \`      | "Invalid parameter"               | One or more parameters provided are invalid or missing.                                                                                                                                              |
| `INVALID_LOGIN_PROVIDER`    | "Invalid login provider"          | The login provider specified is not supported or is invalid.                                                                                                                                         |
| `INVALID_TOKEN`             | "Token does not exist"            | The token does not exist.                                                                                                                                                                            |
| `INVALID_LOGIN_SESSION`     | "Invalid Login Session"           | The login session information does not exist.                                                                                                                                                        |
| `NOT_INITIALIZED_ERROR`     | "Not initialized error"           | The WepinLoginLibrary has not been properly initialized.                                                                                                                                             |
| `ALREADY_INITIALIZED_ERROR` | "Already initialized"             | The WepinLoginLibrary is already initialized, so the logout operation cannot be performed again.                                                                                                     |
| `NOT_ACTIVITY`              | "Context is not activity"         | The Context is not an activity                                                                                                                                                                       |
| `USER_CANCELLED`            | "User cancelled"                  | The user has cancelled the operation.                                                                                                                                                                |
| `UNKNOWN_ERROR`             | "An unknown error occurred"       | An unknown error has occurred, and the cause is not identified.                                                                                                                                      |
| `NOT_CONNECTED_INTERNET`    | "No internet connection"          | The system is unable to detect an active internet connection.                                                                                                                                        |
| `FAILED_LOGIN`              | "Failed to Oauth log in"          | The login attempt has failed due to incorrect credentials or other issues.                                                                                                                           |
| `ALREADY_LOGOUT`            | "Already Logout"                  | The user is already logged out, so the logout operation cannot be performed again.                                                                                                                   |
| `INVALID_EMAIL_DOMAIN`      | "Invalid email domain"            | The provided email address's domain is not allowed or recognized by the system.                                                                                                                      |
| `FAILED_SEND_EMAIL`         | "Failed to send email"            | The system encountered an error while sending an email. This is because the email address is invalid or we sent verification emails too often. Please change your email or try again after 1 minute. |
| `REQUIRED_EMAIL_VERIFIED`   | "Email verification required"     | Email verification is required to proceed with the requested operation.                                                                                                                              |
| `INCORRECT_EMAIL_FORM`      | "Incorrect email format"          | The provided email address does not match the expected format.                                                                                                                                       |
| `INCORRECT_PASSWORD_FORM`   | "Incorrect password format"       | The provided password does not meet the required format or criteria.                                                                                                                                 |
| `NOT_INITIALIZED_NETWORK`   | "Network Manager not initialized" | The network or connection required for the operation has not been properly initialized.                                                                                                              |
| `REQUIRED_SIGNUP_EMAIL`     | "Email sign-up required."         | The user needs to sign up with an email address to proceed.                                                                                                                                          |
| `FAILED_EMAIL_VERIFIED`     | "Failed to verify email."         | The WepinLoginLibrary encountered an issue while attempting to verify the provided email address.                                                                                                    |
| `FAILED_PASSWORD_SETTING`   | "Failed to set password."         | The WepinLoginLibrary failed to set the password.                                                                                                                                                    |
| `EXISTED_EMAIL`             | "Email already exists."           | The provided email address is already registered in Wepin.                                                                                                                                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wepin.io/widget-integration/android-java-and-kotlin-sdk/login-library/methods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.