stellar/laboratory
stellar/laboratory has 112 GitHub stars and 123 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 19:35 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A set of tools that enables developers to try out and learn about the Stellar network.
Web & AppsREADME.md
OriginalStellar Lab (Lab)
The Stellar Lab is an interactive toolkit for exploring the Stellar network. It helps developers and builders experiment with building, signing, simulating, and submitting transactions, as well as making requests to both RPC and Horizon APIs. With built-in tools for saving and sharing transactions, converting between XDR and JSON, and exploring smart contracts on Stellar, the Stellar Lab is ideal for testing, learning, and exploring on Stellar.
Overview
The main branch is deployed to
https://lab.stellar.org/. On the landing page at the
bottom right, you can reference a commit hash of the web app version you're
viewing.
Prerequisites
- Node.js >= 22.23.4: https://nodejs.org/en/blog/release/v22.23.4
- pnpm >= 10.34.9: https://github.com/pnpm/pnpm/releases/tag/v10.34.9
Tech stack
- Next.js framework (React)
- TypeScript
- Stellar Design System for UI
- Sass for CSS styling
- TanStack (React) Query for API queries
- Zustand for state management
- Playwright for e2e tests
- pnpm
Developing
pnpm dev
Network Limits
The Lab automatically fetches Stellar network limits (Mainnet, Testnet, and
Futurenet) before every dev run.
To configure RPC endpoints, edit the NETWORKS array in
scripts/fetch-network-limits.js:
const NETWORKS = [
{ name: "mainnet", rpcUrl: "MAINNET_RPC_URL" },
{ name: "testnet", rpcUrl: "TESTNET_RPC_URL" },
{ name: "futurenet", rpcUrl: "FUTURENET_RPC_URL" },
];
The script generates src/constants/networkLimits.ts with type-safe exports:
import { MAINNET_LIMITS, NETWORK_LIMITS } from "@/constants/networkLimits";
To manually fetch limits: pnpm fetch-limits.
WalletConnect
WalletConnect is offered on mainnet and testnet only, since those are the only
Stellar chains it exposes (stellar:pubnet and stellar:testnet). It uses a
Reown Cloud project ID committed in
src/components/WalletKit/walletConnect.ts.
Testing it locally needs an https origin. From http://localhost, Freighter
mobile approves the session and returns the account, but then refuses to sign,
reporting the domain as not connected. Use a tunnel (see Hardware Wallets below)
or a deployed preview, and add that origin to the Reown project's allowed
domains — the relay rejects unlisted origins outright with
3000 (Unauthorized: origin not allowed). Allowlist changes can take a few
hours to propagate.
Hardware Wallets
Testing hardware wallets requires an HTTPS connection to enable U2F. The
recommended way to do this is with ngrok. Once
downloaded and authenticated, start ngrok, and tell the Lab to start with a
public URL.
./ngrok http 3000
# in a separate terminal
# the subdomain will appear in ngrok's output
pnpm start --public randomsubdomain.ngrok.io
Building for production
pnpm build
The app will be built into the build directory in Next.js' standalone output
format.
To run production build locally this command can be used conveniently:
pnpm start
To distribute and deploy the production build you need to copy the
build/static directory to the build/standalone/public/_next/static location,
and then the files and directories inside the build/standalone directory are
the only files needed for production and can be distributed to the deployment
location.
In the deployment location the following command will run the app:
node server.js
Tracking
To improve Lab, we use Amplitude and Google Analytics tracking in production.
If you are running your version of Lab (for Quickstart, for example), you can
disable the Google Analytics by setting this env variable:
NEXT_PUBLIC_DISABLE_GOOGLE_ANALYTICS=true
No need to disable Amplitude as it runs only on lab.stellar.org.