메타 마스크에서 토큰 아이콘을 수동으로 추가하는 방법은 무엇입니까?

Metamask 사용자는 사용자 정의 토큰 목록을 업데이트하거나 개발자 도구를 사용하여 지원되지 않는 ERC-20 토큰의 인식을 향상시켜 토큰 아이콘을 수동으로 추가 할 수 있습니다.

2025/06/12 03:49

메타 마스크 란 무엇이며 왜 토큰 아이콘을 추가해야합니까?

Metamask는 사용자가 Ethereum 블록 체인과 상호 작용할 수있는 인기있는 cryptocurrency 지갑입니다. 에테르 (ETH)뿐만 아니라 다양한 ERC-20 토큰을 지원합니다. 일반적으로 사용되는 많은 토큰은 메타 마스크 인터페이스 내에 아이콘을 자동으로 표시하지만 덜 알려진 또는 새로 발사 된 토큰은 아이콘을 표시하지 않아서 한눈에 식별하기가 더 어려워 질 수 있습니다.

토큰 아이콘을 수동으로 추가하면 각 토큰이 인식 가능한 시각적 표현을 갖도록하여 유용성을 향상시킵니다. 이것은 정기적으로 여러 토큰을 관리하는 사용자에게 특히 유용합니다. 아이콘이없는 토큰을 만나면 Metamask가 아직 토큰의 메타 데이터를 색인화하지 않았 거나 토큰 개발자가 공개 저장소에 포함시키기 위해 제출하지 않았기 때문일 수 있습니다.

메타 마스크는 토큰 아이콘을 어떻게 표시합니까?

Metamask는 Coingecko 및 tokenlists.org 와 같은 Github 리포지토리와 같은 커뮤니티 관리 토큰 목록을 포함한 여러 출처에서 토큰 정보를 가져옵니다. 토큰이 사용자의 지갑에 추가되면 Metamask는 이러한 소스에서 기호, 이름 및 아이콘을 가져 오려고 시도합니다 . 데이터를 사용할 수 없으면 토큰은 일반적인 자리 표시 자 아이콘으로 나타납니다.

아이콘 자체는 ​​일반적으로 온라인으로 호스팅되는 이미지 파일을 가리키는 URL로 저장됩니다. 메타 마스크가 올바른 아이콘을 표시하려면 토큰 계약 주소가 인식 된 토큰 목록 중 하나 에서이 이미지 URL과 연관되어야합니다 . 수동으로 토큰 아이콘을 추가하려면 이러한 목록 중 하나를 업데이트하거나 로컬 지갑을 사용자 정의 아이콘 경로를 인식하도록 구성해야합니다.

사용자 정의 토큰 목록을 통해 수동으로 토큰 아이콘을 추가하는 단계

메타 마스크에서 토큰 아이콘을 수동으로 추가하려면 하나의 방법에는 원하는 토큰의 아이콘 URL이 포함 된 사용자 정의 토큰 목록 JSON 파일을 작성하거나 수정하는 것이 포함됩니다. 방법은 다음과 같습니다.

• 토큰 계약 주소 와 아이콘 URL이 준비되어 있는지 확인하십시오.

• 새 JSON 파일을 작성하거나 형식에 따라 기존 파일을 수정하십시오.

   {
   'name': 'Custom Token List',
   'logoURI': 'https://example.com/icon.png',
   'timestamp': '2024-03-15T12:00:00Z',
   'tokens': [ { 'chainId': 1, 'address': '0x...', 'symbol': 'TKN', 'name': 'Token Name', 'decimals': 18, 'logoURI': 'https://example.com/tkn-icon.png' }

  ]]
  }

• 파일을 저장하고 공개적으로 액세스 가능한 서버 또는 호스팅 서비스 (예 : GitHub 페이지)에 업로드하십시오.

• 메타 마스크에서 설정> 고급> 토큰 목록 관리 로 이동하십시오.

• 토큰 목록 추가를 클릭하고 호스팅 된 JSON 파일의 URL을 붙여 넣습니다.

• 필요한 경우 메타 마스크를 확인하고 다시로드하십시오.

이 단계를 완료하면 지갑의 토큰 이름과 함께 사용자 정의 토큰 아이콘이 나타납니다 .

