/lsp-smart-contracts

The reference smart contract implementation in Solidity for the LUKSO LSP Standards.

Primary LanguageTypeScriptApache License 2.0Apache-2.0

LSP Smart Contracts · npm version Coverage Status All Contributors

The smart contracts reference implementation of the LUKSO Standard Proposals (LSPs).

For more information see Documentation on docs.lukso.tech.

⚠️ This package is currently in early stages of development,
use for testing or experimentation purposes only.

Packages

This repo contains packages for the Solidity implementation of the LSP smart contracts.

Package NPM Description
@lukso/lsp0-contracts npm version LSP0 ERC725Account
@lukso/lsp1-contracts npm version LSP1 Universal Receiver
@lukso/lsp1delegate-contracts npm version LSP1 Universal Receiver Delegate
@lukso/lsp2-contracts npm version LSP2 ERC725Y JSON Schema
@lukso/lsp3-contracts npm version LSP3 Profile Metadata
@lukso/lsp4-contracts npm version LSP4 Digital Asset Metadata
@lukso/lsp5-contracts npm version LSP5 Received Assets
@lukso/lsp6-contracts npm version LSP6 Key Manager
@lukso/lsp7-contracts npm version LSP7 Digital Asset
@lukso/lsp8-contracts npm version LSP8 Identifiable Digital Asset
@lukso/lsp9-contracts npm version LSP9 Vault
@lukso/lsp10-contracts npm version LSP10 Received Vaults
@lukso/lsp11-contracts npm version LSP11 Social Recovery
@lukso/lsp12-contracts npm version LSP12 Issued Assets
@lukso/lsp14-contracts npm version LSP14 Ownable 2 Step
@lukso/lsp16-contracts npm version LSP16 Universal Factory
@lukso/lsp17-contracts npm version LSP17 Extensions Package
@lukso/lsp17contractextension-contracts npm version LSP17 Contract Extension Package
@lukso/lsp20-contracts npm version LSP20 Call Verification
@lukso/lsp23-contracts npm version LSP23 Linked Contracts Factory
@lukso/lsp25-contracts npm version LSP25 Execute Relay Call
@lukso/lsp26-contracts npm version LSP26 Follower System
@lukso/universalprofile-contracts npm version Universal Profile

Installation

npm

All the LSP smart contracts are available as npm packages. You can either install all the LSP smart contracts by installing @lukso/lsp-smart-contracts or install the specific LSP that you might want from the list above. For instance, @lukso/lsp7-contracts to install only the LSP7 token contracts.

# Install all the LSPs
npm install @lukso/lsp-smart-contracts

# Install only the LSP7 tokens
npm install @lukso/lsp7-contracts

cloning the repository

Alternatively you can also clone the repository and install its dependencies to start using the smart contracts.

$ git clone https://github.com/lukso-network/lsp-smart-contracts.git
$ cd ./lsp-smart-contracts
$ npm install

Usage

See the README.md file of each individual package to learn more.

Testing

For detailed instructions on how to run tests, please refer to our Testing Guide.

Deployment via hardhat

You can find more infos on how to deploy the contracts via hardhat in the DEPLOYMENT page.


Audits

NB: dates of the audit reports use the american date format YYYY-MM-DD.

The following audits and formal verification were conducted. All high-level issues were addressed, or were not deemed as critical.

Contribute

The implementation contracts of the LSPs exist thanks to their contributors. There are many ways you can participate and help build high quality software. Check out the contribution guidelines!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Jean Cvllr
Jean Cvllr

💻
Yamen Merhi
Yamen Merhi

💻
Fabian Vogelsteller
Fabian Vogelsteller

💻
b00ste.lyx
b00ste.lyx

💻
Matthew Stevens
Matthew Stevens

💻
Reto Ryter
Reto Ryter

🔧 🚇
Callum Grindle
Callum Grindle

👀
Skima Harvey
Skima Harvey

💻
Jenea Vranceanu
Jenea Vranceanu

💻
Hugo Masclet
Hugo Masclet

👀 💻
Leondroid
Leondroid

👀
lucasmt
lucasmt

🐛
qian-hu
qian-hu

🛡️ 🐛
Magali Morin
Magali Morin

💻
Hugo Montenegro
Hugo Montenegro

📖
Volodymyr Lykhonis
Volodymyr Lykhonis

💻
Prosperity
Prosperity

📖
Michael Standen
Michael Standen

💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!