Changes

Jump to navigation Jump to search

Friend Services (edit)

Revision as of 20:16, 6 March 2025

4,869 bytes added ,  6 March
→‎Friend Admin Service "frd:a"
Line 1: Line 1:  
[[Category:Services]]
 
[[Category:Services]]
−
= Friend Service "frd:u" =
+
= Friend User Service "frd:u" =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 142: Line 142:  
|-
 
|-
 
| 0x002E0000
 
| 0x002E0000
−
| [[FRDU:GetServerTimeInterval|GetServerTimeInterval]]
+
| [[FRDU:GetServerTimeDifference|GetServerTimeDifference]]
 
|-
 
|-
 
| 0x002F0040
 
| 0x002F0040
Line 169: Line 169:  
|}
 
|}
   −
= "frd:n" =
+
= Friend Network Daemon Service "frd:n" =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 176: Line 176:  
|-
 
|-
 
| 0x00010000
 
| 0x00010000
−
| GetHandleOfNdmStatusChangedEvent
+
| [[FRDN:GetHandleOfNdmStatusChangedEvent|GetHandleOfNdmStatusChangedEvent]]
 
|-
 
|-
 
| 0x00020000
 
| 0x00020000
−
| Resume
+
| [[FRDN:Resume|Resume]]
 
|-
 
|-
 
| 0x00030040
 
| 0x00030040
−
| SuspendAsync
+
| [[FRDN:SuspendAsync|SuspendAsync]]
 
|-
 
|-
 
| 0x00040000
 
| 0x00040000
−
| QueryStatus
+
| [[FRDN:QueryStatus|QueryStatus]]
 
|}
 
|}
   −
= "frd:a" =
+
= Friend Admin Service "frd:a" =
   −
This contains a similar (probably the same) command handler from 0x0001.... to 0x002F.... as them in frd:u. In addition, it also contains
+
Includes all the commands in [[Friend_Services#Friend_User_Service_.22frd:u.22|frd:u]], and, in addition:
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 201: Line 201:  
|-
 
|-
 
| 0x04020040
 
| 0x04020040
−
| ?
+
| [[FRDA:DeleteLocalAccount|DeleteLocalAccount]]
 
|-
 
|-
 
| 0x04030040
 
| 0x04030040
−
| [[FRDA:SetLocalAccountId|SetLocalAccountId]]
+
| [[FRDA:LoadLocalAccount|LoadLocalAccount]]
 
|-
 
|-
 
| 0x04040000
 
| 0x04040000
−
| ?
+
| [[FRDA:UnloadLocalAccount|UnloadLocalAccount]]
 
|-
 
|-
 
| 0x04050000
 
| 0x04050000
−
| Used in creating the user Mii. No cmdbuff parameters.
+
| [[FRDA:SaveLocalAccountData|SaveLocalAccountData]]
 
|-
 
|-
 
| 0x04060042
 
| 0x04060042
Line 216: Line 216:  
|-
 
|-
 
| 0x04070D80
 
| 0x04070D80
−
| AddFriendOffline
+
| [[FRDA:AddFriendOffline|AddFriendOffline]]
 
|-
 
|-
 
| 0x040802C0
 
| 0x040802C0
−
| ?
+
| [[FRDA:UpdateFriendScreenName|UpdateFriendScreenName]]
 
|-
 
|-
 
| 0x04090100
 
| 0x04090100
Line 225: Line 225:  
|-
 
|-
 
| 0x040A0100
 
| 0x040A0100
−
| UpdatePlayingGame
+
| [[FRDA:UpdatePlayingGame|UpdatePlayingGame]]
 
|-
 
|-
 
| 0x040B00C0
 
| 0x040B00C0
−
| UpdatePreferences
+
| [[FRDA:UpdatePreference|UpdatePreference]]
 
|-  
 
|-  
 
| 0x040C0800
 
| 0x040C0800
Line 234: Line 234:  
|-
 
|-
 
| 0x040D0100
 
| 0x040D0100
−
| UpdateFavoriteGame
+
| [[FRDA:UpdateFavoriteGame|UpdateFavoriteGame]]
 
|-
 
|-
 
| 0x040E0040
 
| 0x040E0040
−
| UpdateNcPrincipalId
+
| [[FRDA:SetNcPrincipalId|SetNcPrincipalId]]
 
|-
 
|-
−
| 0x040F...
+
| 0x040F0240
−
| UpdateComment
+
| [[FRDA:UpdateComment|UpdateComment]]
 
|-
 
|-
 
| 0x04100000
 
| 0x04100000
−
| ?
+
| [[FRDA:IncrementMoveCount|IncrementMoveCount]]
 
|}
 
|}
 +
 +
=Save Data=
 +
 +
See [[FRD_Savegame|FRD Savegame]].
    
=HTTPS Requests=
 
=HTTPS Requests=
Line 327: Line 331:  
| 0x14
 
| 0x14
 
| u8 ApplicationArg[20]
 
| u8 ApplicationArg[20]
 +
|}
 +
 +
