{"templateId":"markdown","versions":[{"version":"v1.37","label":"v1.37 STS","link":"/products/custody/accounts-and-assets/gas-station/overview","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.36","label":"v1.36 STS","link":"/products/custody/v1.36/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.15/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":["A dedicated bot user signs automated funding transactions."]}]}]},{"$$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, bot-user 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| AccountSponsor{\"Account-level sponsor?\"}\n AccountSponsor -->|Yes| Fund[\"Sponsor funds account\"]\n AccountSponsor -->|No| DomainSponsor{\"Domain-level sponsor?\"}\n DomainSponsor -->|Yes| Fund\n DomainSponsor -->|No| ParentSponsor{\"Inherited sponsor from parent domain?\"}\n ParentSponsor -->|Yes| Fund\n ParentSponsor -->|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

Account-level sponsor?

Sponsor funds account

Domain-level sponsor?

Inherited sponsor from parent domain?

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

Account-level sponsor?

Sponsor funds account

Domain-level sponsor?

Inherited sponsor from parent domain?

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| AccountSponsor{\"Account-level sponsor?\"}\n AccountSponsor -->|Yes| Fund[\"Sponsor funds account\"]\n AccountSponsor -->|No| DomainSponsor{\"Domain-level sponsor?\"}\n DomainSponsor -->|Yes| Fund\n DomainSponsor -->|No| ParentSponsor{\"Inherited sponsor from parent domain?\"}\n ParentSponsor -->|Yes| Fund\n ParentSponsor -->|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":["Account-level sponsorship takes precedence over domain-level sponsorship. When domain-level sponsorship uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeSubDomains"]},", the sponsorship can apply to child domains."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bot-user-and-policies","__idx":3},"children":["Bot user and policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gas Station uses a dedicated ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/users/manage-users-and-roles#configure-a-bot-user-with-the-api"},"children":["bot user"]}," to sign and submit funding transactions. Configure this bot user with narrowly scoped permissions and policies for automated fee-funding transactions."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Bot-user scope"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the bot user's funding transactions require manual approvals, those approvals may delay or block automatic sponsorship. Keep the bot user's authority limited to the funding operations Gas Station needs."]}]},{"$$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/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":["Bot-user 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":["Configure sponsorship"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/gas-station/configure-sponsorship"},"children":["Configure gas sponsorship"]}]}]},{"$$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/deployment/reference/gas-station"},"children":["Gas Station reference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bot users"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/users/manage-users-and-roles#configure-a-bot-user-with-the-api"},"children":["Configure bot users"]}]}]},{"$$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/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":"Bot user and policies","id":"bot-user-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-07-10T17:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/accounts-and-assets/gas-station/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}