COMMANDS.md

Stellar App Commands

Overview

Command name	INS	Description
GET_PUBLIC_KEY	0x02	Get public key given BIP32 path
SIGN_TX	0x04	Sign the raw transaction
GET_APP_CONFIGURATION	0x06	Get application configuration information
SIGN_HASH	0x08	Sign the hash
SIGN_SOROBAN_AUTHORIZATION	0x0A	Sign the Soroban Authorization

GET_PUBLIC_KEY

Command

CLA	INS	P1	P2	Lc	CData
0xE0	0x02	0x00	0x00 (no display) 0x01 (display)	1 + 4n	len(bip32_path) (1) || bip32_path{1} (4) || ... || bip32_path{n} (4)

Response

Response length (bytes)	SW	RData
32	0x9000	raw_ed25519_public_key (32)

SIGN_TX

Command

CLA	INS	P1	P2	Lc	CData
0xE0	0x04	0x00 (first) 0x80 (not_first)	0x00 (last) 0x80 (more)	1 + 4n + k Only the first data chunk contains bip32 path data	len(bip32_path) (1) || bip32_path{1} (4) || ... || bip32_path{n} (4) || transaction_chunk(k)

Response

Response length (bytes)	SW	RData
64	0x9000	signature (64)

GET_APP_CONFIGURATION

Command

CLA	INS	P1	P2	Lc	CData
0xE0	0x06	0x00	0x00	0x00	-

Response

Response length (bytes)	SW	RData
4	0x9000	HASH_SIGNING_ENABLED (1) || MAJOR (1) || MINOR (1) || PATCH (1) || RAW_DATA_MAX_SIZE (2)

SIGN_HASH

Command

CLA	INS	P1	P2	Lc	CData
0xE0	0x08	0x00	0x00	1 + 4n + 32	len(bip32_path) (1) || bip32_path{1} (4) || ... || bip32_path{n} (4) hash (32)

Response

Response length (bytes)	SW	RData
64	0x9000	signature (64)

SIGN_SOROBAN_AUTHORIZATION

Command

CLA	INS	P1	P2	Lc	CData
0xE0	0x0A	0x00 (first) 0x80 (not_first)	0x00 (last) 0x80 (more)	1 + 4n + k Only the first data chunk contains bip32 path data	len(bip32_path) (1) || bip32_path{1} (4) || ... || bip32_path{n} (4) || hash_id_preimage_chunk(k)

Response

Response length (bytes)	SW	RData
64	0x9000	signature (64)

Status Words

SW	SW name	Description
0x6125	SW_FORMATTING_FAIL	Failed to format the data
0x6985	SW_DENY	Rejected by user
0x6A87	SW_WRONG_DATA_LENGTH	Lc or minimum APDU lenght is incorrect
0x6B00	SW_WRONG_P1P2	Either P1 or P2 is incorrect
0x6D00	SW_INS_NOT_SUPPORTED	No command exists with INS
0x6E00	SW_CLA_NOT_SUPPORTED	Bad CLA used for this application
0xB002	SW_DISPLAY_ADDRESS_FAIL	Failed to display address
0xB003	SW_DISPLAY_TRANSACTION_HASH_FAIL	Failed to display transaction hash
0xB004	SW_DATA_TOO_LARGE	The data is too large to be processed
0xB005	SW_DATA_PARSING_FAIL	Failed to parse raw data
0xB006	SW_DATA_HASH_FAIL	Failed to compute hash digest of raw data
0xB007	SW_BAD_STATE	Security issue with bad state
0xB008	SW_SIGNATURE_FAIL	Generating signature failed
0xB009	SW_SWAP_CHECKING_FAIL	Failed to check swap params (maybe the data is invalid)
0x9000	SW_OK	Success