ethereumSignTransaction.md

Ethereum: Sign transaction

Asks device to sign given transaction using the private key derived by given BIP32 path. User is asked to confirm all transaction details on Trezor.

ES6

const result = await TrezorConnect.ethereumSignTransaction(params);

CommonJS

TrezorConnect.ethereumSignTransaction(params).then(function(result) {

});

Params

Optional common params

flowtype

• path — obligatory string | Array<number> minimum length is 3. read more
• transaction - obligatory Object type of EthereumTransaction "0x" prefix for each field is optional

Example

TrezorConnect.ethereumSignTransaction({
    path: "m/44'/60'/0'",
    transaction: {
        to: "0x7314e0f1c0e28474bdb6be3e2c3e0453255188f8",
        value: "0xf4240",
        data: "0x01",
        chainId: 1,
        nonce: "0x0",
        gasLimit: "0x5208",
        gasPrice: "0xbebc200"
    }
});

Result

flowtype

{
    success: true,
    payload: {
        v: string, // hexadecimal string with "0x" prefix
        r: string, // hexadecimal string with "0x" prefix
        s: string, // hexadecimal string with "0x" prefix
    }
}

Error

{
    success: false,
    payload: {
        error: string // error message
    }
}

Migration from older version

version 4 and below

TrezorConnect.ethereumSignTx(
  "m/44'/60'/0'", // path
  "0",            // nonce - hexadecimal string without "0x" prefix
  "bebc200",      // gas_price - hexadecimal string without "0x" prefix
  "5208",         // gas_limit - hexadecimal string without "0x" prefix
  "7314e0f1c0e28474bdb6be3e2c3e0453255188f8", // address without "0x" prefix
  "f4240",     // value in wei, hexadecimal string without "0x" prefix
  "01",        // data, hexadecimal string OR null for no data without "0x" prefix
  1,           // chain id for EIP-155 - is only used in fw 1.4.2 and newer, older will ignore it
  function(result) {
      result.v // number
      result.r // hexadecimal string without "0x" prefix
      result.s // hexadecimal string without "0x" prefix
  }
)

version 5

// params are key-value pairs inside Object
TrezorConnect.signTransaction({ 
    path: "m/44'/60'/0'",
    transaction: {
        to: "0x7314e0f1c0e28474bdb6be3e2c3e0453255188f8",
        value: "0xf4240",
        data: "0x01",
        chainId: 1,
        nonce: "0x0",
        gasLimit: "0x5208",
        gasPrice: "0xbebc200"
    }
}).then(function(result) {
    result.v // hexadecimal string with "0x" prefix
    result.r // hexadecimal string with "0x" prefix
    result.s // hexadecimal string with "0x" prefix
})