Latest revision as of 23:28, 20 August 2024

The ACT module handles NNID accounts. This module behaves very similarly to the Wii U implementation (nn::act)

ACT service "act:u"[edit]

These commands are common to both act:u and act:a

Command Header	Available since system-version	Description
0x00010084		Initialize
0x00020040		GetErrorCode
0x00030000		GetLastResponseCode
0x00040000		?
0x00050082		GetCommonInfo
0x000600C2		GetAccountDataBlock/GetAccountInfo
0x00070082		GetResultAsync
0x000800C2		GetMiiImageData
0x00090180		SetNfsPassword
0x000A0040?		?
0x000B0042		AcquireEulaList
0x000C0082		AcquireTimeZoneList
0x000D0040		GenerateUuid
0x000E0080		?
0x000F0140		FindSlotNoByUuid
0x00100000		SaveData
0x00110080		GetTransferableId
0x00120102		AcquireNexServiceToken
0x00130002		GetNexServiceToken
0x00140382		AcquireIndependentServiceToken
0x00150002		GetIndependentServiceToken
0x00160082		AcquireAccountInfo
0x00170084		AcquireAccountIdByPrincipalId
0x00180044		AcquirePrincipalIdByAccountId
0x00190044		AcquireMii
0x001A0042		AcquireAccountInfoEx
0x001B0084		AcquireOtherTypePrincipalID?
0x001C0342		?
0x001D0004		InquireMailAddress
0x001E0082		AcquireEula
0x001F0082		AcquireEulaLanguageList
0x00200382		?
0x00210002		?
0x00220342		?

ACT service "act:a"[edit]

These commands are exclusive to act:a

Command Header	Available since system-version	Description
0x04010080		?
0x04020000		CreateConsoleAccount
0x04030040		CommitConsoleAccount
0x04040080		UnbindServerAccount
0x04050040		DeleteConsoleAccount
0x04060240		?
0x04070000		UnloadConsoleAccount
0x04080080		EnableAccountPasswordCache
0x04090040		SetDefaultAccount
0x040A0040		ReplaceAccountId
0x040B0040		GetSupportContext
0x040C0100		?
0x040D00C0		?
0x040E02C0		?
0x040F0280		?
0x04100040		?
0x04110040		?
0x041207C0		UpdateMii
0x041300C2		UpdateMiiImage
0x04140182		InquireAccountIdAvailability
0x04150EC4		BindToNewServerAccount
0x041602C4		BindToExistentServerAccount
0x041702C4		InquireBindingToExistentServerAccount
0x04180042		?
0x04190042		?
0x041A01C2		AcquireAccountTokenEx
0x041B0142		AgreeEula
0x041C0042		SyncAccountInfo
0x041D0080		?
0x041E0182		UpdateAccountPassword
0x041F0042		ReissueAccountPassword
0x04200180		SetAccountPasswordInput
0x04210042		UploadMii
0x04220042		?
0x04230082		ValidateMailAddress
0x04240044		?
0x04250042		SendConfirmationMail
0x04260044		?
0x04270084		?
0x04280044		ApproveByCreditCard
0x04290082		SendCoppaCodeMail
0x042A0080		?
0x042B01C4		?
0x042C0042		?
0x042D0042		?
0x042E0080		?
0x042F0084		UpdateAccountInfoEx
0x04300044		UpdateAccountMailAddress
0x04310042		?
0x04320042		?
0x04330042		?
0x04340003		?
0x04350042		DeleteServerAccount

This is the service used by regular applications.

Account slots[edit]

Like the friends sysmodule, the ACT module supports multiple accounts internally, although this functionality is not exposed to the users. Unlike the Wii U which supports up to 12 accounts, the 3DS only has 8 account slots.

Some commands require require the account slot as an argument, which is 1-indexed. The value for using the current loaded account is 0xFE.

DataBlocks[edit]

Data blocks can be accessed from specific commands depending on the data that is requested. These follow a similar order to the Wii U ACTInfoTypes.

