syntax = "proto3";
package container;
option go_package = "github.com/nspcc-dev/neofs-api-go/container";
option csharp_namespace = "NeoFS.API.Container";

import "github.com/nspcc-dev/netmap/selector.proto";
import "github.com/gogo/protobuf/gogoproto/gogo.proto";

option (gogoproto.stable_marshaler_all) = true;

// The Container service definition.
message Container {
    // OwnerID is a wallet address.
    bytes OwnerID              = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
    // Salt is a nonce for unique container id calculation.
    bytes Salt                 = 2 [(gogoproto.customtype) = "UUID",    (gogoproto.nullable) = false];
    // Capacity defines amount of data that can be stored in the container (doesn't used for now).
    uint64 Capacity            = 3;
    // Rules define storage policy for the object inside the container.
    netmap.PlacementRule Rules = 4 [(gogoproto.nullable) = false];
    // BasicACL with access control rules for owner, system, others and
    // permission bits for bearer token and extended ACL.
    uint32 BasicACL            = 5;
    // Attributes define any immutable characteristics of container.
    repeated Attribute Attributes = 6;
}

// Attribute is a key-value pair of strings.
message Attribute {
  // Key of immutable container attribute.
  string Key   = 1;
  // Value of immutable container attribute.
  string Value = 2;
}