Introduction

Solnet is Solana's C# SDK designed to integrate seamlessly with the .NET ecosystem for web, mobile, and desktop apps. Whether you're a seasoned developer or just getting started, you'll find examples, docs, and APIs that make Solana development in .NET straightforward.

Features

Full JSON RPC API coverage
Full Streaming JSON RPC API coverage
Wallet and accounts (Phantom and solana-keygen compatible)
Keystore (Phantom and solana-keygen compatible)
Transaction decoding/encoding (base64 and wire format)
Message decoding/encoding (base64 and wire format)
Instruction decompilation
TokenWallet object to send SPL tokens and JIT provisioning of Associated Token Accounts
Programs
- Native Programs
  - System Program
  - Stake Program
- Solana Program Library (SPL)
  - Compute Budget Program
  - Account Compression Program
  - Governance Program
  - StakePool Program
  - Address Lookup Table Program
  - Memo Program
  - Token Program
  - Token Swap Program
  - Associated Token Account Program
  - Name Service Program
  - Shared Memory Program

For maintainability and due to the size/complexity of some other programs, this repository focuses on Solana's Native Programs and SPL programs. For other commonly used programs see:

Maintained by Bifrost

Requirements

.NET 6.0 (deprecated)
.NET 8.0+ (recommended)

Dependencies

BifrostSecurity
Portable.BouncyCastle (optional)

Installation

Use the .NET CLI to install Solnet packages into your project (choose the ones you need):

# Rpc client and streaming
 dotnet add package Solana.Rpc
 dotnet add package Solana.Programs

# Wallets and keys
 dotnet add package Solana.Wallet

# Token helpers
 dotnet add package Solana.Extensions

# Keystore utilities
 dotnet add package Solana.Keystore

Latest Packages on NuGet:

Quickstart

A minimal example to fetch a balance and send a memo:

using Solnet.Rpc;
using Solnet.Rpc.Builders;
using Solnet.Rpc.Types;
using Solnet.Programs;
using Solnet.Wallet;

var rpc = ClientFactory.GetClient(Cluster.MainNet);
var wallet = new Wallet();
var from = wallet.GetAccount(0);

// Get balance
var bal = rpc.GetBalance(from.PublicKey);
Console.WriteLine($"Balance: {bal.Result.Value} lamports");

// Send a simple memo transaction
var blockhash = rpc.GetLatestBlockHash();
var tx = new TransactionBuilder()
    .SetRecentBlockHash(blockhash.Result.Value.Blockhash)
    .SetFeePayer(from)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(MemoProgram.NewMemo(from, "Hello from Solnet"))
    .Build(from);

var sig = rpc.SendTransaction(tx);
Console.WriteLine($"tx: {sig.Result}");

Examples

The Solnet.Examples project contains runnable code examples. Some examples derive accounts from a seed and may fail if an account at a derivation index already exists with the same seed. If you see simulation logs like account address is ... already in use, increment the derivation index (e.g., wallet.GetAccount(index + 1)).

Wallets

The Solnet.Wallet project implements wallet and key generation compatible with both solana-keygen and Phantom.

Initialize a keypair from a secret key

var account = Account.FromSecretKey("");

Initialize a wallet (Phantom-compatible by default)

var wallet = new Wallet("mnemonic words ...", WordList.English);
var account = wallet.GetAccount(10);

Initialize a wallet compatible with solana-keygen

var wallet = new Wallet("mnemonic words ...", WordList.English, "passphrase", SeedMode.Bip39);
var account = wallet.Account; // solana-keygen uses a fixed derivation path

Generating new wallets

var newMnemonic = new Mnemonic(WordList.English, WordCount.Twelve);
var wallet = new Wallet(newMnemonic);

KeyStore

The Solnet.KeyStore project enables secure storage of keys, seeds, and mnemonics. It implements the Web3 Secret Storage Definition and includes SolanaKeyStoreService to read keys generated by solana-keygen.

Secret KeyStore Service

var secretKeyStoreService = new SecretKeyStoreService();
var jsonString = secretKeyStoreService.EncryptAndGenerateDefaultKeyStoreAsJson(password, data, address);

