aboutsummaryrefslogtreecommitdiffstats
path: root/packages/subproviders/src/subproviders/eth_lightwallet.ts
blob: fedcc9578e6111bdd588351e72dbc24cee9c1ae5 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
import { assert } from '@0xproject/assert';
import { ECSignatureBuffer } from '@0xproject/types';
import { addressUtils } from '@0xproject/utils';
import * as lightwallet from 'eth-lightwallet';
import EthereumTx = require('ethereumjs-tx');
import * as _ from 'lodash';

import { PartialTxParams, WalletSubproviderErrors } from '../types';

import { BaseWalletSubprovider } from './base_wallet_subprovider';

/*
 * This class implements the [web3-provider-engine](https://github.com/MetaMask/provider-engine) subprovider interface.
 * This subprovider intercepts all account related RPC requests (e.g message/transaction signing, etc...) and
 * re-routes them to [eth-lightwallet](https://github.com/ConsenSys/eth-lightwallet).
 */
export class EthLightwalletSubprovider extends BaseWalletSubprovider {
    private _signing: lightwallet.signing;
    private _keystore: lightwallet.keystore;
    private _pwDerivedKey: Uint8Array;
    /**
     * Instantiates a EthLightwalletSubprovider
     * @param signing The lightwallet module containing signing functions
     * @param keystore An instance of the lightwallet keystore
     * @param pwDerivedKey The users password derived key
     */
    constructor(signing: lightwallet.signing, keystore: lightwallet.keystore, pwDerivedKey: Uint8Array) {
        super();

        this._signing = signing;
        this._keystore = keystore;
        this._pwDerivedKey = pwDerivedKey;
    }
    /**
     * Retrieve the accounts associated with the eth-lightwallet instance.
     * This method is implicitly called when issuing a `eth_accounts` JSON RPC request
     * via your providerEngine instance.
     *
     * @return An array of accounts
     */
    public async getAccountsAsync(): Promise<string[]> {
        const accounts = this._keystore.getAddresses();
        return accounts;
    }
    /**
     * Signs a transaction with the account specificed by the `from` field in txParams.
     * If you've added this Subprovider to your app's provider, you can simply send
     * an `eth_sendTransaction` JSON RPC request, and this method will be called auto-magically.
     * If you are not using this via a ProviderEngine instance, you can call it directly.
     * @param txParams Parameters of the transaction to sign
     * @return Signed transaction hex string
     */
    public async signTransactionAsync(txParams: PartialTxParams): Promise<string> {
        if (_.isUndefined(txParams.from) || !addressUtils.isAddress(txParams.from)) {
            throw new Error(WalletSubproviderErrors.FromAddressMissingOrInvalid);
        }

        const tx = new EthereumTx(txParams);
        const txHex = tx.serialize().toString('hex');
        let signedTxHex: string = this._signing.signTx(
            this._keystore,
            this._pwDerivedKey,
            txHex,
            txParams.from,
        );

        signedTxHex = `0x${signedTxHex}`;

        return signedTxHex;
    }
    /**
     * Sign a personal Ethereum signed message. The signing account will be the account
     * associated with the provided address.
     * If you've added the EthLightwalletSubprovider to your app's provider, you can simply send an `eth_sign`
     * or `personal_sign` JSON RPC request, and this method will be called auto-magically.
     * If you are not using this via a ProviderEngine instance, you can call it directly.
     * @param data Hex string message to sign
     * @param address Address of the account to sign with
     * @return Signature hex string (order: rsv)
     */
    public async signPersonalMessageAsync(data: string, address: string): Promise<string> {
        if (_.isUndefined(data)) {
            throw new Error(WalletSubproviderErrors.DataMissingForSignPersonalMessage);
        }
        assert.isHexString('data', data);
        assert.isETHAddressHex('address', address);
        const result: ECSignatureBuffer = await this._signing.signMsgHash(
            this._keystore,
            this._pwDerivedKey,
            data,
            address,
        );

        const signature = this._signing.concatSig(result);

        return signature;
    }
}