setup-stellar-contracts

What problem does it solve?

Provides a repeatable, opinionated setup for Soroban/Stellar smart contract projects that removes guesswork about toolchain, CLI, and dependency configuration so developers can start building with OpenZeppelin crates quickly.

Core Features & Use Cases

• Toolchain and CLI setup: Guides installing the Rust toolchain with the wasm32v1-none target and the Stellar CLI required for Soroban development.
• Workspace dependency management: Explains how to pin OpenZeppelin crates in the root Cargo.toml workspace dependencies and reference them in per-contract Cargo.toml files.
• Build and test patterns: Documents code import conventions, common macros and traits, and the commands to build WASM artifacts and run tests.
• Use Case: When creating a new token or governance contract on Soroban, follow these steps to initialize the project, add the exact OpenZeppelin crates, implement the contract patterns, build to WASM, and run unit tests.

Quick Start

Initialize a new Soroban project named my_project, add the OpenZeppelin crates to the root workspace dependencies and each contract's Cargo.toml as workspace dependencies, then build the contract to WASM and run tests.