joshua/dash-docs
1
0
Fork 0
mirror of https://github.com/seigler/dash-docs synced 2025-07-27 17:56:16 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
dash-docs/en/doxygen/html/classTxConfirmStats.html

833 lines
43 KiB
HTML
Raw Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.14"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Dash Core: TxConfirmStats Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(initResizable);
/* @license-end */</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="bitcoin_logo_doxygen.png"/></td>
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Dash Core
&#160;<span id="projectnumber">0.12.2.1</span>
</div>
<div id="projectbrief">P2P Digital Currency</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.14 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('classTxConfirmStats.html','');});
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pri-attribs">Private Attributes</a> &#124;
<a href="classTxConfirmStats-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">TxConfirmStats Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p><code>#include &lt;<a class="el" href="fees_8h_source.html">fees.h</a>&gt;</code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a5a7701e1463d687cae1e86204748dc5e"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a5a7701e1463d687cae1e86204748dc5e">Initialize</a> (std::vector&lt; double &gt; &amp;defaultBuckets, unsigned int maxConfirms, double <a class="el" href="classTxConfirmStats.html#a61076f7531b27abbd85ec8bc7bc90ee2">decay</a>, std::string <a class="el" href="classTxConfirmStats.html#a638b665311ffa2e6433b426fa0db6453">dataTypeString</a>)</td></tr>
<tr class="separator:a5a7701e1463d687cae1e86204748dc5e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3cf61e975c43103bb2c1e5ac3f5b3cf8"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a3cf61e975c43103bb2c1e5ac3f5b3cf8">ClearCurrent</a> (unsigned int nBlockHeight)</td></tr>
<tr class="separator:a3cf61e975c43103bb2c1e5ac3f5b3cf8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a64281208674a51e15fb10a619bde2a51"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a64281208674a51e15fb10a619bde2a51">Record</a> (int blocksToConfirm, double val)</td></tr>
<tr class="separator:a64281208674a51e15fb10a619bde2a51"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae0b014c40cdf3c2207f2677774000261"><td class="memItemLeft" align="right" valign="top">unsigned int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#ae0b014c40cdf3c2207f2677774000261">NewTx</a> (unsigned int nBlockHeight, double val)</td></tr>
<tr class="separator:ae0b014c40cdf3c2207f2677774000261"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a421aa07c38b5f51dae2f2bdd725ba169"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a421aa07c38b5f51dae2f2bdd725ba169">removeTx</a> (unsigned int entryHeight, unsigned int nBestSeenHeight, unsigned int bucketIndex)</td></tr>
<tr class="separator:a421aa07c38b5f51dae2f2bdd725ba169"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a96211021e0e019a566a2126948861ead"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a96211021e0e019a566a2126948861ead">UpdateMovingAverages</a> ()</td></tr>
<tr class="separator:a96211021e0e019a566a2126948861ead"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a7ac4f70e6029ecf06e8d1528ab9c33f1"><td class="memItemLeft" align="right" valign="top">double&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a7ac4f70e6029ecf06e8d1528ab9c33f1">EstimateMedianVal</a> (int confTarget, double sufficientTxVal, double minSuccess, bool requireGreater, unsigned int nBlockHeight)</td></tr>
<tr class="separator:a7ac4f70e6029ecf06e8d1528ab9c33f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab2b42aa0beab3ed825ccc8486dfc0a84"><td class="memItemLeft" align="right" valign="top">unsigned int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#ab2b42aa0beab3ed825ccc8486dfc0a84">GetMaxConfirms</a> ()</td></tr>
<tr class="separator:ab2b42aa0beab3ed825ccc8486dfc0a84"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a61caf0db4ffeb8c112375e2aedf62499"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a61caf0db4ffeb8c112375e2aedf62499">Write</a> (<a class="el" href="classCAutoFile.html">CAutoFile</a> &amp;<a class="el" href="util_8cpp.html#a5256be9be45ec4d0909f14a61d455e23">fileout</a>)</td></tr>
<tr class="separator:a61caf0db4ffeb8c112375e2aedf62499"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3cc392ef180cd7bddd0181c1a73dd741"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a3cc392ef180cd7bddd0181c1a73dd741">Read</a> (<a class="el" href="classCAutoFile.html">CAutoFile</a> &amp;filein)</td></tr>
<tr class="separator:a3cc392ef180cd7bddd0181c1a73dd741"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pri-attribs"></a>
Private Attributes</h2></td></tr>
<tr class="memitem:a1267be3e0742dcf549adcaa2e13e66f7"><td class="memItemLeft" align="right" valign="top">std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a1267be3e0742dcf549adcaa2e13e66f7">buckets</a></td></tr>
<tr class="separator:a1267be3e0742dcf549adcaa2e13e66f7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2f21d56ed1f23ec8d106526db25e8e6e"><td class="memItemLeft" align="right" valign="top">std::map&lt; double, unsigned int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a2f21d56ed1f23ec8d106526db25e8e6e">bucketMap</a></td></tr>
<tr class="separator:a2f21d56ed1f23ec8d106526db25e8e6e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6d09b27bc31a4f7ce4a8104d61546d37"><td class="memItemLeft" align="right" valign="top">std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a6d09b27bc31a4f7ce4a8104d61546d37">txCtAvg</a></td></tr>
<tr class="separator:a6d09b27bc31a4f7ce4a8104d61546d37"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a91ea5d52ed3df7cc92e0383fcc0bf18d"><td class="memItemLeft" align="right" valign="top">std::vector&lt; int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a91ea5d52ed3df7cc92e0383fcc0bf18d">curBlockTxCt</a></td></tr>
<tr class="separator:a91ea5d52ed3df7cc92e0383fcc0bf18d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab09c024915718a928764b2a6b69f8215"><td class="memItemLeft" align="right" valign="top">std::vector&lt; std::vector&lt; double &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#ab09c024915718a928764b2a6b69f8215">confAvg</a></td></tr>
<tr class="separator:ab09c024915718a928764b2a6b69f8215"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a96013d2383fb68757b4dc948a98b09fe"><td class="memItemLeft" align="right" valign="top">std::vector&lt; std::vector&lt; int &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a96013d2383fb68757b4dc948a98b09fe">curBlockConf</a></td></tr>
<tr class="separator:a96013d2383fb68757b4dc948a98b09fe"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aad7cdbbb2fccfe1abf2dbfb2cc0230ce"><td class="memItemLeft" align="right" valign="top">std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#aad7cdbbb2fccfe1abf2dbfb2cc0230ce">avg</a></td></tr>
<tr class="separator:aad7cdbbb2fccfe1abf2dbfb2cc0230ce"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a294a044fae770c4977f2ba46c78cdf2a"><td class="memItemLeft" align="right" valign="top">std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a294a044fae770c4977f2ba46c78cdf2a">curBlockVal</a></td></tr>
<tr class="separator:a294a044fae770c4977f2ba46c78cdf2a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a638b665311ffa2e6433b426fa0db6453"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a638b665311ffa2e6433b426fa0db6453">dataTypeString</a></td></tr>
<tr class="separator:a638b665311ffa2e6433b426fa0db6453"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a61076f7531b27abbd85ec8bc7bc90ee2"><td class="memItemLeft" align="right" valign="top">double&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a61076f7531b27abbd85ec8bc7bc90ee2">decay</a></td></tr>
<tr class="separator:a61076f7531b27abbd85ec8bc7bc90ee2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab80a5b84994e90d568f798632a510ab3"><td class="memItemLeft" align="right" valign="top">std::vector&lt; std::vector&lt; int &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#ab80a5b84994e90d568f798632a510ab3">unconfTxs</a></td></tr>
<tr class="separator:ab80a5b84994e90d568f798632a510ab3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a80101a37c91a8953151d0c146bfbc635"><td class="memItemLeft" align="right" valign="top">std::vector&lt; int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classTxConfirmStats.html#a80101a37c91a8953151d0c146bfbc635">oldUnconfTxs</a></td></tr>
<tr class="separator:a80101a37c91a8953151d0c146bfbc635"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>We will instantiate two instances of this class, one to track transactions that were included in a block due to fee, and one for tx's included due to priority. We will lump transactions into a bucket according to their approximate fee or priority and then track how long it took for those txs to be included in a block</p>
<p>The tracking of unconfirmed (mempool) transactions is completely independent of the historical tracking of transactions that have been confirmed in a block. </p>
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00079">79</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
</div><h2 class="groupheader">Member Function Documentation</h2>
<a id="a3cf61e975c43103bb2c1e5ac3f5b3cf8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3cf61e975c43103bb2c1e5ac3f5b3cf8">&#9670;&nbsp;</a></span>ClearCurrent()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::ClearCurrent </td>
<td>(</td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>nBlockHeight</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Clear the state of the curBlock variables to start counting for the new block </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00041">41</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00434">CBlockPolicyEstimator::processBlock()</a>.</p>
</div>
</div>
<a id="a7ac4f70e6029ecf06e8d1528ab9c33f1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7ac4f70e6029ecf06e8d1528ab9c33f1">&#9670;&nbsp;</a></span>EstimateMedianVal()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double TxConfirmStats::EstimateMedianVal </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>confTarget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double&#160;</td>
<td class="paramname"><em>sufficientTxVal</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double&#160;</td>
<td class="paramname"><em>minSuccess</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&#160;</td>
<td class="paramname"><em>requireGreater</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>nBlockHeight</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Calculate a fee or priority estimate. Find the lowest value bucket (or range of buckets to make sure we have enough data points) whose transactions still have sufficient likelihood of being confirmed within the target number of confirmations </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">confTarget</td><td>target number of confirmations </td></tr>
<tr><td class="paramname">sufficientTxVal</td><td>required average number of transactions per block in a bucket range </td></tr>
<tr><td class="paramname">minSuccess</td><td>the success probability we require </td></tr>
<tr><td class="paramname">requireGreater</td><td>return the lowest fee/pri such that all higher values pass minSuccess OR return the highest fee/pri such that all lower values fail minSuccess </td></tr>
<tr><td class="paramname">nBlockHeight</td><td>the current block height </td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00078">78</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00492">CBlockPolicyEstimator::estimateFee()</a>, <a class="el" href="fees_8cpp_source.html#l00533">CBlockPolicyEstimator::estimatePriority()</a>, <a class="el" href="fees_8cpp_source.html#l00506">CBlockPolicyEstimator::estimateSmartFee()</a>, <a class="el" href="fees_8cpp_source.html#l00542">CBlockPolicyEstimator::estimateSmartPriority()</a>, and <a class="el" href="fees_8cpp_source.html#l00434">CBlockPolicyEstimator::processBlock()</a>.</p>
</div>
</div>
<a id="ab2b42aa0beab3ed825ccc8486dfc0a84"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab2b42aa0beab3ed825ccc8486dfc0a84">&#9670;&nbsp;</a></span>GetMaxConfirms()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">unsigned int TxConfirmStats::GetMaxConfirms </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the max number of confirms we're tracking </p>
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00166">166</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00492">CBlockPolicyEstimator::estimateFee()</a>, <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00533">CBlockPolicyEstimator::estimatePriority()</a>, <a class="el" href="fees_8cpp_source.html#l00506">CBlockPolicyEstimator::estimateSmartFee()</a>, and <a class="el" href="fees_8cpp_source.html#l00542">CBlockPolicyEstimator::estimateSmartPriority()</a>.</p>
</div>
</div>
<a id="a5a7701e1463d687cae1e86204748dc5e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5a7701e1463d687cae1e86204748dc5e">&#9670;&nbsp;</a></span>Initialize()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::Initialize </td>
<td>(</td>
<td class="paramtype">std::vector&lt; double &gt; &amp;&#160;</td>
<td class="paramname"><em>defaultBuckets</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>maxConfirms</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double&#160;</td>
<td class="paramname"><em>decay</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">std::string&#160;</td>
<td class="paramname"><em>dataTypeString</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize the data structures. This is called by BlockPolicyEstimator's constructor with default values. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">defaultBuckets</td><td>contains the upper limits for the bucket boundaries </td></tr>
<tr><td class="paramname">maxConfirms</td><td>max number of confirms to track </td></tr>
<tr><td class="paramname">decay</td><td>how much to decay the historical moving average per block </td></tr>
<tr><td class="paramname">dataTypeString</td><td>for logging purposes </td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00015">15</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00301">CBlockPolicyEstimator::CBlockPolicyEstimator()</a>.</p>
</div>
</div>
<a id="ae0b014c40cdf3c2207f2677774000261"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae0b014c40cdf3c2207f2677774000261">&#9670;&nbsp;</a></span>NewTx()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned int TxConfirmStats::NewTx </td>
<td>(</td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>nBlockHeight</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double&#160;</td>
<td class="paramname"><em>val</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Record a new transaction entering the mempool </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00248">248</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00344">CBlockPolicyEstimator::processTransaction()</a>.</p>
</div>
</div>
<a id="a3cc392ef180cd7bddd0181c1a73dd741"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3cc392ef180cd7bddd0181c1a73dd741">&#9670;&nbsp;</a></span>Read()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::Read </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCAutoFile.html">CAutoFile</a> &amp;&#160;</td>
<td class="paramname"><em>filein</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Read saved state of estimation data from a file and replace all internal data structures and variables with this state. </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00185">185</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00573">CBlockPolicyEstimator::Read()</a>.</p>
</div>
</div>
<a id="a64281208674a51e15fb10a619bde2a51"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a64281208674a51e15fb10a619bde2a51">&#9670;&nbsp;</a></span>Record()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::Record </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>blocksToConfirm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double&#160;</td>
<td class="paramname"><em>val</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Record a new transaction data point in the current block stats </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">blocksToConfirm</td><td>the number of blocks it took this transaction to confirm </td></tr>
<tr><td class="paramname">val</td><td>either the fee or the priority when entered of the transaction </td></tr>
</table>
</dd>
</dl>
<dl class="section warning"><dt>Warning</dt><dd>blocksToConfirm is 1-based and has to be &gt;= 1 </dd></dl>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00054">54</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00397">CBlockPolicyEstimator::processBlockTx()</a>.</p>
</div>
</div>
<a id="a421aa07c38b5f51dae2f2bdd725ba169"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a421aa07c38b5f51dae2f2bdd725ba169">&#9670;&nbsp;</a></span>removeTx()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::removeTx </td>
<td>(</td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>entryHeight</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>nBestSeenHeight</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int&#160;</td>
<td class="paramname"><em>bucketIndex</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove a transaction from mempool tracking stats </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00257">257</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00285">CBlockPolicyEstimator::removeTx()</a>.</p>
</div>
</div>
<a id="a96211021e0e019a566a2126948861ead"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a96211021e0e019a566a2126948861ead">&#9670;&nbsp;</a></span>UpdateMovingAverages()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::UpdateMovingAverages </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Update our estimates by decaying our historical moving average and updating with the data gathered from the current block </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00067">67</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00434">CBlockPolicyEstimator::processBlock()</a>.</p>
</div>
</div>
<a id="a61caf0db4ffeb8c112375e2aedf62499"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a61caf0db4ffeb8c112375e2aedf62499">&#9670;&nbsp;</a></span>Write()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void TxConfirmStats::Write </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCAutoFile.html">CAutoFile</a> &amp;&#160;</td>
<td class="paramname"><em>fileout</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Write state of estimation data to a file </p>
<p class="definition">Definition at line <a class="el" href="fees_8cpp_source.html#l00176">176</a> of file <a class="el" href="fees_8cpp_source.html">fees.cpp</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00566">CBlockPolicyEstimator::Write()</a>.</p>
</div>
</div>
<h2 class="groupheader">Member Data Documentation</h2>
<a id="aad7cdbbb2fccfe1abf2dbfb2cc0230ce"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aad7cdbbb2fccfe1abf2dbfb2cc0230ce">&#9670;&nbsp;</a></span>avg</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;double&gt; TxConfirmStats::avg</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00101">101</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>, and <a class="el" href="fees_8cpp_source.html#l00176">Write()</a>.</p>
</div>
</div>
<a id="a2f21d56ed1f23ec8d106526db25e8e6e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2f21d56ed1f23ec8d106526db25e8e6e">&#9670;&nbsp;</a></span>bucketMap</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::map&lt;double, unsigned int&gt; TxConfirmStats::bucketMap</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00084">84</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00248">NewTx()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, and <a class="el" href="fees_8cpp_source.html#l00054">Record()</a>.</p>
</div>
</div>
<a id="a1267be3e0742dcf549adcaa2e13e66f7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1267be3e0742dcf549adcaa2e13e66f7">&#9670;&nbsp;</a></span>buckets</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;double&gt; TxConfirmStats::buckets</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00083">83</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>, and <a class="el" href="fees_8cpp_source.html#l00176">Write()</a>.</p>
</div>
</div>
<a id="ab09c024915718a928764b2a6b69f8215"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab09c024915718a928764b2a6b69f8215">&#9670;&nbsp;</a></span>confAvg</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;std::vector&lt;double&gt; &gt; TxConfirmStats::confAvg</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00095">95</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8h_source.html#l00166">GetMaxConfirms()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>, and <a class="el" href="fees_8cpp_source.html#l00176">Write()</a>.</p>
</div>
</div>
<a id="a96013d2383fb68757b4dc948a98b09fe"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a96013d2383fb68757b4dc948a98b09fe">&#9670;&nbsp;</a></span>curBlockConf</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;std::vector&lt;int&gt; &gt; TxConfirmStats::curBlockConf</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00097">97</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00054">Record()</a>, and <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>.</p>
</div>
</div>
<a id="a91ea5d52ed3df7cc92e0383fcc0bf18d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a91ea5d52ed3df7cc92e0383fcc0bf18d">&#9670;&nbsp;</a></span>curBlockTxCt</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;int&gt; TxConfirmStats::curBlockTxCt</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00091">91</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00054">Record()</a>, and <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>.</p>
</div>
</div>
<a id="a294a044fae770c4977f2ba46c78cdf2a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a294a044fae770c4977f2ba46c78cdf2a">&#9670;&nbsp;</a></span>curBlockVal</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;double&gt; TxConfirmStats::curBlockVal</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00103">103</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00054">Record()</a>, and <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>.</p>
</div>
</div>
<a id="a638b665311ffa2e6433b426fa0db6453"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a638b665311ffa2e6433b426fa0db6453">&#9670;&nbsp;</a></span>dataTypeString</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::string TxConfirmStats::dataTypeString</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00108">108</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00248">NewTx()</a>, and <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>.</p>
</div>
</div>
<a id="a61076f7531b27abbd85ec8bc7bc90ee2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a61076f7531b27abbd85ec8bc7bc90ee2">&#9670;&nbsp;</a></span>decay</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">double TxConfirmStats::decay</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00109">109</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>, and <a class="el" href="fees_8cpp_source.html#l00176">Write()</a>.</p>
</div>
</div>
<a id="a80101a37c91a8953151d0c146bfbc635"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a80101a37c91a8953151d0c146bfbc635">&#9670;&nbsp;</a></span>oldUnconfTxs</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;int&gt; TxConfirmStats::oldUnconfTxs</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00116">116</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, and <a class="el" href="fees_8cpp_source.html#l00257">removeTx()</a>.</p>
</div>
</div>
<a id="a6d09b27bc31a4f7ce4a8104d61546d37"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6d09b27bc31a4f7ce4a8104d61546d37">&#9670;&nbsp;</a></span>txCtAvg</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;double&gt; TxConfirmStats::txCtAvg</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00089">89</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, <a class="el" href="fees_8cpp_source.html#l00067">UpdateMovingAverages()</a>, and <a class="el" href="fees_8cpp_source.html#l00176">Write()</a>.</p>
</div>
</div>
<a id="ab80a5b84994e90d568f798632a510ab3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab80a5b84994e90d568f798632a510ab3">&#9670;&nbsp;</a></span>unconfTxs</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;std::vector&lt;int&gt; &gt; TxConfirmStats::unconfTxs</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">private</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="fees_8h_source.html#l00114">114</a> of file <a class="el" href="fees_8h_source.html">fees.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="fees_8cpp_source.html#l00041">ClearCurrent()</a>, <a class="el" href="fees_8cpp_source.html#l00078">EstimateMedianVal()</a>, <a class="el" href="fees_8cpp_source.html#l00015">Initialize()</a>, <a class="el" href="fees_8cpp_source.html#l00248">NewTx()</a>, <a class="el" href="fees_8cpp_source.html#l00185">Read()</a>, and <a class="el" href="fees_8cpp_source.html#l00257">removeTx()</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li>src/policy/<a class="el" href="fees_8h_source.html">fees.h</a></li>
<li>src/policy/<a class="el" href="fees_8cpp_source.html">fees.cpp</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="classTxConfirmStats.html">TxConfirmStats</a></li>
<li class="footer">Generated on Thu Dec 14 2017 13:15:13 for Dash Core by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.14 </li>
</ul>
</div>
</body>
</html>
Reference in a new issue View git blame Copy permalink