msnp-wiki/docs/versions/msnp5.md

# Introduction
MSNP5 is the fourth released version of the Mobile Status Notification Protocol.  
It was introduced officially in Client Version 3.0.0283.

# Command information
It introduces the notification service commands:
* [BPR](../commands/bpr.md)
* [NOT](../commands/not.md)
* [PAG](../commands/pag.md)
* [PRP](../commands/prp.md)
* [SDC](../commands/sdc.md)

*No switchboard or dispatch service commands were known to be introduced in this version*

*No commands were known to be removed in this version*

# Known changes
(from [MSNP4](msnp4.md)):
* [BPR](../commands/bpr.md) and [PRP](../commands/prp.md) have been added to [SYN](../commands/syn.md).
* [`<NOTIFICATION>`](../files/notification.md) documents are handled by the client with the new [NOT](../commands/not.md) payload command.
* Non-protocol: Official website stopped updating the whatsnew.asp page between this (MSNP5) and [MSNP7](msnp7.md).
* Official Client: Introduced the toast notification system. Notifications can now stack vertically.
* Official Client: Log in notifications are now handled by the newly introduced toast system.
* Official Client: Introduced emoticons.
* Official Client: Introduced File Transfer and Messenger-to-Messenger calling via invitations.
* Introduced first payload commands ([SDC](../commands/sdc.md), [PAG](../commands/pag.md)) to be sent to the Notification Server from the client.
* Official Client: [FND](../commands/fnd.md) functionality changed slightly(?) to say that the Passport privacy policy
  doesn't allow users to retrieve the e-mails assocated with the user's account,
  sending the user to a invitation screen with, with it ending in sending an [SDC](../commands/sdc.md) in the format of
  `SDC TrID {FND index} 0x0409 MSMSGS MSMSGS X X example%20user {length}`.
  The `0x0409` can be changed to any language code, with the `length` denoting the payload if specified.
* Official Client: [URL](../commands/url.md) without the Passport Site ID (parameter 3) support has been removed.
* Official Client: Added new [URL](../commands/url.md) services `MOBILE` and `CHGMOB` .
* Official Client: Error code 924 has been shadow-implemented,
  which when sent as a [USR](../commands/usr.md) response, shows the
  "Sorry, you can not sign in until your verify that (user handle) really belongs to you" dialog.

# Client-server communication example
```
C: VER 1 MSNP5 MSNP4 CVR0
S: VER 1 MSNP5
C: INF 2
S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0
```
Client disconnects from server.

Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP5 MSNP4 CVR0
S: VER 4 MSNP5
C: INF 5
S: INF 5 MD5
C: USR 6 MD5 I example@hotmail.com
S: USR 6 MDS S prefix
C: USR 7 MD5 S $md5(prefix + password)
S: USR 7 OK example@hotmail.com example%20user
S: MSG Hotmail Hotmail 367
MIME-Version: 1.0
Content-Type: text/x-msmsgsprofile; charset=UTF-8
LoginTime: 1726321960
EmailEnabled: 1
MemberIdHigh: 1
MemberIdLow: 2
lang_preference: 1033
PreferredEmail: example@hotmail.com
country: US
PostalCode: 
Gender: 
Kid: 0
Age: 
BDayPre: 
Birthday: 
Wallet: 
Flags: 1027
sid: 507
kv: 11
MSPAuth: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA$$

C: SYN 8 5
S: SYN 8 6
S: SYN 8 6
S: GTC 8 6 A
S: BLP 8 6 AL
S: LST 8 FL 6 1 1 anotheruser@hotmail.com another%20user
S: BPR 6 anotheruser@hotmail.com PHH 1%20(222)%203333
S: BPR 6 anotheruser@hotmail.com PHW
S: BPR 6 anotheruser@hotmail.com PHM
S: BPR 6 anotheruser@hotmail.com MOB N
S: LST 8 AL 6 1 1 anotheruser@hotmail.com another%20user
S: LST 8 BL 6 0 0
S: LST 8 RL 6 1 1 anotheruser@hotmail.com another%20user
C: CHG 9 NLN
S: CHG 9 NLN
S: NOT 367
<NOTIFICATION ver="1" id="2" siteid="0" siteurl="http://example.com/">
	<TO pid="0x00000001:0x00000002" name="example@hotmail.com" />
	<MSG id="0">
		<ACTION url="alert?command=action" />
		<SUBSCR url="alert?command=change" />
		<BODY lang="1033" icon="alerticon_32x32.png">
			<TEXT>This is an example notification.</TEXT>
		</BODY>
	</MSG>
</NOTIFICATION>
C: PRP 10 PHH 123%20(4567)
S: PRP 10 7 PHH 123%20(4567)
S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444
C: OUT
```
Client disconnects from server.
```
S: OUT
```
Server disconnects client.
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Introduction`
0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead 2024-12-18 15:16:29 -05:00			`MSNP5 is the fourth released version of the Mobile Status Notification Protocol.`
initial commit 2024-10-10 15:38:51 -04:00			`It was introduced officially in Client Version 3.0.0283.`

actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Command information`
initial commit 2024-10-10 15:38:51 -04:00			`It introduces the notification service commands:`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [BPR](../commands/bpr.md)`
massive amount of corrections, rest of pre-P11 commands upgrade yiki, slugs now work better, but not in URLs (i forgot) 0 Commands Left. Time for that parity check. Add a license too. Bump version to 0.1.0. NEW RECORD! 2024-10-26 06:56:17 -04:00			`* [NOT](../commands/not.md)`
Late Night Commiting: PAG and PGD 8 commands until first parity check. 2024-10-21 17:31:11 -04:00			`* [PAG](../commands/pag.md)`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`* [PRP](../commands/prp.md)`
more corrections, ADC and SDC new page: Reference Constants, which include the wiki's various values used on pages. 2024-10-21 12:30:22 -04:00			`* [SDC](../commands/sdc.md)`
initial commit 2024-10-10 15:38:51 -04:00
			`No switchboard or dispatch service commands were known to be introduced in this version`

			`No commands were known to be removed in this version`

actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Known changes`
			`(from [MSNP4](msnp4.md)):`
Corrections, USR, SYN Added new section to Protocols (half done with it though): Changes to error codes, to ask "When did that error code get implemented and when did it get removed" Probably could be made better, eh. 5 Commands Remain. New change record, too. 2024-10-23 16:47:02 -04:00			`* [BPR](../commands/bpr.md) and [PRP](../commands/prp.md) have been added to [SYN](../commands/syn.md).`
[0.1.4-alpha.1] xml examples, NOT stuff, fixes updated yiki also 2024-11-19 15:23:28 -05:00			* [`<NOTIFICATION>`](../files/notification.md) documents are handled by the client with the new [NOT](../commands/not.md) payload command.
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`* Non-protocol: Official website stopped updating the whatsnew.asp page between this (MSNP5) and [MSNP7](msnp7.md).`
initial commit 2024-10-10 15:38:51 -04:00			`* Official Client: Introduced the toast notification system. Notifications can now stack vertically.`
			`* Official Client: Log in notifications are now handled by the newly introduced toast system.`
			`* Official Client: Introduced emoticons.`
			`* Official Client: Introduced File Transfer and Messenger-to-Messenger calling via invitations.`
[0.1.4] MSNP13 and MSNP14, ADL, RML, FQY also add new command findings: * undocumented command GSB * syntax and other errors fixed * explode a bit of xml in places that were a bit too long * find out what a "merchant cab" file is (one line of xml) 2024-11-30 12:02:48 -05:00			`* Introduced first payload commands ([SDC](../commands/sdc.md), [PAG](../commands/pag.md)) to be sent to the Notification Server from the client.`
			`* Official Client: [FND](../commands/fnd.md) functionality changed slightly(?) to say that the Passport privacy policy`
add new pages, templates and update yiki + templates not compiled + added: BLP, FND and GTC, CHG and IMS command pages * updated links and added new relevant ones 2024-10-13 17:03:57 -04:00			`doesn't allow users to retrieve the e-mails assocated with the user's account,`
more corrections, ADC and SDC new page: Reference Constants, which include the wiki's various values used on pages. 2024-10-21 12:30:22 -04:00			`sending the user to a invitation screen with, with it ending in sending an [SDC](../commands/sdc.md) in the format of`
add new pages, templates and update yiki + templates not compiled + added: BLP, FND and GTC, CHG and IMS command pages * updated links and added new relevant ones 2024-10-13 17:03:57 -04:00			`SDC TrID {FND index} 0x0409 MSMSGS MSMSGS X X example%20user {length}`.
			The `0x0409` can be changed to any language code, with the `length` denoting the payload if specified.
fix a bunch of errors, new commands + ADD + REM + URL * fixed a bunch of formatting * changed the default list version to 255, if it increases to 256 it means it changed * fixed a bunch of muscle memory mishaps * Clean-up some missing "fill this in once information is available's 2024-10-16 16:12:41 -04:00			`* Official Client: [URL](../commands/url.md) without the Passport Site ID (parameter 3) support has been removed.`
			* Official Client: Added new [URL](../commands/url.md) services `MOBILE` and `CHGMOB` .
found what that parameter does, 923 and 924 info apparently 923 and 924 are supported way earlier it's REALLY confusing apparently because yes those clients DO handle those codes, but HOW? makes me want to throw out the error code tables because it seems like different clients implement them in different ways with no established rule, especially those two because only 924 doesn't appear in plain text in the main binary until P7, but it absolutely exists before then? And for 923... I don't even know. It's not in the main binary (at all). Let alone in later versions. 2024-10-24 10:17:51 -04:00			`* Official Client: Error code 924 has been shadow-implemented,`
			`which when sent as a [USR](../commands/usr.md) response, shows the`
			`"Sorry, you can not sign in until your verify that (user handle) really belongs to you" dialog.`
initial commit 2024-10-10 15:38:51 -04:00
actually use markdown features pages should look better in yiki now since i improved that too 2024-10-11 15:40:21 -04:00			`# Client-server communication example`
initial commit 2024-10-10 15:38:51 -04:00			```
			`C: VER 1 MSNP5 MSNP4 CVR0`
			`S: VER 1 MSNP5`
			`C: INF 2`
			`S: INF 2 MD5`
			`C: USR 3 MD5 I example@hotmail.com`
			`S: XFR 3 NS 10.0.0.5:1863 0`
			```
