Module genshin.client.components.auth.subclients.app
App sub client for AuthClient.
Covers HoYoLAB and Miyoushe app auth endpoints.
Classes
class AppAuthClient (cookies: ForwardRef('http.cookies.BaseCookie[Any]') | Mapping[Any, Any] | str | Sequence[ForwardRef('http.cookies.BaseCookie[Any]') | Mapping[Any, Any] | str] | None = None,
*,
authkey: str | None = None,
lang: Literal['zh-cn', 'zh-tw', 'de-de', 'en-us', 'es-es', 'fr-fr', 'id-id', 'it-it', 'ja-jp', 'ko-kr', 'pt-pt', 'ru-ru', 'th-th', 'vi-vn', 'tr-tr'] = 'en-us',
region: Region = Region.OVERSEAS,
proxy: str | None = None,
game: Game | None = None,
uid: int | None = None,
hoyolab_id: int | None = None,
device_id: str | None = None,
device_fp: str | None = None,
headers: Mapping[str, str] | Mapping[multidict._multidict.istr, str] | multidict._multidict.CIMultiDict | multidict._multidict.CIMultiDictProxy | Iterable[Tuple[str | multidict._multidict.istr, str]] | None = None,
cache: BaseCache | None = None,
debug: bool = False)-
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookiesApp sub client for AuthClient.
Ancestors
- BaseClient
- abc.ABC
Subclasses
Class variables
var logger : logging.Logger
Instance variables
var authkeys : dict[Game, str]-
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookies var cache : BaseCache-
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookies -
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookies var custom_headers : multidict._multidict.CIMultiDict[str]-
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookies var uids : dict[Game, int]-
Expand source code
class AppAuthClient(base.BaseClient): """App sub client for AuthClient.""" @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: SessionMMTResult, ticket: None = ..., ) -> typing.Union[AppLoginResult, ActionTicket]: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: ActionTicket, ) -> AppLoginResult: ... @typing.overload async def _app_login( # noqa: D102 missing docstring in overload? self, account: str, password: str, *, encrypted: bool = ..., mmt_result: None = ..., ticket: None = ..., ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: ... async def _app_login( self, account: str, password: str, *, encrypted: bool = False, mmt_result: typing.Optional[SessionMMTResult] = None, ticket: typing.Optional[ActionTicket] = None, ) -> typing.Union[AppLoginResult, SessionMMT, ActionTicket]: """Login with a password using HoYoLab app endpoint. Returns ------- - Cookies if login is successful. - SessionMMT if captcha is triggered. - ActionTicket if email verification is required. """ headers = { **auth_utility.APP_LOGIN_HEADERS, "ds": ds_utility.generate_dynamic_secret(constants.DS_SALT["app_login"]), } if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() if ticket: headers["x-rpc-verify"] = ticket.to_rpc_verify_header() payload = { "account": account if encrypted else auth_utility.encrypt_credentials(account, 1), "password": password if encrypted else auth_utility.encrypt_credentials(password, 1), } async with self.cookie_manager.create_session() as session: async with session.post( routes.APP_LOGIN_URL.get_url(), json=payload, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] == -3239: # Email verification required action_ticket = json.loads(r.headers["x-rpc-verify"]) return ActionTicket(**action_ticket) if not data["data"]: errors.raise_for_retcode(data) cookies = { "stoken": data["data"]["token"]["token"], "ltuid_v2": data["data"]["user_info"]["aid"], "ltmid_v2": data["data"]["user_info"]["mid"], "account_id_v2": data["data"]["user_info"]["aid"], "account_mid_v2": data["data"]["user_info"]["mid"], } self.set_cookies(cookies) return AppLoginResult(**cookies) async def _send_verification_email( self, ticket: ActionTicket, *, mmt_result: typing.Optional[SessionMMTResult] = None, ) -> typing.Union[None, SessionMMT]: """Send verification email. Returns None if success, SessionMMT data if geetest triggered. """ headers = {**auth_utility.EMAIL_SEND_HEADERS} if mmt_result: headers["x-rpc-aigis"] = mmt_result.to_aigis_header() async with self.cookie_manager.create_session() as session: async with session.post( routes.SEND_VERIFICATION_CODE_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, }, headers=headers, ) as r: data = await r.json() if data["retcode"] == -3101: # Captcha triggered aigis = json.loads(r.headers["x-rpc-aigis"]) return SessionMMT(**aigis) if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _verify_email(self, code: str, ticket: ActionTicket) -> None: """Verify email.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.VERIFY_EMAIL_URL.get_url(), json={ "action_type": "verify_for_component", "action_ticket": ticket.verify_str.ticket, "email_captcha": code, "verify_method": 2, }, headers=auth_utility.EMAIL_VERIFY_HEADERS, ) as r: data = await r.json() if data["retcode"] != 0: errors.raise_for_retcode(data) return None async def _create_qrcode(self) -> QRCodeCreationResult: """Create a QR code for login.""" async with self.cookie_manager.create_session() as session: async with session.post( routes.CREATE_QRCODE_URL.get_url(), headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeCreationResult( ticket=data["data"]["ticket"], url=data["data"]["url"], ) async def _check_qrcode(self, ticket: str) -> tuple[QRCodeStatus, SimpleCookie]: """Check the status of a QR code login.""" payload = {"ticket": ticket} async with self.cookie_manager.create_session() as session: async with session.post( routes.CHECK_QRCODE_URL.get_url(), json=payload, headers=auth_utility.QRCODE_HEADERS, ) as r: data = await r.json() if not data["data"]: errors.raise_for_retcode(data) return QRCodeStatus(data["data"]["status"]), r.cookies
Inherited members