WEPIN Developer Documentation
WepinBlogContact
한국어
한국어
  • 시작하기
    • 소개
  • 위핀
    • 특징
    • 아키텍처
      • 키 생성
      • 서명
      • 키 백업
    • 워크스페이스
      • 앱 등록 및 키 발급
      • 네트워크 및 자산 추가
      • 위젯 디자인
    • 지원 블록체인
    • 계정 추상화
  • 로그인
    • 개요
    • 소셜 로그인 인증 프로바이더
      • Email/Password
      • Google
      • Apple
      • Discord
      • Naver
      • Facebook
      • Line
      • Kakao
    • 사용자 인터페이스
    • 로그인 일원화
    • 리소스
  • 위젯 연동
    • 사전 준비
    • Web: JavaScript SDK
      • 로그인
        • 설치
        • 초기화하기
        • 메서드
      • 핀 패드
        • 설치
        • 초기화하기
        • 메서드
      • 위젯
        • 설치
        • 초기화하기
        • 메서드
        • 확인하기
      • 프로바이더
        • Ethereum Provider
        • Kaia Provider
        • Solana Provider
        • Wagmi Connector
      • 월렛 어댑터
        • Solana Wallet Adapter
    • Android: Java & Kotlin SDK
      • 로그인
        • 설치
        • 초기화하기
        • 메서드
      • 핀 패드
        • 설치
        • 초기화하기
        • 메서드
      • 위젯
        • 설치
        • 초기화하기
        • 메서드
    • iOS: Swift SDK
      • 로그인
        • 설치
        • 초기화하기
        • 메서드
      • 핀 패드
        • 설치
        • 초기화하기
        • 메서드
      • 위젯
        • 설치
        • 초기화하기
        • 메서드
    • Flutter SDK
      • 로그인
        • 설치
        • 초기화하기
        • 메서드
      • 위젯
        • 설치
        • 초기화하기
        • 메서드
        • 확인하기
      • 핀 패드
        • 설치
        • 초기화하기
        • 메서드
    • React Native SDK
      • 로그인
        • 설치
        • 초기화
        • 메서드
    • Unity SDK
      • 설치
      • 초기화하기
      • 메서드
      • 확인하기
    • Compose Multiplatform SDK
      • 로그인
        • 설치
        • 초기화하기
        • 메서드
      • 위젯
        • 설치
        • 초기화하기
        • 메서드
        • 확인하기
  • API
    • 개요
    • 등록 절차
    • 로그인
    • 지갑 생성 및 관리
    • 토큰 및 NFT 조회
    • 트랜잭션
  • Deprecated
    • Web: JavaScript SDK
      • SDK
        • 설치
        • 초기화하기
        • 메서드
        • 확인하기
      • 프로바이더
        • Ethereum Provider
      • Wagmi Connector
    • Android: Java & Kotlin SDK
      • 설치
      • 초기화하기
      • 메서드
      • 확인하기
    • iOS: Swift SDK
      • 설치
      • 초기화하기
      • 메서드
      • 확인하기
    • Flutter SDK
      • 설치
      • 초기화하기
      • 메서드
      • 확인하기
    • React Native SDK
      • 설치
      • 초기화하기
      • 메서드
      • 확인하기
      • 프로바이더
        • EVM 호환
  • 기타
    • 로고 & 브랜드 가이드라인
Powered by GitBook
On this page
  • 트랜잭션에 필요한 정보 조회
  • 트랜잭션 서명하기
  • 트랜잭션 전송하기
  • Response

Was this helpful?

  1. API

트랜잭션

Previous토큰 및 NFT 조회NextWeb: JavaScript SDK

Last updated 28 days ago

Was this helpful?

트랜잭션 실행과 관련된 API는 3가지로 구성됩니다.

  • /v1/tx/prepare

  • /v1/tx/sign

  • /v1/tx/broadcast

상황에 따라 필요한 API들을 순서대로 수행할 수 있습니다.

  • 서명만 생성하는 경우: 트랜잭션에 필요한 정보 조회 ⇒ 트랜잭션 서명하기

  • 서명 생성과 브로드캐스트까지 한번에 실행하는 경우: 트랜잭션에 필요한 정보 조회 ⇒ 트랜잭션 전송하기

    • (Optional) 서명 생성 및 브로드캐스트까지 실행하는 경우: 트랜잭션에 필요한 정보 조회 ⇒ 트랜잭션 서명하기 ⇒ 트랜잭션 전송하기

트랜잭션에 필요한 정보 조회

트랜잭션에 필요한 수수료와 같은 정보를 조회 합니다.

POST /v1/tx/prepare HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}

Request

Parameter

Name
Type
Description
Required

