# Create programs on X1

You can also use [playground](https://beta.solpg.io/). 

This section covers the steps to set up your local environment for X1 development.

## Quick installation

On Linux, run this single command to install all dependencies.

```sh
curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/solana-developers/solana-install/main/install.sh | bash
```

After installation, you should see output similar to the following:

```
Installed Versions:
Rust: rustc 1.84.1 (e71f9a9a9 2025-01-27)
Solana CLI: solana-cli 2.0.26 (src:3dccb3e7; feat:607245837, client:Agave)
Anchor CLI: anchor-cli 0.30.1
Node.js: v23.7.0
Yarn: 1.22.1
```

If the quick installation command above doesn't work, please refer to instructions below to install each dependency individually.

## Install needed libraries

{% code overflow="wrap" %}

```sh
sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev libssl-dev npm
```

{% endcode %}

```sh
sudo npm install -g yarn
```

## Install the Solana CLI(Linux)

The Solana CLI provides all the tools required to build and deploy Solana programs.

Install the Solana CLI tool suite using the official install command:

```sh
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
```

You can replace `stable` with the release tag matching the software version of your desired release (i.e. `v2.0.3`), or use one of the three symbolic channel names: `stable`, `beta`, or `edge`.

If it is your first time installing the Solana CLI, you may see the following message prompting you to add a `PATH` environment variable:

```
Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
```

If you are using a Linux or WSL terminal, you can add the `PATH` environment variable to your shell configuration file by running the command logged from the installation or by restarting your terminal.

```sh
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
```

To verify that the installation was successful, check the Solana CLI version:

```sh
solana-cli 2.0.26 (src:3dccb3e7; feat:607245837, client:Agave)
```

To later update the Solana CLI to the latest version, you can use the following command:

```sh
agave-install update
```

## Create keypair

Using command **solana-keygen** to generate a new wallet. It will generate a 12-word seed (aka. mnemonic, or recovery) phrase. Save it safe.

```sh
solana-keygen new --no-passphrase -o ~/.config/solana/id.json
```

```
solana config set -k ~/.config/solana/id.json
```

## Install rust and cargo

```
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
```

Use the latest stable rust version:

```
rustup update
```

Check version:

```
cargo -V
```

On Linux systems you may need to install libssl-dev, pkg-config, zlib1g-dev, protobuf etc.

{% code overflow="wrap" %}

```
sudo apt-get update
sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang cmake make libprotobuf-dev protobuf-compiler
```

{% endcode %}

Rust installation link for reference:

{% embed url="<https://www.rust-lang.org/tools/install>" %}

## Install anchor

Install **avm** using Cargo. Note this will replace your anchor binary if you had one installed:

```
cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
```

Install the latest version of the CLI using avm, and then set it to be the version to use:

```
avm install latest
avm use latest
```

Verify installation:

```
anchor --version
```

Anchor installation link for reference:

{% embed url="<https://www.anchor-lang.com/docs/installation>" %}

## Create and deploy a program with Anchor

### Initialise a new project

```
anchor init <project name>
```

```
cd <project name>
```

### Display Anchor.toml

```
cat Anchor.toml
```

programs: \<project name> = "program ID"\
cluster = localnet\
wallet = path to wallet\
scripts:  how yarn is used to run a test&#x20;

### Change provider to X1 Testnet RPC

```
nano Anchor.toml
```

Change localnet to: <https://rpc.testnet.x1.xyz>

### Set to X1 testnet&#x20;

```
solana config set -u https://rpc.testnet.x1.xyz
```

To verify set network, use:

```
solana config get
```

### Fund wallet

{% embed url="<https://faucet.testnet.x1.xyz/>" %}

Verify received airdrop:

```
solana balance
```

### Build project

```
anchor build
```

### Deploy program

```
anchor test
```

### Confirm test transaction

```
solana confirm -v <tx hash>
```

Or:

{% embed url="<https://explorer.x1.xyz/>" %}

### Modify program

```
cd programs/<project name>/src
```

```
nano lib.rs
```

Go back to original \<project name> directory, before building and deploying program again.&#x20;

### If error

{% hint style="info" %}
**instruction 0: account data too small for instruction**
{% endhint %}

The byte size is pre-set for initial deployment. You can increase byte size by:

```
solana program extend <program id> 15000
```

## Tutorial

{% embed url="<https://www.youtube.com/watch?v=gnDzOPK8jMc&t>" %}