클러스터

Solana 클러스터 이름, RPC 엔드포인트, faucet 안내입니다.

Solana 클러스터는 validator 네트워크입니다. 앱은 연결할 클러스터를 선택합니다.

지원 클러스터

Vue Solana는 다음 클러스터 이름을 지원합니다.

  • mainnet-beta: Solana mainnet입니다. Solana의 공식 mainnet 클러스터 이름입니다. 프로덕션 앱과 실제 SOL에 사용합니다.
  • devnet: 개발자 네트워크입니다. 앱을 개발할 때 사용합니다. Devnet SOL은 실제 가치가 없습니다.
  • testnet: validator와 프로토콜 테스트 네트워크입니다. 앱 개발에서는 devnet보다 덜 일반적입니다.
  • localnet: 보통 http://127.0.0.1:8899에서 실행되는 로컬 validator입니다.

mainnet이 아니라 mainnet-beta를 사용하세요. Vue Solana는 의도적으로 mainnet 별칭을 추가하지 않습니다.

공식 참고 자료: Solana Clusters

RPC 엔드포인트

RPC 엔드포인트는 앱이 Solana를 읽거나 쓰는 데 사용하는 HTTP URL입니다.

예시:

  • https://api.devnet.solana.com
  • https://api.mainnet-beta.solana.com
  • http://127.0.0.1:8899

@vue-solana/vue/web3, @vue-solana/nuxt/web3, @vue-solana/core/web3Connection 객체는 이 엔드포인트로 RPC 요청을 보냅니다. 공개 엔드포인트는 시작하기에 유용하지만, 프로덕션 앱은 일반적으로 안정성과 rate limit 때문에 전용 RPC provider를 사용합니다.

공식 참고 자료: Solana RPC

WebSocket 엔드포인트

WebSocket 엔드포인트는 subscription과 실시간 업데이트에 사용됩니다. wsEndpoint를 명시적으로 전달하지 않으면 Vue Solana가 RPC 엔드포인트에서 WebSocket 엔드포인트를 유도합니다.

예시:

  • wss://api.devnet.solana.com
  • wss://api.mainnet-beta.solana.com
  • ws://127.0.0.1:8900

클러스터 설정

Vue:

createSolanaPlugin({
  cluster: "devnet",
});

Nuxt:

export default defineNuxtConfig({
  modules: ["@vue-solana/nuxt"],
  solana: {
    cluster: "devnet",
  },
});

커스텀 엔드포인트도 전달할 수 있습니다.

createSolanaPlugin({
  cluster: "mainnet-beta",
  endpoint: "https://your-rpc.example.com",
  commitment: "confirmed",
});

Devnet 또는 Testnet SOL 받기

공식 faucet을 사용하세요.

https://faucet.solana.com

Devnet 또는 Testnet을 선택하고 지갑 주소를 붙여 넣은 뒤 SOL을 요청합니다.

Solana CLI가 설치되어 있다면 airdrop도 요청할 수 있습니다.

solana airdrop 1 YOUR_WALLET_ADDRESS --url devnet
solana airdrop 1 YOUR_WALLET_ADDRESS --url testnet

Devnet과 testnet SOL은 실제 가치가 없습니다. 테스트 중에는 실제 자금이 있는 지갑을 절대 사용하지 마세요.