Skip to content

Clarify refund amounts and gas cost deductions in refunds documentation #263

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pedromcunha merged 2 commits into from
Feb 26, 2026
Merged

Clarify refund amounts and gas cost deductions in refunds documentation #263

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d0b926d
Add refund amounts and costs section to clarify deductions
relay-clarity[bot] Feb 26, 2026
8aa31de
Fix refund example
pedromcunha Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions references/api/api_core_concepts/refunds.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,14 @@ the chain is experiencing a large reorganization.
- *User Sends Deposits With the Same Request ID in the Calldata Multiple Times*
- *User Send Deposits Without a Request ID in the Calldata*

## Refund amounts and costs
The refund amount may be less than what you originally deposited due to several factors:

- **Gas costs are deducted:** The gas cost of processing the refund transaction is deducted from the refunded amount.
- **Origin swaps:** If your transaction included an origin swap, you will only receive what the depository contract actually received after the swap, not your original deposit amount.

For example, if you send us a memecoin it will be swapped to USDC as a part of the deposit transaction. In the case of a refund we will refund in USDC for the amount the deposit contract received after the swap into USDC minus the cost of gas.

## When is there no refund given?
If the refund amount is not enough to cover the cost of gas, Relay will
mark the bridge or swap as failed & no refund will be sent.
Expand Down