wip

Author: Mr-Leshiy

docs/src/architecture/08_concepts/catalyst_voting/transaction.md

@@ -128,6 +128,29 @@ Expected witness (includes signature)
     ```
 <!-- markdownlint-enable max-one-sentence-per-line code-block-style -->
 
+#### Transaction signing
+
+[COSE] is used to define a transaction's signature structure.
+[COSE] is a flexible security protocol that supports various types of security messages.
+However, only `COSE Signed Data Object` or `COSE_Sign` type is used.
+
+The following header must be included in the [COSE] signasture.
+
+`protected`:
+* `content type`: `application/cbor`
+  (this parameter is used to indicate the content type of the data in the payload or ciphertext fields).
+
+Any other headers as `alg`, `kid` etc. could be specified of any kind and not defined by this spec.
+
+##### Signature payload
+
+As mentioned earlier, the content type of the [COSE] signature payload is `application/cbor`.
+In particular it must be a [CBOR] encoded [BLAKE2b-256] hash bytes:
+
+```CDDL
+payload = #6.32782(bytes .size 32)
+```
+
 ## Rationale
 
 ## Path to Active
@@ -140,6 +163,8 @@ Expected witness (includes signature)
 
 <!-- OPTIONAL SECTIONS: see CIP-0001 > Document > Structure table -->
 
-[BLAKE2b-256]: https://www.blake2.net/blake2.pdf\
-[BLAKE2b-512]: https://www.blake2.net/blake2.pdf\
+[BLAKE2b-256]: https://www.blake2.net/blake2.pdf
+[BLAKE2b-512]: https://www.blake2.net/blake2.pdf
 [ristretto255]: https://ristretto.group
+[COSE]: https://datatracker.ietf.org/doc/rfc9052/
+[CBOR]: https://datatracker.ietf.org/doc/rfc8949/

docs/src/architecture/08_concepts/catalyst_voting/tx_v2.cddl

@@ -1,40 +1,28 @@
 vote_tx = [
-    brand_id: UUID, ; e.g. Midnight, Catalyst etc.
-    campaign_id: UUID, ; e.g. Fund 1, Fund 2 etc.
-    event_id: UUID, ;
-    category_id: UUID,
-    vote_type: UUID,
-    challenge_info,
+    vote_tx_body,
+    signature
+]
+
+vote_tx_body = [
+    vote_info,
     votes,
     voters_data: encoded_cbor
 ]
 
-votes = [+ vote]
-vote = (public_vote / private_vote)
-;---
-vote = [ choices, ? proof, ? prop_id ]
-choices = [ + choice ] 
-choice = encoded-cbor
-;---
-
-public_vote = [2* bool]
-; public_vote = [2* scalar]
-; public_vote = [2* bytes]
-private_vote = [2* (encrypted_vote, vote_proof)]
-
-encrypted_vote = ciphertext
-vote_proof = ( [2* (announcement, ciphertext, r_response)], scalar)
-
-ciphertext = (group_element, group_element)
-announcement = (group_element, group_element, group_element)
-r_response = (scalar, scalar, scalar)
-
-; encrypted_vote = bytes
-; vote_proof = bytes
+vote_info = {
+    brand_id: UUID, ; e.g. Midnight, Catalyst etc.
+    campaign_id: UUID, ; e.g. treasury campaign
+    event_id: UUID, ; e.g. Fund 1, Fund 2 etc.
+    category_id: UUID,
+    vote_type: UUID, ; e.g. Public or Private vote
+}
 
-scalar = (bytes .size 32)
-group_element = (bytes .size 32)
+votes = [+ vote]
+vote = [
+    choice: encoded-cbor,
+    proof: encoded-cbor / null,
+    prop_id: UUID / null,
+]
 
 UUID = #6.37(bytes) ; UUID type
-
-#6.24( bstr( biguint  ) )
+signature = #6.98(COSE_Sign) ; COSE signature