솔라나 토큰 메타데이터 수정: 이름, 심볼, 로고

솔라나 토큰 메타데이터를 고치는 일은 하나처럼 보이지만 사실 둘입니다. 메타데이터는 토큰의 공개 명함입니다. 이름, 심볼, 로고, 설명, 링크가 여기 들어갑니다. 그런데 이 정보는 한 곳이 아니라 두 곳에 나뉘어 있고, 각각 따로 수정됩니다.

출시 뒤 가장 자주 오는 문의도 여기서 나옵니다. 로고는 일주일 전에 바꿨는데 Solscan에는 여전히 옛 이름이 떠 있다는 것입니다.

• 이름, 심볼, 웹 주소는 체인에 적혀 있습니다. 고치면 수수료가 듭니다.
• 로고, 설명, 소셜 링크는 파일 안에 있습니다. 고치는 데 돈이 들지 않습니다.
• 한 층을 수정해도 다른 층은 절대 따라 움직이지 않습니다.
• 잠그는 것은 되돌릴 수 없는 유일한 결정입니다.

메타데이터의 두 층

토큰이 만들어질 때 정보는 Metaplex Token Metadata를 거쳐 들어옵니다. 솔라나의 거의 모든 토큰이 따르는 표준입니다. 이것이 첫 번째 층을 만듭니다. 그 계정이 민트에 어떻게 붙는지는 솔라나의 Metaplex Metadata 문서에 설명되어 있습니다.

첫째 층은 체인 위에 있습니다. 딱 세 가지를 담습니다. 이름, 심볼(티커), 그리고 어떤 파일을 가리키는 웹 주소입니다. 지갑과 탐색기는 여기부터 읽습니다. 이 셋 중 무엇이든 손대면 체인에 쓰는 일이고, 비용이 따릅니다.

둘째 층은 그 주소에 있는 파일입니다. 안에는 로고, 설명, 웹사이트, 소셜 링크가 들어 있습니다. 이 중 하나를 바꾸는 일은 같은 주소에 같은 파일을 다시 올리는 것뿐입니다. 트랜잭션도 수수료도 없습니다.

그래서 누군가 로고를 바꿨는데 이름이 그대로여도 고장난 것이 아닙니다. 로고는 파일에, 이름은 체인에 있고, 한쪽을 고쳐도 다른 쪽은 움직이지 않습니다.

항목	층	바꾸는 방법	비용
토큰 이름	체인	수정 도구	0.2 SOL
심볼(티커)	체인	수정 도구	0.2 SOL
웹 주소(URI)	체인	수정 도구	0.2 SOL
로고	파일	같은 주소에 다시 올리기	무료
설명	파일	같은 주소에 다시 올리기	무료
웹사이트와 소셜	파일	같은 주소에 다시 올리기	무료

정말로 손대야 하는 순간

• 새 로고가 필요할 때. 디자인이 더 나은 버전을 넘겼습니다. 로고는 파일에 있으니 같은 주소에 다시 올리면 끝입니다. 무료입니다.
• 링크가 바뀌었을 때. 디스코드가 옮겨졌거나, X 계정이 바뀌었거나, 사이트가 다른 도메인으로 갔을 때입니다. 역시 파일만 고치면 됩니다.
• 이름이나 심볼이 틀렸을 때. 임시 이름으로 출시했거나 티커에 오타가 있는 경우입니다. 이쪽은 봉인된 면이라 수정 도구를 거쳐야 합니다.
• 파일을 영구 저장소로 옮길 때. 주소 자체가 바뀌므로 이것도 체인에 쓰는 일입니다. 이 단계는 언제나 잠금보다 먼저입니다.

앞의 두 경우는 체인을 건드리지 않고 비용도 없으며 필요한 만큼 반복할 수 있습니다. 뒤의 두 경우는 이름이든 티커든 주소든 같은 양식을 통과합니다. 정리하면 겉모습에 해당하는 것은 무료이고, 값이 붙는 것은 봉인된 세 항목뿐입니다.

솔라나 토큰 메타데이터 수정, 단계별로

로고나 링크만 바꾼다면 아래 단계는 필요 없습니다. 이름, 심볼, 주소를 바꾼다면 네 단계입니다.

