blockchain 1.0.2 → 1.1.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 9632fa2321d9fd2c31b83a92805d0e4b5c3adb8c
4
- data.tar.gz: 815a5905bfe359dd078674515e0e5e23c6047785
3
+ metadata.gz: e743573eea586a756a9be86dd0520a3ef75731ac
4
+ data.tar.gz: b0e4df9dcaadddbd4ea608ad52a7e7488ddb4372
5
5
  SHA512:
6
- metadata.gz: c4950484bf456cf3ea3b5924a39faab96d6788a660ca28cbe9e8c0e0fff63a1b62606a3e775eb928a68184d995b4135654ed1638d2b594be1e3c04d0b55d1fb0
7
- data.tar.gz: 57369609fe4381631733b42d482319a2b3927e8d71a9498104424d5f9bd06f8e64c61251575fcbd77aff7cdf0016d3c091da0d0937cbcae422331d8e5374accd
6
+ metadata.gz: 776d8f47c6ab6880fc3597990d034f433b0a54075585cd936f8b068a98c9b48407fd14021a8108784dd75ca064efcb9d276af7684f8e1cdfb647e0fa72ab3c6d
7
+ data.tar.gz: 5b4ef222ccaabc04bdc9cbcd227b32ff1b3a1f5dcd684e7775cb30ee448b597c68f1d76302d1d549c5eb6003d76808b1298576429f6276e892708cd5dab2dc86
data/README.md CHANGED
@@ -1,57 +1,57 @@
1
- #Blockchain API library (Ruby, v1)
2
-
3
- An official Ruby gem for interacting with the Blockchain.info API.
4
-
5
- ###Getting started
6
-
7
- Installation via RubyGems:
8
-
9
- ```
10
- $ gem install blockchain
11
- ```
12
-
13
- Manual installation:
14
- ```
15
- $ git clone https://github.com/blockchain/api-v1-client-ruby
16
- $ cd api-v1-client-ruby
17
- $ rake install
18
- ```
19
-
20
- The gem consists of the following functionality:
21
-
22
- * `blockexplorer` ([docs](docs/blockexplorer.md)) ([api/blockchain_api][api1])
23
- * `createwallet` ([docs](docs/createwallet.md)) ([api/create_wallet][api2])
24
- * `exchangerates` ([docs](docs/exchangerates.md)) ([api/exchange\_rates\_api][api3])
25
- * `pushtx` ([docs](docs/pushtx.md)) ([pushtx][api7])
26
- * `receive` ([docs](docs/receive.md)) ([api/api_receive][api4])
27
- * `statistics` ([docs](docs/statistics.md)) ([api/charts_api][api5])
28
- * `wallet` ([docs](docs/wallet.md)) ([api/blockchain\_wallet\_api][api6])
29
-
30
- The main module is called `Blockchain`
31
-
32
- ###Error handling
33
-
34
- All functions may raise exceptions caused by incorrectly passed parameters or other problems. If a call is rejected server-side, the `APIException` exception will be raised.
35
-
36
- ###Connection timeouts
37
-
38
- It is possible to set arbitrary connection timeouts.
39
-
40
- ```ruby
41
- require 'blockchain'
42
- Blockchain::TIMEOUT_SECONDS = 5 #time out after 5 seconds
43
- ```
44
-
45
- ###Request limits and API keys
46
-
47
- In order to prevent abuse some API methods require an API key approved with some basic contact information and a description of its intended use. Please request an API key [here](https://blockchain.info/api/api_create_code).
48
-
49
- The same API key can be used to bypass the request limiter.
50
-
51
- [api1]: https://blockchain.info/api/blockchain_api
52
- [api2]: https://blockchain.info/api/create_wallet
53
- [api3]: https://blockchain.info/api/exchange_rates_api
54
- [api4]: https://blockchain.info/api/api_receive
55
- [api5]: https://blockchain.info/api/charts_api
56
- [api6]: https://blockchain.info/api/blockchain_wallet_api
57
- [api7]: https://blockchain.info/pushtx
1
+ #Blockchain API library (Ruby, v1)
2
+
3
+ An official Ruby gem for interacting with the Blockchain.info API.
4
+
5
+ ###Getting started
6
+
7
+ Installation via RubyGems:
8
+
9
+ ```
10
+ $ gem install blockchain
11
+ ```
12
+
13
+ Manual installation:
14
+ ```
15
+ $ git clone https://github.com/blockchain/api-v1-client-ruby
16
+ $ cd api-v1-client-ruby
17
+ $ rake install
18
+ ```
19
+
20
+ The gem consists of the following functionality:
21
+
22
+ * `blockexplorer` ([docs](docs/blockexplorer.md)) ([api/blockchain_api][api1])
23
+ * `createwallet` ([docs](docs/createwallet.md)) ([api/create_wallet][api2])
24
+ * `exchangerates` ([docs](docs/exchangerates.md)) ([api/exchange\_rates\_api][api3])
25
+ * `pushtx` ([docs](docs/pushtx.md)) ([pushtx][api7])
26
+ * `receive` ([docs](docs/receive.md)) ([api/api_receive][api4])
27
+ * `statistics` ([docs](docs/statistics.md)) ([api/charts_api][api5])
28
+ * `wallet` ([docs](docs/wallet.md)) ([api/blockchain\_wallet\_api][api6])
29
+
30
+ The main module is called `Blockchain`
31
+
32
+ ###Error handling
33
+
34
+ All functions may raise exceptions caused by incorrectly passed parameters or other problems. If a call is rejected server-side, the `APIException` exception will be raised.
35
+
36
+ ###Connection timeouts
37
+
38
+ It is possible to set arbitrary connection timeouts.
39
+
40
+ ```ruby
41
+ require 'blockchain'
42
+ Blockchain::TIMEOUT_SECONDS = 5 #time out after 5 seconds
43
+ ```
44
+
45
+ ###Request limits and API keys
46
+
47
+ In order to prevent abuse some API methods require an API key approved with some basic contact information and a description of its intended use. Please request an API key [here](https://blockchain.info/api/api_create_code).
48
+
49
+ The same API key can be used to bypass the request limiter.
50
+
51
+ [api1]: https://blockchain.info/api/blockchain_api
52
+ [api2]: https://blockchain.info/api/create_wallet
53
+ [api3]: https://blockchain.info/api/exchange_rates_api
54
+ [api4]: https://blockchain.info/api/api_receive
55
+ [api5]: https://blockchain.info/api/charts_api
56
+ [api6]: https://blockchain.info/api/blockchain_wallet_api
57
+ [api7]: https://blockchain.info/pushtx
@@ -1,117 +1,117 @@
1
- ##Block explorer functionality
2
-
3
- All functions support an optional parameter called `api_code`. It won't be listed with every function description.
4
-
5
- ####`get_block`
6
- Get a single block based on a block index or hash. Returns a `Block` object.
7
-
8
- Params:
9
- ```
10
- block_id : str - block index or hash
11
- ```
12
-
13
- Usage:
14
- ```ruby
15
- require 'blockchain'
16
-
17
- block = Blockchain::get_block('000000000000000016f9a2c3e0f4c1245ff24856a79c34806969f5084f410680')
18
- ```
19
-
20
- ####`get_tx`
21
- Get a single transaction based on a transaction index or hash. Returns a `Transaction` object.
22
-
23
- Params:
24
- ```
25
- tx_id : str - transaction index or hash
26
- ```
27
-
28
- Usage:
29
- ```ruby
30
- tx = Blockchain::get_tx('d4af240386cdacab4ca666d178afc88280b620ae308ae8d2585e9ab8fc664a94')
31
- ```
32
-
33
- ####`get_block_height`
34
- Get an array of blocks at the specified height. Returns an array of `Block` objects.
35
-
36
- Params:
37
- ```
38
- height : int - block height
39
- ```
40
-
41
- Usage:
42
- ```ruby
43
- blocks = Blockchain::get_block_height(2570)
44
- ```
45
-
46
- ####`get_address`
47
- Get a single address and its transactions. Returns an `Address` object.
48
-
49
- Params:
50
- ```
51
- address : str - address in the base58 or hash160 format
52
- ```
53
-
54
- Usage:
55
- ```ruby
56
- address = Blockchain::get_address('1HS9RLmKvJ7D1ZYgfPExJZQZA1DMU3DEVd')
57
- ```
58
-
59
- ####`get_unspent_outputs`
60
- Get an array of unspent outputs for an address. Returns an array of `UnspentOutput` objects.
61
-
62
- Params:
63
- ```
64
- address : str - address in the base58 or hash160 format
65
- ```
66
-
67
- Usage:
68
- ```ruby
69
- outs = Blockchain::get_unspent_outputs('1HS9RLmKvJ7D1ZYgfPExJZQZA1DMU3DEVd')
70
- ```
71
-
72
- ####`get_latest_block`
73
- Get the latest block on the main chain. Returns a `LatestBlock` object.
74
-
75
- Usage:
76
- ```ruby
77
- latest_block = Blockchain::get_latest_block()
78
- ```
79
-
80
- ####`get_unconfirmed_tx`
81
- Get a list of currently unconfirmed transactions. Returns an array of `Transaction` objects.
82
-
83
- Usage:
84
- ```ruby
85
- txs = Blockchain::get_unconfirmed_tx()
86
- ```
87
-
88
- ####`get_blocks`
89
- Get a list of blocks for a specific day or mining pool. Returns an array of `SimpleBlock` objects.
90
-
91
- Params:
92
- ```
93
- time : int - unix time in ms (optional)
94
- pool_name : str - pool name (optional)
95
- ```
96
- At least one parameter is required.
97
-
98
- Usage:
99
- ```ruby
100
- blocks = Blockchain::get_blocks(pool_name = 'Discus Fish')
101
- ```
102
-
103
- ####`get_inventory_data`
104
- Get inventory data for recent blocks and addresses (up to 1 hour old). Returns an `InventoryData` object.
105
-
106
- Params:
107
- ```
108
- hash : str - tx or block hash
109
- ```
110
-
111
- Usage:
112
- ```ruby
113
- inv = Blockchain::get_inventory_data('d4af240386cdacab4ca666d178afc88280b620ae308ae8d2585e9ab8fc664a94')
114
- ```
115
-
116
- Note regarding `Input` objects: if coinbase transaction, only `script` and `script_siq` will be populated.
117
-
1
+ ##Block explorer functionality
2
+
3
+ All functions support an optional parameter called `api_code`. It won't be listed with every function description.
4
+
5
+ ####`get_block`
6
+ Get a single block based on a block index or hash. Returns a `Block` object.
7
+
8
+ Params:
9
+ ```
10
+ block_id : str - block index or hash
11
+ ```
12
+
13
+ Usage:
14
+ ```ruby
15
+ require 'blockchain'
16
+
17
+ block = Blockchain::get_block('000000000000000016f9a2c3e0f4c1245ff24856a79c34806969f5084f410680')
18
+ ```
19
+
20
+ ####`get_tx`
21
+ Get a single transaction based on a transaction index or hash. Returns a `Transaction` object.
22
+
23
+ Params:
24
+ ```
25
+ tx_id : str - transaction index or hash
26
+ ```
27
+
28
+ Usage:
29
+ ```ruby
30
+ tx = Blockchain::get_tx('d4af240386cdacab4ca666d178afc88280b620ae308ae8d2585e9ab8fc664a94')
31
+ ```
32
+
33
+ ####`get_block_height`
34
+ Get an array of blocks at the specified height. Returns an array of `Block` objects.
35
+
36
+ Params:
37
+ ```
38
+ height : int - block height
39
+ ```
40
+
41
+ Usage:
42
+ ```ruby
43
+ blocks = Blockchain::get_block_height(2570)
44
+ ```
45
+
46
+ ####`get_address`
47
+ Get a single address and its transactions. Returns an `Address` object.
48
+
49
+ Params:
50
+ ```
51
+ address : str - address in the base58 or hash160 format
52
+ ```
53
+
54
+ Usage:
55
+ ```ruby
56
+ address = Blockchain::get_address('1HS9RLmKvJ7D1ZYgfPExJZQZA1DMU3DEVd')
57
+ ```
58
+
59
+ ####`get_unspent_outputs`
60
+ Get an array of unspent outputs for an address. Returns an array of `UnspentOutput` objects.
61
+
62
+ Params:
63
+ ```
64
+ address : str - address in the base58 or hash160 format
65
+ ```
66
+
67
+ Usage:
68
+ ```ruby
69
+ outs = Blockchain::get_unspent_outputs('1HS9RLmKvJ7D1ZYgfPExJZQZA1DMU3DEVd')
70
+ ```
71
+
72
+ ####`get_latest_block`
73
+ Get the latest block on the main chain. Returns a `LatestBlock` object.
74
+
75
+ Usage:
76
+ ```ruby
77
+ latest_block = Blockchain::get_latest_block()
78
+ ```
79
+
80
+ ####`get_unconfirmed_tx`
81
+ Get a list of currently unconfirmed transactions. Returns an array of `Transaction` objects.
82
+
83
+ Usage:
84
+ ```ruby
85
+ txs = Blockchain::get_unconfirmed_tx()
86
+ ```
87
+
88
+ ####`get_blocks`
89
+ Get a list of blocks for a specific day or mining pool. Returns an array of `SimpleBlock` objects.
90
+
91
+ Params:
92
+ ```
93
+ time : int - unix time in ms (optional)
94
+ pool_name : str - pool name (optional)
95
+ ```
96
+ At least one parameter is required.
97
+
98
+ Usage:
99
+ ```ruby
100
+ blocks = Blockchain::get_blocks(pool_name = 'Discus Fish')
101
+ ```
102
+
103
+ ####`get_inventory_data`
104
+ Get inventory data for recent blocks and addresses (up to 1 hour old). Returns an `InventoryData` object.
105
+
106
+ Params:
107
+ ```
108
+ hash : str - tx or block hash
109
+ ```
110
+
111
+ Usage:
112
+ ```ruby
113
+ inv = Blockchain::get_inventory_data('d4af240386cdacab4ca666d178afc88280b620ae308ae8d2585e9ab8fc664a94')
114
+ ```
115
+
116
+ Note regarding `Input` objects: if coinbase transaction, only `script` and `script_siq` will be populated.
117
+
@@ -1,20 +1,20 @@
1
- ##Create Wallet functionality
2
-
3
- ####`create_wallet`
4
- Create a new Blockchain.info wallet. It can be created containing a pre-generated private key or will otherwise generate a new private key. Returns a `CreateWalletResponse` instance.
5
-
6
- Params:
7
- ```
8
- password : str - password for the new wallet. At least 10 characters.
9
- api_code : str - API code with the create wallets permission
10
- priv : str - private key to add to the wallet (optional, keyword)
11
- label : str - label for the first address in the wallet (optional, keyword)
12
- email : str - email to associate with the new wallet (optional, keyword)
13
- ```
14
-
15
- Usage:
16
- ```ruby
17
- require 'blockchain'
18
-
19
- wallet = Blockchain::create_wallet('1234password', '58ck39ajuiw', label: 'Test wallet')
20
- ```
1
+ ##Create Wallet functionality
2
+
3
+ ####`create_wallet`
4
+ Create a new Blockchain.info wallet. It can be created containing a pre-generated private key or will otherwise generate a new private key. Returns a `CreateWalletResponse` instance.
5
+
6
+ Params:
7
+ ```
8
+ password : str - password for the new wallet. At least 10 characters.
9
+ api_code : str - API code with the create wallets permission
10
+ priv : str - private key to add to the wallet (optional, keyword)
11
+ label : str - label for the first address in the wallet (optional, keyword)
12
+ email : str - email to associate with the new wallet (optional, keyword)
13
+ ```
14
+
15
+ Usage:
16
+ ```ruby
17
+ require 'blockchain'
18
+
19
+ wallet = Blockchain::create_wallet('1234password', '58ck39ajuiw', label: 'Test wallet')
20
+ ```
@@ -1,32 +1,32 @@
1
- ##Exchange rates functionality
2
-
3
- All functions support an optional parameter called `api_code`. It won't be listed with every function description.
4
-
5
- ####`get_ticker`
6
- Call the 'ticker' method and return a dictionary of `Currency` objects. Keys are currency symbols (str) and values are `Currency` objects.
7
-
8
-
9
- Usage:
10
- ```ruby
11
- require 'blockchain'
12
-
13
- ticker = Blockchain::get_ticker()
14
- #print the 15 min price for every currency
15
- ticker.keys.each do |key|
16
- puts ticker[key].p15min
17
- end
18
- ```
19
-
20
- ####`to_btc`
21
- Call the 'tobtc' method and convert x value in the provided currency to BTC. Returns a `float`.
22
-
23
- Params:
24
- ```
25
- ccy : str - currency code
26
- value : float
27
- ```
28
-
29
- Usage:
30
- ```ruby
31
- btc_amount = Blockchain::to_btc('USD', 4342.11)
1
+ ##Exchange rates functionality
2
+
3
+ All functions support an optional parameter called `api_code`. It won't be listed with every function description.
4
+
5
+ ####`get_ticker`
6
+ Call the 'ticker' method and return a dictionary of `Currency` objects. Keys are currency symbols (str) and values are `Currency` objects.
7
+
8
+
9
+ Usage:
10
+ ```ruby
11
+ require 'blockchain'
12
+
13
+ ticker = Blockchain::get_ticker()
14
+ #print the 15 min price for every currency
15
+ ticker.keys.each do |key|
16
+ puts ticker[key].p15min
17
+ end
18
+ ```
19
+
20
+ ####`to_btc`
21
+ Call the 'tobtc' method and convert x value in the provided currency to BTC. Returns a `float`.
22
+
23
+ Params:
24
+ ```
25
+ ccy : str - currency code
26
+ value : float
27
+ ```
28
+
29
+ Usage:
30
+ ```ruby
31
+ btc_amount = Blockchain::to_btc('USD', 4342.11)
32
32
  ```