Changelog
The latest updates & improvements to Splits.

Split creation flow

We've made a number of design improvements to the new Split flow.

Improved new Split creation flow

First, creating a Liquid Split is now a template. We did this because it's fundamentally different than just creating a Split, since when creating a Liquid Split you're actually deploying an NFT contract in addition to a mutable Split. Given our future product direction we felt pulling Liquid Split out into it's own template makes the most sense.

Mutable Split controller

Previously, choosing to make a Split mutable was separate from choosing the controller. Since a Split can only be mutable if a controller is set, we decided to combine these two steps into one by allowing you to make a selection. If you want the Split to be immutable, just select "no controller". Otherwise, you can either select yourself (if your wallet is connected) or you an enter in any address you wish.

Select controller

Distribution threshold

Adding a distribution bounty is the best way to automate your Splits. By adding a bounty, you're encouraging third-parties to come and distribute balances for the recipients. In an effort to more clearly communicate how this bounty works, we've redesigned this input to let you select the amount at which balances will be distributed. You can see (on the right side) what percentage the distributor fee will be based on the threshold you've selected.

Set a distribution threshold

Splits Sponsor

We're grateful for the folks who have chosen to donate a portion of their Split's earnings back to the team building Splits. It's an honor knowing that people are choosing to pay us—not because they have to, but because they want to. We want to both celebrate the people who have chosen to donate, and also make it easier to donate. Now, the last part of creating a new Split is deciding whether you want to become a sponsor.

Become a sponsor

If you choose to become a sponsor, anytime your Split is viewed or shared online, everyone will see the sponsorship badge displayed at the top of your page and know that you've chosen to sponsor the development of Splits.

Sponsor badge

Upload CSV flow

People have increasingly been creating larger and larger Splits. We've seen several Splits with hundreds of recipients! This is great to see, and we need to ensure that creating large Splits is as easy as possible. To this end, we redesigned the "bulk upload" flow to make it both easier to use and more apparent as an option.

Add many recipients at once

Now when creating a Split, next to "Add Recipient" there is an "Upload CSV" option. Clicking it will open a dialog where you can either upload a CSV or paste in a list of addresses and amounts. Once you hit "Validate", those recipients will be added as recipients.

Recoup creation flow

Finally, we took the changes we made to the new Split form, including the CSV upload flow, and added them to the new Recoup page as well. We have seen more and more folks use the Recoup flow, like this Metalabel drop, and have found that the process of creating a Recoup with many recipients was tedious. Plus, there were a number of bugs we learned about. So we fixed the bugs and brought all the Split improvements over to Recoup.

Sponsor badge

Most of our effort has been focused on getting Swapper into a launch-ready state – keep an eye out for more news on that front in the coming weeks!

Sherlock competition

Our radio silence and general lack of changelog updates is because we've been focused on Swapper, a new contract we're about to launch. We have been working on this contract for a few months now and just opened up a Sherlock competition for it and a handful of related contracts.

This is our first time doing a Sherlock competition and we're excited to have obront be our Lead Senior Watson. We'd love for you to join and see what vulnerabilities you can find. The competition ends on April 24th.

We'll be launching Swapper into the app (along with a handful of related products) in the coming weeks once the Sherlock competition is complete.

Templates section

When creating new contracts, we've separated the main building blocks (Split and Waterfall) from the templates. Templates stack different building blocks together, so we wanted to make a clearer distinction between the types of contracts being created. We're also developing more contracts and templates, and this separation will help users understand how everything works together.

New contract and templates sections

Recoup preview

When creating a Recoup, multiple contracts are involved. To make it easier to understand how funds will flow through the contract once it's created, we added a contract preview to the creation process.

Recoup preview

Creation flow polish

We made some improvements to the new contract creation process, including removing unnecessary components, improving the mobile experience, and hiding infrequently used actions.

Form polish

Recoup template

We believe the onchain ecosystem as a whole benefits greatly from simple, modular, and resuable tools. We also understand that it's oftentimes the combination of simple tools that unlock new workflows.

When Waterfall launched a few months ago, we thought about how great it would be to pair it with Splits. (In fact, Metalabel did just this). This combination of Waterfall + Splits lets you create all sorts of interesting structures that revolve around splitting profits instead of revenue. Most projects have upfront costs, and the person who covers those costs wants to be repaid before profits are split among the group. Musicians, VC, PE, debt—tons of workflows exist that need to combine these contracts together.

The problem is that to do so requires deep knowledge of how the system as a whole operates, since you can't create a Waterfall that points to a Split unless that Split already exists. Recoup solves this problem. It's a very simple contract paired with a UI that lets you, in a single transaction, create a Waterfall that points to multiple Splits.

Create a new Recoup contract

