django-bitcoin 0.2

内容

• Introduction
• Features
• Installation
• Usage
  • Tutorial
  • Wallet websites, escrow services using the “Wallet”-model
  • Templatetags
  • Transaction notifications
• Community
• Support and source code
• Changelog
  • 0.2 (2013-05-14)
  • 0.1

Tutorial

There is a small tutorial about how to use django-bitcoin to create your own instawallet。

Wallet websites, escrow services using the “Wallet”-model

您可以使用wallet类来执行不同的比特币移动应用程序。典型的例子是一个市场风格的网站，有多个卖家和买家。或自由职业者网站，需要代管。或者甚至可以用这个抽象来完成交换（但是需要一些额外的类）。

请注意，当您在钱包对象之间移动比特币时，只有传入和传出交易才需要比特币交易。 系统“钱包”对象之间的交易不会生成“真实”比特币交易。每个事务（传入事务除外）都会记录到wallettransaction对象以简化记帐。

这也意味着比特币交易是“混合的”：

from django_bitcoin import Wallet, currency

class Profile(models.Model):
    wallet = ForeignKey(Wallet)
    outgoing_bitcoin_address = CharField()

class Escrow(models.Model):
    wallet = ForeignKey(Wallet)
    buyer_happy = BooleanField(default=False)

buyer=Profile.objects.create()
seller=Profile.objects.create()

purchase=Escrow.objects.create()

AMOUNT_USD="9.99"

m=currency.Money(AMOUNT_USD, "USD")
btc_amount=currency.exchange(m, "BTC")

print "Send "+str(btc_amount)+" BTC to address "+buyer.wallet.receiving_address()

sleep(5000) # wait for transaction

if p1.wallet.total_balance()>=btc_amount:
    p1.send_to_wallet(purchase, btc_amount)

    sleep(1000) # wait for product/service delivery

    if purchase.buyer_happy:
        purchase.wallet.send_to_wallet(seller.wallet)
        seller.wallet.send_to_address(seller.outgoing_bitcoin_address, seller.wallet.total_balance())
    else:
        print "WHY U NO HAPPY"
        #return bitcoins to buyer, 50/50 split or something

Templatetags

要在您的视图中显示交易历史记录和简单的电子钱包标记行，请使用以下模板标记：

{% load currency_conversions %}
<!-- display balance tagline, estimate in USD and received/sent -->
{% wallet_tagline profile.bitcoin_wallet %}
<!-- display list of transactions as a table -->
{% wallet_history profile.bitcoin_wallet %}

相互兑换货币的简单方法：BTC2USD、USD2BTC、Eur2BTC、BTC2EUR

在BitcoinCharts.com上，任何货币都可以使用Currency2BTC和BTC2Currency:

{% load currency_conversions %}
Hi, for the pizza: send me {{bitcoin_amount}}BTC (about {{ bitcoin_amount|btc2usd }}USD).

使用google charts api显示比特币支付的二维码：

{% load currency_conversions %}
Pay the following payment with your android bitcoin wallet:
{% bitcoin_payment_qr wallet.receiving_address bitcoin_amount %}.

The same but display also description and an estimate in EUR:
{% bitcoin_payment_qr wallet.receiving_address bitcoin_amount "One beer" "EUR" %}.

Transaction notifications

要启用比特币交易通知，请在settings.py中设置以下标志：

BITCOIN_TRANSACTION_SIGNALING = True

之后，您需要设置一个cron作业来每分钟运行一次，如下所示：

* * * * * (cd $APP_PATH && python manage.py python manage.py CheckTransactions >> $APP_PATH/logs/email_sends.log 2>&1)

之后，您可以定义您的余额更改和余额更改确认信号：

from django_bitcoin.models import balance_changed, balance_changed_confirmed
from django.dispatch import receiver


@receiver(balance_changed)
def balance_changed_handler(sender, **kwargs):
    pass
    # try:
    # print "balance changed", sender.id, kwargs["changed"], sender.total_balance()


@receiver(balance_changed_confirmed)
def balance_changed_confirmed_handler(sender, **kwargs):
    pass

0.2 (2013-05-14)

• readme.rst，更改日志和发布流程工作流更新[miohtama]
• 历史价格数据处理[Jeremias Kangas]

0.1

• 初始版本