NAME
Finance::Bitcoin::Wallet - a bitcoin wallet
SYNOPSIS
use Finance::Bitcoin;
my $uri = 'http://user:password@127.0.0.1:8332/';
my $wallet = Finance::Bitcoin::Wallet->new($uri);
print "Have: " . $wallet->balance . "\n";
$wallet->pay($destination_address, $amount);
print "Now have: " . $wallet->balance . "\n";
foreach my $address ($wallet->addresses)
{
print $address->label . "\n";
}DESCRIPTION
This module is part of the high-level API for accessing a running Bitcoin instance.
new($endpoint)-
Constructor. $endpoint may be the JSON RPC endpoint URL, or may be a Finance::Bitcoin::API object.
balance-
Returns the current balance of the wallet.
pay($dest, $amount)-
Pays some bitcoins to an account, causing the balance of the wallet to decrease. $dest may be a Finance::Bitcoin::Address, or an address string.
addresses-
Returns a list of receiving addresses - i.e. addresses that can be used by other people to send money to this wallet. Each item on the list is a Finance::Bitcoin::Address object.
This list may be non-exhaustive!
create_address($label)-
Creates a new receiving address - i.e. an address that can be used by other people to send money to this wallet. $label is an optional human-friendly name for the address. Returns a Finance::Bitcoin::Address object.
api-
Retrieve a reference to the Finance::Bitcoin::API object being used.
BUGS
Please report any bugs to http://rt.cpan.org/.
SEE ALSO
Finance::Bitcoin, Finance::Bitcoin::Address.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT
Copyright 2010-2011 Toby Inkster
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.