Skip to content

quickstart.md

Latest commit

 

History

History
230 lines (169 loc) · 4.19 KB

quickstart.md

File metadata and controls

230 lines (169 loc) · 4.19 KB

Quick Start

Get up and running with SolScript in minutes.

Create a New Project

solscript new my-project
cd my-project

This creates a new project using the default template (counter):

my-project/
├── src/
│   └── main.sol        # Your contract
├── solscript.toml      # Project configuration
├── .gitignore
└── README.md

Using Templates

SolScript includes templates for common patterns:

# List available templates
solscript new --list

# Create with a specific template
solscript new my-token --template token
solscript new my-nft --template nft

Available templates:

Template Difficulty Description
simple Beginner Minimal contract for learning
counter Beginner Counter with ownership (default)
token Intermediate ERC20-style fungible token
voting Intermediate Decentralized voting system
escrow Advanced Trustless escrow with disputes
nft Advanced ERC721-style NFT collection

Project Structure

solscript.toml

[project]
name = "my-project"
version = "0.1.0"

[contract]
main = "src/main.sol"
name = "MyProject"

[build]
output = "output"

[solana]
cluster = "devnet"

[dependencies]
# Add packages here

src/main.sol

The generated contract template:

contract MyProject {
    @state counter: u64;
    @state owner: Address;

    event CounterIncremented(by: Address, newValue: u64);

    fn init() {
        self.owner = tx.sender;
        self.counter = 0;
    }

    @public
    fn increment() {
        self.counter += 1;
        emit CounterIncremented(tx.sender, self.counter);
    }

    @public
    @view
    fn get_counter(): u64 {
        return self.counter;
    }
}

Build Your Contract

Type Check Only

solscript check src/main.sol

Generate Anchor Code

solscript build src/main.sol

This creates an Anchor project in output/:

output/
├── Anchor.toml
├── Cargo.toml
├── programs/
│   └── solscript_program/
│       └── src/
│           ├── lib.rs
│           ├── state.rs
│           ├── instructions.rs
│           ├── error.rs
│           └── events.rs
└── tests/

Compile to BPF

Via Anchor (default):

solscript build-bpf src/main.sol

Via Direct LLVM (faster, requires LLVM 18):

solscript build-bpf --llvm src/main.sol

This compiles to a deployable Solana program (.so file).

Development Workflow

Watch Mode

Automatically rebuild on file changes:

solscript watch src/main.sol

Format Code

solscript fmt src/main.sol

Run Tests

Add test functions to your contract:

contract MyProject {
    // ... contract code ...

    #[test]
    fn test_increment() {
        increment();
        assert_eq(self.counter, 1, "Counter should be 1");
    }
}

Run tests:

solscript test src/main.sol

Deploy to Solana

Local Development

Start a local validator:

solana-test-validator

Deploy:

solscript deploy src/main.sol --cluster localnet

Devnet

# Ensure you have devnet SOL
solana airdrop 2 --url devnet

# Deploy
solscript deploy src/main.sol --cluster devnet

Common Commands

Command Description
solscript new <name> Create new project from template
solscript new --list List available templates
solscript check <file> Type check only
solscript build <file> Generate Anchor code
solscript build-bpf <file> Compile to BPF (via Anchor)
solscript build-bpf --llvm <file> Compile to BPF (direct LLVM)
solscript test <file> Run tests
solscript deploy <file> Deploy to cluster
solscript watch <file> Watch and rebuild
solscript fmt <file> Format code
solscript doctor Check environment
solscript lsp Start Language Server

Next Steps