2020-10-27 12:41:47 +00:00
|
|
|
<p align="center">
|
|
|
|
|
<img src="./.github/logo.svg" width="500px" alt="NeoFS">
|
|
|
|
|
</p>
|
|
|
|
|
<p align="center">
|
|
|
|
|
<a href="https://fs.neo.org">NeoFS</a> related smart contracts.
|
|
|
|
|
</p>
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2020-10-27 12:41:47 +00:00
|
|
|
---
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2020-10-27 12:41:47 +00:00
|
|
|
# Overview
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2020-10-27 12:41:47 +00:00
|
|
|
NeoFS-Contract contains all NeoFS related contracts written for
|
|
|
|
|
[neo-go](https://github.com/nspcc-dev/neo-go) compiler. These contracts
|
2022-04-14 11:56:51 +00:00
|
|
|
are deployed both in the mainchain and the sidechain.
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2022-04-14 11:56:51 +00:00
|
|
|
Mainchain contracts:
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2020-10-27 12:41:47 +00:00
|
|
|
- neofs
|
2021-04-21 06:44:44 +00:00
|
|
|
- processing
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2022-04-14 11:56:51 +00:00
|
|
|
Sidechain contracts:
|
2020-03-30 13:59:54 +00:00
|
|
|
|
2020-12-29 11:32:37 +00:00
|
|
|
- alphabet
|
2020-10-27 12:41:47 +00:00
|
|
|
- audit
|
|
|
|
|
- balance
|
|
|
|
|
- container
|
|
|
|
|
- neofsid
|
|
|
|
|
- netmap
|
2021-07-22 17:54:54 +00:00
|
|
|
- nns
|
2021-03-22 06:18:33 +00:00
|
|
|
- proxy
|
2020-10-27 12:41:47 +00:00
|
|
|
- reputation
|
2021-12-07 12:06:43 +00:00
|
|
|
- subnet
|
2020-10-27 12:41:47 +00:00
|
|
|
|
|
|
|
|
# Getting started
|
|
|
|
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
|
|
|
|
|
To compile smart contracts you need:
|
|
|
|
|
|
2022-10-17 15:35:00 +00:00
|
|
|
- [neo-go](https://github.com/nspcc-dev/neo-go) >= 0.99.2
|
2020-10-27 12:41:47 +00:00
|
|
|
|
|
|
|
|
## Compilation
|
|
|
|
|
|
2022-04-14 11:56:51 +00:00
|
|
|
To build and compile smart contract, run `make all` command. Compiled contracts
|
2020-10-27 12:41:47 +00:00
|
|
|
`*_contract.nef` and manifest `config.json` files are placed in the
|
|
|
|
|
corresponding directories.
|
2020-03-30 13:59:54 +00:00
|
|
|
|
|
|
|
|
```
|
2020-10-27 12:41:47 +00:00
|
|
|
$ make all
|
2021-12-07 12:06:43 +00:00
|
|
|
/home/user/go/bin/cli contract compile -i alphabet -c alphabet/config.yml -m alphabet/config.json -o alphabet/alphabet_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i audit -c audit/config.yml -m audit/config.json -o audit/audit_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i balance -c balance/config.yml -m balance/config.json -o balance/balance_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i container -c container/config.yml -m container/config.json -o container/container_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i neofsid -c neofsid/config.yml -m neofsid/config.json -o neofsid/neofsid_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i netmap -c netmap/config.yml -m netmap/config.json -o netmap/netmap_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i proxy -c proxy/config.yml -m proxy/config.json -o proxy/proxy_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i reputation -c reputation/config.yml -m reputation/config.json -o reputation/reputation_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i subnet -c subnet/config.yml -m subnet/config.json -o subnet/subnet_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i nns -c nns/config.yml -m nns/config.json -o nns/nns_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i neofs -c neofs/config.yml -m neofs/config.json -o neofs/neofs_contract.nef
|
|
|
|
|
/home/user/go/bin/cli contract compile -i processing -c processing/config.yml -m processing/config.json -o processing/processing_contract.nef
|
2020-03-30 13:59:54 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can specify path to the `neo-go` binary with `NEOGO` environment variable:
|
|
|
|
|
|
|
|
|
|
```
|
2020-10-27 12:41:47 +00:00
|
|
|
$ NEOGO=/home/user/neo-go/bin/neo-go make all
|
2020-03-30 13:59:54 +00:00
|
|
|
```
|
|
|
|
|
|
2020-12-29 11:32:37 +00:00
|
|
|
Remove compiled files with `make clean` or `make mr_proper` command.
|
2020-10-27 12:41:47 +00:00
|
|
|
|
2022-10-31 15:48:26 +00:00
|
|
|
## Building Debian package
|
|
|
|
|
|
|
|
|
|
To build Debian package containing compiled contracts, run `make debpackage`
|
|
|
|
|
command. Package will install compiled contracts `*_contract.nef` and manifest
|
|
|
|
|
`config.json` with corresponding directories to `/var/lib/neofs/contract` for
|
|
|
|
|
further usage.
|
|
|
|
|
It will download and build neo-go, if needed.
|
|
|
|
|
|
|
|
|
|
To clean package-related files, use `make debclean`.
|
|
|
|
|
|
2021-10-04 12:08:37 +00:00
|
|
|
# Testing
|
|
|
|
|
Smartcontract tests reside in `tests/` directory. To execute test suite
|
2022-04-14 11:56:51 +00:00
|
|
|
after applying changes, simply run `make test`.
|
2021-10-04 12:08:37 +00:00
|
|
|
```
|
|
|
|
|
$ make test
|
|
|
|
|
ok github.com/nspcc-dev/neofs-contract/tests 0.462s
|
|
|
|
|
```
|
|
|
|
|
|
2021-07-01 17:20:46 +00:00
|
|
|
# NeoFS API compatibility
|
|
|
|
|
|
2022-10-17 15:35:00 +00:00
|
|
|
| neofs-contract version | supported NeoFS API versions |
|
|
|
|
|
|:----------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
|
|
|
|
| v0.9.x | [v2.7.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.7.0), [v2.8.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.8.0) |
|
|
|
|
|
| v0.10.x | [v2.7.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.7.0), [v2.8.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.8.0) |
|
|
|
|
|
| v0.11.x | [v2.7.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.7.0), [v2.8.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.8.0), [v2.9.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.9.0) |
|
|
|
|
|
| v0.12.x | [v2.10.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.10.0) |
|
|
|
|
|
| v0.13.x | [v2.11.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.11.0) |
|
|
|
|
|
| v0.14.x | [v2.11.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.11.0) |
|
|
|
|
|
| v0.15.x | [v2.11.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.11.0), [v2.12.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.12.0) |
|
|
|
|
|
| v0.15.x | [v2.11.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.11.0), [v2.12.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.12.0) |
|
|
|
|
|
| v0.16.x | [v2.14.0](https://github.com/nspcc-dev/neofs-api/releases/tag/v2.14.0) |
|
2021-07-01 17:20:46 +00:00
|
|
|
|
2020-10-27 12:41:47 +00:00
|
|
|
|
|
|
|
|
# License
|
2020-03-30 13:59:54 +00:00
|
|
|
|
|
|
|
|
This project is licensed under the GPLv3 License - see the
|
|
|
|
|
[LICENSE.md](LICENSE.md) file for details
|
