🚀 Quick Start Guide

Welcome to Arch Network! Let’s get your first program running in under 15 minutes.

Prerequisites

Before starting, ensure you have all required tools and dependencies installed. See the System Requirements page for detailed installation instructions.

Quick checklist:

  • Git (v2.0 or later)
  • Rust (v1.70 or later)
  • Solana CLI tools (v1.16 or later)
  • Arch Network CLI (latest version)

Verify your installation:

# Verify installations
git --version
rustc --version
solana --version
cli --version

⏱️ Time Estimate

  • Total time: ~15 minutes
  • Active time: ~10 minutes
  • Waiting time: ~5 minutes

🚀 Quick Start Project

1. Clone Example Project

# Get the starter example
git clone https://github.com/Arch-Network/arch-examples
cd arch-examples/examples/helloworld

2. Start Local Validator

Development Network (Default)

# Start a local validator
cli validator-start \
    --network-mode devnet \
    --data-dir ./.arch_data \
    --rpc-bind-ip 127.0.0.1 \
    --rpc-bind-port 9002 \
    --titan-endpoint titan-node.dev.aws.archnetwork.xyz \
    --titan-socket-endpoint titan-node.dev.aws.archnetwork.xyz:18443

Building and Deploying Your Program

💡 For a more detailed guide on program development and deployment, see Setting Up a Project.

# Build the program using Solana's BPF compiler
cargo build-sbf

# Deploy to local validator using Arch Network CLI
cli deploy ./target/deploy/helloworldprogram.so

# Note: Save your program ID for later use
export PROGRAM_ID=<DEPLOYED_PROGRAM_ADDRESS>

Testing Your Deployment

💡 For troubleshooting deployment issues, refer to our Troubleshooting Guide.

🎮 Test Your Deployment

💡 For detailed testing strategies and examples, see our Testing Guide.

# Verify program deployment
cli show $PROGRAM_ID

# Get program logs
cli get-logs $PROGRAM_ID

# Get block information
cli get-block <BLOCK_HASH>

Next Steps

Congratulations! You’ve successfully deployed your first program. Here’s what you can explore next:

🌐 Ready for Testnet?

When you’re ready to deploy to testnet:

# Start validator in testnet mode
cli validator-start \
    --network-mode testnet \
    --data-dir ./.arch_data \
    --rpc-bind-ip 127.0.0.1 \
    --rpc-bind-port 9002 \
    --titan-endpoint titan-node.test.aws.archnetwork.xyz \
    --titan-socket-endpoint titan-node.test.aws.archnetwork.xyz:49332

# Deploy program to testnet
cli deploy ./target/deploy/helloworldprogram.so --network-mode testnet

# Verify deployment
cli show <PROGRAM_ADDRESS> --network-mode testnet

💡 Note: Testnet deployments require additional setup and configuration. See our Testnet Guide for details.

📚 Next Steps

🆘 Need Help?