package hw.trezor.messages.stellar

Get desktop application:
View/edit binary Protocol Buffers messages

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required string destination_account = 2

  destination account address

* Response: Address for the given index @end

• required string address = 1

  Address in Stellar format (base32 of a pubkey with checksum)

• optional bytes mac = 2

  Address authentication code

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required string trusted_account = 2

  The account being allowed to hold the asset

• required StellarAssetType asset_type = 3

• optional string asset_code = 4

  human-readable asset code

• required bool is_authorized = 5

* Describes a Stellar asset @embed

Used in: StellarChangeTrustOp, StellarCreatePassiveSellOfferOp, StellarManageBuyOfferOp, StellarManageSellOfferOp, StellarPathPaymentStrictReceiveOp, StellarPathPaymentStrictSendOp, StellarPaymentOp

• required StellarAssetType type = 1

• optional string code = 2

  for non-native assets, string describing the code

• optional string issuer = 3

  issuing address

https://github.com/stellar/stellar-core/blob/02d26858069de7c0eefe065056fb0a19bf72ea56/src/xdr/Stellar-ledger-entries.x#L25-L31

Used in: StellarAllowTrustOp, StellarAsset

• NATIVE = 0

• ALPHANUM4 = 1

• ALPHANUM12 = 2

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required uint64 bump_to = 2

  new sequence number

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required StellarAsset asset = 2

• required uint64 limit = 3

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required bytes balance_id = 2

  balance id, 4 bytes of type flag, 32 bytes of data

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required string new_account = 2

  account address to create

• required sint64 starting_balance = 3

  initial starting balance for the new account

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required StellarAsset selling_asset = 2

• required StellarAsset buying_asset = 3

• required sint64 amount = 4

• required uint32 price_n = 5

  Price numerator

• required uint32 price_d = 6

  Price denominator

* Request: Address at the specified index @start @next StellarAddress

• repeated uint32 address_n = 1

  BIP-32 path. For compatibility with other wallets, must be m/44'/148'/index'

• optional bool show_display = 2

  optionally show on display before sending the result

• optional bool chunkify = 3

  display the address in chunks of 4 characters

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L521 @embed

Used in: StellarInvokeHostFunctionOp

• required StellarHostFunction.StellarHostFunctionType type = 1

• optional StellarInvokeContractArgs invoke_contract = 2

Used in: StellarHostFunction

• HOST_FUNCTION_TYPE_INVOKE_CONTRACT = 0

  We only support this type of host function at this time.

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L515 @embed

Used in: StellarHostFunction, StellarSorobanAuthorizedFunction

• required string contract_address = 1

• required string function_name = 2

• repeated StellarSCVal args = 3

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarTxExtRequest

• optional string source_account = 1

  (optional) source account address

• required StellarHostFunction function = 2

• repeated StellarSorobanAuthorizationEntry auth = 3

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required StellarAsset selling_asset = 2

• required StellarAsset buying_asset = 3

• required sint64 amount = 4

• required uint32 price_n = 5

  Price numerator

• required uint32 price_d = 6

  Price denominator

• required uint64 offer_id = 7

  Offer ID for updating an existing offer

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required string key = 2

• optional bytes value = 3

  64 bytes of arbitrary data

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required StellarAsset selling_asset = 2

• required StellarAsset buying_asset = 3

• required sint64 amount = 4

• required uint32 price_n = 5

  Price numerator

• required uint32 price_d = 6

  Price denominator

• required uint64 offer_id = 7

  Offer ID for updating an existing offer

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source address

• required StellarAsset send_asset = 2

  asset we pay with

• required sint64 send_max = 3

  the maximum amount of sendAsset to send (excluding fees)

• required string destination_account = 4

  recipient of the payment

• required StellarAsset destination_asset = 5

  what they end up with

• required sint64 destination_amount = 6

  amount they end up with

• repeated StellarAsset paths = 7

  additional hops it must go through to get there

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source address

• required StellarAsset send_asset = 2

  asset we pay with

• required sint64 send_amount = 3

  amount of sendAsset to send (excluding fees)

• required string destination_account = 4

  recipient of the payment

• required StellarAsset destination_asset = 5

  what they end up with

• required sint64 destination_min = 6

  the minimum amount of dest asset to be received

• repeated StellarAsset paths = 7

  additional hops it must go through to get there

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• required string destination_account = 2

  destination account address

• required StellarAsset asset = 3

  asset involved in the operation

• required sint64 amount = 4

  amount of the given asset to pay

* Describes a Stellar SCValue See https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-contract.x#L229 @embed

Used in: StellarInvokeContractArgs, StellarSCVal.StellarSCValMapEntry, StellarSorobanAddressCredentials

• required StellarSCVal.StellarSCValType type = 1

• optional bool b = 2

  SCV_BOOL

• optional uint32 u32 = 4

  SCV_U32

• optional sint32 i32 = 5

  SCV_I32

• optional uint64 u64 = 6

  SCV_U64

• optional sint64 i64 = 7

  SCV_I64

