executeTxAction

콘솔에서 정의한 TxAction을 실제 수행하기 위한 API입니다. 실제 동작은 스마트 컨트랙트의 함수를 호출하는 것과 같으므로, 응답 또한 해당 함수의 반환값에 따라 결정됩니다. 요청의 Body Parameter는 매핑된 action의 타입에 따라 달라질 수 있기 때문에, 루니버스 콘솔의 Tx Action탭에서 생성된 action의 상세정보를 참고하시기 바랍니다.

Path Params
string
required

콘솔에서 TxAction 생성시 정의한 액션의 이름.

Body Params
string
required

UUID v4 형식의 트랜잭션의 ID. 생성하고자 하는 transaction의 ID를 지정하기 위한 필드입니다. ID는 해당 네트워크 내부에서 고유 해야 하며, 향후 생성된 트랜잭션의 결과 확인, 이력 조회 등에서 트랜잭션의 구분자로 사용됩니다.

string
required

트랜잭션을 실제 전송하는데 사용할 계정의 주소. 만약 호출한 action이 스마트 컨트랙트의 상태를 변경하지 않는 단순 조회 기능인 경우 from 계정의 타입(EOA 또는 DEOA)에 상관 없이 별도의 서명이 필요하지 않기 때문에 action 호출의 결과가 바로 반환됩니다. 만약 해당 action이 스마트 컨트랙트의 상태를 변경하는 트랜잭션인 경우, from 계정에 EOA 타입의 계정 주소를 입력하면 실제 action이 수행되지 않고 raw 트랜잭션이 응답되며 이를 서명하여 다시 제출하는 과정이 필요합니다.
DEOA 타입의 계정 주소로 action을 호출하는 경우 원격 서명 되어 처리되므로 별도의 서명 과정이 필요하지 않습니다. 단, 응답에 포함된 결과는 트랜잭션 제출에 대한 성공 실패 여부이므로, 실제 트랜잭션이 정상적으로 처리되었는지 여부는 callbackUrl을 통한 결과 수신 또는 receipt 조회를 통해 최종 확인할 수 있습니다.

string
required

트랜잭션의 수신 계정. 트랜잭션의 타입에 따라 수신자 계정을 입력해야 하는 함수를 호출하는 경우 대상 계정을 지정하기 위해 사용합니다(예: 토큰 전송 트랜잭션).

string
required

수행할 함수의 input 파라미터. 트랜잭션 action 및 연동된 함수에 따라 다른 값을 가집니다. 루니버스 콘솔의 Tx Action 탭에서 사용하고자 하는 action에 정의된 input 객체(object) 예시를 참고하실 수 있습니다.

string

트랜잭션의 결과를 받을 callbackUrl. callbackUrl의 endpoint를 별도로 구현하여 사용할 수 있습니다. Callback 요청 형식에 관한 상세 내용은 여기를 참조해주세요.

Response

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json