Nethereum Versions Save

EVM simulator (rc1)

• EVM simulator to simulate the outcome and state changes (and optionally trace) a new or existing call / transaction (no gas counter for the time being), and be able to validate state changes, ether transfers. Another aim is to enable users, in the future, to preview state changes when interacting with common contracts or standards like erc20 enabling a bigger trust and avoid unexpected results, also in the future smart contracts could provide the state changes "expectations" to be validated.

"Simple" example of simulating an ERC20 transfer: https://github.com/Nethereum/Nethereum/blob/master/tests/Nethereum.Contracts.IntegrationTests/EVM/EvmSimulatorERC20Tests.cs#L26 "Complex" example of simulating Create2 and Ether transfer fallback transfer and event logs: https://github.com/Nethereum/Nethereum/blob/master/tests/Nethereum.Contracts.IntegrationTests/EVM/WalletForwarderTests/ForwarderTests.cs

• Bytecode utils to disassemble bytecode and check function signatures.

Commits: https://github.com/Nethereum/Nethereum/commit/2e7c254d7f49cdd22bb4854ef2c0816436b7286d, https://github.com/Nethereum/Nethereum/commit/f67b5e64dfff3b8e118efe2de50c01013f78174a, https://github.com/Nethereum/Nethereum/commit/dc4200a6ef3b5a5a703bc82d56f10fe7bd0c2f3c, https://github.com/Nethereum/Nethereum/commit/f576f6645948c3b4e35e1ad2e77bb4edec4dadc5 Nuget: https://www.nuget.org/packages/Nethereum.EVM/1.0.0-rc1

Blockchain Storage upgrade

• 1559 changes applied to all the repositories (Sql server, CosmosDb, EF, Azure Storage, etc)
• SQL server context setup and sql scripts for new testnets Goerli and
• DB Schema can now be configured by text.
• Upgrade to .Net 6 and latest releases Commit Blockchain Storage: https://github.com/Nethereum/Nethereum.BlockchainStorage/commit/60e62b7e47a881519b4c3a5cfc003648c68fd4d3 Commit Nethereum: https://github.com/Nethereum/Nethereum/commit/e4dcf8ee07d8b66503cbd7a4637f41d5f8c35af9 Nugets: https://www.nuget.org/packages?q=nethereum.blockchainstore

Metamask

• Fix on Blazor server side component by @chaeyk in https://github.com/Nethereum/Nethereum/pull/883
• Fix on Blazor server side configure await, commits: https://github.com/Nethereum/Nethereum/commit/90b8f057c918ed189710cf673fc681f874261b44
• Accounts fix in unity js @youtpout in https://github.com/Nethereum/Nethereum/pull/886

ChainIds

• Add Goerli to Chain by @abaines-nextup in https://github.com/Nethereum/Nethereum/pull/881 and adding Sepolia and Optimism https://github.com/Nethereum/Nethereum/commit/d070a282a164fad5926819b54aa1c1f672217cfd

Generator Console

• Adding more frameworks by @boulix3 in https://github.com/Nethereum/Nethereum/pull/888

Smart contracts standards

• Adding methods to retrieve required or optional contract abis or signatures, also include interface support Commit: https://github.com/Nethereum/Nethereum/commit/d6aa2a4705de0c77a71067bfeb5b33efb6380b06

Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.10.0...4.11.0 Nuget Web3: https://www.nuget.org/packages/Nethereum.Web3 All Nugets: https://www.nuget.org/profiles/nethereum

Unity DLLs (attached)

net472UnityCommonAOT Includes all the Common used net472 AOT dlls, if you need extra libraries just copy them from net472dllsAOT. net472dllsAOT: Includes all the net472 AOT dlls, this includes libraries like Nethereum.Geth, Nethereum.Besu etc that are not Common

netStandardMinimalWebglUnityAOT Includes a minimal set of netStandard dlls to work with webgl, it excludes libraries like Nethereum.Web3 and Nethereum.JsonRpc.RpcClient which cannot be used in webgl but instead is required to use Nethereum.Unity with coroutines. netStandardCommonUnityAOT Includes all the Common dlls / libraries used in netstandard AOT, if you need extra libraries just copy them from netStandardUnityCommonAOT. netStandardUnityCommonAOT Includes all the netstandard AOT dlls, this includes libraries like Nethereum.Geth, Nethereum.Besu etc that are not Common, this may include duplicated libraries like UnityEngine or Newtonsoft.Json.dll

