package api import ( "context" "github.com/ethereum/go-ethereum/accounts/keystore" gethcommon "github.com/ethereum/go-ethereum/common" "github.com/status-im/status-go/geth/common" "github.com/status-im/status-go/geth/params" ) // StatusAPI provides API to access Status related functionality. type StatusAPI struct { b *StatusBackend } // NewStatusAPI create a new StatusAPI instance func NewStatusAPI() *StatusAPI { return &StatusAPI{ b: NewStatusBackend(), } } // NodeManager returns reference to node manager func (api *StatusAPI) NodeManager() common.NodeManager { return api.b.NodeManager() } // AccountManager returns reference to account manager func (api *StatusAPI) AccountManager() common.AccountManager { return api.b.AccountManager() } // JailManager returns reference to jail func (api *StatusAPI) JailManager() common.JailManager { return api.b.JailManager() } // TxQueueManager returns reference to account manager func (api *StatusAPI) TxQueueManager() common.TxQueueManager { return api.b.TxQueueManager() } // StartNode start Status node, fails if node is already started func (api *StatusAPI) StartNode(config *params.NodeConfig) error { nodeStarted, err := api.b.StartNode(config) if err != nil { return err } <-nodeStarted return nil } // StartNodeAsync start Status node, fails if node is already started // Returns immediately w/o waiting for node to start (see node.ready) func (api *StatusAPI) StartNodeAsync(config *params.NodeConfig) (<-chan struct{}, error) { return api.b.StartNode(config) } // StopNode stop Status node. Stopped node cannot be resumed. func (api *StatusAPI) StopNode() error { nodeStopped, err := api.b.StopNode() if err != nil { return err } <-nodeStopped return nil } // StopNodeAsync stop Status node. Stopped node cannot be resumed. // Returns immediately, w/o waiting for node to stop (see node.stopped) func (api *StatusAPI) StopNodeAsync() (<-chan struct{}, error) { return api.b.StopNode() } // RestartNode restart running Status node, fails if node is not running func (api *StatusAPI) RestartNode() error { nodeStarted, err := api.b.RestartNode() if err != nil { return err } <-nodeStarted // do not return up until backend is ready return nil } // RestartNodeAsync restart running Status node, in async manner func (api *StatusAPI) RestartNodeAsync() (<-chan struct{}, error) { return api.b.RestartNode() } // ResetChainData remove chain data from data directory. // Node is stopped, and new node is started, with clean data directory. func (api *StatusAPI) ResetChainData() error { nodeStarted, err := api.b.ResetChainData() if err != nil { return err } <-nodeStarted // do not return up until backend is ready return nil } // ResetChainDataAsync remove chain data from data directory, in async manner func (api *StatusAPI) ResetChainDataAsync() (<-chan struct{}, error) { return api.b.ResetChainData() } // CallRPC executes RPC request on node's in-proc RPC server func (api *StatusAPI) CallRPC(inputJSON string) string { return api.b.CallRPC(inputJSON) } // CreateAccount creates an internal geth account // BIP44-compatible keys are generated: CKD#1 is stored as account key, CKD#2 stored as sub-account root // Public key of CKD#1 is returned, with CKD#2 securely encoded into account key file (to be used for // sub-account derivations) func (api *StatusAPI) CreateAccount(password string) (address, pubKey, mnemonic string, err error) { return api.b.AccountManager().CreateAccount(password) } // CreateChildAccount creates sub-account for an account identified by parent address. // CKD#2 is used as root for master accounts (when parentAddress is ""). // Otherwise (when parentAddress != ""), child is derived directly from parent. func (api *StatusAPI) CreateChildAccount(parentAddress, password string) (address, pubKey string, err error) { return api.b.AccountManager().CreateChildAccount(parentAddress, password) } // RecoverAccount re-creates master key using given details. // Once master key is re-generated, it is inserted into keystore (if not already there). func (api *StatusAPI) RecoverAccount(password, mnemonic string) (address, pubKey string, err error) { return api.b.AccountManager().RecoverAccount(password, mnemonic) } // VerifyAccountPassword tries to decrypt a given account key file, with a provided password. // If no error is returned, then account is considered verified. func (api *StatusAPI) VerifyAccountPassword(keyStoreDir, address, password string) (*keystore.Key, error) { return api.b.AccountManager().VerifyAccountPassword(keyStoreDir, address, password) } // SelectAccount selects current account, by verifying that address has corresponding account which can be decrypted // using provided password. Once verification is done, decrypted key is injected into Whisper (as a single identity, // all previous identities are removed). func (api *StatusAPI) SelectAccount(address, password string) error { // FIXME(oleg-raev): This method doesn't make stop, it rather resets its cells to an initial state // and should be properly renamed, for example: ResetCells api.b.jailManager.Stop() return api.b.AccountManager().SelectAccount(address, password) } // Logout clears whisper identities func (api *StatusAPI) Logout() error { api.b.jailManager.Stop() return api.b.AccountManager().Logout() } // SendTransaction creates a new transaction and waits until it's complete. func (api *StatusAPI) SendTransaction(ctx context.Context, args common.SendTxArgs) (gethcommon.Hash, error) { return api.b.SendTransaction(ctx, args) } // CompleteTransaction instructs backend to complete sending of a given transaction func (api *StatusAPI) CompleteTransaction(id common.QueuedTxID, password string) (gethcommon.Hash, error) { return api.b.txQueueManager.CompleteTransaction(id, password) } // CompleteTransactions instructs backend to complete sending of multiple transactions func (api *StatusAPI) CompleteTransactions(ids []common.QueuedTxID, password string) map[common.QueuedTxID]common.RawCompleteTransactionResult { return api.b.txQueueManager.CompleteTransactions(ids, password) } // DiscardTransaction discards a given transaction from transaction queue func (api *StatusAPI) DiscardTransaction(id common.QueuedTxID) error { return api.b.txQueueManager.DiscardTransaction(id) } // DiscardTransactions discards given multiple transactions from transaction queue func (api *StatusAPI) DiscardTransactions(ids []common.QueuedTxID) map[common.QueuedTxID]common.RawDiscardTransactionResult { return api.b.txQueueManager.DiscardTransactions(ids) } // JailParse creates a new jail cell context, with the given chatID as identifier. // New context executes provided JavaScript code, right after the initialization. func (api *StatusAPI) JailParse(chatID string, js string) string { return api.b.jailManager.Parse(chatID, js) } // JailCall executes given JavaScript function w/i a jail cell context identified by the chatID. func (api *StatusAPI) JailCall(chatID, this, args string) string { return api.b.jailManager.Call(chatID, this, args) } // JailBaseJS allows to setup initial JavaScript to be loaded on each jail.Parse() func (api *StatusAPI) JailBaseJS(js string) { api.b.jailManager.BaseJS(js) } // Notify and send message func (api *StatusAPI) Notify(token string) string { api.b.notification.Notify(token) api.b.notification.Send() return token }