FAQ

Q: The client accepts strings where the API expects enums — is that safe?

A: The library may accept plain strings in some places, but you should prefer passing enum members from aiorocket2.enums (for example Network.TON or Country.US). This protects against typos and keeps your code self-documenting.

Q: I get xRocketAPIError with a non-helpful message — how to debug?

A: Inspect the exception payload; enable logging of request/response in your environment. Verify you pass correct types and valid values (enums, currency codes, correct numeric precision). For transient network errors, the client will retry according to configured retries and backoff_base.

Q: How to use testnet?

A: Initialize the client with testnet=True or set base_url to your staging endpoint. Testnet avoids real transfers.

Q: Where to find upstream API docs?

A: Official xRocket API: https://pay.xrocket.exchange/api