CaptchaHandler or Bot.handle_captcha() ?

[TheRealRedSlime]

Hi,

i am completely lost between versions of discord.py-self, and with the CORRECT WAY to solve captchas.
It's been a lot of days im searching for this, and there is no clear & working answer on internet.
NOTE : I am using 2captcha.

In the v2.0.0, it's possible to implement a discord.CaptchaHandler when defining my discord.Bot or discord.Client, and there is no need to use bot.handle_captcha() when a CaptchaRequired is raised (because bot.handle_captcha() is not defined in the v2.0.0)
For this, the only good way i found is which posted on the telegram (11 Apr. 2022), refering to discord.CaptchaHandler in V2.0.0.
There is a script that looks operationnal. I used quite the same way in my script :

	class CaptchaSolver(discord.CaptchaHandler):
		def two_captcha(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
			api_key = 'my_api_key'
			solver = twocaptcha.TwoCaptcha(apiKey=api_key, defaultTimeout=180)
			result = solver.hcaptcha(
				sitekey=data['captcha_sitekey'],
				data=data['captcha_rqdata'],
				url='https://discord.com/channels/@me',
			)
			return result['code'] #perhaps return result instead of result["code"]

		async def fetch_token(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
			loop = asyncio.get_running_loop()
			return await loop.run_in_executor(None, self.two_captcha, data, proxy, proxy_auth)

But this is not working.

So I looked for Bot.handle_captcha(), which is only available with cloning the lastest version of the github repository (looks like it's V2.1.0)
The handle_captcha() method is referring to the captcha_handler param indicated when defining the Bot/Client.

BUT in this version, discord.CaptchaHandler class has been removed, so I absolutely don't understand what do I have to put in the captcha_handler parameter !
It's written "(Optional[Callable[[CaptchaRequired, Client], Awaitable[str]])" - btw its missing a ] to Optionnal[]
... I am completely lost 😢
Which version should i use ? I am getting so much different errors that i can't place them all here ...

This is a part of my script :

		elif msg.content.startswith(f"{bot.user.mention} dm ") :
			nothing, dm, user, *args = msg.content.split(" ")
			user = await  bot.fetch_user(int(user))
			try :
				dmchannel = await user.create_dm()
				await dmchannel.send(' '.join(args))
			except discord.CaptchaRequired as err : 
				await bot.handle_captcha(err)

NOTE : depending on the version of discord.py-self I use, i remove discord.CaptchaHandler or await bot.handle_captcha(err)

Thank you so much 🙏

[dolfies]

Captcha handling was rewritten in v2.1 because it was unnecessarily complicated.

The Optional[Callable[[CaptchaRequired, Client], Awaitable[str]])] syntax essentially means it accepts a method that looks like this:

async def captcha(exc: discord.CaptchaRequired, bot: commands.Bot) -> str:
    # do stuff here, e.g. run your existing two_captcha() function in an executor
    log.debug(f'Got a CAPTCHA with sitekey {exc.sitekey}')

bot = commands.Bot(captcha_handler=captcha)

This is handled by the Bot.handle_captcha() method you mentioned, which can alternatively be overrided if you are already subclassing Client/Bot:

class MyBot(commands.Bot):
    async def handle_captcha(self, exc: discord.CaptchaRequired) -> str:
        # do stuff here, e.g. run your existing two_captcha() function in an executor
        log.debug(f'Got a CAPTCHA with sitekey {exc.sitekey}')

bot = MyBot()  # do NOT use the captcha_handler parameter if you override the above method

Side note: I don't recommend services like TwoCaptcha.

[TheRealRedSlime]

Just another question, can I do this :

	class MyBot(commands.Bot):
		async def handle_captcha(self, exc: discord.CaptchaRequired) -> str:
			def two_captcha(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
				api_key = 'myapikey'
				solver = twocaptcha.TwoCaptcha(apiKey=api_key, defaultTimeout=180)
				result = solver.hcaptcha(
					sitekey=data['captcha_sitekey'],
					data=data['captcha_rqdata'],
					url='https://discord.com/channels/@me',
				)
				return result['code']

			log.debug(f'Got a CAPTCHA with sitekey {exc.sitekey}')
			loop = asyncio.get_running_loop()
			return await loop.run_in_executor(None, two_captcha, data, proxy, proxy_auth) # and what do I have to put right here ?

Or do I have to still use the fetch_token() method into my handle_captcha() method ?
(like this ↓)

	class MyBot(commands.Bot):
		def two_captcha(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
			api_key = 'myapikey'
			solver = twocaptcha.TwoCaptcha(apiKey=api_key, defaultTimeout=180)
			result = solver.hcaptcha(
				sitekey=data['captcha_sitekey'],
				data=data['captcha_rqdata'],
				url='https://discord.com/channels/@me',
			)
			return result['code']

		async def fetch_token(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
			log.debug(f'Got a CAPTCHA with sitekey {exc.sitekey}')
			loop = asyncio.get_running_loop()
			return await loop.run_in_executor(None, self.two_captcha, data, proxy, proxy_auth)

And thank you so much for your quick help 🙏

[Sitois]

So, It should be used like:

async def captcha(exc: discord.CaptchaRequired, bot: commands.Bot) -> str:
	def two_captcha(self, data: dict, proxy: str, proxy_auth: aiohttp.BasicAuth) -> str:
		api_key = 'key'
		solver = twocaptcha.TwoCaptcha(apiKey=api_key, defaultTimeout=180)
		result = solver.hcaptcha(
			sitekey=data['captcha_sitekey'],
			data=data['captcha_rqdata'],
			url='https://discord.com/channels/@me',
     	)
		return result['code'] 

(It will be really helpful if you can answer quickly!)
?