Auto Swap and Distribution Setting
What Are Auto Swap & Distribution Settings?
Auto Swap & Distribution Settings allow organizations to automatically convert incoming USDC or USDT revenue into another supported token before distributing it.
At each scheduled distribution time, the smart contract swaps the entire available balance of the selected USDC or USDT into the chosen destination token. The resulting tokens are then sent either to the connected operation address or distributed among multiple recipient addresses according to the configured percentages.
This feature follows the same distribution rules as Distribution Settings, with an additional automatic swap step.
How to Set Up Auto Swap & Distribution Settings
Auto Swap & Distribution Settings automatically swap incoming USDC or USDT revenue into a selected token and distribute the resulting tokens according to the configured recipient option and schedule.
Go to the Auto Swap & Distribution Settings tab.
Under Supported Assets, select USDC or USDT.
Under Swap To, select the token you want to receive after the swap.
Under Recipient, select one of the following:
Your Current Address
Forwarding Address and Ratio
When selecting Forwarding Address and Ratio, enter the recipient wallet addresses and distribution percentage for each address.
To add another recipient, select Add More. You can add up to 12 recipient addresses.
Set the Distribution Time.
Review the applicable distribution fee.
Select Set Up.
Approve the required requests in KEYRING PRO Wallet.
Wait for the setup process to complete.
Recipient Options
Only one recipient option can be selected for each Auto Swap & Distribution contract.
Your Current Address
Select Your Current Address to send the entire swapped amount back to the wallet address currently connected to KEYRING ONE.
When this option is selected:
The connected operation address is the only recipient.
No additional recipient addresses can be added.
The distribution fee is calculated as one recipient.
Forwarding Address and Ratio
Select Forwarding Address and Ratio to distribute the swapped tokens among multiple wallet addresses.
The following rules apply:
The total distribution percentage across all recipient addresses must equal 100%.
The connected operation address cannot be added as a forwarding address.
A maximum of 12 recipient addresses can be added.
The distribution fee is calculated based on the number of recipient addresses.
Supported Source Assets
Auto Swap & Distribution Settings currently support the following source stablecoins:
USDC
USDT
At each scheduled distribution time, the entire available balance of the selected source stablecoin is swapped and distributed.
Only one active distribution-related contract can exist for each supported stablecoin across both Distribution Settings and Auto Swap & Distribution Settings.
For example:
If a USDC contract is active under Distribution Settings, another USDC contract cannot be created under Auto Swap & Distribution Settings.
If a USDT Auto Swap & Distribution contract is active, another USDT distribution contract cannot be created until the current contract is stopped.
This rule applies because each contract processes the entire available balance of its selected USDC or USDT.
Distribution Time
You can choose between two automatic distribution schedules.
Hourly
Revenue is swapped and distributed once every hour, starting from the next full hour after the setup is completed.
For example:
If the setup is completed at 4:20, the first execution is scheduled for 5:00.
If the setup is completed at 4:45, the first execution is also scheduled for 5:00.
After the first execution, the system continues processing every hour.
Daily
Revenue is swapped and distributed once per day at the selected UTC hour.
Only full-hour times can be selected. Minutes cannot be configured.
For example, selecting 12:00 UTC means the system will attempt to swap and distribute the available revenue every day at 12:00 UTC.
Distribution Fee
A distribution fee is charged each time the system successfully completes an Auto Swap & Distribution.
The fee is calculated based on the number of recipient addresses:
Most supported networks: USD 0.10 per recipient address
Ethereum: USD 2.00 per recipient address
When Your Current Address is selected, the fee is calculated for one recipient:
USD 0.10 on most supported networks
USD 2.00 on Ethereum
When Forwarding Address and Ratio is selected, the fee is calculated according to the number of forwarding addresses.
For example, distributing to three addresses would incur:
USD 0.30 on most supported networks
USD 6.00 on Ethereum
The fee is deducted automatically when the transaction is successfully processed.
How to Stop an Auto Swap & Distribution Contract
Only one active distribution-related contract can exist for each supported stablecoin, and the settings of an existing contract cannot be changed.
To update the destination token, recipient option, recipient addresses, percentages, or schedule, you must stop the current contract and create a new one.
To stop an Auto Swap & Distribution contract:
Go to the Auto Swap & Distribution Settings tab.
In the panel on the right, open My Auto Swap & Distribution Settings.
Select the contract you want to stop.
Select Stop Distribution.
Confirm the request in KEYRING PRO Wallet.
Wait for the process to complete.
Important Notes
Stopping the contract permanently removes the current Auto Swap & Distribution settings.
The contract settings cannot be restored after the contract has been stopped.
To resume the service for the same USDC or USDT, you must create a new contract.
The new contract can use a different destination token, recipient option, forwarding addresses, percentages, or schedule.
Last updated