With this tool a merchant can accept payments through a smart contract using liquidity pools. Smart contract for merchant creates 0xProcessing.
Web3 processing allows clients to pay with Web3 wallets in any of the available iterations: either with a widget on the website or a mobile wallet.
In this case, the size of the liquidity pool, the number of transactions and their volume, as well as any other necessary information that you would like to broadcast, can be available to users in real time through the blockchain browser or frontend of your website.
In addition, the functionality of Web3 processing allows you to set up automatic payouts to your employees' Web3 wallets.
Before you start integrating the method, leave a support request to activate the appropriate functionality. This deposit method supports BNB chains.
First, you need to contact technical support to connect your merchant to this feature. After receiving an answer from technical support about readiness, you can start the integration.
API endpoint: https://web30.0xprocessing.com/
Check
To authorize in the API you need to generate a token in your personal account under "Settings - Merchant Management - Web3 API Token".
Requests must contain the APIKEY header with your API key.
The process of adding tokens to the whitelist
In order for the liquidity pool to accept the tokens you want, you must add them to the whitelist of the smart contract.
First, you need to select from the available tokens the ones you need to work with.
You can see the list of supported tokens in the method Info/SupportedTokens.
You can add tokens in the method ContractSettings/AddTokenToWhitelist.
All methods of interaction with the contract return the id of the request, the status of which can be viewed in the method Queue/Status/{requestId}
After executing the request, be sure to verify that the request has been successfully executed.
Depositing tokens into the pool by users
To deposit a token into the pool, you must create a "Deposit" button in the user environment.
Example:token_contract_address – token contract address (can be obtained from the method Info/SupportedTokens)
pool_contract_address – address of the pool contract (can be obtained from the method Info/Contract)
To allow a user to claim tokens from the pool (withdrawal), it is necessary to reserve an amount for that user in the contract, as well as provide the user with a Claim button.
After successfully reserving an amount, the user can "claim" it from the contract via claim.
<script src="https://cdnjs.cloudflare.com/ajax/libs/web3/1.7.0-rc.0/web3.min.js"></script>
<script>
window.addEventListener('load',
// Connecting Metamask
async () => {
if (window.ethereum) {
window.web3 = new window.Web3(window.ethereum);
initConnectButton();
} else if (window.web3) {
window.web3 = new Web3(window.web3.currentProvider);
initConnectButton();
}
});
const initConnectButton = async () => {
web3.eth.getAccounts(function(err, accounts) {
if (err != null) {
document.getElementById('0xWeb3PoolConnectButton').style.display = 'none';
}
});
document.getElementById('0xWeb3PoolConnectButton').addEventListener('click',
async () => {
if (window.ethereum) {
try {
await window.ethereum.request({ method: 'eth_requestAccounts' });
initClaimButton();
} catch (err) {
console.log('User denied access', err);
}
} else if (window.web3) {
window.web3 = new Web3(window.web3.currentProvider);
initClaimButton();
}
});
}
const initClaimButton = async () => {
document.getElementById('0xWeb3PoolConnectButton').style.display = 'none';
document.getElementById('0xWeb3PoolClaimSection').style.display = 'block';
const contractAbi = JSON.parse('[{"anonymous":false,"inputs":[],"name":"Pause","type":"event"},{"anonymous":false,"inputs":[],"name":"Unpause","type":"event"},{"inputs":[{"internalType":"address","name":"recepient","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"addUserClaimable","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"token","type":"address"}],"name":"claim","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"claimFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"claimable","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"feePercent","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPercent","type":"uint256"}],"name":"feePercentChange","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"feeRecepient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"recepient","type":"address"}],"name":"feeRecepientChange","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getOwner","outputs":[{"internalType":"address","name":"owner","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"reserved","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"whitelistERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"whitelistedERC20","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"recepient","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawalAdmin","outputs":[],"stateMutability":"nonpayable","type":"function"}]');
var accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
web3.eth.defaultAccount = accounts[0];
var tokenAddress = document.getElementById('0xWeb3PoolClaimButton').dataset.token;
var poolAddress = document.getElementById('0xWeb3PoolClaimButton').dataset.pool;
var contract = new web3.eth.Contract(contractAbi, poolAddress);
var decimals = web3.utils.toBN(18);
contract.methods.claimable(accounts[0], tokenAddress).call(function(error, result) {
document.getElementById('0xWeb3PoolClaimAvailable').innerHTML = result / Math.pow(10, decimals);
});
document.getElementById('0xWeb3PoolClaimButton').addEventListener('click',
async () => {
var amount = document.getElementById('0xWeb3PoolClaimInput').value;
var value = amount * Math.pow(10, decimals);
console.log(value);
contract.methods.claim(web3.utils.toHex(value), tokenAddress).send({ from: accounts[0] },
function (error, result) {
if (!error) {
console.log(result);
} else {
console.log(error);
}
});
});
}
</script>
The result of the claim procedure, that is, when the user received tokens from the contract to his wallet can be received in the same way as a deposit.
Withdraw
Withdraw the balance of tokens from the contract (except those reserved for users).
To reserve the required amount for a certain user, you need to call the method .
During the reservation, the commission of the pool will be withdrawn.You can find this information on the form .
In order for the user to pick up his tokens, it is necessary to call the method of the contract.
Withdrawal of free tokens is performed using the method
The number of available free tokens can be obtained by the method
