Nethereum 6.0.4

Nethereum 6.0.4 adds the new nethereum-dapp Aspire template for full-stack dApp development (Solidity + C# + Blazor + EIP-6963 wallet), fixes Explorer ABI auto-discovery from Foundry artifacts, resolves blazor.web.js compatibility with .NET 10 NuGet-packaged Razor components, improves EIP-6963 wallet CSS and interop, adds a parallel NuGet build script, and introduces GitHub Actions CI with prerelease publishing.

Full Changelog

Nethereum.Aspire.TemplatePack — New nethereum-dapp Template

New full-stack dApp template creating a complete development environment with 9 projects — Solidity contracts (Foundry), C# typed services (code generation), Blazor WebApp with EIP-6963 wallet integration, embedded TDD and E2E tests, and the full DevChain + Indexer + Explorer infrastructure, all orchestrated by .NET Aspire.

• WebApp with EIP-6963 wallet discovery, chain validation, and wallet_addEthereumChain switching
• Three UI states: not connected → wrong chain → correct chain (deploy/mint/transfer/balance)
• Light-themed CSS with card-based layout, form styling, and wallet CSS custom properties
• Foundry contracts project with starter ERC-20 (MyToken + mint), Forge tests, and deploy scripts
• ContractServices with pre-generated C# typed contract access from Solidity ABI
• Tests project with fast TDD using embedded DevChain (no Docker needed)
• IntegrationTests project for E2E testing against the running AppHost
• LoadGenerator with random mint/transfer/ETH send operations
• Code generation scripts (generate-csharp.ps1 / .sh) invoking Nethereum.Generator.Console
• AppHost configures Explorer ABI auto-discovery from contracts/out/ Foundry artifacts
• Local Explorer App.razor override to fix blazor.web.js compatibility with NuGet-packaged Razor components on .NET 10

Commits: f500fcc0, 818cc8af, 9c68e081, 4828ebda

Nethereum.Aspire.TemplatePack — DevChain Template Fixes

• Fixed project references from old NethereumDevChain_ prefixed names to clean Projects.DevChain, Projects.Indexer, Projects.Explorer
• Updated to async MapDevChainEndpointsAsync() matching library API changes
• Added local Explorer App.razor override for blazor.web.js .NET 10 compatibility
• Updated Aspire version to 13.1.1 in README examples
• Updated default Nethereum version to 6.0.4

Commits: 76c796ef, d348e405, 60e76cc3

Nethereum.Explorer — Runtime Bytecode ABI Matching

The Explorer now automatically discovers contract ABIs by matching on-chain runtime bytecode against locally loaded Foundry/Hardhat artifacts. Previously, FileSystemABIInfoStorage loaded artifacts but only matched by contract address (which required prior registration). Now the AbiStorageService falls back to bytecode-based matching:

1. Fetch on-chain bytecode via eth_getCode
2. Compare against all loaded Foundry artifacts (stripping metadata suffixes)
3. On match: bind the ABI to the contract address, persist to the database, and serve decoded function calls

This means: deploy a contract from the dApp WebApp or via forge script, navigate to its address in the Explorer, and the ABI is available immediately — no manual upload needed.

• Added FileSystemABIInfoStorage and IWeb3 dependencies to AbiStorageService
• New bytecode matching fallback in GetContractAbiAsync after address-based and external source lookups fail
• Registers matched contract address for future direct lookups via RegisterContractAddress
• Persists matched ABI to the Contracts database table

Commits: 6e1921f8

Nethereum.Explorer — Wallet CSS Fix

Fixed wallet button and dropdown styling in the Explorer when using the EIP6963Wallet component with Theme="None". The Blazor scoped CSS from EIP6963Wallet.razor.css had higher specificity than the Explorer's unscoped .no-theme overrides, causing oversized fonts and icons in the navbar.

• Added !important to all .no-theme wallet CSS rules (button, dropdown, icon sizing)
• Compact 0.8rem font, 1.25em icons, proper dropdown positioning now wins over scoped styles

Commits: 6e1921f8

Nethereum.EIP6963WalletInterop — personal_sign Fix

Fixed personal_sign passing a JSON string instead of the raw address parameter, which caused MetaMask to reject the signing request.

Commits: ce721746

Nethereum.DevChain — Hosting Improvements

• Moved hosting extension types from Nethereum.DevChain.Server to the core Nethereum.DevChain library
• Added reusable WebApplicationExtensions for MapDevChainEndpointsAsync() — async endpoint mapping
• Enables any ASP.NET Core host to serve DevChain endpoints without depending on the Server package

Commits: ef3e25ee

Contract Deployment Race Condition Fix

Fixed a race condition where DeployContractAndWaitForReceiptAsync could fail because the contract code wasn't yet available at the deployed address. Now polls eth_getCode to verify the contract is deployed before returning.

Commits: bb5b2209

Wallet Price Refresh & Overflow Fixes

• Price refresh service with two-threshold model for stale/expired prices
• Fixed overflow in ValidateUpperBytes preventing incorrect integer decoding

Commits: 5d391e3a, 2dcb306c

MinimalHdWallet Moved to Nethereum.Accounts

Moved MinimalHdWallet from standalone package to Nethereum.Accounts for .NET 6+ frameworks, reducing dependency count for common wallet operations.

Commits: fbfcbf64, 76e56c0b

SparseMerkleTree Optimisations

Performance improvements to the Sparse Merkle Tree implementation used by the EVM and state verification.

Commits: 4026d4a7

Build & CI

• Version bump: 6.0.0 → 6.0.4
• Herumi native packages: 6.0.2, 6.0.3, 6.0.4 packed to nativeartifacts/
• nuget.bat: Fixed Herumi output path from ..\nativeartifacts to ..\..\nativeartifacts
• nuget-fast.ps1: New parallel PowerShell build script — builds all projects once then packs with --no-build using ForEach-Object -Parallel (PowerShell 7+). Configurable thread count via -MaxParallel.
• GitHub Actions: Updated workflow with .NET 6/8/9/10, MAUI workload, prerelease publishing to GitHub Packages on push to master

Commits: c5830e83

Documentation

• New Aspire Templates documentation section with 12 guides covering the complete developer journey:
• Getting Started: DevChain template, dApp template
• Solidity Development: VS Code setup, writing contracts, Forge testing, Forge deploy
• C# Integration: code generation, unit testing, integration testing
• dApp Development: wallet integration, token interaction UI, Explorer ABI discovery
• Plugin skills: aspire-devchain, aspire-dapp
• Updated global pages: What Do You Want To Do, Component Catalog, Landing Page
• [NethereumDocExample] attribute and tagged tests for core-foundation README examples
• EIP-7702 skill and tagged tests for query-blocks guides
• README rewrites across multiple packages

Commits: 23b931ed, c4dc7ea3, a91964fb, ee9f693c, afd0da8a, cb466c9c, 4d3a7a89

---

All Commits Since 6.0.0

4828ebda Fix template README version references to 6.0.4
9c68e081 Aspire Template Pack: Update README with nethereum-dapp template docs, wallet flow, ABI auto-discovery, and troubleshooting
d348e405 DevChain Template: Add local Explorer App.razor to fix blazor.web.js compatibility with NuGet-packaged Razor components
818cc8af Dapp Template: Add local Explorer App.razor to fix blazor.web.js compatibility with NuGet-packaged Razor components, update templates to default NuGet 6.0.4
bb5b2209 Fix contract deployment race condition by polling eth_getCode (#1082)
ce721746 Fix EIP6963 personal_sign passing JSON string instead of address (#1080)
76c796ef DevChain Template: Fix project references, update to async MapDevChainEndpointsAsync, and update Aspire version to 13.1.1 in README
60e76cc3 Remove old template
63e29eb5 update validate documentation section skill
c5830e83 Bump version to 6.0.4, add Herumi native packages, parallel nuget-fast.ps1 build script, fix nuget.bat Herumi output path, and GitHub Actions CI with prerelease publishing to GitHub Packages
6e1921f8 Explorer: Add runtime bytecode ABI matching for Foundry artifacts and fix wallet CSS specificity with !important overrides for scoped Blazor styles
f500fcc0 Aspire Templates: Add nethereum-dapp template with EIP-6963 wallet chain validation, light-themed WebApp UI, and Foundry contract integration; update DevChain template and template pack to 6.0.4
ef3e25ee DevChain: Move hosting types from Server tool to library, add reusable web extensions
5d391e3a Wallet: Price refresh service with two-threshold model and overflow fixes
3a9f214a Update readme
b3fab9b7 update geth and start bat
8127d576 Project folder LightClient Consensus
2bd97f0e skills update
bbafb371 Readme Update
2dcb306c Adding validate UpperBytes to prevent overflows decoding ints
4026d4a7 SparseMerkleTree optimisations
d106e500 Readme updates
fbfcbf64 Moving MinimalHdWallet to Nethereum.Accounts
76e56c0b MinimalHd Wallet moved to Nethereum.Accounts for frameworks 6 and above
4d3a7a89 examples and docs tagging in tests
cb466c9c Aspire Template Pack
afd0da8a Tests: Fix KeyStore doc examples to use DocSection.Signing
ee9f693c Docs: Add EIP-7702 skill and tag tests for query-blocks and EIP-7702 guides
3f6c490c Intial plugin claude skills
3fc3645b update commit and validate docs sections
a91964fb Skills: Add documentation propagation checks to commit skill
c4dc7ea3 Tests: Add [NethereumDocExample] attribute and tagged tests for all core-foundation README examples
23b931ed README rewrite, org profile, and documentation plan
e8a72ed9 Readme Update