{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","not-enabled","code-page-name"]},"type":"markdown"},"seo":{"title":"SponsorshipSet","siteUrl":"https://opensource.ripple.com/","meta":[{"name":"google-site-verification","content":"bLwyBi1imklcIuQxZ7JeI_kRF5Mg7yfr6arpEQV2nsE"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Create, update, or delete a Sponsorship ledger entry on the XRP Ledger."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"sponsorshipset","__idx":0},"children":["SponsorshipSet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/tequdev/rippled/blob/sponsor/src/libxrpl/tx/transactors/Sponsor/SponsorshipSet.cpp"},"children":["[Source]"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create, update, or delete a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/xls-68-sponsored-fees-and-reserves/references/ledger-entries/sponsorship"},"children":["Sponsorship ledger entry"]}," on the XRP Ledger."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This transaction requires that you specify either the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CounterpartySponsor"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsee"]},", but not both."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Requires the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xls.xrpl.org/xls/XLS-0068-sponsored-fees-and-reserves.html"},"children":["Sponsor amendment"]}," ",{"$$mdtype":"Tag","name":"NotEnabled","attributes":{},"children":[]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-json","__idx":1},"children":["Example JSON"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"TransactionType\": \"SponsorshipSet\",\n  \"Account\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n  \"Sponsee\": \"rfkDkFai4jUfCvAJiZ5Vm7XvvWjYvDqeYo\",\n  \"FeeAmount\": \"1000000\",\n  \"MaxFee\": \"1000\",\n  \"ReserveCount\": 5,\n  \"Fee\": \"12\",\n  \"Sequence\": 42\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sponsorshipset-fields","__idx":2},"children":["SponsorshipSet"," Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/xls-68-sponsored-fees-and-reserves/references/transactions/updated-common-transaction-fields#common-transaction-updates#common-transaction-fields"},"children":["common fields"]},", ",{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"SponsorshipSet"},"children":[]}," transactions use the following fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field Name"},"children":["Field Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"JSON Type"},"children":["JSON Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/binary-format/"},"children":["Internal Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CounterpartySponsor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor associated with this relationship. This account also pays for the reserve of this object. If this field is included, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," is assumed to be the sponsee."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Amount"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The remaining amount of XRP that the sponsor has provided for the sponsee to use for fees. This value replaces what is currently in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship.FeeAmount"]}," field, if it exists."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MaxFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Amount"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The maximum fee per transaction that will be sponsored. This prevents abuse or excessive draining of the sponsored fee pool."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReserveCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt32"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The remaining amount of reserves that the sponsor has provided for the sponsee to use. This value replaces what is currently in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship.ReserveCount"]}," field, if it exists."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsee associated with this relationship. If this field is included, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," is assumed to be the sponsor."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sponsorshipset-flags","__idx":3},"children":["SponsorshipSet"," Flags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"SponsorshipSet"},"children":[]}," transactions support additional values in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Flags"]}," field, as follows:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Flag Name"},"children":["Flag Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Hex Value"},"children":["Hex Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Decimal Value"},"children":["Decimal Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipSetRequireSignForFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x00010000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["65536"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Adds the restriction that every use of this sponsor for sponsoring fees requires a signature from the sponsor."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipClearRequireSignForFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x00020000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["131072"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Removes the restriction that every use of this sponsor for sponsoring fees requires a signature from the sponsor."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipSetRequireSignForReserve"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x00040000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["262144"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Adds the restriction that every use of this sponsor for sponsoring reserves requires a signature from the sponsor."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipClearRequireSignForReserve"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x00080000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["524288"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Removes the restriction that every use of this sponsor for sponsoring reserves requires a signature from the sponsor."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfDeleteObject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x00100000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["1048576"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Deletes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship"]}," ledger object. When enabled, no other fields or flag-setting fields may be specified. Deleting returns any remaining XRP in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]}," to the sponsor's account."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deleting-a-sponsorship-object","__idx":4},"children":["Deleting a Sponsorship Object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To delete a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship"]}," object, the sponsor or sponsee submits a ",{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"SponsorshipSet"},"children":[]}," transaction with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfDeleteObject"]}," flag enabled. Any remaining XRP in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]}," is returned to the sponsor's account upon deletion."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deleting the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship"]}," object only removes the pre-funded fee and reserve arrangement between the sponsor and sponsee. Ledger entries that were previously created using sponsored reserves retain their ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}," field and remain sponsored. To transfer or dissolve sponsorship for those existing ledger entries, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/xls-68-sponsored-fees-and-reserves/references/transactions/sponsorshiptransfer"},"children":["SponsorshipTransfer transaction"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-cases","__idx":5},"children":["Error Cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Besides errors that can occur for all transactions, ",{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"SponsorshipSet"},"children":[]}," transactions can result in the following ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/transactions/transaction-results"},"children":["transaction result codes"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecNO_DST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor or sponsee account does not exist on the ledger."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecNO_ENTRY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfDeleteObject"]}," flag is enabled but the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship"]}," object does not exist."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecUNFUNDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor does not have sufficient XRP to fund the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]}," or to cover the reserve for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsorship"]}," object."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temBAD_AMOUNT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An amount field is invalid. This can occur when:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]}," is negative or not denominated in XRP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MaxFee"]}," is negative or not denominated in XRP."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temINVALID_FLAG"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The transaction has invalid flags. This can occur when:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conflicting flags are enabled, such as both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipSetRequireSignForFee"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfSponsorshipClearRequireSignForFee"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfDeleteObject"]}," flag is enabled with flags that modify the object's settings."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temMALFORMED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The transaction is malformed. This can occur when:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," is not equal to either the sponsor or sponsee."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CounterpartySponsor"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsee"]}," are specified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Neither ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CounterpartySponsor"]}," nor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsee"]}," is specified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The sponsee attempts to create or update the object. Only the sponsor can create or update."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfDeleteObject"]}," flag is enabled and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FeeAmount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MaxFee"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReserveCount"]}," is specified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The sponsor and sponsee are the same account."]}]}]}]}]}]}]}]},"headings":[{"value":"SponsorshipSet","id":"sponsorshipset","depth":1},{"value":"Example JSON","id":"example-json","depth":2},{"value":"SponsorshipSet Fields","id":"sponsorshipset-fields","depth":2},{"value":"SponsorshipSet Flags","id":"sponsorshipset-flags","depth":2},{"value":"Deleting a Sponsorship Object","id":"deleting-a-sponsorship-object","depth":2},{"value":"Error Cases","id":"error-cases","depth":2}],"frontmatter":{"seo":{"description":"Create, update, or delete a Sponsorship ledger entry on the XRP Ledger.","title":"SponsorshipSet"},"labels":["Fees","Accounts","Sponsorship"],"status":"not_enabled"},"editPage":{"to":"https://github.com/ripple/opensource.ripple.com/tree/main/docs/xls-68-sponsored-fees-and-reserves/references/transactions/sponsorshipset.md"},"lastModified":"2026-04-10T16:11:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/xls-68-sponsored-fees-and-reserves/references/transactions/sponsorshipset","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}