Method Detail

• reset

   Service.Empty reset(Darkside.DarksideMetaState request)

  Reset reverts all darksidewalletd state (active block range, latest height,
  staged blocks and transactions) and lightwalletd state (cache) to empty,
  the same as the initial state. This occurs synchronously and instantaneously;
  no reorg happens in lightwalletd. This is good to do before each independent
  test so that no state leaks from one test to another.
  Also sets (some of) the values returned by GetLightdInfo(). The Sapling
  activation height specified here must be where the block range starts.
  

• stageBlocks

   Service.Empty stageBlocks(Darkside.DarksideBlocksURL request)

  StageBlocks is the same as StageBlocksStream() except the blocks are fetched
  from the given URL. Blocks are one per line, hex-encoded (not JSON).
  

• stageBlocksCreate

   Service.Empty stageBlocksCreate(Darkside.DarksideEmptyBlocks request)

  StageBlocksCreate is like the previous two, except it creates 'count'
  empty blocks at consecutive heights starting at height 'height'. The
  'nonce' is part of the header, so it contributes to the block hash; this
  lets you create identical blocks (same transactions and height), but with
  different hashes.
  

• stageTransactions

   Service.Empty stageTransactions(Darkside.DarksideTransactionsURL request)

  StageTransactions is the same except the transactions are fetched from
  the given url. They are all staged into the block at the given height.
  Staging transactions to different heights requires multiple calls.
  

• applyStaged

   Service.Empty applyStaged(Darkside.DarksideHeight request)

  ApplyStaged iterates the list of blocks that were staged by the
  StageBlocks*() gRPCs, in the order they were staged, and "merges" each
  into the active, working blocks list that the mock zcashd is presenting
  to lightwalletd. Even as each block is applied, the active list can't
  have gaps; if the active block range is 1000-1006, and the staged block
  range is 1003-1004, the resulting range is 1000-1004, with 1000-1002
  unchanged, blocks 1003-1004 from the new range, and 1005-1006 dropped.
  After merging all blocks, ApplyStaged() appends staged transactions (in
  the order received) into each one's corresponding (by height) block
  The staging area is then cleared.
  The argument specifies the latest block height that mock zcashd reports
  (i.e. what's returned by GetLatestBlock). Note that ApplyStaged() can
  also be used to simply advance the latest block height presented by mock
  zcashd. That is, there doesn't need to be anything in the staging area.
  

• getIncomingTransactions

   Iterator<Service.RawTransaction> getIncomingTransactions(Service.Empty request)

  Calls to the production gRPC SendTransaction() store the transaction in
  a separate area (not the staging area); this method returns all transactions
  in this separate area, which is then cleared. The height returned
  with each transaction is -1 (invalid) since these transactions haven't
  been mined yet. The intention is that the transactions returned here can
  then, for example, be given to StageTransactions() to get them "mined"
  into a specified block on the next ApplyStaged().
  

• clearIncomingTransactions

   Service.Empty clearIncomingTransactions(Service.Empty request)

  Clear the incoming transaction pool.
  

• addAddressUtxo

   Service.Empty addAddressUtxo(Service.GetAddressUtxosReply request)

  Add a GetAddressUtxosReply entry to be returned by GetAddressUtxos().
  There is no staging or applying for these, very simple.
  

• clearAddressUtxo

   Service.Empty clearAddressUtxo(Service.Empty request)

  Clear the list of GetAddressUtxos entries (can't fail)
  

• addTreeState

   Service.Empty addTreeState(Service.TreeState request)

  Adds a GetTreeState to the tree state cache
  

• removeTreeState

   Service.Empty removeTreeState(Service.BlockID request)

  Removes a GetTreeState for the given height from cache if present (can't fail)
  

• clearAllTreeStates

   Service.Empty clearAllTreeStates(Service.Empty request)

  Clear the list of GetTreeStates entries (can't fail)