{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/concepts/gas-station","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/concepts/gas-station","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/concepts/gas-station","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/concepts/gas-station","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/concepts/gas-station","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/concepts/gas-station","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/concepts/gas-station","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":["The Gas Station Service automatically funds transaction fees for sponsored accounts."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Eliminates the need for end-user accounts to hold native tokens for gas fees."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supports account-level and domain-level sponsorship with subdomain inheritance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Works with Ethereum and EVM-compatible blockchains."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses Just-in-Time (JIT) funding to transfer exact fee amounts when needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provides low-balance alerts to ensure sponsor accounts remain funded."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Why this matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For operators"]},": Gas Station removes friction from end-user transactions. Users don't need to acquire native tokens (e.g., ETH) just to pay fees—your organization sponsors those costs from designated accounts. This is essential for onboarding users who hold only stablecoins or other tokens."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For architects"]},": The service integrates with existing ","Ripple Custody"," policies and intents. A dedicated bot user handles automated approvals, so you maintain full audit trails while eliminating manual fee-funding steps."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Current limitations"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chain support"]},": Ethereum and EVM-compatible chains only. Support for additional chains (Solana, XRPL) will be added in the future."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Alert delivery"]},": Low-balance alerts are delivered through your monitoring infrastructure. Configure alerts in your monitoring system (e.g., Grafana) to receive email or Slack notifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cross-chain sponsorship"]},": A sponsor account can only fund accounts on the same blockchain network."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Implementation approach"]},": The current Gas Station implementation uses a mechanical funding approach: the service detects pending transactions and transfers gas fees from sponsor accounts to sponsored accounts as standard blockchain transactions. This release does not leverage native gas abstraction mechanisms such as ERC-4337 Paymasters. Support for native paymaster integration (including EIP-7701 Native Account Abstraction) will be added in the future."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Before you begin"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Prerequisites"]},": Familiarity with ","Ripple Custody"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/accounts"},"children":["accounts"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/governance/domains"},"children":["domains"]},", and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/concepts/transactions-processing"},"children":["transaction processing"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Further reading"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/deployment/reference/gas-station"},"children":["Gas Station reference"]}," — On-premise deployment configuration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/environment/user/bot-user"},"children":["Configure bot users"]}," — Set up bot users for automated operations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/accounting/gas-station/configure-sponsorship"},"children":["Configure gas sponsorship"]}," — API guide with step-by-step instructions"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service is a background service that monitors transaction events and automatically funds accounts that lack sufficient native tokens to cover gas fees. When a sponsored account initiates a transaction, the service:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detects the pending transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Estimates the required fee using a dry-run API call"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transfers the exact amount (plus a safety margin) from the sponsor account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allows the original transaction to proceed"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"processing-flow","__idx":2},"children":["Processing flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service continuously monitors ","Ripple Custody"," for transaction events and automatically funds accounts that need gas. The following state diagram shows the decision logic at each step:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"stateDiagram-v2\n [*] --> PollEvents\n\n state \"Poll Events\" as PollEvents\n state \"Outbound Transaction Detected\" as OutboundTx\n state \"Is Account Sponsored?\" as AcctSponsored\n state \"Is Domain Sponsored?\" as DomainSponsored\n state \"Estimate Fee via Dry-Run API\" as EstimateFee\n state \"Create Funding Transaction Intent\" as CreateIntent\n state \"Does Sponsor Have Sufficient Balance?\" as SponsorBal\n state \"Funding Successful\" as FundingSuccess\n state \"Does Sponsor Still Have Sufficient Balance?\" as SponsorStillBal\n state \"Account Has Sufficient Funds for Fees\" as AcctHasFunds\n state \"Send Low Balance Alert\" as SendAlert\n state \"Do nothing\" as DoNothing\n\n PollEvents --> OutboundTx : Event detected\n\n state check_funds <>\n OutboundTx --> check_funds\n check_funds --> AcctHasFunds : Has sufficient funds\n check_funds --> AcctSponsored : Insufficient funds\n\n state is_acct_sponsored <>\n AcctSponsored --> is_acct_sponsored\n is_acct_sponsored --> EstimateFee : Yes (account sponsored)\n is_acct_sponsored --> DomainSponsored : No\n\n state is_domain_sponsored <>\n DomainSponsored --> is_domain_sponsored\n is_domain_sponsored --> EstimateFee : Yes (domain sponsored)\n is_domain_sponsored --> DoNothing : No sponsor found\n\n EstimateFee --> CreateIntent\n CreateIntent --> SponsorBal\n\n state has_sufficient_balance <>\n SponsorBal --> has_sufficient_balance\n has_sufficient_balance --> FundingSuccess : Yes (sufficient balance)\n has_sufficient_balance --> SendAlert : No (low balance)\n\n FundingSuccess --> SponsorStillBal\n\n state still_has_balance <>\n SponsorStillBal --> still_has_balance\n still_has_balance --> [*] : Yes\n still_has_balance --> SendAlert : No\n\n AcctHasFunds --> [*] : No sponsorship needed\n SendAlert --> [*]\n DoNothing --> [*]\n","diagramHtml":"

Event detected

Has sufficient funds

Insufficient funds

Yes (account sponsored)

No

Yes (domain sponsored)

No sponsor found

Yes (sufficient balance)

No (low balance)

Yes

No

No sponsorship needed

Poll Events

Outbound Transaction Detected

Is Account Sponsored?

Is Domain Sponsored?

Estimate Fee via Dry-Run API

Create Funding Transaction Intent

Does Sponsor Have Sufficient Balance?

Funding Successful

Does Sponsor Still Have Sufficient Balance?

Account Has Sufficient Funds for Fees

Send Low Balance Alert

Do nothing

","diagramHtmlDark":"

Event detected

Has sufficient funds

Insufficient funds

Yes (account sponsored)

No

Yes (domain sponsored)

No sponsor found

Yes (sufficient balance)

No (low balance)

Yes

No

No sponsorship needed

Poll Events

Outbound Transaction Detected

Is Account Sponsored?

Is Domain Sponsored?

Estimate Fee via Dry-Run API

Create Funding Transaction Intent

Does Sponsor Have Sufficient Balance?

Funding Successful

Does Sponsor Still Have Sufficient Balance?

Account Has Sufficient Funds for Fees

Send Low Balance Alert

Do nothing

"},"children":["stateDiagram-v2\n [*] --> PollEvents\n\n state \"Poll Events\" as PollEvents\n state \"Outbound Transaction Detected\" as OutboundTx\n state \"Is Account Sponsored?\" as AcctSponsored\n state \"Is Domain Sponsored?\" as DomainSponsored\n state \"Estimate Fee via Dry-Run API\" as EstimateFee\n state \"Create Funding Transaction Intent\" as CreateIntent\n state \"Does Sponsor Have Sufficient Balance?\" as SponsorBal\n state \"Funding Successful\" as FundingSuccess\n state \"Does Sponsor Still Have Sufficient Balance?\" as SponsorStillBal\n state \"Account Has Sufficient Funds for Fees\" as AcctHasFunds\n state \"Send Low Balance Alert\" as SendAlert\n state \"Do nothing\" as DoNothing\n\n PollEvents --> OutboundTx : Event detected\n\n state check_funds <>\n OutboundTx --> check_funds\n check_funds --> AcctHasFunds : Has sufficient funds\n check_funds --> AcctSponsored : Insufficient funds\n\n state is_acct_sponsored <>\n AcctSponsored --> is_acct_sponsored\n is_acct_sponsored --> EstimateFee : Yes (account sponsored)\n is_acct_sponsored --> DomainSponsored : No\n\n state is_domain_sponsored <>\n DomainSponsored --> is_domain_sponsored\n is_domain_sponsored --> EstimateFee : Yes (domain sponsored)\n is_domain_sponsored --> DoNothing : No sponsor found\n\n EstimateFee --> CreateIntent\n CreateIntent --> SponsorBal\n\n state has_sufficient_balance <>\n SponsorBal --> has_sufficient_balance\n has_sufficient_balance --> FundingSuccess : Yes (sufficient balance)\n has_sufficient_balance --> SendAlert : No (low balance)\n\n FundingSuccess --> SponsorStillBal\n\n state still_has_balance <>\n SponsorStillBal --> still_has_balance\n still_has_balance --> [*] : Yes\n still_has_balance --> SendAlert : No\n\n AcctHasFunds --> [*] : No sponsorship needed\n SendAlert --> [*]\n DoNothing --> [*]\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flow-steps","__idx":3},"children":["Flow steps"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1-poll-events","__idx":4},"children":["1. Poll Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service continuously polls ","Ripple Custody"," for transaction events using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/domains/{domainId}/events"]}," endpoint. The polling interval is configurable (default: 5 seconds)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"2-detect-transaction","__idx":5},"children":["2. Detect Transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an event is received, the service identifies outbound transactions by checking the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderReference"]}," field. Inbound transactions (where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderReference"]}," is null) are ignored."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"3-check-balance","__idx":6},"children":["3. Check Balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service retrieves the account's native token balance using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/domains/{domainId}/accounts/{accountId}/balances"]},". If the account already has sufficient funds for the estimated fee, no sponsorship is needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"4-check-sponsorship","__idx":7},"children":["4. Check Sponsorship"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For accounts with insufficient balance, the service looks up sponsorship configuration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account-level first"]},": Check if the specific account has a dedicated sponsor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain-level second"]},": Check if the account's domain has a sponsor (with optional subdomain inheritance)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no sponsor is found, the transaction remains in \"Preparing\" state until funds are manually added."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"5-estimate-fee","__idx":8},"children":["5. Estimate Fee"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service uses ","Ripple Custody","'s dry-run API to calculate the exact gas amount required for the transaction. A configurable safety margin (default: 10%) is applied to account for fee volatility."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"6-create-funding-intent","__idx":9},"children":["6. Create Funding Intent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service generates a transaction order payload to transfer the required gas amount from the sponsor account to the sponsored account. This payload is signed by the bot user's private key."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"7-check-sponsor-balance","__idx":10},"children":["7. Check Sponsor Balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before submitting, the service verifies the sponsor account has sufficient funds via a dry-run check. If the sponsor lacks funds, the funding transaction is not submitted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"8-alert-if-low","__idx":11},"children":["8. Alert if Low"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After successful funding (or if funding fails due to low balance), the service checks the sponsor's remaining balance against configured alert thresholds. If the balance falls below the threshold, a notification is sent to the monitoring system."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"detailed-sequence","__idx":12},"children":["Detailed sequence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram shows the complete API interactions between the Gas Station Service and ","Ripple Custody",", including the specific endpoints called at each step:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n actor User\n participant RCUS\n participant GasStation\n\n User->>RCUS: createTransactionOrderIntent()\n Note over RCUS: Transaction will stay in preparing if not enough fees\n\n GasStation->>RCUS: pollTransactionCreatedEvents(): { transactionId }\n Note right of GasStation: /v1/domains/{domainId}/events\n\n GasStation->>RCUS: getTransactionDetails(transactionId): { orderReference.id }\n Note right of GasStation: /v1/domains/{domainId}/transactions/{transactionId}\n\n alt orderReference is null\n Note right of GasStation: Inbound transaction, ignore it\n else orderReference is not null\n GasStation->>RCUS: getTransactionOrderDetails(orderReference.id): { accountSourceId, ... }\n Note right of GasStation: /v1/domains/{domainId}/transactions/orders/{transactionOrderId}\n\n GasStation->>RCUS: getAccountNativeBalance(accountSourceId): accountNativeBalance\n Note right of GasStation: /v1/domains/{domainId}/accounts/{accountId}/balances\n\n GasStation->>RCUS: getIntentForTransactionOrder(orderReference.id, \"v0_CreateTransactionOrder\"): intent\n Note right of GasStation: /v1/domains/{domainId}/intents?entityId={transactionOrderId}&details.payload.type=\"v0_CreateTransactionOrder\"\n\n GasStation->>RCUS: runDryRunForIntent(intent.id): { estimate.fee }\n Note right of GasStation: Get estimated transaction fee\n\n alt accountNativeBalance >= estimate.fee\n Note right of GasStation: Account has sufficient balance
No sponsorship needed\n else accountNativeBalance < estimate.fee\n GasStation->>GasStation: findSponsoringAccount(accountSourceId): sponsorAccountId\n\n alt sponsorAccountId is null\n Note right of GasStation: No sponsor found
Transaction remains in preparing state\n else sponsor found\n GasStation->>GasStation: createTransactionOrderPayload(sponsorAccountId, accountSourceId, estimate.fee)\n\n GasStation->>RCUS: runDryRun(payload): dryRunResult\n\n alt dryRunResult is success (Enough funds in sponsor)\n GasStation->>GasStation: signIntent(payload)\n GasStation->>RCUS: submitIntent(signedPayload)\n Note right of GasStation: Fund the sponsored account with gas\n\n GasStation->>RCUS: getSponsorBalance(sponsorAccountId): sponsorBalance\n\n alt sponsorBalance < configuredAlertLimit\n GasStation->>RCUS: sendNotification(\"Sponsor low balance\")\n Note right of GasStation: Alert user to refill sponsor account\n end\n end\n end\n end\n end\n","diagramHtml":"GasStationRCUSGasStationRCUSTransaction will stay in preparing if not enough fees/v1/domains/{domainId}/events/v1/domains/{domainId}/transactions/{transactionId}Inbound transaction, ignore it/v1/domains/{domainId}/transactions/orders/{transactionOrderId}/v1/domains/{domainId}/accounts/{accountId}/balances/v1/domains/{domainId}/intents?entityId={transactionOrderId}&details.payload.type=\"v0_CreateTransactionOrder\"Get estimated transaction feeAccount has sufficient balanceNo sponsorship neededNo sponsor foundTransaction remains in preparing stateFund the sponsored account with gasAlert user to refill sponsor accountalt[sponsorBalance < configuredAlertLimit]alt[dryRunResult is success (Enough funds in sponsor)]alt[sponsorAccountId is null][sponsor found]alt[accountNativeBalance >= estimate.fee][accountNativeBalance < estimate.fee]alt[orderReference is null][orderReference is not null]UsercreateTransactionOrderIntent()pollTransactionCreatedEvents(): { transactionId }getTransactionDetails(transactionId): { orderReference.id }getTransactionOrderDetails(orderReference.id): { accountSourceId, ... }getAccountNativeBalance(accountSourceId): accountNativeBalancegetIntentForTransactionOrder(orderReference.id, \"v0_CreateTransactionOrder\"): intentrunDryRunForIntent(intent.id): { estimate.fee }findSponsoringAccount(accountSourceId): sponsorAccountIdcreateTransactionOrderPayload(sponsorAccountId, accountSourceId, estimate.fee)runDryRun(payload): dryRunResultsignIntent(payload)submitIntent(signedPayload)getSponsorBalance(sponsorAccountId): sponsorBalancesendNotification(\"Sponsor low balance\")User","diagramHtmlDark":"GasStationRCUSGasStationRCUSTransaction will stay in preparing if not enough fees/v1/domains/{domainId}/events/v1/domains/{domainId}/transactions/{transactionId}Inbound transaction, ignore it/v1/domains/{domainId}/transactions/orders/{transactionOrderId}/v1/domains/{domainId}/accounts/{accountId}/balances/v1/domains/{domainId}/intents?entityId={transactionOrderId}&details.payload.type=\"v0_CreateTransactionOrder\"Get estimated transaction feeAccount has sufficient balanceNo sponsorship neededNo sponsor foundTransaction remains in preparing stateFund the sponsored account with gasAlert user to refill sponsor accountalt[sponsorBalance < configuredAlertLimit]alt[dryRunResult is success (Enough funds in sponsor)]alt[sponsorAccountId is null][sponsor found]alt[accountNativeBalance >= estimate.fee][accountNativeBalance < estimate.fee]alt[orderReference is null][orderReference is not null]UsercreateTransactionOrderIntent()pollTransactionCreatedEvents(): { transactionId }getTransactionDetails(transactionId): { orderReference.id }getTransactionOrderDetails(orderReference.id): { accountSourceId, ... }getAccountNativeBalance(accountSourceId): accountNativeBalancegetIntentForTransactionOrder(orderReference.id, \"v0_CreateTransactionOrder\"): intentrunDryRunForIntent(intent.id): { estimate.fee }findSponsoringAccount(accountSourceId): sponsorAccountIdcreateTransactionOrderPayload(sponsorAccountId, accountSourceId, estimate.fee)runDryRun(payload): dryRunResultsignIntent(payload)submitIntent(signedPayload)getSponsorBalance(sponsorAccountId): sponsorBalancesendNotification(\"Sponsor low balance\")User"},"children":["sequenceDiagram\n actor User\n participant RCUS\n participant GasStation\n\n User->>RCUS: createTransactionOrderIntent()\n Note over RCUS: Transaction will stay in preparing if not enough fees\n\n GasStation->>RCUS: pollTransactionCreatedEvents(): { transactionId }\n Note right of GasStation: /v1/domains/{domainId}/events\n\n GasStation->>RCUS: getTransactionDetails(transactionId): { orderReference.id }\n Note right of GasStation: /v1/domains/{domainId}/transactions/{transactionId}\n\n alt orderReference is null\n Note right of GasStation: Inbound transaction, ignore it\n else orderReference is not null\n GasStation->>RCUS: getTransactionOrderDetails(orderReference.id): { accountSourceId, ... }\n Note right of GasStation: /v1/domains/{domainId}/transactions/orders/{transactionOrderId}\n\n GasStation->>RCUS: getAccountNativeBalance(accountSourceId): accountNativeBalance\n Note right of GasStation: /v1/domains/{domainId}/accounts/{accountId}/balances\n\n GasStation->>RCUS: getIntentForTransactionOrder(orderReference.id, \"v0_CreateTransactionOrder\"): intent\n Note right of GasStation: /v1/domains/{domainId}/intents?entityId={transactionOrderId}&details.payload.type=\"v0_CreateTransactionOrder\"\n\n GasStation->>RCUS: runDryRunForIntent(intent.id): { estimate.fee }\n Note right of GasStation: Get estimated transaction fee\n\n alt accountNativeBalance >= estimate.fee\n Note right of GasStation: Account has sufficient balance
No sponsorship needed\n else accountNativeBalance < estimate.fee\n GasStation->>GasStation: findSponsoringAccount(accountSourceId): sponsorAccountId\n\n alt sponsorAccountId is null\n Note right of GasStation: No sponsor found
Transaction remains in preparing state\n else sponsor found\n GasStation->>GasStation: createTransactionOrderPayload(sponsorAccountId, accountSourceId, estimate.fee)\n\n GasStation->>RCUS: runDryRun(payload): dryRunResult\n\n alt dryRunResult is success (Enough funds in sponsor)\n GasStation->>GasStation: signIntent(payload)\n GasStation->>RCUS: submitIntent(signedPayload)\n Note right of GasStation: Fund the sponsored account with gas\n\n GasStation->>RCUS: getSponsorBalance(sponsorAccountId): sponsorBalance\n\n alt sponsorBalance < configuredAlertLimit\n GasStation->>RCUS: sendNotification(\"Sponsor low balance\")\n Note right of GasStation: Alert user to refill sponsor account\n end\n end\n end\n end\n end\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sponsorship-hierarchy","__idx":13},"children":["Sponsorship hierarchy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service supports flexible sponsorship configurations:"]},{"$$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":"Level"},"children":["Level"]},{"$$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":"strong","attributes":{},"children":["Account-level"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A sponsor account funds a specific list of accounts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain-level"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A sponsor account funds all accounts within a domain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subdomain inheritance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeSubDomains"]}," is enabled, sponsorship extends to all child domains"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lookup-algorithm","__idx":14},"children":["Lookup algorithm"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When determining which sponsor to use, the service follows this hierarchy:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct account sponsor"]},": Check if the account has a dedicated sponsor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain sponsor"]},": Check if the account's domain has a sponsor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parent domain sponsor"]},": If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeSubDomains"]}," is enabled, walk up the domain hierarchy"]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n A[Transaction detected] --> B{Account has direct sponsor?}\n B -->|Yes| C[Use account sponsor]\n B -->|No| D{Domain has sponsor?}\n D -->|Yes| E[Use domain sponsor]\n D -->|No| F{Parent domain with includeSubDomains?}\n F -->|Yes| G[Use parent domain sponsor]\n F -->|No| H[No sponsorship - transaction waits]\n","diagramHtml":"

