web3.eth.ens¶

`web3.eth.ens` 相关函数让你可以与 ENS 进行交互。¶

registry¶

web3.eth.ens.registry;

返回指定网络的 ENS 注册表。

返回值¶

Registry - 当前 ENS 注册表。

例子¶

web3.eth.ens.registry;
> {
    ens: ENS,
    contract: Contract,
    owner: Function(name),
    resolve: Function(name)
}

resolver¶

web3.eth.ens.resolver(name);

返回以太坊域名地址对应的 resolver 合约。

返回值¶

Reslver - 该域名对应的 ENS resolver。

例子¶

web3.eth.ens.resolver('ethereum.eth').then(function (contract) {
    console.log(contract);
});
> Contract<Resolver>

getAddress¶

web3.eth.ens.getAddress(ENSName);

将 ENS 域名解析为以太坊地址。

参数¶

ENSName - String: 需哟解析的 ENS 域名。

返回值¶

String - 给定域名的以太坊地址。

例子¶

web3.eth.ens.getAddress('ethereum.eth').then(function (address) {
    console.log(address);
})
> 0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359

setAddress¶

web3.eth.ens.setAddress(ENSName, address, options);

通过域名解析器（resolver）指定 ENS 域名对应的以太坊地址。

参数¶

ENSName - String: ENS 域名。
address - String: 要设置的以太坊地址。
options - Object: 用于发送交易的参数选项。
- from - String: 交易发出地址。
- gasPrice - String (可选): 用于此交易的燃料价格（以 wei 为单位）。
- gas - Number (可选): 用于此交易的最大燃料数量（gasLimit）。

AddrChanged 事件会被触发。

例子¶

web3.eth.ens.setAddress(
    'ethereum.eth',
    '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then(function (result) {
         console.log(result.events);
});
> AddrChanged(...)

// 或者使用事件触发器

web3.eth.ens.setAddress(
    'ethereum.eth',
    '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', function(hash){
    ...
})
.on('confirmation', function(confirmationNumber, receipt){
    ...
})
.on('receipt', function(receipt){
    ...
})
.on('error', console.error);

// Or listen to the AddrChanged event on the resolver

web3.eth.ens.resolver('ethereum.eth').then(function (resolver) {
    resolver.events.AddrChanged({fromBlock: 0}, function(error, event) {
        console.log(event);
    })
    .on('data', function(event){
        console.log(event);
    })
    .on('changed', function(event){
        // remove event from local database
    })
    .on('error', console.error);
});


关于合约事件处理的更多信息，请看这里 contract-events_。

getPubkey¶

web3.eth.ens.getPubkey(ENSName);

返回公钥所在曲线点的 X 和 Y 坐标。

参数¶

ENSName - String: ENS 域名。

返回值¶

Object<String, String> - X 和 Y 坐标。

例子¶

web3.eth.ens.getPubkey('ethereum.eth').then(function (result) {
    console.log(result)
});
> {
    "0": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "1": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "x": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "y": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

setPubkey¶

web3.eth.ens.setPubkey(ENSName, x, y, options);

设置 ENS 节点对应的 SECP256k1 公钥。

参数¶

ENSName - String: ENS 域名。
x - String: 公钥的 X 坐标。
y - String: 公钥的 Y 坐标。
options - Object: 用于发送交易的参数选型。
- from - String: 交易发出地址。
- gasPrice - String (可选): 用于此交易的燃料价格（以 wei 为单位）。
- gas - Number (可选): 用于此交易的最大燃料数量（gasLimit）。

触发 PubkeyChanged 事件。

例子¶

web3.eth.ens.setPubkey(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then(function (result) {
    console.log(result.events);
});
> PubkeyChanged(...)

// 或者使用事件触发器

web3.eth.ens.setPubkey(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', function(hash){
    ...
})
.on('confirmation', function(confirmationNumber, receipt){
    ...
})
.on('receipt', function(receipt){
    ...
})
.on('error', console.error);

// 或者监听与 resolver 关联的 PubkeyChanged 事件


web3.eth.ens.resolver('ethereum.eth').then(function (resolver) {
    resolver.events.PubkeyChanged({fromBlock: 0}, function(error, event) {
        console.log(event);
    })
    .on('data', function(event){
        console.log(event);
    })
    .on('changed', function(event){
        // remove event from local database
    })
    .on('error', console.error);
});


关于合约事件处理的更多信息，请看这里 contract-events_。

getContent¶

web3.eth.ens.getContent(ENSName);

返回与 ENS 节点关联的内容哈希。

参数¶

ENSName - String: ENS 域名。

返回值¶

String - 与 ENS 节点关联的内容哈希。

例子¶

web3.eth.ens.getContent('ethereum.eth').then(function (result) {
    console.log(result);
});
> "0x0000000000000000000000000000000000000000000000000000000000000000"

setContent¶

web3.eth.ens.setContent(ENSName, hash, options);

设置与 ENS 节点关联的内容哈希。

参数¶

ENSName - String: ENS 域名。
hash - String: 要设置的内容哈希。
options - Object: 用于发送交易的参数选型。
- from - String: 交易发出地址。
- gasPrice - String (可选): 用于此交易的燃料价格（以 wei 为单位）。
- gas - Number (可选): 用于此交易的最大燃料数量（gasLimit）。

触发 ContentChanged 事件。

例子¶

web3.eth.ens.setContent(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then(function (result) {
    console.log(result.events);
});
> ContentChanged(...)

// 或者使用事件触发器

web3.eth.ens.setContent(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', function(hash){
    ...
})
.on('confirmation', function(confirmationNumber, receipt){
    ...
})
.on('receipt', function(receipt){
    ...
})
.on('error', console.error);

// 或者监听 resolver 上的 ContentChanged 事件

web3.eth.ens.resolver('ethereum.eth').then(function (resolver) {
    resolver.events.ContentChanged({fromBlock: 0}, function(error, event) {
        console.log(event);
    })
    .on('data', function(event){
        console.log(event);
    })
    .on('changed', function(event){
        // 从本地数据库中移除事件
    })
    .on('error', console.error);
});


关于合约事件处理的更多信息，请看这里 contract-events_。

getMultihash¶

web3.eth.ens.getMultihash(ENSName);

返回和 ENS 节点管理的 multihash。

参数¶

ENSName - String: ENS 域名。

返回值¶

String - 关联的 multihash。

例子¶

web3.eth.ens.getMultihash('ethereum.eth').then(function (result) {
    console.log(result);
});
> 'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK'

setMultihash¶

web3.eth.ens.setMultihash(ENSName, hash, options);

设置和 ENS 节点关联的 multihash。

参数¶

ENSName - String: ENS 域名。
hash - String: 要设置的 multihash。
options - Object: 用于发送交易的参数选型。
- from - String: 交易发出地址。
- gasPrice - String (可选): 用于此交易的燃料价格（以 wei 为单位）。
- gas - Number (可选): 用于此交易的最大燃料数量（gasLimit）。

触发 MultihashChanged 事件。

例子¶

web3.eth.ens.setMultihash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then(function (result) {
    console.log(result.events);
});
> MultihashChanged(...)

// 或者使用事件触发器

web3.eth.ens.setMultihash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', function(hash){
    ...
})
.on('confirmation', function(confirmationNumber, receipt){
    ...
})
.on('receipt', function(receipt){
    ...
})
.on('error', console.error);


