wallet-quickstart

Nethereum Wallet SDK

Build multi-platform self-custodial wallet applications using a layered MVVM architecture with shared ViewModels and platform-specific renderers.

Architecture

Nethereum.Wallet                              Core services
  + Nethereum.Wallet.UI.Components            Shared MVVM ViewModels
  + Nethereum.Wallet.UI.Components.Blazor     Blazor/MudBlazor renderer
    or .Maui                                  .NET MAUI renderer

NuGet packages:

dotnet add package Nethereum.Wallet
dotnet add package Nethereum.Wallet.UI.Components.Blazor

Quick Start

Register Services (Program.cs)

builder.Services.AddNethereumWallet();
builder.Services.AddNethereumWalletBlazorComponents();

Add the Wallet Component

@using Nethereum.Wallet.UI.Components.Blazor
<NethereumWallet />

This gives you the full wallet UI: account creation, vault management, dashboard, and transaction screens.

WalletVault — Encrypted Storage

The WalletVault encrypts all wallet data (private keys, mnemonic seeds) with a user password:

var vault = new WalletVault();
vault.CreateNew("strong-password-here");

Lock and unlock:

vault.Lock();
bool success = vault.Unlock("strong-password-here");

The vault uses AES encryption. The IWalletVaultService abstraction handles platform-specific secure storage.

Account Types

Mnemonic (BIP39/BIP44)

var accountService = new CoreWalletAccountService(vault);
var mnemonicAccount = accountService.CreateMnemonicAccount(
    "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
    password: null,
    accountIndex: 0);

The MnemonicWalletAccountFactory creates accounts with standard derivation paths (m/44'/60'/0'/0/x).

Private Key

var account = accountService.CreatePrivateKeyAccount(
    "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80",
    name: "My Account");

View-Only

var viewOnly = accountService.CreateViewOnlyAccount(
    "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
    name: "Vitalik Watch");

ViewModel Pattern

All wallet screens follow the same MVVM pattern using CommunityToolkit.Mvvm:

public partial class MyScreenViewModel : ObservableObject
{
    [ObservableProperty] private string _fieldName = "";
    [ObservableProperty] private string? _fieldNameError;

    partial void OnFieldNameChanged(string value) => ValidateFieldName();

    private void ValidateFieldName()
    {
        FieldNameError = string.IsNullOrWhiteSpace(FieldName)
            ? _localizer.GetString(Keys.FieldRequired)
            : null;
    }

    public bool IsFormValid => string.IsNullOrEmpty(FieldNameError)
        && !string.IsNullOrWhiteSpace(FieldName);

    [RelayCommand]
    private async Task SaveAsync()
    {
        if (!IsFormValid) return;
        // ...
    }
}

Localisation

Every screen has a Localizer with EN/ES translations:

public class MyScreenLocalizer : ComponentLocalizerBase<MyScreenViewModel>
{
    public static class Keys
    {
        public const string Title = "Title";
        public const string FieldRequired = "FieldRequired";
    }

    protected override void RegisterTranslations()
    {
        _globalService.RegisterTranslations(_componentName, "en-US", new Dictionary<string, string>
        {
            [Keys.Title] = "My Screen",
            [Keys.FieldRequired] = "This field is required",
        });
        _globalService.RegisterTranslations(_componentName, "es-ES", new Dictionary<string, string>
        {
            [Keys.Title] = "Mi Pantalla",
            [Keys.FieldRequired] = "Este campo es obligatorio",
        });
    }
}

Service Registration Pattern

Each feature area registers its services:

public static IServiceCollection AddMyFeatureServices(this IServiceCollection services)
{
    services.AddTransient<MyScreenViewModel>();
    services.AddSingleton<MyScreenLocalizer>();
    services.AddTransient<IComponentLocalizer<MyScreenViewModel>>(provider =>
        provider.GetRequiredService<MyScreenLocalizer>());
    return services;
}

Blazor Component Pattern

@using Nethereum.Wallet.UI.Components.Blazor.Shared
@inject MyScreenViewModel ViewModel
@inject IComponentLocalizer<MyScreenViewModel> Localizer

<WalletFormLayout Title="@Localizer.GetString(Keys.Title)"
                  PrimaryText="@Localizer.GetString(Keys.Save)"
                  OnPrimary="@HandleSave">
    <ChildContent>
        <WalletFormSection Title="@Localizer.GetString(Keys.SectionTitle)">
            <MudTextField @bind-Value="ViewModel.FieldName"
                          Label="@Localizer.GetString(Keys.FieldLabel)"
                          Error="@(!string.IsNullOrEmpty(ViewModel.FieldNameError))"
                          ErrorText="@ViewModel.FieldNameError"
                          Required="true" />
        </WalletFormSection>
    </ChildContent>
</WalletFormLayout>

Hardware Wallet Support

For Trezor integration:

dotnet add package Nethereum.Wallet.UI.Components.Trezor
dotnet add package Nethereum.Wallet.UI.Components.Blazor.Trezor

For Ledger/Trezor on Android MAUI:

dotnet add package Nethereum.Maui.AndroidUsb

Key Packages

Console Tests / Examples

Working examples in the Nethereum repo:

• consoletests/NethereumWCBlazor/ — WalletConnect Blazor integration
• consoletests/NethereumReownAppKitBlazor/ — Reown AppKit Blazor integration
• src/demos/Nethereum.Wallet.Blazor.Demo/ — Full Blazor wallet demo

For full documentation, see: https://docs.nethereum.com/docs/wallet-sdk/overview