Policy Management

A policy is your configuration on a blockchain network for using Circle’s Gas Station. You must set up a policy to use the Gas Station on Mainnet. Here, you will configure what you are willing to sponsor on behalf of your users. Circle’s Gas Station will pay the fees if a transaction meets your configuration.

Policy Setup for Gas Station on Mainnets

To activate a Mainnet Policy, follow these steps:

1. Access the Sponsorship Policy page: Using your credentials, log in to the developer console. Toggle to Mainnet [top left corner]. From there, navigate to the Gas Station section, which allows you to manage your gas fee sponsorship policies efficiently.
2. Choose to create or select a policy: If you do not have a Mainnet Policy yet, select the option to create a new policy. Alternatively, choose the desired policy from the available list if you already have an existing one.
3. Configure policy settings: Set the desired configurations for your policy based on your specific needs. Refer to the list of configurations provided below for clarity on available options.
4. Update or create the policy: After applying the necessary configurations, choose either the "Update" or "Create" button at the bottom of the page. "Update" should be selected if you modify an existing policy, whereas "Create" is appropriate for a new policy.
5. Activate the policy: After confirming your chosen policy configurations, proceed to the top right corner of the page and select the "Activate" button. This final step confirms your intention to enable the selected policy and initiate gas fee sponsorship according to the specified settings.

👍

Gas Station auto-sponsors after Policy is set

When you create a policy on a chain, Circle sponsors gas fees for all accounts that meet your configuration. You do not need to pass the policy ID in each transaction request.

Policy Configurations

A policy consists of the following configurations:

1. Policy Name: Provide a descriptive name for the policy to identify it in the policy list. The policy name displays only in the console.

2. Network: Refers to the specific blockchain network where the Gas Station will cover gas fees. Each policy supports only one blockchain network, ensuring clarity and ease of management.

3. Default Policy: The policy sponsors gas fees for any transaction on a specific network, including wallet creation and contract execution. You can set only one default policy per network. We recommend designating this as the first policy for the specified network.

   Note: Transactions use only default policies. If you want to use a non-default policy, update it to default and activate it.

4. Maximum spend per day* (optional): Specify the maximum allowance for gas fees in USD that you are willing to sponsor within a 24-hour period. This restriction provides control over the allocated budget for gas fee sponsorship.

5. Maximum spend per transaction* (optional): The maximum allowance for gas fees in USD that you are willing to sponsor for a single transaction.

   Note: Maximum spend per transaction limit does not apply to the first transaction made from any Smart Contract Account (SCA) wallet. This includes SCA-type wallets as well as Console Wallets.

6. Maximum operations per day* (optional): The maximum number of supported operations (such as transactions) per day.
7. Blocked addresses (optional): A configurable list of blockchain addresses that will not receive sponsored gas fees. This feature allows you to exclude specific addresses from benefiting from gas fee coverage.

*Daily limits reset once every 24 hours at 0:00 UTC.

By leveraging these configurations within a policy, you can fine-tune the gas fee sponsorship parameters to your specific requirements and financial considerations. Note that any limits left blank will not be applied.

Deactivating a Gas Station Policy on Mainnet

If you need to deactivate the Mainnet policy at any given time, it can be done conveniently from the developer console. To deactivate the Mainnet policy, follow these simple steps:

1. Select the Mainnet policy: Access the console and locate the intended Mainnet policy that you wish to deactivate. This can be found in the policy management section.
2. Click on the deactivate option: Once you have identified the Mainnet policy, click on the "deactivate" button in the console interface's top right corner. This action triggers the deactivation process.
3. Confirm the deactivation: A pop-up modal will appear after clicking the deactivate option. Select the deactivate button within the modal to confirm your intention to deactivate the Mainnet policy.

🚧

CAUTION: Deactivating a policy will stop all Mainnet transaction sponsorships and end-users wallet transactions will be rejected effectively unusable.

Following these steps, you can easily deactivate the Mainnet policy, granting you control and flexibility over the gas fee sponsorship within your application.

Policy Setup for Gas Station on Testnets

When it comes to using Gas Station on Testnets, the setup process is hassle-free. Circle takes care of the initial configuration by automatically generating a default policy upon signing up for an account. This default policy is specially designed for developers leveraging Programmable Wallets during the testing phase. With this default policy in place, you can seamlessly sponsor Testnet tokens while building your applications.

It's important to note the gas fee sponsorship limits applicable for different Testnet networks:

1. Polygon Amoy: The daily limit for sponsoring Testnet tokens is 50 MATIC.
2. Ethereum Sepolia: The daily limit for sponsoring Testnet tokens is 50 ETH.
3. Solana Devnet: The daily limit for sponsoring devnet tokens is 2 SOL.

View Gas Sponsored Transactions

We provide a dashboard and APIs to monitor and analyze these gas sponsorship transactions.

Using the Developer Dashboard

To view gas-sponsored transactions in Testnet or Mainnet:

1. Access the Gas Station policy page: log in to the developer console using your credentials. From there, navigate to the Gas Station Policy section, which allows you to manage your gas fee sponsorship policies efficiently.
2. Select a policy: Choose the specific policy you want to review from the available list on the policy page.

View sponsored transactions table: On the policy page, you will find a table view listing the transactions that have been sponsored. You also have the option to apply filters to refine the view, enabling you to focus on the relevant data that meets your specific requirements.