try
{
    var decrypted = KeyStore.DecryptKeyStoreFromJson(password, jsonString);
}
catch (Exception)
{
    Console.WriteLine("Invalid password!");
}

Solana KeyStore Service

var solanaKeyStoreService = new SolanaKeyStoreService();
var wallet = solanaKeyStoreService.RestoreKeystore(filePath, passphrase);

RPC and Streaming RPC

The Solnet.Rpc project contains a full implementation of the Solana JSON RPC.

ClientFactory pattern

var rpcClient = ClientFactory.GetClient(Cluster.MainNet, logger);
var paidClient = ClientFactory.GetClient("https://your.paid.rpc", logger);
var streamingRpcClient = ClientFactory.GetStreamingClient(Cluster.MainNet, logger);

Using the RPC

var accountInfo = rpcClient.GetAccountInfo("5omQJtDUHA3gMFdHEQg1zZSvcBUVzey5WaKWYRmqF1Vj");
var tokenAccounts = rpcClient.GetTokenAccountsByOwner("5omQJtDUHA3gMFdHEQg1zZSvcBUVzey5WaKWYRmqF1Vj");
var wrappedSolAccounts = rpcClient.GetTokenAccountsByOwner(
    "5omQJtDUHA3gMFdHEQg1zZSvcBUVzey5WaKWYRmqF1Vj",
    "So11111111111111111111111111111111111111112");

var serumAddress = "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin";
var programAccounts = rpcClient.GetProgramAccounts(serumAddress);
var filters = new List<MemCmp>() { new MemCmp { Offset = 45, Bytes = OwnerAddress } };
var filteredProgramAccounts = rpcClient.GetProgramAccounts(serumAddress, memCmpList: filters);

Using the Streaming RPC

var txSig = rpcClient.SendTransaction(tx);
var subscription = streamingRpcClient.SubscribeSignature(txSig.Result, (state, response) =>
{
    // handle confirmation
}, Commitment.Finalized);

Sending a transaction

Important: Understanding priority fees

Poorly optimized transactions can get dropped due to high compute demand. Always specify both compute unit limit and price to improve inclusion probability.

var txBuilder = new TransactionBuilder()
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000));

var rpcClient = ClientFactory.GetClient(Cluster.MainNet);
var wallet = new Wallet();
var fromAccount = wallet.GetAccount(0);
var toAccount = wallet.GetAccount(1);
var blockHash = rpcClient.GetLatestBlockHash();

