Deploy Smart Contracts

​

What you will learn

• Setting up your development environment

• Using create-soon-app template

• Understanding Anchor program structure

• Creating and using Program Derived Addresses (PDAs)

• Connecting an Anchor program to a Next.js UI

• Using Jupiter wallet adapter

​

Prerequisites

For this guide, you will need:

• Node.js and pnpm

• Rust and Cargo

• Anchor CLI

• A SOON compatible wallet

• SOON RPC endpoint

​

Getting Started

​

1. Clone the Repository

# Clone the repository
git clone https://github.com/rkmonarch/soon-app.git

# Navigate to the project directory
cd soon-app

Verify the project structure:

ls

You should see the following structure:

soon-app/
├── anchor-program/     # Solana program written in Anchor
├── src/               # Frontend Next.js application
├── .eslintrc.json
├── .gitignore
├── next-env.d.ts
├── next.config.mjs
├── package.json
├── pnpm-lock.yaml
├── postcss.config.mjs
├── tailwind.config.ts
└── tsconfig.json

​

Understanding the Anchor Program

The Anchor program is located in anchor-program/programs/favorites/src/lib.rs. Let’s break down its key components:

​

Program State

#[account]
#[derive(InitSpace)]
pub struct Favorites {
    pub number: u64,
    #[max_len(50)]
    pub color: String,
    #[max_len(5, 50)]
    pub hobbies: Vec<String>
}

This structure defines what we’ll store on-chain:

• A favorite number (u64)

• A favorite color (string up to 50 chars)

• A list of hobbies (up to 5 hobbies, each up to 50 chars)

​

Program ID Declaration

declare_id!("E6t9eu8HpaFx6PymgHuPPrGwMegFYrCdLa4EeejjE4ji");

​

Instruction Handler

#[program]
pub mod favorites {
    use super::*;

    pub fn set_favorites(
        ctx: Context<SetFavorites>,
        number: u64,
        color: String,
        hobbies: Vec<String>
    ) -> Result<()> {
        let user_public_key = ctx.accounts.user.key();
        msg!(
            "User {user_public_key}'s favorite number is {number}, favorite color is: {color}",
        );
        msg!(
            "User's hobbies are: {:?}",
            hobbies
        ); 

        ctx.accounts.favorites.set_inner(Favorites {
            number,
            color,
            hobbies
        });
        Ok(())
    }
}

​

Account Context

#[derive(Accounts)]
pub struct SetFavorites<'info> {
    #[account(mut)]
    pub user: Signer<'info>,

    #[account(
        init_if_needed, 
        payer = user, 
        space = ANCHOR_DISCRIMINATOR_SIZE + Favorites::INIT_SPACE, 
        seeds=[b"favorites", user.key().as_ref()],
        bump
    )]
    pub favorites: Account<'info, Favorites>,

    pub system_program: Program<'info, System>,
}

​

Building and Deploying

​

1. Install Dependencies

# Install project dependencies
pnpm install

​

2. Configure SOON Network

# Set SOON testnet URL
solana config set --url https://rpc.testnet.soo.network/rpc

# Verify configuration
solana config get

​

3. Prepare Wallet

# Generate new keypair (if needed)
solana-keygen new

# Get testnet SOON tokens from faucet
https://faucet.soo.network/

​

4. Build Anchor Program

# Navigate to anchor directory
cd anchor-program

# Build the program
anchor build

​

5. Get Program ID

# Get program ID from the keypair
solana address -k target/deploy/favorites-keypair.json

​

6. Update Program ID

Update the program ID in:

• lib.rs (declare_id! macro)

• Anchor.toml

​

7. Deploy Program

# Deploy to SOON testnet
anchor deploy

# Verify deployment
solana account <PROGRAM_ID>

​

Frontend Setup

​

Start Development Server

pnpm dev

​

Testing the dApp

1. Connect your SOON wallet

2. Input your favorites:

   • Enter a favorite number

   • Choose a favorite color

   • Add up to 5 hobbies

3. Click “Save Favorites” to store on-chain

4. View the transaction on SOON Explorer

​

Common Issues & Solutions

1. Deployment Failures

   • Ensure sufficient SOON testnet balance

   • Verify RPC endpoint is correct

   • Check program ID matches in all locations

2. Transaction Errors

   • Verify wallet connection

   • Check input validations

   • Ensure proper PDA derivation

3. Build Issues

   • Clean and rebuild: anchor clean && anchor build

   • Verify Rust and Anchor CLI versions

   • Check for any missing dependencies

​

Resources

• SOON Explorer: https://explorer.testnet.soo.network

• Create SOON App: https://github.com/rkmonarch/soon-app