net461dllsAOT Includes all the net461 AOT dlls, this includes libraries like Nethereum.Geth, Nethereum.Besu etc that are not Common, this may include duplicated libraries like UnityEngine or Newtonsoft.Json.dll

Note: If you need the net351 dlls for older versions of unity, please let us know in discord.

• Metamask webgl unity component as a separate library. https://github.com/Nethereum/Nethereum/commit/5c8a5bfd9ba092f96be7f95d47f13b7920ed78a7 More info here on why is this necessary here: https://github.com/Nethereum/Nethereum/issues/878#issuecomment-1267158877

• Using cancellationToken instead of or for backwards compatibility include cancellationTokenSource , many thanks to @Pzixel for starting this. https://github.com/Nethereum/Nethereum/commit/7b4e303a908e12c9d3e0f90fa2dfa2be9ba3b895

• TransactionReceipt Polling service accessible from Web3 and polling time configurable instead creating a new instance.

Update Unity https://github.com/Nethereum/Unity3dSampleTemplate.git with Nethereum.Unity.Metamask

Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.9.0...4.10.0

What's Changed

Logging Breaking Change

Migration of Logging from Common.Logging to Microsoft.Extensions.Logging For older versions of .net where Microsoft.Extensions.Logging is not supported a custom ILogger has been created in Nethereum.JsonRpc.Client which anyone can implement for simple logging.

This fixes Unity when there is a namespace conflict with their internal Common libraries (Burst)

https://github.com/Nethereum/Nethereum/commit/8efdef896b3684e3d329d27327d19e7e1b6464d6

Metamask

• Interceptor eth_estimateGas from is required by @Magehernan in https://github.com/Nethereum/Nethereum/pull/875
• Interceptor eth_call to include from if not supplied, use enum ApiMethods instead of strings https://github.com/Nethereum/Nethereum/commit/aad4631538811d332a5c807969a335e99062b41a
• Fixes on blazor interop networkchange https://github.com/Nethereum/Nethereum/commit/3452274cf727385c8edc3ab5eaf7b110f3c1762c

Nethereum.UI

• Nethereum host provider and generic validation attributes https://github.com/Nethereum/Nethereum/commit/2489cbb405ff957cc9421ca7e06d69889da4f0b2

Unity3dSampleTemplate Upgraded Unity3dSampleTemplate to include example of targeting multiple platforms Desktop / Native / Browser to enable code reusability https://github.com/Nethereum/Unity3dSampleTemplate

Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.8.0...4.9.0