var tx = new TransactionBuilder()
    .SetRecentBlockHash(blockHash.Result.Value.Blockhash)
    .SetFeePayer(fromAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(MemoProgram.NewMemo(fromAccount, "Hello from Sol.Net :)"))
    .AddInstruction(SystemProgram.Transfer(fromAccount, toAccount.PublicKey, 100000))
    .Build(fromAccount);

var firstSig = rpcClient.SendTransaction(tx);

Create, Initialize and Mint

var wallet = new Wallet(MnemonicWords);

var blockHash = rpcClient.GetLatestBlockHash();
var minBalanceForExemptionAcc = rpcClient.GetMinimumBalanceForRentExemption(TokenProgram.TokenAccountDataSize).Result;
var minBalanceForExemptionMint = rpcClient.GetMinimumBalanceForRentExemption(TokenProgram.MintAccountDataSize).Result;

var mintAccount = wallet.GetAccount(21);
var ownerAccount = wallet.GetAccount(10);
var initialAccount = wallet.GetAccount(22);

var tx = new TransactionBuilder()
    .SetRecentBlockHash(blockHash.Result.Value.Blockhash)
    .SetFeePayer(ownerAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(SystemProgram.CreateAccount(
        ownerAccount,
        mintAccount,
        minBalanceForExemptionMint,
        TokenProgram.MintAccountDataSize,
        TokenProgram.ProgramIdKey))
    .AddInstruction(TokenProgram.InitializeMint(
        mintAccount.PublicKey,
        2,
        ownerAccount.PublicKey,
        ownerAccount.PublicKey))
    .AddInstruction(SystemProgram.CreateAccount(
        ownerAccount,
        initialAccount,
        minBalanceForExemptionAcc,
        TokenProgram.TokenAccountDataSize,
        TokenProgram.ProgramIdKey))
    .AddInstruction(TokenProgram.InitializeAccount(
        initialAccount.PublicKey,
        mintAccount.PublicKey,
        ownerAccount.PublicKey))
    .AddInstruction(TokenProgram.MintTo(
        mintAccount.PublicKey,
        initialAccount.PublicKey,
        25000,
        ownerAccount))
    .AddInstruction(MemoProgram.NewMemo(initialAccount, "Hello from Sol.Net"))
    .Build(new List<Account>{ ownerAccount, mintAccount, initialAccount });

Transfer a Token to a new Token Account

var rpcClient = ClientFactory.GetClient(Cluster.MainNet);
var wallet = new Wallet();

var blockHash = rpcClient.GetLatestBlockHash();
var minBalanceForExemptionAcc =
    rpcClient.GetMinimumBalanceForRentExemption(TokenProgram.TokenAccountDataSize).Result;

var mintAccount = wallet.GetAccount(21);
var ownerAccount = wallet.GetAccount(10);
var initialAccount = wallet.GetAccount(22);
var newAccount = wallet.GetAccount(23);

var tx = new TransactionBuilder()
    .SetRecentBlockHash(blockHash.Result.Value.Blockhash)
    .SetFeePayer(ownerAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(SystemProgram.CreateAccount(
        ownerAccount,
        newAccount,
        minBalanceForExemptionAcc,
        TokenProgram.TokenAccountDataSize,
        TokenProgram.ProgramIdKey))
    .AddInstruction(TokenProgram.InitializeAccount(
        newAccount.PublicKey,
        mintAccount.PublicKey,
        ownerAccount.PublicKey))
    .AddInstruction(TokenProgram.Transfer(
        initialAccount.PublicKey,
        newAccount.PublicKey,
        25000,
        ownerAccount))
    .AddInstruction(MemoProgram.NewMemo(initialAccount, "Hello from Sol.Net"))
    .Build(new List<Account>{ ownerAccount, newAccount });

Transaction and Message decoding

var tx = Transaction.Deserialize(txData);
var msg = Message.Deserialize(msgData);
var signedTx = Transaction.Populate(msg, new List<byte[]> { account.Sign(msgData) });

Programs

The Solnet.Programs project contains implementations of several Native and SPL programs. See Solnet.Examples for more depth, including multi-signature operations.

Hello Solana World

var memoInstruction = MemoProgram.NewMemo(wallet.Account, "Hello Solana World, using Solnet :)");

var recentHash = rpcClient.GetLatestBlockHash();

var tx = new TransactionBuilder()
    .SetFeePayer(wallet.Account)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(memoInstruction)
    .SetRecentBlockHash(recentHash.Result.Value.Blockhash)
    .Build(wallet.Account);

Creating and sending tokens to an Associated Token Account

var recentHash = rpcClient.GetLatestBlockHash();

PublicKey associatedTokenAccountOwner = new ("65EoWs57dkMEWbK4TJkPDM76rnbumq7r3fiZJnxggj2G");
PublicKey associatedTokenAccount =
    AssociatedTokenAccountProgram.DeriveAssociatedTokenAccount(associatedTokenAccountOwner, mintAccount);

byte[] txBytes = new TransactionBuilder()
    .SetRecentBlockHash(recentHash.Result.Value.Blockhash)
    .SetFeePayer(ownerAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(30000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(AssociatedTokenAccountProgram.CreateAssociatedTokenAccount(
        ownerAccount,
        associatedTokenAccountOwner,
        mintAccount))
    .AddInstruction(TokenProgram.Transfer(
        initialAccount,
        associatedTokenAccount,
        25000,
        ownerAccount))
    .AddInstruction(MemoProgram.NewMemo(ownerAccount, "Hello from Sol.Net"))
    .Build(new List<Account> { ownerAccount });

string signature = rpcClient.SendTransaction(txBytes);

Creating and extending an Address Lookup Table for a complex transaction

var rpcClient = ClientFactory.GetClient(Cluster.MainNet);
var wallet = new Wallet("mnemonic words ...", WordList.English);

var authorityAccount = wallet.GetAccount(0);
var payerAccount = authorityAccount;

// ALT creation depends on a recent slot and derives the lookup table PDA from
// authority + recentSlot.
ulong recentSlot = rpcClient.GetSlot().Result;
PublicKey lookupTableAddress = AddressLookupTableProgram.DeriveLookupTableAddress(
    authorityAccount.PublicKey,
    recentSlot);

var createBlockHash = rpcClient.GetLatestBlockHash();
byte[] createAltTx = new TransactionBuilder()
    .SetRecentBlockHash(createBlockHash.Result.Value.Blockhash)
    .SetFeePayer(payerAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(60000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(AddressLookupTableProgram.CreateLookupTable(
        authorityAccount.PublicKey,
        payerAccount.PublicKey,
        recentSlot))
    .Build(payerAccount);

string createAltSignature = rpcClient.SendTransaction(createAltTx).Result;

// Wait for confirmation before extending or consuming the table in a v0 transaction.
List<PublicKey> addressesToCache = new()
{
    TokenProgram.ProgramIdKey,
    SystemProgram.ProgramIdKey,
    new PublicKey("So11111111111111111111111111111111111111112"),
    new PublicKey("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL")
};

var extendBlockHash = rpcClient.GetLatestBlockHash();
byte[] extendAltTx = new TransactionBuilder()
    .SetRecentBlockHash(extendBlockHash.Result.Value.Blockhash)
    .SetFeePayer(payerAccount)
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitLimit(60000))
    .AddInstruction(ComputeBudgetProgram.SetComputeUnitPrice(1000000))
    .AddInstruction(AddressLookupTableProgram.ExtendLookupTable(
        lookupTableAddress,
        authorityAccount.PublicKey,
        payerAccount.PublicKey,
        addressesToCache))
    .Build(payerAccount);

string extendAltSignature = rpcClient.SendTransaction(extendAltTx).Result;

// Once confirmed, the table can be referenced from a v0 transaction through
// VersionedTransaction.AddressTableLookups and MessageAddressTableLookup.
var lookupReference = new Message.MessageAddressTableLookup
{
    AccountKey = lookupTableAddress,
    WritableIndexes = System.Array.Empty<byte>(),
    ReadonlyIndexes = new byte[] { 0, 1, 2, 3 }
};

This pattern is useful when a later transaction needs more account addresses than fit comfortably in the legacy message format. In Solnet, you typically create and populate the ALT with TransactionBuilder, wait for confirmation, and then reference it from a VersionedTransaction when building the larger v0 message.

Instruction decoding

var msg = Message.Deserialize(msgBase64);
var decodedInstructions = InstructionDecoder.DecodeInstructions(msg);

Contribution

We encourage everyone to contribute, submit issues and PRs, and join discussions. Every kind of help is welcome.

Legacy Maintainers

Hugo - murlokito
Tiago - tiago

Current Maintainers

Nathan - BifrostTitan

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 353 Commits
.config		.config
.github		.github
assets		assets
docs		docs
src		src
test		test
.editorconfig		.editorconfig
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.rst		CONTRIBUTING.rst
LICENSE		LICENSE
PULL_REQUEST_TEMPLATE.md		PULL_REQUEST_TEMPLATE.md
README.md		README.md
SharedBuildProperties.props		SharedBuildProperties.props
Solnet.sln		Solnet.sln
Solnet.sln.DotSettings		Solnet.sln.DotSettings
build.cake		build.cake
build.ps1		build.ps1
build.sh		build.sh
cake.config		cake.config
changelog.md		changelog.md

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Introduction

Features

Requirements

Dependencies

Installation

Quickstart

Examples

Wallets

Initialize a keypair from a secret key

Initialize a wallet (Phantom-compatible by default)

Initialize a wallet compatible with solana-keygen

Generating new wallets

KeyStore

Secret KeyStore Service

Solana KeyStore Service

RPC and Streaming RPC

ClientFactory pattern

Using the RPC

Using the Streaming RPC

Sending a transaction

Important: Understanding priority fees

Create, Initialize and Mint

Transfer a Token to a new Token Account

Transaction and Message decoding

Programs

Hello Solana World

Creating and sending tokens to an Associated Token Account

Creating and extending an Address Lookup Table for a complex transaction

Instruction decoding

Contribution

Legacy Maintainers

Current Maintainers

License

About

Topics

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Uh oh!

Contributors

Uh oh!

Languages