frostfs-node/CHANGELOG.md
Evgenii Stratonikov 8796807040 [#1936] network/cache: Handle dial errors
After an SDK update `Dial` can return an error.

Signed-off-by: Evgenii Stratonikov <evgeniy@morphbits.ru>
2022-10-24 13:28:53 +03:00

58 KiB

Changelog

Changelog for NeoFS Node

Unreleased

Added

  • --timeout flag in neofs-cli control commands (#1917)
  • Document shard modes of operation (#1909)
  • tree list CLI command (#1332)
  • TreeService.GetTrees RPC (#1902)
  • All trees synchronization on bootstrap (#1902)
  • --force flag to neofs-cli control set-status command (#1916)

Changed

  • Path to a metabase can now be reloaded with a SIGHUP.

Fixed

  • writecache.max_object_size is now correctly handled (#1925)
  • Correctly handle setting ONLINE netmap status after maintenance (#1922)
  • Correctly reset shard errors in ControlService.SetShardMode RPC (#1931)
  • Setting node's network state to MAINTENANCE while network settings forbid it (#1916)
  • Do not panic during API client creation (#1936)

Removed

Updated

  • neo-go to v0.99.4

Updating from v0.33.0

Now storage node serves Control API SetNemapStatus request with MAINTENANCE status only if the mode is allowed in the network settings. To force starting the local maintenance on the node, provide --force flag to the neofs-cli control set-status command.

0.33.0 - 2022-10-17 - Anmado (안마도, 鞍馬島)

Added

  • Serving NetmapService.NetmapSnapshot RPC (#1793)
  • netmap snapshot command of NeoFS CLI (#1793)
  • apiclient.allow_external config flag to fallback to node external addresses (#1817)
  • Support MAINTENANCE state of the storage nodes (#1680, #1681)
  • Changelog updates CI step (#1808)
  • Validate storage node configuration before node startup (#1805)
  • neofs-node -check command to check the configuration file (#1805)
  • flush-cache control service command to flush write-cache (#1806)
  • wallet-address flag in neofs-adm morph refill-gas command (#1820)
  • Validate policy before container creation (#1704)
  • --timeout flag in neofs-cli subcommands (#1837)
  • container nodes command to output list of nodes for container, grouped by replica (#1704)
  • Configuration flag to ignore shard in neofs-node (#1840)
  • Add new RPC TreeService.Healthcheck
  • Fallback to GET if GET_RANGE from one storage nodes to another is denied by basic ACL (#1884)
  • List of shards and logger level runtime reconfiguration (#1770)
  • neofs-adm morph set-config now supports well-known MaintenanceModeAllowed key (#1892)
  • add, get-by-path and add-by-path tree service CLI commands (#1332)
  • Tree synchronisation on startup (#1329)

Changed

  • Allow to evacuate shard data with EvacuateShard control RPC (#1800)
  • Flush write-cache when moving shard to DEGRADED mode (#1825)
  • Make morph.cache_ttl default value equal to morph block time (#1846)
  • Policer marks nodes under maintenance as OK without requests (#1680)
  • Unify help messages in CLI (#1854)
  • evacuate, set-mode and flush-cache control subcommands now accept a list of shard ids (#1867)
  • Reading object commands of NeoFS CLI don't open remote sessions (#1865)
  • Use hex format to print storage node ID (#1765)

Fixed

  • Description of command netmap nodeinfo (#1821)
  • Proper status for object.Delete if session token is missing (#1697)
  • Fail startup if metabase has an old version (#1809)
  • Storage nodes could enter the network with any state (#1796)
  • Missing check of new state value in ControlService.SetNetmapStatus (#1797)
  • Correlation of object session to request (#1420)
  • Do not increase error counter in engine.Inhume if shard is read-only (#1839)
  • control drop-objects can remove split objects (#1830)
  • Node's status in neofs-cli netmap nodeinfo command (#1833)
  • Child check in object assembly process of ObjectService.Get handler (#1878)
  • Shard ID in the object counter metrics (#1863)
  • Metabase migration from the first version (#1860)

Removed

  • Remove WIF and NEP2 support in neofs-cli's --wallet flag (#1128)
  • Remove --generate-key option in neofs-cli container delete (#1692)
  • Serving ControlService.NetmapSnapshot RPC (#1793)
  • control netmap-snapshot command of NeoFS CLI (#1793)

Updated

  • neofs-contract to v0.16.0
  • neofs-api-go to v2.14.0

Updating from v0.32.0

Replace using the control netmap-snapshot command with netmap snapshot one in NeoFS CLI. Node can now specify additional addresses in ExternalAddr attribute. To allow a node to dial other nodes external address, use apiclient.allow_external config setting. Add --force option to skip placement validity check for container creation.

Pass maintenance state to neofs-cli control set-status to enter maintenance mode. If network allows maintenance state (), it will be reflected in the network map. Storage nodes under maintenance are not excluded from the network map, but don't serve object operations. () can be fetched from network configuration via neofs-cli netmap netinfo command.

To allow maintenance mode during neofs-adm deployments, set network.maintenance_mode_allowed parameter in config.

When issuing an object session token for root (virtual, "big") objects, additionally include all members of the split-chain. If session context includes root object only, it is not spread to physical ("small") objects.

neofs-node configuration now supports mode: disabled flag for a shard. This can be used to temporarily ignore shards without completely removing them from the config file.

0.32.0 - 2022-09-14 - Pungdo (풍도, 楓島)

Added

  • Objects counter metric (#1712)
  • meta subcommand to neofs-lens (#1714)
  • Storage node metrics with global and per-shard object counters (#1658)
  • Removal of trees on container removal (#1630)
  • Logging new epoch events on storage node (#1763)
  • Timeout for streaming RPC (#1746)
  • neofs-adm is now able to dump hashes from a custom zone (#1748)
  • Empty filename support in the Tree Service (#1698)
  • Flag to neofs-cli container list-objects command for attribute printing (#1649)

Changed

  • neofs-cli object put's object ID output has changed from "ID" to "OID" (#1296)
  • neofs-cli container set-eacl command now pre-checks container ACL's extensibility (#1652)
  • Access control in Tree service (#1628)
  • Tree service doesn't restrict depth in rpc GetSubTree (#1753)
  • neofs-adm registers contract hashes in both hex and string address formats (#1749)
  • Container list cache synchronization with the Sidechain (#1632)
  • Blobstor components are unified (#1584, #1686, #1523)

Fixed

  • Panic on write-cache's Delete operation (#1664)
  • Payload duplication in neofs-cli storagegroup put (#1706)
  • Contract calls in notary disabled environments (#1743)
  • Blobovnicza.Get op now iterates over all size buckets (#1707)
  • Object expiration time (#1670)
  • Parser of the placement policy (#1775)
  • Tree service timeout logs (#1759)
  • Object flushing on writecache side (#1745)
  • Active blobovniczas caching (#1691)
  • neofs-adm TX waiting (#1738)
  • neofs-adm registers contracts with a minimal GAS payment (#1683)
  • Permissions of the file created by neofs-cli (#1719)
  • neofs-adm creates TX with a high priority attribute (#1702)
  • Storage node's restart after a hard reboot (#1647)

Updated

  • neo-go to v0.99.2
  • nspcc-dev/neofs-contract to v0.15.5
  • prometheus/client_golang to v1.13.0
  • google.golang.org/protobuf to v1.28.1

Updating from v0.31.0

Storage Node now collects object count prometheus metrics: neofs_node_object_counter.

Provide --no-precheck flag to neofs-cli container set-eacl for unconditional sending of a request (previous default behavior).

0.31.0 - 2022-08-04 - Baengnyeongdo (백령도, 白翎島)

Added

  • neofs-adm allows deploying arbitrary contracts (#1629)

Changed

  • Priority order in the Morph client (#1648)

Fixed

  • Losing request context in eACL response checks (#1595)
  • Do not return expired objects that have not been handled by the GC yet (#1634)
  • Setting CID field in neofs-cli acl extended create (#1650)
  • neofs-ir no longer hangs if it cannot bind to the control endpoint (#1643)
  • Do not require lifetime flag in session create CLI command (#1655)
  • Using deprecated gRPC options (#1644)
  • Increasing metabase error counter on disabled pilorama (#1642)
  • Deadlock in the morph client related to synchronous notification handling (#1653)
  • Slow metabase COMMON_PREFIX search for empty prefix (#1656)

Removed

  • Deprecated profiler and metrics configuration sections (#1654)

Updated

  • chzyer/realine to v1.5.1
  • google/uuid to v1.3.0
  • nats-io/nats.go to v1.16.0
  • prometheus/client_golang to v1.12.2
  • spf13/cast to v1.5.0
  • spf13/viper to v1.12.0
  • go.uber.org/zap to v1.21.0
  • google.golang.org/grpc to v1.48.0

Updating from v0.30.0

  1. Change morph.endpoint.client priority values using the following rule: the higher the priority the lower the value (non-specified or 0 values are interpreted as the highest priority -- 1).
  2. Deprecated profiler and metrics configuration sections are dropped, use pprof and prometheus instead.

0.30.2 - 2022-08-01

Added

  • EACL_NOT_FOUND status code support (#1645).

0.30.1 - 2022-07-29

Fixed

  • GetRange operation now works correctly with objects stored in write-cache (#1638)
  • Losing request context in eACL response checks (#1595)
  • Wrong balance contract in innerring processor (#1636)
  • neofs-adm now sets groups in manifest for all contracts properly (#1631)

Updated

  • neo-go to v0.99.1
  • neofs-sdk-go to v1.0.0-rc.6

0.30.0 - 2022-07-22 - Saengildo (생일도, 生日島)

Added

  • Profiler and metrics services now should be enabled with a separate flag
  • Experimental support for the tree-service, disabled by default (#1607)
  • Homomorphic hashes calculation can be disabled across the whole network (#1365)
  • Improve neofs-adm auto-completion (#1594)

Changed

  • Require SG members to be unique (#1490)
  • neofs-cli now doesn't remove container with LOCK objects without --force flag (#1500)
  • LOCK objects are now required to have an expiration epoch (#1461)
  • morph sections in IR and storage node configuration now accept an address and a priority of an endpoint (#1609)
  • Morph client now retries connecting to the failed endpoint too (#1609)
  • Redirecting GET and GETRANGE requests now does not store full object copy in memory (#1605)
  • neofs-adm now registers candidates during initialization in a single transaction (#1608)

Fixed

  • Invalid smart contract address in balance contract listener (#1636)

  • Shard now can start in degraded mode if the metabase is unavailable (#1559)

  • Shard can now be disabled completely on init failure (#1559)

  • Storage group members are now required to be unique (#1490)

  • Print shard ID in component logs (#1611)

Updated

  • neofs-contract to v0.15.3
  • neo-go to the pre-release version
  • github.com/spf13/cobra to v1.5.0

Updating from v0.29.0

  1. Change morph endpoints from simple string to a pair of address and priority. The second can be omitted. For inner ring node this resides in morph.endpoint.client section, for storage node -- in morph.rpc_endpoint section. See config/example for an example.

  2. Move storage.default section to storage.shard.default.

  3. Rename metrics and profiler sections to prometheus and pprof respectively, though old versions are supported. In addition, these sections must now be explicitly enabled with enabled: true flag.

0.29.0 - 2022-07-07 - Yeonpyeongdo (연평도, 延坪島)

Support WalletConnect signature scheme.

Added

  • Retrieve passwords for storage wallets from the configuration in neofs-adm (#1539)
  • Metabase format versioning (#1483)
  • neofs-adm generates wallets in a pretty JSON format
  • Makefile supports building from sources without a git repo

Fixed

  • Do not replicate object twice to the same node (#1410)
  • Concurrent object handling by the Policer (#1411)
  • Attaching API version to the forwarded requests (#1581)
  • Node OOM panics on GetRange request with extremely huge range length (#1590)

Updated

  • neofs-sdk-go to latest pre-release version
  • tzhash to v1.6.1

0.28.3 - 2022-06-08

Updated

  • Neo-go 0.98.3 => 0.99.0 (#1480)

Changed

  • Replace pointers with raw structures in results for local storage (#1460)
  • Move common CLI's functions in a separate package (#1452)

Fixed

  • Confirmation of eACL tables by alphabet nodes when ACL extensibility is disabled (#1485)
  • Do not use WS neo-go client in neofs-adm (#1378)
  • Log more detailed network errors by the Alphabet (#1487)
  • Fix container verification by the Alphabet (#1464)
  • Include alphabet contracts to the base group in neofs-adm (#1489)

0.28.2 - 2022-06-03

Updated

  • Neo-go 0.98.2 => 0.98.3 (#1430)
  • NeoFS SDK v1.0.0-rc.3 => v1.0.0-rc.4
  • NeoFS API v2.12.1 => v2.12.2
  • NeoFS Contracts v0.14.2 => v0.15.1

Added

  • Config examples for Inner ring application (#1358)
  • Command for documentation generation for neofs-cli, neofs-adm and neofs-lens (#1396)

Fixed

  • Do not ask for contract wallet password twice (#1346)
  • Do not update NNS group if the key is the same (#1375)
  • Make LOCODE messages more descriptive (#1394)
  • Basic income transfer's incorrect log message (#1374)
  • Listen to subnet removal events in notary-enabled env (#1224)
  • Update/remove nodes whose subnet has been removed (#1162)
  • Potential removal of local object when policy isn't complied (#1335)
  • Metabase Select is now slightly faster (#1433)
  • Fix a number of bugs in writecache (#1462)
  • Refactor eACL processing and fix bugs (#1471)
  • Do not validate subnet removal by IR (#1441)
  • Replace pointers with raw structures in parameters for local storage (#1418)

Removed

  • Remove num and shard_num parameters from the configuration (#1474)

0.28.1 - 2022-05-05

Fixed

  • Loss of the connection scheme during address parsing in NeoFS CLI (#1351)

0.28.0 - 2022-04-29 - Heuksando (흑산도, 黑山島)

Added

  • morph dump-balances command to NeoFS Adm (#1308)
  • Ability to provide session token from file in NeoFS CLI (#1216)

Fixed

  • Panic in netmap netinfo command of NeoFS CLI (#1312)
  • Container cache invalidation on DELETE op (#1313)
  • Subscription to side-chain events in shards (#1321)
  • Trusted object creation without session token (#1283)
  • Storing invalid objects during trusted PUT op (#1286)
  • RAM overhead when writing objects to local storage (#1343)

Changed

  • NeoFS Adm output from stderr to stdout (#1311)
  • Node's object GC mechanism (#1318)

Updating from v0.28.0-rc.3

Clean up all metabases and re-sync them using resync_metabase config flag.

0.28.0-rc.3 - 2022-04-08

Fixed

  • Check expiration epoch of provided session token (#1168)
  • Prevent corruption in writecache.Head (#1149)
  • Use separate caches in N3 RPC multi client (#1213)
  • neofs-adm fixes (#1288, #1294, #1295)
  • Don't stop notification listener twice (#1291)
  • Metabase panic (#1293)
  • Disallow to tick block timer twice on the same height (#1208)

Added

  • Persistent storage for session tokens (#1189)
  • Cache for Inner Ring list fetcher (#1278)
  • Degraded mode of storage engine (#1143)
  • Command to change native Policy contract in neofs-adm (#1289)
  • Single websocket endpoint pool for RPC and notifications (#1053)

Changed

  • Cache NeoFS clients based only on public key (#1157)
  • Make blobovnicza.Put idempotent (#1262)
  • Optimize metabase list operations (#1262)
  • PDP check ranges are now asked in random order (#1163)
  • Update go version up to v1.17 (#1250)

Removed

  • Reduced amount of slices with pointers (#1239)

Updating from v0.28.0-rc.2

Remove NEOFS_IR_MAINNET_ENDPOINT_NOTIFICATION, NEOFS_IR_MORPH_ENDPOINT_NOTIFICATION, and NEOFS_MORPH_NOTIFICATION_ENDPOINT from Inner Ring and Storage configurations.

Specify WebSocket endpoints in NEOFS_IR_MAINNET_ENDPOINT_CLIENT, NEOFS_IR_MORPH_ENDPOINT_CLIENT, and NEOFS_MORPH_RPC_ENDPOINT at Inner Ring and Storage configurations.

Specify path to persistent session token db in Storage configuration with NEOFS_NODE_PERSISTENT_SESSIONS_PATH.

0.28.0-rc.2 - 2022-03-24

Fixed

  • Respect format flags for SplitInfo output (#1233)
  • Output errors in neofs-cli to stderr where possible (#1259)

Added

  • Print details for AccessDenied errors in neofs-cli (#1252)
  • Split client creation into 2 stages (#1244)
  • Update morph client to work with v0.15.0 (#1253)

0.28.0-rc.1 - 2022-03-18

Native RFC-6979 signatures of messages and tokens, LOCK object types, experimental notifications over NATS with NeoFS API v2.12 support

Fixed

  • Remove session tokens from local storage of storage node after expiration (#1133)
  • Readme typos (#1167)
  • LOCODE attribute and announced address are not mandatory for relay node config (#1114)
  • Check session token verb (#1191)
  • Fix data race leading to reputation data loss (#1210)

Added

  • Look for CustomGroup scope in NNS contract before contract invocation (#749)
  • Cache of notary transaction heights (#1151)
  • NATS notifications (#1183)
  • LOCK object type (#1175, #1176, #1181)
  • Progress bar for object upload/download in neofs-cli (#1185)
  • Support of new status codes (#1247)

Changed

  • Update neofs-api-go and neofs-sdk-go (#1101, #1131, #1195, #1209, #1231)
  • Use path/filepath package for OS path management (#1132)
  • Shard sets mode to read-only if it hits threshold limit (#1118)
  • Use request timeout in chain client of neofs-adm (#1115)
  • Generate wallets with 0644 permissions in neofs-adm (#1115)
  • Use cache of parsed addresses in GC (#1115)
  • Determine config type based on file extension in neofs-ir (#1115)
  • Reuse some error defined in contracts (#1115)
  • Improved neofs-cli usability (#1103)
  • Refactor v2 / SDK packages in eACL (#596)

Removed

  • Remove some wrappers from morph package (#625)
  • GetRange method in blobovnicza (#1115)
  • Deprecated structures from SDK v1.0.0 rc (#1181)

Updating from neofs-node v0.27.5

Set shard error threshold for read-only mode switch with NEOFS_STORAGE_SHARD_RO_ERROR_THRESHOLD (default: 0, deactivated).

Set NATS configuration for notifications in NEOFS_NODE_NOTIFICATION section. See example config for more details.

0.27.7 - 2022-03-30

Fixed

  • Shard ID is now consistent between restarts (#1204)

Added

  • More N3 RPC caches in object service (#1278)

0.27.6 - 2022-03-28

Fixed

  • Allow empty passwords in neofs-cli config (#1136)
  • Set correct audit range hash type in neofs-ir (#1180)
  • Read objects directly from blobstor in case of shard inconsistency (#1186)
  • Fix -w flag in subnet commands of neofs-adm (#1223)
  • Do not use explicit mutex lock in chain caches (#1236)
  • Force gRPC server stop if it can't shut down gracefully in storage node (#1270)
  • Return non-zero exit code in acl extended create command failures and fix help message (#1259)

Added

  • Interactive storage node configurator in neofs-adm (#1090)
  • Logs in metabase operations (#1188)

0.27.5 - 2022-01-31

Fixed

  • Flush small objects when persist write cache (#1088)
  • Empty response body in object.Search request (#1098)
  • Inner ring correctly checks session token in container.SetEACL request (#1110)
  • Printing in verbose mode in CLI (#1120)
  • Subnet removal event processing (#1123)

Added

  • Password support in CLI config (#1103)
  • Shard dump restore commands in CLI (#1085, #1086)
  • acl extended create command in CLI (#1092)

Changed

  • Adopt new owner.ID API from SDK (#1100)
  • Use go install instead of go get in Makefile (#1102)
  • Storage node returns Fixed12 decimal on accounting.Balance request. CLI prints Fixed8 rounded value by default. (#1084)
  • Support new update interface for NNS contract in NeoFS Adm (#1091)
  • Rename use_write_cache to writecache.enabled in stoarge config (#1117)
  • Preallocate slice in headersFromObject (#1115)
  • Unify collection of expired objects (#1115)
  • Calculate blobovnicza size at initialization properly (#1115)
  • Process fast search filters outside bbolt transaction (#1115)
  • Update TZHash library to v1.5.1

Removed

  • --wif and --binary-key keys from CLI (#1083)
  • Extended ACL validator moved to SDK library (#1096)
  • --generate-key flag in CLI control commands (#1103)
  • Various unused code (#1123)

Upgrading from v0.27.4

Use --wallet key in CLI to provide WIF or binary key file instead of --wif and --binary-key.

Replace NEOFS_STORAGE_SHARD_N_USE_WRITE_CACHE with NEOFS_STORAGE_SHARD_N_WRITECACHE_ENABLED in Storage node config.

Specify password: xxx in config file for NeoFS CLI to avoid password input.

0.27.4 - 2022-01-13

Fixed

  • ACL check did not produce status code (#1062)
  • Asset transfer wrapper used incorrect receiver (#1069)
  • Empty search response missed meta header and body (#1063)
  • IR node in single chain environment used incorrect source of IR list (#1025)
  • Incorrect message sequence in object.Range request (#1077)

Added

  • Option to disable compression of object based on their content-type attribute (#1060)

Changed

  • Factor out autocomplete command in CLI and Adm (#1041)
  • Single crypto rand source (#851)

Upgrading from v0.27.3

To disable compression for object with specific content-types, specify them as a string array in blobstor section: NEOFS_STORAGE_SHARD_N_BLOBSTOR_COMPRESSION_EXCLUDE_CONTENT_TYPES. Use asterisk as wildcard, e.g. video/*.

0.27.3 - 2021-12-30

Added

  • SetShardMode RPC in control API, available in CLI (#1044)
  • Support of basic ACL constants without final flag in CLI (#1066)

Changed

  • neofs-adm updates contracts in single tx (#1035)
  • Proxy contract arguments for deployment in neofs-adm (#1056)

0.27.2 - 2021-12-28

Fixed

Added

  • ListShards RPC in control API, available in CLI (#1043)
  • Epoch metric in Storage and Inner Ring applications (#1054)

Changed

  • Some object replication related logs were moved to DEBUG level (#1052)

0.27.1 - 2021-12-20

Fixed

  • Big objects now flushed from WriteCache after write (#1028)
  • WriteCache big object counter (#1022)
  • Panic in the container estimation routing (#1016)
  • Shutdown freeze in policer component (#1047)

Added

  • Shorthand -g for --generate-key in NeoFS CLI (#1034)
  • Autocomplete generator command for neofs-adm (#1013)
  • Max connection per host config value for neo-go client (#780)
  • Sanity check of session token context in container service (#1045)

Changed

  • CLI now checks NeoFS status code for exit code (#1039)
  • New Update method signature for NNS contract in neofs-adm (#1038)

0.27.0 - 2021-12-09 - Sinjido (신지도, 薪智島)

NeoFS API v2.11.0 support with response status codes and storage subnetworks.

Fixed

  • CLI now opens LOCODE database in read-only mode for listing command (#958)
  • Tombstone owner now is always set (#842)
  • Node in relay mode does not require shard config anymore (#969)
  • Alphabet nodes now ignore notary notifications with non-HALT main tx (#976)
  • neofs-adm now prints version of NNS contract (#1014)
  • Possible NPE in blobovnicza (#1007)
  • More precise calculation of blobovnicza size (#915)

Added

  • Maintenance mode for Storage node (#922)
  • Float values in Storage node config (#903)
  • Status codes for NeoFS API Response messages (#961)
  • Subnetwork support (#977, #973, #983, #974, #982, #979, #998, #995, #1001, #1004)
  • Customized fee for named container registration (#1008)

Changed

  • Alphabet contract number is not mandatory (#880)
  • Alphabet nodes resign AddPeer request if it updates Storage node info (#938)
  • All applications now use client from neofs-sdk-go library (#966)
  • Some shard configuration records were renamed, see upgrading section (#859)
  • Nonce and VUB values of notary transactions generated from notification hash (#844)
  • Non alphabet notary invocations now have 4 witnesses (#975)
  • Object replication is now async and continuous (#965)
  • NeoFS ADM updated for the neofs-contract v0.13.0 deploy (#984)
  • Minimal TLS version is set to v1.2 (#878)
  • Alphabet nodes now invoke netmap.Register to add node to the network map candidates in notary enabled environment (#1008)

Upgrading from v0.26.1

NEOFS_IR_CONTRACTS_ALPHABET_AMOUNT is not mandatory env anymore. If it is not set, Inner Ring would try to read maximum from config and NNS contract. However, that parameter still can be set in order to require the exact number of contracts.

Shard configuration records were renamed:

  • refill_metabase -> resync_metabase
  • writecache.max_size -> writecache.max_object_size
  • writecache.mem_size -> writecache.memcache_capacity
  • writecache.size_limit -> writecache_capcity
  • blobstor.blobovnicza.opened_cache_size -> blobstor.blobovnicza.opened_cache_capacity
  • *.shallow_depth -> *.depth
  • *.shallow_width -> *.width
  • *.small_size_limit -> *.small_object_size

Specify storage subnetworks in NEOFS_NODE_SUBNET_ENTRIES as the list of integer numbers. To exit default subnet, use NEOFS_NODE_SUBNET_EXIT_ZERO=true

Specify fee for named container registration in notary disabled environment with NEOFS_IR_FEE_NAMED_CONTAINER_REGISTER.

0.26.1 - 2021-11-02

Fixed

  • Storage Node handles requests before its initialization is finished (#934)
  • Release worker pools gracefully (#901)
  • Metabase ignored containers of storage group and tombstone objects in listing (#945)
  • CLI missed endpoint flag in control netmap-snapshot command (#942)
  • Write cache object persisting (#866)

Added

  • Quote symbol support in .env example tests (#935)
  • FSTree object counter (#821)
  • neofs-adm prints contract version in dump-hashes command (#940)
  • Default values section in shard configuration (#877)
  • neofs-adm downloads contracts directly from GitHub (#733)

Changed

  • Use FSTree counter in write cache (#821)
  • Calculate notary deposit till parameter depending on available deposit (#910)
  • Storage node returns session token error if attached token's private key is not available (#943)
  • Refactor of NeoFS API client in inner ring (#946)
  • LOCODE generator tries to find the closest continent if there are no exact match (#955)

Upgrading from v0.26.0

You can specify default section in storage engine configuration. See example for more details.

0.26.0 - 2021-10-19 - Udo (우도, 牛島)

NeoFS API v2.10 support

Fixed

  • Check remote node public key in every response message (#645)
  • Do not lose local container size estimations (#872)
  • Compressed and uncompressed objects are always available for reading regardless of compression configuration (#868)
  • Use request session token in ACL check of object.Put (#881)
  • Parse URI in neofs-cli properly (#883)
  • Parse minutes in LOCODE DB properly (#902)
  • Remove expired tombstones (#884)
  • Close all opened blobovniczas properly (#896)
  • Do not accept objects with empty OwnerID field (#841)

Added

  • More logs in governance and policer components (#867, #882)
  • Contract address getter in static blockchain clients (#627)
  • Alphabet configuration option to disable governance sync (#869)
  • neofs-lens app implementation (#791)
  • Detailed comments in neofs-node config example (#858)
  • Size suffixes support in neofs-node config (#857)
  • Docs for neofs-adm (#906)
  • Side chain block size duration and global NeoFS configuration in NetworkConfig response (#833)
  • Support native container names (#889)

Changed

  • Updated grpc to v1.41.0 (#860)
  • Updated neo-go to v0.97.3 (#833)
  • Updated neofs-api-go to v1.30.0
  • Adopt neofs-adm for new contracts release (#835, #888)
  • Adopt neofs-node for new contracts release (#905)
  • SN and IR notary deposits are made dynamically depending on the Notary and GAS balances (#771)
  • VMagent port in testnet config is now 443 (#908)
  • Use per-shard worker pools for object.Put operations (#674)
  • Renamed --rpc-endpoint CLI flag for control command to --endpoint (#879)

Removed

  • Global flags in CLI. Deleted useless flags from accounting balance command (#810).
  • Interactive mode in docker run command (#916)

Upgrading from v0.25.1

Deleted NEOFS_IR_NOTARY_SIDE_DEPOSIT_AMOUNT, NEOFS_IR_NOTARY_MAIN_DEPOSIT_AMOUNT and NEOFS_IR_TIMERS_SIDE_NOTARY, NEOFS_IR_TIMERS_MAIN_NOTARY Inner Ring envs. Deleted NEOFS_MORPH_NOTARY_DEPOSIT_AMOUNT and NEOFS_MORPH_NOTARY_DEPOSIT_DURATION Storage Node envs. control CLI command does not have --rpc-endpoint/r flag, use endpoint instead.

0.25.1 - 2021-09-29

Fixed

  • Panic caused by missing Neo RPC endpoints in storage node's config (#863)

Added

  • Support of multiple Neo RPC endpoints in Inner Ring node (#792)

mainchain section of storage node config is left unused by the application.

0.25.0 - 2021-09-27 - Mungapdo (문갑도, 文甲島)

Fixed

  • Work of a storage node with one Neo RPC endpoint instead of a list (#746)
  • Lack of support for HEAD operation on the object write cache (#762)
  • Storage node attribute parsing is stable now (#787)
  • Inner Ring node now logs transaction hashes of Deposit and Withdraw events in LittleEndian encoding (#794)
  • Storage node uses public keys of the remote nodes in placement traverser checks (#645)
  • Extended ACL Target check of role and public keys is mutual exclusive now (#816)
  • neofs-adm supports update and deploy of neofs-contract v0.11.0 (#834, #836)
  • Possible NPE in public key conversion (#848)
  • Object assembly routine do not forward existing request instead of creating new one (#839)
  • Shard now returns only physical stored objects for replication (#840)

Added

  • Support events from P2P notary pool
  • Smart contract address auto negotiation with NNS contract (#736)
  • Detailed logs for all data writing operations in storage engine (#790)
  • Docker build and release targets in Makefile (#785)
  • Metabase restore option in the shard config (#789)
  • Write cache used size limit in bytes (#776)

Changed

  • Reduce container creation delay via listening P2P notary pool (#519)
  • Extended ACL table is not limited to 1KiB (#731)
  • Netmap side chain client wrapper now has TryNotary option (#793)
  • Sticky bit is ignored in requests with SYSTEM role (#818)
  • Incomplete object put error now contains last RPC error (#778)
  • Container service invalidates container cache on writing operations (#803)
  • Improved write cache size counters (#776)
  • Metabase returns NotFound error instead of AlreadyRemoved on GCMarked objects (#840)
  • Object service uses two routine pools for remote and local GET requests (#845)

Removed

  • Dockerfile for AllInOne image moved to a separate repository (#796)

Upgrading from v0.24.1

Added NEOFS_CONTRACTS_PROXY env for Storage Node; mandatory in notary enabled environments only. It should contain proxy contract's scripthash in side chain.

Added NEOFS_MORPH_NOTARY_DEPOSIT_AMOUNT and NEOFS_MORPH_NOTARY_DEPOSIT_DURATION envs for Storage Node, that have default values, not required. They should contain notary deposit amount and frequency(in blocks) respectively.

All side chain contract address config values are optional. If side chain contract address is not specified, then value gathered from NNS contract.

Added NEOFS_STORAGE_SHARD_<N>_WRITECACHE_SIZE_LIMIT where <N> is shard ID. This is the size limit for the all write cache storages combined in bytes. Default size limit is 1 GiB.

Added NEOFS_STORAGE_SHARD_<N>_REFILL_METABASE bool flag where <N> is shard ID. This flag purges metabase instance at the application start and reinitialize it with available objects from the blobstor.

Object service pool size now split into NEOFS_OBJECT_PUT_POOL_SIZE_REMOTE and NEOFS_OBJECT_PUT_POOL_SIZE_LOCAL configuration records.

0.24.1 - 2021-09-07

Fixed

  • Storage and Inner Ring will not start until Neo RPC node will have the height of the latest processed block by the nodes (#795)

Upgrading from v0.24.0

Specify path to the local state DB in Inner Ring node config with NEOFS_IR_NODE_PERSISTENT_STATE_PATH. Specify path to the local state DB in Storage node config with NEOFS_NODE_PERSISTENT_STATE_PATH.

0.24.0 - 2021-08-30 Anmyeondo (안면도, 安眠島)

Fixed

  • Linter warning messages (#766)
  • Storage Node does not register itself in network in relay mode now (#761)

Changed

  • neofs-adm fails when is called in a notary-disabled environment (#757)
  • neofs-adm uses neo-go client's native NNS resolving method instead of the custom one (#756)
  • Node selects pseudo-random list of objects from metabase for replication (#715)

Added

  • Contract update support in neofs-adm utility (#748)
  • Container transferring support in neofs-adm utility (#755)
  • Storage Node's balance refilling support in neofs-adm utility (#758)
  • Support COMMON_PREFIX filter for object attributes in storage engine and neofs-cli (#760)
  • Node's and IR's notary status debug message on startup (#758)
  • Go 1.17 unit tests in CI (#766)
  • Supporting all eACL filter fields from the specification (#768)
  • Cache for Container service's read operations (#676)

Updated

  • neofs-api-go library to v1.29.0

Removed

  • Unused DB_SIZE parameter of writecache (#773)

Upgrading from v0.23.1

Storage Node does not read unused NEOFS_STORAGE_SHARD_XXX_WRITECACHE_DB_SIZE config parameter anymore.

0.23.1 - 2021-08-06

N3 Mainnet launch release with minor fixes.

Added

  • Initial version of neofs-adm tool for fast side chain deployment and management in private installations
  • Notary support auto negotiation (#709)
  • Option to disable side chain cache in Storage node (#704)
  • Escape symbols in Storage node attributes (#700)

Changed

  • Updated neo-go to v0.97.1
  • Updated multiaddr lib to v0.4.0 with native TLS protocol support (#661)
  • Default file permission in storage engine is 660 (#646)

Fixed

  • Container size estimation routine now aggregates values by cid-epoch tuple (#723)
  • Storage engine always creates executable dirs (#646)
  • GC routines in storage engine shards shutdown gracefully (#745)
  • Handle context shutdown at NeoFS multi client group address switching (#737)
  • Scope for main chain invocations from Inner Ring nodes (#751)

Upgrading from v0.23.0

Added NEOFS_MORPH_DISABLE_CACHE env. If true, none of the eACL/netmap/container RPC responses cached.

Remove WITHOUT_NOTARY and WITHOUT_MAIN_NOTARY records from Inner Ring node config. Notary support is now auto negotiated.

0.23.0 - 2021-07-23 - Wando (완도, 莞島)

Improved stability for notary disabled environment.

Added

  • Alphabet wallets generation command in neofs-adm (#684)
  • Initial epoch timer tick synchronization at Inner Ring node startup (#679)

Changed

  • --address flag is optional in NeoFS CLI (#656)
  • Notary subsystem now logs ValidUntilBlock (#677)
  • Updated neo-go to v0.96.1
  • Storage Node configuration example contains usable parameters (#699)

Fixed

  • Do not use side chain RoleManagement contract as source of Inner Ring list when notary disabled in side chain (#672)
  • Alphabet list transition is even more effective (#697)
  • Inner Ring node does not require proxy and processing contracts if notary disabled (#701, #714)

Upgrading from v0.22.3

To upgrade Storage node or Inner Ring node from v0.22.3, you don't need to change configuration files. Make sure, that NEO RPC nodes, specified in config, are connected to N3 RC4 (Testnet) network.

0.22.3 - 2021-07-13

Added

  • Support binary eACL format in container CLI command (#650).
  • Dockerfile for neofs-adm utility (#680).

Changed

  • All docker files moved to .docker dir (#682).

Fixed

  • Do not require MainNet attributes in "Without MainNet" mode (#663).
  • Stable alphabet list merge in Inner Ring governance (#670).
  • User can specify only wallet section without node key (#690).
  • Log keys in hex format in reputation errors (#693).
  • Connections leak and reduced amount of connection overall (#692).

Removed

  • Debug output of public key in Inner Ring log (#689).

0.22.2 - 2021-07-07

Updated broken version of NeoFS API Go.

Updated

0.22.1 - 2021-07-07

Added

  • GetCandidates method to morph client wrapper (#647).
  • All-in-One Docker image that contains all NeoFS related binaries (#662).
  • --version flag to Storage Node binary (#664).

Changed

  • Do not check NeoFS version in LocalNodeInfo requests and Put container operations; v2.7.0 is genesis version of NeoFS (#660).
  • All error calls of CLI return 1 exit code (#657).

Fixed

  • Do not use multisignature for audit operations (#658).
  • Skip audit for containers without Storage Groups (#659).

Updated

0.22.0 - 2021-06-29 - Muuido (무의도, 舞衣島)

Storage nodes with a group of network endpoints.

Added

  • Support of Neo wallet credentials in CLI (#610).
  • More reliable approval of trust value by IR (#500).
  • Storage node's ability to announce and serve on multiple network addresses (#607).
  • Validation of network addresses of netmap candidates in IR (#557).
  • Control service with healthcheck RPC in IR and CLI support (#414).

Fixed

  • Approval of objects with with duplicate attribute keys or empty values (#633).
  • Approval of containers with with duplicate attribute keys or empty values (#634).
  • Default path for CLI config (#626).

Changed

  • version command replaced with --version flag in CLI (#571).
  • Command usage text is not printed on errors in CLI (#623).
  • netmap snapshot command replaced with control netmap-snapshot one in CLI (#651).
  • IR does not include nodes with LOCODE derived attributes to the network map (#412).
  • IR uses morph/client packages for contract invocations (#496).
  • Writecache decreases local size when objects are flushed (#568).
  • IR can override global configuration values only in debug build (#363).

Updated

0.21.1 - 2021-06-10

Fixed

  • Session token lifetime check (#589).
  • Payload size check on the relayed objects (#580).

Added

  • VMagent to collect metrics from testnet storage image

Changed

  • Updated neofs-api-go to v1.27.1 release.

0.21.0 - 2021-06-03 - Seongmodo (석모도, 席毛島)

Session token support in container service, refactored config in storage node, TLS support on gRPC servers.

Fixed

  • ACL service traverses over all RequestMetaHeader chain to find bearer and session tokens (#548).
  • Object service correctly resends complete objects without attached session token (#501).
  • Inner ring processes neofs.Bind and neofs.Unbind notifications (#556).
  • Client cache now gracefully closes all available connections (#567).

Added

  • Session token support in container service for container.Put, container.Delete and container.SetEACL operations.
  • Session token support in container and sign command of NeoFS CLI.
  • TLS encryption support of gRPC service in storage node.

Changed

  • Inner ring listens RoleManagement contract notifications to start governance update earlier.
  • Inner ring processes extended ACL changes.
  • Inner ring makes signature checks of containers and extended ACLs.
  • Refactored config of storage node.
  • Static clients from morph/client do not process notary invocations explicitly anymore. Now notary support specified at static client creation.
  • Updated neo-go to v0.95.1 release.
  • Updated neofs-api-go to v1.27.0 release.

Removed

  • Container policy parser moved to neofs-sdk-go repository.
  • Invoke package from inner ring.

0.20.0 - 2021-05-21 - Dolsando (돌산도, 突山島)

NeoFS is N3 RC2 compatible.

Fixed

  • Calculations in EigenTrust algorithm (#527).
  • NPE at object service request forwarding (#532, #543, #544).
  • FSTree iterations in blobstor (#541).
  • Inhume operation in storage engine (#546).

Added

  • Optional endpoint to main chain in storage app.
  • Client for NeoFSID contract.

Changed

  • Reorganized and removed plenty of application configuration records (#510, #511, #512, #514).
  • Nodes do not resolve remote addresses manually.
  • Presets for basic ACL in CLI are private ,public-read and public-read-write now.
  • Updated neo-go to v0.95.0 release.
  • Updated neofs-api-go to v1.26.1 release.
  • Updated go-multiaddr to v0.3.1 release.

Removed

  • Unused external GC workers (GC is part of the shard in storage engine now).
  • Unused worker pools for object service in storage app.
  • pkg/errors dependency (stdlib errors used instead).

0.19.0 - 2021-05-07 - Daecheongdo (대청도, 大靑島)

Storage nodes exchange, calculate, aggregate and store reputation information in reputation contract. Inner ring nodes support workflows with and without notary subsystem in chains.

Fixed

  • Build with go1.16.
  • Notary deposits last more blocks.
  • TX hashes now prints in little endian in logs.
  • Metabase deletes graves regardless of the presence of objects.
  • SplitInfo error created from all shards instead of first matched shard.
  • Possible deadlock at cache eviction in blobovnicza.
  • Storage node does not send rebootstrap messages after it went offline.

Added

  • Reputation subsystem that includes reputation collection, exchange, calculation and storage components.
  • Notary and non notary workflows in inner ring.
  • Audit fee transfer for inner ring nodes that performed audit.
  • Unified encoding for all side chain payment details.
  • New write cache implementation for storage engine.
  • NEP-2 and NEP-6 key formats in CLI.

Changed

  • Metabase puts data in batches.
  • Network related new epoch handlers in storage node executed asynchronously.
  • Storage node gets epoch duration from global config.
  • Storage node resign and resend Search, Range, Head, Get requests of object service without modification.
  • Inner ring does not sync side chain validators in single chain deployment.
  • neo-go updated to v0.94.1
  • neofs-api-go updated to v1.26.0

0.18.0 - 2021-03-26 - Yeongheungdo (영흥도, 靈興島)

NeoFS operates with updated governance model. Alphabet keys and inner ring keys are accessed from side chain committee and RoleManagement contract. Each epoch alphabet keys are synchronized with main chain.

Fixed

  • Metabase does not store object payloads anymore.
  • TTLNetCache now always evict data after a timeout.
  • NeoFS CLI keyer could misinterpret hex value as base58.

Added

  • Local trust controller in storage node.
  • Governance processor in inner ring that synchronizes list of alphabet keys.

Changed

  • Inner ring keys and alphabet keys are managed separately by inner ring and gathered from committee and RoleManagement contract.

0.17.0 - 2021-03-22 - Jebudo (제부도, 濟扶島)

Notary contract support, updated neofs-api-go with raw client, some performance tweaks with extra caches and enhanced metrics.

Added

  • Notary contract support.
  • Cache for morph client.
  • Metrics for object service and storage engine.
  • Makefile target for fast and dirty docker images.
  • GAS threshold value in inner ring GAS transfers.

Changed

  • RPC client cache now re-used per address instead of (address+key) tuple.
  • Updated neofs-api-go version to v1.25.0 with raw client support.
  • Updated neo-go to testnet compatible v0.94.0 version.

0.16.0 - 2021-02-26 - Ganghwado (강화도, 江華島)

Garbage collector is now running inside storage engine. It is accessed via Control API, from policer component and through object expiration scrubbers.

Inner ring configuration now supports single chain mode with any number of alphabet contracts.

Storage node now supports NetworkInfo method in netmap service.

Fixed

  • Storage engine now inhumes object only in single shard.
  • Metabase correctly removes parent data at batched children delete.
  • Metabase does not accept tombstone on tombstone records in graveyard anymore.
  • Object service now rejects expired objects.
  • CLI now correctly attaches bearer token in storage group operations.
  • Container policy parser now works with strings in filter key.
  • Policer component now removes redundant objects locally.

Added

  • GC job that monitors expired objects.
  • GC job that removes marked objects from physical storage.
  • Batch inhume operations in metabase, shard and engine.
  • control.DropObjects RPC method.
  • Support of netmap.NetworkInfo RPC method.
  • Single chain inner ring configuration.

Changed

  • UN-LOCODE node attribute now optional.
  • engine.Delete method now marks object to be removed by GC.
  • Inner ring node supports any number of alphabet contracts from 1 up to 40.

0.15.0 - 2021-02-12 - Seonyudo (선유도, 仙遊島)

NeoFS nodes are now preview5-compatible.

IR nodes are now engaged in the distribution of funds to the storage nodes: for the passed audit and for the amount of stored information. All timers of the IR nodes related to the generation and processing of global system events are decoupled from astronomical time, and are measured in the number of blockchain blocks.

For the geographic positioning of storage nodes, a global NeoFS location database is now used, the key in which is a UN/LOCODE, and the base itself is generated on the basis of the UN/LOCODE and OpenFlights databases.

Added

  • Timers with time in blocks of the chain.
  • Subscriptions to new blocks in blockchain event Listener.
  • Tracking the volume of stored information by containers in the storage engine and an external interface for obtaining this data.
  • TransferX operation in sidechain client.
  • Calculators of audit and basic settlements.
  • Distribution of funds to storage nodes for audit and for the amount of stored information (settlement processors of IR).
  • NeoFS API Container.AnnounceUsedSpace RPC service.
  • Exchange of information about container volumes between storage nodes controlled by IR through sidechain notifications.
  • Support of new search matchers (STRING_NOT_EQUAL, NOT_PRESENT).
  • Functional for the formation of NeoFS location database.
  • CLI commands for generating and reading the location database.
  • Checking the locode attribute and generating geographic attributes for candidates for a network map on IR side.
  • Verification of the eACL signature when checking Object ACL rules.

Fixed

  • Overwriting the local configuration of node attributes when updating the network map.
  • Ignoring the X-headers CLI storagegroup commands.
  • Inability to attach bearer token in CLI storagegroup commands.

Changed

  • Units of epoch and emit IR intervals.
  • Query language in CLI object search command.

Updated

  • neo-go v0.93.0.
  • neofs-api-go v1.23.0.

0.14.3 - 2021-01-27

Fixed

  • Upload of objects bigger than single gRPC message.
  • Inconsistent placement issues (#347, #349).
  • Bug when ACL request classifier failed to classify RoleOthers in first epoch.

Added

  • Debug section in readme file for testnet configuration.

Changed

  • Docker images now based on alpine and contain shell.
  • Node bootstraps with active state in node info structure.

0.14.2 - 2021-01-20

Testnet4 related bugfixes.

Fixed

  • Default values for blobovnicza object size limit and blobstor small object size are not zero.
  • Various storage engine log messages.
  • Bug when inner ring node ignored bootstrap messages from restarted storage nodes.

Added

  • Timeout for reading boltDB files at storage node initialization.

Changed

  • Increased default extra GAS fee for contract invocations at inner ring.

0.14.1 - 2021-01-15

Fixed

  • Inner ring node could not confirm netmap.updateState notification.
  • object.RangeHash method ignored salt values.

Added

  • Control API service for storage node with health check, netmap and node state relate methods.
  • Object service now looks to previous epoch containers.
  • Possibility to configure up multiple NEO RPC endpoints in storage node.

Changed

  • Storage node shuts down if event producer RPC node is down.

0.14.0 - 2020-12-30 - Yeouido (여의도, 汝矣島)

Preview4 compatible NeoFS nodes with data audit.

Added

  • Data audit routines in inner ring nodes.
  • Storage group operations in CLI (neofs-cli storagegroup --help).

Fixed

  • Loss of request X-headers during the forwarding in Object service.

Changed

  • Updated neo-go version for preview4 compatibility.

Updated

  • neo-go v0.92.0.
  • neofs-api-go v1.22.0.

0.13.2 - 2020-12-24

Support changes from neofs-api-go v1.21.2 release.

Added

  • Support of request X-Headers in CLI commands.

Changed

  • Use updated API of container library.

0.13.1 - 2020-12-18

Fixes based on Modo release testing results.

Added

  • Verification of chain element addresses during object assembling.

Changed

  • Processing of filters by non-address fields in Object Range/RangeHash/Delete.

Fixed

  • Graveyard and ToMoveIt bucket names in metabase.
  • Double formation of the parent title when transforming an object.
  • Loss of session token during Object Put.
  • Potential generating Range requests inside Get request execution context.

0.13.0 - 2020-12-15 - Modo (모도, 茅島)

Implementation of a local object storage engine. Adaptation of the object service work scheme for the engine.

Changed

  • Object format after transformations.
  • Handling of object operations.

Added

  • Local storage components: Engine, Shard, BlobStor, Metabase, Blobovnicza.
  • Support of voting for sidechain governance in IR node.
  • Raw flag support in Object Get/Head/GetRange CLI commands.

Fixed

  • Ignoring object address from session token in eACL validation.

0.12.1 - 2020-11-25

Bugfixes and small performance improvements.

Fixed

  • Routine leak by adding SDK client cache. (#184)
  • Variety of ACL bugs. (#180, #190, #209)
  • Policer tried to replicate virtual objects. (#182)
  • Search queries with object ID field. (#177)
  • Bug with extended ACL signature check in neofs-cli (#206)

Added

  • More debug logs in object service.
  • Dial timeouts in object service config (NEOFS_OBJECT_PUT_DIAL_TIMEOUT=5s)

Changed

  • Routine pools in object service are non-blocking now.
  • Container service now returns error if extended ACL is not set.

0.12.0 - 2020-11-17

NeoFS-API v2.0 support and updated brand-new storage node application.

Fixed

  • SetConfig method invocation of netmap contract. (#147)
  • Balance response overflow. (#122)

Added

  • Gas emission routine in inner ring nodes.
  • GRPC reflection service. (NEOFS_GRPC_ENABLE_REFLECT_SERVICE=true)
  • New netmap query language parser.

Changed

  • Storage node application rebuilt from scratch.
  • CLI supports accounting, object and container related operations.
  • Inner ring node shutdowns on neo RPC node connection drop.
  • Updated to preview4 compatible neo-go version.

0.11.0 - 2020-07-23

Added

  • Inner ring application to repository.
  • Inner ring epoch processor.
  • Inner ring asset processor for GAS deposit and withdraw.

Changed

  • The structure of source code tree.

[0.10.0] - 2020-07-10

First public review release.