Yes

No

Yes

No

Yes

No

Transaction detected

Account has direct sponsor?

Use account sponsor

Domain has sponsor?

Use domain sponsor

Parent domain with includeSubDomains?

Use parent domain sponsor

No sponsorship - transaction waits

","diagramHtmlDark":"

Yes

No

Yes

No

Yes

No

Transaction detected

Account has direct sponsor?

Use account sponsor

Domain has sponsor?

Use domain sponsor

Parent domain with includeSubDomains?

Use parent domain sponsor

No sponsorship - transaction waits

"},"children":["flowchart TD\n A[Transaction detected] --> B{Account has direct sponsor?}\n B -->|Yes| C[Use account sponsor]\n B -->|No| D{Domain has sponsor?}\n D -->|Yes| E[Use domain sponsor]\n D -->|No| F{Parent domain with includeSubDomains?}\n F -->|Yes| G[Use parent domain sponsor]\n F -->|No| H[No sponsorship - transaction waits]\n"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each account can have only one sponsor. If you configure both account-level and domain-level sponsorship, the account-level sponsor takes precedence."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-chains","__idx":15},"children":["Supported chains"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service currently supports Ethereum and EVM-compatible blockchains:"]},{"$$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":"Chain type"},"children":["Chain type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Networks"},"children":["Networks"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Fee token"},"children":["Fee token"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EVM-compatible"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum, Polygon, Avalanche, BSC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ETH, MATIC, AVAX, BNB"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Support for additional chains (Solana, XRPL) will be added in the future."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service uses ","Ripple Custody","'s dry-run API to estimate fees. All chain-specific fee calculations are handled automatically."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bot-user-and-automation","__idx":16},"children":["Bot user and automation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service uses a dedicated ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["bot user"]}," to sign and submit funding transactions automatically:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No manual approval required"]},": Once you configure the bot user with auto-approval policies, gas funding transactions are approved automatically without human intervention"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full audit trail"]},": All bot user actions are logged in the ","Ripple Custody"," intent system"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure key storage"]},": The bot user's private key is stored in a secure vault (Kubernetes Secret or HashiCorp Vault)"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your organization adds additional approval requirements to the bot user's transactions, automatic sponsorship will be blocked. Funding transactions will require manual approval, defeating the purpose of the Gas Station."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"low-balance-alerts","__idx":17},"children":["Low-balance alerts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure alert thresholds to receive notifications when sponsor account balances fall below specified levels."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"alert-configuration","__idx":18},"children":["Alert configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you configure a sponsor, you can set alert thresholds for each native token the sponsor holds:"]},{"$$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":"Field"},"children":["Field"]},{"$$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":"strong","attributes":{},"children":["tickerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The UUID of the native token to monitor (e.g., ETH, MATIC, AVAX)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The balance threshold—alerts trigger when the balance falls to or below this amount"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can configure multiple alert thresholds per sponsor, one for each token type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-alerts-work","__idx":19},"children":["How alerts work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service checks the sponsor account balance after each funding transaction:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After successfully funding a sponsored account, the service retrieves the sponsor's current balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For each configured alert threshold, it compares the current balance to the threshold amount"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the balance is at or below the threshold, the service emits an alert event"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"alert-delivery","__idx":20},"children":["Alert delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alerts are delivered through your monitoring infrastructure:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grafana integration"]},": All alerts are sent to Grafana as log events and metrics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure notifications"]},": Set up Grafana alerting rules to receive notifications via email, Slack, PagerDuty, or other channels"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monitor the metric"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gas_station_sponsor_low_balance"]}," indicates when a sponsor balance is below threshold"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure Grafana alerts to notify your operations team before sponsor accounts run out of funds. This ensures uninterrupted sponsorship for your users."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fee-estimation-and-safety-margin","__idx":21},"children":["Fee estimation and safety margin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service estimates transaction fees using the ","Ripple Custody"," dry-run API:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the original transaction intent"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Execute a dry-run to simulate the transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply a configurable safety margin (default: 10%)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transfer the total amount to the sponsored account"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The safety margin accounts for fee volatility between estimation and actual transaction broadcast."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retry-and-fault-tolerance","__idx":22},"children":["Retry and fault tolerance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service implements a two-tier retry mechanism to handle transient failures:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tier-1-immediate-retries","__idx":23},"children":["Tier 1: Immediate retries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For transient failures during event processing, the service performs immediate in-memory retries:"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Max attempts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3 retries per operation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backoff strategy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exponential [1s, 2s, 4s]"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timeout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10 seconds per attempt"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Total time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["~17 seconds worst case"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tier-2-queue-based-retries","__idx":24},"children":["Tier 2: Queue-based retries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When immediate retries are exhausted, jobs are persisted to a database queue for background processing:"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry interval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fixed 5 minutes between cycles"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maximum age"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24 hours from job creation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maximum retry count"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 attempts"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jobs exceeding these limits are moved to a dead letter queue for manual investigation."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two-tier retry mechanism ensures that temporary failures (network issues, API timeouts) don't cause permanent funding failures while preventing infinite retry loops."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"performance","__idx":25},"children":["Performance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Gas Station Service is designed to meet strict performance requirements:"]},{"$$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":"Metric"},"children":["Metric"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Target"},"children":["Target"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["End-to-end funding time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["< 2 minutes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Polling interval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 seconds (configurable)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Happy path"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["~35 seconds (including blockchain confirmation)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Worst case with retries"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["~72 seconds (well within SLA)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sla-breakdown","__idx":26},"children":["SLA breakdown"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Event polling interval: 5 seconds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dry-run API call: 1-3 seconds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Funding transaction submission: 1-2 seconds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Blockchain confirmation: varies by chain (EVM: 12-15s)"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":27},"children":["Next steps"]},{"$$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":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/deployment/reference/gas-station"},"children":["Gas Station reference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configuration parameters and deployment options"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/environment/user/bot-user"},"children":["Configure bot users"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set up bot users for automated operations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.34/api/accounting/gas-station/configure-sponsorship"},"children":["Configure gas sponsorship"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set up sponsor accounts and configure sponsorship rules"]}]}]}]}]}]},"headings":[{"value":"Gas Station","id":"gas-station","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Processing flow","id":"processing-flow","depth":2},{"value":"Flow steps","id":"flow-steps","depth":3},{"value":"1. Poll Events","id":"1-poll-events","depth":4},{"value":"2. Detect Transaction","id":"2-detect-transaction","depth":4},{"value":"3. Check Balance","id":"3-check-balance","depth":4},{"value":"4. Check Sponsorship","id":"4-check-sponsorship","depth":4},{"value":"5. Estimate Fee","id":"5-estimate-fee","depth":4},{"value":"6. Create Funding Intent","id":"6-create-funding-intent","depth":4},{"value":"7. Check Sponsor Balance","id":"7-check-sponsor-balance","depth":4},{"value":"8. Alert if Low","id":"8-alert-if-low","depth":4},{"value":"Detailed sequence","id":"detailed-sequence","depth":2},{"value":"Sponsorship hierarchy","id":"sponsorship-hierarchy","depth":2},{"value":"Lookup algorithm","id":"lookup-algorithm","depth":3},{"value":"Supported chains","id":"supported-chains","depth":2},{"value":"Bot user and automation","id":"bot-user-and-automation","depth":2},{"value":"Low-balance alerts","id":"low-balance-alerts","depth":2},{"value":"Alert configuration","id":"alert-configuration","depth":3},{"value":"How alerts work","id":"how-alerts-work","depth":3},{"value":"Alert delivery","id":"alert-delivery","depth":3},{"value":"Fee estimation and safety margin","id":"fee-estimation-and-safety-margin","depth":2},{"value":"Retry and fault tolerance","id":"retry-and-fault-tolerance","depth":2},{"value":"Tier 1: Immediate retries","id":"tier-1-immediate-retries","depth":3},{"value":"Tier 2: Queue-based retries","id":"tier-2-queue-based-retries","depth":3},{"value":"Performance","id":"performance","depth":2},{"value":"SLA breakdown","id":"sla-breakdown","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Gas Station"}},"lastModified":"2026-04-07T19:14:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.34/concepts/gas-station","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}