Create an XLM CAP-15 fee-bump request

post

https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/xlm/feebump

Wraps a fully-signed inner XLM transaction in a CAP-15 fee-bump where the outer fee is paid by the designated fee-source address, instead of the account that signed the inner transaction.
Required role: RequestCreator.
Idempotent via externalRequestId.

Body Params

Wraps a fully-signed inner XLM transaction in a CAP-15 fee-bump so the fee is paid by the designated fee-source address instead of the account that signed the inner transaction. The caller supplies the signed inner XDR TransactionEnvelope.

feeSourceAddressId

string

required

ID of the XLM address that pays the outer fee. Must be governed by an XLM_FeeBump rule line.

outerMaxFee

string

Absolute cap on the outer fee in stroops, as a decimal string. Mirrors tg-protect-engine field name.

innerEnvelope

string

required

XDR-encoded signed inner TransactionEnvelope (ENVELOPE_TYPE_TX/V1), embedded verbatim in the outer FeeBumpTransaction.

comment

string

Optional reconciliation note included in transaction history.

externalRequestId

string

Caller-supplied idempotency key. Repeats with the same id return the original request unchanged.

Responses

200A successful response.

400Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)

401Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource

403Forbidden: indicates that the server understands the request but refuses to authorize it

404Not Found: indicates that the server cannot find the requested resource

500Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request

503Service Unavailable: indicates that the server is not ready to handle the request.

defaultAn unexpected error response.