#!/usr/bin/env python3 # # MMGen Wallet, a terminal-based cryptocurrency wallet # Copyright (C)2013-2024 The MMGen Project # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . """ tool.rpc: JSON/RPC routines for the 'mmgen-tool' utility """ from .common import tool_cmd_base,options_annot_str from ..tw.view import TwView from ..tw.txhistory import TwTxHistory class tool_cmd(tool_cmd_base): "tracking-wallet commands using the JSON-RPC interface" need_proto = True need_amt = True async def daemon_version(self): "print coin daemon version" from ..daemon import CoinDaemon d = CoinDaemon( cfg=self.cfg, proto=self.proto, test_suite=self.cfg.test_suite ) if self.proto.base_proto == 'Monero': from ..proto.xmr.rpc import MoneroRPCClient r = MoneroRPCClient( cfg = self.cfg, proto = self.proto, daemon = d, host = 'localhost', port = d.rpc_port, user = None, passwd = None, ignore_daemon_version = True ) else: from ..rpc import rpc_init r = await rpc_init(self.cfg, self.proto, ignore_daemon_version=True, ignore_wallet=True) return f'{d.coind_name} version {r.daemon_version} ({r.daemon_version_str})' async def getbalance(self, minconf: 'minimum number of confirmations' = 1, quiet: 'produce quieter output' = False, pager: 'send output to pager' = False ): "list confirmed/unconfirmed, spendable/unspendable balances in tracking wallet" from ..tw.bal import TwGetBalance return (await TwGetBalance(self.cfg,self.proto,minconf,quiet)).format(color=self.cfg.color) async def twops(self, obj,pager,reverse,detail,sort,age_fmt,interactive, **kwargs ): obj.reverse = reverse obj.age_fmt = age_fmt for k,v in kwargs.items(): setattr(obj,k,v) await obj.get_data(sort_key=sort,reverse_sort=reverse) if interactive: await obj.view_filter_and_sort() ret = True else: ret = await obj.format('detail' if detail else 'squeezed') if hasattr(obj,'twctl'): del obj.twctl return ret async def twview(self, pager: 'send output to pager' = False, reverse: 'reverse order of unspent outputs' = False, wide: 'display data in wide tabular format' = False, minconf: 'minimum number of confirmations' = 1, sort: 'unspent output sort order ' + options_annot_str(TwView.sort_funcs) = 'age', age_fmt: 'format for the Age/Date column ' + options_annot_str(TwView.age_fmts) = 'confs', interactive: 'enable interactive operation' = False, show_mmid: 'show MMGen IDs along with coin addresses' = True ): "view tracking wallet unspent outputs" from ..tw.unspent import TwUnspentOutputs obj = await TwUnspentOutputs(self.cfg,self.proto,minconf=minconf) return await self.twops( obj,pager,reverse,wide,sort,age_fmt,interactive, show_mmid = show_mmid ) async def txhist(self, pager: 'send output to pager' = False, reverse: 'reverse order of transactions' = False, detail: 'produce detailed, non-tabular output' = False, sinceblock: 'display transactions starting from this block' = 0, sort: 'transaction sort order ' + options_annot_str(TwTxHistory.sort_funcs) = 'age', age_fmt: 'format for the Age/Date column ' + options_annot_str(TwView.age_fmts) = 'confs', interactive: 'enable interactive operation' = False ): "view transaction history of tracking wallet" obj = await TwTxHistory(self.cfg,self.proto,sinceblock=sinceblock) return await self.twops( obj,pager,reverse,detail,sort,age_fmt,interactive ) async def listaddress(self, mmgen_addr:str, wide: 'display data in wide tabular format' = False, minconf: 'minimum number of confirmations' = 1, showcoinaddr: 'display coin address in addition to MMGen ID' = True, age_fmt: 'format for the Age/Date column ' + options_annot_str(TwView.age_fmts) = 'confs' ): "list the specified MMGen address in the tracking wallet and its balance" return await self.listaddresses( mmgen_addrs = mmgen_addr, wide = wide, minconf = minconf, showcoinaddrs = showcoinaddr, age_fmt = age_fmt ) async def listaddresses(self, pager: 'send output to pager' = False, reverse: 'reverse order of unspent outputs' = False, wide: 'display data in wide tabular format' = False, minconf: 'minimum number of confirmations' = 1, sort: 'address sort order ' + options_annot_str(['reverse','mmid','addr','amt']) = '', age_fmt: 'format for the Age/Date column ' + options_annot_str(TwView.age_fmts) = 'confs', interactive: 'enable interactive operation' = False, mmgen_addrs: 'hyphenated range or comma-separated list of addresses' = '', showcoinaddrs:'display coin addresses in addition to MMGen IDs' = True, showempty: 'show addresses with no balances' = True, showused: 'show used addresses (tristate: 0=no, 1=yes, 2=all)' = 1, all_labels: 'show all addresses with labels' = False ): "list MMGen addresses in the tracking wallet and their balances" assert showused in (0,1,2), "‘showused’ must have a value of 0, 1 or 2" from ..tw.addresses import TwAddresses obj = await TwAddresses(self.cfg,self.proto,minconf=minconf,mmgen_addrs=mmgen_addrs) return await self.twops( obj,pager,reverse,wide,sort,age_fmt,interactive, showcoinaddrs = showcoinaddrs, showempty = showempty, showused = showused, all_labels = all_labels ) async def add_label(self,mmgen_or_coin_addr:str,label:str): "add descriptive label for address in tracking wallet" from ..tw.ctl import TwCtl return await (await TwCtl(self.cfg,self.proto,mode='w')).set_comment(mmgen_or_coin_addr,label) async def remove_label(self,mmgen_or_coin_addr:str): "remove descriptive label for address in tracking wallet" await self.add_label( mmgen_or_coin_addr, '' ) return True async def remove_address(self,mmgen_or_coin_addr:str): "remove an address from tracking wallet" from ..tw.ctl import TwCtl # returns None on failure: ret = await (await TwCtl(self.cfg,self.proto,mode='w')).remove_address(mmgen_or_coin_addr) if ret: from ..util import msg msg(f'Address {ret!r} deleted from tracking wallet') return ret async def resolve_address(self,mmgen_or_coin_addr:str): "resolve an MMGen address in the tracking wallet to a coin address or vice-versa" from ..tw.ctl import TwCtl ret = await (await TwCtl(self.cfg,self.proto,mode='w')).resolve_address( mmgen_or_coin_addr ) if ret: from ..addr import is_coin_addr return ret.twmmid if is_coin_addr(self.proto,mmgen_or_coin_addr) else ret.coinaddr else: return False async def rescan_address(self,mmgen_or_coin_addr:str): "rescan an address in the tracking wallet to update its balance" from ..tw.ctl import TwCtl return await (await TwCtl(self.cfg,self.proto,mode='w')).rescan_address( mmgen_or_coin_addr ) async def rescan_blockchain(self, start_block: int = None, stop_block: int = None ): """ rescan the blockchain to update historical transactions in the tracking wallet NOTE: The rescanning process typically takes several hours and may be interrupted using Ctrl-C. An interrupted rescan may be resumed using the ‘start_block’ parameter. """ from ..tw.ctl import TwCtl await (await TwCtl(self.cfg,self.proto,mode='w')).rescan_blockchain(start_block,stop_block) return True async def twexport(self,include_amts=True,pretty=False,prune=False,warn_used=False,force=False): """ export a tracking wallet to JSON format NOTES: If ‘include_amts’ is true (the default), Ethereum balances will be restored from the dump upon import. For Bitcoin and forks, amount fields in the dump are ignored. If ‘pretty’ is true, JSON will be dumped in human-readable format to allow for editing of comment fields. If ‘prune’ is true, an interactive menu will be launched allowing the user to prune unwanted addresses before creating the JSON dump. Pruning has no effect on the existing tracking wallet. If ‘warn_used’ is true, the user will be prompted before pruning used addresses. If ‘force’ is true, any existing dump will be overwritten without prompting. """ from ..tw.json import TwJSON await TwJSON.Export( self.cfg, self.proto, include_amts = include_amts, pretty = pretty, prune = prune, warn_used = warn_used, force_overwrite = force ) return True async def twimport(self,filename:str,ignore_checksum=False,batch=False): """ restore a tracking wallet from a JSON dump created by ‘twexport’ NOTES: If comment fields in the JSON dump have been edited, ‘ignore_checksum’ must be set to true. The restored tracking wallet will have correct balances but no record of historical transactions. These may be restored by running ‘mmgen-tool rescan_blockchain’. """ from ..tw.json import TwJSON await TwJSON.Import( self.cfg, self.proto, filename, ignore_checksum=ignore_checksum, batch=batch ) return True