userId

String

O

accountId

String

전송할 계정 ID. /v1/account의 response value

O

contract

String

토큰을 전송하려고 할 때, 전송할 토큰의 contract 주소

X

to

String

전송 받을 주소

O

isNft

String

ERC1155 | ERC721 NFT를 전송하려고 할 때, NFT scheme type 을 정의

X

tokenId

Number String

isNft 를 설정하고 NFT를 전송하려고 하는 경우 NFT 의 token ID

X

amount

String

전송할 코인 or 토큰의 개수. FT를 전송할 경우에 사용.

X

Response

Success Response

Name
Type
Description

Name

Type

Description

balance

String

전송하려는 계정의 현재 Balance

decimals

String

전송하려는 계정 코인의 decimals

symbol

String

전송하려는 계정 코인의 symbol

tokenId

Number

전송하려는 계정이 토큰 계정인 경우 tokenId

detail

TxData(Object)

Transaction에 필요한 데이터. 계정의 종류에 따라 다른 TxData 포맷을 가짐.

트랜잭션 서명하기

POST /v1/tx/sign HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}

Request

Parameter

Name
Type
Description
Required

userId

String

O

type

String

서명의 종류 •transaction (transaction) | msg_sign (Personal sign) | sign_data (typed data) • type에 따라 txData 의 구성이 다릅니다. •msg_sign | sign_data 는 현재 EVM transaction만 지원합니다.

O

pin

UVD

사용자의 UVD

O

walletId

String

사용자 지갑 ID

O

accountId

String

O

tokenId

String

토큰을 전송하는 경우 tokenId

X

isNft

String

ERC1155 | ERC721

X

contract

String

토큰을 전송하는 경우 contract 주소

X

txData

TxData(Object)

O

otpCode

Object

otp 인증 정보

X

Response

Success Response

Name
Type
Description

signatureResult

Object

sign result 값. 전송 네트워크 별로 다른 구조.

transaction

Object

전송 세부 내역

트랜잭션 전송하기

서명된 트랜잭션을 전송합니다.

POST /v1/tx/broadcast HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}

Request

Parameter

Name
Type
Description
Required

userId

String

O

type

String

서명의 종류 • transaction (transaction) | msg_sign (Personal sign) | sign_data (typed dat • type에 따라 txData 의 구성이 다릅니다. • msg_sign | sign_data 는 현재 EVM transaction만 지원합니다.

O

pin

UVD

사용자의 UVD

O

walletId

String

사용자 지갑 ID

O

accountId

String

O

tokenId

String

토큰을 전송하는 경우 tokenId

X

contract

String

토큰을 전송하는 경우 contract 주소

X

isNft

String

ERC1155 | ERC721

X

signatureResult

String | Object

/prepare /sign /broadcast 순서로 실행 시 이미 서명된 데이터를 Broadcast 하는 경우 서명(/tx/sign) 후 전달 받은 데이터(수정 없이 그대로 사용)

X

txData

TxData(Object)

X

otpCode

Object

otp 인증 정보

X

Response

Success Response

Name
Type
Description

signatureResult

Object

sign result 값. 전송 네트워크 별로 조금씩 다른 구조.

transaction

Object

전송 세부 내역

broadcastData

String

네트워크로 전송한 데이터

txid

String

Transaction ID

후 받은 Response의 userId

를 통해 조회한 데이터를 이용해서 실제 서명을 진행합니다. 필요에 따라서 TxData의 fee 값을 수정해서 서명을 진행할 수 있습니다. 서명 전에는 반드시 PIN Pad Library를 이용하여 사용자의 지갑 PIN 번호를 받아서 UVD를 함께 전송해야 합니다.

후 받은 Response의 userId

전송할 계정 ID. 의 accountId와 동일한 값이어야 함.

Transaction에 필요한 데이터. 계정의 종류에 따라 다른 TxData 포멧을 가짐. 를 통해 조회한 데이터 값을 포함.

후 받은 Response의 userId

전송할 계정 ID. 의 accountId와 동일한 값이어야 함.

/prepare /broadcast순서로 실행 시 서명을 하고 Broadcast 까지 한번에 하는 경우 Transaction에 필요한 데이터. 계정의 종류에 따라 다른 TxData 포멧을 가짐. 를 통해 조회한 데이터 값을 포함.

트랜잭션에 필요한 정보 조회
트랜잭션 서명하기
트랜잭션 전송하기
트랜잭션에 필요한 정보 조회
트랜잭션에 필요한 정보 조회
트랜잭션에 필요한 정보 조회
트랜잭션에 필요한 정보 조회
트랜잭션에 필요한 정보 조회
로그인
로그인
로그인