{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/accounts-and-assets/gas-station/overview","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/accounts-and-assets/gas-station/overview","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/gas-station/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/gas-station/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/gas-station/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/gas-station/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/gas-station/overview","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.19/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Gas Station","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"gas-station","__idx":0},"children":["Gas Station"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Executive summary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gas Station funds transaction fees for sponsored accounts on supported Solana, XRPL, and EVM-compatible ledgers."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sponsor accounts provide native tokens for accounts that need gas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure sponsorship for specific accounts or for a domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeSubDomains"]}," to include subdomains in domain sponsorship."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gas Station uses just-in-time funding instead of pre-funding every sponsored account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gas Station submits automated funding transactions as system-signed intents. You must activate system-signed intents and create a Gas Station policy before sponsorship works."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Why this matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gas Station reduces operational friction for users and integrations that hold non-native tokens but do not hold the native token required for transaction fees. Operators can fund one or more sponsor accounts and define which accounts or domains receive fee funding."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For architects, Gas Station affects account design, system-signed policy governance, sponsor funding, and monitoring. Scope sponsorship deliberately so accounts get automated funding where they need it without granting broader transaction authority than the service requires."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Current scope"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gas Station currently supports fee funding for non-native asset transactions on selected Solana, XRPL, and EVM-compatible ledgers. A sponsor account can only fund accounts on the same blockchain network. Sponsorship does not remove the need to fund and monitor sponsor accounts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-gas-station-works","__idx":1},"children":["How Gas Station works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a sponsored account needs native gas for a supported transaction, Gas Station:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detects that the account needs fee funding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Checks whether Gas Station sponsors the account directly or through its domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Estimates the required native-token amount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submits a funding transaction from the sponsor account to the sponsored account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Records the sponsorship activity for audit and monitoring."]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n Tx[\"Transaction needs gas\"] --> HasFunds{\"Account already has enough native token?\"}\n HasFunds -->|Yes| Done[\"No sponsorship needed\"]\n HasFunds -->|No| DomainSponsor{\"Domain-level sponsor?\"}\n DomainSponsor -->|Yes| Fund[\"Sponsor funds account\"]\n DomainSponsor -->|No| ParentSponsor{\"Inherited sponsor from parent domain?\"}\n ParentSponsor -->|Yes| Fund\n ParentSponsor -->|No| AccountSponsor{\"Account-level sponsor?\"}\n AccountSponsor -->|Yes| Fund\n AccountSponsor -->|No| Waiting[\"Transaction waits for manual funding\"]\n Fund --> Continue[\"Original transaction can continue\"]\n","diagramHtml":"

Yes

No

Yes

No

Yes

No

Yes

No

Transaction needs gas

Account already has enough native token?

No sponsorship needed

Domain-level sponsor?

Sponsor funds account

Inherited sponsor from parent domain?

Account-level sponsor?

Transaction waits for manual funding

Original transaction can continue

","diagramHtmlDark":"

Yes

No

Yes

No

Yes

No

Yes

No

Transaction needs gas

Account already has enough native token?

No sponsorship needed

Domain-level sponsor?

Sponsor funds account

Inherited sponsor from parent domain?

Account-level sponsor?

Transaction waits for manual funding

Original transaction can continue

