React and React Native request errors
Theswap method from useSwap rejects its Promise if signing or request submission fails.
If signing takes longer than the request expiry window, the hook throws a PrivyClientError
with code embedded_wallet_request_expired. This can happen when a mobile app is backgrounded during signing.
Prompt the user to retry; the expired request is not submitted.
For failures after action creation, see execution errors and action status polling.
Validation errors
Routing errors
Execution errors
A swap that passes validation is accepted as a wallet action and executed asynchronously. The following conditions are not returned on the request — they surface as arejected wallet action, before anything is submitted on-chain. Poll the wallet action or subscribe
to the swap.rejected webhook to detect them.

