MST-Contract API란?
개요블록체인 상의 스마트 컨트랙트를 직접 다루지 않아도, 일반적인 웹 API 호출만으로 NFT 발행, SBT 발급, RWA 등록과 같은 기능을 사용할 수 있게 만든 서비스입니다.
지갑 연결, 가스 설정, 서명 처리 등 복잡한 과정은 모두 서버가 대신 처리합니다.
API 가이드
스마트 컨트랙트 기반 API 사용 설명
복잡한 스마트 컨트랙트 호출을 일반 HTTP API 방식으로
누구나 사용할 수 있도록 구성된 가이드입니다.
- OpenAPI 3.1
- Auth:
x-api-key - Network: 사내 전용/테스트넷
빠른 시작
API 키 발급
발급받은
x-api-key를 모든 요청 헤더에 포함합니다.API 호출
REST API로 NFT·SBT·RWA 등 블록체인 기능을 간편하게 사용합니다.
결과 확인
응답의
transactionHash로 블록체인 기록 증거를 확인합니다.
API 동작 흐름
여러분의 요청이 블록체인에 기록되는 과정입니다. 요청을 보내면 서버가 컨트랙트를 실행하고, 기록이 끝나면 transactionHash를 돌려줍니다.
- 클라이언트 요청JSON 형태의 API 요청 전송 (REST API)
- HTTP RequestMST 서버 처리인증 확인, 스마트 컨트랙트 함수 자동 실행
- Transaction블록체인 기록트랜잭션 기록 완료 → transactionHash 반환
초보자를 위한 API 설명
MST-Contract API를 처음 사용하는 분들을 위한 친절한 가이드
어떻게 동작하나요?
원리여러분은 단순히 JSON 형태의 API 요청만 보냅니다. 그러면 서버가 해당 요청에 맞는 스마트 컨트랙트 함수를 자동으로 실행합니다. 트랜잭션이 블록체인에 기록되면 그 결과를 API 응답으로 전달합니다.
동작 구조
블록체인 사용 = 서버에 API 요청 → 서버가 대신 처리 → 블록체인 기록
사용 절차
실전- API 키를 발급받습니다. 요청 헤더에
x-api-key를 포함합니다. - Base URL을 확인합니다. 예:
https://api.mst.network/v1 - 필요한 기능(NFT·SBT·RWA 등)에 맞는 API를 호출합니다.
- 응답의
transactionHash는 ‘블록체인 기록 증거’입니다. - 관리 대시보드에서 처리 상태와 로그를 확인합니다.
예시로 이해하기
코드NFT 발행하기
“NFT를 발행한다” → 아래 API를 호출하면 서버가 블록체인에 NFT를 생성합니다.
HTTP POST /v1/nfts/mintRWA 등록하기
“실물자산을 블록체인에 등록한다” → RWA 토큰이 생성되고 기록됩니다.
HTTP POST /v1/rwa/mintSBT 발급하기
“권리를 부여한다” → 양도 불가한 인증·권한 토큰을 발급합니다.
HTTP POST /v1/sbts/mint
즉, 스마트 컨트랙트를 직접 코드로 작성하거나 배포할 필요 없이 기존 REST API 쓰듯이 블록체인을 활용할 수 있습니다.