• HostWallet, AccountSigning https://github.com/Nethereum/Nethereum/commit/dea0cd09c676ab140e64185f7b29e7174e900381 New Host Wallet RPC methods to enable to interact with hosted wallets or signing messages.
  • New host wallet rpc methods (AddChain, RequestPermissions, GetPermissions
  • New AccountSigning rpc methods for personalSign and TypedData V4, these will be replaced when using an Account or External Account to sign with Nethereum or other External Account provider (ie AzureKeyVault, AWSKeyManager, Trezor, Ledger), but will be sent via rpc when using a hosted wallet.
  • Metamask interceptor changes for v4 and personalSign to add from account

• EIP712

  • Json serialisation and deserialisation of typed messages for encoding / decoding / signing and recovery when sending or receiving messages. https://github.com/Nethereum/Nethereum/commit/17d2eda58ae524e5475074e14c78bedd1b67196a
  • Encoding is part of the the ABI library not the signer library https://github.com/Nethereum/Nethereum/commit/dea0cd09c676ab140e64185f7b29e7174e900381

• AWS Key Manager external signer, this enables signing transactions and messages externally using AWS. https://github.com/Nethereum/Nethereum/commit/b140c4cbeda8255684a86042fbe2ea5e3326caa1 Thanks @Spied001 for the initial port from Azure Key Vault external signer.

• RPC batch support https://github.com/Nethereum/Nethereum/commit/23865fd66725a29651c0289997ac5be5d391913d, example https://github.com/Nethereum/Nethereum/blob/master/tests/Nethereum.Accounts.IntegrationTests/BatchTests.cs

• RPC api update, adding Debug https://github.com/Nethereum/Nethereum/commit/6562c1b79a6bf65da6044bf961984a3589c33cf7, Create Access List https://github.com/Nethereum/Nethereum/commit/841e103776a611f3783b1d5b4dc66532a0003630 and GetProof https://github.com/Nethereum/Nethereum/commit/1cf21db314e2a63c9abfa22575257e41df555d2b

• ENS using Unicode for ENS normalisation (support for emojis and international) https://github.com/Nethereum/Nethereum/commit/f6acc6260129f2893647aad94a6b75104db1ff09

• Fix Blockchain Processing on cancellation if just started (not progress) will error as progress is null. Thanks @FatTigerWang for discovering this and help https://github.com/Nethereum/Nethereum/commit/a71ea3c1a3355b0d0bda48e93c43637ed0dc259d

• Blockchain Storage migrate to 4.8.0 and small fixes https://github.com/Nethereum/Nethereum.BlockchainStorage/commit/49aadd3fa395288bc50bd6fb2d2f4725577fa8a8

Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.7.0...4.8.0

• Unity changes
  • New Unity abi requests code generator https://github.com/Nethereum/Nethereum/commit/3c5545298f35b5606f8d72d1b9eae2ab4a64a052 https://github.com/Nethereum/Nethereum/commit/9784a79810968258d52e4d30f2cfcf97a4f8ce34 https://www.npmjs.com/package/nethereum-codegen
  • Unity support for different clients when using coroutines https://github.com/Nethereum/Nethereum/commit/5dce9579f1435cc8a43af665baa149ab5868d4f3
    • IUnityRpcRequestClient as a generic interface to make rpc requests (http, etc)
    • UnityWebRequestRpcClient specific implemenation for UnityWebRequest
    • UnityRpcRequest the main class that wraps calls to IUnityRpcRequestClient, defaults to UnityWebRequestRpcClient or uses a IUnityRpcRequestClientFactory to create other types of rpc client
    • All Eth RpcRequests now inherit from UnityRpcRequest and accept IUnityRpcRequestClientFactory.
    • All other requests like TransactionSignedUnityRequest, Query calls, Estimate, EthTransfer, Fees calculations etc also accept IUnityRpcRequestClientFactory as a way to initialise their internals requests
    • New Contracts Requests base classes and Factories to simplify the creation of specific requests to query and transact with smart contracts.
  • Unity ERC20, ERC1155, ERC721 requests and factories https://github.com/Nethereum/Nethereum/commit/84095de75199c19f48a8205f06157b9638c206da
  • Metamask integration https://github.com/Nethereum/Nethereum/commit/e4103d643d0328f0cd5cece59f4f04b9825acfea
    • New MetamaskRequestRpcClient implementing IUnityRpcRequestClient, it includes a concurrent dictionary to store and check for callback messages, avoiding having callbacks with SendMessage
    • MetamaskRequestRpcClientFactory implementation of IUnityRpcRequestClientFactory
    • MetamaskTransactionUnityRequest implementation of IContractTransactionUnityRequest and using IUnityRpcRequestClientFactory this after refactoring it does not dependent of Metamask as it is a simple implementation of TransactionSend
    • All the other classes now take use the IUnityRpcRequestClientFactory, NFT helpers also migrated from Nethereum.Unity.Webgl
    • Metamask timeout https://github.com/Nethereum/Nethereum/commit/5ecce4a2c9ad5a5e86d27d5adefa977b032c1e20
    • WebGl template update https://github.com/Nethereum/Nethereum.Unity.Webgl

---

• Fix AdminApiService included on interface https://github.com/Nethereum/Nethereum/commit/0ac7332d0543e2f9162606508babed9cf58dd3a6
• EIP2612TypeFactory https://github.com/Nethereum/Nethereum/commit/4452ad3d122962c5fa5667969559f46dfb8c4bda
• Preset DomainWithNameVersionAndChainId https://github.com/Nethereum/Nethereum/commit/25cc65478a9e1c48109cd04f243e12dcc2b9eb78
• Fix misspelt parameter and field in TransactionReceiptPollingService https://github.com/Nethereum/Nethereum/commit/5d6648646aa57cb1b93b415ce4d494bda74c15dd Thanks @GitHubPang
• Fix BigDecimal Floor should return 0 when precision is 0 or lower https://github.com/Nethereum/Nethereum/commit/5c159ae08073aa0b532e76a125ba186e5f8b8b92
• Update rpc generator Unity https://github.com/Nethereum/Nethereum/commit/6c71ce729b3ceb6e82d1010cbe8f9fb557375b15
• fix #861: last confirmed block equals latest block by @FatTigerWang in https://github.com/Nethereum/Nethereum/pull/862
• Chain Features https://github.com/Nethereum/Nethereum/commit/1980feea3ef67a6cfb343c9517cb970dc49b0235 Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.6.1...4.7.0

NOTE: Unity users netStandardMinimalUnityAOT includes the Metamask jslib to enable the integration.

• Metamask and Metamask Blazor as core library and new updates from the template https://github.com/Nethereum/Nethereum/commit/2b5e96964228a5300375870a4e34b1b3d7ab4a7c Nugets: https://www.nuget.org/packages/Nethereum.Metamask.Blazor https://www.nuget.org/packages/Nethereum.Metamask
• Metamask Template with Siwe support on Wasm, Server side, JWT https://github.com/Nethereum/Nethereum.Metamask.Blazor Note: The template will be updated to use the core packages (and how to customise).
• Proof of Humanity included in core standard contracts, including retrieval of Evidence (User details) from Logs and Ipfs. https://github.com/Nethereum/Nethereum/commit/fc14789aac7c472167206ebe60995476bd45d57e https://github.com/Nethereum/Nethereum/commit/9305a0a0722260a63b6b460846d5f2fc1ff07a94 https://github.com/Nethereum/Nethereum/commit/832f5687e4c1046fbc11063cb1cf1a491b603815 For more info on Proof of Humanity check https://www.proofofhumanity.id/
• ParameterOuput to Json fix https://github.com/Nethereum/Nethereum/commit/d88a11e0720ef310814f6e86bc27db9e17f8105c
• StreamingWebSockets allow for empty responses and retry https://github.com/Nethereum/Nethereum/commit/fe97f53d3ec63308179bf6fd7319ae620c7eb022
• Websockets stopping client https://github.com/Nethereum/Nethereum/commit/313ca634386c428980b8c08046ca38e322471ab2
• WebsocketStreaming add rpc methods and test scenarios https://github.com/Nethereum/Nethereum/commit/bf0f1c0bea39fb89f238bc2b515c01df21c48f52 https://github.com/Nethereum/Nethereum/commit/1dfe394419311f5dee4a166fa194ce4781e90904
• Ether service allow for GasPrice 0 https://github.com/Nethereum/Nethereum/commit/d370e6b12261bb8d9a878757992faf805f957268
• Ipfs publishing updates https://github.com/Nethereum/Nethereum/commit/5fa322327b8a306a07210047f4d15cc262b8faec

Full Changelog: https://github.com/Nethereum/Nethereum/compare/4.5.0...4.6.1

Unity: Use netStandardAOTMinimalUnity.zip for a minimal set of dlls (i.e you just want to use webgl) or net472dllsAOT.zip or netStandardAOT.zip if you want all the dlls (some will be redundant be aware of that) and want to target all platforms

• 1271 Wallet owner validation https://github.com/Nethereum/Nethereum/commit/ade35437b6003eeac2924555845f0cfbedd7f06b
• Siwe Updates
  • Adding support for 1271
  • User service to get registered Users
  • Implementation to check on NFT 721
  • Services and New way to handle storage session (specific interface / in memory storage)
  • Remove signature from SiweMessage
  • Update tests https://github.com/Nethereum/Nethereum/commit/ade35437b6003eeac2924555845f0cfbedd7f06b
• Log Orchestrator fixes https://github.com/Nethereum/Nethereum/pull/825 @scermat
• Merge BlockParameter changes https://github.com/Nethereum/Nethereum/commit/c24083b836d1e2d2c75e0592b213351438ee968d
• Log Orchestrator GetLogsResponse Cancellation: Adding cancellation timeout to GetLogsAsync to enable cancellation on retries https://github.com/Nethereum/Nethereum/commit/938738164fe120108416fbe0c087210b69f0e998
• Solidity multidimensional https://github.com/Nethereum/Nethereum/commit/c281ee8d7a246bad2cad0154bd9d1d5a036781f3
• FeeSugestion logic fix https://github.com/Nethereum/Nethereum/commit/ac5ec8fc610e150bd005ef3ba8e13d14aa9dbf0b @flycarl @dengjia
• Full Change Log with other changes https://github.com/Nethereum/Nethereum/compare/4.4.1...4.5.0

• Nethereum.Optimism L2 project
• Json.net minimum 11.0.2
• DataContracts to JsonProperties
• SiweDates force UTC on parsing
• 1559 fee strategy default to TimePreference
• Simple IPFS publisher of Nethereum dlls (Netstandard 2.0 dlls, used by the Playground)
• BouncyCastle Portable moved to up to 2.0

• Siwe
  • Simplifying date management using the SiweMessage object
  • Adding Session nonce management out of the box examples, InMemory and Simple. InMemory provides the out of the box template for session management, that will only need to replace the storage with a "proper" database session. Simple provides just an interface to generate nonces.
  • Adding a siwe message service, responsible to create messages (complete them) and validation. This could be inherit by another service to create the default message values.
• ERC20, ERC1155, ERC721, ENS now part of contracts project as standards to provide easy access and continue build helper functions for standards.
• ERC20, ERC721 global services with multi calls to retrieve owners, balances
• Log processing single call process services for ERC20 and ERC721 i.e enabling retrieve all transfers ERC20, ERC721 of an account for a contract / set of contracts in a single call (long running or short running, depending on the amount of transfers).
• Update / support latest NBitcoin (used in the HDWallet), Bouncy Castle
• Besu rpc names to lower fix thanks to @tributech-dhofer
• Spelling corrections by @GitHubPang
• TokenList part of ERC20 standard contracts https://tokenlists.org/, to simplify users access of token information, retrieve balances, etc
• Log processing block range changes and defaults to enable bigger weight on failure (too many logs response, retry)
• Multicall upgrade to v3 allowing to flag failures and values
• Multicall to avoid timing out is split into different requests automatically. (default to 3000 calls per request)
• Quorum fixes on data contract deserialisation and adding interfaces to enable mocking
• Simple IpfsHttpService to add files (ie ERC721, ERC1155) including basic authentication support.
• Json.Net, Unity json.net upgrade to 13, generic support up to 13
• Geth admin methods update, fixes s on geth custom eth_call and example,
• Rpc tests to ensure match (where possible) open rpc spec. Rollback "input" to "data" in Call / Transaction as it is not supported across all forks. Rpc dto updates
• Code generator upper case constant / functions to CamelCase, publish again structs outside contract fixes

• Human readable ABI support (similar to ethers)
• EIP712, support for V4 arrays, structs, complex types, builders. Thanks for the fix on signing @tommyliu9
• GnosisSafe support
• MultiSend support
• Siwe core support
• TransactionManager disable calculations and estimation to delegate to MM.
• Error handling (custom, revert) fixes on value access.
• Azure external signer update to new version and legacy support thanks @rubo
• Log processing / blockchain progress
• Code generator fix to bypass views with no output and struct fix with not Contract type on abi.
• Websocket streaming additions to remove deadlocks when reusing the same client. Thanks for all the feedback and help @SnakePin
• Addition to Filtering Logs, thanks @jamescarter-le Api updates +Quorum Api Update (Permission, Debug, Privacy, IBFT, Raft, extension contracts). also now Web3Quorum inherits Web3Geth to include Geth extensions (Admin, etc)
• Parity
• Geth debug (Thanks @coj337 for debug_traceCall)

DLLs attached, if you are starting Unity3d the best option is to use the NetStandardAOT.zip or the NetStandardAOTMinimalUnity.zip