Rebalancing

Context

Once your paymaster instance is running, your relayers are spending STRK tokens to pay for transaction while your GasTanker is accumulating users tokens. After a while, you could be out of STRK on your relayers to pay for transaction.

To avoid being out of gas token, the rebalancing process will trigger 2 actions when needed:

• Swapping each token listed in supported-tokens to STRK
• Refill each relayers homogeneously with the resulting STRK balance

Trigger

Rebalancing can be triggered in two ways:

• Manually using the CLI command
• Automatically

Automatic rebalancing is activated as soon as the configuration is set, and can be configured with 3 properties:

• The minimum balance in STRK before triggering the rebalance process
• The interval of time between 2 checks

Swap

The swap process consist of swapping the GasTanker balance of all supported tokens back to STRK. This process is triggered 2 times:

• Periodically
  • To smooth the price impact of selling
  • To avoid being out of STRK if a refill is needed
• At every triggering of the refilling process
  • To be sure to refill the max we can at once

📘

Note

Some FRI could be left in GasTanker after this process because of price variation, they will be used in next refilling round

Swap params

You can configure the swap to avoid loosing money when rebalancing, this include:

• Max price impact
• Slippage

If the condition of one of this 2 params is not met, the swap is aborted for the concerned pair.

Swap provider

You can define the swap provider you want to use for the swap process, currently supported providers:

AVNU

• Mainnet: starknet.api.avnu.fi
• Sepolia: sepolia.api.avnu.fi

Refill

Once the rebalancing as been triggered by a low balance relayer (balance < min-relayer-balance), the STRK balance resulted from the Swap is distributed among all the relayers to have the most homogeneous balances at the end of the process. For example, a relayers can be omitted from some rebalancing.

The refill is bundled as a multicall composed of transfers from the GasTanker to the relayers.

Rebalancing properties

The rebalancing configuration is optional, it means that if you omit it you'll have to trigger the rebalancing manually.

Example

{
  "relayers": {
    // ... other relayer properties
    "rebalancing": {
      "check_interval": 2,
      "trigger_balance": "0x1BC16D674EC80000",// 2 strk
      "swap_config": {
          "swap_interval": 10,
          "max_price_impact": 0.08,
          "slippage": 0.05,
          "min_usd_sell_amount": 1,
          "swap_client_config": {
              "provider": "avnu",
              "endpoint": "https://sepolia.api.avnu.fi",
              "chain_id": "sepolia"
          }
      }
  	}
   // ... other relayer properties
  },
}