솔라나 토큰 홀더 스냅샷

홀더 스냅샷은 특정 순간에 어떤 토큰을 보유한 모든 지갑과 각 지갑의 보유량을 정리한 목록입니다. 솔라나에서는 이 목록이 토큰 계정에서 만들어집니다. 토큰을 한 번이라도 받은 지갑은 그 민트에 대한 토큰 계정을 갖게 되고, 잔액은 그 계정에 저장됩니다. 스냅샷은 이 계정들을 훑어 소유 지갑별로 묶고 합계를 기록합니다.

스냅샷이라는 말이 중요합니다. 살아 있는 토큰의 잔액은 매초 움직이므로 목록은 찍은 순간에만 참입니다. 에어드롭 자격이나 투표 가중치처럼 이 목록에 의존하는 결정은 그 순간에 고정해야 하고, 가능하면 미리 공지해서 나중에 토큰을 옮겨 유리하게 만드는 일을 막는 것이 좋습니다.

이 페이지는 자체 인덱서나 RPC 구독, 스크립트 없이 그 목록을 만들어 줍니다. 같은 홀더 스캔이 이미 DexLab 멀티센더의 토큰 홀더 수령자 소스를 움직이고 있으며, 여기서는 전송 전에 목록을 살펴보고 내보낼 수 있도록 따로 열어 둔 것입니다.

대부분의 팀은 토큰의 생애에서 네 번 홀더 목록이 필요합니다.

• 에어드롭과 보상. 커뮤니티 에어드롭, 로열티 보상, 소급 배분은 모두 특정 날짜에 누가 토큰을 들고 있었는지에서 시작합니다. 스냅샷을 찍고 최소 보유량으로 먼지 지갑을 걸러낸 뒤 멀티센더에 넘기면 됩니다.
• 거버넌스. 보유량에 가중치를 두는 투표는 고정된 투표자 목록이 필요합니다. 공지한 시각에 스냅샷을 찍으면 가중치가 고정되어, 투표를 위해 토큰을 빌렸다가 돌려주는 방식이 통하지 않습니다.
• 마이그레이션. 토큰이 새 민트로 옮겨갈 때, 예를 들어 기존 SPL 민트에서 전송 수수료나 메타데이터 확장이 있는 Token-2022 민트로 옮길 때, 옛 홀더 목록이 곧 새 토큰을 보유 비율대로 받아야 할 지갑 목록입니다.
• 런치 풀과 상장. 유동성 풀을 만들거나 상장을 신청하기 전에 심사자가 묻는 숫자는 홀더 수와 상위 지갑 집중도입니다. 위에 표시되는 상위 10명, 상위 50명 비중이 바로 그 숫자입니다.

어느 경우든 스냅샷은 보관해야 할 기록입니다. 찍는 순간 CSV를 내려받으세요. 다시 돌아왔을 때는 실시간 목록이 이미 바뀌어 있습니다.

솔라나는 잔액을 지갑 자체에 저장하지 않습니다. 지갑이 보유한 민트마다 별도의 토큰 계정이 있고, 보통은 지갑과 민트에서 파생된 연관 토큰 계정이 수량을 기록합니다. 한 지갑이 같은 민트의 토큰 계정을 여러 개 가질 수도 있어서, 이 도구는 계정 수를 세지 않고 소유자별로 모든 계정을 합산합니다. 홀더 수는 잔액이 있는 서로 다른 소유자의 수이지 계정 수가 아닙니다.

온체인 수량은 가장 작은 단위, 즉 기본 단위의 정수입니다. 민트가 소수점 자릿수를 선언하고, 사람이 읽는 잔액은 원시 수량을 10의 그 거듭제곱으로 나눈 값입니다. 소수점 9자리 민트는 1.5개 토큰을 1,500,000,000으로 저장합니다. 이 도구는 민트 계정에서 직접 자릿수를 읽으므로 표와 CSV의 잔액은 전송 명령이 쓰는 것과 같은 자릿수로 변환되며, CSV에는 사람이 읽는 잔액과 기본 단위 원시값이 함께 들어 있어 스크립트는 자릿수를 몰라도 됩니다.

Token-2022 민트도 같은 방식으로 처리됩니다. 도구는 민트 계정을 소유한 프로그램이 기존 SPL Token 프로그램인지 Token-2022 프로그램인지 확인해 요약 옆에 표시합니다. Token-2022 민트의 토큰 계정은 그 프로그램 아래에 있고, 홀더 스캔은 기존 민트와 같은 방법으로 읽습니다. 전송 수수료나 전송 훅 같은 확장은 지갑의 잔액을 바꾸지 않으므로 스냅샷도 바꾸지 않습니다. 확장이 중요해지는 것은 나중에 보낼 때이며, 멀티센더가 감지한 프로그램의 transfer-checked 명령으로 이를 처리합니다.

스캔 자체는 DexLab API의 Helius getTokenAccounts 메서드를 사용해 민트의 모든 토큰 계정을 훑습니다. 잔액이 0인 계정은 묶기 전에 제외되므로, 한때 보유했다가 전부 판 지갑은 홀더로 표시되지 않습니다.

CSV 내려받기 버튼은 머리글 한 줄과 홀더당 한 줄로 된 UTF-8 파일을 만듭니다. 최소 보유량 필터를 적용한 뒤 표에 보이는 순서대로, 보유량이 큰 순서입니다. 열은 다음과 같습니다.