• optional uint64 timepoint = 8

  SCV_TIMEPOINT

• optional uint64 duration = 9

  SCV_DURATION

• optional StellarSCVal.StellarUInt128Parts u128 = 10

  SCV_U128

• optional StellarSCVal.StellarInt128Parts i128 = 11

  SCV_I128

• optional StellarSCVal.StellarUInt256Parts u256 = 12

  SCV_U256

• optional StellarSCVal.StellarInt256Parts i256 = 13

  SCV_I256

• optional bytes bytes = 14

  SCV_BYTES

• optional bytes string = 15

  SCV_STRING - The bytes contained in Strings do not necessarily conform to any standard text encoding such as ASCII or Unicode UTF-8. They are plain uninterpreted bytes. See: https://developers.stellar.org/docs/learn/fundamentals/contract-development/types/built-in-types

• optional string symbol = 16

  SCV_SYMBOL

• repeated StellarSCVal vec = 17

  SCV_VEC

• repeated StellarSCVal.StellarSCValMapEntry map = 18

  SCV_MAP

• optional string address = 19

  SCV_ADDRESS

Used in: StellarSCVal

• required sint64 hi = 1

• required uint64 lo = 2

Used in: StellarSCVal

• required sint64 hi_hi = 1

• required uint64 hi_lo = 2

• required uint64 lo_hi = 3

• required uint64 lo_lo = 4

Used in: StellarSCVal

• required StellarSCVal key = 1

• required StellarSCVal value = 2

Used in: StellarSCVal

• SCV_BOOL = 0

• SCV_VOID = 1

• SCV_U32 = 3

• SCV_I32 = 4

• SCV_U64 = 5

• SCV_I64 = 6

• SCV_TIMEPOINT = 7

• SCV_DURATION = 8

• SCV_U128 = 9

• SCV_I128 = 10

• SCV_U256 = 11

• SCV_I256 = 12

• SCV_BYTES = 13

• SCV_STRING = 14

• SCV_SYMBOL = 15

• SCV_VEC = 16

• SCV_MAP = 17

• SCV_ADDRESS = 18

Used in: StellarSCVal

• required uint64 hi = 1

• required uint64 lo = 2

Used in: StellarSCVal

• required uint64 hi_hi = 1

• required uint64 hi_lo = 2

• required uint64 lo_hi = 3

• required uint64 lo_lo = 4

* Request: ask device to confirm this operation type @next StellarTxOpRequest @next StellarSignedTx

• optional string source_account = 1

  (optional) source account address

• optional string inflation_destination_account = 2

  (optional) inflation destination address

• optional uint32 clear_flags = 3

• optional uint32 set_flags = 4

• optional uint32 master_weight = 5

• optional uint32 low_threshold = 6

• optional uint32 medium_threshold = 7

• optional uint32 high_threshold = 8

• optional string home_domain = 9

• optional StellarSetOptionsOp.StellarSignerType signer_type = 10

• optional bytes signer_key = 11

• optional uint32 signer_weight = 12

https://github.com/stellar/stellar-core/blob/02d26858069de7c0eefe065056fb0a19bf72ea56/src/xdr/Stellar-types.x#L32-L37

Used in: StellarSetOptionsOp

• ACCOUNT = 0

• PRE_AUTH = 1

• HASH = 2

* Request: ask device to sign a Soroban authorization payload The device signs the HashIDPreimage variant selected by envelope_type. Currently only ENVELOPE_TYPE_SOROBAN_AUTHORIZATION_WITH_ADDRESS is supported (Protocol 27, CAP-71): the payload signed for SOROBAN_CREDENTIALS_ADDRESS_V2 credentials, which binds the signature to the authorizing address. @start @next StellarSorobanAuthorizationSignature @next Failure

• repeated uint32 address_n = 1

  BIP-32 path. For compatibility with other wallets, must be m/44'/148'/index'

• required string network_passphrase = 2

  passphrase of the network the authorization is valid on; the preimage's networkID is derived from it

• required StellarSignSorobanAuthorization.StellarSorobanAuthorizationEnvelopeType envelope_type = 3

  the HashIDPreimage variant to sign

• optional StellarSignSorobanAuthorization.StellarSorobanAuthorizationWithAddress soroban_authorization_with_address = 4

  union arm for ENVELOPE_TYPE_SOROBAN_AUTHORIZATION_WITH_ADDRESS

Soroban authorization cases of the EnvelopeType XDR enum, see https://github.com/stellar/stellar-xdr/blob/v27.0/Stellar-ledger-entries.x#L656

Used in: StellarSignSorobanAuthorization

• ENVELOPE_TYPE_SOROBAN_AUTHORIZATION_WITH_ADDRESS = 10

https://github.com/stellar/stellar-xdr/blob/v27.0/Stellar-transaction.x#L753

Used in: StellarSignSorobanAuthorization

• required sint64 nonce = 1

  replay-protection nonce of the credentials

• required uint32 signature_expiration_ledger = 2

  ledger sequence until which the authorization remains valid

