SolanaSdk 1.2.2

SolanaSdk

A comprehensive .NET SDK for Solana blockchain development. Build wallets, sign transactions, derive keys, and integrate with Solana programs using clean, type-safe C# APIs.

Features

Installation

dotnet add package SolanaSdk

Quick Start

Create a New Wallet

using SolanaSdk.Wallet;
using SolanaSdk.Wallet.Bip39;

// Generate a new 24-word wallet
var wallet = new SWallet(WordCount.TwentyFour, WordList.English);

Console.WriteLine($"Mnemonic: {wallet.Mnemonic}");
Console.WriteLine($"Address: {wallet.Account.PublicKey}");

// Sign a message
byte[] signature = wallet.Sign(Encoding.UTF8.GetBytes("Hello Solana!"));

Recover from Mnemonic

string mnemonic = "your twelve word mnemonic phrase goes here ...";
var wallet = new SWallet(mnemonic, WordList.English);

// Derive multiple accounts
var account0 = wallet.GetAccount(0);
var account1 = wallet.GetAccount(1);

Import from CLI Keypair

// From Solana CLI keypair file
var account = SAccount.FromKeypairFile("~/.config/solana/id.json");

// From base58 secret key
var account = SAccount.FromSecretKey("your-base58-secret-key");

// Export back to file
account.SaveKeypairFile("backup.json");

HD Key Derivation

using SolanaSdk.Slip10;

byte[] seed = wallet.DeriveMnemonicSeed();
var slip10 = new Slip10(seed);

// Standard Solana derivation path
var (privateKey, chainCode) = slip10.DerivePath("m/44'/501'/0'/0'");

// Or use the convenience method
var (key, code) = slip10.DeriveSolanaAccount(account: 0, change: 0);

Wallet Discovery

using SolanaSdk.Discovery;

var discovery = new WalletDiscovery();
var result = discovery.Discover(wallet, new DiscoveryOptions
{
    Profile = DiscoveryProfile.All,  // Phantom, Solflare, Ledger
    MaxAccounts = 10
});

foreach (var account in result.Accounts)
{
    Console.WriteLine($"{account.Profile}: {account.Address}");
}

Program Derived Addresses

var programId = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
var seeds = new[] { Encoding.UTF8.GetBytes("metadata") };

if (PublicKey.TryFindProgramAddress(seeds, programId, out var pda, out byte bump))
{
    Console.WriteLine($"PDA: {pda}, Bump: {bump}");
}

Associated Token Accounts

var wallet = new PublicKey("WalletAddress...");
var mint = new PublicKey("TokenMintAddress...");

var ata = AssociatedTokenAccount.GetAddress(wallet, mint);

Vanity Address Generation

// Generate address starting with "Sol"
var result = VanityAddressGenerator.GenerateWithPrefix("Sol");
Console.WriteLine($"Address: {result.Account.PublicKey}");
Console.WriteLine($"Attempts: {result.Attempts}");

// Parallel generation
var result = await VanityAddressGenerator.GenerateWithPrefixAsync("ABC");

SLIP-39 Secret Sharing

using SolanaSdk.Wallet.Slip39;

var sss = new ShamirsSecretSharing(new StrongRandom());

// Create 2-of-3 shares
var shares = sss.GenerateShares(
    extendable: false,
    iterationExponent: 0,
    groupThreshold: 1,
    groups: new[] { new Group(2, 3) },
    passphrase: "",
    masterSecret: walletSeed
);

// Recover from any 2 shares
var recovered = sss.CombineShares(
    new[] { shares[0][0], shares[0][1] },
    passphrase: ""
);

Message Signing

// Standard signing
byte[] signature = account.Sign(messageBytes);

// Off-chain message (Phantom/Solflare compatible)
byte[] signature = account.SignMessage("Sign this message");

// Verification
bool isValid = account.Verify(messageBytes, signature);

Secure Key Management

All key classes implement IDisposable with secure memory clearing:

using (var account = new SAccount())
{
    byte[] signature = account.Sign(message);
} // Key material is securely zeroed

Supported Languages

BIP-39 mnemonics support: English, Japanese, Spanish, French, Chinese (Simplified/Traditional), Portuguese, Czech.

var mnemonic = "あいこくしん あいさつ ...";
var wordList = WordList.AutoDetect(mnemonic); // Returns Japanese

API Reference

Core Classes

• SWallet - BIP-39 HD wallet
• Slip39SWallet - SLIP-39 wallet
• SAccount - Keypair (public + private key)
• PublicKey - 32-byte Ed25519 public key
• PrivateKey - 64-byte Ed25519 private key

Key Derivation

• Slip10 - SLIP-10 Ed25519 HD derivation
• Ed25519Bip32 - BIP-32 style derivation

Utilities

• VanityAddressGenerator - Custom address generation
• AssociatedTokenAccount - ATA derivation
• Keypair - CLI keypair import/export
• SolanaConstants - Program IDs and constants

Requirements

• .NET 8.0+

Links

• GitHub Repository
• Report Issues

License

MIT License - see LICENSE for details.