• 먼저 상태를 봅니다. 토큰 상태 조회 도구를 열고 토큰 주소를 붙여 넣습니다. 현재 값을 읽어주고, 수정 권한이 아직 어떤 지갑에 남아 있는지 알려줍니다. 무료이고, 권한이 이미 넘어갔다면 수수료를 낼 이유가 없습니다.
• 맞는 지갑을 연결합니다. 그 권한을 가진 지갑만 서명할 수 있습니다. 다른 지갑으로는 수정이 그냥 들어가지 않습니다.
• 새 값을 넣고 서명합니다. 메타데이터 수정 도구에 주소를 붙여 넣고 바꿀 값을 적은 뒤 지갑에서 승인합니다. 그 시점의 수수료는 확인 전에 화면에 표시됩니다.
• 끝나면 확인합니다. 상태 조회를 한 번 더 돌립니다. 로고는 조금 기다려야 합니다. 지갑이 이미지를 십 분에서 삼십 분 정도 캐시에 담아 둡니다.

잠그기 전에 파일은 반드시 영구적인 곳에 있어야 합니다. 반복되는 사고는 이렇습니다. 팀이 출시 때 파일을 무료 호스팅에 올리고, 몇 주 뒤 메타데이터를 잠그고, 몇 달 뒤 그 호스팅이 만료됩니다. 주소는 404를 돌려주기 시작합니다. 이름은 체인에 봉인되어 있어 그대로 보이지만 로고와 설명은 사라지고, 수정 권한이 없으니 아무도 토큰을 새 파일로 연결할 수 없습니다.

네 번째 단계를 건너뛰는 경우가 많은데, 사실 그 단계가 앞의 셋을 증명합니다. 지갑 화면이 바뀐 것은 내 쪽 표시일 뿐이고, 체인에 실제로 무엇이 적혔는지는 상태 조회가 말해 줍니다. 나중에 누군가에게 보여줄 근거도 결국 그 값입니다.

잠글까 열어 둘까

언젠가는 메타데이터를 잠그라는 말을 듣게 됩니다. 잠근다는 것은 수정 권한을 영구히 포기해서, 팀을 포함해 누구도 더 이상 바꿀 수 없게 만드는 일입니다. 사는 쪽은 이것을 보기 좋아하고, 일부 상장 체크리스트도 이를 묻습니다.

결정하는 것은 순서입니다. 먼저 파일을 Arweave나 핀이 걸린 IPFS로 옮기고, 그다음 체인의 주소를 새 링크로 돌리고, 며칠에 걸쳐 서로 다른 두 대의 컴퓨터에서 열리는지 확인한 뒤에야 잠급니다.

잠글 때는 깊이를 고릅니다. 수정 권한 포기 도구는 이름과 심볼과 주소에 대한 권리만 가져갑니다. 불변 처리 도구는 수정, 발행, 동결 권한을 한 번에 넘깁니다. 셋을 나란히 비교한 글은 토큰 권한 포기 가이드에 있습니다.

실무 기준은 이렇습니다. 브랜드가 자리 잡았고, 토큰이 여섯 달 넘게 이름 변경 없이 돌아갔고, 파일이 이미 영구 저장소에 있거나 거래소가 직접 요구한다면 잠급니다. 리브랜딩 가능성이 남아 있거나, 호스팅을 잃을 수 있거나, 두 번째 버전이 아직 논의 중이라면 미룹니다. 이 과정 전체에서 한 방향으로만 열리는 문은 이것 하나뿐입니다.

수정이 들어가지 않는 이유

두 가지가 거의 모든 경우를 덮습니다. 하나는 수정 권한이 이미 포기된 경우로, 대개 생성 시점에 그렇게 됩니다. 그러면 이름과 심볼과 주소는 영구히 봉인됩니다. 다른 하나는 연결한 지갑이 권한을 가진 지갑이 아닌 경우입니다.

두 번째는 도구 결함처럼 보이지만 아닙니다. 상태 조회가 어느 지갑에 권한이 있는지 알려주니 정확히 그 지갑을 연결하면 됩니다. 권한이 정말 사라졌다면 되돌릴 길은 없고, 남은 방법은 새 토큰을 발행하는 것뿐입니다.

비슷해 보이지만 무해한 세 번째 경우도 있습니다. 수정은 진작 반영되었는데 지갑이 옛 이미지를 계속 보여주는 상황입니다. 토큰이 잘못 보이거나 아예 보이지 않는 이유는 Phantom 지갑에 토큰이 안 보일 때에 모아 두었습니다. 탐색기 검색에 토큰이 뜨게 하는 것은 조건이 따로 있는 별개 절차이고, 솔라나의 토큰 검증 안내에 적혀 있습니다.

