feat(dir): add referrer CIDs

Signed-off-by: Bendegúz Csirmaz <csirmazbendeguz@gmail.com>

Author: csirmazbendeguz

api/core/v1/referrer.go

@@ -3,6 +3,11 @@
 
 package v1
 
+import (
+	"encoding/json"
+	"fmt"
+)
+
 // ReferrerObject defines an interface for referrer objects that can be
 // marshaled and unmarshaled to/from RecordReferrer format.
 type ReferrerObject interface {
@@ -18,3 +23,27 @@ type ReferrerObject interface {
 	//   - PublicKey: "agntcy.dir.sign.v1.PublicKey"
 	ReferrerType() string
 }
+
+// Marshal marshals the RecordReferrer similar to how Record.Marshal marshals Record.
+func (r *RecordReferrer) Marshal() ([]byte, error) {
+	if r == nil {
+		return nil, nil
+	}
+
+	jsonBytes, err := json.Marshal(r)
+	if err != nil {
+		return nil, fmt.Errorf("failed to marshal RecordReferrer: %w", err)
+	}
+
+	var normalized any
+	if err := json.Unmarshal(jsonBytes, &normalized); err != nil {
+		return nil, fmt.Errorf("failed to normalize JSON for canonical ordering: %w", err)
+	}
+
+	canonicalBytes, err := json.Marshal(normalized)
+	if err != nil {
+		return nil, fmt.Errorf("failed to marshal normalized JSON with sorted keys: %w", err)
+	}
+
+	return canonicalBytes, nil
+}

api/store/v1/store_service.pb.go

@@ -59,6 +59,9 @@ message PushReferrerResponse {
 
   // Optional error message if push failed
   optional string error_message = 2;
+
+  // The CID of the referrer
+  string cid = 3;
 }
 
 // PullReferrerRequest represents a record with optional OCI artifacts for pull operations.

proto/agntcy/dir/store/v1/store_service.proto

@@ -61,6 +61,13 @@ export declare type PushReferrerResponse = Message<"agntcy.dir.store.v1.PushRefe
    * @generated from field: optional string error_message = 2;
    */
   errorMessage?: string;
+
+  /**
+   * The CID of the referrer
+   *
+   * @generated from field: string cid = 3;
+   */
+  cid: string;
 };
 
 /**

sdk/dir-js/src/models/agntcy/dir/store/v1/store_service_pb.d.ts

@@ -13,7 +13,7 @@ import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
  * Describes the file agntcy/dir/store/v1/store_service.proto.
  */
 export const file_agntcy_dir_store_v1_store_service = /*@__PURE__*/
