# Gavin Andresen
# 2010-06-25 19:18:15
# https://bitcointalk.org/index.php?topic=214.msg1773#msg1773

I want to write an application that does stuff whenever bitcoins are sent to a particular Bitcoin address. @p{par}

Actually, that feature would be useful for the Bitcoin Faucet (it could monitor the donation address and keep it's display of how many bitcoins are available more up-to-date; currently I memcache the balance and only update it every 10 minutes or so). @p{par}

I want this new JSON-RPC call: @p{par}

monitorreceivedbyaddress(address, nConfirmations, url) @p{brk}
 address:  bitcoin address to monitor @p{brk}
 nConfirmations: send notification after this many transaction confirmations @p{brk}
 url: POST detail of the transaction to this url (after nConfirmations) @p{par}

I'm thinking the POST data would look like: @p{brk}

Code:
{"tx_id" : "...transaction id, maybe encoded into hex", @p{brk}
  "address" : bitcoin address being monitored @p{brk}
  "label" : label (if any) of the bitcoin address being monitored @p{brk}
  "amount" : amount being paid to address @p{brk}
  "confirmations" : number of confirmations @p{brk}
  "from" : [ "address" , "address" ]  # Sending address(es) @p{brk}
} @p{brk}

 @p{brk}
I don't think teaching the bitcoin client to do HTTP POSTs would be horribly hard; I might take a whack at implementing this myself... @p{brk}