explaingit

solraildev/solrail-core-sdk

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5Setup · hard

TLDR

A privacy MVP for Solana that lets users shield SOL or USDC into a private pool, transfer privately, and unshield back to a public wallet.

Mindmap

mindmap
  root((SolRail))
    What it does
      Shield SOL and USDC
      Private transfers
      Unshield to public wallet
    Tech stack
      Circom
      Anchor
      Solana
      TypeScript SDK
    Use cases
      Private payments
      Wallet integration
      Local dev testing
    Audience
      Solana developers
      Privacy researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Shield SOL or USDC into a private pool before sending it to hide sender, recipient, and amount.

USE CASE 2

Build a wallet or dapp on top of the TypeScript SDK to integrate private Solana transfers.

USE CASE 3

Run the local indexer, relayer, and web wallet to test the full shield and unshield flow.

USE CASE 4

Study a working example of Circom Groth16 join-split circuits paired with Anchor programs.

What is it built with?

TypeScriptCircomAnchorSolanaReact

How does it compare?

solraildev/solrail-core-sdk0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires installing Circom, snarkjs, Anchor, and the Solana toolchain before anything builds.

The README does not state a license, so terms of use are unclear.

In plain English

SolRail is a privacy tool for the Solana blockchain that lets someone shield their SOL or USDC tokens into a private pool, send them privately to someone else while they are inside that pool, and later unshield them back into a normal public wallet. The project is described as an early MVP covering just those three actions: shielding, private transfers, and unshielding. Under the hood it combines several pieces. The privacy guarantees come from zero knowledge circuits built with Circom and a proving system called Groth16, arranged in a join split pattern that takes two inputs and produces two outputs per private transaction. The on chain logic runs as Solana programs written with the Anchor framework, split into a pool program and a separate verifier program. A dedicated crypto package handles the underlying building blocks, including a hash function called Poseidon, the private notes that represent hidden balances, and a Merkle tree used to prove a note exists without revealing which one it is. On top of all this sits a TypeScript SDK for developers to build against, plus an indexer and a relayer service, and a React based wallet app for end users. The README lays out what stays private and what does not. While tokens sit inside the shielded pool, the sender's identity, the recipient's identity, and for private sends even the token type and amount are hidden. What remains visible on chain is the initial deposit into the pool, including who made it and how much, the final withdrawal out of the pool, the pool's total value locked, and general timing information about when transactions happen. Private addresses inside the system use a distinct zkSol prefix so they can be told apart from normal Solana addresses. Beyond a short quick start showing how to install dependencies, build the zero knowledge circuits and Anchor programs, and run the indexer, relayer, and web app locally for development, the README does not go into further detail about the project's design or its current state of completeness.

Copy-paste prompts

Prompt 1
Help me set up SolRail's local dev environment with the indexer, relayer, and web app.
Prompt 2
Explain what stays private versus public on-chain when using SolRail's shielded pool.
Prompt 3
Walk me through building SolRail's Circom circuits and Anchor programs from source.
Prompt 4
Show me how to use the @solrail/sdk TypeScript package to shield and unshield tokens.

Frequently asked questions

What is solrail-core-sdk?

A privacy MVP for Solana that lets users shield SOL or USDC into a private pool, transfer privately, and unshield back to a public wallet.

What language is solrail-core-sdk written in?

Mainly TypeScript. The stack also includes TypeScript, Circom, Anchor.

What license does solrail-core-sdk use?

The README does not state a license, so terms of use are unclear.

How hard is solrail-core-sdk to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is solrail-core-sdk for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.