아래에 토큰 종류별로 정리되어 있으니 참고해 주시기 바랍니다.

[KIP-7/KIP-17/KIP-37 토큰 등록 방법]

1. 컨트랙트 주소

   : 컨트랙트 주소 확인 방법은 총 2가지가 있으며 콘솔 페이지에서 직접 확인하거나 API 호출을 이용하는 방법이 있습니다. 자세한 방법은 아래 내용을 참고해 주세요.

   1. 콘솔 페이지

      1. 콘솔 페이지에서 로그인을 합니다.
      2. 좌측 메뉴에서 아래 메뉴 순서로 클릭합니다.
         • Service - KIP Series -  KIP-7 - Contracts
         • Service - KIP Series -  KIP-17 - Contracts
         • Service - KIP Series -  KIP-37 - Contracts
      3. 컨트랙트 목록에서 조회를 원하는 컨트랙트를 클릭하면 컨트랙트 주소를 확인하실 수 있습니다.
         

   2. API 호출
      

      1) 먼저 KIP-7 API /KIP-17 API / KIP-37 API 문서에 접속해 줍니다.
      2) 좌측 메뉴에서 'Contract - 컨트랙트 목록 조회' 순으로 클릭합니다.
      3) 해당 페이지를 참고하여 API 호출을 한 후에 성공적으로 요청이 이루어지면 Responses에서 ‘address’ (컨트랙트 주소)를 확인하실 수 있습니다.
      
      
      

2. 컨트랙트 코드 등록

   클레이튼스코프에서 제공하는 "컨트랙트 코드 등록 자동화" 기능을 이용하면 거의 즉시 반영됩니다.
   

   1. Klaytnscope에서 '컨트랙트 주소'를 조회합니다.
   2. Contract 탭을 선택하고, 'Match Contract Source Code' 를 클릭합니다.
      

   3. 코드를 제출하기 위해 지갑을 연결하고, 아래 항목을 선택 및 첨부파일을 업로드해주세요.

      • 컴파일러 버전 :
        

        1. KIP7: v0.5.6+commit.b259423e

        2. KIP17 : v0.5.0+commit.1d4f565a

        3. KIP37 : v0.5.6+commit.b259423e

      • 오픈 소스 라이선스 유형 : MIT License (MIT)
      • 소스코드 : 솔리디티 JSON 입력(문서)
        *본 문서에 첨부되어 있는 파일을 참고 부탁드립니다.(문서 하단 참고)
        [예시]
        
        
        

3. 토큰 정보 등록

   토큰 코드 등록이 완료 되었다면, 토큰 정보 등록 API를 통해 토큰 정보 등록 신청을 할 수 있습니다.

   • KlaytnScope 페이지 내 “Update Token Info“ 기능은 KAS KIP로 배포한 컨트랙트의 경우, Deployer 계정으로 인증이 불가능하기 때문에 활용이 불가한 점 참고 부탁드립니다.

     토큰 정보를 업데이트 하기 위해서는 다음과 같은 절차를 거치게 됩니다.

     아래 제공된 상세 가이드를 순서대로 참고하여 진행해주시기 바랍니다.

1. 업데이트하고자 하는 컨트랙트의 Deployer 계정으로 서명값 생성

2. 위에서 생성한 서명값을 사용하여 토큰 정보 업데이트 신청 API 호출

3. KlaytnScope 운영팀에서 확인 후 승인

4. 업데이트된 정보 반영

Deployer 서명값을 생성하는 자바스크립트 코드:

* 본 문서에 첨부되어 있는 파일을 참고 부탁드립니다.(문서 하단 참고)

