Technical and product requirements

Design

• Market with Cardano assets (NFTs)

• Offers participation on the market to 3rd parties

• Offers to use contract in own market

• There is a fixed fee of 2.5% that is distributed between all parties, that participated in successful trade

• All datums should be compatible with original the contract designed by Vacuumlabs (verified by Cbor serialization)

Fees and royalty calculation

• 10% to JoB

• 20% listing marketplace

• 20% listing affiliate (can be same as a marketplace)

• 50% to selling marketplace, which can be divided into many records (affiliates)

• Royalty

The calculation for price 100 ADA, and a typical set of treasuries and 5% royalty:

• 92.5 ADA to the seller (100 - 2.5 (fees) - 5 (5% royalty) )

• 0.25 ADA to JoB treasury (100 _ 0.25 _ 0.1)

• 0.5 ADA to listing marketplace treasury(100 _ 0.025 _ 0.2)

• 0.5 ADA to listing affiliate treasury (100 _ 0.025 _ 0.2)

• 0.625 ADA to selling marketplace treasury (100 _ 0.25 _ 0.25)

• 0.625 ADA to selling affiliate treasury (100 _ 0.25 _ 0.25)

• 5 ADA to royalty treasury (100 * 0.05)

Tech specs

• It is not necessary to mint values

• There is an option to produce treasury during a transaction

• There is an option to consume treasury

• Logic is divided between Treasury the contract and function contracts (InstantBuy/Offer)

Mint

Simple contract, that checks argument OutputReference is present on inputs. The purpose is only for minting disposable assets (for treasury validation method)

Staking

A simple contract that is validated same as the Withdrawal method, which is passed as an argument. The second argument is just salt for PolicyId It is a stake address that can be withdrawn by the wallet/token holder

Treasury

Common contract where user can collect ADA value during interacting with NFT market. There are two purposes:

• Use the treasury in transaction

• Withdraw treasury

The contract holds information about the withdrawal method in datum

Usage in transaction

Typical usage of the treasury is, that the original UTxO is spending during the transaction and a new one is created on output. The diff between output and input is provision.

• Check, that the count of UTxOs with the same script hash and datum like spending UTxO is equal to one (there is no need to spend more than one)

• Check, that the count of UTxOs with the same address (payment credential and spending credential) is equal to One (it is not possible to burn it or change stake address)

• Check, that the output ADA on UTxO is bigger than the input ADA

• Check, that the output values of ADA are bigger than the defined minimal value

• Check, that treasury UTxOs do not contain another asset except ADA

Usage during withdrawal

There are two validation mechanisms, depending on the type of treasury:

• by payment credential

• by validation token

• Check, that the validation mechanism is valid

• Check that outputs UTxOs is bigger than a minimal value

• The number of the same treasury (credential, datum, stake) is present on the input and output

• The number of output treasury (credential, datum, stake) can be reduced to 5 (another can be spent without creating new ones)

Instant buy

Contract for buying NFTs

There are two purposes:

• Accept

• Cancel

The validator has params

validator(
  treasury_script_hash: Hash<Blake2b_224, credential.Script>, // Reference to treasury validator
  stake_addresses: List<credential.StakeCredential>,          // List of accepted JoB stake address
  job: types.WithdrawalMethod,                                // JoB treasury, what is present in each transaction
)

Information about price, royalty etc., are stored in datum

Accept

• Check, that the ADA sent to a user is correct

• Check, that all provisions are correct

• Check, that the basis of royalty is not lower than the minimal value

• Check, that portions defined in the redeemer are correct

• If the royalty (payment credential) is the same as the seller's address, the royalty is not paid to a treasury, but directly to the seller's address

Cancel

The transaction is signed by stored payment credentials There is no other check for the spending contract

Offer

Is very similar to instant buying instead of a final check to pay assets/ADA to the offerer's address.

Information about price, royalty etc., are stored in datum