fxhash comes with built-in tools so that the work that is the fruit of a collaboration between many artists can be released in the best possible conditions. We provides a collaboration factory contract which can be used to originate collaboration contracts between any number of entities.
What's a collaboration contract ?
A collaboration contract allows entities to create, approve and send operations to the blockchain as a group. Creating a collaboration contract doesn't bind the different parties together but sending operations through the collaboration contract is binding. An operation can be sent through a collaboration contract if and only if all the parties have approved the transaction. Only then the transaction can be executed by any member of the collaboration. Not all the transactions are made available through the collaboration contract but only a list of operations provided by fxhash. This ensures that the transactions that are sent through the collaboration contract are safe to be sent.
How to create a collaboration ?
Anyone can create a collaboration by going to the collaborations page. You need to add all the collaboration members to the form.
The shares will be used in case some funds are sent to the contract (if other marketplaces were to pay royalties directly to the collaboration contract for instance). We recommend leaving the default shares, so that the funds are equally split between all the members of the collaboration.
Please note that the shares of collaboration contract itself don't guarantee that the proceeds made by publishing the token through the collaboration will be split between all the parties. You still need to define how the proceeds will be split on the primary and secondary market at the creation of the generative token. By default if you author the piece as a collaboration, the UI will pre-fill the splits on primary and secondary so that each collaborator gets the same amount.
You can setup different splits if you author different pieces with the same collaboration contract for instance.
Integration on the platform
When fxhash detects that a work was published with a collaboration contract, it assigns all the members of the collaboration as authors. We tried to provide a seamless integration of the collaboration contracts as we feel that they play a major role in the development of our artistic community.
If a work is published as a collaboration, it will also appear on all the profiles of the collaborators.
How to send operations as a collaboration group ?
We tried to make the usage of the collaboration as transparent as possible for you. For instance, you can edit the settings of a token as you would do if you were its only author, but instead of sending the update operation directly it creates a proposal in the collaboration contract itself.
The collaboration manager
When you go to your collaborations page, you will see all your collaborations. By clicking on each of them, you will access a page to manage the collaboration. There are 3 tabs on this page:
- operations awaiting: operations not sent to the blockchain yet
- operations executed: operations previously approved and executed
- informations: extra informations about the collab, such as the shares, the contract balance and a button to withdraw the funds
Inspecting an operation
Operations can be inspected before getting approved. By clicking on the operation type, you can toggle a preview which will show what the operation will do in an elegant manner:
You can also check the exact call parameters if you want to be sure of what you are approving.
You must be very careful when approving an operation on a collaboration contract, and make sure that you agree with its application. Our UI makes it easy to inspect those operations, and you should review those thoroughly.
Approving and executing
By default, the initiator of the operation will be marked as approving the operation. All the other members will have to approve it before it can be executed. You can approve/reject an operation by clicking on the corresponding buttons. Approving and rejecting are not definitive, and as long as the operation is not executed you can still change your vote. Once all the members have approved, the
execute operation button will be enabled and any member will be able to execute the operation.
By clicking the button, it will execute the operation, and voilà !
Projects authored as a collaboration
When a project is created through a collaboration contract, the address of the contract is stored as the author onchain. And since the members of a collaboration own the collaboration contract, they are indirectly co-authors by definition.
On the fxhash website, when you edit a project co-authored, it will automatically create proposals in the collaboration contract (displayed in the operations awaiting section of the manager).
There are some extra costs that come with using a collaboration contract. First, the contract needs to be originated. Then, each operation needs to be stored twice, for the creation of the proposal (where the parameters are stored onchain) and for its execution (same cost as if you were to send the same operation by yourself).
We recommend splitting those costs by having different members creating and executing an operation.