source: project/wiki/eggref/4/bitcoin @ 33385

Last change on this file since 33385 was 33385, checked in by evhan, 4 years ago

egg-locations: Migrate my eggs from bitbucket.org to foldling.org

File size: 1.3 KB
Line 
1[[tags: egg]]
2
3== bitcoin
4
5[[toc:]]
6
7=== Description
8
9An interface to [[https://en.bitcoin.it/wiki/Bitcoind|bitcoind]]'s JSON-RPC API.
10
11The source for this egg is available
12[[http://git.foldling.org/chicken-bitcoin.git|here]].
13
14=== Requirements
15
16* [[/egg/uri-common|uri-common]]
17* [[/egg/http-client|http-client]]
18* [[/egg/medea|medea]]
19
20=== Usage
21
22Function names and signatures match those listed in the
23[[https://en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list|bitcoind API reference]].
24JSON responses are translated into Scheme datatypes according to [[/egg/medea|medea]]'s conversion rules.
25
26When an error response is received from bitcoind, an exception of type {{(exn bitcoin)}} is raised.
27
28    > (use bitcoin)
29    > (define c (make-bitcoind-connection "http://user:pass@localhost:8332"))
30    > (getblockcount c)
31    215673
32    > (getblock c 123456)
33    "0000000000002917ed80650c6174aac8dfc46f5fe36480aaef682ff6cd83c3ca"
34    > (getinfo c)
35    ((version . 70200)
36     (protocolversion . 60002)
37     (walletversion . 60000)
38     (balance . 12.0)
39     (blocks . 215673)
40     (connections . 0)
41     (proxy . "")
42     (difficulty . 2979636.61693807)
43     (testnet . #f)
44     (keypoololdest . 1357260660)
45     (keypoolsize . 108)
46     (paytxfee . 0.0)
47     (errors . ""))
48
49=== License
50
51Public Domain
Note: See TracBrowser for help on using the repository browser.