Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(p2p): update coinjoin messages #93

Merged
merged 3 commits into from
Jan 22, 2024
+13 −22
Merged

docs(p2p): update coinjoin messages #93

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5dc8ebc
docs(p2p): update dsq info and example
thephez Jan 18, 2024
32d06de
docs(p2p): remove deprecated info from dssu
thephez Jan 18, 2024
cf1b431
docs(p2p): update dstx
thephez Jan 18, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 13 additions & 22 deletions docs/reference/p2p-network-privatesend-messages.md
View file
Open in desktop
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