Wallet Quickstart
Developmentwallet-quickstartWallet Quickstart is an Agent Skill for development published in the Nethereum/Nethereum repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Build a multi-platform wallet application using the Nethereum Wallet SDK with MVVM architecture (.NET/C#). Use this skill when the user asks about building a wallet app, Nethereum.Wallet, wallet UI components, MVVM wallet, WalletVault, account management in the wallet SDK, or creating wallet screens in Blazor or MAUI.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Nethereum/Nethereum/blob/HEAD/plugins/nethereum-skills/skills/wallet-quickstart/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/wallet-quickstart, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
| Package | Purpose |
|---|---|
Nethereum.Wallet | Core: accounts, vaults, chains, transactions |
Nethereum.UI | IEthereumHostProvider, SIWE authenticator |
Nethereum.Wallet.UI.Components | Shared MVVM ViewModels |
Nethereum.Wallet.UI.Components.Blazor | Blazor renderer |
Nethereum.Wallet.UI.Components.Maui | MAUI renderer |
Nethereum.Wallet.RpcRequests | EIP-1193 JSON-RPC handlers |
Console Tests / Examples
Working examples in the Nethereum repo:
consoletests/NethereumWCBlazor/— WalletConnect Blazor integrationconsoletests/NethereumReownAppKitBlazor/— Reown AppKit Blazor integrationsrc/demos/Nethereum.Wallet.Blazor.Demo/— Full Blazor wallet demo
For full documentation, see: https://docs.nethereum.com/docs/wallet-sdk/overview