[#71] Stop using obsolete .github directory

This commit is a part of multi-repo cleanup effort:
TrueCloudLab/frostfs-infra#136

Signed-off-by: Vitaliy Potyarkin <v.potyarkin@yadro.com>

.forgejo/markdown.tmpl

@@ -4,11 +4,11 @@
 ## Table of Contents
 {{range .Files}}
 {{$file_name := .Name}}- [{{.Name}}](#{{.Name}})
-{{if .Services}} - Services
-    {{range .Services}}- [{{.Name}}](#{{.FullName}})
+{{if .Services}}  - Services
+    {{range .Services}}  - [{{.Name}}](#{{.FullName}})
     {{end}}{{end}}
 {{if .Messages}}  - Messages
-    {{range .Messages}}- [{{.LongName}}](#{{.FullName}})
+    {{range .Messages}}  - [{{.LongName}}](#{{.FullName}})
     {{end}}{{end}}
 {{end}}
 - [Scalar Value Types](#scalar-value-types)

.forgejo/workflows/dco.yaml

@@ -0,0 +1,19 @@
+name: DCO action
+on: [pull_request]
+
+jobs:
+  dco:
+    name: DCO
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Setup Go
+        uses: actions/setup-go@v3
+        with:
+          go-version: '1.22'
+      - name: Run commit format checker
+        uses: https://git.frostfs.info/TrueCloudLab/dco-go@v3
+        with:
+          from: 'origin/${{ github.event.pull_request.base.ref }}'

.forgejo/workflows/fmt.yaml

@@ -0,0 +1,17 @@
+name: Formatters
+on: [pull_request]
+
+jobs:
+  fmt:
+    name: Run fmt
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install deps
+        run: |
+          apt update
+          apt install -y clang-format
+      - name: Run fmt
+        run: |
+          make fmt
+          git diff --exit-code --quiet

.forgejo/workflows/pre-commit.yaml

@@ -0,0 +1,18 @@
+name: Pre-commit hooks
+on: [pull_request]
+
+jobs:
+  pre-commit:
+    name: Pre-commit
+    env:
+      # Skip pre-commit hooks which are executed by other actions.
+      SKIP: make-fmt
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install deps
+        run: |
+          apt update
+          apt install -y pre-commit
+      - name: Run pre-commit
+        run: pre-commit run --all-files --hook-stage manual --color=always

.github/CODEOWNERS

@@ -1 +0,0 @@
-*   @alexvanin @realloc @fyrchik @anatoly-bogatyrev

.github/workflows/buf.yml

@@ -1,36 +0,0 @@
-name: Buf lint
-
-on:
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  lint:
-    runs-on: ubuntu-20.04
-    steps:
-      - uses: actions/checkout@v2
-      - uses: wizhi/setup-buf@v1
-        with:
-          version: 0.20.5
-      - run: buf check lint
-
-  breaking:
-    runs-on: ubuntu-20.04
-    steps:
-      - name: Setup buf
-        uses: wizhi/setup-buf@v1
-        with:
-          version: 0.20.5
-      - name: Check out ref code
-        uses: actions/checkout@v2
-        with:
-          ref: ${{ github.base_ref }}
-          path: baseref
-      - run: cd baseref && buf image build -o image.bin
-
-      - name: Check out code
-        uses: actions/checkout@v2
-        with:
-          path: prclone
-      - run: cd prclone && buf check breaking --against-input ../baseref/image.bin

.github/workflows/dco.yml

@@ -1,21 +0,0 @@
-name: DCO check
-
-on:
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  commits_check_job:
-    runs-on: ubuntu-latest
-    name: Commits Check
-    steps:
-    - name: Get PR Commits
-      id: 'get-pr-commits'
-      uses: tim-actions/get-pr-commits@master
-      with:
-        token: ${{ secrets.GITHUB_TOKEN }}
-    - name: DCO Check
-      uses: tim-actions/dco@master
-      with:
-        commits: ${{ steps.get-pr-commits.outputs.commits }}

.gitignore

@@ -1,2 +1 @@
 .idea
-

.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: check-merge-conflict
+      - id: check-json
+      - id: check-xml
+      - id: check-yaml
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+        exclude: ".svg$"
+
+  - repo: local
+    hooks:
+      - id: make-fmt
+        name: Run make fmt
+        entry: make fmt
+        language: system
+        pass_filenames: false

CHANGELOG.md

@@ -9,6 +9,7 @@
 ### Removed
 - Reputation system (#22)
 - All `subnet` related fields and types (#25)
+- Storage group (#19)
 
 ## [2.14.0] - 2022-09-23 - Anmado (안마도, 鞍馬島)
 
@@ -60,7 +61,7 @@ Network magic, main status codes, object locks and notifications.
 - `LOCK` value of `object.Type` enum (#194)
 - `Lock` message with payload content of `LOCK` objects (#194)
 - `LOCKED` and `LOCK_NON_REGULAR_OBJECT` status codes to `Object` section (#194)
-- `scheme` field of type `SignatureScheme` to `Signature` message which determines 
+- `scheme` field of type `SignatureScheme` to `Signature` message which determines
   signature scheme (#55)
 - `SignatureRFC6979` message (#203)
 
@@ -165,8 +166,8 @@ values in the objects.
 
 ### Changed
 
-- Clarified processing of empty search query in `object.Search` RPC. 
-- Specified connection of tombstone expiration value with well-known 
+- Clarified processing of empty search query in `object.Search` RPC.
+- Specified connection of tombstone expiration value with well-known
   `__NEOFS__EXPIRATION_EPOCH` object attribute.
 
 ## [2.3.0] - 2021-02-11 - Seonyudo (선유도, 仙遊島)

CODEOWNERS

@@ -0,0 +1 @@
+.*   @alexvanin @realloc @fyrchik @a.bogatyrev

CONTRIBUTING.md

@@ -3,8 +3,8 @@
 First, thank you for contributing! We love and encourage pull requests from
 everyone. Please follow the guidelines:
 
-- Check the open [issues](https://github.com/TrueCloudLab/frostfs-api/issues) and
-  [pull requests](https://github.com/TrueCloudLab/frostfs-api/pulls) for existing
+- Check the open [issues](https://git.frostfs.info/TrueCloudLab/frostfs-api/issues) and
+  [pull requests](https://git.frostfs.info/TrueCloudLab/frostfs-api/pulls) for existing
   discussions.
 
 - Open an issue first, to discuss a new feature or enhancement.
@@ -25,19 +25,20 @@ Start by forking the `frostfs-api` repository, make changes in a branch and then
 send a pull request. We encourage pull requests to discuss code changes. Here
 are the steps in details:
 
-### Set up your GitHub Repository
-Fork [NeoFS node upstream](https://github.com/TrueCloudLab/frostfs-api/fork) source
+### Set up your repository
+
+Fork [FrostFS upstream](https://git.frostfs.info/TrueCloudLab/frostfs-api/fork) source
 repository to your own personal repository. Copy the URL of your fork (you will
 need it for the `git clone` command below).
 
 ```sh
-$ git clone https://github.com/TrueCloudLab/frostfs-api
+$ git clone https://git.frostfs.info/TrueCloudLab/frostfs-api
 ```
 
 ### Set up git remote as ``upstream``
 ```sh
 $ cd frostfs-api
-$ git remote add upstream https://github.com/TrueCloudLab/frostfs-api
+$ git remote add upstream https://git.frostfs.info/TrueCloudLab/frostfs-api
 $ git fetch upstream
 $ git merge upstream/master
 ...
@@ -86,7 +87,7 @@ $ git push origin feature/123-something_awesome
 ```
 
 ### Create a Pull Request
-Pull requests can be created via GitHub. Refer to [this
+Pull requests can be created via git.frostfs.info. Refer to [this
 document](https://help.github.com/articles/creating-a-pull-request/) for
 detailed steps on how to create a pull request. After a Pull Request gets peer
 reviewed and approved, it will be merged.

Makefile

@@ -1,21 +1,35 @@
 #!/usr/bin/make -f
 SHELL=bash
 
-# BRanch to match for BReaking changes
-BRBR?=master
+include help.mk
 
-.PHONY: lint
-lint:
-	buf check lint
-	buf check breaking --against-input '.git#branch=$(BRBR)'
+.PHONY: doc fmt pre-commit unpre-commit pre-commit-run
 
-.PHONY: doc
 # Regenerate documentation for proto files:
 doc:
 	@for f in `find . -type f -name '*.proto' -exec dirname {} \; | sort -u `; do \
 		echo "⇒ Documentation for $$(basename $$f)"; \
 		protoc \
-			--doc_opt=.github/markdown.tmpl,$${f}.md \
+			--doc_opt=.forgejo/markdown.tmpl,$${f}.md \
 			--proto_path=.:/usr/local/include \
 			--doc_out=proto-docs/ $${f}/*.proto; \
 	done
+
+# Run clang-format
+fmt:
+	@for f in `ls **/*.proto`; do \
+		echo "⇒ Formatting $$f"; \
+		clang-format -i $$f; \
+	done
+
+# Activate pre-commit hooks
+pre-commit:
+	pre-commit install --hook-type pre-commit
+
+# Deactivate pre-commit hooks
+unpre-commit:
+	pre-commit uninstall --hook-type pre-commit
+
+# Run pre-commit hooks
+pre-commit-run:
+	@pre-commit run --all-files --hook-stage manual

README.md

@@ -1,19 +1,18 @@
 <p align="center">
-<img src="./.github/logo.svg" width="500px" alt="FrostFS">
+<img src="./.forgejo/logo.svg" width="500px" alt="FrostFS">
 </p>
 <p align="center">
-  <a href="https://objectstorage.info">FrostFS</a> API language-agnostic protocol definitions
+  <a href="https://frostfs.info">FrostFS</a> API language-agnostic protocol definitions
 </p>
 
 ---
-![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/TrueCloudLab/frostfs-api?sort=semver)
-![License](https://img.shields.io/github/license/TrueCloudLab/frostfs-api.svg?style=popout)
+![Release](https://git.frostfs.info/TrueCloudLab/frostfs-api/badges/release.svg)
 
 ## Overview
 
 FrostFS-API repository is the basis for language-specific libraries, e.g.:
 
-- [frostfs-api-go](https://github.com/TrueCloudLab/frostfs-api-go)
+- [frostfs-api-go](https://git.frostfs.info/TrueCloudLab/frostfs-api-go)
 
 Those libraries contain compiled protocol buffers definitions, wrapped with
 language-specific code. Use them to integrate applications with FrostFS.

accounting/service.proto

@@ -9,27 +9,27 @@ import "accounting/types.proto";
 import "refs/types.proto";
 import "session/types.proto";
 
-// Accounting service provides methods for interaction with NeoFS sidechain via
-// other NeoFS nodes to get information about the account balance. Deposit and
-// Withdraw operations can't be implemented here, as they require Mainnet NeoFS
-// smart contract invocation. Transfer operations between internal NeoFS
-// accounts are possible if both use the same token type.
+// Accounting service provides methods for interaction with FrostFS sidechain
+// via other FrostFS nodes to get information about the account balance. Deposit
+// and Withdraw operations can't be implemented here, as they require Mainnet
+// FrostFS smart contract invocation. Transfer operations between internal
+// FrostFS accounts are possible if both use the same token type.
 service AccountingService {
-  // Returns the amount of funds in GAS token for the requested NeoFS account.
+  // Returns the amount of funds in GAS token for the requested FrostFS account.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS):
   // balance has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON).
-  rpc Balance (BalanceRequest) returns (BalanceResponse);
+  rpc Balance(BalanceRequest) returns (BalanceResponse);
 }
 
 // BalanceRequest message
 message BalanceRequest {
   // To indicate the account for which the balance is requested, its identifier
-  // is used. It can be any existing account in NeoFS sidechain `Balance` smart
-  // contract. If omitted, client implementation MUST set it to the request's
-  // signer `OwnerID`.
+  // is used. It can be any existing account in FrostFS sidechain `Balance`
+  // smart contract. If omitted, client implementation MUST set it to the
+  // request's signer `OwnerID`.
   message Body {
     // Valid user identifier in `OwnerID` format for which the balance is
     // requested. Required field.
@@ -51,7 +51,8 @@ message BalanceRequest {
 // BalanceResponse message
 message BalanceResponse {
   // The amount of funds in GAS token for the `OwnerID`'s account requested.
-  // Balance is given in the `Decimal` format to avoid precision issues with rounding.
+  // Balance is given in the `Decimal` format to avoid precision issues with
+  // rounding.
   message Body {
     // Amount of funds in GAS token for the requested account.
     Decimal balance = 1;

accounting/types.proto

@@ -5,7 +5,7 @@ package neo.fs.v2.accounting;
 option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/accounting/grpc;accounting";
 option csharp_namespace = "Neo.FileStorage.API.Accounting";
 
-// Standard floating point data type can't be used in NeoFS due to inexactness
+// Standard floating point data type can't be used in FrostFS due to inexactness
 // of the result when doing lots of small number operations. To solve the lost
 // precision issue, special `Decimal` format is used for monetary computations.
 //
@@ -14,9 +14,9 @@ option csharp_namespace = "Neo.FileStorage.API.Accounting";
 // description.
 message Decimal {
   // Number in the smallest Token fractions.
-  int64 value = 1 [json_name = "value"];
+  int64 value = 1 [ json_name = "value" ];
 
   // Precision value indicating how many smallest fractions can be in one
   // integer.
-  uint32 precision = 2 [json_name = "precision"];
+  uint32 precision = 2 [ json_name = "precision" ];
 }

acl/types.proto

@@ -6,6 +6,7 @@ option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/acl/grpc;ac
 option csharp_namespace = "Neo.FileStorage.API.Acl";
 
 import "refs/types.proto";
+import "ape/types.proto";
 
 // Target role of the access control rule in access control list.
 enum Role {
@@ -19,7 +20,8 @@ enum Role {
   // container or an inner ring node
   SYSTEM = 2;
 
-  // Others target rule is applied if sender is neither a user nor a system target
+  // Others target rule is applied if sender is neither a user nor a system
+  // target
   OTHERS = 3;
 }
 
@@ -87,18 +89,18 @@ enum HeaderType {
   // Filter object headers
   OBJECT = 2;
 
-  // Filter service headers. These are not processed by NeoFS nodes and
+  // Filter service headers. These are not processed by FrostFS nodes and
   // exist for service use only.
   SERVICE = 3;
 }
 
 // Describes a single eACL rule.
 message EACLRecord {
-  // NeoFS request Verb to match
-  Operation operation = 1 [json_name = "operation"];
+  // FrostFS request Verb to match
+  Operation operation = 1 [ json_name = "operation" ];
 
   // Rule execution result. Either allows or denies access if filters match.
-  Action action = 2 [json_name = "action"];
+  Action action = 2 [ json_name = "action" ];
 
   // Filter to check particular properties of the request or the object.
   //
@@ -132,48 +134,48 @@ message EACLRecord {
   // it's possible to take that information from the requested address.
   message Filter {
     // Define if Object or Request header will be used
-    HeaderType header_type = 1 [json_name = "headerType"];
+    HeaderType header_type = 1 [ json_name = "headerType" ];
 
     // Match operation type
-    MatchType match_type = 2 [json_name = "matchType"];
+    MatchType match_type = 2 [ json_name = "matchType" ];
 
     // Name of the Header to use
-    string key = 3 [json_name="key"];
+    string key = 3 [ json_name = "key" ];
 
     // Expected Header Value or pattern to match
-    string value = 4 [json_name="value"];
+    string value = 4 [ json_name = "value" ];
   }
 
   // List of filters to match and see if rule is applicable
-  repeated Filter filters = 3 [json_name="filters"];
+  repeated Filter filters = 3 [ json_name = "filters" ];
 
   // Target to apply ACL rule. Can be a subject's role class or a list of public
   // keys to match.
   message Target {
     // Target subject's role class
-    Role role = 1 [json_name="role"];
+    Role role = 1 [ json_name = "role" ];
 
     // List of public keys to identify target subject
-    repeated bytes keys = 2 [json_name="keys"];
+    repeated bytes keys = 2 [ json_name = "keys" ];
   }
   // List of target subjects to apply ACL rule to
-  repeated Target targets = 4 [json_name="targets"];
+  repeated Target targets = 4 [ json_name = "targets" ];
 }
 
 // Extended ACL rules table. A list of ACL rules defined additionally to Basic
 // ACL. Extended ACL rules can be attached to a container and can be updated
 // or may be defined in `BearerToken` structure. Please see the corresponding
-// NeoFS Technical Specification section for detailed description.
+// FrostFS Technical Specification section for detailed description.
 message EACLTable {
   // eACL format version. Effectively, the version of API library used to create
   // eACL Table.
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Identifier of the container that should use given access control rules
-  neo.fs.v2.refs.ContainerID container_id = 2 [json_name="containerID"];
+  neo.fs.v2.refs.ContainerID container_id = 2 [ json_name = "containerID" ];
 
   // List of Extended ACL rules
-  repeated EACLRecord records = 3 [json_name="records"];
+  repeated EACLRecord records = 3 [ json_name = "records" ];
 }
 
 // BearerToken allows to attach signed Extended ACL rules to the request in
@@ -183,44 +185,65 @@ message EACLTable {
 // used in the similar use cases, like providing authorisation to externally
 // authenticated party.
 //
-// BearerToken can be issued only by the container's owner and must be signed using
-// the key associated with the container's `OwnerID`.
+// BearerToken can be issued only by the container's owner and must be signed
+// using the key associated with the container's `OwnerID`.
 message BearerToken {
-  // Bearer Token body structure contains Extended ACL table issued by the container
-  // owner with additional information preventing token abuse.
+  // Bearer Token body structure contains Extended ACL table issued by the
+  // container owner with additional information preventing token abuse.
   message Body {
     // Table of Extended ACL rules to use instead of the ones attached to the
     // container. If it contains `container_id` field, bearer token is only
-    // valid for this specific container. Otherwise, any container of the same owner
-    // is allowed.
-    EACLTable eacl_table = 1 [json_name="eaclTable"];
+    // valid for this specific container. Otherwise, any container of the same
+    // owner is allowed.
+    //
+    // Deprecated: eACL tables are no longer relevant - `APEOverrides` should be
+    // used instead.
+    EACLTable eacl_table = 1 [ json_name = "eaclTable" ];
 
     // `OwnerID` defines to whom the token was issued. It must match the request
     // originator's `OwnerID`. If empty, any token bearer will be accepted.
-    neo.fs.v2.refs.OwnerID owner_id = 2 [json_name="ownerID"];
+    neo.fs.v2.refs.OwnerID owner_id = 2 [ json_name = "ownerID" ];
 
     // Lifetime parameters of the token. Field names taken from
     // [rfc7519](https://tools.ietf.org/html/rfc7519).
     message TokenLifetime {
       // Expiration Epoch
-      uint64 exp = 1 [json_name="exp"];
+      uint64 exp = 1 [ json_name = "exp" ];
 
       // Not valid before Epoch
-      uint64 nbf = 2 [json_name="nbf"];
+      uint64 nbf = 2 [ json_name = "nbf" ];
 
       // Issued at Epoch
-      uint64 iat = 3 [json_name="iat"];
+      uint64 iat = 3 [ json_name = "iat" ];
     }
     // Token expiration and valid time period parameters
-    TokenLifetime lifetime = 3 [json_name="lifetime"];
+    TokenLifetime lifetime = 3 [ json_name = "lifetime" ];
 
     // AllowImpersonate flag to consider token signer as request owner.
     // If this field is true extended ACL table in token body isn't processed.
-    bool allow_impersonate = 4 [json_name="allowImpersonate"];
+    bool allow_impersonate = 4 [ json_name = "allowImpersonate" ];
+
+    // APEOverride is the list of APE chains defined for a target.
+    // These chains are meant to serve as overrides to the already defined (or
+    // even undefined) APE chains for the target (see contract `Policy`).
+    //
+    // The server-side processing of the bearer token with set APE overrides
+    // must verify if a client is permitted to override chains for the target,
+    // preventing unauthorized access through the APE mechanism.
+    message APEOverride {
+      // Target for which chains are applied.
+      frostfs.v2.ape.ChainTarget target = 1 [ json_name = "target" ];
+
+      // The list of APE chains.
+      repeated frostfs.v2.ape.Chain chains = 2 [ json_name = "chains" ];
+    }
+
+    // APE override for the target.
+    APEOverride ape_override = 5 [ json_name = "apeOverride" ];
   }
   // Bearer Token body
-  Body body = 1 [json_name="body"];
+  Body body = 1 [ json_name = "body" ];
 
   // Signature of BearerToken body
-  neo.fs.v2.refs.Signature signature = 2 [json_name="signature"];
+  neo.fs.v2.refs.Signature signature = 2 [ json_name = "signature" ];
 }

ape/types.proto

@@ -0,0 +1,33 @@
+syntax = "proto3";
+
+package frostfs.v2.ape;
+
+option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/ape/grpc;ape";
+
+// TargetType is a type target to which a rule chain is defined.
+enum TargetType {
+  UNDEFINED = 0;
+
+  NAMESPACE = 1;
+
+  CONTAINER = 2;
+
+  USER = 3;
+
+  GROUP = 4;
+}
+
+// ChainTarget is an object to which a rule chain is defined.
+message ChainTarget {
+  TargetType type = 1;
+
+  string name = 2;
+}
+
+// Chain is a chain of rules defined for a specific target.
+message Chain {
+  oneof kind {
+    // Raw representation of a serizalized rule chain.
+    bytes raw = 1;
+  }
+}

apemanager/service.proto

@@ -0,0 +1,171 @@
+syntax = "proto3";
+
+package frostfs.v2.apemanager;
+
+import "ape/types.proto";
+import "session/types.proto";
+
+option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/apemanager/grpc;apemanager";
+
+// `APEManagerService` provides API to manage rule chains within sidechain's
+// `Policy` smart contract.
+service APEManagerService {
+  // Add a rule chain for a specific target to `Policy` smart contract.
+  //
+  // Statuses:
+  // - **OK** (0, SECTION_SUCCESS): \
+  //   the chain has been successfully added;
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  //   container (as target) not found;
+  // - **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  //   the operation is denied by the service.
+  rpc AddChain(AddChainRequest) returns (AddChainResponse);
+
+  // Remove a rule chain for a specific target from `Policy` smart contract.
+  // RemoveChain is an idempotent operation: removal of non-existing rule chain
+  // also means success.
+  //
+  // Statuses:
+  // - **OK** (0, SECTION_SUCCESS): \
+  //   the chain has been successfully removed;
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  //   container (as target) not found;
+  // - **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  //   the operation is denied by the service.
+  rpc RemoveChain(RemoveChainRequest) returns (RemoveChainResponse);
+
+  // List chains defined for a specific target from `Policy` smart contract.
+  //
+  // Statuses:
+  // - **OK** (0, SECTION_SUCCESS): \
+  //   chains have been successfully listed;
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  //   container (as target) not found;
+  // - **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  //   the operation is denied by the service.
+  rpc ListChains(ListChainsRequest) returns (ListChainsResponse);
+}
+
+message AddChainRequest {
+  message Body {
+    // A target for which a rule chain is added.
+    frostfs.v2.ape.ChainTarget target = 1;
+
+    // The chain to set for the target.
+    frostfs.v2.ape.Chain chain = 2;
+  }
+
+  // The request's body.
+  Body body = 1;
+
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+}
+
+message AddChainResponse {
+  message Body {
+    // Chain ID assigned for the added rule chain.
+    // If chain ID is left empty in the request, then
+    // it will be generated.
+    bytes chain_id = 1;
+  }
+
+  // The response's body.
+  Body body = 1;
+
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
+
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+}
+
+message RemoveChainRequest {
+  message Body {
+    // Target for which a rule chain is removed.
+    frostfs.v2.ape.ChainTarget target = 1;
+
+    // Chain ID assigned for the rule chain.
+    bytes chain_id = 2;
+  }
+
+  // The request's body.
+  Body body = 1;
+
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+}
+
+message RemoveChainResponse {
+  // Since RemoveChain is an idempotent operation, then the only indicator that
+  // operation could not be performed is an error returning to a client.
+  message Body {}
+
+  // The response's body.
+  Body body = 1;
+
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
+
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+}
+
+message ListChainsRequest {
+  message Body {
+    // Target for which rule chains are listed.
+    frostfs.v2.ape.ChainTarget target = 1;
+  }
+
+  // The request's body.
+  Body body = 1;
+
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+}
+
+message ListChainsResponse {
+  message Body {
+    // The list of chains defined for the reqeusted target.
+    repeated frostfs.v2.ape.Chain chains = 1;
+  }
+
+  // The response's body.
+  Body body = 1;
+
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
+
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+}

audit/types.proto

@@ -1,59 +0,0 @@
-syntax = "proto3";
-
-package neo.fs.v2.audit;
-
-option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/audit/grpc;audit";
-option csharp_namespace = "Neo.FileStorage.API.Audit";
-
-import "refs/types.proto";
-
-// DataAuditResult keeps record of conducted Data Audits. The detailed report is
-// generated separately.
-message DataAuditResult {
-  // Data Audit Result format version. Effectively, the version of API library
-  // used to report DataAuditResult structure.
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
-
-  // Epoch number when the Data Audit was conducted
-  fixed64 audit_epoch = 2 [json_name = "auditEpoch"];
-
-  // Container under audit
-  neo.fs.v2.refs.ContainerID container_id = 3 [json_name = "containerID"];
-
-  // Public key of the auditing InnerRing node in a binary format
-  bytes public_key = 4 [json_name = "publicKey"];
-
-  // Shows if Data Audit process was complete in time or if it was cancelled
-  bool complete = 5 [json_name = "complete"];
-
-  // Number of request done at PoR stage
-  uint32 requests = 6 [json_name = "requests"];
-
-  // Number of retries done at PoR stage
-  uint32 retries = 7 [json_name = "retries"];
-
-  // List of Storage Groups that passed audit PoR stage
-  repeated neo.fs.v2.refs.ObjectID pass_sg = 8 [json_name = "passSG"];
-
-  // List of Storage Groups that failed audit PoR stage
-  repeated neo.fs.v2.refs.ObjectID fail_sg = 9 [json_name = "failSG"];
-
-  // Number of sampled objects under the audit placed in an optimal way according to
-  // the containers placement policy when checking PoP
-  uint32 hit = 10 [json_name = "hit"];
-
-  // Number of sampled objects under the audit placed in suboptimal way according to
-  // the containers placement policy, but still at a satisfactory level when
-  // checking PoP
-  uint32 miss = 11 [json_name = "miss"];
-
-  // Number of sampled objects under the audit stored inconsistently with the
-  // placement policy or not found at all when checking PoP
-  uint32 fail = 12 [json_name = "fail"];
-
-  // List of storage node public keys that passed at least one PDP
-  repeated bytes pass_nodes = 13 [json_name = "passNodes"];
-
-  // List of storage node public keys that failed at least one PDP
-  repeated bytes fail_nodes = 14 [json_name = "failNodes"];
-}

buf.yaml

@@ -1,10 +0,0 @@
-lint:
-  use:
-    - DEFAULT
-    - COMMENTS
-    - ENUM_FIRST_VALUE_ZERO
-  except:
-    - PACKAGE_DIRECTORY_MATCH
-    - PACKAGE_VERSION_SUFFIX
-    - ENUM_VALUE_PREFIX
-    - ENUM_ZERO_VALUE_SUFFIX

container/service.proto

@@ -5,36 +5,39 @@ package neo.fs.v2.container;
 option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/container/grpc;container";
 option csharp_namespace = "Neo.FileStorage.API.Container";
 
-import "acl/types.proto";
 import "container/types.proto";
 import "refs/types.proto";
 import "session/types.proto";
 
 // `ContainerService` provides API to interact with `Container` smart contract
-// in NeoFS sidechain via other NeoFS nodes. All of those actions can be done
-// equivalently by directly issuing transactions and RPC calls to sidechain
+// in FrostFS sidechain via other FrostFS nodes. All of those actions can be
+// done equivalently by directly issuing transactions and RPC calls to sidechain
 // nodes.
 service ContainerService {
   // `Put` invokes `Container` smart contract's `Put` method and returns
   // response immediately. After a new block is issued in sidechain, request is
-  // verified by Inner Ring nodes. After one more block in sidechain, the container
-  // is added into smart contract storage.
+  // verified by Inner Ring nodes. After one more block in sidechain, the
+  // container is added into smart contract storage.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS): \
   //   request to save the container has been sent to the sidechain;
-  // - Common failures (SECTION_FAILURE_COMMON).
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   container create access denied.
   rpc Put(PutRequest) returns (PutResponse);
 
   // `Delete` invokes `Container` smart contract's `Delete` method and returns
   // response immediately. After a new block is issued in sidechain, request is
-  // verified by Inner Ring nodes. After one more block in sidechain, the container
-  // is added into smart contract storage.
+  // verified by Inner Ring nodes. After one more block in sidechain, the
+  // container is added into smart contract storage.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS): \
   //   request to remove the container has been sent to the sidechain;
-  // - Common failures (SECTION_FAILURE_COMMON).
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   container delete access denied.
   rpc Delete(DeleteRequest) returns (DeleteResponse);
 
   // Returns container structure from `Container` smart contract storage.
@@ -44,7 +47,9 @@ service ContainerService {
   //   container has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON);
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
-  //   requested container not found.
+  //   requested container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied.
   rpc Get(GetRequest) returns (GetResponse);
 
   // Returns all owner's containers from 'Container` smart contract' storage.
@@ -52,42 +57,13 @@ service ContainerService {
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS): \
   //   container list has been successfully read;
-  // - Common failures (SECTION_FAILURE_COMMON).
-  rpc List(ListRequest) returns (ListResponse);
-
-  // Invokes 'SetEACL' method of 'Container` smart contract and returns response
-  // immediately. After one more block in sidechain, changes in an Extended ACL are
-  // added into smart contract storage.
-  //
-  // Statuses:
-  // - **OK** (0, SECTION_SUCCESS): \
-  //   request to save container eACL has been sent to the sidechain;
-  // - Common failures (SECTION_FAILURE_COMMON).
-  rpc SetExtendedACL(SetExtendedACLRequest) returns (SetExtendedACLResponse);
-
-  // Returns Extended ACL table and signature from `Container` smart contract
-  // storage.
-  //
-  // Statuses:
-  // - **OK** (0, SECTION_SUCCESS): \
-  //   container eACL has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON);
-  // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
-  //   container not found;
-  // - **EACL_NOT_FOUND** (3073, SECTION_CONTAINER): \
-  //   eACL table not found.
-  rpc GetExtendedACL(GetExtendedACLRequest) returns (GetExtendedACLResponse);
-
-  // Announces the space values used by the container for P2P synchronization.
-  //
-  // Statuses:
-  // - **OK** (0, SECTION_SUCCESS): \
-  //   estimation of used space has been successfully announced;
-  // - Common failures (SECTION_FAILURE_COMMON).
-  rpc AnnounceUsedSpace(AnnounceUsedSpaceRequest) returns (AnnounceUsedSpaceResponse);
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   container list access denied.
+  rpc List(ListRequest) returns (ListResponse);
 }
 
-// New NeoFS Container creation request
+// New FrostFS Container creation request
 message PutRequest {
   // Container creation request has container structure's signature as a
   // separate field. It's not stored in sidechain, just verified on container
@@ -95,7 +71,7 @@ message PutRequest {
   // the stable-marshalled container strucutre, hence there is no need for
   // additional signature checks.
   message Body {
-    // Container structure to register in NeoFS
+    // Container structure to register in FrostFS
     container.Container container = 1;
 
     // Signature of a stable-marshalled container according to RFC-6979.
@@ -114,7 +90,7 @@ message PutRequest {
   neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
 }
 
-// New NeoFS Container creation response
+// New FrostFS Container creation response
 message PutResponse {
   // Container put response body contains information about the newly registered
   // container as seen by `Container` smart contract. `ContainerID` can be
@@ -143,10 +119,11 @@ message DeleteRequest {
   // the container owner's intent. The signature will be verified by `Container`
   // smart contract, so signing algorithm must be supported by NeoVM.
   message Body {
-    // Identifier of the container to delete from NeoFS
+    // Identifier of the container to delete from FrostFS
     neo.fs.v2.refs.ContainerID container_id = 1;
 
-    // `ContainerID` signed with the container owner's key according to RFC-6979.
+    // `ContainerID` signed with the container owner's key according to
+    // RFC-6979.
     neo.fs.v2.refs.SignatureRFC6979 signature = 2;
   }
   // Body of container delete request message.
@@ -268,150 +245,3 @@ message ListResponse {
   // transmission.
   neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
 }
-
-// Set Extended ACL
-message SetExtendedACLRequest {
-  // Set Extended ACL request body does not have separate `ContainerID`
-  // reference. It will be taken from `EACLTable.container_id` field.
-  message Body {
-    // Extended ACL table to set for the container
-    neo.fs.v2.acl.EACLTable eacl = 1;
-
-    // Signature of stable-marshalled Extended ACL table according to RFC-6979.
-    neo.fs.v2.refs.SignatureRFC6979 signature = 2;
-  }
-  // Body of set extended acl request message.
-  Body body = 1;
-
-  // Carries request meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
-
-  // Carries request verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
-}
-
-// Set Extended ACL
-message SetExtendedACLResponse {
-  // `SetExtendedACLResponse` has an empty body because the operation is
-  // asynchronous and the update should be reflected in `Container` smart contract's
-  // storage after next block is issued in sidechain.
-  message Body { }
-
-  // Body of set extended acl response message.
-  Body body = 1;
-
-  // Carries response meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
-
-  // Carries response verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
-}
-
-// Get Extended ACL
-message GetExtendedACLRequest {
-  // Get Extended ACL request body
-  message Body {
-    // Identifier of the container having Extended ACL
-    neo.fs.v2.refs.ContainerID container_id = 1;
-  }
-
-  // Body of get extended acl request message.
-  Body body = 1;
-
-  // Carries request meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
-
-  // Carries request verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
-}
-
-// Get Extended ACL
-message GetExtendedACLResponse {
-  // Get Extended ACL Response body can be empty if the requested container does
-  // not have Extended ACL Table attached or Extended ACL has not been allowed at
-  // the time of container creation.
-  message Body {
-    // Extended ACL requested, if available
-    neo.fs.v2.acl.EACLTable eacl = 1;
-
-    // Signature of stable-marshalled Extended ACL according to RFC-6979.
-    neo.fs.v2.refs.SignatureRFC6979 signature = 2;
-
-    // Session token if Extended ACL was set within a session
-    neo.fs.v2.session.SessionToken session_token = 3;
-  }
-  // Body of get extended acl response message.
-  Body body = 1;
-
-  // Carries response meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
-
-  // Carries response verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
-}
-
-// Announce container used space
-message AnnounceUsedSpaceRequest {
-  // Container used space announcement body.
-  message Body {
-    // Announcement contains used space information for a single container.
-    message Announcement {
-      // Epoch number for which the container size estimation was produced.
-      uint64 epoch = 1;
-
-      // Identifier of the container.
-      neo.fs.v2.refs.ContainerID container_id = 2;
-
-      // Used space is a sum of object payload sizes of a specified
-      // container, stored in the node. It must not include inhumed objects.
-      uint64 used_space = 3;
-    }
-
-    // List of announcements. If nodes share several containers,
-    // announcements are transferred in a batch.
-    repeated Announcement announcements = 1;
-  }
-
-  // Body of announce used space request message.
-  Body body = 1;
-
-  // Carries request meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
-
-  // Carries request verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
-}
-
-// Announce container used space
-message AnnounceUsedSpaceResponse {
-  // `AnnounceUsedSpaceResponse` has an empty body because announcements are
-  // one way communication.
-  message Body { }
-
-  // Body of announce used space response message.
-  Body body = 1;
-
-  // Carries response meta information. Header data is used only to regulate
-  // message transport and does not affect request execution.
-  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
-
-  // Carries response verification information. This header is used to
-  // authenticate the nodes of the message route and check the correctness of
-  // transmission.
-  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
-}

container/types.proto

@@ -10,26 +10,26 @@ import "refs/types.proto";
 
 // Container is a structure that defines object placement behaviour. Objects can
 // be stored only within containers. They define placement rule, attributes and
-// access control information. An ID of a container is a 32 byte long SHA256 hash
-// of stable-marshalled container message.
+// access control information. An ID of a container is a 32 byte long SHA256
+// hash of stable-marshalled container message.
 message Container {
   // Container format version. Effectively, the version of API library used to
   // create the container.
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Identifier of the container owner
-  neo.fs.v2.refs.OwnerID owner_id = 2 [json_name = "ownerID"];
+  neo.fs.v2.refs.OwnerID owner_id = 2 [ json_name = "ownerID" ];
 
   // Nonce is a 16 byte UUIDv4, used to avoid collisions of `ContainerID`s
-  bytes nonce = 3 [json_name = "nonce"];
+  bytes nonce = 3 [ json_name = "nonce" ];
 
-  // `BasicACL` contains access control rules for the owner, system and others groups,
-  // as well as permission bits for `BearerToken` and `Extended ACL`
-  uint32 basic_acl = 4 [json_name = "basicACL"];
+  // `BasicACL` contains access control rules for the owner, system and others
+  // groups, as well as permission bits for `BearerToken` and `Extended ACL`
+  uint32 basic_acl = 4 [ json_name = "basicACL" ];
 
   // `Attribute` is a user-defined Key-Value metadata pair attached to the
-  // container. Container attributes are immutable. They are set at the moment of
-  // container creation and can never be added or updated.
+  // container. Container attributes are immutable. They are set at the moment
+  // of container creation and can never be added or updated.
   //
   // Key name must be a container-unique valid UTF-8 string. Value can't be
   // empty. Containers with duplicated attribute names or attributes with empty
@@ -43,15 +43,16 @@ message Container {
   //   NNS contract.
   // * [ __SYSTEM__ZONE ]  \
   //   (`__NEOFS__ZONE` is deprecated) \
-  //   String of a zone for `__SYSTEM__NAME` (`__NEOFS__NAME` is deprecated). Used as a TLD of a domain name in NNS
-  //   contract. If no zone is specified, use default zone: `container`.
+  //   String of a zone for `__SYSTEM__NAME` (`__NEOFS__NAME` is deprecated).
+  //   Used as a TLD of a domain name in NNS contract. If no zone is specified,
+  //   use default zone: `container`.
   // * [ __SYSTEM__DISABLE_HOMOMORPHIC_HASHING ] \
   //   (`__NEOFS__DISABLE_HOMOMORPHIC_HASHING` is deprecated) \
-  //   Disables homomorphic hashing for the container if the value equals "true" string.
-  //   Any other values are interpreted as missing attribute. Container could be
-  //   accepted in a NeoFS network only if the global network hashing configuration
-  //   value corresponds with that attribute's value. After container inclusion, network
-  //   setting is ignored.
+  //   Disables homomorphic hashing for the container if the value equals "true"
+  //   string. Any other values are interpreted as missing attribute. Container
+  //   could be accepted in a FrostFS network only if the global network hashing
+  //   configuration value corresponds with that attribute's value. After
+  //   container inclusion, network setting is ignored.
   //
   // And some well-known attributes used by applications only:
   //
@@ -61,14 +62,15 @@ message Container {
   //   User-defined local time of container creation in Unix Timestamp format
   message Attribute {
     // Attribute name key
-    string key = 1 [json_name = "key"];
+    string key = 1 [ json_name = "key" ];
 
     // Attribute value
-    string value = 2 [json_name = "value"];
+    string value = 2 [ json_name = "value" ];
   }
   // Attributes represent immutable container's meta data
-  repeated Attribute attributes = 5 [json_name = "attributes"];
+  repeated Attribute attributes = 5 [ json_name = "attributes" ];
 
   // Placement policy for the object inside the container
-  neo.fs.v2.netmap.PlacementPolicy placement_policy = 6 [json_name = "placementPolicy"];
+  neo.fs.v2.netmap.PlacementPolicy placement_policy = 6
+      [ json_name = "placementPolicy" ];
 }

doc/release_instructions.md

@@ -1,6 +1,6 @@
 # Release instructions
 
-This documents outlines the neofs-api release process and can be used as a TODO
+This documents outlines the frostfs-api release process and can be used as a TODO
 list for a new release.
 
 ## Pre-release checks
@@ -20,7 +20,7 @@ Add an entry to the CHANGELOG.md following the style established there.
 Add a codename for releases with the new major version, version and release date in
 the heading. Write a paragraph describing the most significant changes done in
 this release. Then add sections with what has been added, changed and removed,
-describing each change briefly with a reference to GitHub issues, where
+describing each change briefly with a reference to issues, where
 available.
 
 ## Release commit
@@ -38,7 +38,7 @@ Release v2.9.0 - Anmyeondo (안면도, 安眠島)
 Use `vX.Y.Z` tag following the semantic versioning standard. For pre-release
 versions use `vX.Y.Z-rc.N` scheme.
 
-## Push changes and release tag to Github
+## Push changes and release tag to repository
 
 This step should bypass the default PR mechanism to get a correct result (so
 that releasing requires admin privileges for the project), both the `master`
@@ -48,9 +48,9 @@ branch update and tag must be pushed simultaneously like this:
 $ git push origin master v2.7.0
 ```
 
-## Make a proper Github release
+## Make a proper release
 
-Edit an automatically-created release on Github.
+Edit an automatically-created release on git.frostfs.info
 
 Release title has to follow `<version> <Romanized codename> (<Hangeul, Hanja
 codename> )` scheme for major releases and just `<version>` for regular point
@@ -58,6 +58,5 @@ releases.
 
 ## Post-release actions
 
-* Close corresponding X.Y.Z Github milestone
+* Close corresponding X.Y.Z milestone
 * Make announcements in Matrix and Discord channels
-* Update [NeoFS Technical Specification](https://github.com/nspcc-dev/neofs-spec)

help.mk

@@ -0,0 +1,11 @@
+.PHONY: help
+
+# Show this help prompt
+help:
+	@echo '  Usage:'
+	@echo ''
+	@echo '    make <target>'
+	@echo ''
+	@echo '  Targets:'
+	@echo ''
+	@awk '/^#/{ comment = substr($$0,3) } /^[a-zA-Z][a-zA-Z0-9_-]+:/{ print "   ", $$1, comment; comment = "" }' $(MAKEFILE_LIST) | column -t -s ':' | grep -v 'IGNORE' | sort | uniq

lock/types.proto

@@ -9,10 +9,11 @@ import "refs/types.proto";
 
 // Lock objects protects a list of objects from being deleted. The lifetime of a
 // lock object is limited similar to regular objects in
-// `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) attribute. Lock object MUST have expiration epoch.
-// It is impossible to delete a lock object via ObjectService.Delete RPC call.
+// `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated)
+// attribute. Lock object MUST have expiration epoch. It is impossible to delete
+// a lock object via ObjectService.Delete RPC call.
 message Lock {
   // List of objects to lock. Must not be empty or carry empty IDs.
   // All members must be of the `REGULAR` type.
-  repeated neo.fs.v2.refs.ObjectID members = 1 [json_name = "members"];
+  repeated neo.fs.v2.refs.ObjectID members = 1 [ json_name = "members" ];
 }

netmap/service.proto

@@ -9,45 +9,45 @@ import "netmap/types.proto";
 import "refs/types.proto";
 import "session/types.proto";
 
-// `NetmapService` provides methods to work with `Network Map` and the information
-// required to build it. The resulting `Network Map` is stored in sidechain
-// `Netmap` smart contract, while related information can be obtained from other
-// NeoFS nodes.
+// `NetmapService` provides methods to work with `Network Map` and the
+// information required to build it. The resulting `Network Map` is stored in
+// sidechain `Netmap` smart contract, while related information can be obtained
+// from other FrostFS nodes.
 service NetmapService {
-  // Get NodeInfo structure from the particular node directly. 
-  // Node information can be taken from `Netmap` smart contract. In some cases, though,
-  // one may want to get recent information directly or to talk to the node not yet
-  // present in the `Network Map` to find out what API version can be used for
-  // further communication. This can be also used to check if a node is up and running.
+  // Get NodeInfo structure from the particular node directly.
+  // Node information can be taken from `Netmap` smart contract. In some cases,
+  // though, one may want to get recent information directly or to talk to the
+  // node not yet present in the `Network Map` to find out what API version can
+  // be used for further communication. This can be also used to check if a node
+  // is up and running.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS):
   // information about the server has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON).
-  rpc LocalNodeInfo (LocalNodeInfoRequest) returns (LocalNodeInfoResponse);
+  rpc LocalNodeInfo(LocalNodeInfoRequest) returns (LocalNodeInfoResponse);
 
-  // Read recent information about the NeoFS network.
+  // Read recent information about the FrostFS network.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS):
   // information about the current network state has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON).
-  rpc NetworkInfo (NetworkInfoRequest) returns (NetworkInfoResponse);
+  rpc NetworkInfo(NetworkInfoRequest) returns (NetworkInfoResponse);
 
-  // Returns network map snapshot of the current NeoFS epoch.
+  // Returns network map snapshot of the current FrostFS epoch.
   //
   // Statuses:
   // - **OK** (0, SECTION_SUCCESS):
   // information about the current network map has been successfully read;
   // - Common failures (SECTION_FAILURE_COMMON).
-  rpc NetmapSnapshot (NetmapSnapshotRequest) returns (NetmapSnapshotResponse);
+  rpc NetmapSnapshot(NetmapSnapshotRequest) returns (NetmapSnapshotResponse);
 }
 
 // Get NodeInfo structure directly from a particular node
 message LocalNodeInfoRequest {
   // LocalNodeInfo request body is empty.
-  message Body {
-  }
+  message Body {}
   // Body of the LocalNodeInfo request message
   Body body = 1;
 
@@ -65,7 +65,7 @@ message LocalNodeInfoRequest {
 message LocalNodeInfoResponse {
   // Local Node Info, including API Version in use.
   message Body {
-    // Latest NeoFS API version in use
+    // Latest FrostFS API version in use
     neo.fs.v2.refs.Version version = 1;
 
     // NodeInfo structure with recent information from node itself
@@ -86,81 +86,77 @@ message LocalNodeInfoResponse {
 
 // Get NetworkInfo structure with the network view from a particular node.
 message NetworkInfoRequest {
-    // NetworkInfo request body is empty.
-    message Body {
-    }
-    // Body of the NetworkInfo request message
-    Body body = 1;
+  // NetworkInfo request body is empty.
+  message Body {}
+  // Body of the NetworkInfo request message
+  Body body = 1;
 
-    // Carries request meta information. Header data is used only to regulate
-    // message transport and does not affect request execution.
-    neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
 
-    // Carries request verification information. This header is used to
-    // authenticate the nodes of the message route and check the correctness of
-    // transmission.
-    neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
 }
 
 // Response with NetworkInfo structure including current epoch and
 // sidechain magic number.
 message NetworkInfoResponse {
-    // Information about the network.
-    message Body {
-        // NetworkInfo structure with recent information.
-        NetworkInfo network_info = 1;
-    }
-    // Body of the NetworkInfo response message.
-    Body body = 1;
+  // Information about the network.
+  message Body {
+    // NetworkInfo structure with recent information.
+    NetworkInfo network_info = 1;
+  }
+  // Body of the NetworkInfo response message.
+  Body body = 1;
 
-    // Carries response meta information. Header data is used only to regulate
-    // message transport and does not affect response execution.
-    neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect response execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
 
-    // Carries response verification information. This header is used to
-    // authenticate the nodes of the message route and check the correctness of
-    // transmission.
-    neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
 }
 
 // Get netmap snapshot request
 message NetmapSnapshotRequest {
-    // Get netmap snapshot request body.
-    message Body {
-    }
+  // Get netmap snapshot request body.
+  message Body {}
 
-    // Body of get netmap snapshot request message.
-    Body body = 1;
+  // Body of get netmap snapshot request message.
+  Body body = 1;
 
-    // Carries request meta information. Header data is used only to regulate
-    // message transport and does not affect request execution.
-    neo.fs.v2.session.RequestMetaHeader meta_header = 2;
-
-    // Carries request verification information. This header is used to
-    // authenticate the nodes of the message route and check the correctness of
-    // transmission.
-    neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
 
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
 }
 
 // Response with current netmap snapshot
 message NetmapSnapshotResponse {
-    // Get netmap snapshot response body
-    message Body {
-        // Structure of the requested network map.
-        Netmap netmap = 1 [json_name = "netmap"];
-    }
+  // Get netmap snapshot response body
+  message Body {
+    // Structure of the requested network map.
+    Netmap netmap = 1 [ json_name = "netmap" ];
+  }
 
-    // Body of get netmap snapshot response message.
-    Body body = 1;
+  // Body of get netmap snapshot response message.
+  Body body = 1;
 
-    // Carries response meta information. Header data is used only to regulate
-    // message transport and does not affect response execution.
-    neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
-
-    // Carries response verification information. This header is used to
-    // authenticate the nodes of the message route and check the correctness of
-    // transmission.
-    neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect response execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
 
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
 }

netmap/types.proto

@@ -36,6 +36,9 @@ enum Operation {
 
   // Logical negation
   NOT = 9;
+
+  // Matches pattern
+  LIKE = 10;
 }
 
 // Selector modifier shows how the node set will be formed. By default selector
@@ -52,46 +55,46 @@ enum Clause {
   DISTINCT = 2;
 }
 
-// This filter will return the subset of nodes from `NetworkMap` or another filter's
-// results that will satisfy filter's conditions.
+// This filter will return the subset of nodes from `NetworkMap` or another
+// filter's results that will satisfy filter's conditions.
 message Filter {
   // Name of the filter or a reference to a named filter. '*' means
   // application to the whole unfiltered NetworkMap. At top level it's used as a
   // filter name. At lower levels it's considered to be a reference to another
   // named filter
-  string name = 1 [json_name = "name"];
+  string name = 1 [ json_name = "name" ];
 
   // Key to filter
-  string key = 2 [json_name = "key"];
+  string key = 2 [ json_name = "key" ];
 
   // Filtering operation
-  Operation op = 3 [json_name = "op"];
+  Operation op = 3 [ json_name = "op" ];
 
   // Value to match
-  string value = 4 [json_name = "value"];
+  string value = 4 [ json_name = "value" ];
 
   // List of inner filters. Top level operation will be applied to the whole
   // list.
-  repeated Filter filters = 5 [json_name = "filters"];
+  repeated Filter filters = 5 [ json_name = "filters" ];
 }
 
 // Selector chooses a number of nodes from the bucket taking the nearest nodes
 // to the provided `ContainerID` by hash distance.
 message Selector {
   // Selector name to reference in object placement section
-  string name = 1 [json_name = "name"];
+  string name = 1 [ json_name = "name" ];
 
   // How many nodes to select from the bucket
-  uint32 count = 2 [json_name = "count"];
+  uint32 count = 2 [ json_name = "count" ];
 
   // Selector modifier showing how to form a bucket
-  Clause clause = 3 [json_name = "clause"];
+  Clause clause = 3 [ json_name = "clause" ];
 
   // Bucket attribute to select from
-  string attribute = 4 [json_name = "attribute"];
+  string attribute = 4 [ json_name = "attribute" ];
 
   // Filter reference to select from
-  string filter = 5 [json_name = "filter"];
+  string filter = 5 [ json_name = "filter" ];
 }
 
 // Number of object replicas in a set of nodes from the defined selector. If no
@@ -99,10 +102,16 @@ message Selector {
 // default.
 message Replica {
   // How many object replicas to put
-  uint32 count = 1 [json_name = "count"];
+  uint32 count = 1 [ json_name = "count" ];
 
   // Named selector bucket to put replicas
-  string selector = 2 [json_name = "selector"];
+  string selector = 2 [ json_name = "selector" ];
+
+  // Data shards count
+  uint32 ec_data_count = 3 [ json_name = "ecDataCount" ];
+
+  // Parity shards count
+  uint32 ec_parity_count = 4 [ json_name = "ecParityCount" ];
 }
 
 // Set of rules to select a subset of nodes from `NetworkMap` able to store
@@ -111,45 +120,45 @@ message Replica {
 message PlacementPolicy {
   // Rules to set number of object replicas and place each one into a named
   // bucket
-  repeated Replica replicas = 1 [json_name = "replicas"];
+  repeated Replica replicas = 1 [ json_name = "replicas" ];
 
-  // Container backup factor controls how deep NeoFS will search for nodes
+  // Container backup factor controls how deep FrostFS will search for nodes
   // alternatives to include into container's nodes subset
-  uint32 container_backup_factor = 2 [json_name = "containerBackupFactor"];
+  uint32 container_backup_factor = 2 [ json_name = "containerBackupFactor" ];
 
   // Set of Selectors to form the container's nodes subset
-  repeated Selector selectors = 3 [json_name = "selectors"];
+  repeated Selector selectors = 3 [ json_name = "selectors" ];
 
   // List of named filters to reference in selectors
-  repeated Filter filters = 4 [json_name = "filters"];
+  repeated Filter filters = 4 [ json_name = "filters" ];
 
   // Unique flag defines non-overlapping application for replicas
-  bool unique = 5 [json_name = "unique"];
+  bool unique = 5 [ json_name = "unique" ];
 }
 
-// NeoFS node description
+// FrostFS node description
 message NodeInfo {
-  // Public key of the NeoFS node in a binary format
-  bytes public_key = 1 [json_name = "publicKey"];
+  // Public key of the FrostFS node in a binary format
+  bytes public_key = 1 [ json_name = "publicKey" ];
 
   // Ways to connect to a node
-  repeated string addresses = 2 [json_name = "addresses"];
+  repeated string addresses = 2 [ json_name = "addresses" ];
 
-  // Administrator-defined Attributes of the NeoFS Storage Node.
+  // Administrator-defined Attributes of the FrostFS Storage Node.
   //
   // `Attribute` is a Key-Value metadata pair. Key name must be a valid UTF-8
   // string. Value can't be empty.
   //
   // Attributes can be constructed into a chain of attributes: any attribute can
-  // have a parent attribute and a child attribute (except the first and the last
-  // one). A string representation of the chain of attributes in NeoFS Storage
-  // Node configuration uses ":" and "/" symbols, e.g.:
+  // have a parent attribute and a child attribute (except the first and the
+  // last one). A string representation of the chain of attributes in FrostFS
+  // Storage Node configuration uses ":" and "/" symbols, e.g.:
   //
-  //        `NEOFS_NODE_ATTRIBUTE_1=key1:val1/key2:val2`
+  //        `FrostFS_NODE_ATTRIBUTE_1=key1:val1/key2:val2`
   //
-  // Therefore the string attribute representation in the Node configuration must
-  // use "\:", "\/" and "\\" escaped symbols if any of them appears in an attribute's
-  // key or value.
+  // Therefore the string attribute representation in the Node configuration
+  // must use "\:", "\/" and "\\" escaped symbols if any of them appears in an
+  // attribute's key or value.
   //
   // Node's attributes are mostly used during Storage Policy evaluation to
   // calculate object's placement and find a set of nodes satisfying policy
@@ -192,8 +201,8 @@ message NodeInfo {
   //   [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). Calculated
   //   automatically from `UN-LOCODE` attribute.
   // * Continent \
-  //   Node's continent name according to the [Seven-Continent model]
-  //   (https://en.wikipedia.org/wiki/Continent#Number). Calculated
+  //   Node's continent name according to the [Seven-Continent
+  //   model](https://en.wikipedia.org/wiki/Continent#Number). Calculated
   //   automatically from `UN-LOCODE` attribute.
   // * ExternalAddr
   //   Node's preferred way for communications with external clients.
@@ -201,25 +210,25 @@ message NodeInfo {
   //   Must contain a comma-separated list of multi-addresses.
   //
   // For detailed description of each well-known attribute please see the
-  // corresponding section in NeoFS Technical Specification.
+  // corresponding section in FrostFS Technical Specification.
   message Attribute {
     // Key of the node attribute
-    string key = 1 [json_name = "key"];
+    string key = 1 [ json_name = "key" ];
 
     // Value of the node attribute
-    string value = 2 [json_name = "value"];
+    string value = 2 [ json_name = "value" ];
 
     // Parent keys, if any. For example for `City` it could be `Region` and
     // `Country`.
-    repeated string parents = 3 [json_name = "parents"];
+    repeated string parents = 3 [ json_name = "parents" ];
   }
-  // Carries list of the NeoFS node attributes in a key-value form. Key name
+  // Carries list of the FrostFS node attributes in a key-value form. Key name
   // must be a node-unique valid UTF-8 string. Value can't be empty. NodeInfo
   // structures with duplicated attribute names or attributes with empty values
   // will be considered invalid.
-  repeated Attribute attributes = 3 [json_name = "attributes"];
+  repeated Attribute attributes = 3 [ json_name = "attributes" ];
 
-  // Represents the enumeration of various states of the NeoFS node.
+  // Represents the enumeration of various states of the FrostFS node.
   enum State {
     // Unknown state
     UNSPECIFIED = 0;
@@ -234,20 +243,20 @@ message NodeInfo {
     MAINTENANCE = 3;
   }
 
-  // Carries state of the NeoFS node
-  State state = 4 [json_name = "state"];
+  // Carries state of the FrostFS node
+  State state = 4 [ json_name = "state" ];
 }
 
 // Network map structure
 message Netmap {
-    // Network map revision number.
-    uint64 epoch = 1 [json_name = "epoch"];
+  // Network map revision number.
+  uint64 epoch = 1 [ json_name = "epoch" ];
 
-    // Nodes presented in network.
-    repeated NodeInfo nodes = 2 [json_name = "nodes"];
+  // Nodes presented in network.
+  repeated NodeInfo nodes = 2 [ json_name = "nodes" ];
 }
 
-// NeoFS network configuration
+// FrostFS network configuration
 message NetworkConfig {
   // Single configuration parameter. Key MUST be network-unique.
   //
@@ -266,7 +275,7 @@ message NetworkConfig {
   //   Fee paid for container creation by the container owner.
   //   Value: little-endian integer. Default: 0.
   // - **EpochDuration** \
-  //   NeoFS epoch duration measured in Sidechain blocks.
+  //   FrostFS epoch duration measured in Sidechain blocks.
   //   Value: little-endian integer. Default: 0.
   // - **HomomorphicHashingDisabled** \
   //   Flag of disabling the homomorphic hashing of objects' payload.
@@ -278,33 +287,71 @@ message NetworkConfig {
   //   Flag allowing setting the MAINTENANCE state to storage nodes.
   //   Value: true if any byte != 0. Default: false.
   // - **MaxObjectSize** \
-  //   Maximum size of physically stored NeoFS object measured in bytes.
+  //   Maximum size of physically stored FrostFS object measured in bytes.
   //   Value: little-endian integer. Default: 0.
+  //
+  //   This value refers to the maximum size of a **physically** stored object
+  //   in FrostFS. However, from a user's perspective, the **logical** size of a
+  //   stored object can be significantly larger. The relationship between the
+  //   physical and logical object sizes is governed by the following formula
+  //
+  //   ```math
+  //   \mathrm{Stored\ Object\ Size} \le
+  //   \frac{
+  //     \left(\mathrm{Max\ Object\ Size}\right)^2
+  //   }{
+  //     \mathrm{Object\ ID\ Size}
+  //   }
+  //   ```
+  //
+  //   This arises from the fact that a tombstone, also being an object, stores
+  //   the IDs of inhumed objects and cannot be divided into smaller objects,
+  //   thus having an upper limit for its size.
+  //
+  //   For example, if:
+  //   * Max Object Size Size = 64 MiB;
+  //   * Object ID Size = 32 B;
+  //
+  //   then:
+  //   ```math
+  //     \mathrm{Stored\ Object\ Size} \le
+  //     \frac{\left(64\ \mathrm{MiB}\right)^2}{32\ \mathrm{B}} =
+  //     \frac{2^{52}}{2^5}\ \mathrm{B} =
+  //     2^{47}\ \mathrm{B} =
+  //     128\ \mathrm{TiB}
+  //   ```
   // - **WithdrawFee** \
   //   Fee paid for withdrawal of funds paid by the account owner.
   //   Value: little-endian integer. Default: 0.
+  // - **MaxECDataCount** \
+  //   Maximum number of data shards for EC placement policy.
+  //   Value: little-endian integer. Default: 0.
+  // - **MaxECParityCount** \
+  //   Maximum number of parity shards for EC placement policy.
+  //   Value: little-endian integer. Default: 0.
   message Parameter {
     // Parameter key. UTF-8 encoded string
-    bytes key = 1 [json_name = "key"];
+    bytes key = 1 [ json_name = "key" ];
 
     // Parameter value
-    bytes value = 2 [json_name = "value"];
+    bytes value = 2 [ json_name = "value" ];
   }
   // List of parameter values
-  repeated Parameter parameters = 1 [json_name = "parameters"];
+  repeated Parameter parameters = 1 [ json_name = "parameters" ];
 }
 
-// Information about NeoFS network
+// Information about FrostFS network
 message NetworkInfo {
-    // Number of the current epoch in the NeoFS network
-    uint64 current_epoch = 1 [json_name = "currentEpoch"];
+  // Number of the current epoch in the FrostFS network
+  uint64 current_epoch = 1 [ json_name = "currentEpoch" ];
 
-    // Magic number of the sidechain of the NeoFS network
-    uint64 magic_number = 2 [json_name = "magicNumber"];
+  // Magic number of the sidechain of the FrostFS network
+  uint64 magic_number = 2 [ json_name = "magicNumber" ];
 
-    // MillisecondsPerBlock network parameter of the sidechain of the NeoFS network
-    int64 ms_per_block = 3 [json_name = "msPerBlock"];
+  // MillisecondsPerBlock network parameter of the sidechain of the FrostFS
+  // network
+  int64 ms_per_block = 3 [ json_name = "msPerBlock" ];
 
-    // NeoFS network configuration
-    NetworkConfig network_config = 4 [json_name = "networkConfig"];
+  // FrostFS network configuration
+  NetworkConfig network_config = 4 [ json_name = "networkConfig" ];
 }

object/service.proto

@@ -13,11 +13,11 @@ import "session/types.proto";
 // not affect the sidechain and are only served by nodes in p2p style.
 service ObjectService {
   // Receive full object structure, including Headers and payload. Response uses
-  // gRPC stream. First response message carries the object with the requested address.
-  // Chunk messages are parts of the object's payload if it is needed. All
-  // messages, except the first one, carry payload chunks. The requested object can
-  // be restored by concatenation of object message payload and all chunks
-  // keeping the receiving order.
+  // gRPC stream. First response message carries the object with the requested
+  // address. Chunk messages are parts of the object's payload if it is needed.
+  // All messages, except the first one, carry payload chunks. The requested
+  // object can be restored by concatenation of object message payload and all
+  // chunks keeping the receiving order.
   //
   // Extended headers can change `Get` behaviour:
   // * [ __SYSTEM__NETMAP_EPOCH ] \
@@ -26,9 +26,10 @@ service ObjectService {
   //   calculation.
   // * [ __SYSTEM__NETMAP_LOOKUP_DEPTH ] \
   //   (`__NEOFS__NETMAP_LOOKUP_DEPTH` is deprecated) \
-  //   Will try older versions (starting from `__SYSTEM__NETMAP_EPOCH` (`__NEOFS__NETMAP_EPOCH` is deprecated) if specified or
-  //   the latest one otherwise) of Network Map to find an object until the depth
-  //   limit is reached.
+  //   Will try older versions (starting from `__SYSTEM__NETMAP_EPOCH`
+  //   (`__NEOFS__NETMAP_EPOCH` is deprecated) if specified or the latest one
+  //   otherwise) of Network Map to find an object until the depth limit is
+  //   reached.
   //
   // Please refer to detailed `XHeader` description.
   //
@@ -44,6 +45,8 @@ service ObjectService {
   //   the requested object has been marked as deleted;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc Get(GetRequest) returns (stream GetResponse);
@@ -70,15 +73,18 @@ service ObjectService {
   // - **ACCESS_DENIED** (2048, SECTION_OBJECT): \
   //   write access to the container is denied;
   // - **LOCKED** (2050, SECTION_OBJECT): \
-  //   placement of an object of type TOMBSTONE that includes at least one locked
-  //   object is prohibited;
+  //   placement of an object of type TOMBSTONE that includes at least one
+  //   locked object is prohibited;
   // - **LOCK_NON_REGULAR_OBJECT** (2051, SECTION_OBJECT): \
   //   placement of an object of type LOCK that includes at least one object of
   //   type other than REGULAR is prohibited;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object storage container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
-  //   (for trusted object preparation) session private key does not exist or has
+  //   (for trusted object preparation) session private key does not exist or
+  //   has
   // been deleted;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
@@ -108,6 +114,8 @@ service ObjectService {
   //   deleting a locked object is prohibited;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc Delete(DeleteRequest) returns (DeleteResponse);
@@ -136,12 +144,14 @@ service ObjectService {
   //   the requested object has been marked as deleted;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc Head(HeadRequest) returns (HeadResponse);
 
   // Search objects in container. Search query allows to match by Object
-  // Header's filed values. Please see the corresponding NeoFS Technical
+  // Header's filed values. Please see the corresponding FrostFS Technical
   // Specification section for more details.
   //
   // Extended headers can change `Search` behaviour:
@@ -160,14 +170,16 @@ service ObjectService {
   //   access to operation SEARCH of the object is denied;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   search container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc Search(SearchRequest) returns (stream SearchResponse);
 
   // Get byte range of data payload. Range is set as an (offset, length) tuple.
   // Like in `Get` method, the response uses gRPC stream. Requested range can be
-  // restored by concatenation of all received payload chunks keeping the receiving
-  // order.
+  // restored by concatenation of all received payload chunks keeping the
+  // receiving order.
   //
   // Extended headers can change `GetRange` behaviour:
   // * [ __SYSTEM__NETMAP_EPOCH ] \
@@ -195,6 +207,8 @@ service ObjectService {
   //   the requested range is out of bounds;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc GetRange(GetRangeRequest) returns (stream GetRangeResponse);
@@ -228,12 +242,15 @@ service ObjectService {
   //   the requested range is out of bounds;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc GetRangeHash(GetRangeHashRequest) returns (GetRangeHashResponse);
 
   // Put the prepared object into container.
-  // `ContainerID`, `ObjectID`, `OwnerID`, `PayloadHash` and `PayloadLength` of an object MUST be set.
+  // `ContainerID`, `ObjectID`, `OwnerID`, `PayloadHash` and `PayloadLength` of
+  // an object MUST be set.
   //
   // Extended headers can change `Put` behaviour:
   // * [ __SYSTEM__NETMAP_EPOCH \
@@ -250,19 +267,71 @@ service ObjectService {
   // - **ACCESS_DENIED** (2048, SECTION_OBJECT): \
   //   write access to the container is denied;
   // - **LOCKED** (2050, SECTION_OBJECT): \
-  //   placement of an object of type TOMBSTONE that includes at least one locked
-  //   object is prohibited;
+  //   placement of an object of type TOMBSTONE that includes at least one
+  //   locked object is prohibited;
   // - **LOCK_NON_REGULAR_OBJECT** (2051, SECTION_OBJECT): \
   //   placement of an object of type LOCK that includes at least one object of
   //   type other than REGULAR is prohibited;
   // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   //   object storage container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
   // - **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
-  //   (for trusted object preparation) session private key does not exist or has
+  //   (for trusted object preparation) session private key does not exist or
+  //   has
   // been deleted;
   // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   //   provided session token has expired.
   rpc PutSingle(PutSingleRequest) returns (PutSingleResponse);
+
+  // Patch the object. Request uses gRPC stream. First message must set
+  // the address of the object that is going to get patched. If the object's
+  // attributes are patched, then these attrubutes must be set only within the
+  // first stream message.
+  //
+  // If the patch request is performed by NOT the object's owner but if the
+  // actor has the permission to perform the patch, then `OwnerID` of the object
+  // is changed. In this case the object's owner loses the object's ownership
+  // after the patch request is successfully done.
+  //
+  // As objects are content-addressable the patching causes new object ID
+  // generation for the patched object. This object id is set witihn
+  // `PatchResponse`. But the object id may remain unchanged in such cases:
+  // 1. The chunk of the applying patch contains the same value as the object's
+  // payload within the same range;
+  // 2. The patch that reverts the changes applied by preceding patch;
+  // 3. The application of the same patches for the object a few times.
+  //
+  // Extended headers can change `Patch` behaviour:
+  // * [ __SYSTEM__NETMAP_EPOCH \
+  //   (`__NEOFS__NETMAP_EPOCH` is deprecated) \
+  //   Will use the requsted version of Network Map for object placement
+  //   calculation.
+  //
+  // Please refer to detailed `XHeader` description.
+  //
+  // Statuses:
+  // - **OK** (0, SECTION_SUCCESS): \
+  //   object has been successfully patched and saved in the container;
+  // - Common failures (SECTION_FAILURE_COMMON);
+  // - **ACCESS_DENIED** (2048, SECTION_OBJECT): \
+  //   write access to the container is denied;
+  // - **OBJECT_NOT_FOUND** (2049, SECTION_OBJECT): \
+  //   object not found in container;
+  // - **OBJECT_ALREADY_REMOVED** (2052, SECTION_OBJECT): \
+  //   the requested object has been marked as deleted.
+  // - **OUT_OF_RANGE** (2053, SECTION_OBJECT): \
+  //   the requested range is out of bounds;
+  // - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  //   object storage container not found;
+  // - **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  //   access to container is denied;
+  // - **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
+  //   (for trusted object preparation) session private key does not exist or
+  //   has been deleted;
+  // - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
+  //   provided session token has expired.
+  rpc Patch(stream PatchRequest) returns (PatchResponse);
 }
 
 // GET object request
@@ -315,6 +384,9 @@ message GetResponse {
 
       // Meta information of split hierarchy for object assembly.
       SplitInfo split_info = 3;
+
+      // Meta information for EC object assembly.
+      ECInfo ec_info = 4;
     }
   }
   // Body of get object response message.
@@ -346,16 +418,16 @@ message PutRequest {
       // Object's Header
       Header header = 3;
 
-      // Number of copies of the object to store within the RPC call. By default,
-      // object is processed according to the container's placement policy.
-      // Can be one of:
+      // Number of copies of the object to store within the RPC call. By
+      // default, object is processed according to the container's placement
+      // policy. Can be one of:
       // 1. A single number; applied to the whole request and is treated as
       // a minimal number of nodes that must store an object to complete the
       // request successfully.
       // 2. An ordered array; every number is treated as a minimal number of
       // nodes in a corresponding placement vector that must store an object
-      // to complete the request successfully. The length MUST equal the placement
-      // vectors number, otherwise request is considered malformed.
+      // to complete the request successfully. The length MUST equal the
+      // placement vectors number, otherwise request is considered malformed.
       repeated uint32 copies_number = 4;
     }
     // Single message in the request stream.
@@ -406,7 +478,7 @@ message DeleteRequest {
   message Body {
     // Address of the object to be deleted
     neo.fs.v2.refs.Address address = 1;
- }
+  }
   // Body of delete object request message.
   Body body = 1;
 
@@ -478,10 +550,10 @@ message HeadRequest {
 // 3. Check if `ObjectID` signature in `signature` field is correct
 message HeaderWithSignature {
   // Full object header
-  Header header = 1 [json_name = "header"];
+  Header header = 1 [ json_name = "header" ];
 
   // Signed `ObjectID` to verify full header's authenticity
-  neo.fs.v2.refs.Signature signature = 2 [json_name = "signature"];
+  neo.fs.v2.refs.Signature signature = 2 [ json_name = "signature" ];
 }
 
 // Object HEAD response
@@ -490,7 +562,7 @@ message HeadResponse {
   message Body {
     // Requested object header, it's part or meta information about split
     // object.
-    oneof head{
+    oneof head {
       // Full object's `Header` with `ObjectID` signature
       HeaderWithSignature header = 1;
 
@@ -499,6 +571,9 @@ message HeadResponse {
 
       // Meta information of split hierarchy.
       SplitInfo split_info = 3;
+
+      // Meta information for EC object assembly.
+      ECInfo ec_info = 4;
     }
   }
   // Body of head object response message.
@@ -523,11 +598,11 @@ message SearchRequest {
 
     // Version of the Query Language used
     uint32 version = 2;
-    // Filter structure checks if the object header field or the attribute content
-    // matches a value.
+    // Filter structure checks if the object header field or the attribute
+    // content matches a value.
     //
     // If no filters are set, search request will return all objects of the
-    // container, including Regular object, Tombstones and Storage Group
+    // container, including Regular object and Tombstone
     // objects. Most human users expect to get only object they can directly
     // work with. In that case, `$Object:ROOT` filter should be used.
     //
@@ -557,16 +632,19 @@ message SearchRequest {
     //   object_id of parent
     // * $Object:split.splitID \
     //   16 byte UUIDv4 used to identify the split object hierarchy parts
+    // * $Object:ec.parent \
+    //   If the object is stored according to EC policy, then ec_parent
+    //   attribute is set to return an id list of all related EC chunks.
     //
     // There are some well-known filter aliases to match objects by certain
     // properties:
     //
     // * $Object:ROOT \
-    //   Returns only `REGULAR` type objects that are not split or that are the top
-    //   level root objects in a split hierarchy. This includes objects not
+    //   Returns only `REGULAR` type objects that are not split or that are the
+    //   top level root objects in a split hierarchy. This includes objects not
     //   present physically, like large objects split into smaller objects
     //   without a separate top-level root object. Objects of other types like
-    //   StorageGroups and Tombstones will not be shown. This filter may be
+    //   Locks and Tombstones will not be shown. This filter may be
     //   useful for listing objects like `ls` command of some virtual file
     //   system. This filter is activated if the `key` exists, disregarding the
     //   value and matcher type.
@@ -575,17 +653,17 @@ message SearchRequest {
     //   activated if the `key` exists, disregarding the value and matcher type.
     //
     // Note: using filters with a key with prefix `$Object:` and match type
-    // `NOT_PRESENT `is not recommended since this is not a cross-version approach.
-    // Behavior when processing this kind of filters is undefined.
+    // `NOT_PRESENT `is not recommended since this is not a cross-version
+    // approach. Behavior when processing this kind of filters is undefined.
     message Filter {
       // Match type to use
-      MatchType match_type = 1 [json_name = "matchType"];
+      MatchType match_type = 1 [ json_name = "matchType" ];
 
       // Attribute or Header fields to match
-      string key = 2 [json_name = "key"];
+      string key = 2 [ json_name = "key" ];
 
       // Value to match
-      string value = 3 [json_name = "value"];
+      string value = 3 [ json_name = "value" ];
     }
     // List of search expressions
     repeated Filter filters = 3;
@@ -668,12 +746,15 @@ message GetRangeResponse {
   // chunks.
   message Body {
     // Requested object range or meta information about split object.
-    oneof range_part{
+    oneof range_part {
       // Chunked object payload's range.
       bytes chunk = 1;
 
       // Meta information of split hierarchy.
       SplitInfo split_info = 2;
+
+      // Meta information for EC object assembly.
+      ECInfo ec_info = 3;
     }
   }
 
@@ -744,36 +825,35 @@ message GetRangeHashResponse {
 
 // Object PUT Single request
 message PutSingleRequest {
-    // PUT Single request body
-    message Body {
-      // Prepared object with payload.
-      Object object = 1;
-      // Number of copies of the object to store within the RPC call. By default,
-      // object is processed according to the container's placement policy.
-      // Every number is treated as a minimal number of
-      // nodes in a corresponding placement vector that must store an object
-      // to complete the request successfully. The length MUST equal the placement
-      // vectors number, otherwise request is considered malformed.
-      repeated uint32 copies_number = 2;
-    }
-    // Body of put single object request message.
-    Body body = 1;
-  
-    // Carries request meta information. Header data is used only to regulate
-    // message transport and does not affect request execution.
-    neo.fs.v2.session.RequestMetaHeader meta_header = 2;
-  
-    // Carries request verification information. This header is used to
-    // authenticate the nodes of the message route and check the correctness of
-    // transmission.
-    neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+  // PUT Single request body
+  message Body {
+    // Prepared object with payload.
+    Object object = 1;
+    // Number of copies of the object to store within the RPC call. By default,
+    // object is processed according to the container's placement policy.
+    // Every number is treated as a minimal number of
+    // nodes in a corresponding placement vector that must store an object
+    // to complete the request successfully. The length MUST equal the placement
+    // vectors number, otherwise request is considered malformed.
+    repeated uint32 copies_number = 2;
+  }
+  // Body of put single object request message.
+  Body body = 1;
+
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
 }
 
 // Object PUT Single response
 message PutSingleResponse {
   // PUT Single Object response body
-  message Body {
-  }
+  message Body {}
   // Body of put single object response message.
   Body body = 1;
 
@@ -785,4 +865,75 @@ message PutSingleResponse {
   // authenticate the nodes of the message route and check the correctness of
   // transmission.
   neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
-}
+}
+
+// Object PATCH request
+message PatchRequest {
+  // PATCH request body
+  message Body {
+    // The address of the object that is requested to get patched.
+    neo.fs.v2.refs.Address address = 1;
+
+    // New attributes for the object. See `replace_attributes` flag usage to
+    // define how new attributes should be set.
+    repeated neo.fs.v2.object.Header.Attribute new_attributes = 2;
+
+    // If this flag is set, then the object's attributes will be entirely
+    // replaced by `new_attributes` list. The empty `new_attributes` list with
+    // `replace_attributes = true` just resets attributes list for the object.
+    //
+    // Default `false` value for this flag means the attributes will be just
+    // merged. If the incoming `new_attributes` list contains already existing
+    // key, then it just replaces it while merging the lists.
+    bool replace_attributes = 3;
+
+    // The patch for the object's payload.
+    message Patch {
+      // The range of the source object for which the payload is replaced by the
+      // patch's chunk. If the range's `length = 0`, then the patch's chunk is
+      // just appended to the original payload starting from the `offest`
+      // without any replace.
+      Range source_range = 1;
+
+      // The chunk that is being appended to or that replaces the original
+      // payload on the given range.
+      bytes chunk = 2;
+    }
+
+    // The patch that is applied for the object.
+    Patch patch = 4;
+  }
+
+  // Body for patch request message.
+  Body body = 1;
+
+  // Carries request meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.RequestMetaHeader meta_header = 2;
+
+  // Carries request verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
+}
+
+// Object PATCH response
+message PatchResponse {
+  // PATCH response body
+  message Body {
+    // The object ID of the saved patched object.
+    neo.fs.v2.refs.ObjectID object_id = 1;
+  }
+
+  // Body for patch response message.
+  Body body = 1;
+
+  // Carries response meta information. Header data is used only to regulate
+  // message transport and does not affect request execution.
+  neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
+
+  // Carries response verification information. This header is used to
+  // authenticate the nodes of the message route and check the correctness of
+  // transmission.
+  neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
+}

object/types.proto

@@ -9,13 +9,12 @@ import "refs/types.proto";
 import "session/types.proto";
 
 // Type of the object payload content. Only `REGULAR` type objects can be split,
-// hence `TOMBSTONE`, `STORAGE_GROUP` and `LOCK` payload is limited by the maximum
-// object size.
+// hence `TOMBSTONE` and `LOCK` payload is limited by the
+// maximum object size.
 //
 // String presentation of object type is the same as definition:
 // * REGULAR
 // * TOMBSTONE
-// * STORAGE_GROUP
 // * LOCK
 enum ObjectType {
   // Just a normal object
@@ -24,8 +23,8 @@ enum ObjectType {
   // Used internally to identify deleted objects
   TOMBSTONE = 1;
 
-  // StorageGroup information
-  STORAGE_GROUP = 2;
+  // Unused (previously storageGroup information)
+  // _ = 2;
 
   // Object lock
   LOCK = 3;
@@ -53,59 +52,62 @@ enum MatchType {
 message ShortHeader {
   // Object format version. Effectively, the version of API library used to
   // create particular object.
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Epoch when the object was created
-  uint64 creation_epoch = 2 [json_name = "creationEpoch"];
+  uint64 creation_epoch = 2 [ json_name = "creationEpoch" ];
 
   // Object's owner
-  neo.fs.v2.refs.OwnerID owner_id = 3 [json_name = "ownerID"];
+  neo.fs.v2.refs.OwnerID owner_id = 3 [ json_name = "ownerID" ];
 
   // Type of the object payload content
-  ObjectType object_type = 4 [json_name = "objectType"];
+  ObjectType object_type = 4 [ json_name = "objectType" ];
 
   // Size of payload in bytes.
   // `0xFFFFFFFFFFFFFFFF` means `payload_length` is unknown
-  uint64 payload_length = 5 [json_name = "payloadLength"];
+  uint64 payload_length = 5 [ json_name = "payloadLength" ];
 
   // Hash of payload bytes
-  neo.fs.v2.refs.Checksum payload_hash = 6 [json_name = "payloadHash"];
+  neo.fs.v2.refs.Checksum payload_hash = 6 [ json_name = "payloadHash" ];
 
   // Homomorphic hash of the object payload
-  neo.fs.v2.refs.Checksum homomorphic_hash = 7 [json_name = "homomorphicHash"];
+  neo.fs.v2.refs.Checksum homomorphic_hash = 7
+      [ json_name = "homomorphicHash" ];
 }
 
 // Object Header
 message Header {
   // Object format version. Effectively, the version of API library used to
   // create particular object
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Object's container
-  neo.fs.v2.refs.ContainerID container_id = 2 [json_name = "containerID"];
+  neo.fs.v2.refs.ContainerID container_id = 2 [ json_name = "containerID" ];
 
   // Object's owner
-  neo.fs.v2.refs.OwnerID owner_id = 3 [json_name = "ownerID"];
+  neo.fs.v2.refs.OwnerID owner_id = 3 [ json_name = "ownerID" ];
 
   // Object creation Epoch
-  uint64 creation_epoch = 4 [json_name = "creationEpoch"];
+  uint64 creation_epoch = 4 [ json_name = "creationEpoch" ];
 
   // Size of payload in bytes.
   // `0xFFFFFFFFFFFFFFFF` means `payload_length` is unknown.
-  uint64 payload_length = 5 [json_name = "payloadLength"];
+  uint64 payload_length = 5 [ json_name = "payloadLength" ];
 
   // Hash of payload bytes
-  neo.fs.v2.refs.Checksum payload_hash = 6 [json_name = "payloadHash"];
+  neo.fs.v2.refs.Checksum payload_hash = 6 [ json_name = "payloadHash" ];
 
   // Type of the object payload content
-  ObjectType object_type = 7 [json_name = "objectType"];
+  ObjectType object_type = 7 [ json_name = "objectType" ];
 
   // Homomorphic hash of the object payload
-  neo.fs.v2.refs.Checksum homomorphic_hash = 8 [json_name = "homomorphicHash"];
+  neo.fs.v2.refs.Checksum homomorphic_hash = 8
+      [ json_name = "homomorphicHash" ];
 
   // Session token, if it was used during Object creation. Need it to verify
   // integrity and authenticity out of Request scope.
-  neo.fs.v2.session.SessionToken session_token = 9 [json_name = "sessionToken"];
+  neo.fs.v2.session.SessionToken session_token = 9
+      [ json_name = "sessionToken" ];
 
   // `Attribute` is a user-defined Key-Value metadata pair attached to an
   // object.
@@ -114,15 +116,16 @@ message Header {
   // Objects with duplicated attribute names or attributes with empty values
   // will be considered invalid.
   //
-  // There are some "well-known" attributes starting with `__SYSTEM__` (`__NEOFS__` is deprecated) prefix
-  // that affect system behaviour:
+  // There are some "well-known" attributes starting with `__SYSTEM__`
+  // (`__NEOFS__` is deprecated) prefix that affect system behaviour:
   //
   // * [ __SYSTEM__UPLOAD_ID ] \
   //   (`__NEOFS__UPLOAD_ID` is deprecated) \
   //   Marks smaller parts of a split bigger object
   // * [ __SYSTEM__EXPIRATION_EPOCH ] \
   //   (`__NEOFS__EXPIRATION_EPOCH` is deprecated) \
-  //   Tells GC to delete object after that epoch
+  //   The epoch after which object with no LOCKs on it becomes unavailable.
+  //   Locked object continues to be available until each of the LOCKs expire.
   // * [ __SYSTEM__TICK_EPOCH ] \
   //   (`__NEOFS__TICK_EPOCH` is deprecated) \
   //   Decimal number that defines what epoch must produce
@@ -152,15 +155,15 @@ message Header {
   //   MIME Content Type of object's payload
   //
   // For detailed description of each well-known attribute please see the
-  // corresponding section in NeoFS Technical Specification.
+  // corresponding section in FrostFS Technical Specification.
   message Attribute {
     // string key to the object attribute
-    string key = 1 [json_name = "key"];
+    string key = 1 [ json_name = "key" ];
     // string value of the object attribute
-    string value = 2 [json_name = "value"];
+    string value = 2 [ json_name = "value" ];
   }
   // User-defined object attributes
-  repeated Attribute attributes = 10 [json_name = "attributes"];
+  repeated Attribute attributes = 10 [ json_name = "attributes" ];
 
   // Bigger objects can be split into a chain of smaller objects. Information
   // about inter-dependencies between spawned objects and how to re-construct
@@ -168,54 +171,84 @@ message Header {
   // must be within the same container.
   message Split {
     // Identifier of the origin object. Known only to the minor child.
-    neo.fs.v2.refs.ObjectID parent = 1 [json_name = "parent"];
+    neo.fs.v2.refs.ObjectID parent = 1 [ json_name = "parent" ];
 
     // Identifier of the left split neighbor
-    neo.fs.v2.refs.ObjectID previous = 2 [json_name = "previous"];
+    neo.fs.v2.refs.ObjectID previous = 2 [ json_name = "previous" ];
 
     // `signature` field of the parent object. Used to reconstruct parent.
-    neo.fs.v2.refs.Signature parent_signature = 3 [json_name = "parentSignature"];
+    neo.fs.v2.refs.Signature parent_signature = 3
+        [ json_name = "parentSignature" ];
 
     // `header` field of the parent object. Used to reconstruct parent.
-    Header parent_header = 4 [json_name = "parentHeader"];
+    Header parent_header = 4 [ json_name = "parentHeader" ];
 
     // List of identifiers of the objects generated by splitting current one.
-    repeated neo.fs.v2.refs.ObjectID children = 5 [json_name = "children"];
+    repeated neo.fs.v2.refs.ObjectID children = 5 [ json_name = "children" ];
 
     // 16 byte UUIDv4 used to identify the split object hierarchy parts. Must be
     // unique inside container. All objects participating in the split must have
     // the same `split_id` value.
-    bytes split_id = 6 [json_name = "splitID"];
-
+    bytes split_id = 6 [ json_name = "splitID" ];
   }
   // Position of the object in the split hierarchy
-  Split split = 11 [json_name = "split"];
+  Split split = 11 [ json_name = "split" ];
+
+  // Erasure code can be applied to any object.
+  // Information about encoded object structure is stored in `EC` header.
+  // All objects belonging to a single EC group have the same `parent` field.
+  message EC {
+    // Identifier of the origin object. Known to all chunks.
+    neo.fs.v2.refs.ObjectID parent = 1 [ json_name = "parent" ];
+    // Index of this chunk.
+    uint32 index = 2 [ json_name = "index" ];
+    // Total number of chunks in this split.
+    uint32 total = 3 [ json_name = "total" ];
+    // Total length of a parent header. Used to trim padding zeroes.
+    uint32 header_length = 4 [ json_name = "headerLength" ];
+    // Chunk of a parent header.
+    bytes header = 5 [ json_name = "header" ];
+    // As the origin object is EC-splitted its identifier is known to all
+    // chunks as parent. But parent itself can be a part of Split (does not
+    // relate to EC-split). In this case parent_split_id should be set.
+    bytes parent_split_id = 6 [ json_name = "parentSplitID" ];
+    // EC-parent's parent ID. parent_split_parent_id is set if EC-parent,
+    // itself, is a part of Split and if an object ID of its parent is
+    // presented. The field allows to determine how EC-chunk is placed in Split
+    // hierarchy.
+    neo.fs.v2.refs.ObjectID parent_split_parent_id = 7
+        [ json_name = "parentSplitParentID" ];
+    // EC parent's attributes.
+    repeated Attribute parent_attributes = 8 [ json_name = "parentAttributes" ];
+  }
+  // Erasure code chunk information.
+  EC ec = 12 [ json_name = "ec" ];
 }
 
 // Object structure. Object is immutable and content-addressed. It means
-// `ObjectID` will change if the header or the payload changes. It's calculated as a
-// hash of header field which contains hash of the object's payload.
+// `ObjectID` will change if the header or the payload changes. It's calculated
+// as a hash of header field which contains hash of the object's payload.
 //
 // For non-regular object types payload format depends on object type specified
 // in the header.
 message Object {
   // Object's unique identifier.
-  neo.fs.v2.refs.ObjectID object_id = 1 [json_name = "objectID"];
+  neo.fs.v2.refs.ObjectID object_id = 1 [ json_name = "objectID" ];
 
   // Signed object_id
-  neo.fs.v2.refs.Signature signature = 2 [json_name = "signature"];
+  neo.fs.v2.refs.Signature signature = 2 [ json_name = "signature" ];
 
   // Object metadata headers
-  Header header = 3 [json_name = "header"];
+  Header header = 3 [ json_name = "header" ];
 
   // Payload bytes
-  bytes payload = 4 [json_name = "payload"];
+  bytes payload = 4 [ json_name = "payload" ];
 }
 
 // Meta information of split hierarchy for object assembly. With the last part
 // one can traverse linked list of split hierarchy back to the first part and
-// assemble the original object. With a linking object one can assemble an object
-// right from the object parts.
+// assemble the original object. With a linking object one can assemble an
+// object right from the object parts.
 message SplitInfo {
   // 16 byte UUID used to identify the split object hierarchy parts.
   bytes split_id = 1;
@@ -229,3 +262,17 @@ message SplitInfo {
   // object parts.
   neo.fs.v2.refs.ObjectID link = 3;
 }
+
+// Meta information for the erasure-encoded object.
+message ECInfo {
+  message Chunk {
+    // Object ID of the chunk.
+    neo.fs.v2.refs.ObjectID id = 1;
+    // Index of the chunk.
+    uint32 index = 2;
+    // Total number of chunks in this split.
+    uint32 total = 3;
+  }
+  // Chunk stored on the node.
+  repeated Chunk chunks = 1;
+}

proto-docs/accounting.md

@@ -4,21 +4,21 @@
 ## Table of Contents
 
 - [accounting/service.proto](#accounting/service.proto)
- - Services
-    - [AccountingService](#neo.fs.v2.accounting.AccountingService)
-    
+  - Services
+      - [AccountingService](#neo.fs.v2.accounting.AccountingService)
+
   - Messages
-    - [BalanceRequest](#neo.fs.v2.accounting.BalanceRequest)
-    - [BalanceRequest.Body](#neo.fs.v2.accounting.BalanceRequest.Body)
-    - [BalanceResponse](#neo.fs.v2.accounting.BalanceResponse)
-    - [BalanceResponse.Body](#neo.fs.v2.accounting.BalanceResponse.Body)
-    
+      - [BalanceRequest](#neo.fs.v2.accounting.BalanceRequest)
+      - [BalanceRequest.Body](#neo.fs.v2.accounting.BalanceRequest.Body)
+      - [BalanceResponse](#neo.fs.v2.accounting.BalanceResponse)
+      - [BalanceResponse.Body](#neo.fs.v2.accounting.BalanceResponse.Body)
+
 
 - [accounting/types.proto](#accounting/types.proto)
 
   - Messages
-    - [Decimal](#neo.fs.v2.accounting.Decimal)
-    
+      - [Decimal](#neo.fs.v2.accounting.Decimal)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -35,11 +35,11 @@
 <a name="neo.fs.v2.accounting.AccountingService"></a>
 
 ### Service "neo.fs.v2.accounting.AccountingService"
-Accounting service provides methods for interaction with NeoFS sidechain via
-other NeoFS nodes to get information about the account balance. Deposit and
-Withdraw operations can't be implemented here, as they require Mainnet NeoFS
-smart contract invocation. Transfer operations between internal NeoFS
-accounts are possible if both use the same token type.
+Accounting service provides methods for interaction with FrostFS sidechain
+via other FrostFS nodes to get information about the account balance. Deposit
+and Withdraw operations can't be implemented here, as they require Mainnet
+FrostFS smart contract invocation. Transfer operations between internal
+FrostFS accounts are possible if both use the same token type.
 
 ```
 rpc Balance(BalanceRequest) returns (BalanceResponse);
@@ -48,7 +48,7 @@ rpc Balance(BalanceRequest) returns (BalanceResponse);
 
 #### Method Balance
 
-Returns the amount of funds in GAS token for the requested NeoFS account.
+Returns the amount of funds in GAS token for the requested FrostFS account.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS):
@@ -78,9 +78,9 @@ BalanceRequest message
 
 ### Message BalanceRequest.Body
 To indicate the account for which the balance is requested, its identifier
-is used. It can be any existing account in NeoFS sidechain `Balance` smart
-contract. If omitted, client implementation MUST set it to the request's
-signer `OwnerID`.
+is used. It can be any existing account in FrostFS sidechain `Balance`
+smart contract. If omitted, client implementation MUST set it to the
+request's signer `OwnerID`.
 
 
 | Field | Type | Label | Description |
@@ -105,7 +105,8 @@ BalanceResponse message
 
 ### Message BalanceResponse.Body
 The amount of funds in GAS token for the `OwnerID`'s account requested.
-Balance is given in the `Decimal` format to avoid precision issues with rounding.
+Balance is given in the `Decimal` format to avoid precision issues with
+rounding.
 
 
 | Field | Type | Label | Description |
@@ -130,7 +131,7 @@ Balance is given in the `Decimal` format to avoid precision issues with rounding
 <a name="neo.fs.v2.accounting.Decimal"></a>
 
 ### Message Decimal
-Standard floating point data type can't be used in NeoFS due to inexactness
+Standard floating point data type can't be used in FrostFS due to inexactness
 of the result when doing lots of small number operations. To solve the lost
 precision issue, special `Decimal` format is used for monetary computations.
 
@@ -169,4 +170,3 @@ description.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/acl.md

@@ -6,14 +6,15 @@
 - [acl/types.proto](#acl/types.proto)
 
   - Messages
-    - [BearerToken](#neo.fs.v2.acl.BearerToken)
-    - [BearerToken.Body](#neo.fs.v2.acl.BearerToken.Body)
-    - [BearerToken.Body.TokenLifetime](#neo.fs.v2.acl.BearerToken.Body.TokenLifetime)
-    - [EACLRecord](#neo.fs.v2.acl.EACLRecord)
-    - [EACLRecord.Filter](#neo.fs.v2.acl.EACLRecord.Filter)
-    - [EACLRecord.Target](#neo.fs.v2.acl.EACLRecord.Target)
-    - [EACLTable](#neo.fs.v2.acl.EACLTable)
-    
+      - [BearerToken](#neo.fs.v2.acl.BearerToken)
+      - [BearerToken.Body](#neo.fs.v2.acl.BearerToken.Body)
+      - [BearerToken.Body.APEOverride](#neo.fs.v2.acl.BearerToken.Body.APEOverride)
+      - [BearerToken.Body.TokenLifetime](#neo.fs.v2.acl.BearerToken.Body.TokenLifetime)
+      - [EACLRecord](#neo.fs.v2.acl.EACLRecord)
+      - [EACLRecord.Filter](#neo.fs.v2.acl.EACLRecord.Filter)
+      - [EACLRecord.Target](#neo.fs.v2.acl.EACLRecord.Target)
+      - [EACLTable](#neo.fs.v2.acl.EACLTable)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -38,8 +39,8 @@ like [JWT](https://jwt.io), it has a limited lifetime and scope, hence can be
 used in the similar use cases, like providing authorisation to externally
 authenticated party.
 
-BearerToken can be issued only by the container's owner and must be signed using
-the key associated with the container's `OwnerID`.
+BearerToken can be issued only by the container's owner and must be signed
+using the key associated with the container's `OwnerID`.
 
 
 | Field | Type | Label | Description |
@@ -51,16 +52,37 @@ the key associated with the container's `OwnerID`.
 <a name="neo.fs.v2.acl.BearerToken.Body"></a>
 
 ### Message BearerToken.Body
-Bearer Token body structure contains Extended ACL table issued by the container
-owner with additional information preventing token abuse.
+Bearer Token body structure contains Extended ACL table issued by the
+container owner with additional information preventing token abuse.
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| eacl_table | [EACLTable](#neo.fs.v2.acl.EACLTable) |  | Table of Extended ACL rules to use instead of the ones attached to the container. If it contains `container_id` field, bearer token is only valid for this specific container. Otherwise, any container of the same owner is allowed. |
+| eacl_table | [EACLTable](#neo.fs.v2.acl.EACLTable) |  | Table of Extended ACL rules to use instead of the ones attached to the container. If it contains `container_id` field, bearer token is only valid for this specific container. Otherwise, any container of the same owner is allowed.
+
+Deprecated: eACL tables are no longer relevant - `APEOverrides` should be used instead. |
 | owner_id | [neo.fs.v2.refs.OwnerID](#neo.fs.v2.refs.OwnerID) |  | `OwnerID` defines to whom the token was issued. It must match the request originator's `OwnerID`. If empty, any token bearer will be accepted. |
 | lifetime | [BearerToken.Body.TokenLifetime](#neo.fs.v2.acl.BearerToken.Body.TokenLifetime) |  | Token expiration and valid time period parameters |
 | allow_impersonate | [bool](#bool) |  | AllowImpersonate flag to consider token signer as request owner. If this field is true extended ACL table in token body isn't processed. |
+| ape_override | [BearerToken.Body.APEOverride](#neo.fs.v2.acl.BearerToken.Body.APEOverride) |  | APE override for the target. |
+
+
+<a name="neo.fs.v2.acl.BearerToken.Body.APEOverride"></a>
+
+### Message BearerToken.Body.APEOverride
+APEOverride is the list of APE chains defined for a target.
+These chains are meant to serve as overrides to the already defined (or
+even undefined) APE chains for the target (see contract `Policy`).
+
+The server-side processing of the bearer token with set APE overrides
+must verify if a client is permitted to override chains for the target,
+preventing unauthorized access through the APE mechanism.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| target | [frostfs.v2.ape.ChainTarget](#frostfs.v2.ape.ChainTarget) |  | Target for which chains are applied. |
+| chains | [frostfs.v2.ape.Chain](#frostfs.v2.ape.Chain) | repeated | The list of APE chains. |
 
 
 <a name="neo.fs.v2.acl.BearerToken.Body.TokenLifetime"></a>
@@ -85,7 +107,7 @@ Describes a single eACL rule.
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| operation | [Operation](#neo.fs.v2.acl.Operation) |  | NeoFS request Verb to match |
+| operation | [Operation](#neo.fs.v2.acl.Operation) |  | FrostFS request Verb to match |
 | action | [Action](#neo.fs.v2.acl.Action) |  | Rule execution result. Either allows or denies access if filters match. |
 | filters | [EACLRecord.Filter](#neo.fs.v2.acl.EACLRecord.Filter) | repeated | List of filters to match and see if rule is applicable |
 | targets | [EACLRecord.Target](#neo.fs.v2.acl.EACLRecord.Target) | repeated | List of target subjects to apply ACL rule to |
@@ -153,7 +175,7 @@ keys to match.
 Extended ACL rules table. A list of ACL rules defined additionally to Basic
 ACL. Extended ACL rules can be attached to a container and can be updated
 or may be defined in `BearerToken` structure. Please see the corresponding
-NeoFS Technical Specification section for detailed description.
+FrostFS Technical Specification section for detailed description.
 
 
 | Field | Type | Label | Description |
@@ -189,7 +211,7 @@ Enumeration of possible sources of Headers to apply filters.
 | HEADER_UNSPECIFIED | 0 | Unspecified header, default value. |
 | REQUEST | 1 | Filter request headers |
 | OBJECT | 2 | Filter object headers |
-| SERVICE | 3 | Filter service headers. These are not processed by NeoFS nodes and exist for service use only. |
+| SERVICE | 3 | Filter service headers. These are not processed by FrostFS nodes and exist for service use only. |
 
 
 
@@ -261,4 +283,3 @@ Target role of the access control rule in access control list.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/ape.md

@@ -3,64 +3,63 @@
 
 ## Table of Contents
 
-- [bootstrap/types.proto](#bootstrap/types.proto)
+- [ape/types.proto](#ape/types.proto)
 
   - Messages
-    - [NodeInfo](#bootstrap.NodeInfo)
-    - [NodeInfo.Attribute](#bootstrap.NodeInfo.Attribute)
-    
+      - [Chain](#frostfs.v2.ape.Chain)
+      - [ChainTarget](#frostfs.v2.ape.ChainTarget)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
 
 
-<a name="bootstrap/types.proto"></a>
+<a name="ape/types.proto"></a>
 <p align="right"><a href="#top">Top</a></p>
 
-## bootstrap/types.proto
+## ape/types.proto
 
 
  <!-- end services -->
 
 
-<a name="bootstrap.NodeInfo"></a>
+<a name="frostfs.v2.ape.Chain"></a>
 
-### Message NodeInfo
-Groups the information about the NeoFS node.
+### Message Chain
+Chain is a chain of rules defined for a specific target.
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| Address | [string](#string) |  | Carries network address of the NeoFS node. |
-| PublicKey | [bytes](#bytes) |  | Carries public key of the NeoFS node in a binary format. |
-| Attributes | [NodeInfo.Attribute](#bootstrap.NodeInfo.Attribute) | repeated | Carries list of the NeoFS node attributes in a string key-value format. |
-| state | [NodeInfo.State](#bootstrap.NodeInfo.State) |  | Carries state of the NeoFS node. |
+| raw | [bytes](#bytes) |  | Raw representation of a serizalized rule chain. |
 
 
-<a name="bootstrap.NodeInfo.Attribute"></a>
+<a name="frostfs.v2.ape.ChainTarget"></a>
 
-### Message NodeInfo.Attribute
-Groups attributes of the NeoFS node.
+### Message ChainTarget
+ChainTarget is an object to which a rule chain is defined.
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| Key | [string](#string) |  | Carries string key to the node attribute. |
-| Value | [string](#string) |  | Carries string value of the node attribute. |
+| type | [TargetType](#frostfs.v2.ape.TargetType) |  |  |
+| name | [string](#string) |  |  |
 
  <!-- end messages -->
 
 
-<a name="bootstrap.NodeInfo.State"></a>
+<a name="frostfs.v2.ape.TargetType"></a>
 
-### NodeInfo.State
-Represents the enumeration of various states of the NeoFS node.
+### TargetType
+TargetType is a type target to which a rule chain is defined.
 
 | Name | Number | Description |
 | ---- | ------ | ----------- |
-| Unknown | 0 | Undefined state. |
-| Online | 1 | Active state on the network. |
-| Offline | 2 | Network unavailable state. |
+| UNDEFINED | 0 |  |
+| NAMESPACE | 1 |  |
+| CONTAINER | 2 |  |
+| USER | 3 |  |
+| GROUP | 4 |  |
 
 
  <!-- end enums -->
@@ -86,4 +85,3 @@ Represents the enumeration of various states of the NeoFS node.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/apemanager.md

@@ -0,0 +1,269 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [apemanager/service.proto](#apemanager/service.proto)
+  - Services
+      - [APEManagerService](#frostfs.v2.apemanager.APEManagerService)
+
+  - Messages
+      - [AddChainRequest](#frostfs.v2.apemanager.AddChainRequest)
+      - [AddChainRequest.Body](#frostfs.v2.apemanager.AddChainRequest.Body)
+      - [AddChainResponse](#frostfs.v2.apemanager.AddChainResponse)
+      - [AddChainResponse.Body](#frostfs.v2.apemanager.AddChainResponse.Body)
+      - [ListChainsRequest](#frostfs.v2.apemanager.ListChainsRequest)
+      - [ListChainsRequest.Body](#frostfs.v2.apemanager.ListChainsRequest.Body)
+      - [ListChainsResponse](#frostfs.v2.apemanager.ListChainsResponse)
+      - [ListChainsResponse.Body](#frostfs.v2.apemanager.ListChainsResponse.Body)
+      - [RemoveChainRequest](#frostfs.v2.apemanager.RemoveChainRequest)
+      - [RemoveChainRequest.Body](#frostfs.v2.apemanager.RemoveChainRequest.Body)
+      - [RemoveChainResponse](#frostfs.v2.apemanager.RemoveChainResponse)
+      - [RemoveChainResponse.Body](#frostfs.v2.apemanager.RemoveChainResponse.Body)
+
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="apemanager/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## apemanager/service.proto
+
+
+
+
+<a name="frostfs.v2.apemanager.APEManagerService"></a>
+
+### Service "frostfs.v2.apemanager.APEManagerService"
+`APEManagerService` provides API to manage rule chains within sidechain's
+`Policy` smart contract.
+
+```
+rpc AddChain(AddChainRequest) returns (AddChainResponse);
+rpc RemoveChain(RemoveChainRequest) returns (RemoveChainResponse);
+rpc ListChains(ListChainsRequest) returns (ListChainsResponse);
+
+```
+
+#### Method AddChain
+
+Add a rule chain for a specific target to `Policy` smart contract.
+
+Statuses:
+- **OK** (0, SECTION_SUCCESS): \
+  the chain has been successfully added;
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  container (as target) not found;
+- **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  the operation is denied by the service.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| AddChain | [AddChainRequest](#frostfs.v2.apemanager.AddChainRequest) | [AddChainResponse](#frostfs.v2.apemanager.AddChainResponse) |
+#### Method RemoveChain
+
+Remove a rule chain for a specific target from `Policy` smart contract.
+RemoveChain is an idempotent operation: removal of non-existing rule chain
+also means success.
+
+Statuses:
+- **OK** (0, SECTION_SUCCESS): \
+  the chain has been successfully removed;
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  container (as target) not found;
+- **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  the operation is denied by the service.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| RemoveChain | [RemoveChainRequest](#frostfs.v2.apemanager.RemoveChainRequest) | [RemoveChainResponse](#frostfs.v2.apemanager.RemoveChainResponse) |
+#### Method ListChains
+
+List chains defined for a specific target from `Policy` smart contract.
+
+Statuses:
+- **OK** (0, SECTION_SUCCESS): \
+  chains have been successfully listed;
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  container (as target) not found;
+- **APE_MANAGER_ACCESS_DENIED** (5120, SECTION_APE_MANAGER): \
+  the operation is denied by the service.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| ListChains | [ListChainsRequest](#frostfs.v2.apemanager.ListChainsRequest) | [ListChainsResponse](#frostfs.v2.apemanager.ListChainsResponse) |
+ <!-- end services -->
+
+
+<a name="frostfs.v2.apemanager.AddChainRequest"></a>
+
+### Message AddChainRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [AddChainRequest.Body](#frostfs.v2.apemanager.AddChainRequest.Body) |  | The request's body. |
+| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.AddChainRequest.Body"></a>
+
+### Message AddChainRequest.Body
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| target | [frostfs.v2.ape.ChainTarget](#frostfs.v2.ape.ChainTarget) |  | A target for which a rule chain is added. |
+| chain | [frostfs.v2.ape.Chain](#frostfs.v2.ape.Chain) |  | The chain to set for the target. |
+
+
+<a name="frostfs.v2.apemanager.AddChainResponse"></a>
+
+### Message AddChainResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [AddChainResponse.Body](#frostfs.v2.apemanager.AddChainResponse.Body) |  | The response's body. |
+| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.AddChainResponse.Body"></a>
+
+### Message AddChainResponse.Body
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| chain_id | [bytes](#bytes) |  | Chain ID assigned for the added rule chain. If chain ID is left empty in the request, then it will be generated. |
+
+
+<a name="frostfs.v2.apemanager.ListChainsRequest"></a>
+
+### Message ListChainsRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [ListChainsRequest.Body](#frostfs.v2.apemanager.ListChainsRequest.Body) |  | The request's body. |
+| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.ListChainsRequest.Body"></a>
+
+### Message ListChainsRequest.Body
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| target | [frostfs.v2.ape.ChainTarget](#frostfs.v2.ape.ChainTarget) |  | Target for which rule chains are listed. |
+
+
+<a name="frostfs.v2.apemanager.ListChainsResponse"></a>
+
+### Message ListChainsResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [ListChainsResponse.Body](#frostfs.v2.apemanager.ListChainsResponse.Body) |  | The response's body. |
+| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.ListChainsResponse.Body"></a>
+
+### Message ListChainsResponse.Body
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| chains | [frostfs.v2.ape.Chain](#frostfs.v2.ape.Chain) | repeated | The list of chains defined for the reqeusted target. |
+
+
+<a name="frostfs.v2.apemanager.RemoveChainRequest"></a>
+
+### Message RemoveChainRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [RemoveChainRequest.Body](#frostfs.v2.apemanager.RemoveChainRequest.Body) |  | The request's body. |
+| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.RemoveChainRequest.Body"></a>
+
+### Message RemoveChainRequest.Body
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| target | [frostfs.v2.ape.ChainTarget](#frostfs.v2.ape.ChainTarget) |  | Target for which a rule chain is removed. |
+| chain_id | [bytes](#bytes) |  | Chain ID assigned for the rule chain. |
+
+
+<a name="frostfs.v2.apemanager.RemoveChainResponse"></a>
+
+### Message RemoveChainResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [RemoveChainResponse.Body](#frostfs.v2.apemanager.RemoveChainResponse.Body) |  | The response's body. |
+| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="frostfs.v2.apemanager.RemoveChainResponse.Body"></a>
+
+### Message RemoveChainResponse.Body
+Since RemoveChain is an idempotent operation, then the only indicator that
+operation could not be performed is an error returning to a client.
+
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |

proto-docs/audit.md

@@ -1,74 +0,0 @@
-# Protocol Documentation
-<a name="top"></a>
-
-## Table of Contents
-
-- [audit/types.proto](#audit/types.proto)
-
-  - Messages
-    - [DataAuditResult](#neo.fs.v2.audit.DataAuditResult)
-    
-
-- [Scalar Value Types](#scalar-value-types)
-
-
-
-<a name="audit/types.proto"></a>
-<p align="right"><a href="#top">Top</a></p>
-
-## audit/types.proto
-
-
- <!-- end services -->
-
-
-<a name="neo.fs.v2.audit.DataAuditResult"></a>
-
-### Message DataAuditResult
-DataAuditResult keeps record of conducted Data Audits. The detailed report is
-generated separately.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| version | [neo.fs.v2.refs.Version](#neo.fs.v2.refs.Version) |  | Data Audit Result format version. Effectively, the version of API library used to report DataAuditResult structure. |
-| audit_epoch | [fixed64](#fixed64) |  | Epoch number when the Data Audit was conducted |
-| container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Container under audit |
-| public_key | [bytes](#bytes) |  | Public key of the auditing InnerRing node in a binary format |
-| complete | [bool](#bool) |  | Shows if Data Audit process was complete in time or if it was cancelled |
-| requests | [uint32](#uint32) |  | Number of request done at PoR stage |
-| retries | [uint32](#uint32) |  | Number of retries done at PoR stage |
-| pass_sg | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | List of Storage Groups that passed audit PoR stage |
-| fail_sg | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | List of Storage Groups that failed audit PoR stage |
-| hit | [uint32](#uint32) |  | Number of sampled objects under the audit placed in an optimal way according to the containers placement policy when checking PoP |
-| miss | [uint32](#uint32) |  | Number of sampled objects under the audit placed in suboptimal way according to the containers placement policy, but still at a satisfactory level when checking PoP |
-| fail | [uint32](#uint32) |  | Number of sampled objects under the audit stored inconsistently with the placement policy or not found at all when checking PoP |
-| pass_nodes | [bytes](#bytes) | repeated | List of storage node public keys that passed at least one PDP |
-| fail_nodes | [bytes](#bytes) | repeated | List of storage node public keys that failed at least one PDP |
-
- <!-- end messages -->
-
- <!-- end enums -->
-
-
-
-## Scalar Value Types
-
-| .proto Type | Notes | C++ Type | Java Type | Python Type |
-| ----------- | ----- | -------- | --------- | ----------- |
-| <a name="double" /> double |  | double | double | float |
-| <a name="float" /> float |  | float | float | float |
-| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
-| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
-| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
-| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
-| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
-| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
-| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
-| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
-| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
-| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
-| <a name="bool" /> bool |  | bool | boolean | boolean |
-| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
-| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/container.md

@@ -3,50 +3,37 @@
 
 ## Table of Contents
 
-- [Protocol Documentation](#protocol-documentation)
-  - [Table of Contents](#table-of-contents)
-  - [container/service.proto](#containerserviceproto)
-    - [Service "neo.fs.v2.container.ContainerService"](#service-neofsv2containercontainerservice)
-      - [Method Put](#method-put)
-      - [Method Delete](#method-delete)
-      - [Method Get](#method-get)
-      - [Method List](#method-list)
-      - [Method SetExtendedACL](#method-setextendedacl)
-      - [Method GetExtendedACL](#method-getextendedacl)
-      - [Method AnnounceUsedSpace](#method-announceusedspace)
-    - [Message AnnounceUsedSpaceRequest](#message-announceusedspacerequest)
-    - [Message AnnounceUsedSpaceRequest.Body](#message-announceusedspacerequestbody)
-    - [Message AnnounceUsedSpaceRequest.Body.Announcement](#message-announceusedspacerequestbodyannouncement)
-    - [Message AnnounceUsedSpaceResponse](#message-announceusedspaceresponse)
-    - [Message AnnounceUsedSpaceResponse.Body](#message-announceusedspaceresponsebody)
-    - [Message DeleteRequest](#message-deleterequest)
-    - [Message DeleteRequest.Body](#message-deleterequestbody)
-    - [Message DeleteResponse](#message-deleteresponse)
-    - [Message DeleteResponse.Body](#message-deleteresponsebody)
-    - [Message GetExtendedACLRequest](#message-getextendedaclrequest)
-    - [Message GetExtendedACLRequest.Body](#message-getextendedaclrequestbody)
-    - [Message GetExtendedACLResponse](#message-getextendedaclresponse)
-    - [Message GetExtendedACLResponse.Body](#message-getextendedaclresponsebody)
-    - [Message GetRequest](#message-getrequest)
-    - [Message GetRequest.Body](#message-getrequestbody)
-    - [Message GetResponse](#message-getresponse)
-    - [Message GetResponse.Body](#message-getresponsebody)
-    - [Message ListRequest](#message-listrequest)
-    - [Message ListRequest.Body](#message-listrequestbody)
-    - [Message ListResponse](#message-listresponse)
-    - [Message ListResponse.Body](#message-listresponsebody)
-    - [Message PutRequest](#message-putrequest)
-    - [Message PutRequest.Body](#message-putrequestbody)
-    - [Message PutResponse](#message-putresponse)
-    - [Message PutResponse.Body](#message-putresponsebody)
-    - [Message SetExtendedACLRequest](#message-setextendedaclrequest)
-    - [Message SetExtendedACLRequest.Body](#message-setextendedaclrequestbody)
-    - [Message SetExtendedACLResponse](#message-setextendedaclresponse)
-    - [Message SetExtendedACLResponse.Body](#message-setextendedaclresponsebody)
-  - [container/types.proto](#containertypesproto)
-    - [Message Container](#message-container)
-    - [Message Container.Attribute](#message-containerattribute)
-  - [Scalar Value Types](#scalar-value-types)
+- [container/service.proto](#container/service.proto)
+  - Services
+      - [ContainerService](#neo.fs.v2.container.ContainerService)
+
+  - Messages
+      - [DeleteRequest](#neo.fs.v2.container.DeleteRequest)
+      - [DeleteRequest.Body](#neo.fs.v2.container.DeleteRequest.Body)
+      - [DeleteResponse](#neo.fs.v2.container.DeleteResponse)
+      - [DeleteResponse.Body](#neo.fs.v2.container.DeleteResponse.Body)
+      - [GetRequest](#neo.fs.v2.container.GetRequest)
+      - [GetRequest.Body](#neo.fs.v2.container.GetRequest.Body)
+      - [GetResponse](#neo.fs.v2.container.GetResponse)
+      - [GetResponse.Body](#neo.fs.v2.container.GetResponse.Body)
+      - [ListRequest](#neo.fs.v2.container.ListRequest)
+      - [ListRequest.Body](#neo.fs.v2.container.ListRequest.Body)
+      - [ListResponse](#neo.fs.v2.container.ListResponse)
+      - [ListResponse.Body](#neo.fs.v2.container.ListResponse.Body)
+      - [PutRequest](#neo.fs.v2.container.PutRequest)
+      - [PutRequest.Body](#neo.fs.v2.container.PutRequest.Body)
+      - [PutResponse](#neo.fs.v2.container.PutResponse)
+      - [PutResponse.Body](#neo.fs.v2.container.PutResponse.Body)
+
+
+- [container/types.proto](#container/types.proto)
+
+  - Messages
+      - [Container](#neo.fs.v2.container.Container)
+      - [Container.Attribute](#neo.fs.v2.container.Container.Attribute)
+
+
+- [Scalar Value Types](#scalar-value-types)
 
 
 
@@ -62,8 +49,8 @@
 
 ### Service "neo.fs.v2.container.ContainerService"
 `ContainerService` provides API to interact with `Container` smart contract
-in NeoFS sidechain via other NeoFS nodes. All of those actions can be done
-equivalently by directly issuing transactions and RPC calls to sidechain
+in FrostFS sidechain via other FrostFS nodes. All of those actions can be
+done equivalently by directly issuing transactions and RPC calls to sidechain
 nodes.
 
 ```
@@ -71,9 +58,6 @@ rpc Put(PutRequest) returns (PutResponse);
 rpc Delete(DeleteRequest) returns (DeleteResponse);
 rpc Get(GetRequest) returns (GetResponse);
 rpc List(ListRequest) returns (ListResponse);
-rpc SetExtendedACL(SetExtendedACLRequest) returns (SetExtendedACLResponse);
-rpc GetExtendedACL(GetExtendedACLRequest) returns (GetExtendedACLResponse);
-rpc AnnounceUsedSpace(AnnounceUsedSpaceRequest) returns (AnnounceUsedSpaceResponse);
 
 ```
 
@@ -81,13 +65,15 @@ rpc AnnounceUsedSpace(AnnounceUsedSpaceRequest) returns (AnnounceUsedSpaceRespon
 
 `Put` invokes `Container` smart contract's `Put` method and returns
 response immediately. After a new block is issued in sidechain, request is
-verified by Inner Ring nodes. After one more block in sidechain, the container
-is added into smart contract storage.
+verified by Inner Ring nodes. After one more block in sidechain, the
+container is added into smart contract storage.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS): \
   request to save the container has been sent to the sidechain;
-- Common failures (SECTION_FAILURE_COMMON).
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  container create access denied.
 
 | Name | Input | Output |
 | ---- | ----- | ------ |
@@ -96,13 +82,15 @@ Statuses:
 
 `Delete` invokes `Container` smart contract's `Delete` method and returns
 response immediately. After a new block is issued in sidechain, request is
-verified by Inner Ring nodes. After one more block in sidechain, the container
-is added into smart contract storage.
+verified by Inner Ring nodes. After one more block in sidechain, the
+container is added into smart contract storage.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS): \
   request to remove the container has been sent to the sidechain;
-- Common failures (SECTION_FAILURE_COMMON).
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  container delete access denied.
 
 | Name | Input | Output |
 | ---- | ----- | ------ |
@@ -116,7 +104,9 @@ Statuses:
   container has been successfully read;
 - Common failures (SECTION_FAILURE_COMMON);
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
-  requested container not found.
+  requested container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied.
 
 | Name | Input | Output |
 | ---- | ----- | ------ |
@@ -128,115 +118,16 @@ Returns all owner's containers from 'Container` smart contract' storage.
 Statuses:
 - **OK** (0, SECTION_SUCCESS): \
   container list has been successfully read;
-- Common failures (SECTION_FAILURE_COMMON).
+- Common failures (SECTION_FAILURE_COMMON);
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  container list access denied.
 
 | Name | Input | Output |
 | ---- | ----- | ------ |
 | List | [ListRequest](#neo.fs.v2.container.ListRequest) | [ListResponse](#neo.fs.v2.container.ListResponse) |
-#### Method SetExtendedACL
-
-Invokes 'SetEACL' method of 'Container` smart contract and returns response
-immediately. After one more block in sidechain, changes in an Extended ACL are
-added into smart contract storage.
-
-Statuses:
-- **OK** (0, SECTION_SUCCESS): \
-  request to save container eACL has been sent to the sidechain;
-- Common failures (SECTION_FAILURE_COMMON).
-
-| Name | Input | Output |
-| ---- | ----- | ------ |
-| SetExtendedACL | [SetExtendedACLRequest](#neo.fs.v2.container.SetExtendedACLRequest) | [SetExtendedACLResponse](#neo.fs.v2.container.SetExtendedACLResponse) |
-#### Method GetExtendedACL
-
-Returns Extended ACL table and signature from `Container` smart contract
-storage.
-
-Statuses:
-- **OK** (0, SECTION_SUCCESS): \
-  container eACL has been successfully read;
-- Common failures (SECTION_FAILURE_COMMON);
-- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
-  container not found;
-- **EACL_NOT_FOUND** (3073, SECTION_CONTAINER): \
-  eACL table not found.
-
-| Name | Input | Output |
-| ---- | ----- | ------ |
-| GetExtendedACL | [GetExtendedACLRequest](#neo.fs.v2.container.GetExtendedACLRequest) | [GetExtendedACLResponse](#neo.fs.v2.container.GetExtendedACLResponse) |
-#### Method AnnounceUsedSpace
-
-Announces the space values used by the container for P2P synchronization.
-
-Statuses:
-- **OK** (0, SECTION_SUCCESS): \
-  estimation of used space has been successfully announced;
-- Common failures (SECTION_FAILURE_COMMON).
-
-| Name | Input | Output |
-| ---- | ----- | ------ |
-| AnnounceUsedSpace | [AnnounceUsedSpaceRequest](#neo.fs.v2.container.AnnounceUsedSpaceRequest) | [AnnounceUsedSpaceResponse](#neo.fs.v2.container.AnnounceUsedSpaceResponse) |
  <!-- end services -->
 
 
-<a name="neo.fs.v2.container.AnnounceUsedSpaceRequest"></a>
-
-### Message AnnounceUsedSpaceRequest
-Announce container used space
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [AnnounceUsedSpaceRequest.Body](#neo.fs.v2.container.AnnounceUsedSpaceRequest.Body) |  | Body of announce used space request message. |
-| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.AnnounceUsedSpaceRequest.Body"></a>
-
-### Message AnnounceUsedSpaceRequest.Body
-Container used space announcement body.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| announcements | [AnnounceUsedSpaceRequest.Body.Announcement](#neo.fs.v2.container.AnnounceUsedSpaceRequest.Body.Announcement) | repeated | List of announcements. If nodes share several containers, announcements are transferred in a batch. |
-
-
-<a name="neo.fs.v2.container.AnnounceUsedSpaceRequest.Body.Announcement"></a>
-
-### Message AnnounceUsedSpaceRequest.Body.Announcement
-Announcement contains used space information for a single container.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| epoch | [uint64](#uint64) |  | Epoch number for which the container size estimation was produced. |
-| container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Identifier of the container. |
-| used_space | [uint64](#uint64) |  | Used space is a sum of object payload sizes of a specified container, stored in the node. It must not include inhumed objects. |
-
-
-<a name="neo.fs.v2.container.AnnounceUsedSpaceResponse"></a>
-
-### Message AnnounceUsedSpaceResponse
-Announce container used space
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [AnnounceUsedSpaceResponse.Body](#neo.fs.v2.container.AnnounceUsedSpaceResponse.Body) |  | Body of announce used space response message. |
-| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.AnnounceUsedSpaceResponse.Body"></a>
-
-### Message AnnounceUsedSpaceResponse.Body
-`AnnounceUsedSpaceResponse` has an empty body because announcements are
-one way communication.
-
-
-
 <a name="neo.fs.v2.container.DeleteRequest"></a>
 
 ### Message DeleteRequest
@@ -260,7 +151,7 @@ smart contract, so signing algorithm must be supported by NeoVM.
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Identifier of the container to delete from NeoFS |
+| container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Identifier of the container to delete from FrostFS |
 | signature | [neo.fs.v2.refs.SignatureRFC6979](#neo.fs.v2.refs.SignatureRFC6979) |  | `ContainerID` signed with the container owner's key according to RFC-6979. |
 
 
@@ -286,58 +177,6 @@ and done via consensus in Inner Ring nodes.
 
 
 
-<a name="neo.fs.v2.container.GetExtendedACLRequest"></a>
-
-### Message GetExtendedACLRequest
-Get Extended ACL
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [GetExtendedACLRequest.Body](#neo.fs.v2.container.GetExtendedACLRequest.Body) |  | Body of get extended acl request message. |
-| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.GetExtendedACLRequest.Body"></a>
-
-### Message GetExtendedACLRequest.Body
-Get Extended ACL request body
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Identifier of the container having Extended ACL |
-
-
-<a name="neo.fs.v2.container.GetExtendedACLResponse"></a>
-
-### Message GetExtendedACLResponse
-Get Extended ACL
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [GetExtendedACLResponse.Body](#neo.fs.v2.container.GetExtendedACLResponse.Body) |  | Body of get extended acl response message. |
-| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.GetExtendedACLResponse.Body"></a>
-
-### Message GetExtendedACLResponse.Body
-Get Extended ACL Response body can be empty if the requested container does
-not have Extended ACL Table attached or Extended ACL has not been allowed at
-the time of container creation.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| eacl | [neo.fs.v2.acl.EACLTable](#neo.fs.v2.acl.EACLTable) |  | Extended ACL requested, if available |
-| signature | [neo.fs.v2.refs.SignatureRFC6979](#neo.fs.v2.refs.SignatureRFC6979) |  | Signature of stable-marshalled Extended ACL according to RFC-6979. |
-| session_token | [neo.fs.v2.session.SessionToken](#neo.fs.v2.session.SessionToken) |  | Session token if Extended ACL was set within a session |
-
-
 <a name="neo.fs.v2.container.GetRequest"></a>
 
 ### Message GetRequest
@@ -440,7 +279,7 @@ List containers response body.
 <a name="neo.fs.v2.container.PutRequest"></a>
 
 ### Message PutRequest
-New NeoFS Container creation request
+New FrostFS Container creation request
 
 
 | Field | Type | Label | Description |
@@ -462,14 +301,14 @@ additional signature checks.
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| container | [Container](#neo.fs.v2.container.Container) |  | Container structure to register in NeoFS |
+| container | [Container](#neo.fs.v2.container.Container) |  | Container structure to register in FrostFS |
 | signature | [neo.fs.v2.refs.SignatureRFC6979](#neo.fs.v2.refs.SignatureRFC6979) |  | Signature of a stable-marshalled container according to RFC-6979. |
 
 
 <a name="neo.fs.v2.container.PutResponse"></a>
 
 ### Message PutResponse
-New NeoFS Container creation response
+New FrostFS Container creation response
 
 
 | Field | Type | Label | Description |
@@ -492,54 +331,6 @@ returned here to make sure everything has been done as expected.
 | ----- | ---- | ----- | ----------- |
 | container_id | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Unique identifier of the newly created container |
 
-
-<a name="neo.fs.v2.container.SetExtendedACLRequest"></a>
-
-### Message SetExtendedACLRequest
-Set Extended ACL
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [SetExtendedACLRequest.Body](#neo.fs.v2.container.SetExtendedACLRequest.Body) |  | Body of set extended acl request message. |
-| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.SetExtendedACLRequest.Body"></a>
-
-### Message SetExtendedACLRequest.Body
-Set Extended ACL request body does not have separate `ContainerID`
-reference. It will be taken from `EACLTable.container_id` field.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| eacl | [neo.fs.v2.acl.EACLTable](#neo.fs.v2.acl.EACLTable) |  | Extended ACL table to set for the container |
-| signature | [neo.fs.v2.refs.SignatureRFC6979](#neo.fs.v2.refs.SignatureRFC6979) |  | Signature of stable-marshalled Extended ACL table according to RFC-6979. |
-
-
-<a name="neo.fs.v2.container.SetExtendedACLResponse"></a>
-
-### Message SetExtendedACLResponse
-Set Extended ACL
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body | [SetExtendedACLResponse.Body](#neo.fs.v2.container.SetExtendedACLResponse.Body) |  | Body of set extended acl response message. |
-| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
-| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
-
-
-<a name="neo.fs.v2.container.SetExtendedACLResponse.Body"></a>
-
-### Message SetExtendedACLResponse.Body
-`SetExtendedACLResponse` has an empty body because the operation is
-asynchronous and the update should be reflected in `Container` smart contract's
-storage after next block is issued in sidechain.
-
-
  <!-- end messages -->
 
  <!-- end enums -->
@@ -560,8 +351,8 @@ storage after next block is issued in sidechain.
 ### Message Container
 Container is a structure that defines object placement behaviour. Objects can
 be stored only within containers. They define placement rule, attributes and
-access control information. An ID of a container is a 32 byte long SHA256 hash
-of stable-marshalled container message.
+access control information. An ID of a container is a 32 byte long SHA256
+hash of stable-marshalled container message.
 
 
 | Field | Type | Label | Description |
@@ -578,8 +369,8 @@ of stable-marshalled container message.
 
 ### Message Container.Attribute
 `Attribute` is a user-defined Key-Value metadata pair attached to the
-container. Container attributes are immutable. They are set at the moment of
-container creation and can never be added or updated.
+container. Container attributes are immutable. They are set at the moment
+of container creation and can never be added or updated.
 
 Key name must be a container-unique valid UTF-8 string. Value can't be
 empty. Containers with duplicated attribute names or attributes with empty
@@ -593,15 +384,16 @@ There are some "well-known" attributes affecting system behaviour:
   NNS contract.
 * [ __SYSTEM__ZONE ]  \
   (`__NEOFS__ZONE` is deprecated) \
-  String of a zone for `__SYSTEM__NAME` (`__NEOFS__NAME` is deprecated). Used as a TLD of a domain name in NNS
-  contract. If no zone is specified, use default zone: `container`.
+  String of a zone for `__SYSTEM__NAME` (`__NEOFS__NAME` is deprecated).
+  Used as a TLD of a domain name in NNS contract. If no zone is specified,
+  use default zone: `container`.
 * [ __SYSTEM__DISABLE_HOMOMORPHIC_HASHING ] \
   (`__NEOFS__DISABLE_HOMOMORPHIC_HASHING` is deprecated) \
-  Disables homomorphic hashing for the container if the value equals "true" string.
-  Any other values are interpreted as missing attribute. Container could be
-  accepted in a NeoFS network only if the global network hashing configuration
-  value corresponds with that attribute's value. After container inclusion, network
-  setting is ignored.
+  Disables homomorphic hashing for the container if the value equals "true"
+  string. Any other values are interpreted as missing attribute. Container
+  could be accepted in a FrostFS network only if the global network hashing
+  configuration value corresponds with that attribute's value. After
+  container inclusion, network setting is ignored.
 
 And some well-known attributes used by applications only:
 
@@ -641,4 +433,3 @@ And some well-known attributes used by applications only:
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/lock.md

@@ -6,8 +6,8 @@
 - [lock/types.proto](#lock/types.proto)
 
   - Messages
-    - [Lock](#neo.fs.v2.lock.Lock)
-    
+      - [Lock](#neo.fs.v2.lock.Lock)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -27,8 +27,9 @@
 ### Message Lock
 Lock objects protects a list of objects from being deleted. The lifetime of a
 lock object is limited similar to regular objects in
-`__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) attribute. Lock object MUST have expiration epoch.
-It is impossible to delete a lock object via ObjectService.Delete RPC call.
+`__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated)
+attribute. Lock object MUST have expiration epoch. It is impossible to delete
+a lock object via ObjectService.Delete RPC call.
 
 
 | Field | Type | Label | Description |
@@ -60,4 +61,3 @@ It is impossible to delete a lock object via ObjectService.Delete RPC call.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/netmap.md

@@ -3,40 +3,41 @@
 
 ## Table of Contents
 
-- [Protocol Documentation](#protocol-documentation)
-  - [Table of Contents](#table-of-contents)
-  - [netmap/service.proto](#netmapserviceproto)
-    - [Service "neo.fs.v2.netmap.NetmapService"](#service-neofsv2netmapnetmapservice)
-      - [Method LocalNodeInfo](#method-localnodeinfo)
-      - [Method NetworkInfo](#method-networkinfo)
-      - [Method NetmapSnapshot](#method-netmapsnapshot)
-    - [Message LocalNodeInfoRequest](#message-localnodeinforequest)
-    - [Message LocalNodeInfoRequest.Body](#message-localnodeinforequestbody)
-    - [Message LocalNodeInfoResponse](#message-localnodeinforesponse)
-    - [Message LocalNodeInfoResponse.Body](#message-localnodeinforesponsebody)
-    - [Message NetmapSnapshotRequest](#message-netmapsnapshotrequest)
-    - [Message NetmapSnapshotRequest.Body](#message-netmapsnapshotrequestbody)
-    - [Message NetmapSnapshotResponse](#message-netmapsnapshotresponse)
-    - [Message NetmapSnapshotResponse.Body](#message-netmapsnapshotresponsebody)
-    - [Message NetworkInfoRequest](#message-networkinforequest)
-    - [Message NetworkInfoRequest.Body](#message-networkinforequestbody)
-    - [Message NetworkInfoResponse](#message-networkinforesponse)
-    - [Message NetworkInfoResponse.Body](#message-networkinforesponsebody)
-  - [netmap/types.proto](#netmaptypesproto)
-    - [Message Filter](#message-filter)
-    - [Message Netmap](#message-netmap)
-    - [Message NetworkConfig](#message-networkconfig)
-    - [Message NetworkConfig.Parameter](#message-networkconfigparameter)
-    - [Message NetworkInfo](#message-networkinfo)
-    - [Message NodeInfo](#message-nodeinfo)
-    - [Message NodeInfo.Attribute](#message-nodeinfoattribute)
-    - [Message PlacementPolicy](#message-placementpolicy)
-    - [Message Replica](#message-replica)
-    - [Message Selector](#message-selector)
-    - [Clause](#clause)
-    - [NodeInfo.State](#nodeinfostate)
-    - [Operation](#operation)
-  - [Scalar Value Types](#scalar-value-types)
+- [netmap/service.proto](#netmap/service.proto)
+  - Services
+      - [NetmapService](#neo.fs.v2.netmap.NetmapService)
+
+  - Messages
+      - [LocalNodeInfoRequest](#neo.fs.v2.netmap.LocalNodeInfoRequest)
+      - [LocalNodeInfoRequest.Body](#neo.fs.v2.netmap.LocalNodeInfoRequest.Body)
+      - [LocalNodeInfoResponse](#neo.fs.v2.netmap.LocalNodeInfoResponse)
+      - [LocalNodeInfoResponse.Body](#neo.fs.v2.netmap.LocalNodeInfoResponse.Body)
+      - [NetmapSnapshotRequest](#neo.fs.v2.netmap.NetmapSnapshotRequest)
+      - [NetmapSnapshotRequest.Body](#neo.fs.v2.netmap.NetmapSnapshotRequest.Body)
+      - [NetmapSnapshotResponse](#neo.fs.v2.netmap.NetmapSnapshotResponse)
+      - [NetmapSnapshotResponse.Body](#neo.fs.v2.netmap.NetmapSnapshotResponse.Body)
+      - [NetworkInfoRequest](#neo.fs.v2.netmap.NetworkInfoRequest)
+      - [NetworkInfoRequest.Body](#neo.fs.v2.netmap.NetworkInfoRequest.Body)
+      - [NetworkInfoResponse](#neo.fs.v2.netmap.NetworkInfoResponse)
+      - [NetworkInfoResponse.Body](#neo.fs.v2.netmap.NetworkInfoResponse.Body)
+
+
+- [netmap/types.proto](#netmap/types.proto)
+
+  - Messages
+      - [Filter](#neo.fs.v2.netmap.Filter)
+      - [Netmap](#neo.fs.v2.netmap.Netmap)
+      - [NetworkConfig](#neo.fs.v2.netmap.NetworkConfig)
+      - [NetworkConfig.Parameter](#neo.fs.v2.netmap.NetworkConfig.Parameter)
+      - [NetworkInfo](#neo.fs.v2.netmap.NetworkInfo)
+      - [NodeInfo](#neo.fs.v2.netmap.NodeInfo)
+      - [NodeInfo.Attribute](#neo.fs.v2.netmap.NodeInfo.Attribute)
+      - [PlacementPolicy](#neo.fs.v2.netmap.PlacementPolicy)
+      - [Replica](#neo.fs.v2.netmap.Replica)
+      - [Selector](#neo.fs.v2.netmap.Selector)
+
+
+- [Scalar Value Types](#scalar-value-types)
 
 
 
@@ -51,10 +52,10 @@
 <a name="neo.fs.v2.netmap.NetmapService"></a>
 
 ### Service "neo.fs.v2.netmap.NetmapService"
-`NetmapService` provides methods to work with `Network Map` and the information
-required to build it. The resulting `Network Map` is stored in sidechain
-`Netmap` smart contract, while related information can be obtained from other
-NeoFS nodes.
+`NetmapService` provides methods to work with `Network Map` and the
+information required to build it. The resulting `Network Map` is stored in
+sidechain `Netmap` smart contract, while related information can be obtained
+from other FrostFS nodes.
 
 ```
 rpc LocalNodeInfo(LocalNodeInfoRequest) returns (LocalNodeInfoResponse);
@@ -65,11 +66,12 @@ rpc NetmapSnapshot(NetmapSnapshotRequest) returns (NetmapSnapshotResponse);
 
 #### Method LocalNodeInfo
 
-Get NodeInfo structure from the particular node directly. 
-Node information can be taken from `Netmap` smart contract. In some cases, though,
-one may want to get recent information directly or to talk to the node not yet
-present in the `Network Map` to find out what API version can be used for
-further communication. This can be also used to check if a node is up and running.
+Get NodeInfo structure from the particular node directly.
+Node information can be taken from `Netmap` smart contract. In some cases,
+though, one may want to get recent information directly or to talk to the
+node not yet present in the `Network Map` to find out what API version can
+be used for further communication. This can be also used to check if a node
+is up and running.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS):
@@ -81,7 +83,7 @@ information about the server has been successfully read;
 | LocalNodeInfo | [LocalNodeInfoRequest](#neo.fs.v2.netmap.LocalNodeInfoRequest) | [LocalNodeInfoResponse](#neo.fs.v2.netmap.LocalNodeInfoResponse) |
 #### Method NetworkInfo
 
-Read recent information about the NeoFS network.
+Read recent information about the FrostFS network.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS):
@@ -93,7 +95,7 @@ information about the current network state has been successfully read;
 | NetworkInfo | [NetworkInfoRequest](#neo.fs.v2.netmap.NetworkInfoRequest) | [NetworkInfoResponse](#neo.fs.v2.netmap.NetworkInfoResponse) |
 #### Method NetmapSnapshot
 
-Returns network map snapshot of the current NeoFS epoch.
+Returns network map snapshot of the current FrostFS epoch.
 
 Statuses:
 - **OK** (0, SECTION_SUCCESS):
@@ -147,7 +149,7 @@ Local Node Info, including API Version in use.
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| version | [neo.fs.v2.refs.Version](#neo.fs.v2.refs.Version) |  | Latest NeoFS API version in use |
+| version | [neo.fs.v2.refs.Version](#neo.fs.v2.refs.Version) |  | Latest FrostFS API version in use |
 | node_info | [NodeInfo](#neo.fs.v2.netmap.NodeInfo) |  | NodeInfo structure with recent information from node itself |
 
 
@@ -257,8 +259,8 @@ Information about the network.
 <a name="neo.fs.v2.netmap.Filter"></a>
 
 ### Message Filter
-This filter will return the subset of nodes from `NetworkMap` or another filter's
-results that will satisfy filter's conditions.
+This filter will return the subset of nodes from `NetworkMap` or another
+filter's results that will satisfy filter's conditions.
 
 
 | Field | Type | Label | Description |
@@ -285,7 +287,7 @@ Network map structure
 <a name="neo.fs.v2.netmap.NetworkConfig"></a>
 
 ### Message NetworkConfig
-NeoFS network configuration
+FrostFS network configuration
 
 
 | Field | Type | Label | Description |
@@ -313,7 +315,7 @@ System parameters:
   Fee paid for container creation by the container owner.
   Value: little-endian integer. Default: 0.
 - **EpochDuration** \
-  NeoFS epoch duration measured in Sidechain blocks.
+  FrostFS epoch duration measured in Sidechain blocks.
   Value: little-endian integer. Default: 0.
 - **HomomorphicHashingDisabled** \
   Flag of disabling the homomorphic hashing of objects' payload.
@@ -325,11 +327,48 @@ System parameters:
   Flag allowing setting the MAINTENANCE state to storage nodes.
   Value: true if any byte != 0. Default: false.
 - **MaxObjectSize** \
-  Maximum size of physically stored NeoFS object measured in bytes.
+  Maximum size of physically stored FrostFS object measured in bytes.
   Value: little-endian integer. Default: 0.
+
+  This value refers to the maximum size of a **physically** stored object
+  in FrostFS. However, from a user's perspective, the **logical** size of a
+  stored object can be significantly larger. The relationship between the
+  physical and logical object sizes is governed by the following formula
+
+  ```math
+  \mathrm{Stored\ Object\ Size} \le
+  \frac{
+    \left(\mathrm{Max\ Object\ Size}\right)^2
+  }{
+    \mathrm{Object\ ID\ Size}
+  }
+  ```
+
+  This arises from the fact that a tombstone, also being an object, stores
+  the IDs of inhumed objects and cannot be divided into smaller objects,
+  thus having an upper limit for its size.
+
+  For example, if:
+  * Max Object Size Size = 64 MiB;
+  * Object ID Size = 32 B;
+
+  then:
+  ```math
+    \mathrm{Stored\ Object\ Size} \le
+    \frac{\left(64\ \mathrm{MiB}\right)^2}{32\ \mathrm{B}} =
+    \frac{2^{52}}{2^5}\ \mathrm{B} =
+    2^{47}\ \mathrm{B} =
+    128\ \mathrm{TiB}
+  ```
 - **WithdrawFee** \
   Fee paid for withdrawal of funds paid by the account owner.
   Value: little-endian integer. Default: 0.
+- **MaxECDataCount** \
+  Maximum number of data shards for EC placement policy.
+  Value: little-endian integer. Default: 0.
+- **MaxECParityCount** \
+  Maximum number of parity shards for EC placement policy.
+  Value: little-endian integer. Default: 0.
 
 
 | Field | Type | Label | Description |
@@ -341,49 +380,49 @@ System parameters:
 <a name="neo.fs.v2.netmap.NetworkInfo"></a>
 
 ### Message NetworkInfo
-Information about NeoFS network
+Information about FrostFS network
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| current_epoch | [uint64](#uint64) |  | Number of the current epoch in the NeoFS network |
-| magic_number | [uint64](#uint64) |  | Magic number of the sidechain of the NeoFS network |
-| ms_per_block | [int64](#int64) |  | MillisecondsPerBlock network parameter of the sidechain of the NeoFS network |
-| network_config | [NetworkConfig](#neo.fs.v2.netmap.NetworkConfig) |  | NeoFS network configuration |
+| current_epoch | [uint64](#uint64) |  | Number of the current epoch in the FrostFS network |
+| magic_number | [uint64](#uint64) |  | Magic number of the sidechain of the FrostFS network |
+| ms_per_block | [int64](#int64) |  | MillisecondsPerBlock network parameter of the sidechain of the FrostFS network |
+| network_config | [NetworkConfig](#neo.fs.v2.netmap.NetworkConfig) |  | FrostFS network configuration |
 
 
 <a name="neo.fs.v2.netmap.NodeInfo"></a>
 
 ### Message NodeInfo
-NeoFS node description
+FrostFS node description
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| public_key | [bytes](#bytes) |  | Public key of the NeoFS node in a binary format |
+| public_key | [bytes](#bytes) |  | Public key of the FrostFS node in a binary format |
 | addresses | [string](#string) | repeated | Ways to connect to a node |
-| attributes | [NodeInfo.Attribute](#neo.fs.v2.netmap.NodeInfo.Attribute) | repeated | Carries list of the NeoFS node attributes in a key-value form. Key name must be a node-unique valid UTF-8 string. Value can't be empty. NodeInfo structures with duplicated attribute names or attributes with empty values will be considered invalid. |
-| state | [NodeInfo.State](#neo.fs.v2.netmap.NodeInfo.State) |  | Carries state of the NeoFS node |
+| attributes | [NodeInfo.Attribute](#neo.fs.v2.netmap.NodeInfo.Attribute) | repeated | Carries list of the FrostFS node attributes in a key-value form. Key name must be a node-unique valid UTF-8 string. Value can't be empty. NodeInfo structures with duplicated attribute names or attributes with empty values will be considered invalid. |
+| state | [NodeInfo.State](#neo.fs.v2.netmap.NodeInfo.State) |  | Carries state of the FrostFS node |
 
 
 <a name="neo.fs.v2.netmap.NodeInfo.Attribute"></a>
 
 ### Message NodeInfo.Attribute
-Administrator-defined Attributes of the NeoFS Storage Node.
+Administrator-defined Attributes of the FrostFS Storage Node.
 
 `Attribute` is a Key-Value metadata pair. Key name must be a valid UTF-8
 string. Value can't be empty.
 
 Attributes can be constructed into a chain of attributes: any attribute can
-have a parent attribute and a child attribute (except the first and the last
-one). A string representation of the chain of attributes in NeoFS Storage
-Node configuration uses ":" and "/" symbols, e.g.:
+have a parent attribute and a child attribute (except the first and the
+last one). A string representation of the chain of attributes in FrostFS
+Storage Node configuration uses ":" and "/" symbols, e.g.:
 
-       `NEOFS_NODE_ATTRIBUTE_1=key1:val1/key2:val2`
+       `FrostFS_NODE_ATTRIBUTE_1=key1:val1/key2:val2`
 
-Therefore the string attribute representation in the Node configuration must
-use "\:", "\/" and "\\" escaped symbols if any of them appears in an attribute's
-key or value.
+Therefore the string attribute representation in the Node configuration
+must use "\:", "\/" and "\\" escaped symbols if any of them appears in an
+attribute's key or value.
 
 Node's attributes are mostly used during Storage Policy evaluation to
 calculate object's placement and find a set of nodes satisfying policy
@@ -426,8 +465,8 @@ explicitly set:
   [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). Calculated
   automatically from `UN-LOCODE` attribute.
 * Continent \
-  Node's continent name according to the [Seven-Continent model]
-  (https://en.wikipedia.org/wiki/Continent#Number). Calculated
+  Node's continent name according to the [Seven-Continent
+  model](https://en.wikipedia.org/wiki/Continent#Number). Calculated
   automatically from `UN-LOCODE` attribute.
 * ExternalAddr
   Node's preferred way for communications with external clients.
@@ -435,7 +474,7 @@ explicitly set:
   Must contain a comma-separated list of multi-addresses.
 
 For detailed description of each well-known attribute please see the
-corresponding section in NeoFS Technical Specification.
+corresponding section in FrostFS Technical Specification.
 
 
 | Field | Type | Label | Description |
@@ -456,9 +495,10 @@ storage policy definition languages.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | replicas | [Replica](#neo.fs.v2.netmap.Replica) | repeated | Rules to set number of object replicas and place each one into a named bucket |
-| container_backup_factor | [uint32](#uint32) |  | Container backup factor controls how deep NeoFS will search for nodes alternatives to include into container's nodes subset |
+| container_backup_factor | [uint32](#uint32) |  | Container backup factor controls how deep FrostFS will search for nodes alternatives to include into container's nodes subset |
 | selectors | [Selector](#neo.fs.v2.netmap.Selector) | repeated | Set of Selectors to form the container's nodes subset |
 | filters | [Filter](#neo.fs.v2.netmap.Filter) | repeated | List of named filters to reference in selectors |
+| unique | [bool](#bool) |  | Unique flag defines non-overlapping application for replicas |
 
 
 <a name="neo.fs.v2.netmap.Replica"></a>
@@ -473,6 +513,8 @@ default.
 | ----- | ---- | ----- | ----------- |
 | count | [uint32](#uint32) |  | How many object replicas to put |
 | selector | [string](#string) |  | Named selector bucket to put replicas |
+| ec_data_count | [uint32](#uint32) |  | Data shards count |
+| ec_parity_count | [uint32](#uint32) |  | Parity shards count |
 
 
 <a name="neo.fs.v2.netmap.Selector"></a>
@@ -511,7 +553,7 @@ hash distance.
 <a name="neo.fs.v2.netmap.NodeInfo.State"></a>
 
 ### NodeInfo.State
-Represents the enumeration of various states of the NeoFS node.
+Represents the enumeration of various states of the FrostFS node.
 
 | Name | Number | Description |
 | ---- | ------ | ----------- |
@@ -538,6 +580,8 @@ Operations on filters
 | LE | 6 | Less or equal |
 | OR | 7 | Logical OR |
 | AND | 8 | Logical AND |
+| NOT | 9 | Logical negation |
+| LIKE | 10 | Matches pattern |
 
 
  <!-- end enums -->
@@ -563,4 +607,3 @@ Operations on filters
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/object.md

@@ -4,55 +4,67 @@
 ## Table of Contents
 
 - [object/service.proto](#object/service.proto)
- - Services
-    - [ObjectService](#neo.fs.v2.object.ObjectService)
-    
+  - Services
+      - [ObjectService](#neo.fs.v2.object.ObjectService)
+
   - Messages
-    - [DeleteRequest](#neo.fs.v2.object.DeleteRequest)
-    - [DeleteRequest.Body](#neo.fs.v2.object.DeleteRequest.Body)
-    - [DeleteResponse](#neo.fs.v2.object.DeleteResponse)
-    - [DeleteResponse.Body](#neo.fs.v2.object.DeleteResponse.Body)
-    - [GetRangeHashRequest](#neo.fs.v2.object.GetRangeHashRequest)
-    - [GetRangeHashRequest.Body](#neo.fs.v2.object.GetRangeHashRequest.Body)
-    - [GetRangeHashResponse](#neo.fs.v2.object.GetRangeHashResponse)
-    - [GetRangeHashResponse.Body](#neo.fs.v2.object.GetRangeHashResponse.Body)
-    - [GetRangeRequest](#neo.fs.v2.object.GetRangeRequest)
-    - [GetRangeRequest.Body](#neo.fs.v2.object.GetRangeRequest.Body)
-    - [GetRangeResponse](#neo.fs.v2.object.GetRangeResponse)
-    - [GetRangeResponse.Body](#neo.fs.v2.object.GetRangeResponse.Body)
-    - [GetRequest](#neo.fs.v2.object.GetRequest)
-    - [GetRequest.Body](#neo.fs.v2.object.GetRequest.Body)
-    - [GetResponse](#neo.fs.v2.object.GetResponse)
-    - [GetResponse.Body](#neo.fs.v2.object.GetResponse.Body)
-    - [GetResponse.Body.Init](#neo.fs.v2.object.GetResponse.Body.Init)
-    - [HeadRequest](#neo.fs.v2.object.HeadRequest)
-    - [HeadRequest.Body](#neo.fs.v2.object.HeadRequest.Body)
-    - [HeadResponse](#neo.fs.v2.object.HeadResponse)
-    - [HeadResponse.Body](#neo.fs.v2.object.HeadResponse.Body)
-    - [HeaderWithSignature](#neo.fs.v2.object.HeaderWithSignature)
-    - [PutRequest](#neo.fs.v2.object.PutRequest)
-    - [PutRequest.Body](#neo.fs.v2.object.PutRequest.Body)
-    - [PutRequest.Body.Init](#neo.fs.v2.object.PutRequest.Body.Init)
-    - [PutResponse](#neo.fs.v2.object.PutResponse)
-    - [PutResponse.Body](#neo.fs.v2.object.PutResponse.Body)
-    - [Range](#neo.fs.v2.object.Range)
-    - [SearchRequest](#neo.fs.v2.object.SearchRequest)
-    - [SearchRequest.Body](#neo.fs.v2.object.SearchRequest.Body)
-    - [SearchRequest.Body.Filter](#neo.fs.v2.object.SearchRequest.Body.Filter)
-    - [SearchResponse](#neo.fs.v2.object.SearchResponse)
-    - [SearchResponse.Body](#neo.fs.v2.object.SearchResponse.Body)
-    
+      - [DeleteRequest](#neo.fs.v2.object.DeleteRequest)
+      - [DeleteRequest.Body](#neo.fs.v2.object.DeleteRequest.Body)
+      - [DeleteResponse](#neo.fs.v2.object.DeleteResponse)
+      - [DeleteResponse.Body](#neo.fs.v2.object.DeleteResponse.Body)
+      - [GetRangeHashRequest](#neo.fs.v2.object.GetRangeHashRequest)
+      - [GetRangeHashRequest.Body](#neo.fs.v2.object.GetRangeHashRequest.Body)
+      - [GetRangeHashResponse](#neo.fs.v2.object.GetRangeHashResponse)
+      - [GetRangeHashResponse.Body](#neo.fs.v2.object.GetRangeHashResponse.Body)
+      - [GetRangeRequest](#neo.fs.v2.object.GetRangeRequest)
+      - [GetRangeRequest.Body](#neo.fs.v2.object.GetRangeRequest.Body)
+      - [GetRangeResponse](#neo.fs.v2.object.GetRangeResponse)
+      - [GetRangeResponse.Body](#neo.fs.v2.object.GetRangeResponse.Body)
+      - [GetRequest](#neo.fs.v2.object.GetRequest)
+      - [GetRequest.Body](#neo.fs.v2.object.GetRequest.Body)
+      - [GetResponse](#neo.fs.v2.object.GetResponse)
+      - [GetResponse.Body](#neo.fs.v2.object.GetResponse.Body)
+      - [GetResponse.Body.Init](#neo.fs.v2.object.GetResponse.Body.Init)
+      - [HeadRequest](#neo.fs.v2.object.HeadRequest)
+      - [HeadRequest.Body](#neo.fs.v2.object.HeadRequest.Body)
+      - [HeadResponse](#neo.fs.v2.object.HeadResponse)
+      - [HeadResponse.Body](#neo.fs.v2.object.HeadResponse.Body)
+      - [HeaderWithSignature](#neo.fs.v2.object.HeaderWithSignature)
+      - [PatchRequest](#neo.fs.v2.object.PatchRequest)
+      - [PatchRequest.Body](#neo.fs.v2.object.PatchRequest.Body)
+      - [PatchRequest.Body.Patch](#neo.fs.v2.object.PatchRequest.Body.Patch)
+      - [PatchResponse](#neo.fs.v2.object.PatchResponse)
+      - [PatchResponse.Body](#neo.fs.v2.object.PatchResponse.Body)
+      - [PutRequest](#neo.fs.v2.object.PutRequest)
+      - [PutRequest.Body](#neo.fs.v2.object.PutRequest.Body)
+      - [PutRequest.Body.Init](#neo.fs.v2.object.PutRequest.Body.Init)
+      - [PutResponse](#neo.fs.v2.object.PutResponse)
+      - [PutResponse.Body](#neo.fs.v2.object.PutResponse.Body)
+      - [PutSingleRequest](#neo.fs.v2.object.PutSingleRequest)
+      - [PutSingleRequest.Body](#neo.fs.v2.object.PutSingleRequest.Body)
+      - [PutSingleResponse](#neo.fs.v2.object.PutSingleResponse)
+      - [PutSingleResponse.Body](#neo.fs.v2.object.PutSingleResponse.Body)
+      - [Range](#neo.fs.v2.object.Range)
+      - [SearchRequest](#neo.fs.v2.object.SearchRequest)
+      - [SearchRequest.Body](#neo.fs.v2.object.SearchRequest.Body)
+      - [SearchRequest.Body.Filter](#neo.fs.v2.object.SearchRequest.Body.Filter)
+      - [SearchResponse](#neo.fs.v2.object.SearchResponse)
+      - [SearchResponse.Body](#neo.fs.v2.object.SearchResponse.Body)
+
 
 - [object/types.proto](#object/types.proto)
 
   - Messages
-    - [Header](#neo.fs.v2.object.Header)
-    - [Header.Attribute](#neo.fs.v2.object.Header.Attribute)
-    - [Header.Split](#neo.fs.v2.object.Header.Split)
-    - [Object](#neo.fs.v2.object.Object)
-    - [ShortHeader](#neo.fs.v2.object.ShortHeader)
-    - [SplitInfo](#neo.fs.v2.object.SplitInfo)
-    
+      - [ECInfo](#neo.fs.v2.object.ECInfo)
+      - [ECInfo.Chunk](#neo.fs.v2.object.ECInfo.Chunk)
+      - [Header](#neo.fs.v2.object.Header)
+      - [Header.Attribute](#neo.fs.v2.object.Header.Attribute)
+      - [Header.EC](#neo.fs.v2.object.Header.EC)
+      - [Header.Split](#neo.fs.v2.object.Header.Split)
+      - [Object](#neo.fs.v2.object.Object)
+      - [ShortHeader](#neo.fs.v2.object.ShortHeader)
+      - [SplitInfo](#neo.fs.v2.object.SplitInfo)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -80,17 +92,19 @@ rpc Head(HeadRequest) returns (HeadResponse);
 rpc Search(SearchRequest) returns (stream SearchResponse);
 rpc GetRange(GetRangeRequest) returns (stream GetRangeResponse);
 rpc GetRangeHash(GetRangeHashRequest) returns (GetRangeHashResponse);
+rpc PutSingle(PutSingleRequest) returns (PutSingleResponse);
+rpc Patch(stream PatchRequest) returns (PatchResponse);
 
 ```
 
 #### Method Get
 
 Receive full object structure, including Headers and payload. Response uses
-gRPC stream. First response message carries the object with the requested address.
-Chunk messages are parts of the object's payload if it is needed. All
-messages, except the first one, carry payload chunks. The requested object can
-be restored by concatenation of object message payload and all chunks
-keeping the receiving order.
+gRPC stream. First response message carries the object with the requested
+address. Chunk messages are parts of the object's payload if it is needed.
+All messages, except the first one, carry payload chunks. The requested
+object can be restored by concatenation of object message payload and all
+chunks keeping the receiving order.
 
 Extended headers can change `Get` behaviour:
 * [ __SYSTEM__NETMAP_EPOCH ] \
@@ -99,9 +113,10 @@ Extended headers can change `Get` behaviour:
   calculation.
 * [ __SYSTEM__NETMAP_LOOKUP_DEPTH ] \
   (`__NEOFS__NETMAP_LOOKUP_DEPTH` is deprecated) \
-  Will try older versions (starting from `__SYSTEM__NETMAP_EPOCH` (`__NEOFS__NETMAP_EPOCH` is deprecated) if specified or
-  the latest one otherwise) of Network Map to find an object until the depth
-  limit is reached.
+  Will try older versions (starting from `__SYSTEM__NETMAP_EPOCH`
+  (`__NEOFS__NETMAP_EPOCH` is deprecated) if specified or the latest one
+  otherwise) of Network Map to find an object until the depth limit is
+  reached.
 
 Please refer to detailed `XHeader` description.
 
@@ -117,6 +132,8 @@ Statuses:
   the requested object has been marked as deleted;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
@@ -147,15 +164,18 @@ Statuses:
 - **ACCESS_DENIED** (2048, SECTION_OBJECT): \
   write access to the container is denied;
 - **LOCKED** (2050, SECTION_OBJECT): \
-  placement of an object of type TOMBSTONE that includes at least one locked
-  object is prohibited;
+  placement of an object of type TOMBSTONE that includes at least one
+  locked object is prohibited;
 - **LOCK_NON_REGULAR_OBJECT** (2051, SECTION_OBJECT): \
   placement of an object of type LOCK that includes at least one object of
   type other than REGULAR is prohibited;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object storage container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
-  (for trusted object preparation) session private key does not exist or has
+  (for trusted object preparation) session private key does not exist or
+  has
 been deleted;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
@@ -182,10 +202,15 @@ Statuses:
 - Common failures (SECTION_FAILURE_COMMON);
 - **ACCESS_DENIED** (2048, SECTION_OBJECT): \
   delete access to the object is denied;
+- **OBJECT_NOT_FOUND** (2049, SECTION_OBJECT): \
+  the object could not be deleted because it has not been \
+  found within the container;
 - **LOCKED** (2050, SECTION_OBJECT): \
   deleting a locked object is prohibited;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
@@ -218,6 +243,8 @@ Statuses:
   the requested object has been marked as deleted;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
@@ -227,7 +254,7 @@ Statuses:
 #### Method Search
 
 Search objects in container. Search query allows to match by Object
-Header's filed values. Please see the corresponding NeoFS Technical
+Header's filed values. Please see the corresponding FrostFS Technical
 Specification section for more details.
 
 Extended headers can change `Search` behaviour:
@@ -246,6 +273,8 @@ Statuses:
   access to operation SEARCH of the object is denied;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   search container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
@@ -256,8 +285,8 @@ Statuses:
 
 Get byte range of data payload. Range is set as an (offset, length) tuple.
 Like in `Get` method, the response uses gRPC stream. Requested range can be
-restored by concatenation of all received payload chunks keeping the receiving
-order.
+restored by concatenation of all received payload chunks keeping the
+receiving order.
 
 Extended headers can change `GetRange` behaviour:
 * [ __SYSTEM__NETMAP_EPOCH ] \
@@ -285,6 +314,8 @@ Statuses:
   the requested range is out of bounds;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
@@ -322,12 +353,107 @@ Statuses:
   the requested range is out of bounds;
 - **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
   object container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
 - **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
   provided session token has expired.
 
 | Name | Input | Output |
 | ---- | ----- | ------ |
 | GetRangeHash | [GetRangeHashRequest](#neo.fs.v2.object.GetRangeHashRequest) | [GetRangeHashResponse](#neo.fs.v2.object.GetRangeHashResponse) |
+#### Method PutSingle
+
+Put the prepared object into container.
+`ContainerID`, `ObjectID`, `OwnerID`, `PayloadHash` and `PayloadLength` of
+an object MUST be set.
+
+Extended headers can change `Put` behaviour:
+* [ __SYSTEM__NETMAP_EPOCH \
+  (`__NEOFS__NETMAP_EPOCH` is deprecated) \
+  Will use the requested version of Network Map for object placement
+  calculation.
+
+Please refer to detailed `XHeader` description.
+
+Statuses:
+- **OK** (0, SECTION_SUCCESS): \
+  object has been successfully saved in the container;
+- Common failures (SECTION_FAILURE_COMMON);
+- **ACCESS_DENIED** (2048, SECTION_OBJECT): \
+  write access to the container is denied;
+- **LOCKED** (2050, SECTION_OBJECT): \
+  placement of an object of type TOMBSTONE that includes at least one
+  locked object is prohibited;
+- **LOCK_NON_REGULAR_OBJECT** (2051, SECTION_OBJECT): \
+  placement of an object of type LOCK that includes at least one object of
+  type other than REGULAR is prohibited;
+- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  object storage container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
+- **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
+  (for trusted object preparation) session private key does not exist or
+  has
+been deleted;
+- **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
+  provided session token has expired.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| PutSingle | [PutSingleRequest](#neo.fs.v2.object.PutSingleRequest) | [PutSingleResponse](#neo.fs.v2.object.PutSingleResponse) |
+#### Method Patch
+
+Patch the object. Request uses gRPC stream. First message must set
+the address of the object that is going to get patched. If the object's
+attributes are patched, then these attrubutes must be set only within the
+first stream message.
+
+If the patch request is performed by NOT the object's owner but if the
+actor has the permission to perform the patch, then `OwnerID` of the object
+is changed. In this case the object's owner loses the object's ownership
+after the patch request is successfully done.
+
+As objects are content-addressable the patching causes new object ID
+generation for the patched object. This object id is set witihn
+`PatchResponse`. But the object id may remain unchanged in such cases:
+1. The chunk of the applying patch contains the same value as the object's
+payload within the same range;
+2. The patch that reverts the changes applied by preceding patch;
+3. The application of the same patches for the object a few times.
+
+Extended headers can change `Patch` behaviour:
+* [ __SYSTEM__NETMAP_EPOCH \
+  (`__NEOFS__NETMAP_EPOCH` is deprecated) \
+  Will use the requsted version of Network Map for object placement
+  calculation.
+
+Please refer to detailed `XHeader` description.
+
+Statuses:
+- **OK** (0, SECTION_SUCCESS): \
+  object has been successfully patched and saved in the container;
+- Common failures (SECTION_FAILURE_COMMON);
+- **ACCESS_DENIED** (2048, SECTION_OBJECT): \
+  write access to the container is denied;
+- **OBJECT_NOT_FOUND** (2049, SECTION_OBJECT): \
+  object not found in container;
+- **OBJECT_ALREADY_REMOVED** (2052, SECTION_OBJECT): \
+  the requested object has been marked as deleted.
+- **OUT_OF_RANGE** (2053, SECTION_OBJECT): \
+  the requested range is out of bounds;
+- **CONTAINER_NOT_FOUND** (3072, SECTION_CONTAINER): \
+  object storage container not found;
+- **CONTAINER_ACCESS_DENIED** (3074, SECTION_CONTAINER): \
+  access to container is denied;
+- **TOKEN_NOT_FOUND** (4096, SECTION_SESSION): \
+  (for trusted object preparation) session private key does not exist or
+  has been deleted;
+- **TOKEN_EXPIRED** (4097, SECTION_SESSION): \
+  provided session token has expired.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Patch | [PatchRequest](#neo.fs.v2.object.PatchRequest) | [PatchResponse](#neo.fs.v2.object.PatchResponse) |
  <!-- end services -->
 
 
@@ -484,6 +610,7 @@ chunks.
 | ----- | ---- | ----- | ----------- |
 | chunk | [bytes](#bytes) |  | Chunked object payload's range. |
 | split_info | [SplitInfo](#neo.fs.v2.object.SplitInfo) |  | Meta information of split hierarchy. |
+| ec_info | [ECInfo](#neo.fs.v2.object.ECInfo) |  | Meta information for EC object assembly. |
 
 
 <a name="neo.fs.v2.object.GetRequest"></a>
@@ -535,6 +662,7 @@ GET Object Response body
 | init | [GetResponse.Body.Init](#neo.fs.v2.object.GetResponse.Body.Init) |  | Initial part of the object stream |
 | chunk | [bytes](#bytes) |  | Chunked object payload |
 | split_info | [SplitInfo](#neo.fs.v2.object.SplitInfo) |  | Meta information of split hierarchy for object assembly. |
+| ec_info | [ECInfo](#neo.fs.v2.object.ECInfo) |  | Meta information for EC object assembly. |
 
 
 <a name="neo.fs.v2.object.GetResponse.Body.Init"></a>
@@ -601,6 +729,7 @@ Object HEAD response body
 | header | [HeaderWithSignature](#neo.fs.v2.object.HeaderWithSignature) |  | Full object's `Header` with `ObjectID` signature |
 | short_header | [ShortHeader](#neo.fs.v2.object.ShortHeader) |  | Short object header |
 | split_info | [SplitInfo](#neo.fs.v2.object.SplitInfo) |  | Meta information of split hierarchy. |
+| ec_info | [ECInfo](#neo.fs.v2.object.ECInfo) |  | Meta information for EC object assembly. |
 
 
 <a name="neo.fs.v2.object.HeaderWithSignature"></a>
@@ -621,6 +750,71 @@ following steps:
 | signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Signed `ObjectID` to verify full header's authenticity |
 
 
+<a name="neo.fs.v2.object.PatchRequest"></a>
+
+### Message PatchRequest
+Object PATCH request
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [PatchRequest.Body](#neo.fs.v2.object.PatchRequest.Body) |  | Body for patch request message. |
+| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="neo.fs.v2.object.PatchRequest.Body"></a>
+
+### Message PatchRequest.Body
+PATCH request body
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| address | [neo.fs.v2.refs.Address](#neo.fs.v2.refs.Address) |  | The address of the object that is requested to get patched. |
+| new_attributes | [Header.Attribute](#neo.fs.v2.object.Header.Attribute) | repeated | New attributes for the object. See `replace_attributes` flag usage to define how new attributes should be set. |
+| replace_attributes | [bool](#bool) |  | If this flag is set, then the object's attributes will be entirely replaced by `new_attributes` list. The empty `new_attributes` list with `replace_attributes = true` just resets attributes list for the object.
+
+Default `false` value for this flag means the attributes will be just merged. If the incoming `new_attributes` list contains already existing key, then it just replaces it while merging the lists. |
+| patch | [PatchRequest.Body.Patch](#neo.fs.v2.object.PatchRequest.Body.Patch) |  | The patch that is applied for the object. |
+
+
+<a name="neo.fs.v2.object.PatchRequest.Body.Patch"></a>
+
+### Message PatchRequest.Body.Patch
+The patch for the object's payload.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| source_range | [Range](#neo.fs.v2.object.Range) |  | The range of the source object for which the payload is replaced by the patch's chunk. If the range's `length = 0`, then the patch's chunk is just appended to the original payload starting from the `offest` without any replace. |
+| chunk | [bytes](#bytes) |  | The chunk that is being appended to or that replaces the original payload on the given range. |
+
+
+<a name="neo.fs.v2.object.PatchResponse"></a>
+
+### Message PatchResponse
+Object PATCH response
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [PatchResponse.Body](#neo.fs.v2.object.PatchResponse.Body) |  | Body for patch response message. |
+| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="neo.fs.v2.object.PatchResponse.Body"></a>
+
+### Message PatchResponse.Body
+PATCH response body
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| object_id | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) |  | The object ID of the saved patched object. |
+
+
 <a name="neo.fs.v2.object.PutRequest"></a>
 
 ### Message PutRequest
@@ -685,6 +879,51 @@ PUT Object response body
 | object_id | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) |  | Identifier of the saved object |
 
 
+<a name="neo.fs.v2.object.PutSingleRequest"></a>
+
+### Message PutSingleRequest
+Object PUT Single request
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [PutSingleRequest.Body](#neo.fs.v2.object.PutSingleRequest.Body) |  | Body of put single object request message. |
+| meta_header | [neo.fs.v2.session.RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | Carries request meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) |  | Carries request verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="neo.fs.v2.object.PutSingleRequest.Body"></a>
+
+### Message PutSingleRequest.Body
+PUT Single request body
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| object | [Object](#neo.fs.v2.object.Object) |  | Prepared object with payload. |
+| copies_number | [uint32](#uint32) | repeated | Number of copies of the object to store within the RPC call. By default, object is processed according to the container's placement policy. Every number is treated as a minimal number of nodes in a corresponding placement vector that must store an object to complete the request successfully. The length MUST equal the placement vectors number, otherwise request is considered malformed. |
+
+
+<a name="neo.fs.v2.object.PutSingleResponse"></a>
+
+### Message PutSingleResponse
+Object PUT Single response
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| body | [PutSingleResponse.Body](#neo.fs.v2.object.PutSingleResponse.Body) |  | Body of put single object response message. |
+| meta_header | [neo.fs.v2.session.ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) |  | Carries response meta information. Header data is used only to regulate message transport and does not affect request execution. |
+| verify_header | [neo.fs.v2.session.ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader) |  | Carries response verification information. This header is used to authenticate the nodes of the message route and check the correctness of transmission. |
+
+
+<a name="neo.fs.v2.object.PutSingleResponse.Body"></a>
+
+### Message PutSingleResponse.Body
+PUT Single Object response body
+
+
+
 <a name="neo.fs.v2.object.Range"></a>
 
 ### Message Range
@@ -726,11 +965,11 @@ Object Search request body
 <a name="neo.fs.v2.object.SearchRequest.Body.Filter"></a>
 
 ### Message SearchRequest.Body.Filter
-Filter structure checks if the object header field or the attribute content
-matches a value.
+Filter structure checks if the object header field or the attribute
+content matches a value.
 
 If no filters are set, search request will return all objects of the
-container, including Regular object, Tombstones and Storage Group
+container, including Regular object and Tombstone
 objects. Most human users expect to get only object they can directly
 work with. In that case, `$Object:ROOT` filter should be used.
 
@@ -760,16 +999,19 @@ prefix to the name. Here is the list of fields available via this prefix:
   object_id of parent
 * $Object:split.splitID \
   16 byte UUIDv4 used to identify the split object hierarchy parts
+* $Object:ec.parent \
+  If the object is stored according to EC policy, then ec_parent
+  attribute is set to return an id list of all related EC chunks.
 
 There are some well-known filter aliases to match objects by certain
 properties:
 
 * $Object:ROOT \
-  Returns only `REGULAR` type objects that are not split or that are the top
-  level root objects in a split hierarchy. This includes objects not
+  Returns only `REGULAR` type objects that are not split or that are the
+  top level root objects in a split hierarchy. This includes objects not
   present physically, like large objects split into smaller objects
   without a separate top-level root object. Objects of other types like
-  StorageGroups and Tombstones will not be shown. This filter may be
+  Locks and Tombstones will not be shown. This filter may be
   useful for listing objects like `ls` command of some virtual file
   system. This filter is activated if the `key` exists, disregarding the
   value and matcher type.
@@ -778,8 +1020,8 @@ properties:
   activated if the `key` exists, disregarding the value and matcher type.
 
 Note: using filters with a key with prefix `$Object:` and match type
-`NOT_PRESENT `is not recommended since this is not a cross-version approach.
-Behavior when processing this kind of filters is undefined.
+`NOT_PRESENT `is not recommended since this is not a cross-version
+approach. Behavior when processing this kind of filters is undefined.
 
 
 | Field | Type | Label | Description |
@@ -827,6 +1069,30 @@ Object Search response body
  <!-- end services -->
 
 
+<a name="neo.fs.v2.object.ECInfo"></a>
+
+### Message ECInfo
+Meta information for the erasure-encoded object.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| chunks | [ECInfo.Chunk](#neo.fs.v2.object.ECInfo.Chunk) | repeated | Chunk stored on the node. |
+
+
+<a name="neo.fs.v2.object.ECInfo.Chunk"></a>
+
+### Message ECInfo.Chunk
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| id | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) |  | Object ID of the chunk. |
+| index | [uint32](#uint32) |  | Index of the chunk. |
+| total | [uint32](#uint32) |  | Total number of chunks in this split. |
+
+
 <a name="neo.fs.v2.object.Header"></a>
 
 ### Message Header
@@ -846,6 +1112,7 @@ Object Header
 | session_token | [neo.fs.v2.session.SessionToken](#neo.fs.v2.session.SessionToken) |  | Session token, if it was used during Object creation. Need it to verify integrity and authenticity out of Request scope. |
 | attributes | [Header.Attribute](#neo.fs.v2.object.Header.Attribute) | repeated | User-defined object attributes |
 | split | [Header.Split](#neo.fs.v2.object.Header.Split) |  | Position of the object in the split hierarchy |
+| ec | [Header.EC](#neo.fs.v2.object.Header.EC) |  | Erasure code chunk information. |
 
 
 <a name="neo.fs.v2.object.Header.Attribute"></a>
@@ -858,15 +1125,16 @@ Key name must be an object-unique valid UTF-8 string. Value can't be empty.
 Objects with duplicated attribute names or attributes with empty values
 will be considered invalid.
 
-There are some "well-known" attributes starting with `__SYSTEM__` (`__NEOFS__` is deprecated) prefix
-that affect system behaviour:
+There are some "well-known" attributes starting with `__SYSTEM__`
+(`__NEOFS__` is deprecated) prefix that affect system behaviour:
 
 * [ __SYSTEM__UPLOAD_ID ] \
   (`__NEOFS__UPLOAD_ID` is deprecated) \
   Marks smaller parts of a split bigger object
 * [ __SYSTEM__EXPIRATION_EPOCH ] \
   (`__NEOFS__EXPIRATION_EPOCH` is deprecated) \
-  Tells GC to delete object after that epoch
+  The epoch after which object with no LOCKs on it becomes unavailable.
+  Locked object continues to be available until each of the LOCKs expire.
 * [ __SYSTEM__TICK_EPOCH ] \
   (`__NEOFS__TICK_EPOCH` is deprecated) \
   Decimal number that defines what epoch must produce
@@ -896,7 +1164,7 @@ And some well-known attributes used by applications only:
   MIME Content Type of object's payload
 
 For detailed description of each well-known attribute please see the
-corresponding section in NeoFS Technical Specification.
+corresponding section in FrostFS Technical Specification.
 
 
 | Field | Type | Label | Description |
@@ -905,6 +1173,26 @@ corresponding section in NeoFS Technical Specification.
 | value | [string](#string) |  | string value of the object attribute |
 
 
+<a name="neo.fs.v2.object.Header.EC"></a>
+
+### Message Header.EC
+Erasure code can be applied to any object.
+Information about encoded object structure is stored in `EC` header.
+All objects belonging to a single EC group have the same `parent` field.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| parent | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) |  | Identifier of the origin object. Known to all chunks. |
+| index | [uint32](#uint32) |  | Index of this chunk. |
+| total | [uint32](#uint32) |  | Total number of chunks in this split. |
+| header_length | [uint32](#uint32) |  | Total length of a parent header. Used to trim padding zeroes. |
+| header | [bytes](#bytes) |  | Chunk of a parent header. |
+| parent_split_id | [bytes](#bytes) |  | As the origin object is EC-splitted its identifier is known to all chunks as parent. But parent itself can be a part of Split (does not relate to EC-split). In this case parent_split_id should be set. |
+| parent_split_parent_id | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) |  | EC-parent's parent ID. parent_split_parent_id is set if EC-parent, itself, is a part of Split and if an object ID of its parent is presented. The field allows to determine how EC-chunk is placed in Split hierarchy. |
+| parent_attributes | [Header.Attribute](#neo.fs.v2.object.Header.Attribute) | repeated | EC parent's attributes. |
+
+
 <a name="neo.fs.v2.object.Header.Split"></a>
 
 ### Message Header.Split
@@ -928,8 +1216,8 @@ must be within the same container.
 
 ### Message Object
 Object structure. Object is immutable and content-addressed. It means
-`ObjectID` will change if the header or the payload changes. It's calculated as a
-hash of header field which contains hash of the object's payload.
+`ObjectID` will change if the header or the payload changes. It's calculated
+as a hash of header field which contains hash of the object's payload.
 
 For non-regular object types payload format depends on object type specified
 in the header.
@@ -965,8 +1253,8 @@ Short header fields
 ### Message SplitInfo
 Meta information of split hierarchy for object assembly. With the last part
 one can traverse linked list of split hierarchy back to the first part and
-assemble the original object. With a linking object one can assemble an object
-right from the object parts.
+assemble the original object. With a linking object one can assemble an
+object right from the object parts.
 
 
 | Field | Type | Label | Description |
@@ -997,20 +1285,18 @@ Type of match expression
 
 ### ObjectType
 Type of the object payload content. Only `REGULAR` type objects can be split,
-hence `TOMBSTONE`, `STORAGE_GROUP` and `LOCK` payload is limited by the maximum
-object size.
+hence `TOMBSTONE` and `LOCK` payload is limited by the
+maximum object size.
 
 String presentation of object type is the same as definition:
 * REGULAR
 * TOMBSTONE
-* STORAGE_GROUP
 * LOCK
 
 | Name | Number | Description |
 | ---- | ------ | ----------- |
 | REGULAR | 0 | Just a normal object |
 | TOMBSTONE | 1 | Used internally to identify deleted objects |
-| STORAGE_GROUP | 2 | StorageGroup information |
 | LOCK | 3 | Object lock |
 
 
@@ -1037,4 +1323,3 @@ String presentation of object type is the same as definition:
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/refs.md

@@ -3,20 +3,20 @@
 
 ## Table of Contents
 
-- [Protocol Documentation](#protocol-documentation)
-  - [Table of Contents](#table-of-contents)
-  - [refs/types.proto](#refstypesproto)
-    - [Message Address](#message-address)
-    - [Message Checksum](#message-checksum)
-    - [Message ContainerID](#message-containerid)
-    - [Message ObjectID](#message-objectid)
-    - [Message OwnerID](#message-ownerid)
-    - [Message Signature](#message-signature)
-    - [Message SignatureRFC6979](#message-signaturerfc6979)
-    - [Message Version](#message-version)
-    - [ChecksumType](#checksumtype)
-    - [SignatureScheme](#signaturescheme)
-  - [Scalar Value Types](#scalar-value-types)
+- [refs/types.proto](#refs/types.proto)
+
+  - Messages
+      - [Address](#neo.fs.v2.refs.Address)
+      - [Checksum](#neo.fs.v2.refs.Checksum)
+      - [ContainerID](#neo.fs.v2.refs.ContainerID)
+      - [ObjectID](#neo.fs.v2.refs.ObjectID)
+      - [OwnerID](#neo.fs.v2.refs.OwnerID)
+      - [Signature](#neo.fs.v2.refs.Signature)
+      - [SignatureRFC6979](#neo.fs.v2.refs.SignatureRFC6979)
+      - [Version](#neo.fs.v2.refs.Version)
+
+
+- [Scalar Value Types](#scalar-value-types)
 
 
 
@@ -32,7 +32,7 @@
 <a name="neo.fs.v2.refs.Address"></a>
 
 ### Message Address
-Objects in NeoFS are addressed by their ContainerID and ObjectID.
+Objects in FrostFS are addressed by their ContainerID and ObjectID.
 
 String presentation of `Address` is a concatenation of string encoded
 `ContainerID` and `ObjectID` delimited by '/' character.
@@ -65,7 +65,7 @@ Depending on checksum algorithm type, the string presentation may vary:
 <a name="neo.fs.v2.refs.ContainerID"></a>
 
 ### Message ContainerID
-NeoFS container identifier. Container structures are immutable and
+FrostFS container identifier. Container structures are immutable and
 content-addressed.
 
 `ContainerID` is a 32 byte long
@@ -90,13 +90,14 @@ with/without paddings are accepted.
 <a name="neo.fs.v2.refs.ObjectID"></a>
 
 ### Message ObjectID
-NeoFS Object unique identifier. Objects are immutable and content-addressed.
-It means `ObjectID` will change if the `header` or the `payload` changes.
+FrostFS Object unique identifier. Objects are immutable and
+content-addressed. It means `ObjectID` will change if the `header` or the
+`payload` changes.
 
 `ObjectID` is a 32 byte long
 [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
-the object's `header` field, which, in it's turn, contains the hash of the object's
-payload.
+the object's `header` field, which, in it's turn, contains the hash of the
+object's payload.
 
 String presentation is a
 [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.
@@ -141,7 +142,7 @@ with/without paddings are accepted.
 <a name="neo.fs.v2.refs.Signature"></a>
 
 ### Message Signature
-Signature of something in NeoFS.
+Signature of something in FrostFS.
 
 
 | Field | Type | Label | Description |
@@ -169,7 +170,8 @@ RFC 6979 signature.
 API version used by a node.
 
 String presentation is a Semantic Versioning 2.0.0 compatible version string
-with 'v' prefix. i.e. `vX.Y`, where `X` is the major number, `Y` is the minor number.
+with 'v' prefix. i.e. `vX.Y`, where `X` is the major number, `Y` is the minor
+number.
 
 
 | Field | Type | Label | Description |
@@ -196,7 +198,8 @@ Checksum algorithm type.
 <a name="neo.fs.v2.refs.SignatureScheme"></a>
 
 ### SignatureScheme
-Signature scheme describes digital signing scheme used for (key, signature) pair.
+Signature scheme describes digital signing scheme used for (key, signature)
+pair.
 
 | Name | Number | Description |
 | ---- | ------ | ----------- |
@@ -228,4 +231,3 @@ Signature scheme describes digital signing scheme used for (key, signature) pair
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/service.md

@@ -1,125 +0,0 @@
-# Protocol Documentation
-<a name="top"></a>
-
-## Table of Contents
-
-- [service/types.proto](#service/types.proto)
-
-  - Messages
-    - [RequestMetaHeader](#neo.fs.v2.service.RequestMetaHeader)
-    - [RequestVerificationHeader](#neo.fs.v2.service.RequestVerificationHeader)
-    - [ResponseMetaHeader](#neo.fs.v2.service.ResponseMetaHeader)
-    - [ResponseVerificationHeader](#neo.fs.v2.service.ResponseVerificationHeader)
-    - [XHeader](#neo.fs.v2.service.XHeader)
-    
-
-- [Scalar Value Types](#scalar-value-types)
-
-
-
-<a name="service/types.proto"></a>
-<p align="right"><a href="#top">Top</a></p>
-
-## service/types.proto
-
-
- <!-- end services -->
-
-
-<a name="neo.fs.v2.service.RequestMetaHeader"></a>
-
-### Message RequestMetaHeader
-Information about the request
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| version | [neo.fs.v2.refs.Version](#neo.fs.v2.refs.Version) |  | Client API version. |
-| epoch | [uint64](#uint64) |  | Client local epoch number. Set to 0 if unknown. |
-| ttl | [uint32](#uint32) |  | Maximum number of nodes in the request route. |
-| x_headers | [XHeader](#neo.fs.v2.service.XHeader) | repeated | Request X-Headers. |
-| session_token | [neo.fs.v2.session.SessionToken](#neo.fs.v2.session.SessionToken) |  | Token is a token of the session within which the request is sent |
-| bearer_token | [neo.fs.v2.acl.BearerToken](#neo.fs.v2.acl.BearerToken) |  | Bearer is a Bearer token of the request |
-| origin | [RequestMetaHeader](#neo.fs.v2.service.RequestMetaHeader) |  | RequestMetaHeader of the origin request. |
-
-
-<a name="neo.fs.v2.service.RequestVerificationHeader"></a>
-
-### Message RequestVerificationHeader
-Verification info for request signed by all intermediate nodes
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Request Body signature. Should be generated once by request initiator. |
-| meta_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Request Meta signature is added and signed by any intermediate node |
-| origin_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Sign previous hops |
-| origin | [RequestVerificationHeader](#neo.fs.v2.service.RequestVerificationHeader) |  | Chain of previous hops signatures |
-
-
-<a name="neo.fs.v2.service.ResponseMetaHeader"></a>
-
-### Message ResponseMetaHeader
-Information about the response
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| version | [neo.fs.v2.refs.Version](#neo.fs.v2.refs.Version) |  | Server API version. |
-| epoch | [uint64](#uint64) |  | Server local epoch number. |
-| ttl | [uint32](#uint32) |  | Maximum number of nodes in the response route. |
-| x_headers | [XHeader](#neo.fs.v2.service.XHeader) | repeated | Response X-Headers. |
-| origin | [ResponseMetaHeader](#neo.fs.v2.service.ResponseMetaHeader) |  | Carries response meta header of the origin response. |
-
-
-<a name="neo.fs.v2.service.ResponseVerificationHeader"></a>
-
-### Message ResponseVerificationHeader
-Verification info for response signed by all intermediate nodes
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| body_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Response Body signature. Should be generated once by answering node. |
-| meta_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Response Meta signature is added and signed by any intermediate node |
-| origin_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Sign previous hops |
-| origin | [ResponseVerificationHeader](#neo.fs.v2.service.ResponseVerificationHeader) |  | Chain of previous hops signatures |
-
-
-<a name="neo.fs.v2.service.XHeader"></a>
-
-### Message XHeader
-Extended headers for Request/Response
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| key | [string](#string) |  | Key of the X-Header. |
-| value | [string](#string) |  | Value of the X-Header. |
-
- <!-- end messages -->
-
- <!-- end enums -->
-
-
-
-## Scalar Value Types
-
-| .proto Type | Notes | C++ Type | Java Type | Python Type |
-| ----------- | ----- | -------- | --------- | ----------- |
-| <a name="double" /> double |  | double | double | float |
-| <a name="float" /> float |  | float | float | float |
-| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
-| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
-| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
-| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
-| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
-| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
-| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
-| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
-| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
-| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
-| <a name="bool" /> bool |  | bool | boolean | boolean |
-| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
-| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/session.md

@@ -4,31 +4,31 @@
 ## Table of Contents
 
 - [session/service.proto](#session/service.proto)
- - Services
-    - [SessionService](#neo.fs.v2.session.SessionService)
-    
+  - Services
+      - [SessionService](#neo.fs.v2.session.SessionService)
+
   - Messages
-    - [CreateRequest](#neo.fs.v2.session.CreateRequest)
-    - [CreateRequest.Body](#neo.fs.v2.session.CreateRequest.Body)
-    - [CreateResponse](#neo.fs.v2.session.CreateResponse)
-    - [CreateResponse.Body](#neo.fs.v2.session.CreateResponse.Body)
-    
+      - [CreateRequest](#neo.fs.v2.session.CreateRequest)
+      - [CreateRequest.Body](#neo.fs.v2.session.CreateRequest.Body)
+      - [CreateResponse](#neo.fs.v2.session.CreateResponse)
+      - [CreateResponse.Body](#neo.fs.v2.session.CreateResponse.Body)
+
 
 - [session/types.proto](#session/types.proto)
 
   - Messages
-    - [ContainerSessionContext](#neo.fs.v2.session.ContainerSessionContext)
-    - [ObjectSessionContext](#neo.fs.v2.session.ObjectSessionContext)
-    - [ObjectSessionContext.Target](#neo.fs.v2.session.ObjectSessionContext.Target)
-    - [RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader)
-    - [RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader)
-    - [ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader)
-    - [ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader)
-    - [SessionToken](#neo.fs.v2.session.SessionToken)
-    - [SessionToken.Body](#neo.fs.v2.session.SessionToken.Body)
-    - [SessionToken.Body.TokenLifetime](#neo.fs.v2.session.SessionToken.Body.TokenLifetime)
-    - [XHeader](#neo.fs.v2.session.XHeader)
-    
+      - [ContainerSessionContext](#neo.fs.v2.session.ContainerSessionContext)
+      - [ObjectSessionContext](#neo.fs.v2.session.ObjectSessionContext)
+      - [ObjectSessionContext.Target](#neo.fs.v2.session.ObjectSessionContext.Target)
+      - [RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader)
+      - [RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader)
+      - [ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader)
+      - [ResponseVerificationHeader](#neo.fs.v2.session.ResponseVerificationHeader)
+      - [SessionToken](#neo.fs.v2.session.SessionToken)
+      - [SessionToken.Body](#neo.fs.v2.session.SessionToken.Body)
+      - [SessionToken.Body.TokenLifetime](#neo.fs.v2.session.SessionToken.Body.TokenLifetime)
+      - [XHeader](#neo.fs.v2.session.XHeader)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -48,7 +48,7 @@
 `SessionService` allows to establish a temporary trust relationship between
 two peer nodes and generate a `SessionToken` as the proof of trust to be
 attached in requests for further verification. Please see corresponding
-section of NeoFS Technical Specification for details.
+section of FrostFS Technical Specification for details.
 
 ```
 rpc Create(CreateRequest) returns (CreateResponse);
@@ -168,7 +168,7 @@ Carries objects involved in the object session.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | container | [neo.fs.v2.refs.ContainerID](#neo.fs.v2.refs.ContainerID) |  | Indicates which container the session is spread to. Field MUST be set and correct. |
-| objects | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | Indicates which objects the session is spread to. Objects are expected to be stored in the NeoFS container referenced by `container` field. Each element MUST have correct format. |
+| objects | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | Indicates which objects the session is spread to. Objects are expected to be stored in the FrostFS container referenced by `container` field. Each element MUST have correct format. |
 
 
 <a name="neo.fs.v2.session.RequestMetaHeader"></a>
@@ -187,7 +187,7 @@ request meta headers are folded in matryoshka style.
 | session_token | [SessionToken](#neo.fs.v2.session.SessionToken) |  | Session token within which the request is sent |
 | bearer_token | [neo.fs.v2.acl.BearerToken](#neo.fs.v2.acl.BearerToken) |  | `BearerToken` with eACL overrides for the request |
 | origin | [RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) |  | `RequestMetaHeader` of the origin request |
-| magic_number | [uint64](#uint64) |  | NeoFS network magic. Must match the value for the network that the server belongs to. |
+| magic_number | [uint64](#uint64) |  | FrostFS network magic. Must match the value for the network that the server belongs to. |
 
 
 <a name="neo.fs.v2.session.RequestVerificationHeader"></a>
@@ -237,12 +237,12 @@ Verification info for the response signed by all intermediate nodes
 <a name="neo.fs.v2.session.SessionToken"></a>
 
 ### Message SessionToken
-NeoFS Session Token.
+FrostFS Session Token.
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| body | [SessionToken.Body](#neo.fs.v2.session.SessionToken.Body) |  | Session Token contains the proof of trust between peers to be attached in requests for further verification. Please see corresponding section of NeoFS Technical Specification for details. |
+| body | [SessionToken.Body](#neo.fs.v2.session.SessionToken.Body) |  | Session Token contains the proof of trust between peers to be attached in requests for further verification. Please see corresponding section of FrostFS Technical Specification for details. |
 | signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) |  | Signature of `SessionToken` information |
 
 
@@ -278,15 +278,15 @@ Lifetime parameters of the token. Field names taken from rfc7519.
 <a name="neo.fs.v2.session.XHeader"></a>
 
 ### Message XHeader
-Extended headers for Request/Response. They may contain any user-defined headers
-to be interpreted on application level.
+Extended headers for Request/Response. They may contain any user-defined
+headers to be interpreted on application level.
 
-Key name must be a unique valid UTF-8 string. Value can't be empty. Requests or
-Responses with duplicated header names or headers with empty values will be
-considered invalid.
+Key name must be a unique valid UTF-8 string. Value can't be empty. Requests
+or Responses with duplicated header names or headers with empty values will
+be considered invalid.
 
-There are some "well-known" headers starting with `__SYSTEM__` (`__NEOFS__` is deprecated) prefix that
-affect system behaviour:
+There are some "well-known" headers starting with `__SYSTEM__` (`__NEOFS__`
+is deprecated) prefix that affect system behaviour:
 
 * [ __SYSTEM__NETMAP_EPOCH ] \
   (`__NEOFS__NETMAP_EPOCH` is deprecated) \
@@ -297,8 +297,8 @@ affect system behaviour:
   (`__NEOFS__NETMAP_LOOKUP_DEPTH` is deprecated) \
   If object can't be found using current epoch's netmap, this header limits
   how many past epochs the node can look up through. The `value` is string
-  encoded `uint64` in decimal presentation. If set to '0' or not set, only the
-  current epoch will be used.
+  encoded `uint64` in decimal presentation. If set to '0' or not set, only
+  the current epoch will be used.
 
 
 | Field | Type | Label | Description |
@@ -338,6 +338,7 @@ Object request verbs
 | DELETE | 5 | Refers to object.Delete RPC call |
 | RANGE | 6 | Refers to object.GetRange RPC call |
 | RANGEHASH | 7 | Refers to object.GetRangeHash RPC call |
+| PATCH | 8 | Refers to object.Patch RPC call |
 
 
  <!-- end enums -->
@@ -363,4 +364,3 @@ Object request verbs
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/status.md

@@ -6,9 +6,9 @@
 - [status/types.proto](#status/types.proto)
 
   - Messages
-    - [Status](#neo.fs.v2.status.Status)
-    - [Status.Detail](#neo.fs.v2.status.Status.Detail)
-    
+      - [Status](#neo.fs.v2.status.Status)
+      - [Status.Detail](#neo.fs.v2.status.Status.Detail)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -26,12 +26,12 @@
 <a name="neo.fs.v2.status.Status"></a>
 
 ### Message Status
-Declares the general format of the status returns of the NeoFS RPC protocol.
-Status is present in all response messages. Each RPC of NeoFS protocol
-describes the possible outcomes and details of the operation.
+Declares the general format of the status returns of the FrostFS RPC
+protocol. Status is present in all response messages. Each RPC of FrostFS
+protocol describes the possible outcomes and details of the operation.
 
 Each status is assigned a one-to-one numeric code. Any unique result of an
-operation in NeoFS is unambiguously associated with the code value.
+operation in FrostFS is unambiguously associated with the code value.
 
 Numerical set of codes is split into 1024-element sections. An enumeration
 is defined for each section. Values can be referred to in the following ways:
@@ -79,6 +79,17 @@ covered by the code.
  <!-- end messages -->
 
 
+<a name="neo.fs.v2.status.APEManager"></a>
+
+### APEManager
+Section of status for APE manager related operations.
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| APE_MANAGER_ACCESS_DENIED | 0 | [**5120**] The operation is denied by APE manager. |
+
+
+
 <a name="neo.fs.v2.status.CommonFail"></a>
 
 ### CommonFail
@@ -87,9 +98,10 @@ Section of failed statuses independent of the operation.
 | Name | Number | Description |
 | ---- | ------ | ----------- |
 | INTERNAL | 0 | [**1024**] Internal server error, default failure. Not detailed. If the server cannot match failed outcome to the code, it should use this code. |
-| WRONG_MAGIC_NUMBER | 1 | [**1025**] Wrong magic of the NeoFS network. Details: - [**0**] Magic number of the served NeoFS network (big-endian 64-bit unsigned integer). |
+| WRONG_MAGIC_NUMBER | 1 | [**1025**] Wrong magic of the FrostFS network. Details: - [**0**] Magic number of the served FrostFS network (big-endian 64-bit unsigned integer). |
 | SIGNATURE_VERIFICATION_FAIL | 2 | [**1026**] Signature verification failure. |
 | NODE_UNDER_MAINTENANCE | 3 | [**1027**] Node is under maintenance. |
+| INVALID_ARGUMENT | 4 | [**1028**] Invalid argument error. If the server fails on validation of a request parameter as the client sent it incorrectly, then this code should be used. |
 
 
 
@@ -102,6 +114,7 @@ Section of statuses for container-related operations.
 | ---- | ------ | ----------- |
 | CONTAINER_NOT_FOUND | 0 | [**3072**] Container not found. |
 | EACL_NOT_FOUND | 1 | [**3073**] eACL table not found. |
+| CONTAINER_ACCESS_DENIED | 2 | [**3074**] Container access denied. |
 
 
 
@@ -133,6 +146,7 @@ Section identifiers.
 | SECTION_OBJECT | 2 | Object service-specific errors. |
 | SECTION_CONTAINER | 3 | Container service-specific errors. |
 | SECTION_SESSION | 4 | Session service-specific errors. |
+| SECTION_APE_MANAGER | 5 | Session service-specific errors. |
 
 
 
@@ -151,7 +165,7 @@ Section of statuses for session-related operations.
 <a name="neo.fs.v2.status.Success"></a>
 
 ### Success
-Section of NeoFS successful return codes.
+Section of FrostFS successful return codes.
 
 | Name | Number | Description |
 | ---- | ------ | ----------- |
@@ -181,4 +195,3 @@ Section of NeoFS successful return codes.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/storagegroup.md

@@ -1,71 +0,0 @@
-# Protocol Documentation
-<a name="top"></a>
-
-## Table of Contents
-
-- [storagegroup/types.proto](#storagegroup/types.proto)
-
-  - Messages
-    - [StorageGroup](#neo.fs.v2.storagegroup.StorageGroup)
-    
-
-- [Scalar Value Types](#scalar-value-types)
-
-
-
-<a name="storagegroup/types.proto"></a>
-<p align="right"><a href="#top">Top</a></p>
-
-## storagegroup/types.proto
-
-
- <!-- end services -->
-
-
-<a name="neo.fs.v2.storagegroup.StorageGroup"></a>
-
-### Message StorageGroup
-StorageGroup keeps verification information for Data Audit sessions. Objects
-that require paid storage guarantees are gathered in `StorageGroups` with
-additional information used for the proof of storage. `StorageGroup` only
-contains objects from the same container.
-
-Being an object payload, StorageGroup may have expiration Epoch set with
-`__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) well-known attribute. When expired, StorageGroup
-will be ignored by InnerRing nodes during Data Audit cycles and will be
-deleted by Storage Nodes.
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| validation_data_size | [uint64](#uint64) |  | Total size of the payloads of objects in the storage group |
-| validation_hash | [neo.fs.v2.refs.Checksum](#neo.fs.v2.refs.Checksum) |  | Homomorphic hash from the concatenation of the payloads of the storage group members. The order of concatenation is the same as the order of the members in the `members` field. |
-| expiration_epoch | [uint64](#uint64) |  | DEPRECATED. Last NeoFS epoch number of the storage group lifetime |
-| members | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | Strictly ordered list of storage group member objects. Members MUST be unique |
-
- <!-- end messages -->
-
- <!-- end enums -->
-
-
-
-## Scalar Value Types
-
-| .proto Type | Notes | C++ Type | Java Type | Python Type |
-| ----------- | ----- | -------- | --------- | ----------- |
-| <a name="double" /> double |  | double | double | float |
-| <a name="float" /> float |  | float | float | float |
-| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
-| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
-| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
-| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
-| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
-| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
-| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
-| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
-| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
-| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
-| <a name="bool" /> bool |  | bool | boolean | boolean |
-| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
-| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

proto-docs/tombstone.md

@@ -6,8 +6,8 @@
 - [tombstone/types.proto](#tombstone/types.proto)
 
   - Messages
-    - [Tombstone](#neo.fs.v2.tombstone.Tombstone)
-    
+      - [Tombstone](#neo.fs.v2.tombstone.Tombstone)
+
 
 - [Scalar Value Types](#scalar-value-types)
 
@@ -26,12 +26,12 @@
 
 ### Message Tombstone
 Tombstone keeps record of deleted objects for a few epochs until they are
-purged from the NeoFS network.
+purged from the FrostFS network.
 
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| expiration_epoch | [uint64](#uint64) |  | Last NeoFS epoch number of the tombstone lifetime. It's set by the tombstone creator depending on the current NeoFS network settings. A tombstone object must have the same expiration epoch value in `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) attribute. Otherwise, the tombstone will be rejected by a storage node. |
+| expiration_epoch | [uint64](#uint64) |  | Last FrostFS epoch number of the tombstone lifetime. It's set by the tombstone creator depending on the current FrostFS network settings. A tombstone object must have the same expiration epoch value in `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) attribute. Otherwise, the tombstone will be rejected by a storage node. |
 | split_id | [bytes](#bytes) |  | 16 byte UUID used to identify the split object hierarchy parts. Must be unique inside a container. All objects participating in the split must have the same `split_id` value. |
 | members | [neo.fs.v2.refs.ObjectID](#neo.fs.v2.refs.ObjectID) | repeated | List of objects to be deleted. |
 
@@ -60,4 +60,3 @@ purged from the NeoFS network.
 | <a name="bool" /> bool |  | bool | boolean | boolean |
 | <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
 | <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
-

refs/types.proto

@@ -5,24 +5,25 @@ package neo.fs.v2.refs;
 option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/refs/grpc;refs";
 option csharp_namespace = "Neo.FileStorage.API.Refs";
 
-// Objects in NeoFS are addressed by their ContainerID and ObjectID.
+// Objects in FrostFS are addressed by their ContainerID and ObjectID.
 //
 // String presentation of `Address` is a concatenation of string encoded
 // `ContainerID` and `ObjectID` delimited by '/' character.
 message Address {
   // Container identifier
-  ContainerID container_id = 1 [json_name = "containerID"];
+  ContainerID container_id = 1 [ json_name = "containerID" ];
   // Object identifier
-  ObjectID object_id = 2 [json_name = "objectID"];
+  ObjectID object_id = 2 [ json_name = "objectID" ];
 }
 
-// NeoFS Object unique identifier. Objects are immutable and content-addressed.
-// It means `ObjectID` will change if the `header` or the `payload` changes.
+// FrostFS Object unique identifier. Objects are immutable and
+// content-addressed. It means `ObjectID` will change if the `header` or the
+// `payload` changes.
 //
 // `ObjectID` is a 32 byte long
 // [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
-// the object's `header` field, which, in it's turn, contains the hash of the object's
-// payload.
+// the object's `header` field, which, in it's turn, contains the hash of the
+// object's payload.
 //
 // String presentation is a
 // [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.
@@ -34,10 +35,10 @@ message Address {
 // with/without paddings are accepted.
 message ObjectID {
   // Object identifier in a binary format
-  bytes value = 1 [json_name = "value"];
+  bytes value = 1 [ json_name = "value" ];
 }
 
-// NeoFS container identifier. Container structures are immutable and
+// FrostFS container identifier. Container structures are immutable and
 // content-addressed.
 //
 // `ContainerID` is a 32 byte long
@@ -54,7 +55,7 @@ message ObjectID {
 // with/without paddings are accepted.
 message ContainerID {
   // Container identifier in a binary format.
-  bytes value = 1 [json_name = "value"];
+  bytes value = 1 [ json_name = "value" ];
 }
 
 // `OwnerID` is a derivative of a user's main public key. The transformation
@@ -74,32 +75,34 @@ message ContainerID {
 // with/without paddings are accepted.
 message OwnerID {
   // Identifier of the container owner in a binary format
-  bytes value = 1 [json_name = "value"];
+  bytes value = 1 [ json_name = "value" ];
 }
 
 // API version used by a node.
 //
 // String presentation is a Semantic Versioning 2.0.0 compatible version string
-// with 'v' prefix. i.e. `vX.Y`, where `X` is the major number, `Y` is the minor number.
+// with 'v' prefix. i.e. `vX.Y`, where `X` is the major number, `Y` is the minor
+// number.
 message Version {
   // Major API version
-  uint32 major = 1 [json_name = "major"];
+  uint32 major = 1 [ json_name = "major" ];
 
   // Minor API version
-  uint32 minor = 2 [json_name = "minor"];
+  uint32 minor = 2 [ json_name = "minor" ];
 }
 
-// Signature of something in NeoFS.
+// Signature of something in FrostFS.
 message Signature {
   // Public key used for signing
-  bytes key = 1 [json_name = "key"];
+  bytes key = 1 [ json_name = "key" ];
   // Signature
-  bytes sign = 2 [json_name = "signature"];
+  bytes sign = 2 [ json_name = "signature" ];
   // Scheme contains digital signature scheme identifier
-  SignatureScheme scheme = 3 [json_name = "scheme"];
+  SignatureScheme scheme = 3 [ json_name = "scheme" ];
 }
 
-// Signature scheme describes digital signing scheme used for (key, signature) pair.
+// Signature scheme describes digital signing scheme used for (key, signature)
+// pair.
 enum SignatureScheme {
   // ECDSA with SHA-512 hashing (FIPS 186-3)
   ECDSA_SHA512 = 0;
@@ -115,9 +118,9 @@ enum SignatureScheme {
 // RFC 6979 signature.
 message SignatureRFC6979 {
   // Public key used for signing
-  bytes key = 1 [json_name = "key"];
+  bytes key = 1 [ json_name = "key" ];
   // Deterministic ECDSA with SHA-256 hashing
-  bytes sign = 2 [json_name = "signature"];
+  bytes sign = 2 [ json_name = "signature" ];
 }
 
 // Checksum algorithm type.
@@ -141,8 +144,8 @@ enum ChecksumType {
 //   Hex encoded string without `0x` prefix
 message Checksum {
   // Checksum algorithm type
-  ChecksumType type = 1 [json_name = "type"];
+  ChecksumType type = 1 [ json_name = "type" ];
 
   // Checksum itself
-  bytes sum = 2 [json_name = "sum"];
+  bytes sum = 2 [ json_name = "sum" ];
 }

session/service.proto

@@ -11,7 +11,7 @@ import "session/types.proto";
 // `SessionService` allows to establish a temporary trust relationship between
 // two peer nodes and generate a `SessionToken` as the proof of trust to be
 // attached in requests for further verification. Please see corresponding
-// section of NeoFS Technical Specification for details.
+// section of FrostFS Technical Specification for details.
 service SessionService {
   // Open a new session between two peers.
   //
@@ -19,7 +19,7 @@ service SessionService {
   // - **OK** (0, SECTION_SUCCESS):
   // session has been successfully opened;
   // - Common failures (SECTION_FAILURE_COMMON).
-  rpc Create (CreateRequest) returns (CreateResponse);
+  rpc Create(CreateRequest) returns (CreateResponse);
 }
 
 // Information necessary for opening a session.

session/types.proto

@@ -36,109 +36,112 @@ message ObjectSessionContext {
 
     // Refers to object.GetRangeHash RPC call
     RANGEHASH = 7;
+
+    // Refers to object.Patch RPC call
+    PATCH = 8;
   }
   // Type of request for which the token is issued
-  Verb verb = 1 [json_name = "verb"];
+  Verb verb = 1 [ json_name = "verb" ];
 
   // Carries objects involved in the object session.
   message Target {
     // Indicates which container the session is spread to. Field MUST be set
     // and correct.
-    refs.ContainerID container = 1 [json_name = "container"];
+    refs.ContainerID container = 1 [ json_name = "container" ];
 
     // Indicates which objects the session is spread to. Objects are expected
-    // to be stored in the NeoFS container referenced by `container` field.
+    // to be stored in the FrostFS container referenced by `container` field.
     // Each element MUST have correct format.
-    repeated refs.ObjectID objects = 2 [json_name = "objects"];
+    repeated refs.ObjectID objects = 2 [ json_name = "objects" ];
   }
   // Object session target. MUST be correctly formed and set. If `objects`
   // field is not empty, then the session applies only to these elements,
   // otherwise, to all objects from the specified container.
-  Target target = 2 [json_name = "target"];
+  Target target = 2 [ json_name = "target" ];
 }
 
 // Context information for Session Tokens related to ContainerService requests.
 message ContainerSessionContext {
-    // Container request verbs
-    enum Verb {
-        // Unknown verb
-        VERB_UNSPECIFIED = 0;
+  // Container request verbs
+  enum Verb {
+    // Unknown verb
+    VERB_UNSPECIFIED = 0;
 
-        // Refers to container.Put RPC call
-        PUT = 1;
+    // Refers to container.Put RPC call
+    PUT = 1;
 
-        // Refers to container.Delete RPC call
-        DELETE = 2;
+    // Refers to container.Delete RPC call
+    DELETE = 2;
 
-        // Refers to container.SetExtendedACL RPC call
-        SETEACL = 3;
-    }
-    // Type of request for which the token is issued
-    Verb verb = 1 [json_name = "verb"];
+    // Refers to container.SetExtendedACL RPC call
+    SETEACL = 3;
+  }
+  // Type of request for which the token is issued
+  Verb verb = 1 [ json_name = "verb" ];
 
-    // Spreads the action to all owner containers.
-    // If set, container_id field is ignored.
-    bool wildcard = 2 [json_name = "wildcard"];
+  // Spreads the action to all owner containers.
+  // If set, container_id field is ignored.
+  bool wildcard = 2 [ json_name = "wildcard" ];
 
-    // Particular container to which the action applies.
-    // Ignored if wildcard flag is set.
-    refs.ContainerID container_id = 3 [json_name = "containerID"];
+  // Particular container to which the action applies.
+  // Ignored if wildcard flag is set.
+  refs.ContainerID container_id = 3 [ json_name = "containerID" ];
 }
 
-// NeoFS Session Token.
+// FrostFS Session Token.
 message SessionToken {
   // Session Token body
   message Body {
     // Token identifier is a valid UUIDv4 in binary form
-    bytes id = 1 [json_name = "id"];
+    bytes id = 1 [ json_name = "id" ];
 
     // Identifier of the session initiator
-    neo.fs.v2.refs.OwnerID owner_id = 2 [json_name = "ownerID"];
+    neo.fs.v2.refs.OwnerID owner_id = 2 [ json_name = "ownerID" ];
 
     // Lifetime parameters of the token. Field names taken from rfc7519.
     message TokenLifetime {
       // Expiration Epoch
-      uint64 exp = 1 [json_name = "exp"];
+      uint64 exp = 1 [ json_name = "exp" ];
 
       // Not valid before Epoch
-      uint64 nbf = 2 [json_name = "nbf"];
+      uint64 nbf = 2 [ json_name = "nbf" ];
 
       // Issued at Epoch
-      uint64 iat = 3 [json_name = "iat"];
+      uint64 iat = 3 [ json_name = "iat" ];
     }
     // Lifetime of the session
-    TokenLifetime lifetime = 3 [json_name = "lifetime"];
+    TokenLifetime lifetime = 3 [ json_name = "lifetime" ];
 
     // Public key used in session
-    bytes session_key = 4 [json_name = "sessionKey"];
+    bytes session_key = 4 [ json_name = "sessionKey" ];
 
     // Session Context information
     oneof context {
       // ObjectService session context
-      ObjectSessionContext object = 5 [json_name = "object"];
+      ObjectSessionContext object = 5 [ json_name = "object" ];
 
       // ContainerService session context
-      ContainerSessionContext container = 6 [json_name = "container"];
+      ContainerSessionContext container = 6 [ json_name = "container" ];
     }
   }
   // Session Token contains the proof of trust between peers to be attached in
   // requests for further verification. Please see corresponding section of
-  // NeoFS Technical Specification for details.
-  Body body = 1 [json_name = "body"];
+  // FrostFS Technical Specification for details.
+  Body body = 1 [ json_name = "body" ];
 
   // Signature of `SessionToken` information
-  neo.fs.v2.refs.Signature signature = 2 [json_name = "signature"];
+  neo.fs.v2.refs.Signature signature = 2 [ json_name = "signature" ];
 }
 
-// Extended headers for Request/Response. They may contain any user-defined headers
-// to be interpreted on application level.
+// Extended headers for Request/Response. They may contain any user-defined
+// headers to be interpreted on application level.
 //
-// Key name must be a unique valid UTF-8 string. Value can't be empty. Requests or
-// Responses with duplicated header names or headers with empty values will be
-// considered invalid.
+// Key name must be a unique valid UTF-8 string. Value can't be empty. Requests
+// or Responses with duplicated header names or headers with empty values will
+// be considered invalid.
 //
-// There are some "well-known" headers starting with `__SYSTEM__` (`__NEOFS__` is deprecated) prefix that
-// affect system behaviour:
+// There are some "well-known" headers starting with `__SYSTEM__` (`__NEOFS__`
+// is deprecated) prefix that affect system behaviour:
 //
 // * [ __SYSTEM__NETMAP_EPOCH ] \
 //   (`__NEOFS__NETMAP_EPOCH` is deprecated) \
@@ -149,88 +152,90 @@ message SessionToken {
 //   (`__NEOFS__NETMAP_LOOKUP_DEPTH` is deprecated) \
 //   If object can't be found using current epoch's netmap, this header limits
 //   how many past epochs the node can look up through. The `value` is string
-//   encoded `uint64` in decimal presentation. If set to '0' or not set, only the
-//   current epoch will be used.
+//   encoded `uint64` in decimal presentation. If set to '0' or not set, only
+//   the current epoch will be used.
 message XHeader {
   // Key of the X-Header
-  string key = 1 [json_name = "key"];
+  string key = 1 [ json_name = "key" ];
 
   // Value of the X-Header
-  string value = 2 [json_name = "value"];
+  string value = 2 [ json_name = "value" ];
 }
 
 // Meta information attached to the request. When forwarded between peers,
 // request meta headers are folded in matryoshka style.
 message RequestMetaHeader {
   // Peer's API version used
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Peer's local epoch number. Set to 0 if unknown.
-  uint64 epoch = 2 [json_name = "epoch"];
+  uint64 epoch = 2 [ json_name = "epoch" ];
 
   // Maximum number of intermediate nodes in the request route
-  uint32 ttl = 3 [json_name = "ttl"];
+  uint32 ttl = 3 [ json_name = "ttl" ];
 
   // Request X-Headers
-  repeated XHeader x_headers = 4 [json_name = "xHeaders"];
+  repeated XHeader x_headers = 4 [ json_name = "xHeaders" ];
 
   // Session token within which the request is sent
-  SessionToken session_token = 5 [json_name = "sessionToken"];
+  SessionToken session_token = 5 [ json_name = "sessionToken" ];
 
   // `BearerToken` with eACL overrides for the request
-  neo.fs.v2.acl.BearerToken bearer_token = 6 [json_name = "bearerToken"];
+  neo.fs.v2.acl.BearerToken bearer_token = 6 [ json_name = "bearerToken" ];
 
   // `RequestMetaHeader` of the origin request
-  RequestMetaHeader origin = 7 [json_name = "origin"];
+  RequestMetaHeader origin = 7 [ json_name = "origin" ];
 
-  // NeoFS network magic. Must match the value for the network
+  // FrostFS network magic. Must match the value for the network
   // that the server belongs to.
-  uint64 magic_number = 8 [json_name = "magicNumber"];
+  uint64 magic_number = 8 [ json_name = "magicNumber" ];
 }
 
 // Information about the response
 message ResponseMetaHeader {
   // Peer's API version used
-  neo.fs.v2.refs.Version version = 1 [json_name = "version"];
+  neo.fs.v2.refs.Version version = 1 [ json_name = "version" ];
 
   // Peer's local epoch number
-  uint64 epoch = 2 [json_name = "epoch"];
+  uint64 epoch = 2 [ json_name = "epoch" ];
 
   // Maximum number of intermediate nodes in the request route
-  uint32 ttl = 3 [json_name = "ttl"];
+  uint32 ttl = 3 [ json_name = "ttl" ];
 
   // Response X-Headers
-  repeated XHeader x_headers = 4 [json_name = "xHeaders"];
+  repeated XHeader x_headers = 4 [ json_name = "xHeaders" ];
 
   // `ResponseMetaHeader` of the origin request
-  ResponseMetaHeader origin = 5 [json_name = "origin"];
+  ResponseMetaHeader origin = 5 [ json_name = "origin" ];
 
   // Status return
-  neo.fs.v2.status.Status status = 6 [json_name = "status"];
+  neo.fs.v2.status.Status status = 6 [ json_name = "status" ];
 }
 
 // Verification info for the request signed by all intermediate nodes.
 message RequestVerificationHeader {
   // Request Body signature. Should be generated once by the request initiator.
-  neo.fs.v2.refs.Signature body_signature = 1 [json_name = "bodySignature"];
+  neo.fs.v2.refs.Signature body_signature = 1 [ json_name = "bodySignature" ];
   // Request Meta signature is added and signed by each intermediate node
-  neo.fs.v2.refs.Signature meta_signature = 2 [json_name = "metaSignature"];
+  neo.fs.v2.refs.Signature meta_signature = 2 [ json_name = "metaSignature" ];
   // Signature of previous hops
-  neo.fs.v2.refs.Signature origin_signature = 3 [json_name = "originSignature"];
+  neo.fs.v2.refs.Signature origin_signature = 3
+      [ json_name = "originSignature" ];
 
   // Chain of previous hops signatures
-  RequestVerificationHeader origin = 4 [json_name = "origin"];
+  RequestVerificationHeader origin = 4 [ json_name = "origin" ];
 }
 
 // Verification info for the response signed by all intermediate nodes
 message ResponseVerificationHeader {
   // Response Body signature. Should be generated once by an answering node.
-  neo.fs.v2.refs.Signature body_signature = 1 [json_name = "bodySignature"];
+  neo.fs.v2.refs.Signature body_signature = 1 [ json_name = "bodySignature" ];
   // Response Meta signature is added and signed by each intermediate node
-  neo.fs.v2.refs.Signature meta_signature = 2 [json_name = "metaSignature"];
+  neo.fs.v2.refs.Signature meta_signature = 2 [ json_name = "metaSignature" ];
   // Signature of previous hops
-  neo.fs.v2.refs.Signature origin_signature = 3 [json_name = "originSignature"];
+  neo.fs.v2.refs.Signature origin_signature = 3
+      [ json_name = "originSignature" ];
 
   // Chain of previous hops signatures
-  ResponseVerificationHeader origin = 4 [json_name = "origin"];
+  ResponseVerificationHeader origin = 4 [ json_name = "origin" ];
 }

status/types.proto

@@ -5,12 +5,12 @@ package neo.fs.v2.status;
 option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/status/grpc;status";
 option csharp_namespace = "Neo.FileStorage.API.Status";
 
-// Declares the general format of the status returns of the NeoFS RPC protocol.
-// Status is present in all response messages. Each RPC of NeoFS protocol
-// describes the possible outcomes and details of the operation.
+// Declares the general format of the status returns of the FrostFS RPC
+// protocol. Status is present in all response messages. Each RPC of FrostFS
+// protocol describes the possible outcomes and details of the operation.
 //
 // Each status is assigned a one-to-one numeric code. Any unique result of an
-// operation in NeoFS is unambiguously associated with the code value.
+// operation in FrostFS is unambiguously associated with the code value.
 //
 // Numerical set of codes is split into 1024-element sections. An enumeration
 // is defined for each section. Values can be referred to in the following ways:
@@ -33,113 +33,130 @@ option csharp_namespace = "Neo.FileStorage.API.Status";
 // should not expect) useful information in the message. Field `details`
 // should make the return more detailed.
 message Status {
-    // The status code
-    uint32 code = 1;
+  // The status code
+  uint32 code = 1;
 
-    // Developer-facing error message
-    string message = 2;
+  // Developer-facing error message
+  string message = 2;
 
-    // Return detail. It contains additional information that can be used to
-    // analyze the response. Each code defines a set of details that can be
-    // attached to a status. Client should not handle details that are not
-    // covered by the code.
-    message Detail {
-        // Detail ID. The identifier is required to determine the binary format
-        // of the detail and how to decode it.
-        uint32 id = 1;
+  // Return detail. It contains additional information that can be used to
+  // analyze the response. Each code defines a set of details that can be
+  // attached to a status. Client should not handle details that are not
+  // covered by the code.
+  message Detail {
+    // Detail ID. The identifier is required to determine the binary format
+    // of the detail and how to decode it.
+    uint32 id = 1;
 
-        // Binary status detail. Must follow the format associated with ID.
-        // The possibility of missing a value must be explicitly allowed.
-        bytes value = 2;
-    }
+    // Binary status detail. Must follow the format associated with ID.
+    // The possibility of missing a value must be explicitly allowed.
+    bytes value = 2;
+  }
 
-    // Data detailing the outcome of the operation. Must be unique by ID.
-    repeated Detail details = 3;
+  // Data detailing the outcome of the operation. Must be unique by ID.
+  repeated Detail details = 3;
 }
 
 // Section identifiers.
 enum Section {
-    // Successful return codes.
-    SECTION_SUCCESS = 0;
+  // Successful return codes.
+  SECTION_SUCCESS = 0;
 
-    // Failure codes regardless of the operation.
-    SECTION_FAILURE_COMMON = 1;
+  // Failure codes regardless of the operation.
+  SECTION_FAILURE_COMMON = 1;
 
-    // Object service-specific errors.
-    SECTION_OBJECT = 2;
+  // Object service-specific errors.
+  SECTION_OBJECT = 2;
 
-    // Container service-specific errors.
-    SECTION_CONTAINER = 3;
+  // Container service-specific errors.
+  SECTION_CONTAINER = 3;
 
-    // Session service-specific errors.
-    SECTION_SESSION = 4;
+  // Session service-specific errors.
+  SECTION_SESSION = 4;
+
+  // Session service-specific errors.
+  SECTION_APE_MANAGER = 5;
 }
 
-// Section of NeoFS successful return codes.
+// Section of FrostFS successful return codes.
 enum Success {
-    // [**0**] Default success. Not detailed.
-    // If the server cannot match successful outcome to the code, it should
-    // use this code.
-    OK = 0;
+  // [**0**] Default success. Not detailed.
+  // If the server cannot match successful outcome to the code, it should
+  // use this code.
+  OK = 0;
 }
 
 // Section of failed statuses independent of the operation.
 enum CommonFail {
-    // [**1024**] Internal server error, default failure. Not detailed.
-    // If the server cannot match failed outcome to the code, it should
-    // use this code.
-    INTERNAL = 0;
+  // [**1024**] Internal server error, default failure. Not detailed.
+  // If the server cannot match failed outcome to the code, it should
+  // use this code.
+  INTERNAL = 0;
 
-    // [**1025**] Wrong magic of the NeoFS network.
-    // Details:
-    //  - [**0**] Magic number of the served NeoFS network (big-endian 64-bit
-    //  unsigned integer).
-    WRONG_MAGIC_NUMBER = 1;
+  // [**1025**] Wrong magic of the FrostFS network.
+  // Details:
+  //  - [**0**] Magic number of the served FrostFS network (big-endian 64-bit
+  //  unsigned integer).
+  WRONG_MAGIC_NUMBER = 1;
 
-    // [**1026**] Signature verification failure.
-    SIGNATURE_VERIFICATION_FAIL = 2;
+  // [**1026**] Signature verification failure.
+  SIGNATURE_VERIFICATION_FAIL = 2;
 
-    // [**1027**] Node is under maintenance.
-    NODE_UNDER_MAINTENANCE = 3;
+  // [**1027**] Node is under maintenance.
+  NODE_UNDER_MAINTENANCE = 3;
+
+  // [**1028**] Invalid argument error. If the server fails on validation of a
+  // request parameter as the client sent it incorrectly, then this code should
+  // be used.
+  INVALID_ARGUMENT = 4;
 }
 
 // Section of statuses for object-related operations.
 enum Object {
-    // [**2048**] Access denied by ACL.
-    // Details:
-    // - [**0**] Human-readable description (UTF-8 encoded string).
-    ACCESS_DENIED = 0;
+  // [**2048**] Access denied by ACL.
+  // Details:
+  // - [**0**] Human-readable description (UTF-8 encoded string).
+  ACCESS_DENIED = 0;
 
-    // [**2049**] Object not found.
-    OBJECT_NOT_FOUND = 1;
+  // [**2049**] Object not found.
+  OBJECT_NOT_FOUND = 1;
 
-    // [**2050**] Operation rejected by the object lock.
-    LOCKED = 2;
+  // [**2050**] Operation rejected by the object lock.
+  LOCKED = 2;
 
-    // [**2051**] Locking an object with a non-REGULAR type rejected.
-    LOCK_NON_REGULAR_OBJECT = 3;
+  // [**2051**] Locking an object with a non-REGULAR type rejected.
+  LOCK_NON_REGULAR_OBJECT = 3;
 
-    // [**2052**] Object has been marked deleted.
-    OBJECT_ALREADY_REMOVED = 4;
+  // [**2052**] Object has been marked deleted.
+  OBJECT_ALREADY_REMOVED = 4;
 
-    // [**2053**] Invalid range has been requested for an object.
-    OUT_OF_RANGE = 5;
+  // [**2053**] Invalid range has been requested for an object.
+  OUT_OF_RANGE = 5;
 }
 
 // Section of statuses for container-related operations.
 enum Container {
-    // [**3072**] Container not found.
-    CONTAINER_NOT_FOUND = 0;
+  // [**3072**] Container not found.
+  CONTAINER_NOT_FOUND = 0;
 
-    // [**3073**] eACL table not found.
-    EACL_NOT_FOUND = 1;
+  // [**3073**] eACL table not found.
+  EACL_NOT_FOUND = 1;
+
+  // [**3074**] Container access denied.
+  CONTAINER_ACCESS_DENIED = 2;
 }
 
 // Section of statuses for session-related operations.
 enum Session {
-    // [**4096**] Token not found.
-    TOKEN_NOT_FOUND = 0;
+  // [**4096**] Token not found.
+  TOKEN_NOT_FOUND = 0;
 
-    // [**4097**] Token has expired.
-    TOKEN_EXPIRED = 1;
+  // [**4097**] Token has expired.
+  TOKEN_EXPIRED = 1;
+}
+
+// Section of status for APE manager related operations.
+enum APEManager {
+  // [**5120**] The operation is denied by APE manager.
+  APE_MANAGER_ACCESS_DENIED = 0;
 }

storagegroup/types.proto

@@ -1,34 +0,0 @@
-syntax = "proto3";
-
-package neo.fs.v2.storagegroup;
-
-option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/storagegroup/grpc;storagegroup";
-option csharp_namespace = "Neo.FileStorage.API.StorageGroup";
-
-import "refs/types.proto";
-
-// StorageGroup keeps verification information for Data Audit sessions. Objects
-// that require paid storage guarantees are gathered in `StorageGroups` with
-// additional information used for the proof of storage. `StorageGroup` only
-// contains objects from the same container.
-//
-// Being an object payload, StorageGroup may have expiration Epoch set with
-// `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated) well-known attribute. When expired, StorageGroup
-// will be ignored by InnerRing nodes during Data Audit cycles and will be
-// deleted by Storage Nodes.
-//
-message StorageGroup {
-  // Total size of the payloads of objects in the storage group
-  uint64 validation_data_size = 1 [json_name = "validationDataSize"];
-
-  // Homomorphic hash from the concatenation of the payloads of the storage
-  // group members. The order of concatenation is the same as the order of the
-  // members in the `members` field.
-  neo.fs.v2.refs.Checksum validation_hash = 2 [json_name = "validationHash"];
-
-  // DEPRECATED. Last NeoFS epoch number of the storage group lifetime
-  uint64 expiration_epoch = 3 [json_name = "expirationEpoch", deprecated = true];
-
-  // Strictly ordered list of storage group member objects. Members MUST be unique
-  repeated neo.fs.v2.refs.ObjectID members = 4 [json_name = "members"];
-}

tombstone/types.proto

@@ -8,19 +8,20 @@ option csharp_namespace = "Neo.FileStorage.API.Tombstone";
 import "refs/types.proto";
 
 // Tombstone keeps record of deleted objects for a few epochs until they are
-// purged from the NeoFS network.
+// purged from the FrostFS network.
 message Tombstone {
-  // Last NeoFS epoch number of the tombstone lifetime. It's set by the tombstone
-  // creator depending on the current NeoFS network settings. A tombstone object
-  // must have the same expiration epoch value in `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated)
+  // Last FrostFS epoch number of the tombstone lifetime. It's set by the
+  // tombstone creator depending on the current FrostFS network settings. A
+  // tombstone object must have the same expiration epoch value in
+  // `__SYSTEM__EXPIRATION_EPOCH` (`__NEOFS__EXPIRATION_EPOCH` is deprecated)
   // attribute. Otherwise, the tombstone will be rejected by a storage node.
-  uint64 expiration_epoch = 1 [json_name = "expirationEpoch"];
+  uint64 expiration_epoch = 1 [ json_name = "expirationEpoch" ];
 
   // 16 byte UUID used to identify the split object hierarchy parts. Must be
   // unique inside a container. All objects participating in the split must
   // have the same `split_id` value.
-  bytes split_id = 2 [json_name = "splitID"];
+  bytes split_id = 2 [ json_name = "splitID" ];
 
   // List of objects to be deleted.
-  repeated neo.fs.v2.refs.ObjectID members = 3 [json_name = "members"];
+  repeated neo.fs.v2.refs.ObjectID members = 3 [ json_name = "members" ];
 }