Skip to content

Advanced Splits on Objktcom for fundraisers

github-actions[bot] edited this page Jun 23, 2023 · 1 revision

if you want to use objktcom to dedicate a % of your swap towards a given charity address, you can set up an "advanced" split swap. This is especially useful when you want to donate a Token that you have already minted, so Teias split contract is not an option.

Note that advanced listings are only possible on primary market.

You can also check out the guide on the same topic on objktcoms wiki (click)

This is how it goes:

listings guide gif by klick.dev (guide-gif by Klick.dev)

of course you need to be logged into the acc you want to swap from, then head over to the page of the token and to the "action" tab (1) and hit "advanced sale" (2)

ob01

like with any other swap, fill out the number of editions you want to swap and at which priche (3) and hit the "+" to add more beneficiaries to the swap

ob02

Put in the donation address (5), set the splits in % (in the case of this example 10% will go towards the creators address and 90 % will go towards the donation address.

Finally, hit "list token" (7), approve the transaction in your wallet and you are done!

last

if the token sells via this listing, 10% of the proceeds will go towards the seller and 90% towards the donation address

Check the splits of a objktcom listing on TzKT

You'll be able to identify a "advanced swap" on objktcom by looking at the listings tab: if there is a split on the listing, you will be able to see a "group" icon!

listings

You can easily check out the split %s by hovering your mouse over the group icon:

shares_mouseover

Secondary Royality splits

if you are collecting on **secondary market (= swaps that have been done by a collector, not the NFTs creator), ythere is currently no way of setting advanced listings: The revenue will go towards the wallet that has listed the token.

However, The artist can set a % of secondary royalities - these roxalities (usually between 10-25%) will go toward sthe addresses the artist defines upon mint. If an artist donates their royalities % to a donation address, it means that on every secondary trade, a % of the royalities will go towards the donation address the artist has defined while minting.

Tokens that donate royalities, will get displayed with a banner stating the cause:

banner

if you want to check the address(es) the donations go to, simply click on the "royalities %"

sec_01

a pop up will show you the addresses set for royalities

sec_02


For the curious ones and all the blockchain fanatics: how to identify these shares on the blockchain explorer ... read on here:

checking shares on TzKT

If you are collecting pieces swapped by their artist (=primary market) you can check if a "split" goes towards a donation wallet by looking at tezos blockchain explorer.

Similar to checking Teias split contracts on chain for verifying the split addresses and their shares we will need to take a look at the blockchain because objktcoms UI doesnt yet show primary splits in their user interface.

First lets go to the token page on objktcom, scroll down and open the "history" tab (1) of said token, and look for the "listing" action in the history. to the very right of that operation you can see a link symbol (2). click it!

01

This is where it should land you: TzKTs page for this blockchain event. on the left, you can see theres two things happening with the listing operation: "update_operators" and "ask". what we are looking for is the "ask" one (3), for primary listings click on that and then click on the "storage" symbol (4) for that operation. a new window should pop up.

02

and here we are! under "amount" you can see how many shares go towards which address (5). in the first example, all shares available go towards the donation contract for "TezQuakeAid"

ATTENTION: for secondary listings the "parameters" in the storage tab will only give you the shares of secondary royalities

03

in the second one 8770 shares go towards the donation address and 980 shares go towards the artists own wallet. if we want to get the % we just have to divide the two: 10% for the artist, 90% for the fundraiser.

03 2

Clone this wiki locally