FrostFS API Golang repository contains implementation of core FrostFS structures that can be used for integration with FrostFS.
Find a file
alexvanin 6ad2e90d82 dep: Update neofs-crypto library to v0.3.0
New version of neofs-crypto library fixes bug
with `SignRFC6979()` function. This function
used in accounting library to sign withdraw cheque.
2020-03-02 13:59:31 +03:00
.github Add CODECOV_TOKEN 2019-11-21 14:09:44 +03:00
accounting accounting: Use little endian in number encoding 2020-02-11 16:54:43 +03:00
bootstrap update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
chain prepare to rename neofs-proto to neofs-api 2020-01-30 16:35:30 +03:00
container update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
decimal update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
docs Response meta header 2020-02-13 18:10:46 +03:00
hash prepare to rename neofs-proto to neofs-api 2020-01-30 16:35:30 +03:00
internal initial 2019-11-18 16:34:06 +03:00
object Response meta header 2020-02-13 18:10:46 +03:00
query update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
refs update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
service Implement Epoch and Version setters on ResponseMetaHeader 2020-02-14 12:17:48 +03:00
session update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
state Add tests for EncodeMetrics and DecodeMetrics 2020-02-10 15:36:28 +03:00
storagegroup update proto files, regenerate pb.go 2020-02-05 16:58:06 +03:00
.gitattributes initial 2019-11-18 16:34:06 +03:00
.gitignore initial 2019-11-18 16:34:06 +03:00
CHANGELOG.md Update changelog for v0.4.0 2020-02-18 12:04:09 +03:00
go.mod dep: Update neofs-crypto library to v0.3.0 2020-03-02 13:59:31 +03:00
go.sum dep: Update neofs-crypto library to v0.3.0 2020-03-02 13:59:31 +03:00
LICENSE.md initial 2019-11-18 16:34:06 +03:00
Makefile Refactoring Makefile 2020-02-10 14:49:39 +03:00
README.md Add badges 2020-02-05 13:55:07 +03:00

NeoFS API

Go codecov Report GitHub release GitHub license


NeoFS API repository contains implementation of core NeoFS structures that can be used for integration with NeoFS.

Description

Repository contains 13 packages that implement NeoFS core structures. These packages mostly contain protobuf files with service and structure definitions or NeoFS core types with complemented functions.

There is a auto-generated documentation for protobuf files in docs.

Accounting

Accounting package defines services and structures for accounting operations: balance request and cheque operations for withdraw. Cheque is a structure with inner ring signatures, which approve that user can withdraw requested amount of assets. NeoFS smart contract takes binary formatted cheque as a parameter in withdraw call.

API

Accounting package defines:

Bootstrap

Bootstrap package defines bootstrap service which is used by storage nodes to connect to the storage network.

API

Bootstrap package defines:

Chain

Chain package contains util functions for operations with NEO Blockchain types: wallet addresses, script-hashes.

Container

Container package defines service and structures for operations with containers. Objects in NeoFS are stored in containers. Container defines storage policy for the objects.

API

Bootstrap package defines:

Decimal

Decimal defines custom decimal implementation which is used in accounting operations.

Hash

Hash package defines homomorphic hash type.

Internal

Internal package defines constant error type and proto interface for custom protobuf structures.

Object

Object package defines service and structures for object operations. Object is a core storage structure in NeoFS. Package contains detailed information about object internal structure.

API

Object package defines:

Query

Query package defines structure for object search requests.

Refs

Refs package defines core identity types: Object ID, Container ID, etc.

Service

Service package defines util structure and functions for all NeoFS services operations: TTL and request signature management, node roles, epoch retriever.

Session

Session package defines service and structures for session obtain. Object operations require an established session with pair of session keys signed by owner of the object.

API

Session package defines:

State

State package defines service and structures for metrics gathering.

API

State package defines:

How to use

NeoFS API packages contain godoc documentation. Examples of using most of these packages can be found in NeoFS-CLI repository. CLI implements and demonstrates all basic interactions with NeoFS: container, object, storage group, and accounting operations.

Protobuf files are recompiled with the command:

$ make protoc

Contributing

At this moment, we do not accept contributions.

License

This project is licensed under the GPLv3 License - see the LICENSE.md file for details