Gas reserves operations
Fund, configure, and troubleshoot the Submission reserve and Sponsorship reserve for advanced accounts in DALP.
This runbook covers all operational tasks for the gas reserves that support advanced accounts. For a conceptual explanation of why the reserves are separate and what each one funds, see Gas reserves.
All procedures in this runbook require System Manager access. Navigate to Organisation settings > Operations > Advanced accounts to start.
On any network that charges gas, keep the Submission reserve funded at all times. If it reaches zero, every advanced-account transaction stops for every participant until you top it up. Keep the Sponsorship reserve funded too whenever gas sponsorship is enabled, or sponsored transactions begin to fail. Funding is not a one-time setup step. It is ongoing, and the balances need monitoring against the alarms described below.
Prerequisites
- Advanced accounts is enabled for the organisation.
- You hold the System Manager role.
- You have access to native tokens on the active network for funding operations.
- Balances update only after the funding transfer confirms on-chain. Allow time for confirmation before verifying the new balance.
Fund the Submission reserve
The Submission reserve is the bundler wallet balance. Send native tokens directly to the bundler wallet address.
Open the advanced accounts hub
Go to Organisation settings > Operations > Advanced accounts.
Locate the Submission reserve section
Find the Submission reserve card. Note the current balance and the low-balance warning if one is present.
Copy the bundler wallet address
Click Fund to open the funding dialog. Copy the bundler wallet address shown in the dialog.
Send native tokens to the address
Use your wallet or custody system to send the required amount of native token to the bundler wallet address you copied.
Confirm the balance update
Wait for the on-chain transfer to confirm. Return to the Submission reserve card and verify that the balance reflects the new amount.
If the balance has not updated, check the transaction status in a block explorer before sending a second transfer.
Fund the Sponsorship reserve
The Sponsorship reserve is backed by the paymaster's EntryPoint deposit. Sending native tokens to the paymaster contract address deposits them into EntryPoint automatically.
Open the advanced accounts hub
Go to Organisation settings > Operations > Advanced accounts.
Locate the Sponsorship reserve section
Find the Sponsorship reserve card. Note the current balance, runway, and any runway alarm status.
Copy the paymaster contract address
Click Fund to open the funding dialog. Copy the paymaster contract address shown in the dialog.
Send native tokens to the paymaster address
Use your wallet or custody system to send the required amount of native token to the paymaster contract address.
The paymaster contract deposits received tokens into EntryPoint. You do not need to interact with EntryPoint directly.
Confirm the balance update
Wait for the on-chain transfer to confirm. Return to the Sponsorship reserve card and verify that the EntryPoint deposit balance reflects the new amount and that the runway has recalculated.
Enable or disable gas sponsorship
Gas sponsorship controls whether the Sponsorship reserve is used for participant transactions. Disabling it is a deliberate policy choice, not an emergency action.
Open the advanced accounts hub
Go to Organisation settings > Operations > Advanced accounts.
Find the sponsorship toggle
Locate the Gas sponsorship setting in the Sponsorship reserve section.
Change the setting
Toggle gas sponsorship on or off. Confirm the change in the dialog that appears.
When you disable sponsorship, the status shows Sponsorship off, which is informational. No alarm is raised.
When you enable sponsorship, confirm the Sponsorship reserve has enough balance before participants begin transacting.
Set runway alarm thresholds
The default warning threshold is 14 days and the default critical threshold is 5 days. Adjust them to match your operational response capacity.
Open the advanced accounts hub
Go to Organisation settings > Operations > Advanced accounts.
Open reserve settings
Find the alarm threshold settings in the Sponsorship reserve section or in the reserve configuration panel. The exact controls depend on the current portal version.
Set the warning threshold
Enter the number of days at which a low-runway warning should trigger. The warning threshold must be greater than the critical threshold.
Set the critical threshold
Enter the number of days at which a critical-runway alarm should trigger.
Save the thresholds
Confirm the change. The updated thresholds take effect on the next runway recalculation.
Configure the refund split
When a sponsored transaction produces a gas refund, DALP splits it between the two reserves. Configure the Submission reserve share to control the allocation.
Open the advanced accounts hub
Go to Organisation settings > Operations > Advanced accounts.
Open the refund split configuration
Locate the refund split setting in the reserve configuration panel.
Set the Submission reserve share
Enter a value from 0 to 10,000 in basis points. This share of each refund goes to the bundler wallet (Submission reserve); the remainder goes to the paymaster EntryPoint deposit (Sponsorship reserve). One basis point equals 0.01%, so 10,000 = 100% and 3,000 = 30%.
A value of 0 sends all refunds to the Sponsorship reserve. A value of 10,000 sends all refunds to the Submission reserve.
Save the setting
Confirm the change. The new split applies to subsequent refunds.
Troubleshooting by reserve status
| Status shown | What it means | What to do |
|---|---|---|
| Submission empty | The bundler wallet is empty. No advanced-account transaction can be submitted. | Fund the Submission reserve immediately. Treat as an operational emergency. Do not wait for on-chain confirmation before alerting on-call staff. |
| Submission low | The bundler balance is below 0.05 ETH (or equivalent). The reserve will empty at current usage rates. | Fund the Submission reserve. Monitor the balance after confirmation. Consider increasing the transfer amount if burn rate is high. |
| Sponsorship runway critical | Runway is below the critical threshold (default 5 days). Sponsored transactions will stop without a top-up. | Fund the Sponsorship reserve. Factor in the recalculation delay before the runway figure updates. |
| Sponsorship runway low | Runway is below the warning threshold (default 14 days). | Plan a top-up within your normal operational window. No immediate action required unless burn rate is accelerating. |
| Sponsorship off | Gas sponsorship is disabled. | No action required unless the platform is supposed to offer gasless transactions. To re-enable, follow the Enable or disable gas sponsorship procedure above. |
| Runway blank or unknown | No sponsored activity in the last seven days. No burn rate to measure. | No action required. Runway will display once sponsored transactions resume. Fund proactively if you expect a volume spike. |
Related
- Gas reserves for the conceptual model: what each reserve funds, why they are separate, and how the status ladder reflects urgency.
- Advanced accounts control center for the full advanced-accounts infrastructure view, including bundler and paymaster status, signer key, and activity log.