cairo-deploy

Cairo Deploy

Reference for deploying Cairo smart contracts to Starknet using sncast (Starknet Foundry).

When to Use

• Deploying contracts to Starknet devnet, Sepolia, or mainnet
• Declaring contract classes
• Setting up deployer accounts
• Configuring network endpoints
• Verifying deployed contracts
• Invoking/calling deployed contracts

When NOT to Use

• Writing or refactoring contract logic (cairo-contract-authoring).
• Unit, integration, or fuzz testing (cairo-testing).
• Gas or performance optimization (cairo-optimization).
• Security review of existing code (cairo-auditor).

Quick Start

1. Build with scarb build, then declare and deploy with sncast.
2. Use skills catalog when the task moves back into authoring, testing, or auditing.

Setup

Install Starknet Foundry

# Install via asdf (recommended for version pinning)
asdf plugin add starknet-foundry
asdf install starknet-foundry 0.56.0
asdf global starknet-foundry 0.56.0

# Or install directly
curl -L https://raw.githubusercontent.com/foundry-rs/starknet-foundry/master/scripts/install.sh | sh
snfoundryup

.tool-versions

Pin versions for reproducible builds:

scarb 2.15.1
starknet-foundry 0.56.0

Note: snforge 0.56.0 requires Scarb >= 2.12.0. Check github.com/foundry-rs/starknet-foundry/releases for the latest.

Build

# Build contracts (generates Sierra + CASM)
scarb build

Output goes to target/dev/:

• myproject_MyContract.contract_class.json (Sierra)
• myproject_MyContract.compiled_contract_class.json (CASM)

Account Setup

Create a New Account

# Generate account on Sepolia
sncast account create \
    --url https://starknet-sepolia.g.alchemy.com/v2/YOUR_KEY \
    --name my-deployer

# This outputs the account address — fund it with ETH/STRK before deploying

# Deploy the account contract
sncast account deploy \
    --url https://starknet-sepolia.g.alchemy.com/v2/YOUR_KEY \
    --name my-deployer