WEMIX3.0
Search…
App-to-App API
이 페이지에서는 dApp을 WEMIX Wallet과 연동하기 위한 App-to-App API를 설명합니다.

App-to-App API 는 REST API로 별도의 인증 절차없이 HTTPS 통신으로 동작합니다.
App-to-App API Flow 는 다음과 같습니다.
App-to-App API는 다음의 접속 환경을 제공합니다.

post
/api/v1/a2a/proposal
dApp에서 실행하고 싶은 작업을 정의하고, 정의된 작업의 requestId 를 발급합니다.
type 속성 설명
Value
Text
auth
지갑주소 요청 (인증 요청)
send
WEMIX 전송 요청
send_token
TOKEN 전송 요청
send_nft
NFT 전송 요청
contract_execute
Contract 실행 요청
metadata 속성 설명
Attribute
Type
Text
name
string
dApp 이름
description
string
실행작업 설명
url
string
dApp 대표 URL
icon
string
dApp 로고 이미지 URL
successCallback
string
dApp 요청 성공 시 처리할 callback 정보
failureCallback
string
dApp 요청 실패 시 처리할 callback 정보
transaction 속성 설명
Attribute
Type
Text
from
string
전송자의 주소. (지갑 사용자가 맞는지 확인용)
to
string
전송 시에는 수신 주소, 스마트 컨트랙트 실행에서는 컨트랙트 주소
value
string
전송하려는 코인 또는 토큰 수량, 10^18 기준
tokenId
string
전송하려는 NFT token id
contract
string
토큰, NFT 전송 시 해당 컨트랙트의 주소
params
string
스마트 컨트랙트 실행 시 함수 파라미터
abi
string
스마트 컨트랙트 실행 시 함수의 abi
지갑 생성 및 연결 예시
{
"type": "auth",
"metadata": {
"name": "dApp 이름",
"description": "요청 설명",
"url": "dApp 대표 URL",
"icon": "dApp 로고 이미지 URL",
"successCallback": "dApp 요청 성공 시 처리할 callback 정보",
"failureCallback": "dApp 요청 실패 시 처리할 callback 정보"
}
}
WEMIX 전송 예시
{
"type": "send",
"metadata": {
"name": "dApp 이름",
"description": "요청 설명",
"url": "dApp 대표 URL",
"icon": "dApp 로고 이미지 URL",
"successCallback": "dApp 요청 성공 시 처리할 callback 정보",
"failureCallback": "dApp 요청 실패 시 처리할 callback 정보"
},
"transaction": {
"from": "fromAddress",
"to": "toAddress",
"value": "10000000"
}
}
토큰 전송 예시
{
"type": "send_token",
"metadata": {
"name": "dApp 이름",
"description": "요청 설명",
"url": "dApp 대표 URL",
"icon": "dApp 로고 이미지 URL",
"successCallback": "dApp 요청 성공 시 처리할 callback 정보",
"failureCallback": "dApp 요청 실패 시 처리할 callback 정보"
},
"transaction": {
"from": "fromAddress",
"to": "toAddress",
"value": "10000000",
"contract": "contract"
}
}
NFT 전송 예시
{
"type": "send_nft",
"metadata": {
"name": "dApp 이름",
"description": "요청 설명",
"url": "dApp 대표 URL",
"icon": "dApp 로고 이미지 URL",
"successCallback": "dApp 요청 성공 시 처리할 callback 정보",
"failureCallback": "dApp 요청 실패 시 처리할 callback 정보"
},
"transaction": {
"from": "fromAddress",
"to": "toAddress",
"contract": "nftContract",
"tokenId": "testTokenId"
}
}
스마트 컨트랙트 실행 예시
{
"type": "contract_execute",
"metadata": {
"name": "dApp 이름",
"description": "요청 설명",
"url": "dApp 대표 URL",
"icon": "dApp 로고 이미지 URL",
"successCallback": "dApp 요청 성공 시 처리할 callback 정보",
"failureCallback": "dApp 요청 실패 시 처리할 callback 정보"
},
"transaction": {
"from": "fromAddress",
"to": "toAddress",
"abi": "{\"name\": \"transfer\", \"type\": \"function\", \"inputs\": [{ \"name\": \"to\", \"type\": \"address\", \"internalType\": \"address\" }, { \"name\": \"amount\", \"type\": \"uint256\", \"internalType\":\"uint256\"}], \"outputs\": [{\"name\": \"\", \"type\": \"bool\", \"internalType\": \"bool\" }], \"stateMutability\": \"nonpayable\"}",
"params": "testParams"
}
}

get
/api/v1/a2a/result
?requestId={요청작업 requestId}
요청한 작업의 결과를 조회합니다.
status 속성 설명
Value
Text
proposal
실행 요청
completed
실행 완료
canceled
실행 취소

에러 응답 예시
{
"errorCode": 3611,
"errorMessage": "invalid type",
"status": 400
}
Status code
Error Code
Description
400
3610
type is required
3611
invalid type
3612
transaction is required
3613
requestId is not found
3614
requestId is required
500
500
server error
Copy link
On this page
개요 및 flow
dApp 실행 작업 요청
post
dApp에서 실행하고 싶은 작업을 정의하고, 정의된 작업의 requestId 를 발급합니다.
dApp 결과 조회
get
요청한 작업의 결과를 조회합니다.
에러 코드