Bitcoin Forum
June 23, 2018, 11:56:21 PM *
News: Latest stable version of Bitcoin Core: 0.16.1  [Torrent]. (New!)
   Home   Help Search Donate Login Register  
Pages: [1]
Author Topic: Satoshi Client Operation: Transaction Exchange  (Read 5418 times)
Offline Offline

Activity: 64
Merit: 10

View Profile
September 06, 2011, 03:57:31 AM

Satoshi Client Operation: Transaction Exchange

The Satoshi client advertises locally generated transactions and relays
transactions from other nodes. This article describes the operations
that deal with this exchange of transactions.

See this article for more information on how transactions are validated:

-- Wallet Send --

The client periodically calls SendMessages() (in main.cpp) which calls
ResendWalletTransactions to send transactions generated locallly.
This routine looks to see if there has been a new block since last time,
and if so, and the local transaction are still not in a block,
then the transactions are sent to all nodes.
This is done only about every 30 minutes.

Transactions are only rebroadcast if they have a timestamp at least
5 minutes older than the last block was received. They are sorted
and sent oldest first.[1]

-- Periodic Advertisement --

The client periodically calls SendMessages() (in main.cpp) which
determines if a message should be sent to a remote node.
For each message processing iteration, one node is chosen as the
"trickle node".[2]  This node is the only one chosen to receive
an "addr" message, if appropriate.[3]

In the section for inventory, the client sends 1/4 of the transaction
inventory, determined randomly [4], UNLESS they are the trickle node,
in which case they receive ALL transactions.[5] Yes that seems reversed,
but it is what it is. If the node is to receive 1/4 (not all), then the
code also avoids sending any transactions that came from the local
wallet.[6]  The comments indicate this is intended to increase privacy.

-- Relay --

When the client receives a transaction via a "tx" messages,
it calls RelayMessage, which calls RelayInventory, which queues the
inventory to be sent to all other nodes.[7]


 1. See CWallet::ResendWalletTransactions in wallet.cpp.
 2. See:
       pnodeTrickle = vNodesCopy[GetRand(vNodesCopy.size())];
      ... and ...
       SendMessages(pnode, pnode == pnodeTrickle);
    in ThreadMessageHandler2() in net.cpp.
 3. See:
        // Message: addr
        if (fSendTrickle)
    in SendMessages() in main.cpp.
 4. See:
       bool fTrickleWait = ((hashRand & 3) != 0);
    in SendMessages() in main.cpp.
 5. See:
        // trickle out tx inv to protect privacy
        if (inv.type == MSG_TX && !fSendTrickle)
    in SendMessages() in main.cpp.
 6. See:
        // always trickle our own transactions
        if (!fTrickleWait)
            CWalletTx wtx;

            if (GetTransaction(inv.hash, wtx))
               if (wtx.fFromMe)
                  fTrickleWait = true;
    in SendMessages() in main.cpp.
 7. Both RelayMessage and RelayInventory in net.h.

Search on "Satoshi Client Operation" for more articles in this series.
Be very wary of relying on JavaScript for security on sites such as and The site can change the JavaScript at any time unless you take unusual precautions, and browsers are not generally known for their airtight security.
Advertised sites are not endorsed by the Bitcoin Forum. They may be unsafe, untrustworthy, or illegal in your jurisdiction. Advertise here.
Hero Member
Offline Offline

Posts: 1529798181

View Profile Personal Message (Offline)

Reply with quote  #2

Report to moderator
Jr. Member
Offline Offline

Activity: 38
Merit: 0

Founder + CEO, BitBox

View Profile WWW
July 18, 2013, 06:48:32 AM

Which version of the client are you describing? I'm looking at 0.1.0 and things aren't lining up.

Check out BitBox, let us know what you think:
Sr. Member
Offline Offline

Activity: 402
Merit: 250 - Proof-of-Skill -

View Profile WWW
March 12, 2014, 02:50:13 AM

any word on the version?

[ANN] [ƑɃ] Fantasybit Sale Live ⛓ Proof-of-Skill Blockchain 🏈 Fantasy Sports 🏈
Offline Offline

Activity: 987
Merit: 1000

View Profile
March 13, 2014, 04:53:08 PM

I've been studying 0.1.3 source while reading bitrick's posts. It lines up pretty well.

The essential parts are already in place in 0.1.0 though. Just the initialization is different in
later versions.

My first post. Hello world.

“Civilization is a hopeless race to discover remedies for the evils it produces.”
― Jean-Jacques Rousseau
Pages: [1]
Jump to:  

Sponsored by , a Bitcoin-accepting VPN.
Powered by MySQL Powered by PHP Powered by SMF 1.1.19 | SMF © 2006-2009, Simple Machines Valid XHTML 1.0! Valid CSS!