アカウント: svn rev 188(JSON-RPCのAPIの変更)
数週間前にこのスレッド (http://bitcointalk.org/index.php?topic=665.msg18890#msg18890)で話し合った「アカウント」の、最小限の実装をコミットした。
コマンドラインやJSONのAPIを使っているなら、手元のコードが動かなくなるかもしれない変更が一つあるので、知っておいてほしい。sendtoaddressメソッドは、「sent」という文字列の代わりに、16進のトランザクションID(256ビットのハッシュ)を返すようになる。
「label」のコマンドは、どれも名前が変わった。古い名前もまだ使えるが、非推奨で、いずれなくなるかもしれない。
ビットコインを使うウェブサービスを開発しているなら、新しい「sendfrom」と「move」のメソッドで、顧客のアカウントの残高の管理がずっと楽になる。APIは、次のように使うことを想定している。
新しいアカウントを作る:アプリケーションの中で、重ならないアカウントIDを生成するだけでいい(顧客のログイン名など)。
アカウントに結びついた、ビットコインの受け取り用のアドレスを得る:
getaccountaddress <account_id>
注:一つのアカウントに、複数のビットコインアドレスを結びつけられる
顧客のアカウントからビットコインを送る:
sendfrom <fromaccount> <tobitcoinaddress> <amount> [minconf=1] [comment] [comment-to]
送る側のアカウントのビットコインが足りなければ失敗する(足りていれば、トランザクションIDを返す)
アカウントのあいだでビットコインを動かす:
move <fromaccount> <toaccount> <amount> [minconf=1] [comment]
移す元のアカウントのビットコインが足りなければ失敗する
アカウントの残高を調べる:
getbalance [account] [minconf=1]
名前が空文字列のアカウントは、少し特別だ。ほかのアカウントに結びついていないビットコインアドレスで受け取ったコインは、すべてこのアカウントに入り、(古い)sendtoaddressメソッドで送ったコインは、このアカウントから引かれる。
近いうちに、ウォレットにあるトランザクションの詳細(どのアカウント宛てか、どのアカウントからか、手数料を払ったかどうかなど)を返すgettransaction <txid>メソッドを入れたい。それと、あるアカウントの残高を作っているトランザクションを、帳簿を付ける人にも分かりやすい明細の一覧で取り出すlisttransactionsも。