Skip to content

Commit

Permalink
docs(p2p): update coinjoin messages (#93)
Browse files Browse the repository at this point in the history
* docs(p2p): update dsq info and example

* docs(p2p): remove deprecated info from dssu

* docs(p2p): update dstx
  • Loading branch information
thephez authored Jan 22, 2024
1 parent f81f30e commit bf4869d
Showing 1 changed file with 13 additions and 22 deletions.
35 changes: 13 additions & 22 deletions docs/reference/p2p-network-privatesend-messages.md
Original file line number Diff line number Diff line change
Expand Up @@ -314,8 +314,7 @@ If the message indicates the queue is ready, the node responds with a [`dsi` mes
| Bytes | Name | Data type | Required | Description |
| ---------- | ----------- | --------- | -------- | -------- |
| 4 | nDenom | int | Required | Denomination allowed in this session
| 36 | masternodeOutPoint | outPoint | *Required | **\* Replaced by `proTxHash` following the v19 hard fork**<br>The unspent outpoint of the masternode (holding 1000 DASH) which is hosting this session
| 32 | proTxHash | uint256 | Required | **Added in Dash Core 19.2.0.<br>Replaces `masternodeOutPoint`.**<br>The ProRegTx hash of the masternode which is hosting this session
| 32 | proTxHash | uint256 | Required | The ProRegTx hash of the masternode which is hosting this session<br>**Replaced `masternodeOutPoint` in Dash Core 19.2.0.**
| 8 | nTime | int64_t | Required | Time this [`dsq` message](../reference/p2p-network-privatesend-messages.md#dsq) was created
| 1 | fReady | bool | Required | Indicates if the pool is ready to be executed
| 97 | vchSig | char[] | Required | BLS Signature of this message by masternode verifiable via pubKeyMasternode (Length (1 byte) + Signature (96 bytes))<br>**Note**: serialized using the basic BLS scheme after Dash 19.0 activation
Expand All @@ -335,23 +334,20 @@ The following annotated hexdump shows a [`dsq` message](../reference/p2p-network
``` text
01000000 ............................. Denomination: 10 Dash (1)
Masternode Outpoint
| a383a2489aedccfab4bb41368d1c8ee3
| 10d9ee90cb3d181880ce4e0cdb36ecb7
| 0f000000 ........................... Outpoint index number: 15
d28018e798ccbd797d0b2fc33513d64d
60d55c92f4b35f46db169332dae95f4d ..... Protx Hash
10b4235c00000000 ..................... Create Time: 2018-12-26 17:02:08 UTC
c93aa96500000000 ..................... Create Time: 2024-01-18 14:50:49 UTC
00 ................................... Ready: 0
60 ................................... Signature length: 96
0409a1349869a02e90e6e1f6d92bf995
27a72542fed987f6d2719596973d89e6
74605a3585b1335650f1555f7576061d
110fb72b3308e378ac8e8fbebeeffdb4
9b2a6562ad965bb3c3fd3f8e68483fdb
0d1401e2264071a74fc01d51e943ce9f ..... Masternode BLS Signature
a5d5ff37b8763059a464ec07a07f3e6a
1a53c6a327446badb054b507cf642e3f
956f0f758f80fd7a80416420c64ca015
11a9bb25490279844aecdae745d3dca0
12be868b6a15b25145d77bc8f5e2425b
e292e183a5a45310e12af6640ac621f1 ..... Masternode BLS Signature
```

## dss
Expand Down Expand Up @@ -427,7 +423,6 @@ The [`dssu` message](../reference/p2p-network-privatesend-messages.md#dssu) prov
| ---------- | ----------- | --------- | -------- | -------- |
| 4 | nMsgSessionID | int | Required | Session ID
| 4 | nMsgState | int | Required | Current state of processing
| 4 | nMsgEntriesCount | int | Required | **_Deprecated in Dash Core 0.15.0_**<br><br>Number of entries in the pool
| 4 | nMsgStatusUpdate | int | Required | Update state and/or signal if entry was accepted or not
| 4 | nMsgMessageID | int | Required | ID of the typical masternode reply message

Expand All @@ -440,7 +435,6 @@ The [`dssu` message](../reference/p2p-network-privatesend-messages.md#dssu) prov
| 2 | `POOL_STATE_ACCEPTING_ENTRIES`
| 3 | `POOL_STATE_SIGNING`
| 4 | `POOL_STATE_ERROR`
| ~~5~~ | ~~`POOL_STATE_SUCCESS`~~ **_Deprecated in Dash Core 0.16.0_**

**Pool Status Update**

Expand Down Expand Up @@ -493,8 +487,7 @@ The [`dstx` message](../reference/p2p-network-privatesend-messages.md#dstx) allo
| Bytes | Name | Data type | Required | Description |
| ---------- | ----------- | --------- | -------- | -------- |
| # | tx | [`tx` message](../reference/p2p-network-data-messages.md#tx) | Required | The transaction
| 36 | masternode<br>OutPoint | outPoint | *Required | **\* Replaced by `proTxHash` following the v19 hard fork**<br>The unspent outpoint of the masternode (holding 1000 DASH) which is signing the message
| 32 | proTxHash | uint256 | Required | **Added in Dash Core 19.2.0.<br>Replaces `masternodeOutPoint`.**<br>The ProRegTx hash of the masternode which is signing the message
| 32 | proTxHash | uint256 | Required | The ProRegTx hash of the masternode which is signing the message<br>**Replaced `masternodeOutPoint` in Dash Core 19.2.0.**
| 97 | vchSig | char[] | Required | BLS Signature of this message by masternode verifiable via pubKeyMasternode (Length (1 byte) + Signature (96 bytes))<br>**Note**: serialized using the basic BLS scheme after Dash 19.0 activation
| 8 | sigTime | int64_t | Require | Time this message was signed

Expand Down Expand Up @@ -546,10 +539,8 @@ Transaction Message
|
| 00000000 ................................... locktime: 0 (a block height)
Masternode Unspent Outpoint
| ccfbe4e7c220264cb0a8bfa5e91c6957
| 33c255384790e80e891a0d8f56a59d9e ......... Outpoint TXID
| 01000000 ................................. Outpoint index number: 1
d28018e798ccbd797d0b2fc33513d64d
60d55c92f4b35f46db169332dae95f4d ........... Protx Hash
60 ......................................... Signature length: 96
Expand Down

0 comments on commit bf4869d

Please sign in to comment.