Netezos is a cross-platform Tezos SDK for .NET developers, simplifying the access and interaction with the Tezos blockchain.
The following functionality is available:
| Namespace | Description |
|---|---|
| Netezos.Contracts | Tools for interaction with Tezos smart contracts, enabling building/parsing Micheline types from/to human-readable types. |
| Netezos.Encoding | Encoding tools for working with Tezos Micheline, Base58, Hex, etc.. |
| Netezos.Forge | Forging tools for encoding operations into binary format accepting by Tezos nodes. |
| Netezos.Keys | Tools for working with simple and HD keys. Supported curves: ed25519 (tz1), secp256k1 (tz2), nistp256 (tz3), bls12381 (tz4). |
| Netezos.Ledger | Tools for interaction with Tezos Ledger App. This is sort of a legacy package, that is no longer maintained, but still working. |
| Netezos.Rpc | Tezos RPC wrapper |
For full documentation and API Reference, please refer to the Netezos website
Netezos is an open development project so any contribution is highly appreciated, starting from documentation improvements, writing examples of usage, etc. and ending with adding new features (as long as these features do not break existing API or are only intended for one person and for very specific use case).
Do not hesitate to use GitHub issue tracker to report bugs or request features.
Feel free to join our Discord server or Telegram chat. We will be glad to hear any feedback and feature requests and will try to help you with general use cases of the Netezos library.
Let's consider the most common use case - sending a transaction.
PM> Install-Package Netezos
// generate new key
var key = new Key();
// or use existing one
var key = Key.FromBase58("edsk4ZkGeBwDyFVjZLL2neV5FUeWNN4NJntFNWmWyEBNbRwa2u3jh1");
// use the address to receive some tez from faucet
var address = key.PubKey.Address; // tz1SauKgPRsTSuQRWzJA262QR8cKdw1d9pyKusing var rpc = new TezosRpc("https://rpc.tzkt.io/mainnet/");
// get a head block
var head = await rpc.Blocks.Head.Hash.GetAsync<string>();
// get account's counter
var counter = await rpc.Blocks.Head.Context.Contracts[address].Counter.GetAsync<int>();Since our address has just been created, we need to reveal its public key before sending any operation, so that everyone can validate our signatures. Therefore, we need to send actually two operations: a reveal and then a transaction.
Netezos allows you to pack multiple operations into a group and forge/send it as an atomic batch.
var content = new ManagerOperationContent[]
{
new RevealContent
{
Source = address,
Counter = ++counter,
PublicKey = key.PubKey.GetBase58(),
GasLimit = 3500,
Fee = 1000 // 0.001 tez
},
new TransactionContent
{
Source = address,
Counter = ++counter,
Amount = 1000000, // 1 tez
Destination = "tz1KhnTgwoRRALBX6vRHRnydDGSBFsWtcJxc",
GasLimit = 2500,
Fee = 1000 // 0.001 tez
}
};
var bytes = await new LocalForge().ForgeOperationGroupAsync(head, content);// sign the operation bytes
byte[] signature = key.SignOperation(bytes);
// inject the operation and get its id (operation hash)
var result = await rpc.Inject.Operation.PostAsync(bytes.Concat(signature));That is it. We have successfully injected our first operation into the Tezos blockchain.