Quickstart

Developing on Atlas will feel familiar if you have experience with Solana. You can use the same libraries and CLI tools, but with one key difference: you'll need to update your RPC URL to the following:

https://testnet.atlas.xyz

1. Install the Solana CLI

You can find the Solana CLI here.

note

We recommend using version 1.18.xx or higher of the Solana CLI to ensure you can deploy programs to Atlas.

2. Request Airdrop

You will need to use the UI testnet faucet to airdrop Sepolia ETH to your wallet.

note

You can find your filesystem wallets pubkey using the following command:

solana address
# or with a custom fs path
solana address -k ~/my_wallet.json

3. Deploy a Program

If you already have a program executable file, you can use the vanilla solana program deploy command shown below to upload new programs to testnet. We recommend that you use the --use-rpc flag, but the deploy script should work regardless as long as the CLI version is up to date.

Terminal

solana program deploy -u "https://testnet.atlas.xyz" $PATH_TO_PROGRAM_SO --program-id $PROGRAM_ID --use-rpc

Replace $PATH_TO_PROGRAM_SO, and $PROGRAM_ID with your own values

warning

Outdated versions of the Solana CLI that deploy programs via UDP or QUIC will not work with Atlas.

Full Deploy Cycle Example

Take a program and deploy it to Atlas. You can try out the deploy cycle by running the following commands:

Terminal

# 1. Clone the SPL Token Program from Solana mainnet
solana program dump -um TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA program.so

# 2. Generate a new program ID for Atlas
solana-keygen new -f -o program-keypair.json -s --no-bip39-passphrase

# 3. Deploy the cloned program to Atlas testnet at the generated address
solana program deploy -u "https://testnet.atlas.xyz" program.so --program-id program-keypair.json

Next Steps

Try out rpcX, Atlas's streamlined read-layer.

Understand the Atlas architecture.

Help

For developer support, join our Discord server: discord.gg/atlas-xyz.