0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead 2024-12-18 15:16:29 -05:00			`Client disconnects from server.`
initial commit 2024-10-10 15:38:51 -04:00
0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead 2024-12-18 15:16:29 -05:00			Client opens a connection to `10.0.0.5:1863`.
initial commit 2024-10-10 15:38:51 -04:00			```
			`C: VER 4 MSNP5 MSNP4 CVR0`
			`S: VER 4 MSNP5`
			`C: INF 5`
			`S: INF 5 MD5`
			`C: USR 6 MD5 I example@hotmail.com`
			`S: USR 6 MDS S prefix`
			`C: USR 7 MD5 S $md5(prefix + password)`
			`S: USR 7 OK example@hotmail.com example%20user`
format it up, remove all carriage returns too 2024-10-15 14:08:22 -04:00			`S: MSG Hotmail Hotmail 367`
			`MIME-Version: 1.0`
			`Content-Type: text/x-msmsgsprofile; charset=UTF-8`
			`LoginTime: 1726321960`
			`EmailEnabled: 1`
			`MemberIdHigh: 1`
			`MemberIdLow: 2`
			`lang_preference: 1033`
			`PreferredEmail: example@hotmail.com`
			`country: US`
			`PostalCode:`
			`Gender:`
			`Kid: 0`
			`Age:`
			`BDayPre:`
			`Birthday:`
			`Wallet:`
			`Flags: 1027`
			`sid: 507`
			`kv: 11`
			`MSPAuth: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA$$`

initial commit 2024-10-10 15:38:51 -04:00			`C: SYN 8 5`
			`S: SYN 8 6`
			`S: SYN 8 6`
			`S: GTC 8 6 A`
			`S: BLP 8 6 AL`
			`S: LST 8 FL 6 1 1 anotheruser@hotmail.com another%20user`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`S: BPR 6 anotheruser@hotmail.com PHH 1%20(222)%203333`
initial commit 2024-10-10 15:38:51 -04:00			`S: BPR 6 anotheruser@hotmail.com PHW`
			`S: BPR 6 anotheruser@hotmail.com PHM`
			`S: BPR 6 anotheruser@hotmail.com MOB N`
			`S: LST 8 AL 6 1 1 anotheruser@hotmail.com another%20user`
			`S: LST 8 BL 6 0 0`
			`S: LST 8 RL 6 1 1 anotheruser@hotmail.com another%20user`
			`C: CHG 9 NLN`
			`S: CHG 9 NLN`
massive amount of corrections, rest of pre-P11 commands upgrade yiki, slugs now work better, but not in URLs (i forgot) 0 Commands Left. Time for that parity check. Add a license too. Bump version to 0.1.0. NEW RECORD! 2024-10-26 06:56:17 -04:00			`S: NOT 367`
			`<NOTIFICATION ver="1" id="2" siteid="0" siteurl="http://example.com/">`
			`<TO pid="0x00000001:0x00000002" name="example@hotmail.com" />`
			`<MSG id="0">`
			`<ACTION url="alert?command=action" />`
			`<SUBSCR url="alert?command=change" />`
			`<BODY lang="1033" icon="alerticon_32x32.png">`
			`<TEXT>This is an example notification.</TEXT>`
			`</BODY>`
			`</MSG>`
format it up, remove all carriage returns too 2024-10-15 14:08:22 -04:00			`</NOTIFICATION>`
fattest update yet - 30 whole changed files next is formatting, which is why i wanted to commit anyway 2024-10-15 13:14:20 -04:00			`C: PRP 10 PHH 123%20(4567)`
			`S: PRP 10 7 PHH 123%20(4567)`
			`S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444`
initial commit 2024-10-10 15:38:51 -04:00			`C: OUT`
			```
0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead 2024-12-18 15:16:29 -05:00			`Client disconnects from server.`
initial commit 2024-10-10 15:38:51 -04:00			```
			`S: OUT`
			```
0.2.0: The Winter Roll-up i have basically touched every file help * Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time. * Rename passport (soap) to RST * Formatting changes (many) * Several corrections * change git host because git.kevinthe.horse seems Dead 2024-12-18 15:16:29 -05:00			`Server disconnects client.`