Implement Gas sponsorship relay endpoint#122
Merged
PeterOche merged 3 commits intodegenspot:mainfrom Mar 24, 2026
Merged
Conversation
|
@gabito1451 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits. You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀 |
PeterOche
approved these changes
Mar 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pr implements the gas sponsorship relay endpoint as requested. This feature allows the backend to sponsor transactions for users by co-signing them using a hot wallet, provided the transactions target the CallRegistry contract.
Key Implementation Details:
Relay Service (
RelayService
):
Transaction Validation: Implements a strict check ensuring that every operation in the transaction is a Soroban InvokeHostFunction call specifically directed at the configured CallRegistry contract ID.
Fee Sponsorship: Uses Stellar Fee-Bump Transactions to wrap the user's signed transaction, allowing the backend to pay for gas fees without the user needing native XLM.
Hot Wallet Signing: Dynamically signs the fee-bump outer transaction using the RELAY_HOT_WALLET_SECRET.
Relay Controller (
RelayController
):
Exposes POST /relay/tx which accepts a transaction XDR.
Returns the transaction hash upon successful submission to the Stellar network.
Module Integration:
Created
RelayModule
and integrated it into the main
AppModule
.
Configured a dedicated SorobanRpc.Server for relay operations.
Configuration:
Updated
.env.example
to include the RELAY_HOT_WALLET_SECRET variable.
Files Created/Modified:
relay.service.ts
(New)
relay.controller.ts
(New)
relay.module.ts
(New)
app.module.ts
(Modified)
closes #118