"},"children":["flowchart TD\n Tx[\"Transaction needs gas\"] --> HasFunds{\"Account already has enough native token?\"}\n HasFunds -->|Yes| Done[\"No sponsorship needed\"]\n HasFunds -->|No| DomainSponsor{\"Domain-level sponsor?\"}\n DomainSponsor -->|Yes| Fund[\"Sponsor funds account\"]\n DomainSponsor -->|No| ParentSponsor{\"Inherited sponsor from parent domain?\"}\n ParentSponsor -->|Yes| Fund\n ParentSponsor -->|No| AccountSponsor{\"Account-level sponsor?\"}\n AccountSponsor -->|Yes| Fund\n AccountSponsor -->|No| Waiting[\"Transaction waits for manual funding\"]\n Fund --> Continue[\"Original transaction can continue\"]\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sponsorship-model","__idx":2},"children":["Sponsorship model"]},{"$$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":{"data-label":"Sponsorship type"},"children":["Sponsorship type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A sponsor account funds specific account IDs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A sponsor account funds accounts in a domain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disables sponsorship for the sponsor configuration."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform resolves a sponsor in a fixed order: first a domain-level sponsor for the account's domain, then a sponsor inherited from a parent domain (when domain-level sponsorship uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeSubDomains"]},"), then account-level sponsorship."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"system-signed-intents-and-policies","__idx":3},"children":["System-signed intents and policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gas Station submits funding transactions as system-signed intents, in the same way as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/accounts-and-assets/omnibus/setup-and-governance#system-signed-automation"},"children":["Omnibus automation"]},". The Gas Station service authenticates as a service caller registered in your identity provider (Keycloak), and does not hold a user signing key."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Migration from bot users"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Earlier releases used a dedicated bot user to sign Gas Station funding transactions. From this release, funding uses system-signed intents instead. Existing deployments must set up the service-caller identity in Keycloak and create a Gas Station system-signed policy, or automated funding stops working."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Funding works only after system-signed intents are activated for the deployment, the Gas Station service caller is registered in your identity provider, and a policy with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intentOrigin: \"SystemSigned\""]}," admits the service's funding intents (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]}," only). For the activation sequence, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/deployment/reference/system-signed-intents"},"children":["System-signed intent configuration"]},"; for the policy example, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/governance/policies/examples#system-signed-gas-station-proposal"},"children":["System-signed Gas Station proposal"]},"; for deploying the service, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/deployment/reference/gas-station"},"children":["Gas Station reference"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Policy scope"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If Gas Station's funding intents match a policy that requires manual approvals, those approvals may delay or block automatic sponsorship. Keep the Gas Station policy narrowly scoped so funding executes without manual intervention."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"omnibus-usage","__idx":4},"children":["Omnibus usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/accounts-and-assets/omnibus/overview"},"children":["Omnibus"]}," can use Gas Station for non-native token sweeps from deposit wallets to the omnibus wallet on supported Solana, XRPL, and EVM networks."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Gas Station funds an Omnibus deposit wallet, Omnibus must ignore the Gas Station account as a deposit source. This prevents Omnibus from processing native-token funding transactions as customer deposits."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"monitoring","__idx":5},"children":["Monitoring"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gas Station sponsorship depends on sponsor-account balances and healthy background processing. Monitor:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sponsor account balances and configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alertLimit"]}," thresholds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Funding failures and retry queues."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gas Station system-signed intent activity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gas Station health and readiness endpoints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Telemetry exported through your configured OpenTelemetry pipeline."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":6},"children":["Related topics"]},{"$$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":{"data-label":"Topic"},"children":["Topic"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Documentation"},"children":["Documentation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UI procedures"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/accounts-and-assets/gas-station/manage-gas-station-ui"},"children":["Manage a gas station in the UI"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API procedures"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/accounts-and-assets/gas-station/manage-gas-station-api"},"children":["Manage a gas station with the API"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deployment reference"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/deployment/reference/gas-station"},"children":["Gas Station reference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["System-signed intents"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/deployment/reference/system-signed-intents"},"children":["System-signed intent configuration"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Omnibus"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.39/accounts-and-assets/omnibus/overview"},"children":["Omnibus"]}]}]}]}]}]}]},"headings":[{"value":"Gas Station","id":"gas-station","depth":1},{"value":"How Gas Station works","id":"how-gas-station-works","depth":2},{"value":"Sponsorship model","id":"sponsorship-model","depth":2},{"value":"System-signed intents and policies","id":"system-signed-intents-and-policies","depth":2},{"value":"Omnibus usage","id":"omnibus-usage","depth":2},{"value":"Monitoring","id":"monitoring","depth":2},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Gas Station"}},"lastModified":"2026-08-04T20:25:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.39/accounts-and-assets/gas-station/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}