• rank: 1부터 시작하는 순위.
• owner: 토큰 계정을 소유한 지갑 주소(base58). 에어드롭을 보낼 주소는 토큰 계정 주소가 아니라 이 주소입니다.
• balance: 민트의 소수점 자릿수로 변환한 사람이 읽는 수량. 지수 표기나 끝자리 0 없이 기록됩니다.
• raw_balance: 같은 수량의 기본 단위 정수값.
• share_percent: 스냅샷에 있는 모든 지갑의 총합 대비 이 지갑의 비중, 소수점 4자리.

내보내기는 잘리지 않습니다. 이 페이지의 표는 최대 1,000줄까지만 그립니다. 링크가 달린 지갑 1만 개를 그리면 휴대폰에서 스크롤조차 힘들기 때문입니다. 하지만 CSV에는 필터를 거친 모든 홀더가 담깁니다.

파일 이름에는 민트 앞 8자와 날짜가 들어가 스냅샷 폴더가 읽기 쉽게 유지됩니다. 내보내기는 멀티센더가 불러오는 것과 같은 홀더 목록을 쓰므로, 여기서 받은 CSV를 스프레드시트에서 다듬고 수량 열을 붙여 멀티센더에 수령자 파일로 올릴 수 있습니다.

이 도구의 스냅샷이 알려 줄 수 있는 것과 없는 것은 다섯 가지 한계로 정해집니다.

• 특정 시점. 목록은 체인을 읽은 순간에만 참입니다. 그때 CSV를 받고 요약 아래 표시된 시각을 기록하세요.
• 60분 캐시. DexLab API는 민트별 홀더 목록을 60분 동안 캐시합니다. 그 안에 스냅샷 찍기를 다시 눌러도 같은 목록이 돌아오며, 그래서 이 도구는 폴링하지 않습니다. 더 새 목록이 필요하면 캐시 시간이 지나기를 기다리세요.
• 토큰 계정 10,000개 스캔 한도. 스캔은 1,000개짜리 페이지를 최대 10장 읽고 멈춥니다. 계정이 그보다 많은 민트는 한도 도달로 표시되고 표 위에 안내가 붙으며, 목록에는 스캔이 도달한 지갑만 담깁니다. 이 페이지들은 보유량 순이 아니라 RPC가 돌려주는 순서대로 읽히므로, 한도에 걸린 목록은 상위 홀더 목록이 아니라 홀더의 큰 표본입니다. 홀더가 수십만 명인 토큰이라면 전수 조사로도, 상위 홀더 목록으로도 보지 마세요.
• 정수는 일정 크기까지만 정확합니다. 잔액은 API에서 JSON 숫자로 전달되며, 약 9,000조 기본 단위 아래에서만 정확합니다. 소수점 9자리 토큰은 대략 900만 개 지점에서 그 선을 넘고, 그보다 큰 잔액은 마지막 몇 자리가 반올림됩니다. 배분에서 문제가 될 크기는 아니지만, raw_balance는 체인 값을 그대로 옮긴 사본이 아니라 정확한 근사값으로 읽어야 하는 이유입니다.
• 풀과 프로그램 필터 없음. API는 어떤 소유자가 유동성 풀, 볼트, 기타 프로그램인지 표시하지 않고, 이 도구도 추측하지 않습니다. 큰 풀과 거래소 지갑은 보통 목록 상단에 있으니, 에어드롭에서 제외해야 한다면 CSV에서 주소로 지우세요.

이 한계들은 지갑과 무관합니다. 홀더 읽기는 공개 조회이며, 에어드롭을 선택하기 전까지는 아무것도 서명되거나 전송되지 않습니다.

이 홀더들에게 에어드롭 버튼을 누르면 같은 민트가 선택되고 토큰 홀더 수령자 소스가 이미 골라진 상태로 DexLab 멀티센더가 열립니다. 거기서 보낼 지갑을 연결하고, 홀더당 수량 또는 보유 비율대로 나눌 총량을 정한 뒤 홀더 불러오기를 누르세요. 여기서 입력한 최소 보유량은 링크를 타고 넘어가 멀티센더의 최소 보유량 칸에 그대로 채워지며, 불러오기 전에 올리거나 내리거나 지울 수 있습니다. 멀티센더가 수령자 목록을 채우고 본인 지갑은 제외하며, 토큰 계정이 아직 없는 수령자가 몇 명인지 세고 네트워크 비용을 추정하는 사전 점검을 실행합니다.

솔라나 메인넷의 멀티센더 서비스 수수료는 단순합니다. 처음 20명은 무료이고, 이후 1명당 0.001 SOL이며, 배치 하나가 0.3 SOL을 넘게 내는 일은 없습니다. 네트워크 수수료와 새 토큰 계정 임대료는 보내는 지갑이 솔라나에 별도로 지불합니다. 데브넷 전송은 완전히 무료라서 실제로 쓰기 전에 배분을 연습할 수 있습니다.

스냅샷을 찍은 토큰이 아니라 다른 토큰, 예를 들어 메인 토큰 홀더에게 보상 토큰을 보내고 싶다면 여기서 CSV를 받아 owner 열만 남기고 수량 열을 추가한 뒤 멀티센더에 파일로 올리세요. 수령자 목록은 어느 쪽이든 같습니다.

에어드롭 가이드 보기