refactor!: introduces namespacing, error classes and renames legacy types (#14)

* Initial refactoring

Namespaced everything
Json fileds to properties
Enums for types (instead of strings)
DateTime conversion for view models.
PlayerPrefs type safety
Enums formatting

* Added additional editorconfig options for clarity

* Renamed RpcProvider to EthereumWalletProvider.

* Fixed refactor names.

* Additional post refactor fix.

* Dotnet format

* Exception cleanup

* IDisposable for EmbeddedWalletManager so it can properly cleanup listeners.

* Added SafeFireAndForget to Utils since we use it in multiple places.

* PrivyUser is now internal exposing just an interface.

* PR cleanup

Added null‑checks/try‑catches in token helpers and unsubscribed auth event
Corrected .editorconfig key
Hardened README samples
Added InternalError enum & refined OTP error mapping
Used SafeFireAndForget with logging for initialization
Fixed misleading exception message in wallet manager

* PR Feedback EmbeddedWallets -> EmbeddedEthereumWallets

EmbeddedWallets  is deprecated, use EmbeddedEthereumWallets now.

* Updated PrivyUser to use new EmbeddedEthereumWallets

Updated PrivyUser to use new EmbeddedEthereumWallets

* Harden exception handling

Harden exception handling by using numeric status codes instead of parsing string values.

* Update SDK/README.md

Remove extra comment

Co-authored-by: Lucas Lois <lucas.lois@privy.io>

* Update SDK/README.md

Explicit types

Co-authored-by: Lucas Lois <lucas.lois@privy.io>

* Update SDK/README.md

removed internal comment

Co-authored-by: Lucas Lois <lucas.lois@privy.io>

* Doc update

* Update preferred modifier order

* Made TaskExtension internal.

* Remove ms conversion logic.

* Rename CreateWallet -> CreateEthereumWallet

* Renamed CreateWalletAtHdIndex -> CreateEthereumWalletAtHdIndex

* Update enums to reflect OAuth

* Addressed PR feedback.

---------

Co-authored-by: Lucas Lois <lucas.lois@privy.io>

Author: andreydobrikov

.editorconfig

@@ -34,6 +34,13 @@ csharp_space_before_colon_in_inheritance_clause = true
 csharp_space_after_colon_in_inheritance_clause = true
 
 # Expression-level preferences
+
+# prefer auto-properties over manual backing fields
+dotnet_style_prefer_auto_properties = true:suggestion
+
+# prefer expression-bodied members when simple
+csharp_style_expression_bodied_methods = true:suggestion
+
 dotnet_style_object_initializer = true:error
 dotnet_style_collection_initializer = true:error
 
@@ -88,3 +95,6 @@ dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case_style
 
 dotnet_naming_symbols.types.applicable_kinds = class, struct, enum, delegate
 dotnet_naming_symbols.types.applicable_accessibilities = *
+
+# Modifier order preferences
+csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion

CONTRIBUTING.md

@@ -2,11 +2,22 @@
 
 For questions or support, email <support@privy.io>.
 
-## Formatting
 
-This project uses [`dotnet format`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-format)
-with an `.editorconfig` to enforce a consistent C# code style.
-CI will reject pull requests that contain unformatted code.
+### Code style & formatting
+
+We use `dotnet format` together with an `.editorconfig` file to enforce
+consistent C# style and catch simple linting issues. A few rules worth
+highlighting:
+
+* `dotnet_style_prefer_auto_properties = true` – always prefer auto‑properties
+  to manually backed fields.
+* `csharp_style_expression_bodied_methods = true` – use expression
+  bodies for short methods.* Naming rules enforce `PascalCase` for enums, types, constants and public
+  members, and `I` prefix for interfaces.
+
+The `.editorconfig` in the repo contains additional options; see the
+[Microsoft code style documentation](https://learn.microsoft.com/dotnet/fundamentals/code-analysis/code-style-rule-options)
+for a complete list.
 
 **Set up the pre-commit hook** (auto-formats staged files on every commit):
 

SDK/README.md

@@ -30,29 +30,33 @@ If you are contributing to the Privy SDK codebase, **read
 ### Initialization
 
 ```csharp
+using Privy.Core;
+using Privy.Config;
+
 var config = new PrivyConfig{
     AppId = "YOUR_APP_ID",
     ClientId = "CLIENT_ID"
 };
 
+// synchronous initialization – returns the SDK instance immediately
 PrivyManager.Initialize(config);
 ```
 
 ### Check user's authentication state
 
 When the Privy SDK is initialized, it will automatically begin to load its necessary
 dependencies and restoring user session data.
-By awaiting on `GetAuthState` you can ensure the SDK will be ready to use in full
-after returning.
+By awaiting on `GetAuthState` you can ensure the SDK has finished its
+background setup before proceeding; this call will block until initialization completes.
 
 ```csharp
 var authState = await PrivyManager.Instance.GetAuthState();
 
 switch (authState) {
     case AuthState.Authenticated:
         // User is authenticated. Grab the user's linked accounts
-        var privyUser = await PrivyManager.Instance.GetUser();
-        var linkedAccounts = privyUser.LinkedAccounts;
+        var user = await PrivyManager.Instance.GetUser();
+        var linkedAccounts = user.LinkedAccounts;
         break;
     case AuthState.Unauthenticated:
         // User is not authenticated.
@@ -82,21 +86,22 @@ try {
 }
 ```
 
-### PrivyUser
+### PrivyUser (`IPrivyUser`)
+
+The SDK exposes the authenticated user as an interface. Refer to `IPrivyUser` for details.
 
 ```csharp
-PrivyUser user = PrivyManager.Instance.User;
+IPrivyUser user = await PrivyManager.Instance.GetUser();
 ```
-
 ### Creating an Embedded Wallet
 
 ```csharp
 try {
-    PrivyUser privyUser = PrivyManager.Instance.User;
+    IPrivyUser privyUser = await PrivyManager.Instance.GetUser();
 
     if (privyUser != null) {
-        IEmbeddedWallet wallet = await PrivyManager.Instance.User.CreateWallet();
-        Debug.Log("New wallet created with address: " + wallet.address);
+        IEmbeddedEthereumWallet wallet = await privyUser.CreateEthereumWallet();
+        Debug.Log("New wallet created with address: " + wallet.Address);
     }
 } catch {
     Debug.Log("Error creating embedded wallet.");
@@ -107,7 +112,23 @@ try {
 
 ```csharp
 try {
-    IEmbeddedWallet embeddedWallet = PrivyManager.Instance.User.EmbeddedWallets[0];
+    // obtain the current user and ensure they're authenticated
+    IPrivyUser privyUser = await PrivyManager.Instance.GetUser();
+    if (privyUser == null)
+    {
+        Debug.LogWarning("No authenticated user – cannot perform RPC request.");
+        return;
+    }
+
+    // make sure there is at least one embedded wallet available
+    IEmbeddedEthereumWallet[] wallets = privyUser.EmbeddedEthereumWallets;
+    if (wallets == null || wallets.Count == 0)
+    {
+        Debug.LogWarning("No embedded wallets found for user.");
+        return;
+    }
+
+    IEmbeddedEthereumWallet embeddedWallet = wallets[0];
 
     var rpcRequest = new RpcRequest
     {

SDK/Runtime/Analytics/ClientAnalyticsIdRepository.cs

@@ -1,6 +1,8 @@
 using System;
+using Privy.Internal.Storage;
+using Privy.Utils;
 
-namespace Privy
+namespace Privy.Analytics
 {
     public class ClientAnalyticsIdRepository : IClientAnalyticsIdRepository
     {

SDK/Runtime/Analytics/IAnalyticsManager.cs

@@ -1,6 +1,6 @@
 using System.Threading.Tasks;
 
-namespace Privy
+namespace Privy.Analytics
 {
     internal interface IAnalyticsManager
     {

SDK/Runtime/Analytics/IAnalyticsRepository.cs

@@ -1,8 +1,10 @@
 using System;
 using System.Threading.Tasks;
+using Privy.Internal.Networking;
 using Newtonsoft.Json;
+using Privy.Utils;
 
-namespace Privy
+namespace Privy.Analytics
 {
     internal interface IAnalyticsRepository
     {
@@ -12,10 +14,10 @@ internal interface IAnalyticsRepository
     internal class AnalyticsEventRequestData
     {
         [JsonProperty("event_name")]
-        public string EventName;
+        public string EventName { get; set; }
 
         [JsonProperty("client_id")]
-        public string ClientId;
+        public string ClientId { get; set; }
     }
 
     class AnalyticsRepository : IAnalyticsRepository

SDK/Runtime/Analytics/IClientAnalyticsIdRepository.cs

@@ -1,4 +1,4 @@
-namespace Privy
+namespace Privy.Analytics
 {
     public interface IClientAnalyticsIdRepository
     {