Setup for Gas Station 2.0

Fireblocks Gas Station 2.0 is an auto-fueling solution that gives you full control over gas management in your workspace. You can designate a single vault account as your Gas Station account and enable auto-fueling on individual vault accounts, removing the need to monitor balances or manually top up vault accounts.

To enable Gas Station 2.0 for your workspace, contact Fireblocks Support. Once enabled, auto-fueling triggers when you deposit tokens into a vault account that doesn't have enough gas to cover withdrawal fees. The triggering and refueling rules are the same as in Gas Station 1.0.

How to set up Gas Station 2.0

Step 1: Install an API Co-signer

Fireblocks recommends that you install and configure an API Co-signer to sign refueling transfers automatically on your behalf. Without one, a workspace user must sign each refueling operation manually using the Fireblocks mobile app.

Step 2: Configure your Policy rules

Set an auto-refueling rule

Add an Auto-refueling Service rule to transfer funds from your designated Gas Station vault account to other vault accounts. Set your auto-refueling Policy rule as the first rule in the execution order.

To prevent misconfigurations or unintended high-value top-ups, Fireblocks recommends adding a blocking rule before the auto-refueling rule. This blocking rule should enforce a maximum transfer value; for example, five times the maximum gas fee of the relevant asset.

Learn more about Policy rules:

• Create a Policy rule
• Transactions not covered by your Policies

Set an API Co-signer rule

Set a Policy rule that assigns your API Co-signer user as an approver, designated signer, or both for all refueling transactions.

For added security, Fireblocks recommends setting an explicit block rule to prevent the API Co-signer from initiating transactions.

Step 3: Configure your Gas Station vault account

To configure a Gas Station vault account:

1. In the Fireblocks Console, create a new vault account to designate as your Gas Station account.
2. Go to Settings > General > Gas Station vault and select the vault account you just created, or an existing one. Gas Station appears under the vault account name, and the account begins funding any vault accounts that have auto-fueling enabled.

Enable auto-fueling for vault accounts

You can enable or disable auto-fueling for vault accounts using the same procedures as in Gas Station 1.0. For instructions, see Enable or disable Gas Station auto-fueling.

If you try to enable auto-fueling on a vault account before designating a Gas Station vault account, a modal prompts you to designate one.

Gas Station 2.0 webhooks

Gas Station 2.0 transactions have different webhook notification properties than Gas Station 1.0 transactions:

• The webhook's source type has changed from GAS_STATION to VAULT_ACCOUNT.
• You can now use the createdBy field to distinguish between transactions initiated by users and those initiated by Fireblocks servers. The updated createdBy field displays as gas-station (not a user ID), which helps you determine whether the transaction is Vault to Vault or Gas Station to Vault.
• For all Gas Station transactions, the Note field automatically displays as Gas Tank auto-fuel.