关于合约事件处理的更多信息，请看这里 contract-events_。

ENS events¶

ENS 接口提供了监听所有 ENS 相关事件的可能性。

已知的 resolver 事件¶

AddrChanged(node bytes32, a address)

2. ContentChanged(node bytes32, hash bytes32) 4. NameChanged(node bytes32, name string) 5. ABIChanged(node bytes32, contentType uint256) 6. PubkeyChanged(node bytes32, x bytes32, y bytes32)

例子¶

web3.eth.ens.resolver('ethereum.eth').then(function (resolver) {
    resolver.events.AddrChanged({fromBlock: 0}, function(error, event) {
        console.log(event);
    })
    .on('data', function(event){
        console.log(event);
    })
    .on('changed', function(event){
        // 从本地数据库移除事件
    })
    .on('error', console.error);
});
> {
    returnValues: {
        node: '0x123456789...',
        a: '0x123456789...',
    },
    raw: {
        data: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
        topics: [
            '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
            '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385'
        ]
    },
    event: 'AddrChanged',
    signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    logIndex: 0,
    transactionIndex: 0,
    transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    blockHash: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    blockNumber: 1234,
    address: '0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe'
}

已知的 registry 事件¶

Transfer(node bytes32, owner address)

2. NewOwner(node bytes32, label bytes32, owner address) 4. NewResolver(node bytes32, resolver address) 5. NewTTL(node bytes32, ttl uint64)

例子¶

web3.eth.ens.resistry.then(function (registry) {
    registry.events.Transfer({fromBlock: 0}, , function(error, event) {
          console.log(event);
      })
      .on('data', function(event){
          console.log(event);
      })
      .on('changed', function(event){
          // 从本地数据库移除事件
      })
      .on('error', console.error);
});
> {
    returnValues: {
        node: '0x123456789...',
        owner: '0x123456789...',
    },
    raw: {
        data: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
        topics: [
            '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
            '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385'
        ]
    },
    event: 'Transfer',
    signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    logIndex: 0,
    transactionIndex: 0,
    transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    blockHash: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    blockNumber: 1234,
    address: '0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe'
}

关于合约事件处理的更多信息，请看这里 contract-events_。

web3.eth.ens¶

web3.eth.ens 相关函数让你可以与 ENS 进行交互。¶

registry¶

返回值¶

例子¶

resolver¶

返回值¶

例子¶

getAddress¶

参数¶

返回值¶

例子¶

setAddress¶

参数¶

例子¶

getPubkey¶

参数¶

返回值¶

例子¶

setPubkey¶

参数¶

例子¶

getContent¶

参数¶

返回值¶

例子¶

setContent¶

参数¶

例子¶

getMultihash¶

参数¶

返回值¶

例子¶

setMultihash¶

参数¶

例子¶

ENS events¶

已知的 resolver 事件¶

例子¶

已知的 registry 事件¶

例子¶

`web3.eth.ens` 相关函数让你可以与 ENS 进行交互。¶