BlkID	Size	Command needed	Description
0x1	0x1	GetCommonInfo	Number of accounts
0x2	0x1	GetCommonInfo	Current account slot
0x3	0x1	GetCommonInfo	Default account slot
0x4	0x8	GetCommonInfo	?
0x5	0x4	GetAccountInfo	PersistentId
0x6	0x8	GetCommonInfo/GetAccountInfo	CommonTransferableIdBase on GetCommonInfo / TransferableIdBase on GetAccountInfo
0x7	0x60	GetAccountInfo	MiiData
0x8	0x11	GetAccountInfo	AccountId (ASCII NUL-terminated Nintendo Network ID)
0x9	0x101	AcquireAccountInfo	Mail address
0xA	0x4	GetAccountInfo	Birthday {u16 year; u8 month; u8 day;}
0xB	0x3	GetAccountInfo	ASCII NUL-terminated Country Name
0xC	0x4	GetAccountInfo	PrincipalId
0xE	0x1	GetAccountInfo	IsPasswordCacheEnabled
0xF	0x1	GetAccountInfo	Does nothing?
0x11	0xA0	GetAccountInfo	struct{u32 PersistentID; u32 padding; u64 TransferableIDBase; u8[0x60] MiiData; char16_t[0xB] MachinUserName?; char[0x11] AccountID; u8 padding; struct{u16 year; u8 month; u8 day;}Birthday; u32 PrincipalID;}
0x12	0x4	GetAccountInfo	?
0x13	0x1	GetAccountInfo	Gender
0x14	0x1	GetAccountInfo	LastAuthenticationResult
0x15	0x11	GetAccountInfo	AssignedAccountId (ASCII NUL-terminated Nintendo Network ID)
0x16	0x1	GetAccountInfo	ParentalControlSlotNo
0x17	0x4	GetAccountInfo	SimpleAddressId (CountryInfo)
0x19	0x8	GetAccountInfo	UtcOffset
0x1A	0x1	GetAccountInfo	IsCommited
0x1B	0x16	GetAccountInfo	MiiName (NUL-terminated UTF-16 Mii name)
0x1C	0x11	GetAccountInfo	NfsPassword
0x1D	0x1	GetAccountInfo	Bool: if EciVirtualAccount has a value
0x1E	0x41	GetAccountInfo	TimeZoneId (ASCII Time Zone Location)
0x1F	0x1	GetAccountInfo	IsMiiUpdated
0x20	0x1	GetAccountInfo	IsMailAddressValidated
0x21	0x4C	GetAccountInfo	?
0x24	0x1	GetAccountInfo	IsServerAccountDeleted
0x25	0x101	GetAccountInfo	MiiImageUrl (ASCII NUL-terminated URL to account mii image)
0x26	0x4	GetAccountInfo	AssignedPrincipalId
0x27	0x4	GetAccountInfo	? (Only accessible with param[1] = 0xFE)
0x28	0x24	GetAccountInfo	struct{char[0x21] NnasSubDomain?; char[0x3] NnasNfsEnv;}
0x29	0x24	GetCommonInfo	struct{char[0x21] DefaultNnasSubDomain?; char[0x3] DefaultNnasNfsEnv;}
0x2A	0x8	GetCommonInfo	?
0x2B	0x1	GetAccountInfo	FpLocalAccountId
0x2C	0x2	GetAccountInfo	Age
0x2D	0x1	GetAccountInfo	IsEnabledReceiveAds
0x2E	0x1	GetAccountInfo	IsOffDeviceAccessEnabled
0x2F	0x4	GetAccountInfo	Translated SimpleAddressId (CountryInfo)

HTTPS Requests[edit]

With each request, ACT-sysmodule specifies request-header "X-Nintendo-Device-Model". This is the only *dedicated* request-header that's contains anything Old3DS/New3DS specific. This was implemented with 9.0.0-X, and presumably 8.1.0-0_New3DS. The value is from a string initialized during ACT-sysmodule startup. The value-string is the codename string for all 5 of the model values from Cfg:GetSystemModel. When the output from GetSystemModel is >=5(switch statement default case), it runs this: "len = snprintf(outstr, outmaxsize, "3DS-%u", model);"

Trusted Root CAs[edit]

ACT module uses a RootCertChain for all HTTPS requests, the only trusted root CA is default CertID 0x3.

New3DS[edit]

Even though ACT-sysmodule uses ptm:s, it doesn't use CheckNew3DS at all.

@@ Line 74: / Line 74: @@
 | 0x00100000
 |
-| ?
+| SaveData
 |-
 | 0x00110080
@@ Line 135: / Line 135: @@
 |
 | AcquireEulaLanguageList
+|-
+| 0x00200382
+|
+| ?
+|-
+| 0x00210002
+|
+| ?
+|-
+| 0x00220342
+|
+| ?
 |-
 |}
@@ Line 173: / Line 185: @@
 | 0x04070000
 |
-| ?
+| UnloadConsoleAccount
 |-
 | 0x04080080
@@ Line 448: / Line 460: @@
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| Does nothing?
 |-
 | 0x11
@@ Line 468: / Line 480: @@
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| LastAuthenticationResult
 |-
 | 0x15
@@ Line 483: / Line 495: @@
 | 0x4
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| SimpleAddressId? ([[Config_Savegame#CountryInfo|CountryInfo]])
+| SimpleAddressId ([[Config_Savegame#CountryInfo|CountryInfo]])
 |-
 | 0x19
@@ Line 493: / Line 505: @@
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| IsCommited
 |-
 | 0x1B
@@ Line 503: / Line 515: @@
 | 0x11
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| AccountId? (ASCII NUL-terminated Nintendo Network ID)
+| NfsPassword
 |-
 | 0x1D
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| Bool: if EciVirtualAccount has a value
 |-
 | 0x1E
@@ Line 518: / Line 530: @@
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| IsMiiUpdated
 |-
 | 0x20
@@ Line 533: / Line 545: @@
 | 0x1
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| ?
+| IsServerAccountDeleted
 |-
 | 0x25
@@ Line 588: / Line 600: @@
 | 0x4
 | [[ACTU:GetAccountDataBlock|GetAccountInfo]]
-| SimpleAddressId ([[Config_Savegame#CountryInfo|CountryInfo]])
+| [[Cfg:TranslateCountryInfo|Translated]] SimpleAddressId ([[Config_Savegame#CountryInfo|CountryInfo]])
 |}

Difference between revisions of "ACT Services"