==Preference==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset !! Size !! Description
 +
|-
 +
| 0x0 || 0x1 || bool IsPublicMode, whether or not the online status is shown
 +
|-
 +
| 0x1 || 0x1 || bool IsShowGameMode, whether or not the currently played game is shown
 +
|-
 +
| 0x2 || 0x1 || bool IsShowPlayedMode, whether or not the play history is shown
 
|}
 
|}
   Line 487: Line 503:  
|}
 
|}
    +
==ServiceLocatorData==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset !! Size !! Description
 +
|-
 +
| 0x0 || 0x4 || [[Friend_Services#NASC_Result|NASC SVCLOC Result]]
 +
|-
 +
| 0x4 || 0x4 || HTTP Status Code
 +
|-
 +
| 0x8 || 0x80 || Service Host (string)
 +
|-
 +
| 0x88 || 0x100 || Service Token (string)
 +
|-
 +
| 0x188 || 0x1 || <code>statusdata</code> from NASC response
 +
|-
 +
| 0x189 || 0x7 || padding
 +
|-
 +
| 0x190 || 0x8 || NEX Timestamp for server time
 +
|}
 +
 +
=Approach Contexts=
 +
The approach context (in the form of an [[Friend_Services#Encrypted_ApproachContext_Payload|encrypted payload]]) of the console can be retrieved using [[FRDU:GetMyApproachContext]].
 +
 +
[[Friend_Services#Encrypted_ApproachContext_Payload|Encrypted payloads]] can be decrypted using [[FRDU:DecryptApproachContext]].
 +
 +
It is possible to add a friend using an [[Friend_Services#Encrypted_ApproachContext_Payload|encrypted payload]] using [[FRDU:AddFriendWithApproach]].
 +
 +
==ApproachContext==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset !! Size !! Description
 +
|-
 +
| 0x0 || 0x48 || [[Friend_Services#Friend_Profile|Friend Profile]] of the console that created this approach context
 +
|-
 +
| 0x48 || 0x1 || bool, Has Mii
 +
|-
 +
| 0x49 || 0x1 || bool, Profanity Flag
 +
|-
 +
| 0x4A || 0x1 || u8, [[Mii#Mii_format|Mii Character Set]]
 +
|-
 +
| 0x4B || 0x70 || [[Friend_Services#Mii_Data|Friend Mii Data]] wrapped using [[APT:Wrap]] (Unwrapped size: 0x60)
 +
|-
 +
| 0xBB || 0x16 || 10-Character UTF-16 Screen Name (10 characters + null termination)
 +
|-
 +
| 0xD1 || 0x10F || unused
 +
|}
 +
 +
==Encrypted ApproachContext Payload==
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset !! Size !! Description
 +
|-
 +
| 0x0 || 0x1 || (u8) unknown, initialized to 1 internally, set to 1 when the PS encryption command succeeds, otherwise 0. Must be 1 when decrypting, otherwise error 0xE0E0C4E9 is returned
 +
|-
 +
| 0x1 || 0x1 || (u8) unknown, always set to 0
 +
|-
 +
| 0x2 || 0x1 || (u8) unknown, initialized to 2 internally, always set to either 1 when the PS encryption command succeeds, or otherwise 0. Must be 1 when decrypting, otherwise error 0xE0E0C4E9 is returned
 +
|-
 +
| 0x3 || 0x1 || (u8) unknown, always set to 0
 +
|-
 +
| 0x4 || 0x4 || u32, Principal ID (part of nonce)
 +
|-
 +
| 0x8 || 0x8 || u64, Friend Code (part of nonce)
 +
|-
 +
| 0x10 || 0x1E0 || [[Friend_Services#ApproachContext|ApproachContext]]
 +
|-
 +
| 0x1F0 || 0x10 || AES-CCM MAC over the encrypted payload at 0x10 thru 0x1F0
 +
|}
 +
 +
==Decrypted ApproachContext Payload==
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset !! Size !! Description
 +
|-
 +
| 0x0 || 0x1 || (u8) unknown, initialized to 1 internally, set to 1 when the PS encryption command succeeds, otherwise 0. Must be 1 when decrypting, otherwise error 0xE0E0C4E9 is returned
 +
|-
 +
| 0x1 || 0x1 || (u8) unknown, always set to 0
 +
|-
 +
| 0x2 || 0x1 || (u8) unknown, initialized to 2 internally, always set to either 1 when the PS encryption command succeeds, or otherwise 0. Must be 1 when decrypting, otherwise error 0xE0E0C4E9 is returned
 +
|-
 +
| 0x3 || 0x1 || (u8) unknown, always set to 0
 +
|-
 +
| 0x4 || 0x1 || bool, Has Mii
 +
|-
 +
| 0x5 || 0x1 || bool, Profanity Flag
 +
|-
 +
| 0x6 || 0x1 || u8, [[Mii#Mii_format|Mii Character Set]]
 +
|-
 +
| 0x7 || 0x1 || padding
 +
|-
 +
| 0x8 || 0x10 || [[Friend_Services#FriendKey|FriendKey]] of the console that created this approach context
 +
|-
 +
| 0x18 || 0x48 || [[Friend_Services#FriendProfile|FriendProfile]] of the console that created this approach context
 +
|-
 +
| 0x60 || 0x60 || [[Friend_Services#Mii_Data|Friend Mii Data]] of the console that created this approach context
 +
|-
 +
| 0xC0 || 0x16 || 10-Character UTF-16 Screen Name (10 characters + null termination)
 +
|-
 +
| 0xD6 || 0x12A || unused
 +
|}
    
= Notification Events =
 
= Notification Events =
Line 498: Line 616:     
==Notification Event Types==
 
==Notification Event Types==
 +
The following event types are accessible to all frd:u and frd:a sessions:
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Value !! Description
−
! Description
+
|-
 +
| 1 || The console went online.
 +
|-
 +
| 2 || The console went offline.
 +
|-
 +
| 3 || A friend is now present (went online).
 
|-
 
|-
−
| 1
+
| 4 || A friend changed their presence, and the current system's JoinGameID is the same as their new or old JoinGameID.
−
| The console went online.
   
|-
 
|-
−
| 2
+
| 5 || A friend changed their Mii.
−
| The console went offline.
   
|-
 
|-
−
| 3
+
| 6 || A friend changed their [[Friend_Services#Profile|Profile]].
−
| A friend is now present (went online).
   
|-
 
|-
−
| 5
+
| 7 || A friend is no longer present (went offline).
−
| A friend changed their Mii.
   
|-
 
|-
−
| 6
+
| 8 || A friend has added you back as a friend (if you had added them before as a "provisionally registered" friend).
−
| A friend changed their [[Friend_Services#Profile|Profile]].
   
|-
 
|-
−
| 7
+
| 9 || A friend sent you an invitation, and the current system's JoinGameID matches that of the friend.
−
| A friend is no longer present (went offline).
+
|}
 +
 
 +
The following values, while signaled internally normally, are not exposed to sessions in any way:
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 8
+
! Value !! Description
−
| A friend has added you back as a friend (if you had added them before as a "provisionally registered" friend).
   
|-
 
|-
−
| 9
+
| 145
−
| A friend sent you a **joinable** game invitation(?) (only signaled when the console's JoinGameID matches that of the friend).
+
| A friend changed their game mode description.
 
|-
 
|-
 
| 146
 
| 146
Line 532: Line 653:  
| 147
 
| 147
 
| A friend changed their personal message.
 
| A friend changed their personal message.
 +
|-
 +
| 148
 +
| A friend changed their presence, but their JoinGameID does not match that of the system.
 
|-
 
|-
 
| 149
 
| 149
−
| A friend sent you an invitation. (signaled regardless of whether the console's JoinGameID matches that of the friend)
+
| A friend sent you an invitation, but their JoinGameID does not match that of the system.
 
|}
 
|}
   Line 638: Line 762:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Value !! 0 !! 1 !! 2 !! 3 !! 4 !! 5 !! 6 !! 7 !! 8 !! 9 !! 10 !! 11 !! 12 !! 13 !! 14 !! 15 !! 16 !! 17 !! 18 !! 19 !! 20 !! 21 !! 22 !! 23 !! 24 !! 25 !! >=26
−
! Server Type Letter
  −
|-
  −
| 0
  −
| L
  −
|-
  −
| 1
  −
| C
  −
|-
  −
| 2
  −
| S
  −
|-
  −
| 3
  −
| D
  −
|-
  −
| 4
  −
| I
  −
|-
  −
| 5
  −
| T
  −
|-
  −
| 6
  −
| U (fallback to default value)
  −
|-
  −
| 7
  −
| J
  −
|-
  −
| 8
  −
| X
  −
|-
  −
| 9
  −
| A
  −
|-
  −
| 10
  −
| B
  −
|-
  −
| 11
  −
| C
  −
|-
  −
| 12
  −
| D
  −
|-
  −
| 13
  −
| E
  −
|-
  −
| 14
  −
| F
  −
|-
  −
| 15
  −
| G
  −
|-
  −
| 16
  −
| H
  −
|-
  −
| 17
  −
| I
  −
|-
  −
| 18
  −
| J
  −
|-
  −
| 19
  −
| K
  −
|-
  −
| 20
  −
| L
  −
|-
  −
| 21
  −
| M
  −
|-
  −
| 22
  −
| N
  −
|-
  −
| 23
  −
| O
  −
|-
  −
| 24
  −
| P
  −
|-
  −
| 25
  −
| Q
   
|-
 
|-
−
| >=26
+
! Letter
−
| U
+
| L || C || S || D || I || T || U (fallback to default value) || J || X || A || B || C || D || E || F || G || H || I || J || K || L || M || N || O || P || Q || U
 
|}
 
|}
TimmSkiller
Trusted
588

edits

Retrieved from "https://www.3dbrew.org/wiki/Special:MobileDiff/22905...23330"

Navigation menu