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

To airdrop Sepolia ETH to your filesystem keypair, run:

Terminal

solana airdrop 0.01 -u "https://testnet.atlas.xyz"

Expected output

Terminal

Requesting airdrop of 0.01 SOL 

Signature: 2Xz9tSJ6xuWxXEjXK4jtJe4E3h4Qdn5GwCcxSNCZeac7fw4EyzQrpBB172TZr3MPvabJPnusEhAxW1uCFRqrkugY

0.01 SOL # Note: the solana CLI uses the "SOL" unit, but on Atlas, the unit is ETH, here 0.01 ETH.

You can also use the UI testnet faucet.

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. Airdrop some testnet tokens to your filesystem keypair.
#    If the airdrop faucet is empty, head to https://faucet.atlas.xyz in your browser.
solana airdrop 0.01 -u "https://testnet.atlas.xyz"

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

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

# 4. 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.