• required string address = 3

  The address whose credentials are being provided: either the device account itself, or e.g. a contract account of which the device is a signer, or, for a CAP-71 delegate signature, the entry's top-level address.

• required StellarSorobanAuthorizedInvocation invocation = 4

  the authorized invocation tree

* Request: ask device to sign Stellar transaction @start @next StellarTxOpRequest

• repeated uint32 address_n = 2

  BIP-32 path. For compatibility with other wallets, must be m/44'/148'/index'

• required string network_passphrase = 3

  passphrase for signing messages on the destination network

• required string source_account = 4

  source account address

• required uint32 fee = 5

  Fee (in stroops) for the transaction

• required uint64 sequence_number = 6

  transaction sequence number

• required uint32 timebounds_start = 8

  unix timestamp (client must truncate this to 32 bits)

• required uint32 timebounds_end = 9

  unix timestamp (client must truncate this to 32 bits)

• required StellarSignTx.StellarMemoType memo_type = 10

  type of memo attached to the transaction

• optional string memo_text = 11

  up to 28 characters (4 bytes are for length)

• optional uint64 memo_id = 12

  8-byte uint64

• optional bytes memo_hash = 13

  32 bytes representing a hash

• required uint32 num_operations = 14

  number of operations in this transaction

• optional common.PaymentRequest payment_req = 15

  SLIP-24 payment request

https://github.com/stellar/stellar-core/blob/02d26858069de7c0eefe065056fb0a19bf72ea56/src/xdr/Stellar-transaction.x#L506-L513

Used in: StellarSignTx

• NONE = 0

• TEXT = 1

• ID = 2

• HASH = 3

• RETURN = 4

* Response: signature for transaction @end

• required bytes public_key = 1

  public key for the private key used to sign data

• required bytes signature = 2

  signature suitable for sending to the Stellar network

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L564 @embed

Used in: StellarSorobanCredentials

• required string address = 1

• required sint64 nonce = 2

• required uint32 signature_expiration_ledger = 3

• required StellarSCVal signature = 4

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L591 @embed

Used in: StellarInvokeHostFunctionOp

• required StellarSorobanCredentials credentials = 1

• required StellarSorobanAuthorizedInvocation root_invocation = 2

* Response: signature for a Soroban authorization entry @end

• required bytes public_key = 1

  public key for the private key used to sign the authorization

• required bytes signature = 2

  ed25519 signature of the authorization payload

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L540 @embed

Used in: StellarSorobanAuthorizedInvocation

• required StellarSorobanAuthorizedFunction.StellarSorobanAuthorizedFunctionType type = 1

• optional StellarInvokeContractArgs contract_fn = 2

Used in: StellarSorobanAuthorizedFunction

• SOROBAN_AUTHORIZED_FUNCTION_TYPE_CONTRACT_FN = 0

* https://github.com/stellar/stellar-xdr/blob/v26.0/Stellar-transaction.x#L558 @embed

Used in: StellarSignSorobanAuthorization.StellarSorobanAuthorizationWithAddress, StellarSorobanAuthorizationEntry

• required StellarSorobanAuthorizedFunction function = 1

• repeated StellarSorobanAuthorizedInvocation sub_invocations = 2

* https://github.com/stellar/stellar-xdr/blob/v27.0/Stellar-transaction.x#L593 @embed

Used in: StellarSorobanAuthorizationEntry

• required StellarSorobanCredentials.StellarSorobanCredentialsType type = 1

• optional StellarSorobanAddressCredentials address_v2 = 2

Used in: StellarSorobanCredentials

• SOROBAN_CREDENTIALS_SOURCE_ACCOUNT = 0

• SOROBAN_CREDENTIALS_ADDRESS_V2 = 2

* Request: ask device to add extra data to the transaction @next StellarSignedTx

• required sint32 v = 1

  For soroban transactions, v = 1, otherwise v = 0

• optional bytes soroban_data = 2

  SorobanTransactionData XDR, required when v == 1. Passed through as raw bytes and committed via the signed digest. Contains the footprint (ledger entries the tx may access), resource limits, and the resourceFee -- none of which grant authority: the footprint only *declares* accessed entries (it cannot authorize state changes; those are gated by StellarInvokeHostFunctionOp.auth, shown on-device), and the resourceFee is a component of the already-confirmed total fee. A tampered value can only fail the tx or waste fees up to that total.

* Response: device is ready for client to send StellarTxExt @next StellarTxExt

(message has no fields)

* Response: device is ready for client to send the next operation @next StellarPaymentOp @next StellarCreateAccountOp @next StellarPathPaymentStrictReceiveOp @next StellarPathPaymentStrictSendOp @next StellarManageSellOfferOp @next StellarManageBuyOfferOp @next StellarCreatePassiveSellOfferOp @next StellarSetOptionsOp @next StellarChangeTrustOp @next StellarAllowTrustOp @next StellarAccountMergeOp @next StellarManageDataOp @next StellarBumpSequenceOp @next StellarClaimClaimableBalanceOp @next StellarInvokeHostFunctionOp

(message has no fields)