토큰 목록을 수정하지 않고 토큰 아이콘 추가

외부 토큰 목록을 처리하지 않으려면 개발자 도구를 사용하여 메타 마스크 인스턴스 내에서 토큰 아이콘을 수동으로 무시할 수 있습니다. 이 방법은 로컬 설치에만 적용되며 다른 사용자에게는 영향을 미치지 않습니다.

• 메타 마스크를 열고 사용자 정의하려는 토큰이 이미 추가되었는지 확인하십시오.
• 브라우저의 Metamask 확장을 마우스 오른쪽 버튼으로 클릭하고 개발자 도구를 여는 검사를 선택하십시오.
• 애플리케이션 탭 으로 이동 한 다음 로컬 스토리지 에서 metamask-controller-state 의 항목을 찾으십시오.
• tokens 섹션을 찾아 계약 주소에 해당하는 토큰 개체를 찾으십시오.
• 토큰 객체 내에서 새로운 키-값 쌍을 추가하십시오 : 'iconUrl': 'https://example.com/tkn-icon.png' .
• 업데이트 된 아이콘을 볼 수있는 메타 마스크를 다시로드하십시오.

이 접근법은 브라우저 개발자 도구에 대한 친숙 함이 필요하며 백업되지 않는 한 장치 나 세션에서 지속적이지 않습니다 .

수동 추가를위한 토큰 아이콘은 어디에서 찾을 수 있습니까?

수동으로 메타 마스크에 추가 할 때 특정 토큰의 올바른 아이콘을 찾는 것이 필수적입니다. 가장 신뢰할 수있는 출처는 다음과 같습니다.

• 공식 토큰 웹 사이트 : 대부분의 프로젝트는 공식 사이트에서 고품질 아이콘을 호스팅합니다.
• GitHub 리포지토리 : 많은 토큰 개발자는 아이콘을 포함한 자산을 공공 저장소에서 유지합니다.
• 커뮤니티 중심의 토큰 목록 : tokenlists.org 와 같은 플랫폼에는 종종 다양한 토큰에 대한 검증 된 아이콘 URL이 포함되어 있습니다.
• 타사 자산 디렉토리 : 일부 서비스는 토큰 메타 데이터를 집계하고 다운로드 가능한 아이콘을 제공합니다.

아이콘 URL을 사용하기 전에 .png 파일을 직접 가리키며 인증없이 공개적으로 액세스 할 수 있는지 확인하십시오. 파손되거나 무단 링크를 사용하면 아이콘이로드되지 않거나 메타 마스크에 의해 차단 될 수 있습니다 .

---

자주 묻는 질문 (FAQ)

Q : 메타 마스크에서 토큰 아이콘에 이미지 형식을 사용할 수 있습니까?

메타 마스크는 주로 투명성 지원과 넓은 호환성으로 인해 토큰 아이콘의 .png 파일을 지원합니다. .jpg 또는 .svg 와 같은 다른 형식을 사용하면 디스플레이 문제 또는 지원되지 않은 렌더링이 발생할 수 있습니다.

Q : 메타 마스크를 업데이트 한 후 수동으로 추가 된 토큰 아이콘이 유지됩니까?

로컬 수정을 통해 추가 된 아이콘 (로컬 스토리지 편집)은 업데이트 또는 캐시 지우기 후 재설정 될 수 있습니다. 그러나 사용자 정의 토큰 목록을 통해 추가 된 아이콘은 목록이 활성화되고 변경되지 않은 한 보존됩니다 .

Q : 메타 마스크에는 토큰 아이콘에 대한 크기 요구 사항이 있습니까?

엄격한 크기 요구 사항은 없지만 명확성을 위해 최소 64x64 픽셀의 정사각형 이미지를 사용하는 것이 좋습니다. 고해상도 디스플레이의 경우 더 큰 크기 (예 : 256x256)가 선호됩니다.

Q : Metamask의 기본 목록에 포함될 토큰 아이콘을 제출할 수 있습니까?

예, 더 광범위한 인식을 위해 Coingecko 또는 Uniswap의 토큰 목록과 같은 플랫폼에 토큰을 제출할 수 있습니다. 이러한 서비스에 제출하면 수동 개입없이 메타 마스크에서 자동 아이콘 감지 가능성이 높아집니다.