Create programs on X1

Basic setup for creating programs on X1 with Anchor

Tutorial

This step-by-step is for terminal. You can also use playground.

Install needed libraries

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

sudo npm install -g yarn

Instal the Solana CLI(Linux)

Install the Solana release v1.18.18 on your machine by running:

sh -c "$(curl -sSfL https://release.solana.com/v1.18.18/install)"

The following output indicates a successful update:

downloading v1.18.19 installerConfiguration: /home/solana/.config/solana/install/config.ymlActive release directory: /home/solana/.local/share/solana/install/active_release* Release version: v1.18.15* Release URL: https://github.com/solana-labs/solana/releases/download/v1.18.15/solana-release-x86_64-unknown-linux-gnu.tar.bz2Update successful

Depending on your system, the end of the installer messaging may prompt you to

Please update your PATH environment variable to include the solana programs:

If you get the above message, copy and paste the recommended command below it to update PATH

You can do this by adding the following line to your $HOME/.profile or /etc/profile (for a system-wide installation):

export PATH="/home/ubuntu/.local/share/solana/install/active_release/bin:$PATH"

Confirm you have the desired version of solana installed by running:

solana --version

After a successful install, solana-install update may be used to easily update the Solana software to a newer version at any time.

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.

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

solana config set -k id0.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.

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

Rust installation link for reference:

Install Rustrustlang

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:

Installation - Docs

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

Change provider to XOLANA RPC

nano Anchor.toml

Change localnet to: https://xolana.xen.network

Set to Xolana network

solana config set -u http://xolana.xen.network:8899

To verify set network, use:

solana config get

Fund wallet

solana aidrop 100

Build project

anchor build

Deploy program

anchor test

Confirm test transaction

solana confirm -v <tx hash>

Or:

https://explorer.xolana.xen.network/

Modify program

cd programs/<project name>/src

nano lib.rs

Go back to original <project name> directory, before building and deploying program again.

If error

instruction 0: account data too small for instruction

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

solana program extend <program id> 15000