Package zephyr.wallet

Interface ZephyrWallet

All Known Implementing Classes:
ZephyrWalletFull, ZephyrWalletRpc

public interface ZephyrWallet
Zephyr wallet interface.
  • Field Details

    • DEFAULT_LANGUAGE

      static final String DEFAULT_LANGUAGE
      The mnemonic language of new random wallets when the config names none.
      See Also:
  • Method Details

    • addListener

      void addListener(ZephyrWalletListenerI listener)
      Register a listener to receive wallet notifications.
      Parameters:
      listener - is the listener to receive wallet notifications
    • removeListener

      void removeListener(ZephyrWalletListenerI listener)
      Unregister a listener to receive wallet notifications.
      Parameters:
      listener - is the listener to unregister
    • getListeners

      Set<ZephyrWalletListenerI> getListeners()
      Get the listeners registered with the wallet.
      Returns:
      the registered listeners
    • isViewOnly

      boolean isViewOnly()
      Indicates if the wallet is view-only, meaning it does not have the private spend key and can therefore only observe incoming outputs.
      Returns:
      {bool} true if the wallet is view-only, false otherwise
    • setDaemonConnection

      void setDaemonConnection(String uri)
      Set the wallet's daemon connection.
      Parameters:
      uri - is the uri of the daemon for the wallet to use
    • setDaemonConnection

      void setDaemonConnection(String uri, String username, String password)
      Set the wallet's daemon connection.
      Parameters:
      uri - is the daemon's URI
      username - is the username to authenticate with the daemon (optional)
      password - is the password to authenticate with the daemon (optional)
    • setDaemonConnection

      void setDaemonConnection(ZephyrRpcConnection daemonConnection)
      Set the wallet's daemon connection
      Parameters:
      daemonConnection - manages daemon connection information
    • getDaemonConnection

      ZephyrRpcConnection getDaemonConnection()
      Get the wallet's daemon connection.
      Returns:
      the wallet's daemon connection
    • setProxyUri

      void setProxyUri(String uri)
      Set the Tor proxy to the daemon.
      Parameters:
      uri - the Tor proxy URI
    • isConnectedToDaemon

      boolean isConnectedToDaemon()
      Indicates if the wallet is connected a daemon.
      Returns:
      true if the wallet is connected to a daemon, false otherwise
    • getVersion

      ZephyrVersion getVersion()
      Returns the wallet version.
      Returns:
      the wallet version
    • getPath

      String getPath()
      Get the wallet's path.
      Returns:
      the path the wallet can be opened with
    • getMnemonic

      String getMnemonic()
      Get the wallet's mnemonic phrase.
      Returns:
      the wallet's mnemonic phrase
    • getMnemonicLanguage

      String getMnemonicLanguage()
      Get the language of the wallet's mnemonic phrase.
      Returns:
      the language of the wallet's mnemonic phrase
    • getPrivateViewKey

      String getPrivateViewKey()
      Get the wallet's private view key.
      Returns:
      the wallet's private view key
    • getPrivateSpendKey

      String getPrivateSpendKey()
      Get the wallet's private spend key.
      Returns:
      the wallet's private spend key
    • getPublicViewKey

      String getPublicViewKey()
      Get the wallet's public view key.
      Returns:
      the wallet's public view key
    • getPublicSpendKey

      String getPublicSpendKey()
      Get the wallet's public spend key.
      Returns:
      the wallet's public spend key
    • getPrimaryAddress

      String getPrimaryAddress()
      Get the wallet's primary address.
      Returns:
      the wallet's primary address
    • getAddress

      String getAddress(int accountIdx, int subaddressIdx)
      Get the address of a specific subaddress.
      Parameters:
      accountIdx - specifies the account index of the address's subaddress
      subaddressIdx - specifies the subaddress index within the account
      Returns:
      the receive address of the specified subaddress
    • getAddressIndex

      ZephyrSubaddress getAddressIndex(String address)
      Get the account and subaddress index of the given address.
      Parameters:
      address - is the address to get the account and subaddress index from
      Returns:
      the account and subaddress indices
    • getIntegratedAddress

      ZephyrIntegratedAddress getIntegratedAddress()
      Get an integrated address based on this wallet's primary address and a randomly generated payment ID.
      Returns:
      the integrated address
    • getIntegratedAddress

      ZephyrIntegratedAddress getIntegratedAddress(String standardAddress, String paymentId)
      Get an integrated address based on the given standard address and payment ID. Uses the wallet's primary address if an address is not given. Generates a random payment ID if a payment ID is not given.
      Parameters:
      standardAddress - is the standard address to generate the integrated address from (wallet's primary address if null)
      paymentId - is the payment ID to generate an integrated address from (randomly generated if null)
      Returns:
      the integrated address
    • decodeIntegratedAddress

      ZephyrIntegratedAddress decodeIntegratedAddress(String integratedAddress)
      Decode an integrated address to get its standard address and payment id.
      Parameters:
      integratedAddress - is an integrated address to decode
      Returns:
      the decoded integrated address including standard address and payment id
    • getHeight

      long getHeight()
      Get the block height that the wallet is synced to.
      Returns:
      the block height that the wallet is synced to
    • getDaemonHeight

      long getDaemonHeight()
      Get the blockchain's height.
      Returns:
      the blockchain's height
    • getHeightByDate

      long getHeightByDate(int year, int month, int day)
      Get the blockchain's height by date as a conservative estimate for scanning.
      Parameters:
      year - year of the height to get
      month - month of the height to get as a number between 1 and 12
      day - day of the height to get as a number between 1 and 31
      Returns:
      the blockchain's approximate height at the given date
    • sync

      Synchronize the wallet with the daemon as a one-time synchronous process.
      Returns:
      the sync result
    • sync

      Synchronize the wallet with the daemon as a one-time synchronous process.
      Parameters:
      listener - listener to receive notifications during synchronization
      Returns:
      the sync result
    • sync

      ZephyrSyncResult sync(Long startHeight)
      Synchronize the wallet with the daemon as a one-time synchronous process.
      Parameters:
      startHeight - is the start height to sync from (defaults to the last synced block)
      Returns:
      the sync result
    • sync

      ZephyrSyncResult sync(Long startHeight, ZephyrWalletListenerI listener)
      Synchronize the wallet with the daemon as a one-time synchronous process.
      Parameters:
      startHeight - is the start height to sync from (defaults to the last synced block)
      listener - listener to receive notifications during synchronization
      Returns:
      the sync result
    • startSyncing

      void startSyncing()
      Start background synchronizing.
    • startSyncing

      void startSyncing(Long syncPeriodInMs)
      Start background synchronizing with a maximum period between syncs.
      Parameters:
      syncPeriodInMs - maximum period between syncs in milliseconds
    • stopSyncing

      void stopSyncing()
      Stop synchronizing the wallet with the daemon.
    • scanTxs

      void scanTxs(Collection<String> txHashes)
      Scan transactions by their hash/id.
      Parameters:
      txHashes - tx hashes to scan
    • rescanSpent

      void rescanSpent()
      Rescan the blockchain for spent outputs. Note: this can only be called with a trusted daemon. Example use case: peer multisig hex is import when connected to an untrusted daemon, so the wallet will not rescan spent outputs. Then the wallet connects to a trusted daemon. This method should be manually invoked to rescan outputs.
    • rescanBlockchain

      void rescanBlockchain()
      Rescan the blockchain from scratch, losing any information which cannot be recovered from the blockchain itself. WARNING: This method discards local wallet data like destination addresses, tx secret keys, tx notes, etc.
    • getBalance

      ZephyrBalance getBalance()
      Get the wallet's balance per asset. Amounts are in atomic units (10^12 per coin for every asset). The asset is an open string; the constants of the current assets are in ZephyrAssets.
      Returns:
      the wallet's balance per asset
    • getBalance

      Map<Integer,ZephyrBalance> getBalance(Integer accountIdx)
      Get the balance of each subaddress of an account, per asset. The map is keyed by subaddress index and may omit subaddresses that never held funds. Amounts are in atomic units (10^12 per coin for every asset). The asset is an open string; the constants of the current assets are in ZephyrAssets.
      Parameters:
      accountIdx - index of the account to get the balances of (required)
      Returns:
      the balance per asset of each subaddress of the account, keyed by subaddress index
    • getBalance

      BigInteger getBalance(String assetType, Integer accountIdx)
      Get an account's balance of one asset. Throws ZephyrError "Must provide account index" if the account index is null.
      Parameters:
      assetType - the asset to get the balance of (an open string, see ZephyrAssets)
      accountIdx - index of the account to get the balance of (required)
      Returns:
      the account's balance of the asset in atomic units (10^12 per coin)
    • getBalance

      BigInteger getBalance(String assetType, Integer accountIdx, Integer subaddressIdx)
      Get a subaddress's balance of one asset. Throws ZephyrError "Must provide account index" if the account index is null, which includes a subaddress index given without an account index.
      Parameters:
      assetType - the asset to get the balance of (an open string, see ZephyrAssets)
      accountIdx - index of the account to get the balance of (required)
      subaddressIdx - index of the subaddress to get the balance of (the whole account if null)
      Returns:
      the requested balance of the asset in atomic units (10^12 per coin)
    • getUnlockedBalance

      ZephyrBalance getUnlockedBalance()
      Get the wallet's unlocked balance per asset. Amounts are in atomic units (10^12 per coin for every asset). The asset is an open string; the constants of the current assets are in ZephyrAssets.
      Returns:
      the wallet's unlocked balance per asset
    • getUnlockedBalance

      Map<Integer,ZephyrBalance> getUnlockedBalance(Integer accountIdx)
      Get the unlocked balance of each subaddress of an account, per asset. The map is keyed by subaddress index and may omit subaddresses that never held funds. Amounts are in atomic units (10^12 per coin for every asset). The asset is an open string; the constants of the current assets are in ZephyrAssets.
      Parameters:
      accountIdx - index of the account to get the unlocked balances of (required)
      Returns:
      the unlocked balance per asset of each subaddress of the account, keyed by subaddress index
    • getUnlockedBalance

      BigInteger getUnlockedBalance(String assetType, Integer accountIdx)
      Get an account's unlocked balance of one asset. Throws ZephyrError "Must provide account index" if the account index is null.
      Parameters:
      assetType - the asset to get the unlocked balance of (an open string, see ZephyrAssets)
      accountIdx - index of the account to get the unlocked balance of (required)
      Returns:
      the account's unlocked balance of the asset in atomic units (10^12 per coin)
    • getUnlockedBalance

      BigInteger getUnlockedBalance(String assetType, Integer accountIdx, Integer subaddressIdx)
      Get a subaddress's unlocked balance of one asset. Throws ZephyrError "Must provide account index" if the account index is null, which includes a subaddress index given without an account index.
      Parameters:
      assetType - the asset to get the unlocked balance of (an open string, see ZephyrAssets)
      accountIdx - index of the account to get the unlocked balance of (required)
      subaddressIdx - index of the subaddress to get the unlocked balance of (the whole account if null)
      Returns:
      the requested unlocked balance of the asset in atomic units (10^12 per coin)
    • getReserveInfo

      ZephyrReserveInfo getReserveInfo()
      Get the state of the Zephyr reserve as the core reports it.
      Returns:
      the reserve state (amounts in atomic units, ratios dimensionless)
    • getCirculatingSupply

      Map<String,BigInteger> getCirculatingSupply()
      Get the circulating supply per asset.
      Returns:
      the circulating supply per asset in atomic units (10^12 per coin for every asset)
    • getAccounts

      List<ZephyrAccount> getAccounts()
      Get all accounts.
      Returns:
      all accounts
    • getAccounts

      List<ZephyrAccount> getAccounts(boolean includeSubaddresses)
      Get all accounts.
      Parameters:
      includeSubaddresses - specifies if subaddresses should be included
      Returns:
      all accounts
    • getAccounts

      List<ZephyrAccount> getAccounts(String tag)
      Get accounts with a given tag.
      Parameters:
      tag - is the tag for filtering accounts, all accounts if null
      Returns:
      all accounts with the given tag
    • getAccounts

      List<ZephyrAccount> getAccounts(boolean includeSubaddresses, String tag)
      Get accounts with a given tag.
      Parameters:
      includeSubaddresses - specifies if subaddresses should be included
      tag - is the tag for filtering accounts, all accounts if null
      Returns:
      all accounts with the given tag
    • getAccount

      ZephyrAccount getAccount(int accountIdx)
      Get an account without subaddress information.
      Parameters:
      accountIdx - specifies the account to get
      Returns:
      the retrieved account
    • getAccount

      ZephyrAccount getAccount(int accountIdx, boolean includeSubaddresses)
      Get an account.
      Parameters:
      accountIdx - specifies the account to get
      includeSubaddresses - specifies if subaddresses should be included
      Returns:
      the retrieved account
    • createAccount

      ZephyrAccount createAccount()
      Create a new account.
      Returns:
      the created account
    • createAccount

      ZephyrAccount createAccount(String label)
      Create a new account with a label for the first subaddress.
      Parameters:
      label - specifies the label for account's first subaddress (optional)
      Returns:
      the created account
    • setAccountLabel

      void setAccountLabel(int accountIdx, String label)
      Set an account label.
      Parameters:
      accountIdx - index of the account to set the label for
      label - the label to set
    • getSubaddresses

      List<ZephyrSubaddress> getSubaddresses(int accountIdx)
      Get all subaddresses in an account.
      Parameters:
      accountIdx - specifies the account to get subaddresses within
      Returns:
      the retrieved subaddresses
    • getSubaddresses

      List<ZephyrSubaddress> getSubaddresses(int accountIdx, List<Integer> subaddressIndices)
      Get subaddresses in an account.
      Parameters:
      accountIdx - specifies the account to get subaddresses within
      subaddressIndices - are specific subaddresses to get (optional)
      Returns:
      the retrieved subaddresses
    • getSubaddress

      ZephyrSubaddress getSubaddress(int accountIdx, int subaddressIdx)
      Get a subaddress.
      Parameters:
      accountIdx - specifies the index of the subaddress's account
      subaddressIdx - specifies index of the subaddress within the account
      Returns:
      the retrieved subaddress
    • createSubaddress

      ZephyrSubaddress createSubaddress(int accountIdx)
      Create a subaddress within an account and without a label.
      Parameters:
      accountIdx - specifies the index of the account to create the subaddress within
      Returns:
      the created subaddress
    • createSubaddress

      ZephyrSubaddress createSubaddress(int accountIdx, String label)
      Create a subaddress within an account.
      Parameters:
      accountIdx - specifies the index of the account to create the subaddress within
      label - specifies the the label for the subaddress (optional)
      Returns:
      the created subaddress
    • setSubaddressLabel

      void setSubaddressLabel(int accountIdx, int subaddressIdx, String label)
      Set a subaddress label.
      Parameters:
      accountIdx - index of the account to set the label for
      subaddressIdx - index of the subaddress to set the label for
      label - the label to set
    • getTx

      ZephyrTxWallet getTx(String txHash)
      Get a wallet transaction by hash.
      Parameters:
      txHash - is the hash of a transaction to get
      Returns:
      the identified transaction or throw if not found
    • getTxs

      List<ZephyrTxWallet> getTxs()
      Get all wallet transactions. Wallet transactions contain one or more transfers that are either incoming or outgoing to the wallet.
      Returns:
      all wallet transactions
    • getTxs

      List<ZephyrTxWallet> getTxs(String... txHashes)
      Get wallet transactions by hash.
      Parameters:
      txHashes - are hashes of transactions to get
      Returns:
      the identified transactions or throw if a transaction is not found
    • getTxs

      List<ZephyrTxWallet> getTxs(List<String> txHashes)
      Get wallet transactions by hash.
      Parameters:
      txHashes - are hashes of transactions to get
      Returns:
      the identified transactions or throw if a transaction is not found
    • getTxs

      List<ZephyrTxWallet> getTxs(List<String> txHashes, Collection<String> missingTxHashes)
      Get wallet transactions by hash and collect missing tx hashes.
      Parameters:
      txHashes - are hashes of transactions to get
      missingTxHashes - is populated with requested but missing tx hashes
      Returns:
      the found transactions
    • getTxs

      Get wallet transactions that meet the criteria defined in a query object.

      Transactions must meet every criteria defined in the query in order to be returned. All criteria are optional and no filtering is applied when not defined.

      All supported query criteria:
         isConfirmed - path of the wallet to open
         password - password of the wallet to open
         networkType - network type of the wallet to open (one of ZephyrNetworkType.MAINNET|TESTNET|STAGENET)
         serverUri - uri of the wallet's daemon (optional)
         serverUsername - username to authenticate with the daemon (optional)
         serverPassword - password to authenticate with the daemon (optional)
         server - ZephyrRpcConnection providing server configuration (optional)
         isConfirmed - get txs that are confirmed or not (optional)
         inTxPool - get txs that are in the tx pool or not (optional)
         isRelayed - get txs that are relayed or not (optional)
         isFailed - get txs that are failed or not (optional)
         isMinerTx - get miner txs or not (optional)
         hash - get a tx with the hash (optional)
         hashes - get txs with the hashes (optional)
         paymentId - get transactions with the payment id (optional)
         paymentIds - get transactions with the payment ids (optional)
         hasPaymentId - get transactions with a payment id or not (optional)
         minHeight - get txs with height greater than or equal to the given height (optional)
         maxHeight - get txs with height less than or equal to the given height (optional)
         isOutgoing - get txs with an outgoing transfer or not (optional)
         isIncoming - get txs with an incoming transfer or not (optional)
         transferQuery - get txs that have a transfer that meets this query (optional)
         includeOutputs - specifies that tx outputs should be returned with tx results (optional)

      Parameters:
      query - specifies properties of the transactions to get
      Returns:
      wallet transactions that meet the query
    • getTxs

      List<ZephyrTxWallet> getTxs(ZephyrTxQuery query, Collection<String> missingTxHashes)

      Get wallet transactions that meet the criteria defined in a query object.

      Transactions must meet every criteria defined in the query in order to be returned. All criteria are optional and no filtering is applied when not defined.

      If querying transactions by hash, unfound or unmet transaction hashes are added to the provided collection.

      All supported query criteria:
         isConfirmed - path of the wallet to open
         password - password of the wallet to open
         networkType - network type of the wallet to open (one of ZephyrNetworkType.MAINNET|TESTNET|STAGENET)
         serverUri - uri of the wallet's daemon (optional)
         serverUsername - username to authenticate with the daemon (optional)
         serverPassword - password to authenticate with the daemon (optional)
         server - ZephyrRpcConnection providing server configuration (optional)
         isConfirmed - get txs that are confirmed or not (optional)
         inTxPool - get txs that are in the tx pool or not (optional)
         isRelayed - get txs that are relayed or not (optional)
         isFailed - get txs that are failed or not (optional)
         isMinerTx - get miner txs or not (optional)
         hash - get a tx with the hash (optional)
         hashes - get txs with the hashes (optional)
         paymentId - get transactions with the payment id (optional)
         paymentIds - get transactions with the payment ids (optional)
         hasPaymentId - get transactions with a payment id or not (optional)
         minHeight - get txs with height greater than or equal to the given height (optional)
         maxHeight - get txs with height less than or equal to the given height (optional)
         isOutgoing - get txs with an outgoing transfer or not (optional)
         isIncoming - get txs with an incoming transfer or not (optional)
         transferQuery - get txs that have a transfer that meets this query (optional)
         includeOutputs - specifies that tx outputs should be returned with tx results (optional)

      Parameters:
      query - specifies properties of the transactions to get
      missingTxHashes - populated with hashes of unfound or unmet transactions that were queried by hash (throws error if null and queried transaction hashes are unfound or unmet)
      Returns:
      wallet transactions that meet the query
    • getTransfers

      List<ZephyrTransfer> getTransfers()
      Get all incoming and outgoing transfers to and from this wallet. An outgoing transfer represents a total amount sent from one or more subaddresses within an account to individual destination addresses, each with their own amount. An incoming transfer represents a total amount received into a subaddress within an account. Transfers belong to transactions which are stored on the blockchain.
      Returns:
      all wallet transfers
    • getTransfers

      List<ZephyrTransfer> getTransfers(int accountIdx)
      Get incoming and outgoing transfers to and from an account. An outgoing transfer represents a total amount sent from one or more subaddresses within an account to individual destination addresses, each with their own amount. An incoming transfer represents a total amount received into a subaddress within an account. Transfers belong to transactions which are stored on the blockchain.
      Parameters:
      accountIdx - is the index of the account to get transfers from
      Returns:
      transfers to/from the account
    • getTransfers

      List<ZephyrTransfer> getTransfers(int accountIdx, int subaddressIdx)
      Get incoming and outgoing transfers to and from a subaddress. An outgoing transfer represents a total amount sent from one or more subaddresses within an account to individual destination addresses, each with their own amount. An incoming transfer represents a total amount received into a subaddress within an account. Transfers belong to transactions which are stored on the blockchain.
      Parameters:
      accountIdx - is the index of the account to get transfers from
      subaddressIdx - is the index of the subaddress to get transfers from
      Returns:
      transfers to/from the subaddress
    • getTransfers

      List<ZephyrTransfer> getTransfers(ZephyrTransferQuery query)

      Get tranfsers that meet the criteria defined in a query object.

      Transfers must meet every criteria defined in the query in order to be returned. All criteria are optional and no filtering is applied when not defined.

      All supported query criteria:
         isOutgoing - get transfers that are outgoing or not (optional)
         isIncoming - get transfers that are incoming or not (optional)
         address - wallet's address that a transfer either originated from (if outgoing) or is destined for (if incoming) (optional)
         accountIndex - get transfers that either originated from (if outgoing) or are destined for (if incoming) a specific account index (optional)
         subaddressIndex - get transfers that either originated from (if outgoing) or are destined for (if incoming) a specific subaddress index (optional)
         subaddressIndices - get transfers that either originated from (if outgoing) or are destined for (if incoming) specific subaddress indices (optional)
         amount - amount being transferred (optional)
         destinations - individual destinations of an outgoing transfer, which is local wallet data and NOT recoverable from the blockchain (optional)
         hasDestinations - get transfers that have destinations or not (optional)
         txQuery - get transfers whose transaction meets this query (optional)
      Parameters:
      query - specifies attributes of transfers to get
      Returns:
      wallet transfers that meet the query
    • getIncomingTransfers

      List<ZephyrIncomingTransfer> getIncomingTransfers()
      Get all of the wallet's incoming transfers.
      Returns:
      the wallet's incoming transfers
    • getIncomingTransfers

      List<ZephyrIncomingTransfer> getIncomingTransfers(ZephyrTransferQuery query)

      Get incoming transfers that meet a query.

      All supported query criteria:
         address - get incoming transfers to a specific address in the wallet (optional)
         accountIndex - get incoming transfers to a specific account index (optional)
         subaddressIndex - get incoming transfers to a specific subaddress index (optional)
         subaddressIndices - get transfers destined for specific subaddress indices (optional)
         amount - amount being transferred (optional)
         txQuery - get transfers whose transaction meets this query (optional)

      Parameters:
      query - specifies which incoming transfers to get
      Returns:
      incoming transfers that meet the query
    • getOutgoingTransfers

      List<ZephyrOutgoingTransfer> getOutgoingTransfers()
      Get all of the wallet's outgoing transfers.
      Returns:
      the wallet's outgoing transfers
    • getOutgoingTransfers

      List<ZephyrOutgoingTransfer> getOutgoingTransfers(ZephyrTransferQuery query)

      Get outgoing transfers that meet a query.

      All supported query criteria:
         address - get outgoing transfers from a specific address in the wallet (optional)
         accountIndex - get outgoing transfers from a specific account index (optional)
         subaddressIndex - get outgoing transfers from a specific subaddress index (optional)
         subaddressIndices - get outgoing transfers from specific subaddress indices (optional)
         amount - amount being transferred (optional)
         destinations - individual destinations of an outgoing transfer, which is local wallet data and NOT recoverable from the blockchain (optional)
         hasDestinations - get transfers that have destinations or not (optional)
         txQuery - get transfers whose transaction meets this query (optional)

      Parameters:
      query - specifies which outgoing transfers to get
      Returns:
      outgoing transfers that meet the query
    • getOutputs

      List<ZephyrOutputWallet> getOutputs()
      Get outputs created from previous transactions that belong to the wallet (i.e. that the wallet can spend one time). Outputs are part of transactions which are stored in blocks on the blockchain.

      Zephyr: in the full wallet (ZephyrWalletFull) the outputs carry no asset (ZephyrOutputWallet.getAssetType() is null): the core keeps an output's asset but does not serialize it. getOutputAssetType(ZephyrOutputWallet) takes the asset from the output's transaction. See the user guide, docs/guide/08-known-limitations.md, section "getOutputs() reports no asset".

      Returns:
      all wallet outputs
    • getOutputs

      Get outputs which meet the criteria defined in a query object.

      Outputs must meet every criteria defined in the query in order to be returned. All criteria are optional and no filtering is applied when not defined.

      All supported query criteria:
         accountIndex - get outputs associated with a specific account index (optional)
         subaddressIndex - get outputs associated with a specific subaddress index (optional)
         subaddressIndices - get outputs associated with specific subaddress indices (optional)
         amount - get outputs with a specific amount (optional)
         minAmount - get outputs greater than or equal to a minimum amount (optional)
         maxAmount - get outputs less than or equal to a maximum amount (optional)
         isSpent - get outputs that are spent or not (optional)
         keyImage - get outputs that match the fields defined in the given key image (optional)
         txQuery - get outputs whose transaction meets this filter (optional)

      Zephyr: in the full wallet (ZephyrWalletFull) the outputs carry no asset (ZephyrOutputWallet.getAssetType() is null): the core keeps an output's asset but does not serialize it. getOutputAssetType(ZephyrOutputWallet) takes the asset from the output's transaction. See the user guide, docs/guide/08-known-limitations.md, section "getOutputs() reports no asset".

      Parameters:
      query - specifies attributes of outputs to get
      Returns:
      the queried outputs
    • getOutputAssetType

      default String getOutputAssetType(ZephyrOutputWallet output)
      Get the asset of an output from its transaction.

      Zephyr: the outputs that getOutputs() returns carry no asset, so this method takes it from the output's transaction with one getTxs(List, Collection) call:

      • If the wallet spent from the output's account in that transaction, the output is either the converted output of a conversion to this account (an incoming transfer at the output's account and subaddress in another asset than the outgoing transfer's, with the output's amount: that asset) or change or a same-asset send to this account (the outgoing transfer's asset, the source asset). The core lists no incoming transfer for the latter.
      • Otherwise the output was received: the asset of the incoming transfer at the output's account and subaddress. A received transaction credits one asset per subaddress.

      Known residue: in a conversion to one's own account whose converted amount is split over several outputs at one subaddress, or whose change equals the converted amount, the converted outputs read as the source asset. One getTxs call per output; cache by transaction hash when looking up many outputs. Tested with the full wallet (ZephyrWalletFull). See the user guide, docs/guide/08-known-limitations.md, section "getOutputs() reports no asset".

      Parameters:
      output - an output of this wallet, with its transaction hash, account and subaddress index
      Returns:
      the asset name (see ZephyrAssets), or null if the output's transaction is not in the wallet or no transfer matches
    • exportOutputs

      String exportOutputs()
      Export outputs since the last export.
      Returns:
      outputs since the last export in hex format
    • exportOutputs

      String exportOutputs(boolean all)
      Export outputs in hex format.
      Parameters:
      all - exports all outputs if true, else exports the outputs since the last export
      Returns:
      outputs in hex format
    • importOutputs

      int importOutputs(String outputsHex)
      Import outputs in hex format.
      Parameters:
      outputsHex - are outputs in hex format
      Returns:
      the number of outputs imported
    • exportKeyImages

      List<ZephyrKeyImage> exportKeyImages()
      Export key images since the last export.
      Returns:
      signed key images since the last export
    • exportKeyImages

      List<ZephyrKeyImage> exportKeyImages(boolean all)
      Export signed key images.
      Parameters:
      all - exports all key images if true, else exports the key images since the last export
      Returns:
      signed key images
    • importKeyImages

      ZephyrKeyImageImportResult importKeyImages(List<ZephyrKeyImage> keyImages)
      Import signed key images and verify their spent status.
      Parameters:
      keyImages - are key images to import and verify (requires hex and signature)
      Returns:
      results of the import
    • getNewKeyImagesFromLastImport

      List<ZephyrKeyImage> getNewKeyImagesFromLastImport()
      Get new key images from the last imported outputs.
      Returns:
      the key images from the last imported outputs
    • freezeOutput

      void freezeOutput(String keyImage)
      Freeze an output.
      Parameters:
      keyImage - key image of the output to freeze
    • thawOutput

      void thawOutput(String keyImage)
      Thaw a frozen output.
      Parameters:
      keyImage - key image of the output to thaw
    • isOutputFrozen

      boolean isOutputFrozen(String keyImage)
      Check if an output is frozen.
      Parameters:
      keyImage - key image of the output to check if frozen
      Returns:
      true if the output is frozen, false otherwise
    • createTx

      ZephyrTxWallet createTx(ZephyrTxConfig config)
      Create a transaction to transfer funds from this wallet.

      All supported configuration:
         address - single destination address (required unless `destinations` provided)
         amount - single destination amount (required unless `destinations` provided)
         accountIndex - source account index to transfer funds from (required)
         subaddressIndex - source subaddress index to transfer funds from (optional)
         subaddressIndices - source subaddress indices to transfer funds from (optional)
         relay - relay the transaction to peers to commit to the blockchain (default false)
         priority - transaction priority (default ZephyrTxPriority.NORMAL)
         destinations - addresses and amounts in a multi-destination tx (required unless `address` and `amount` provided)
         paymentId - transaction payment ID (optional)
         unlockHeight - minimum height for the transaction to unlock (default 0)

      Parameters:
      config - configures the transaction to create
      Returns:
      the created transaction
    • createTxs

      List<ZephyrTxWallet> createTxs(ZephyrTxConfig config)
      Create one or more transactions to transfer funds from this wallet.

      All supported configuration:
         address - single destination address (required unless `destinations` provided)
         amount - single destination amount (required unless `destinations` provided)
         accountIndex - source account index to transfer funds from (required)
         subaddressIndex - source subaddress index to transfer funds from (optional)
         subaddressIndices - source subaddress indices to transfer funds from (optional)
         relay - relay the transactions to peers to commit to the blockchain (default false)
         priority - transaction priority (default ZephyrTxPriority.NORMAL)
         destinations - addresses and amounts in a multi-destination tx (required unless `address` and `amount` provided)
         paymentId - transaction payment ID (optional)
         unlockHeight - minimum height for the transactions to unlock (default 0)
         canSplit - allow funds to be transferred using multiple transactions (default true)

      Parameters:
      config - configures the transactions to create
      Returns:
      the created transactions
    • sweepOutput

      ZephyrTxWallet sweepOutput(ZephyrTxConfig config)
      Sweep an output with a given key image.

      All supported configuration:
         address - single destination address (required)
         keyImage - key image to sweep (required)
         relay - relay the transaction to peers to commit to the blockchain (default false)
         unlockHeight - minimum height for the transaction to unlock (default 0)
         priority - transaction priority (default ZephyrTxPriority.NORMAL)

      Parameters:
      config - configures the sweep transaction
      Returns:
      the created transaction
    • sweepUnlocked

      List<ZephyrTxWallet> sweepUnlocked(ZephyrTxConfig config)
      Sweep all unlocked funds according to the given config.

      All supported configuration:
         address - single destination address (required)
         accountIndex - source account index to sweep from (optional, defaults to all accounts)
         subaddressIndex - source subaddress index to sweep from (optional, defaults to all subaddresses)
         subaddressIndices - source subaddress indices to sweep from (optional)
         relay - relay the transactions to peers to commit to the blockchain (default false)
         priority - transaction priority (default ZephyrTxPriority.NORMAL)
         unlockHeight - minimum height for the transactions to unlock (default 0)
         sweepEachSubaddress - sweep each subaddress individually if true (default false)

      Parameters:
      config - is the sweep configuration
      Returns:
      the created transactions
    • sweepDust

      List<ZephyrTxWallet> sweepDust(boolean relay)
      Sweep all unmixable dust outputs back to the wallet to make them easier to spend and mix. NOTE: Dust only exists pre RCT, so this method will throw "no dust to sweep" on new wallets.
      Parameters:
      relay - specifies if the resulting transaction should be relayed (defaults to false i.e. not relayed)
      Returns:
      the created transactions
    • relayTx

      String relayTx(String txMetadata)
      Relay a previously created transaction.
      Parameters:
      txMetadata - is transaction metadata previously created without relaying
      Returns:
      the hash of the relayed tx
    • relayTx

      String relayTx(ZephyrTxWallet tx)
      Relay a previously created transaction.
      Parameters:
      tx - is the transaction to relay
      Returns:
      the hash of the relayed tx
    • relayTxs

      List<String> relayTxs(Collection<String> txMetadatas)
      Relay previously created transactions.
      Parameters:
      txMetadatas - are transaction metadata previously created without relaying
      Returns:
      the hashes of the relayed txs
    • relayTxs

      List<String> relayTxs(List<ZephyrTxWallet> txs)
      Relay previously created transactions.
      Parameters:
      txs - are the transactions to relay
      Returns:
      the hashes of the relayed txs
    • describeUnsignedTxSet

      ZephyrTxSet describeUnsignedTxSet(String unsignedTxHex)
      Describe a tx set from unsigned tx hex.
      Parameters:
      unsignedTxHex - unsigned tx hex
      Returns:
      the tx set containing structured transactions
    • describeMultisigTxSet

      ZephyrTxSet describeMultisigTxSet(String multisigTxHex)
      Describe a tx set from multisig tx hex.
      Parameters:
      multisigTxHex - multisig tx hex
      Returns:
      the tx set containing structured transactions
    • describeTxSet

      ZephyrTxSet describeTxSet(ZephyrTxSet txSet)
      Describe a tx set containing unsigned or multisig tx hex to a new tx set containing structured transactions.
      Parameters:
      txSet - is a tx set containing unsigned or multisig tx hex
      Returns:
      the tx set containing structured transactions
    • signTxs

      String signTxs(String unsignedTxHex)
      Sign unsigned transactions from a view-only wallet.
      Parameters:
      unsignedTxHex - is unsigned transaction hex from when the transactions were created
      Returns:
      the signed transaction hex
    • submitTxs

      List<String> submitTxs(String signedTxHex)
      Submit signed transactions from a view-only wallet.
      Parameters:
      signedTxHex - is signed transaction hex from signTxs()
      Returns:
      the resulting transaction hashes
    • signMessage

      String signMessage(String message)
      Sign a message.
      Parameters:
      message - is the message to sign
      Returns:
      the signature
    • signMessage

      String signMessage(String message, ZephyrMessageSignatureType signatureType, int accountIdx, int subaddressIdx)
      Sign a message.
      Parameters:
      message - the message to sign
      signatureType - sign with spend key or view key
      accountIdx - the account index of the message signature (default 0)
      subaddressIdx - the subaddress index of the message signature (default 0)
      Returns:
      the signature
    • verifyMessage

      ZephyrMessageSignatureResult verifyMessage(String message, String address, String signature)
      Verify a signature on a message.
      Parameters:
      message - is the signed message
      address - is the signing address
      signature - is the signature
      Returns:
      the message signature verification result
    • getTxKey

      String getTxKey(String txHash)
      Get a transaction's secret key from its hash.
      Parameters:
      txHash - is the transaction's hash
      Returns:
      is the transaction's secret key
    • checkTxKey

      ZephyrCheckTx checkTxKey(String txHash, String txKey, String address)
      Check a transaction in the blockchain with its secret key.

      Zephyr: in the full wallet (ZephyrWalletFull) the received amount of the result is 0 for every current transaction. The core reads the amount of the asset ZEPH only, and since hard fork 11 (height 536,000) no output is ZEPH. ZephyrCheck.isGood() and the confirmations are right. Read the amount from getTxs(String...) instead: the receiver's incoming transfers, or the sender's outgoing destinations, each with its asset. See the user guide, docs/guide/08-known-limitations.md, section "checkTxKey returns amount 0".

      Parameters:
      txHash - specifies the transaction to check
      txKey - is the transaction's secret key
      address - is the destination public address of the transaction
      Returns:
      the result of the check
    • getTxProof

      String getTxProof(String txHash, String address)
      Get a transaction signature to prove it.
      Parameters:
      txHash - specifies the transaction to prove
      address - is the destination public address of the transaction
      Returns:
      the transaction signature
    • getTxProof

      String getTxProof(String txHash, String address, String message)
      Get a transaction signature to prove it.
      Parameters:
      txHash - specifies the transaction to prove
      address - is the destination public address of the transaction
      message - is a message to include with the signature to further authenticate the proof (optional)
      Returns:
      the transaction signature
    • checkTxProof

      ZephyrCheckTx checkTxProof(String txHash, String address, String message, String signature)
      Prove a transaction by checking its signature.

      Zephyr: in the full wallet (ZephyrWalletFull) the received amount of the result is 0 for every current transaction, from the same core code as checkTxKey(java.lang.String, java.lang.String, java.lang.String): the core reads the amount of the asset ZEPH only, which no output has carried since hard fork 11. ZephyrCheck.isGood() and the confirmations are right. Read the amount from getTxs(String...) instead. See the user guide, docs/guide/08-known-limitations.md, section "checkTxKey returns amount 0".

      Parameters:
      txHash - specifies the transaction to prove
      address - is the destination public address of the transaction
      message - is a message included with the signature to further authenticate the proof (optional)
      signature - is the transaction signature to confirm
      Returns:
      the result of the check
    • getSpendProof

      String getSpendProof(String txHash)
      Generate a signature to prove a spend. Unlike proving a transaction, it does not require the destination public address.
      Parameters:
      txHash - specifies the transaction to prove
      Returns:
      the transaction signature
    • getSpendProof

      String getSpendProof(String txHash, String message)
      Generate a signature to prove a spend. Unlike proving a transaction, it does not require the destination public address.
      Parameters:
      txHash - specifies the transaction to prove
      message - is a message to include with the signature to further authenticate the proof (optional)
      Returns:
      the transaction signature
    • checkSpendProof

      boolean checkSpendProof(String txHash, String message, String signature)
      Prove a spend using a signature. Unlike proving a transaction, it does not require the destination public address.
      Parameters:
      txHash - specifies the transaction to prove
      message - is a message included with the signature to further authenticate the proof (optional)
      signature - is the transaction signature to confirm
      Returns:
      true if the signature is good, false otherwise
    • getReserveProofWallet

      String getReserveProofWallet(String message)
      Generate a signature to prove the entire balance of the wallet.
      Parameters:
      message - is a message included with the signature to further authenticate the proof (optional)
      Returns:
      the reserve proof signature
    • getReserveProofAccount

      String getReserveProofAccount(int accountIdx, BigInteger amount, String message)
      Generate a signature to prove an available amount in an account.
      Parameters:
      accountIdx - specifies the account to prove ownership of the amount
      amount - is the minimum amount to prove as available in the account
      message - is a message to include with the signature to further authenticate the proof (optional)
      Returns:
      the reserve proof signature
    • checkReserveProof

      ZephyrCheckReserve checkReserveProof(String address, String message, String signature)
      Proves a wallet has a disposable reserve using a signature.
      Parameters:
      address - is the public wallet address
      message - is a message included with the signature to further authenticate the proof (optional)
      signature - is the reserve proof signature to check
      Returns:
      the result of checking the signature proof
    • getTxNote

      String getTxNote(String txHash)
      Get a transaction note.
      Parameters:
      txHash - specifies the transaction to get the note of
      Returns:
      the tx note
    • getTxNotes

      List<String> getTxNotes(List<String> txHashes)
      Get notes for multiple transactions.
      Parameters:
      txHashes - identify the transactions to get notes for
      Returns:
      notes for the transactions
    • setTxNote

      void setTxNote(String txHash, String note)
      Set a note for a specific transaction.
      Parameters:
      txHash - specifies the transaction
      note - specifies the note
    • setTxNotes

      void setTxNotes(List<String> txHashes, List<String> notes)
      Set notes for multiple transactions.
      Parameters:
      txHashes - specify the transactions to set notes for
      notes - are the notes to set for the transactions
    • getAddressBookEntries

      List<ZephyrAddressBookEntry> getAddressBookEntries()
      Get all address book entries.
      Returns:
      the address book entries
    • getAddressBookEntries

      List<ZephyrAddressBookEntry> getAddressBookEntries(List<Integer> entryIndices)
      Get address book entries.
      Parameters:
      entryIndices - are indices of the entries to get (optional)
      Returns:
      the address book entries
    • addAddressBookEntry

      int addAddressBookEntry(String address, String description)
      Add an address book entry.
      Parameters:
      address - is the entry address
      description - is the entry description (optional)
      Returns:
      the index of the added entry
    • editAddressBookEntry

      void editAddressBookEntry(int index, boolean setAddress, String address, boolean setDescription, String description)
      Edit an address book entry.
      Parameters:
      index - is the index of the address book entry to edit
      setAddress - specifies if the address should be updated
      address - is the updated address
      setDescription - specifies if the description should be updated
      description - is the updated description
    • deleteAddressBookEntry

      void deleteAddressBookEntry(int entryIdx)
      Delete an address book entry.
      Parameters:
      entryIdx - is the index of the entry to delete
    • tagAccounts

      void tagAccounts(String tag, Collection<Integer> accountIndices)
      Tag accounts.
      Parameters:
      tag - is the tag to apply to the specified accounts
      accountIndices - are the indices of the accounts to tag
    • untagAccounts

      void untagAccounts(Collection<Integer> accountIndices)
      Untag acconts.
      Parameters:
      accountIndices - are the indices of the accounts to untag
    • getAccountTags

      List<ZephyrAccountTag> getAccountTags()
      Return all account tags.
      Returns:
      the wallet's account tags
    • setAccountTagLabel

      void setAccountTagLabel(String tag, String label)
      Sets a human-readable description for a tag.
      Parameters:
      tag - is the tag to set a description for
      label - is the label to set for the tag
    • getPaymentUri

      String getPaymentUri(ZephyrTxConfig config)
      Creates a payment URI from a send configuration.
      Parameters:
      config - specifies configuration for a potential tx
      Returns:
      the payment uri
    • parsePaymentUri

      ZephyrTxConfig parsePaymentUri(String uri)
      Parses a payment URI to a transaction configuration.
      Parameters:
      uri - is the payment uri to parse
      Returns:
      the send configuration parsed from the uri
    • getAttribute

      String getAttribute(String key)
      Get an attribute.
      Parameters:
      key - is the attribute to get the value of
      Returns:
      the attribute's value
    • setAttribute

      void setAttribute(String key, String val)
      Set an arbitrary attribute.
      Parameters:
      key - is the attribute key
      val - is the attribute value
    • startMining

      void startMining(Long numThreads, Boolean backgroundMining, Boolean ignoreBattery)
      Start mining.
      Parameters:
      numThreads - is the number of threads created for mining (optional)
      backgroundMining - specifies if mining should occur in the background (optional)
      ignoreBattery - specifies if the battery should be ignored for mining (optional)
    • stopMining

      void stopMining()
      Stop mining.
    • isMultisigImportNeeded

      boolean isMultisigImportNeeded()
      Indicates if importing multisig data is needed for returning a correct balance.
      Returns:
      true if importing multisig data is needed for returning a correct balance, false otherwise
    • isMultisig

      boolean isMultisig()
      Indicates if this wallet is a multisig wallet.
      Returns:
      true if this is a multisig wallet, false otherwise
    • getMultisigInfo

      ZephyrMultisigInfo getMultisigInfo()
      Get multisig info about this wallet.
      Returns:
      multisig info about this wallet
    • prepareMultisig

      String prepareMultisig()
      Get multisig info as hex to share with participants to begin creating a multisig wallet.
      Returns:
      this wallet's multisig hex to share with participants
    • makeMultisig

      String makeMultisig(List<String> multisigHexes, int threshold, String password)
      Make this wallet multisig by importing multisig hex from participants.
      Parameters:
      multisigHexes - are multisig hex from each participant
      threshold - is the number of signatures needed to sign transfers
      password - is the wallet password
      Returns:
      this wallet's multisig hex to share with participants
    • exchangeMultisigKeys

      ZephyrMultisigInitResult exchangeMultisigKeys(List<String> multisigHexes, String password)
      Exchange multisig hex with participants in a M/N multisig wallet. This process must be repeated with participants exactly N-M times.
      Parameters:
      multisigHexes - are multisig hex from each participant
      password - is the wallet's password // TODO zephyr: redundant? wallet is created with password
      Returns:
      the result which has the multisig's address xor this wallet's multisig hex to share with participants iff not done
    • exportMultisigHex

      String exportMultisigHex()
      Export this wallet's multisig info as hex for other participants.
      Returns:
      this wallet's multisig info as hex for other participants
    • importMultisigHex

      int importMultisigHex(String... multisigHexes)
      Import multisig info as hex from other participants.
      Parameters:
      multisigHexes - are multisig hex from each participant
      Returns:
      the number of outputs signed with the given multisig hex
    • importMultisigHex

      int importMultisigHex(List<String> multisigHexes)
      Import multisig info as hex from other participants.
      Parameters:
      multisigHexes - are multisig hex from each participant
      Returns:
      the number of outputs signed with the given multisig hex
    • signMultisigTxHex

      ZephyrMultisigSignResult signMultisigTxHex(String multisigTxHex)
      Sign multisig transactions from a multisig wallet.
      Parameters:
      multisigTxHex - represents unsigned multisig transactions as hex
      Returns:
      the result of signing the multisig transactions
    • submitMultisigTxHex

      List<String> submitMultisigTxHex(String signedMultisigTxHex)
      Submit signed multisig transactions from a multisig wallet.
      Parameters:
      signedMultisigTxHex - is signed multisig hex returned from signMultisigTxHex()
      Returns:
      the resulting transaction hashes
    • changePassword

      void changePassword(String oldPassword, String newPassword)
      Change the wallet password.
      Parameters:
      oldPassword - is the wallet's old password
      newPassword - is the wallet's new password
    • save

      void save()
      Save the wallet at its current path.
    • close

      void close()
      Close the wallet (does not save).
    • close

      void close(boolean save)
      Optionally save then close the wallet.
      Parameters:
      save - specifies if the wallet should be saved before being closed (default false)
    • isClosed

      boolean isClosed()
      Indicates if this wallet is closed or not.
      Returns:
      true if the wallet is closed, false otherwise