Nether.Models 6.1.1

Nethereums.Model

Core Ethereum data models for transactions, blocks, accounts, and cryptographic signatures in Nethereum.

Overview

Nethereum.Model is a foundational package that defines core Ethereum protocol data structures. It is used across the Nethereum ecosystem and covers:

• Transactions (Legacy, EIP-2930, EIP-1559, EIP-7702)
• Block headers
• Account state
• Cryptographic signatures (ECDSA)
• Smart contract event logs

All models support RLP encoding, the serialization format used by Ethereum.

Installation

dotnet add package Nethereum.Model

Dependencies

• Nethereum.RLP --- RLP serialization
• Nethereum.Util --- hashing, address utilities

Key Concepts

Transaction Types

Type Description

Legacy Pre-EIP-155 transactions Legacy + ChainId Replay protection EIP-2930 Access list support EIP-1559 Fee market transactions EIP-7702 Account abstraction

RLP Encoding

Used for: - Network transmission - Hash computation - State storage

Signatures (ECDSA)

• R --- curve point coordinate
• S --- signature proof
• V --- recovery ID + chainId

Chain ID

Used to: - Prevent replay attacks - Identify networks (Mainnet, Polygon, Arbitrum, etc.)

Quick Start

using Nethereum.Model;
using System.Numerics;

var tx = new Transaction1559(
    chainId: 1,
    nonce: 0,
    maxPriorityFeePerGas: BigInteger.Parse("2000000000"),
    maxFeePerGas: BigInteger.Parse("100000000000"),
    gasLimit: 21000,
    receiverAddress: "0x...",
    amount: BigInteger.Parse("1000000000000000000"),
    data: "",
    accessList: null
);

Examples

Legacy Transaction

var tx = new LegacyTransaction(
    to: "0x...",
    amount: new BigInteger(10000000000000000),
    nonce: 0,
    gasPrice: new BigInteger(1000000000000),
    gasLimit: 10000
);

Decode Transaction

var tx = new LegacyTransaction(rlpBytes);
var nonce = tx.Nonce;

Notes

• Always set correct chainId
• Use raw RLP for signing
• Use full RLP for broadcasting
• Post-merge: difficulty = 0, nonce unused

Related Packages

• Nethereum.Signer
• Nethereum.RPC
• Nethereum.Contracts
• Nethereum.Accounts