Skip to content
This repository has been archived by the owner on Jun 17, 2022. It is now read-only.
/ fracada Public archive

Fractionalized Cardano NFT protocol in Plutus.

License

Notifications You must be signed in to change notification settings

dcSpark/fracada

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fracada V1 (deprecated - see V2 link below)

Plutus dApp which enables users to fractionalize their NFTs.

license

This repository is deperecated and replaced by Fracada V2

Disclaimer

The code on this repository has not been audited. We don't recommend it using in production without a full security audit. Use it at your own risk!.

Protocol

This contract locks an NFT and mints a number of tokens representing fractions of it. To get the NFT back, the fraction tokens are burned.

The protocol has three steps:

  1. Locking the NFT: The NFT is paid to the contract
  2. Mint tokens: Fraction tokens are minted (must be run by the same person who performed step 1).
  3. Return the NFT: Burning all the fraction tokens will allow the user to redeem the NFT back.

Testing On Plutus Playground

The Fracada.hs content can be pasted on the Plutus Playground and executed directly in the simulator ( tested and compiled against Plutus release tag plutus-pab/v0.0.2 ).

Building

To build the project execute cabal build at the project root. (NOTE: To build, the easiest way is for now, to clone Plutus do nix-shell on the root of it and then cd to this repo)

To build:

$ cabal configure --enable-tests --enable-executable-dynamic -f -external-libsodium-vrf
$ cabal build

Testing

To run use-case test execute the following commands at the project root.

$ cabal run -- fracada-test # or cabal test
Up to date
use cases
  fracada
    Expose '1-fractionNFT' and '2-returnNFT' endpoints: OK (0.12s)
    Can lock NFT and mint fractionalize tokens:         OK

All 2 tests passed (0.14s)

Dumping Transactions

Dumping transaction for debug purpose ran the following command at the project root:

$ cabal run fracada-scripts --  ./tmp transactions -p scripts/protocol-parameters.json
...
Writing transactions to: ./tmp
Writing partial transaction JSON: ./tmp/fracada-success-1.json

Deployable Scripts

To generate the scripts to deploy on-chain simply run: cabal run script-dump <NFT currency symbol> <NFT token name> <Fraction token name> <number of fractions>

This will create validator.plutus and minting.plutus with the cbor dump of the scripts ready to be submitted in a transaction.

About

Fractionalized Cardano NFT protocol in Plutus.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published