frostfs-api/object/types.proto

syntax = "proto3";

package object;

option go_package = "github.com/nspcc-dev/neofs-api-go/object";
option csharp_namespace = "NeoFS.API.Object";

import "refs/types.proto";
import "service/meta.proto";
import "service/verify.proto";

// Type of the object payload content
enum ObjectType {
  // Just a normal object
  REGULAR = 0;
  // Used internally to identify deleted objects
  TOMBSTONE = 1;
  // Identifies that the object holds StorageGroup information
  STORAGE_GROUP = 2;
}

message Header {
  // Object's container
  refs.ContainerID container_id = 1;
  // Object's owner
  refs.OwnerID owner_id = 2;
  // Epoch when the object was created
  uint64 creation_epoch = 3;
  // Object format version.
  // Effectively the version of API library used to create particular object
  service.Version version = 4;
  // Size of payload in bytes.
  // 0xFFFFFFFFFFFFFFFF means `payload_length` is unknown
  uint64 payload_length = 5;
  // Hash of payload bytes
  bytes payload_hash = 6;
  ObjectType object_type = 7;
  // Homomorphic hash of the object payload.
  bytes homomorphic_hash = 8;
  // Session token, if it was used during Object creation.
  // Need it to verify integrity and authenticity out of Request scope.
  service.SessionToken session_token = 9;

  // Attribute groups the user-defined Key-Value pairs attached to the object
  message Attribute {
    // string key to the object attribute
    string key = 1;
    // string value of the object attribute
    string value = 2;
  }
  repeated Attribute attributes = 10;

  // Information about spawning the objects through a payload splitting.
  message Split {
    // Identifier of the origin object.
    // Parent and children objects must be within the same container.
    // Parent object_id is known only to the minor child.
    refs.ObjectID parent = 1;
    // Previous carries identifier of the left split neighbor.
    refs.ObjectID previous = 2;
    // `signature` field of the parent object. Used to reconstruct parent.
    service.Signature parent_signature = 3;
    // `header` field of the parent object. Used to reconstruct parent.
    Header parent_header = 4;
    // Children carries list of identifiers of the objects generated by splitting the current.
    repeated refs.ObjectID children = 5;
  }
  // Position of the object in the split hierarchy.
  Split split = 11;
}

// Object structure.
message Object {
  // Object's unique identifier.
  // Object is content-addressed. It means id will change if header or payload
  // changes. It's calculated as a hash of header field, which contains hash of
  // object's payload
  refs.ObjectID object_id = 1;
  // Signed object_id
  service.Signature signature = 2;
  // Object metadata headers
  Header header = 3;
  // Payload bytes.
  bytes payload = 4;
}