API 사용 가이드

스마트 컨트랙트 기반
API 사용 설명법

복잡한 스마트 컨트랙트 호출을 일반 HTTP API 방식으로 누구나 사용할 수 있도록 구성된 가이드입니다.

OpenAPI 3.1 Auth: x-api-key Network: 사내 전용/테스트넷

API 키 발급

대시보드에서 x-api-key를 발급받아 모든 요청 헤더에 포함

API 호출

REST API로 NFT/SBT/RWA 등 블록체인 기능을 간편하게 사용

결과 확인

transactionHash로 블록체인 기록 증거를 확인

API 동작 흐름

여러분의 요청이 블록체인에 기록되는 과정

1. 클라이언트 요청 JSON 형태의 API 요청 전송 (REST API)

HTTP Request

2. MST 서버 처리 인증 확인, 스마트 컨트랙트 함수 자동 실행

Transaction

3. 블록체인 기록 트랜잭션 기록 완료 → transactionHash 반환

초보자를 위한 API 설명

MST-Contract API를 처음 사용하는 분들을 위한 친절한 가이드

MST-Contract API란? 개요

블록체인 상의 스마트 컨트랙트를 직접 다루지 않아도, 일반적인 웹 API 호출만으로 NFT 발행, SBT 발급, RWA 등록과 같은 기능을 사용할 수 있게 만든 서비스입니다.

지갑 연결, 가스 설정, 서명 처리 등 복잡한 과정은 모두 서버가 대신 처리합니다.

어떻게 동작하나요? 원리

여러분은 단순히 JSON 형태의 API 요청만 보냅니다. 그러면 서버가 해당 요청에 맞는 스마트 컨트랙트 함수를 자동으로 실행합니다. 트랜잭션이 블록체인에 기록되면 그 결과를 API 응답으로 전달합니다.

동작 구조

블록체인 사용 = 서버에 API 요청 → 서버가 대신 처리 → 블록체인 기록

사용 절차 실전

API 키를 발급받습니다. 헤더에 x-api-key 포함

Base URL을 확인합니다. 예: https://api.mst.network/v1

필요한 기능(NFT/SBT/RWA 등)에 맞는 API를 호출합니다.

응답의 transactionHash는 "블록체인 기록 증거"입니다.

관리 대시보드에서 처리 상태와 로그를 확인합니다.

예시로 이해하기 코드

NFT 발행하기

"NFT를 발행한다" → 아래 API를 호출하면 서버가 블록체인에 NFT를 생성합니다.

POST /v1/nfts/mint

RWA 등록하기

"실물자산을 블록체인에 등록한다" → RWA 토큰이 생성되고 기록됩니다.

POST /v1/rwa/mint

SBT 발급하기

"권리를 부여한다" → 양도 불가한 인증/권한 토큰을 발급합니다.

POST /v1/sbt/mint

즉, 스마트 컨트랙트를 직접 코드로 작성하거나 배포할 필요 없이 기존 REST API 쓰듯이 블록체인을 활용할 수 있습니다.

스마트 컨트랙트 기반API 사용 설명법