# Introduction

MSNP10 is the ninth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 6.1.0155.

# Command information

It introduces the notification service commands:
* ADC
* SBP

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

*No error codes were known to be introduced in this version*

The following commands were removed in this version:
* ADD (automatic disconnection)
* REA (automatic disconnection?)

# Known changes
(from [MSNP9](msnp9.md)):
* Added new initial profile variable `TOUNeeded`. If exists and set to 1,
  a dialog box to review the Messenger Service Terms of Use is shown to the user.
* Changed SYN request and response.
  Client: `SYN transactionID listVersion settingsVersion`.
  Server: `SYN transactionID listVersion settingsVersion numberOfContacts numberOfGroups`.
  `settingsVersion` is always 0.
* Current display name is removed from USR, now is returned with other user properties (PRPs) in SYN.
* PRP MFN replaces REA (current passport). SBP (contact's address) MFN replaces other uses of REA.
* Added new initial profile variable `ABCHMigrated`. If set to 1, some commands are altered, such as:
  SYN: The request and response's list versions are now ISO 8601 with 7 subsecond digits, 
       usually with a -07:00 timezone offset.
       the previously unused second parameter (both request and response) is used as the Last Settings Version,
	   and follows the same time format as List Versions now do.
  LST: GUID specified as `C=` parameter, group IDs are now GUIDs.
  ADC, REM: uses GUIDs instead of contact emails if the list is FL, and also for groups.
  LSG, ADG: Uses GUIDs instead of IDs.
  SBP: Uses the contact's GUID instead of the Contact Address.
* All list version updating commands no longer return the current list version when used.
  GTC, BLP, ADG, REG, RMG, REM, PRP commands are affected by this change.
* Asynchronous BPRs also do not include the new list version number,
  and now provide Friendly Name (MFN) changes instead of sending entire NLNs [needs to be confirmed].
* Added a new list: Pending List/PL (bit 5, decimal 16). Is meant for unhandled contact added you notifications.
* Added new server-side [OUT](../commands/out.md) reasons: MIG, if the server has migrated you to ABCH,
  and TOU, for not accepting the Service Terms of Use.
* Official Client: Now handles the 604 error code again, which was last seen in Client Version 3.6.003x.
  Error code 913 is no longer handled after being implemented in Client Version 4.5.
* First protocol version to remove a core command implemented since [MSNP2](msnp2.md) draft (ADD).

# Client-server communication example
```
C: VER 1 MSNP10 MSNP9 CVR0
S: VER 1 MSNP10
C: CVR 2 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: CVR 2 6.1.0211 6.1.0211 6.1.0155 http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe http://messenger.msn.com
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server

Client opens a connection to 10.0.0.5:1863
```
C: VER 4 MSNP10 MSNP9 CVR0
S: VER 4 MSNP10
C: CVR 5 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: CVR 5 6.1.0211 6.1.0211 6.1.0155 http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe http://messenger.msn.com
C: USR 6 TWN I example@hotmail.com
S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
C: USR 7 TWN S $(pp14response.headers.authenticationInfo["from-PP"])
S: USR 7 OK example@hotmail.com 1 0
S: MSG Hotmail Hotmail 465
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: whatever+t+is+in+your+passport+login+ticket+that+you+sent+for+USR+TWN+S$
ClientIP: 192.168.1.111
ClientPort: 18183
ABCHMigrated: 0

C: SYN 8 15 0
S: SYN 8 16 0 1 1
S: GTC A
S: BLP AL
S: PRP MFN example%20user
S: PRP PHH 123-4567
S: LSG Other%20Contacts 0
S: LST N=anotheruser@hotmail.com F=another%20user 11 0
S: BPR PHH 1%20444%20222-3333
C: CHG 9 NLN
S: CHG 9 NLN
S: OUT MIG
```
Server disconnects client

Client opens a connection to 10.0.0.5:1863 (from stored server)
```
C: VER 10 MSNP10 MSNP9 CVR0
S: VER 10 MSNP10
C: CVR 11 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: CVR 11 6.1.0211 6.1.0211 6.1.0155 http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe http://messenger.msn.com
C: USR 12 TWN I example@hotmail.com
S: USR 12 TWN S passport=parameters,neat=huh,lc=1033,id=507
C: USR 13 TWN S $(pp14response.headers.authenticationInfo["from-PP"])
S: USR 13 OK example@hotmail.com 1 0
S: MSG Hotmail Hotmail 465
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: whatever+t+is+in+your+passport+login+ticket+that+you+sent+for+USR+TWN+S$
ClientIP: 192.168.1.111
ClientPort: 18183
ABCHMigrated: 1

C: SYN 14 0 0
S: SYN 14 2024-09-28T17:18:18.6400000-07:00 2024-09-28T17:18:18.6400000-07:00 1 1
S: GTC A
S: BLP AL
S: PRP MFN example%20user
S: PRP PHH 123-4567
S: LSG Other%20Contacts d6deeacd-7849-4de4-93c5-d130915d0042
S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056a4c55b98 11 d6deeacd-7849-4de4-93c5-d130915d0042
S: BPR PHH 1%20444%20222-3333
C: CHG 15 NLN
S: CHG 15 NLN
C: OUT
```
Client disconnects from server
```
S: OUT
```
Server disconnects client