Documentation Index
Fetch the complete documentation index at: https://docs.solidscipt.zoracle.xyz/llms.txt
Use this file to discover all available pages before exploring further.
The build command is the first step in the SolidScript pipeline. It reads your TypeScript contract files, runs optimizer passes, and writes the equivalent Solidity source to the output directory. The generated .sol files are what downstream commands — compile, verify, and audit — operate on. Use --no-optimize when you need an unmodified baseline for comparison or debugging.
solidscript build <input>
Arguments
| Argument | Description |
|---|
<input> | Path to the directory containing your TypeScript contract files |
Options
| Flag | Description |
|---|
-o, --out <dir> | Output directory for generated Solidity files. Defaults to out/sol |
--no-optimize | Skip optimizer passes and write unoptimized Solidity alongside the standard output |
Output files
| File | Description |
|---|
out/sol/<Contract>.sol | Optimized generated Solidity |
out/sol-unoptimized/<Contract>.sol | Unoptimized output (produced when --no-optimize is set) |
out/sol/<Contract>.sourcemap.json | Source map linking Solidity lines back to TypeScript |
out/sol/<Contract>.optimizations.json | Record of optimizer transformations applied |
Examples
# Build contracts from the contracts/ directory
npx solidscript build contracts
# Build without optimizer passes
npx solidscript build contracts --no-optimize
# Write output to a custom directory
npx solidscript build contracts -o out/generated