stellar/stellar-dev-skill

Overview

This skill is an end-to-end Stellar development playbook focused on Soroban-first smart contract development, client SDK patterns, wallet integration, and secure production practices. It consolidates recommended stacks, testing strategies, and common pitfalls for building payments, tokenization, DeFi, and privacy-aware apps on Stellar. Use it as a hands-on guide for architecting, implementing, and hardening Stellar dApps across Rust, JavaScript, Python, and Go.

How this skill works

The skill classifies tasks into contract, client, frontend/wallet, asset, testing, and infrastructure layers, then prescribes concrete tools and workflows for each. It recommends Soroban (Rust) for on-chain logic, stellar-sdk for client work, Stellar RPC as the primary API, and Stellar Assets as the default token strategy with SAC interop where needed. It also provides testing recipes (local Quickstart, Testnet), wallet flows (Freighter, Wallets Kit), and security hardening notes.

When to use it

• Building Soroban smart contracts or integrating WASM contracts into dApps
• Implementing browser or backend apps using JavaScript, Python, or Go SDKs
• Issuing, managing, or bridging tokens using Stellar Assets or SAC
• Integrating user wallets and signature flows (Freighter, Wallets Kit)
• Designing privacy-aware features (zk proofs, privacy pools) on Stellar

Best practices

• Prefer Soroban for custom on-chain logic and Stellar Assets for standard fungible tokens
• Use Stellar RPC for real-time state and Horizon only for legacy historical queries
• Always specify network passphrase, source account, sequence, and correct fee/resource limits
• Run unit tests via native compilation and integration tests on local Quickstart or Testnet
• Limit contract size, optimize release builds, and audit authorization and storage usage

Example use cases

• Deploy a Soroban contract that mints a managed token and exposes governance hooks
• Build a React dApp that connects with Freighter, constructs transactions, and invokes contracts
• Issue a regulated asset via classic issuance with trustlines and automate KYC off-chain
• Create a privacy pool using ZK verification patterns and Merkle-based membership proofs
• Run CI that compiles contracts to WASM, deploys to local Quickstart, and runs end-to-end tests