When creating a new Recoup, just list all the recipients you want paid out for each tier. As long as more than one recipient is added, when you create the Recoup a Split will also be created. And if there's only one recipient, no Split will be created.

And once again, Metalabel is already using this. For their most recent Quality Drops, they teamed up with Songcamp and Catalog to create a Recoup for an event they're hosting around NFT NYC in April. You can see their Recoup here, and you can read more about the event and tickets here.

Recoup detail view

We think of Recoup as being the first template - a pre-built collection of contracts that solve a very specific problem. We have a number of additional templates we we'll be launching in the coming months, stay tuned.

Improved mobile layout

We wanted to make the app easier to use on mobile, particularly for folks just connecting their wallet to withdraw their balances. This should be simple, and previsouly it required a number of steps and an unintuitive withdraw flow. We improved this on mobile by combining the various actions—network selector, navigation, account menu—into one coherent section.

Better nav on mobile

Additional improvements

  • We now match the same recipient order on the new Split form after hitting "Duplicate Split" from a Split account page
  • We fixed an issue within the account menu dialog, where accounts with lots of tokens to withdraw weren't able to see the full list
  • We reworked the subgraph to ensure Liquid Splits created by third parties properly display in the app

Explore page

There’s a lot of activity going on within the 0xSplits protocol. Unless you know exactly what you’re looking for it can be rather intimidating, never mind unhelpful, to see just a list of all the Splits ever created, which is what we were previously displaying for new users. We improved this experience by launching an all new Explore page, which allows you to see how a handful of different groups—from DAOs to artists to collectives—are getting the most out of the 0xSplits protocol.

Explore featured accounts

Additional networks

It’s important for Splits to be available where the people are, so we’ve deployed the contracts onto a number of new networks including Gnosis, Aurora, Fantom, Avalanche and more. The full list is here. We’ve updated the app to support all these networks and their testnets as well. You won’t see them all in the network selected, but you can still access them by changing the network in your wallet provider.

Token whitelist

Due to the nuances of fetching ERC-20 token information on each new chain, we’ve added the ability for people to customize their own token whitelist in the app. In addition to the tokens on our global whitelist, all tokens added to this whitelist will show up in your app. Note that this whitelist is saved only to local storage and is associated to the network and connected wallet, meaning if you change network and/or connected wallet, the whitelist will also change.

Edit your token whitelist

Additional improvements

  • We added gas estimates to the SDK. When using the SDK, it’s easy to fetch the estimated gas cost for any transaction. More in the docs here.
  • We’re now displaying all contracts in a more consistent manner, making it easier to see any account’s earnings, balance, and last activity. Additionally, when viewing a Split on an account page, you can see the percentage of the Split that account is earning.
  • We removed the testnets from the network selector in the app. You can still access the app on the various testnets by manually changing the network in Metamask.

Hello, Changelog!

We take pride in what we build. And since launching 0xSplits to the world in February 2022, more often than not, much of what we build is never publicly documented. Sometimes we tweet about some big new features, but that typically only happens for…big features. Yet so much of our time is invested in sweating the details and getting the small interactions right. So today, we’re introducing the Changelog, a dedicated space to share all the things we've shipped. So let's get to it.

Updated layout

updatedlayout

We have big plans for the app and will be launching a ton of new features in the next few months. As a result, we needed to introduce a new layout that will provide more flexibility and support for these new features. The new layout gives us this flexibility while making navigation easier on mobile devices and improving the withdraw flow for connected accounts.

Distribute and withdraw

updatedlayout

There are many times when you may want to distribute a Split and then immediately withdraw for those recipients. Maybe because some of the recipients are smart contracts that cannot withdraw for themselves, or perhaps you’re just feeling generous. Regardless of the reason, there are times when pushing funds to the end recipients is useful. Previously, this required going to each recipient’s account page and hitting withdraw. While you can still do that, we’ve made this process a lot easier. Just select the Split balances you wish to distribute, and then hit the down icon within the distribute button. You’ll be able to select what recipients—either all, or if you’re part of the Split, just yourself—for whom you wish to withdraw.

Use an existing Split as a template

updatedlayout

We’ve heard time and again the need to create multiple Splits that are nearly identical. A 5-way Split where 4 of the recipients never change. Whether you’re a music label, podcast host, or musician, there are often times when you want a very similar but not identical configuration. Instead of downloading the CSV and then uploading that each time, now you can just hit the Duplicate Split button within the “Split Recipients” tab. This will take you to the new Split page with the configuration pre-filled, allowing you to make whatever modifications you’d like.

updatedlayout

You may notice that when you do this, we’re actually adding a bunch of params to the URL on the new Split page. We built this feature in this way so that 3rd party apps can deep-link into the new Split flow, allowing users to create pre-defined Split according to 3rd party apps.