返回目录:理财投资
命令:getnewaddress、getreceivedbyaddress、listtransactions、
getaddressesbyaccount、getbalance
比特币参考客户端维护了一个地址池,地址池的大小可以用 getinfo 命令keypoolsize 参数获取。这些地址是自动生成的,可以被用作公开接收地址或零钱地址。使用 getnewaddress 命令可以获得其中的一个地址:
$ bitcoin-cli getnewaddress 1hvzSofGwT8cjb8JU7nBsCSfEVQX5u9CL
现在我们可以使用这个地址从一个外部钱包(假设你在其他交易所、在线钱包或其他 bitcoind 钱包有一些比特币)向我们的 bitcoind 钱包发送一小笔比特币。在本例中,我们将向下面的地址中发送 50mBTC(0.050 比特币)。
我们可以询问 bitcoind 客户端此地址已经接收到的比特币数额,以及指定该数额要被加到余额中所需要的确认数。在本例中,我们指定只需要 0 个确认。在从另一个钱包发送比特币数秒之后,我们将在这个钱包看到反应。我们用getreceivedbyaddress 命令、这个地址及设置确认数为 0:
$ bitcoin-cli getreceivedbyaddress 1hvzSofGwT8cjb8JU7nBsCSfEVQX5u9CL 0
0.05000000
如果我们忽略这个命令后面的 0,我们将只能在至少 minconf 个确认之后才能看到数额,minconf 是想要某笔交易出现在余额中所设置的最少确认数。
minconf 设置在 bitcoind 配置文件指定。由于这笔发送比特币的交易仅在数秒之前完成,它还没有被确认,因而我们将看到余额是 0:
$ bitcoin-cli getreceivedbyaddress 1hvzSofGwT8cjb8JU7nBsCSfEVQX5u9CL 0.00000000
整个钱包接收到的交易可以通过使用 listtransactions 命令展示出来:
$ bitcoin-cli listtransactions [
{
"account" : "", "address":"1hvzSofGwT8cjb8JU7nBsCSfEVQX5u9CL", "category" : "receive",
"amount" : 0.05000000,
"confirmations" : 0, "txid" :
"9ca8f969bd3ef5ec2a8685660fdbf7a8bd365524c2e1fc66c309ac bae2c14ae3",
"time" : 1392660908,
"timereceived" : 1392660908
}
]
我们可以使用 getaddressesbyaccount 命令列出整个钱包的所有地址:
$ bitcoin-cli getaddressesbyaccount "" [
"1LQoTPYy1TyERbNV4zZbhEmgyfAipC6eqL", "17vrg8uwMQUibkvS2ECRX4zpcVJ78iFaZS",
"1FvRHWhHBBZA8cGRRsGiAeqEzUmjJkJQWR",
"1NVJK3JsL41BF1KyxrUyJW5XHjunjfp2jz", "14MZqqzCxjc99M5ipsQSRfieT7qPZcM7Df", "1BhrGvtKFjTAhGdPGbrEwP3xvFjkJBuFCa", "15nem8CX91XtQE8B1Hdv97jE8X44H3DQMT",
"1Q3q6taTsUiv3mMemEuQQJ9sGLEGaSjo81", "1HoSiTg8sb16oE6SrmazQEwcGEv8obv9ns", "13fE8BGhBvnoy68yZKuWJ2hheYKovSDjqM", "1hvzSofGwT8cjb8JU7nBsCSfEVQX5u9CL", "1KHUmVfCJteJ21LmRXHSpPoe23rXKifAb2", "1LqJZz1D9yHxG4cLkdujnqG5jNNGmPeAMD"
]
最后,getbalance 命令将显示所有经过至少 minconf 个确认的交易加和后的余额:
$ bitcoin-cli getbalance 0.05000000
如果交易还未被确认,getbalance 返回的余额将为 0。配置项“minconf”决定了交易在余额中体现的最少确认数。