devise 1.7.0

目录

• Installation
• How To Use Our Python Package
• How To Access The Devise Alternative Exchange

Installation

安装devise repo的最简单方法是从pypi:

$ pip install devise

或者，您可以克隆此repo并安装它：

$ git clone https://github.com/devisechain/Devise
$ cd Devise/python
$ pip install .

有关更详细的安装说明和平台特定系统依赖项的信息，请参阅我们的Installation Guide

How To Use Our Python Package

所有与设计相关的操作都可以通过DeviseClient类执行。

一个DeviseClient对象通过一个公共以太坊节点连接到以太坊网络，既用于需要签名的链上操作（也称为事务），也用于免费的链外操作（也称为调用）。

对于任何需要加密签名的操作，我们支持Official Ethereum Wallet、硬件钱包（具体来说是Ledger Nano S和Trezor）、加密密钥库文件和清除私钥。

要使用Official Ethereum Wallet，请运行

fromdeviseimportDeviseClient# Create a Devise client object to interact with our smart contracts and API.devise_client=DeviseClient(account='0xd4a6B94E45B8c0185...',password='<your password>')

要使用硬件钱包，请运行

fromdeviseimportDeviseClient# Create a Devise client object to interact with our smart contracts and API.devise_client=DeviseClient(account='0xd4a6B94E45B8c0185...',auth_type='[ledger|trezor]')

要使用密钥库文件，请运行

fromdeviseimportDeviseClient# Create a Devise client object to interact with our smart contracts and API.devise_client=DeviseClient(key_file='<path to your encrypted json keystore file>',password='<your password>')

要使用清除私钥，请运行

fromdeviseimportDeviseClient# Create a Devise client object to interact with our smart contracts and API.devise_client=DeviseClient(private_key='<your private key>')

参数password始终是可选的。当需要签名但未提供时，每次需要签名事务时，系统都会提示您键入。

如果需要，可以在创建DeviseClient实例时指定自己的node_url来覆盖用于连接以太坊网络的公共节点。

How To Access The Devise Alternative Exchange

为了访问设计替代交换，您需要i）在您的托管帐户中有足够的设计令牌（DVZ），ii）提交投标，以及iii）如果您的投标成功，则从API请求数据。

要在我们这里为您的托管账户提供资金，请运行：

# Provision your escrow account with DVZ by transferring qty ETH from your Ethereum wallet to the rental Smart contract.qty=1000devise_client.fund_account(amount=qty,unit='ETH',source='ETH')# Check your remaining escrow balance in DVZ tokensremaining=devise_client.dvz_balance_escrow

如果需要，您可以请求历史数据来评估增值：

# Note: Historical data are free of charge, but your escrow account# must be sufficiently provisioned to pay one month rent to be allowed# access historical data.# Check if you are currently allowed to request historical data.has_access=devise_client.client_summary['historical_data_access']print(has_access)# Download historical weights of all leptons on the Devise alternative# exchange and store them in the file 'devise_historical_weights.tar'# in the current folder.devise_client.download_historical_weights()# Download historical returns of all leptons on the Devise alternative# exchange and store them in the file 'devise_historical_returns.tar'# in the current folder.devise_client.download_historical_returns()

一旦你知道你想要多少个座位，以什么价格，你可以通过运行提交您的出价

# Example: submit a bid for 10 seats on the Devise alternative exchange, for a monthly rent capped at 200,000 DVZ.seats=10# Note: The limit monthly rent per seat below is indicative.lmt_monthly_rent_per_seat=200000# The limit price the auction abides by is the limit price per bit of total incremental usefulness.# If between terms leptons are added to the chain, the total incremental usefulness might change,# and as a result you might be paying a higher rent. Your rent per seat and per unit of total# incremental usefulness will however never exceed your specified limit price per bit.lmt_price=lmt_monthly_rent_per_seat/devise_client.total_incremental_usefulnessdevise_client.lease_all(lmt_price,seats)

要检查您是否赢得了本学期的席位，请运行

# Check how many seats you have access to in the current term.total_seats=devise_client.current_term_seatshas_seats=total_seats>0print(has_seats)

如果您有资格获得座位，您可以通过运行来请求公文包权重更新

# Download latests weights of all leptons on the Devise alternative exchange# and stores them in the file 'devise_latest_weights_<yyyy-mm-dd>.tar'# in the current folder. Data updates are available on a daily basis before 7AM ET.latest_weights=devise_client.download_latest_weights()

有关更多信息，请查看我们的wiki。