Overview

The Ourz Contracts allow anyone to setup an 'NFT Lego' that splits funds between addresses. Like everything else on Ethereum, executing code requires gas. Here's a quick rundown of how ourz.network works, and the associated transactions you'll be making to use it.

First, you'll make a transaction to create your Split Contract. The Split Recipients' addresses & allocation %age are set during the Split Contract's creation. These values are permanent and cannot be changed.

Separate from the Recipients, the Split Contract will have an 'owner.' This is set to the address that created the Split. Owners are effectively whitelisted to act on behalf of the Split Contract. They can mint NFTs, curate auctions, or even create a new contract, all as the Split Contract. Owners can also add and remove other owners. Be sure you only whitelist addresses you trust, as they could remove you!

After you've created a Split Contract, you will be able to mint, curate, etc. All of these will work almost exactly the same as it normally would, just via the Split first. There is a small overhead in gas costs for this.

Once funds are in the Split, Recipients are able to claim the funds.

⚠️ It is important to note that ourz.network splits do not automatically forward funds.

⚠️ Funds must be claimed with transactions.

The Recipient can claim funds themselves, or another address could claim it for them which will send the funds to the Recipient's address. Any recipient can claim at any time, and in any order.

The decision to require a separate transaction to claim weighs heavily on smart-contract security principles. It would also make the transaction fees to use the Split Contract scale with the number of Recipients, rather than being a flat gas cost.

Quick Links

Website

Github

Gitcoin Grant

Table of Contents


FAQs

How do I mint a Split NFT?

First you create a split contract with the desired recipient addresses and allocations. These addresses and allocations are permanent - if you want to use different values for another NFT, you must make another split. Then you mint the NFT via the Split contract. Zora sees that the Split Contract is calling mint() and will make the Split Contract the NFT's creator.

Does the number of splits affect the gas fees?

The number of splits doesn't affect the cost of creating a Split contract. Each recipient will have to claim ETH in a separate transaction however.

Are ERC-20s supported?

ERC-20's are supported but not recommended as the gas fees for claiming ERC-20s will scale with the number of recipients.

How does claiming ETH work?

Each recipient requires a separate transaction to claim funds. Thanks to Merkle Proofs, it can be called by any address, but the ETH can only ever be sent to recipients.

Who can mint an NFT for the Split?

Only whitelisted addresses are allowed to mint on behalf of the Split Contract. The owner is the address that originally made the Split Contract, and they can add and remove addresses to the whitelist.


These splits are based on MirrorXYZ's Splits

Read more about Mirror's Splits