feat(rust/vote-tx-v2): Public vote tx v2 CBOR decoding/encoding implementation (#86)

* refactor

* add public_tx mod

* add initial PublicTx impl

* make gen_tx::Choice generic

* make gen_tx::PropId and gen_tx::Proof generic

* add more gen_tx decoding tests

* add separate tx_body mod

* move vote impl into vote mod

* move EventMap to event_map mod

* move VoterData to voter_data mod

* wip

* remove docoding mod

* wip

* add signature header validation

* add a gen_tx::builder

* wip

* refactor VoterData type

* refactor Cbor

* update cddl specs, make voter-data generic

* move choice to the separate mod

* wip

* move Uuid impl to seprate mod

* move EncodedCbor struct to separate mod

* add public tx test

* fix spelling

* fix, add missing comma

* move definition of public_tx/choice and public_tx/proof to the public_tx/vote mod

* add comment which specifies a CBOR encoding/decoding profile

---------

Co-authored-by: Oleksandr Prokhorenko <[email protected]>

Author: Mr-Leshiy

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

@@ -1,18 +1,22 @@
-gen-vote-tx<choice-t, proof-t, prop-id-t> = [
-    tx-body<choice-t, proof-t, prop-id-t>,
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
+gen-vote-tx<choice-t, proof-t, prop-id-t, voter-data-t> = [
+    tx-body<choice-t, proof-t, prop-id-t, voter-data-t>,
     signature
 ]
 
-tx-body<choice-t, proof-t, prop-id-t> = [
-    vote-type
+tx-body<choice-t, proof-t, prop-id-t, voter-data-t> = [
+    vote-type,
     event,
     votes<choice-t, proof-t, prop-id-t>,
-    voter-data,
+    voter-data<voter-data-t>,
 ]
 
 vote-type = UUID ; e.g. Public or Private vote
-event = { * event-key => any }
+event = { * event-key => event-value }
 event-key = int / text
+event-value = any
 
 votes<choice-t, proof-t, prop-id-t> = [+ vote<choice-t, proof-t, prop-id-t>]
 vote<choice-t, proof-t, prop-id-t>  = [
@@ -25,7 +29,7 @@ choice<choice-t> = #6.24(bytes .cbor choice-t) ; encoded-cbor
 proof<proof-t> = #6.24(bytes .cbor proof-t) ; encoded-cbor
 prop-id<prop-id-t> = #6.24(bytes .cbor prop-id-t) ; encoded-cbor
 
-voter-data = encoded-cbor
+voter-data<voter-data-t> = #6.24(bytes .cbor voter-data-t) ; encoded-cbor
 
 UUID = #6.37(bytes) ; UUID type
 signature = #6.98(cose.COSE_Sign) ; COSE signature

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

@@ -1,2 +1,5 @@
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
 cose-payload = blake2b-256
 blake2b-256 = #6.32782(bytes .size 32) ; Blake2b-256 hash bytes

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

@@ -1,4 +1,7 @@
-vote-tx-v2 = gen-vote-tx<choice-data, proof-data, proposal>
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
+vote-tx-v2<voter-data-t> = gen-vote-tx<choice-data, proof-data, proposal, voter-data-t>
 
 choice-data = ciphertext
 ciphertext = [group-element, group-element]

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

@@ -1,4 +1,7 @@
-vote-tx-v2-public = gen-vote-tx<choice-data, proof-data, proposal>
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
+vote-tx-v2-public<voter-data-t> = gen-vote-tx<choice-data, proof-data, proposal, voter-data-t>
 
 choice-data = uint
 proof-data = undefined

docs/src/architecture/08_concepts/immutable_ledger/cddl/block.cddl

@@ -1,3 +1,6 @@
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
 block = [
     block-header,
     block-data,

docs/src/architecture/08_concepts/immutable_ledger/cddl/genesis_to_prev_hash.cddl

@@ -1,3 +1,6 @@
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
 genesis-to-prev-hash = [
     chain-id: ULID,
     timestamp: #6.1(uint .ge 1722470400), ; Epoch-based date/time

docs/src/architecture/08_concepts/immutable_ledger/cddl/hash.cddl

@@ -1,3 +1,6 @@
+; All encoders/decoders of this specification must follow deterministic cbor encoding rules
+; https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06
+
 hash-bytes = (
   #6.32781(bytes) / ; Blake3 hash
   #6.32782(bytes) / ; Blake2b hash