rate_limited decorator doesn't pass type checker

[jamesbraza]

I tried to add --doctest-modules to pytest, but it doesn't work because the rate_limited decorator (from #520) doesn't pass typeguard.

In that PR we got rate_limited to pass mypy via type: ignore comments, but typeguard is not mypy. We should fix the typing of rate_limited.