다른 것보다 더 자주 빠지는 항목이 하나 있습니다. 지금 파일을 어떤 상태로 보고 있는지입니다. 여러 팀이 그 주소를 브라우저에서 열어 보고, 브라우저가 스스로 보관해 둔 옛 버전을 본 다음, 업로드가 실패했다고 결론을 냅니다. 시크릿 창에서 열거나 주소 끝에 아무 매개변수나 붙여 보십시오. 새로 설치한 지갑이 보는 것과 같은 상태가 나옵니다.

리브랜딩처럼 두 층을 함께 바꿀 때는 순서도 돈이 됩니다. 이름과 로고를 같이 바꾼다면 파일 쪽을 먼저 정리하고 체인 쪽을 나중에 쓰는 편이 낫습니다. 파일 쪽은 무료라 몇 번이고 다시 할 수 있지만 체인 쪽은 매번 수수료가 붙기 때문입니다. 순서를 바꿔도 결과는 같지만, 대개 필요 없는 수수료를 한 번 더 내게 됩니다.

가장 자주 반복되는 실수

• 파일을 고쳐 놓고 이름도 바뀐 줄 아는 것. 로고는 파일에, 이름은 체인에 있습니다. 각각 따로 확인하십시오.
• 파일이 임시 호스팅에 있는 채로 잠그는 것. 이 목록에서 가장 비싼 실수이고, 뒤에 고칠 방법이 없습니다.
• 캐시를 기다리지 않는 것. 십 분에서 삼십 분은 정상입니다. 거래를 다시 하기 전에 상태 조회부터 읽으십시오.
• 파일로 이름을 바꾸려는 것. 파일 안의 이름 항목은 지갑이 무시합니다. 진짜 이름 변경은 언제나 도구를 거칩니다.
• 엉뚱한 지갑으로 서명하는 것. 수수료는 들지 않지만 매번 몇 분씩 헤매게 됩니다.

마지막으로 하나 더 있습니다. 수정한 값이 어디까지 퍼졌는지는 서비스마다 속도가 다릅니다. 탐색기가 먼저 바뀌고, 지갑이 그다음이며, 시세 사이트는 자체 캐시 주기까지 기다려야 합니다. 세 곳이 동시에 바뀌지 않는다고 해서 수정이 실패한 것은 아닙니다.

메타데이터 자주 묻는 질문

출시 후에도 토큰 이름을 바꿀 수 있나요?

수정 권한이 아직 어떤 지갑에 있다면 가능합니다. 상태 조회로 무료로 확인한 뒤, 변경은 0.2 SOL이 들고 그 지갑이 서명합니다.

왜 아직 옛날 로고가 보이나요?

잘못된 층을 고쳤거나, 지갑이 아직 이미지를 캐시에 담고 있는 것입니다. 같은 주소에 로고를 다시 올리고 상태를 읽은 다음 캐시가 지나가길 기다리십시오.

수정 비용은 얼마인가요?

파일을 고치는 것은 무료입니다. 이름, 심볼, 주소는 0.2 SOL에 소액의 네트워크 수수료가 더해지고, 금액은 확인 전에 화면에 나옵니다.

토큰을 불변으로 만드는 게 좋을까요?

브랜드가 확실하고 토큰에 이력이 쌓였고 파일이 영구 저장소에 있다면 그렇습니다. 리브랜딩 여지가 남아 있다면 기다리는 편이 낫습니다.

업데이트 권한이란 무엇인가요?

특정 지갑이 가진, 체인에 적힌 메타데이터를 나중에 수정할 수 있는 권리입니다. 그것을 넘기면 기록은 영원히 봉인됩니다.

Token-2022에도 그대로 적용되나요?

일부만 적용됩니다. Token-2022는 메타데이터를 토큰 안에 직접 담을 수 있고 다른 경로를 따릅니다. 이 글은 대부분이 쓰는 SPL과 Metaplex 경로를 다룹니다.

수정 기록이 남나요?

남습니다. 이름이나 심볼을 바꾼 트랜잭션은 체인에 그대로 기록되고 누구나 확인할 수 있습니다. 조용히 이름만 갈아치우는 일이 어려운 이유가 여기 있습니다.

무엇을 고치기 전에

수정은 저렴하고 반복할 수 있으니 첫날에 완벽할 필요가 없습니다. 이름은 고치고 로고는 바꾸고 링크는 필요한 만큼 옮기면 됩니다. 되돌릴 수 없는 것은 잠금 하나뿐입니다. 파일을 영구 저장소로 옮기고, 주소를 그쪽으로 돌리고, 열리는지 확인한 다음에 권한을 넘기십시오.