如何确定一笔用户的BTC转入记录

在用户充值BTC业务中，我们需要通过BTC官方RPC接口中的 listtransactions 接口来获取BTC钱包中最近的交易记录，当监听当某笔未处理的记录时，我们会给记录对应的用户加钱，然后将这笔记录在系统中标记为已处理状态。重点是接口会返回许多笔交易记录，那如何判断某笔记录是已经被我们系统查询到且已经处理了呢？

首先想到的 listtransactions 接口中返回的 txid 字段，起初我们认为 txid 应该是唯一的不会重复的，但在系统后续的运行过程中发现多笔交易记录的 txid 字段是同样的，观察了一下，应该是短时间内发起的多笔BTC交易的 txid 字段是一致的，所以说不能只通过判断 txid 在系统中是否存在来断定系统是否处理过。

通过在网上仔细查阅BTC相关原理后得知，BTC一笔交易记录（一个 txid 就代表了一笔交易记录）可以有多个发送方和多个接收方，这里有一个 vout 参数，代表交易序号。单个地址到单个地址的交易可以凭借此参数确定唯一性。这个参数已经在 listtransactions 接口中返回。
结论：系统需要同时保存 txid 和 vout 字段。在我们观察通过 listtransactions 接口拿到的记录时， txid 可能会重复，但相同 txid 的多笔记录中的 vout 字段一定不同。所以需要结合 txid 和 vout 字段一起判断一笔转入记录。