ens 0.6.1

从名称获取地址

默认为{name}.eth

from ens import ens


# look up the hex representation of the address for a name

eth_address = ens.address('jasoncarver.eth')

assert eth_address == '0x5b2063246f2191f18f2675cedb8b28102e957458'


# ens.py will assume you want a .eth name if you don't specify a full name

assert ens.address('jasoncarver') == eth_address

从地址获取名称

domain = ens.name('0x5b2063246f2191f18f2675cedb8b28102e957458')


# name() also accepts the bytes version of the address

assert ens.name(b'[ c$o!\x91\xf1\x8f&u\xce\xdb\x8b(\x10.\x95tX') == domain


# confirm that the name resolves back to the address that you looked up:

assert ens.address(domain) == '0x5b2063246f2191f18f2675cedb8b28102e957458'

获取名称的所有者

eth_address = ens.owner('exchange.eth')

将您的名称指向您的地址

您想设置您的名称，以便ens.address()显示它指向的地址吗？

ens.setup_address('jasoncarver.eth', '0x5b2063246f2191f18f2675cedb8b28102e957458')

您必须是域（或其父域）的所有者。

在通常情况下，您想将名称指向拥有地址时，可以跳过地址

ens.setup_address('jasoncarver.eth')

您可以任意深度地声明子域。 气体成本会随着子域数量的增加而增加！

ens.setup_address('supreme.executive.power.derives.from.a.mandate.from.the.masses.jasoncarver.eth')

等待交易被挖矿，然后

assert ens.address('supreme.executive.power.derives.from.a.mandate.from.the.masses.jasoncarver.eth') == \
    '0x5b2063246f2191f18f2675cedb8b28102e957458'

将您的地址指向您的名称

您想设置您的地址，以便ens.name()显示指向它的名称吗？

这就像来电显示。它使您和其他人能够取一个账户并确定指向它的名称。有时这被称为“反向”解析。

ens.setup_name('jasoncarver.eth', '0x5b2063246f2191f18f2675cedb8b28102e957458')

如果您不提供地址，setup_name将假设您想要ens.address(name)返回的地址。

ens.setup_name('jasoncarver.eth')

如果名称尚未指向地址，ens.setup_name将为您调用ens.setup_address。

等待交易被挖矿，然后

assert ens.name('0x5b2063246f2191f18f2675cedb8b28102e957458') == 'jasoncarver.eth'

获取拍卖状态

以域名‘payment.eth’为例

from ens.registrar import Status


status = ens.registrar.status('payment')


# if you forget to strip out .eth, ens.py will do it for you

assert ens.registrar.status('payment.eth') == status


# these are the possible statuses

assert status in (
  Status.Open,
  Status.Auctioning,
  Status.Owned,
  Status.Forbidden,
  Status.Revealing,
  Status.NotYetAvailable
  )


# if you get the integer status from another source, you can compare it directly

assert Status.Owned == 2

开始拍卖

# start one auction (which tips people off that you're interested)

ens.registrar.start('you_saw_him_repressin_me_didnt_ya')


# start many auctions (which provides a bit of cover)

ens.registrar.start(['exchange', 'tickets', 'payment', 'trading', 'registry'])

对拍卖出价

以5211 ETH的价格出价“trading.eth”，并秘密“我保证我不会忘记我的秘密”

from web3utils import web3

ens.registrar.bid(
      'trading',
      web3.toWei('5211', 'ether'),
      "I promise I will not forget my secret",
      transact={'from': web3.eth.accounts[0]}
      )

(如果您想“隐藏”您的出价，请在transact字典中设置更高的值)

揭示您的出价

您必须始终揭示您的出价，无论您是赢是输。否则您将损失全部押金。

在‘registry.eth’上以0.01 ETH揭示您的出价，并秘密“说实话，虽然：失去你的秘密意味着失去以太币”

ens.registrar.reveal(
      'registry',
      web3.toWei('0.01', 'ether'),
      "For real, though: losing your secret means losing ether",
      transact={'from': web3.eth.accounts[0]}
      )

领取您赢得的名称

也称为“最终化”拍卖，使您在ENS中成为所有者。

ens.registrar.finalize('gambling')

获取拍卖的详细信息

找出拍卖契据的所有者 - 查看关于拥有名称和契据之间差异的文档

deed = ens.registrar.deed('ethfinex')

assert deed.owner() == '0x9a02ed4ca9ad55b75ff9a05debb36d5eb382e184'

拍卖何时完成？（时区感知的日期时间对象）

close_datetime = ens.registrar.close_at('ethfinex')

assert str(close_datetime) == '2017-06-05 08:10:03+00:00'

存入多少押金？

from decimal import Decimal

deposit = ens.registrar.deposit('ethfinex')

assert web3.fromWei(deposit, 'ether') == Decimal('0.01')

最高出价是多少？

top_bid = ens.registrar.top_bid('ethfinex')

assert web3.fromWei(top_bid, 'ether') == Decimal('201709.02')