루니버스 2.0 업그레이드 안내
2021년 8월 13일 루니버스 2.0 서비스가 오픈했습니다.
현재 1.0 콘솔과 2.0콘솔을 통해 1.0 서비스와 2.0 서비스를 동시에 사용 가능합니다. 그러나 곧 1.0 서비스 종료할 예정입니다. 기존 1.0에 서비스에서 생성한 데이터들은 별도의 업그레이드 없이 2.0 에서 사용하실 수 있습니다. 2021 8월 13일 오픈일 기준으로 데이터 마이그레이션이 되어있어 1.0, 2.0 서비스에서 동시에 확인 가능합니다. 1.0 서비스가 종료되는 시점에 추가/수정/삭제된 데이터는 한번 더 마이그레이션 할 예정입니다.
기존에 제공되었던 1.X API (MX, TX, BE) 는 1.0 서비스 종료 후 일정기간(약 3개월) 이 지나면 deprecated됩니다. 대신 같은(또는 비슷한) 기능을 제공하는 2.0 API를 사용하실 수 있습니다. 따라서 최대한 빠른 시간안에 기존에 사용하시던 API를 변경하시기를 요청드립니다.
일정 기간동안 1.X API 사용이 가능합니다. 2.0 API로 변경하는 것은 추가 구현이 필요할 수 있습니다. 루니버스 2.0 사전 업그레이드를 통해 1.X API를 호환모드로 사용하다가 추후 2.0 API로 완전 변경하시는 것을 추천 드립니다. 2.0 API로 변경하는 자세한 방법은 아래 링크를 확인하세요.

루니버스 2.0 사전 업그레이드

루니버스 1.0 서비스가 종료되면 1.X API는 루니버스 1.0 서비스가 아닌 루니버스 2.0 서비스에 의해 호환모드로 동작합니다.
루니버스에서는 1.0 서비스가 종료되기전 사전 업그레이드 방법을 제공합니다. 호환모드를 테스트할 수 있는 환경을 제공하여 사전 테스트를 진행할 수 있으며 테스트 후 1.0 서비스 종료 전 호환모드로 미리 업그레이드 할 수 있습니다.
루니버스 2.0 사전 업그레이드를 아래와 같이 진행해 주십시오.
    1.
    람다256 담당자에게 사전 업그레이드 진행 알리기
    2.
    사용중인 루니버스 1.X API 목록 확인
    3.
    사용중인 루니버스 1.X API 목록 람다256에 전달
    4.
    사용중인 루니버스 1.X API를 루니버스 1.5 호환 API로 변경
    5.
    변경된 API 호출 테스트 (prd와 동일한 결과를 리턴하는 staging 환경 제공 예정)
    6.
    변경한 내용 서비스에 반영(배포)

람다256 담당자에게 사전 업그레이드 진행 알리기

사전 업그레이드를 진행하기로 결정 하셨다면 람다256 담당자에게 알려주세요. staging 테스트 환경을 미리 준비하고 약속된 시간에 환경을 열어드리겠습니다. 또한 담당자가 사전 업그레이드를 문제없이 진행할 수 있도록 도움을 드리겠습니다.

사용중인 루니버스 1.X API 목록 확인

루니버스에서 제공중인 1.X API는 아래와 같습니다.
    1.
    TX (Side Chain Transaction) API
사이드 체인의 리소스를 제어하기 위한 API 입니다. 1.1 Tx API 문서는 여기서 확인할 수 있습니다.
2. MX (Main Chain Transaction) API
메인 체인의 리소스를 제어하기 위한 API 입니다. 1.0 Mx API 문서는 여기서 확인할 수 있습니다.
3. BE (Luniverse console backend) API
루니버스 콘솔에서 사용하는 API로 외부 공개용은 아니지만 별도 요청에 의해 일부 사용중인 경우가 있습니다. 아래와 같은 url로 시작하는 API가 있다면 람다256으로 반드시 알려주세요. 1.0 서비스가 종료되면 정상동작하지 않을 수 있습니다.
https://api.luniverse.io/be/

사용중인 루니버스 1.X API 목록 람다256에 전달

사용중인 루니버스 1.X API 목록을 확인하셨다면 람다256의 담당자를 통해 전달해 주세요. 이미 전달하셨다면 이 과정은 생략하셔도 됩니다.
사용중인 루니버스 1.X API 가 없다면 별도의 업그레이드 과정은 필요 없습니다. 루니버스 2.0 콘솔을 바로 이용해 주세요.
사용중인 루니버스 1.X API 목록에 특이사항이 있다면 람다256에서 연락을 드리겠습니다. 별도의 연락이 없다면 다음 과정을 바로 진행해 주세요.

사용중인 루니버스 1.X API를 루니버스 1.5 호환 API로 변경

1.0 MX API

MX API는 별도 업그레이드가 필요 없습니다.

1.1 TX API

아래와 같이 기존 호출 API path 중 버전 값만 v1.1에서 v1.5로 변경합니다.
https://api.luniverse.io/tx/v1.1/~
https://api.luniverse.io/tx/v1.5/~

(1.0) BE API

아래와 같이 기존 호출 API path 중 be 앞에 tx/v1.5/ prefix를 추가합니다.
https://api.luniverse.io/be/~
https://api.luniverse.io/tx/v1.5/be/~

변경된 API 호출 테스트 (prd와 동일한 결과를 리턴하는 staging 환경 제공 예정)

루니버스에서는 변경된 API 호출을 테스트 해볼 수 있도록 staging 환경을 제공합니다.
테스트 할 수 있는 준비가 되면 루니버스 담당자에게 알려주세요. staging 테스트 환경을 열어 드립니다.
prd 호출과 동일한 응답값을 반환하며 scan, sidescan등도 제공하여 체인에 기록된 내용도 조회할 수 있습니다.
staging에서 호출한 내용이 prd에 반영되지 않습니다. staging에서 마음껏 자유롭게 테스트 하세요.
테스트 하는 순서는 아래와 같습니다.
    1.
    API host를 staging으로 변경
    2.
    테스트 및 결과 확인
테스트 진행은 람다256 담당자와 협의하여 정해진 시간에 진행됩니다.

API host를 staging으로 변경

루니버스의 staging API Host는 아래와 같습니다.
api.tembit-luniverse.net
사용하고 계신 tx, be api의 host를 아래와 같이 변경합니다.
https://api.luniverse.io/tx/v1.5/~ -> https://api.tembit-luniverse.net/tx/v1.5/~
https://api.luniverse.io/tx/v1.5/be~ -> https://api.tembit-luniverse.net/tx/v1.5/be~

테스트 및 결과 확인

staging에서 호출한 API의 응답값을 확인하세요. 루니버스에서는 블록체인에 저장된 내용을 확인할 수 있도록 staging용 스캔도 제공합니다.

변경한 내용 서비스에 반영(배포)

테스트가 완료되면 변경한 API를 반영해 주세요.
테스트 시 변경했던 API Host를 다시 https://api.luniverse.io로 변경 했는지 확인해 주세요.
가이드나 진행 중 문의사항은 문의 주시면 최대한 빠르게 대응해 드리겠습니다. 감사합니다.
Last modified 1mo ago