1. Deployer 계정으로 서명값 생성

   1. 첨부된 자바스크립트 코드(GetDeployerSignature.js) 다운로드

   2. 다운로드 된 자바스크립트 파일을 열어 아래 항목들 기입

      

      • KIP URL

        1. KIP-7 : https://kip7-api.klaytnapi.com/v1/deployer/sign

        2. KIP-17 : https://kip17-api.klaytnapi.com/v2/deployer/sign

        3. KIP-37 : https://kip37-api.klaytnapi.com/v2/deployer/sign

      • CHAIN ID

        1. Cypress: 8217

        2. Baobab: 1001

      • YOUR KAS ACCESS KEY

        1. 링크 참고: API 인증 키는 무엇인가요?

      • YOU KAS SECRET KEY

        1. 링크 참고: API 인증 키는 무엇인가요?

      • YOUR KIP DEPLOYER ADDRESS

        1. 아래와 같이 KAS KIP Deployer 조회 API 호출하여 확인

           • KIP-7: https://kip7-api.klaytnapi.com/v1/deployer/default

           • KIP-17: https://kip17-api.klaytnapi.com/v2/deployer/default

           • KIP-37: https://kip37-api.klaytnapi.com/v2/deployer/default

        2. 예시

           curl --location --request GET 'https://kip17-api.klaytnapi.com/v2/deployer/default' \ 
           --header 'x-chain-id: ***YOUR CHAIN ID***' \ 
           --header 'Authorization: ***YOUR AUTH TOKEN***'

      • YOUR KIP ADDRESS

        1. 해당 페이지 상단에 “컨트랙트 주소“ 확인 방법 참고
           
           

   3. 실행

      1. 위 작성한 코드를 실행하기 위해서는 우선적으로 caver-js 설치 필요

         1. npm init -y
            npm install caver-js

      2. 실행

         1. node GetDeployerSignature.js

             

      3. 결과값 예시

         encrypted hash for apply :  26198607571743b0c1fe520d44ce3fc1f69bb915c6a437fd9087097bc4d05ba8
         signature :  0x1754fe386e6d44d9ee5a9a6d351af95cab69d83cba7b10ec3d59597403c603df75fe8cf7944493244dfef27d11c2bb096b2b06c8e49548e4f17eb19f387ee3fe01
         validation passed use values below 
         {
           timestamp: 1675843358759,
           walletAddress: '0xf391d96c0d21d75fe71e0d98ab3b1a228323b1f2',
           contractAddress: '0x733e016599be3c5d221a8733b9acf490c132aec5',
           signature: '0x1754fe386e6d44d9ee5a9a6d351af95cab69d83cba7b10ec3d59597403c603df75fe8cf7944493244dfef27d11c2bb096b2b06c8e49548e4f17eb19f387ee3fe01'
         }

          

2. 토큰 정보 업데이트 신청 API 호출

   1. 이미지 파일을 함께 호출하므로 API Body를 form-data 형식으로 아래 예시와 같이 입력

   2. API URL (POST)

      1. Cypress:

         • https://api-cypress.klaytnscope.com/codeMatch/token/:tokenAddress

      2. Baobab:

         • https://api-baobab.klaytnscope.com/codeMatch/token/:tokenAddress

   3. Request body 값 입력 (아래 테이블 참고)

      • 예시

      • {
          params = {
            timestamp: 1655176036
            walletAddress: "0x6ff09c4c3eb0f50d07282934d9f9120f31fb8c1d",
            walletType: "0",
            signature: "0x8bb6aaeb2d96d024754d3b50babf116cece68977acbe8ba6a66f14d5217c60d96af020a0568661e7c72e753e80efe084a3aed9f9ac87bf44d09ce67aad3d4e01",
            projectName: "Contract code match",
            tokenName: "",
            socialProfiles: `{"websiteURL":"https://baobab.scope.klaytn.com/","emailAddress":"klaytn.support@ozys.net","whitepaper":"","gitHub":"","reddit":"","twitter":"","discord":"","telegram":"","weChat":"","face
          },
        files: (binary) 
        }

   4. 응닶갑 확인

      • 예시

      • {
          "success":true, "code":0, 
          "result":{
            "timestamp":"1664438479530",
            "walletAddress":"0x6ff09c4c3eb0f50d07282934d9f9120f31fb8c1d",
            "walletType":"0",
            "signature":"0xcfbbc159acdcc0322da6550ba66fef3a6956675adb2823002ad134bb091827c22db33c28d8007e2a0af09d1145656f6799602c5f120b7381ee0c84974198a9b81c",
            "projectName":"Contract Auto Match",
            "tokenName":"", 
            "socialProfiles":"{\"websiteURL\":\"https://baobab.scope.klaytn.com/\",\"emailAddress\":\"klaytn.support@ozys.net\",\"whitepaper\":\"\",\"gitHub\":\"\",\"reddit\":\"\",\"twitter\":\"\",\"discord\":\"\",
          } 
        }

Request Body 입력값

더 궁금하신 사항이 있으시면 헬프센터 우측 상단 문의등록을 클릭하시고 문의사항을 등록해주시기 바랍니다.

감사합니다.