A Split is a smart contract that splits all incoming native currency (ETH on Ethereum, MATIC on Polygon, etc.) as well as popular ERC-20 tokens according to predefined ownership shares.
Our split contracts are minted using the ERC-20 token standard and as such ownership is easily transferrable. Each recipient has complete control of their share of a split contract and can transfer it to any other 0x address they choose.
It's smart contract logic that you can plug into any blockchain supported payment flow you use.
Supported Currencies
Our split contracts feature automated splitting of the native currency of each blockchain we currently support as well the following ERC-20 tokens.
Native Currencies
MATIC (on Polygon minted contracts)
ETH (on Ethereum testnet minted contracts)
ERC-20 Tokens
ATOM
AVAX
BUSD
DAI
USDC
USDT
WBTC
WETH
Unsupported tokens sent to a split contract will remain held by the contract until they can be distributed manually.If you wish to distribute a token not listed above, please get in touch via support@revelator.com.
Creating a Split
Anyone with the Revelator Wallet app can create a new split contract for usage anywhere web3 payments are processed.
Create a new split contract
Open Splits from the tab bar.
Tap +New split to get started.
Give your split a name and description (optional), and select from our supported blockchains to mint the contract. Tap Next when ready to proceed.
Configure the split contract's token supply by choosing a preset or setting a custom amount.¹ Tap Next when ready to proceed.
Assign the split %'s to be distributed at the time of minting.² To add a recipient, tap + Add split.
When adding new splits, you can search for Revelator Wallet users by name or email, or paste in their public wallet address directly. You can also search for other split contracts by name, or paste in any contract address directly.³
Enter a split amount as a % of token supply or the exact # of tokens.
Optional: Turn on Make Admin if the recipient should have admin permissions on the split contract.⁴
Tap Add split to assign tokens to this recipient at the time of minting.
After you have assigned 100% of the split contracts tokens, tap Preview to review your split contract before minting on-chain.
When ready, tap & hold to confirm and mint your split contract.
Face/Touch ID or PIN will also be required to confirm.
Notes
¹ A higher supply allows for greater liquidity to fractionalize splits between multiple parties. The minimum amount required is 100.
² By default, your own wallet is added as an admin with 0%. You can either increase your split % or remove yourself entirely.
³ Adding a contract address as a recipient of a Split, allows you to waterfall payments between multiple smart contracts.
⁴ Admins have complete authority to edit contract settings and add/remove other admins.
Sending Split Tokens
A split contracts tokens can be sent from your wallet to any other 0x wallet or split contract address. This allows you to control and distribute your split percentage on the contract as you see fit.
Send split tokens to another wallet or split contract
Open one of your split contracts from the Splits tab.
Tap Send in the bottom bar next to your split %.
Tap Send to, to choose a recipient. You can search for other Revelator Wallet users by name or email, or paste in their public wallet address directly. You can also search for other split contracts by name, or paste in any contract address directly.¹
Enter an amount you'd like to send.
Tap Preview transaction to review your transaction before sending.
When ready, tap & hold to confirm and send your transaction.
Face/Touch ID or PIN will also be required to confirm.
Notes
¹ Adding a split contract address as a recipient of a Split, allows you to waterfall payments between multiple parties.
Splitting Payments
Split contracts can be used to split payments from Royalty Tokens, NFT sales, and other smart contracts between multiple parties. To use your split for distributing payments, copy the contract address and paste/use it as the recipient on transactions to be split between all holders.
As soon as a supported token or currency is received by the split contract, it will automatically distribute payments according to the current split percentages of each holder.
Finding a Split's contract address
From Share:
Open the split contract you intend to use.
Tap the share icon next to the split contracts name at the top.
This opens a system share sheet for you to send the contract address via 3rd-party apps or email. You may also copy it to your clipboard here too.
From Holdings:
Open the split contract you intend to use.
Scroll to the Add Holdings card seen below the split contracts earnings history.
Tap Receive to display the splits QR code for scanning by another device (useful when standing next to someone wanting to pay you from their wallet) as well as the contract address for copying or sharing to anyone.
Tap Copy to copy the contract address to your device clipboard for pasting anywhere.
From Details:
Open the split contract you intend to use.
Scroll to the Details section of the page and tap the contract address to copy it to your clipboard.
Example 1: Using a Split to receive NFT royalties
When minting an NFT on Revelator Pro, Studio or any 3rd-party platform you can designate a 0x recipient for receiving royalty proceeds from sales. This means each time your NFT is sold, a percentage of the sale price is directed to your split contract and automatically distributed to each holder according to their share.
Example 2: Using a split as a rights holder on a Royalty Token
When setting up rights holders within a royalty token, if you have a subset of holders that need to split a specific amount vs other rights holders, you can designate their share to be directed via a split contract they are each party to.
They can even direct part of this share to be split further by chaining together an additional split contract, where payment continues to be distributed until all wallets have received their share.
Managing Split Contract Holdings
Split contracts can also be used to hold other smart contract tokens such as NFTs, community/fan tokens, and more in order to share ownership between multiple parties. If your Split is used to hold Royalty Tokens or other Split contract tokens, then they will appear here as well.
Managing a Split Contacts holdings
Only admins can manage any of the assets held in a split contract. As an admin if you wish to send some of a splits holdings to another wallet or split contract address, follow these steps:
Open the split contract you wish to transfer holdings from.
Scroll to the Holdings section.
Open the Royalty Token or split contract from here or tap See all to view all of the splits holdings.
When viewing the details, note the split % is that of the split contracts and not your own. Tap Send to transfer some of the split contracts holdings to another wallet or split contract address.
