> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soo.network/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={"system"}
# Clone the repository
git clone https://github.com/rkmonarch/soon-app.git

# Navigate to the project directory
cd soon-app
```

Verify the project structure:

```bash theme={"system"}
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

```rust theme={"system"}
#[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

```rust theme={"system"}
declare_id!("E6t9eu8HpaFx6PymgHuPPrGwMegFYrCdLa4EeejjE4ji");
```

### Instruction Handler

```rust theme={"system"}
#[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

```rust theme={"system"}
#[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

```bash theme={"system"}
# Install project dependencies
pnpm install
```

### 2. Configure SOON Network

```bash theme={"system"}
# Set SOON testnet URL
solana config set --url https://rpc.testnet.soo.network/rpc

# Verify configuration
solana config get
```

### 3. Prepare Wallet

```bash theme={"system"}
# Generate new keypair (if needed)
solana-keygen new

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

### 4. Build Anchor Program

```bash theme={"system"}
# Navigate to anchor directory
cd anchor-program

# Build the program
anchor build
```

### 5. Get Program ID

```bash theme={"system"}
# 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

```bash theme={"system"}
# Deploy to SOON testnet
anchor deploy

# Verify deployment
solana account <PROGRAM_ID>
```

## Frontend Setup

### Start Development Server

```bash theme={"system"}
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](https://explorer.testnet.soo.network)

* Create SOON App: [https://github.com/rkmonarch/soon-app](https://github.com/rkmonarch/soon-app)