# Gas Station

Executive summary
**Gas Station funds transaction fees for sponsored accounts on supported Solana, XRPL, and EVM-compatible ledgers.**

- Sponsor accounts provide native tokens for accounts that need gas.
- Configure sponsorship for specific accounts or for a domain.
- Set `includeSubDomains` to include subdomains in domain sponsorship.
- Gas Station uses just-in-time funding instead of pre-funding every sponsored account.
- A dedicated bot user signs automated funding transactions.


Why this matters
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.

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.

Current scope
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.

## How Gas Station works

When a sponsored account needs native gas for a supported transaction, Gas Station:

1. Detects that the account needs fee funding.
2. Checks whether Gas Station sponsors the account directly or through its domain.
3. Estimates the required native-token amount.
4. Submits a funding transaction from the sponsor account to the sponsored account.
5. Records the sponsorship activity for audit and monitoring.



```mermaid
flowchart TD
    Tx["Transaction needs gas"] --> HasFunds{"Account already has enough native token?"}
    HasFunds -->|Yes| Done["No sponsorship needed"]
    HasFunds -->|No| AccountSponsor{"Account-level sponsor?"}
    AccountSponsor -->|Yes| Fund["Sponsor funds account"]
    AccountSponsor -->|No| DomainSponsor{"Domain-level sponsor?"}
    DomainSponsor -->|Yes| Fund
    DomainSponsor -->|No| ParentSponsor{"Inherited sponsor from parent domain?"}
    ParentSponsor -->|Yes| Fund
    ParentSponsor -->|No| Waiting["Transaction waits for manual funding"]
    Fund --> Continue["Original transaction can continue"]
```

## Sponsorship model

| Sponsorship type | Description |
|  --- | --- |
| `account` | A sponsor account funds specific account IDs. |
| `domain` | A sponsor account funds accounts in a domain. |
| `none` | Disables sponsorship for the sponsor configuration. |


Account-level sponsorship takes precedence over domain-level sponsorship. When domain-level sponsorship uses `includeSubDomains`, the sponsorship can apply to child domains.

## Bot user and policies

Gas Station uses a dedicated [bot user](/products/custody/v1.36/governance/users/manage-users-and-roles#configure-a-bot-user-with-the-api) to sign and submit funding transactions. Configure this bot user with narrowly scoped permissions and policies for automated fee-funding transactions.

Bot-user scope
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.

## Omnibus usage

[Omnibus](/products/custody/v1.36/accounts-and-assets/omnibus/overview) can use Gas Station for non-native token sweeps from deposit wallets to the omnibus wallet on supported Solana, XRPL, and EVM networks.

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.

## Monitoring

Gas Station sponsorship depends on sponsor-account balances and healthy background processing. Monitor:

- Sponsor account balances and configured `alertLimit` thresholds.
- Funding failures and retry queues.
- Bot-user intent activity.
- Gas Station health and readiness endpoints.
- Telemetry exported through your configured OpenTelemetry pipeline.


## Related topics

| Topic | Documentation |
|  --- | --- |
| Configure sponsorship | [Configure gas sponsorship](/products/custody/v1.36/accounts-and-assets/gas-station/configure-sponsorship) |
| Deployment reference | [Gas Station reference](/products/custody/v1.36/deployment/reference/gas-station) |
| Bot users | [Configure bot users](/products/custody/v1.36/governance/users/manage-users-and-roles#configure-a-bot-user-with-the-api) |
| Omnibus | [Omnibus](/products/custody/v1.36/accounts-and-assets/omnibus/overview) |