-  fileDesc("CidhZ250Y3kvZGlyL3N0b3JlL3YxL3N0b3JlX3NlcnZpY2UucHJvdG8SE2FnbnRjeS5kaXIuc3RvcmUudjEifgoTUHVzaFJlZmVycmVyUmVxdWVzdBIxCgpyZWNvcmRfcmVmGAEgASgLMh0uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZFJlZhI0CghyZWZlcnJlchgCIAEoCzIiLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWZlcnJlciJVChRQdXNoUmVmZXJyZXJSZXNwb25zZRIPCgdzdWNjZXNzGAEgASgIEhoKDWVycm9yX21lc3NhZ2UYAiABKAlIAIgBAUIQCg5fZXJyb3JfbWVzc2FnZSJ2ChNQdWxsUmVmZXJyZXJSZXF1ZXN0EjEKCnJlY29yZF9yZWYYASABKAsyHS5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkUmVmEhoKDXJlZmVycmVyX3R5cGUYAiABKAlIAIgBAUIQCg5fcmVmZXJyZXJfdHlwZSJMChRQdWxsUmVmZXJyZXJSZXNwb25zZRI0CghyZWZlcnJlchgBIAEoCzIiLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWZlcnJlcjL+AwoMU3RvcmVTZXJ2aWNlEkUKBFB1c2gSGi5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkGh0uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZFJlZigBMAESRQoEUHVsbBIdLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWYaGi5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkKAEwARJLCgZMb29rdXASHS5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkUmVmGh4uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZE1ldGEoATABEkEKBkRlbGV0ZRIdLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWYaFi5nb29nbGUucHJvdG9idWYuRW1wdHkoARJnCgxQdXNoUmVmZXJyZXISKC5hZ250Y3kuZGlyLnN0b3JlLnYxLlB1c2hSZWZlcnJlclJlcXVlc3QaKS5hZ250Y3kuZGlyLnN0b3JlLnYxLlB1c2hSZWZlcnJlclJlc3BvbnNlKAEwARJnCgxQdWxsUmVmZXJyZXISKC5hZ250Y3kuZGlyLnN0b3JlLnYxLlB1bGxSZWZlcnJlclJlcXVlc3QaKS5hZ250Y3kuZGlyLnN0b3JlLnYxLlB1bGxSZWZlcnJlclJlc3BvbnNlKAEwAUK/AQoXY29tLmFnbnRjeS5kaXIuc3RvcmUudjFCEVN0b3JlU2VydmljZVByb3RvUAFaImdpdGh1Yi5jb20vYWdudGN5L2Rpci9hcGkvc3RvcmUvdjGiAgNBRFOqAhNBZ250Y3kuRGlyLlN0b3JlLlYxygITQWdudGN5XERpclxTdG9yZVxWMeICH0FnbnRjeVxEaXJcU3RvcmVcVjFcR1BCTWV0YWRhdGHqAhZBZ250Y3k6OkRpcjo6U3RvcmU6OlYxYgZwcm90bzM", [file_agntcy_dir_core_v1_record, file_google_protobuf_empty]);
+  fileDesc("CidhZ250Y3kvZGlyL3N0b3JlL3YxL3N0b3JlX3NlcnZpY2UucHJvdG8SE2FnbnRjeS5kaXIuc3RvcmUudjEifgoTUHVzaFJlZmVycmVyUmVxdWVzdBIxCgpyZWNvcmRfcmVmGAEgASgLMh0uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZFJlZhI0CghyZWZlcnJlchgCIAEoCzIiLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWZlcnJlciJiChRQdXNoUmVmZXJyZXJSZXNwb25zZRIPCgdzdWNjZXNzGAEgASgIEhoKDWVycm9yX21lc3NhZ2UYAiABKAlIAIgBARILCgNjaWQYAyABKAlCEAoOX2Vycm9yX21lc3NhZ2UidgoTUHVsbFJlZmVycmVyUmVxdWVzdBIxCgpyZWNvcmRfcmVmGAEgASgLMh0uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZFJlZhIaCg1yZWZlcnJlcl90eXBlGAIgASgJSACIAQFCEAoOX3JlZmVycmVyX3R5cGUiTAoUUHVsbFJlZmVycmVyUmVzcG9uc2USNAoIcmVmZXJyZXIYASABKAsyIi5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkUmVmZXJyZXIy/gMKDFN0b3JlU2VydmljZRJFCgRQdXNoEhouYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZBodLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRSZWYoATABEkUKBFB1bGwSHS5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkUmVmGhouYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZCgBMAESSwoGTG9va3VwEh0uYWdudGN5LmRpci5jb3JlLnYxLlJlY29yZFJlZhoeLmFnbnRjeS5kaXIuY29yZS52MS5SZWNvcmRNZXRhKAEwARJBCgZEZWxldGUSHS5hZ250Y3kuZGlyLmNvcmUudjEuUmVjb3JkUmVmGhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5KAESZwoMUHVzaFJlZmVycmVyEiguYWdudGN5LmRpci5zdG9yZS52MS5QdXNoUmVmZXJyZXJSZXF1ZXN0GikuYWdudGN5LmRpci5zdG9yZS52MS5QdXNoUmVmZXJyZXJSZXNwb25zZSgBMAESZwoMUHVsbFJlZmVycmVyEiguYWdudGN5LmRpci5zdG9yZS52MS5QdWxsUmVmZXJyZXJSZXF1ZXN0GikuYWdudGN5LmRpci5zdG9yZS52MS5QdWxsUmVmZXJyZXJSZXNwb25zZSgBMAFCvwEKF2NvbS5hZ250Y3kuZGlyLnN0b3JlLnYxQhFTdG9yZVNlcnZpY2VQcm90b1ABWiJnaXRodWIuY29tL2FnbnRjeS9kaXIvYXBpL3N0b3JlL3YxogIDQURTqgITQWdudGN5LkRpci5TdG9yZS5WMcoCE0FnbnRjeVxEaXJcU3RvcmVcVjHiAh9BZ250Y3lcRGlyXFN0b3JlXFYxXEdQQk1ldGFkYXRh6gIWQWdudGN5OjpEaXI6OlN0b3JlOjpWMWIGcHJvdG8z", [file_agntcy_dir_core_v1_record, file_google_protobuf_empty]);
 
 /**
  * Describes the message agntcy.dir.store.v1.PushReferrerRequest.