# Registry

[Source](https://github.com/pulsedomains/pns-contracts/blob/master/contracts/registry/ENSRegistry.sol)

The PNS registry is the core contract that lies at the heart of PNS resolution. All PNS lookups start by querying the registry. The registry maintains a list of domains, recording the owner, resolver, and TTL for each, and allows the owner of a domain to make changes to that data.

The PNS registry is specified in [EIP 137](https://eips.ethereum.org/EIPS/eip-137).

## Deployed Registry addresses

* Mainnet: `0xbd5133993FCDED5945c5539D9f032261F0d13170`.
* Testnet (v4):  `0x20256721c9543eC129C1202c047eB7b194d4703E`.

## Get Owner

```
function owner(bytes32 node) external view returns (address);
```

Returns the owner of the name specified by `node`.

## Get Resolver

```
function resolver(bytes32 node) external view returns (address);
```

Returns the address of the resolver responsible for the name specified by `node`.

## Get TTL

```
function ttl(bytes32 node) external view returns (uint64);
```

Returns the caching time-to-live of the name specified by `node`. Systems that wish to cache information about a name, including ownership, resolver address, and records, should respect this value. If TTL is zero, new data should be fetched on each query.

## Set Owner

```
function setOwner(bytes32 node, address owner) external;
```

Reassigns ownership of the name identified by `node` to `owner`. Only callable by the current owner of the name.

Emits the following event:

```
event Transfer(bytes32 indexed node, address owner);
```

## Set Resolver

```
function setResolver(bytes32 node, address resolver) external;
```

Updates the resolver associated with the name identified by `node` to `resolver`. Only callable by the current owner of the name. `resolver` must specify the address of a contract that implements the Resolver interface.

Emits the following event:

```
event NewResolver(bytes32 indexed node, address resolver);
```

## Set TTL

```
function setTTL(bytes32 node, uint64 ttl) external;
```

Updates the caching time-to-live of the name identified by `node`. Only callable by the current owner of the name.

Emits the following event:

```
event NewTTL(bytes32 indexed node, uint64 ttl);
```

## Set Subdomain Owner

```
function setSubnodeOwner(bytes32 node, bytes32 label, address owner) external;
```

Creates a new subdomain of `node`, assigning ownership of it to the specified `owner`. If the domain already exists, ownership is reassigned but the resolver and TTL are left unmodified.

`label` is the keccak256 hash of the subdomain label to create. For example, if you own *alice.pls* and want to create the subdomain *iam.alice.eth*, supply `namehash('alice.pls')` as the `node`, and `keccak256('iam')` as the `label`.

Emits the following event:

```
event NewOwner(bytes32 indexed node, bytes32 indexed label, address owner);
```

### Set Record

```
function setRecord(bytes32 node, address owner, address resolver, uint64 ttl);
```

Sets the owner, resolver, and TTL for an PNS record in a single operation. This function is offered for convenience, and is exactly equivalent to calling `setResolver`, `setTTL` and `setOwner` in that order.

### Set Subdomain Record

```
function setSubnodeRecord(bytes32 node, bytes32 label, address owner, address resolver, uint64 ttl);
```

Sets the owner, resolver and TTL for a subdomain, creating it if necessary. This function is offered for convenience, and permits setting all three fields without first transferring ownership of the subdomain to the caller.

### Set Approval

```
function setApprovalForAll(address operator, bool approved);
```

Sets or clears an approval. Approved accounts can execute all PNS registry operations on behalf of the caller.

### Check Approval

```
function isApprovedForAll(address owner, address operator) external view returns (bool);
```

Returns true if `operator` is approved to make PNS registry operations on behalf of `owner`.

### Check Record Existence

```
function recordExists(bytes32 node) public view returns (bool);
```

Returns true if `node` exists in this PNS registry. This will return false for records that are in the legacy PNS registry but have not yet been migrated to the new one.