> For the complete documentation index, see [llms.txt](https://elacity.gitbook.io/elacity-sdks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://elacity.gitbook.io/elacity-sdks/protocol/v3.0/references/storage/iiptracker.md).

# IIPTracker

[Git Source](https://github.com/Elacity/v3-drm-protocol/blob/52ca0e7824ef5fab5ebe0a131f7c6e6dd330de09/contracts/storage/IIPTracker.sol)

**Title:** IIPTracker

Interface for tracking intellectual properties.

Tracks which operative contract controls a given `(channel, tokenId)` pair.

## Functions

### bindIP

Binds a content id to a `(channel, tokenId)` pair.

```solidity
function bindIP(bytes16 _contentId, address channel, uint256 tokenId) external;
```

**Parameters**

| Name         | Type      | Description                  |
| ------------ | --------- | ---------------------------- |
| `_contentId` | `bytes16` | Content id to bind.          |
| `channel`    | `address` | Channel contract address.    |
| `tokenId`    | `uint256` | Token id inside the channel. |

### ipReference

Returns the token reference mapped to a content id.

```solidity
function ipReference(bytes16 _contentId) external view returns (address channel, uint256 tokenId);
```

**Parameters**

| Name         | Type      | Description            |
| ------------ | --------- | ---------------------- |
| `_contentId` | `bytes16` | Content id to resolve. |

**Returns**

| Name      | Type      | Description                  |
| --------- | --------- | ---------------------------- |
| `channel` | `address` | Channel contract address.    |
| `tokenId` | `uint256` | Token id inside the channel. |

### operator

Returns the operative address controlling an asset.

```solidity
function operator(address channel, uint256 tokenId) external view returns (address);
```

**Parameters**

| Name      | Type      | Description                      |
| --------- | --------- | -------------------------------- |
| `channel` | `address` | Channel/ledger contract address. |
| `tokenId` | `uint256` | Asset token id.                  |

**Returns**

| Name     | Type      | Description                 |
| -------- | --------- | --------------------------- |
| `<none>` | `address` | Operative contract address. |

### registerDigitalAsset

Registers a digital asset to an operative contract.

**Note:** docs-ignore: true

```solidity
function registerDigitalAsset(address channel, uint256 tokenId, address operator) external;
```

**Parameters**

| Name       | Type      | Description                      |
| ---------- | --------- | -------------------------------- |
| `channel`  | `address` | Channel/ledger contract address. |
| `tokenId`  | `uint256` | Asset token id.                  |
| `operator` | `address` | Operative contract address.      |

## Events

### IPBound

Emitted when a content id is mapped to a token reference.

```solidity
event IPBound(bytes16 indexed contentId, address indexed channel, uint256 indexed tokenId);
```

**Parameters**

| Name        | Type      | Description                  |
| ----------- | --------- | ---------------------------- |
| `contentId` | `bytes16` | Bound content id.            |
| `channel`   | `address` | Channel contract address.    |
| `tokenId`   | `uint256` | Token id inside the channel. |

## Errors

### IPAlreadyBound

Thrown when attempting to bind an already-mapped content id.

```solidity
error IPAlreadyBound(bytes16 contentId);
```

**Parameters**

| Name        | Type      | Description                            |
| ----------- | --------- | -------------------------------------- |
| `contentId` | `bytes16` | Content id that already has a mapping. |

### DigitalAssetAlreadyRegistered

Thrown when attempting to register an already-registered `(channel, tokenId)` operative binding.

```solidity
error DigitalAssetAlreadyRegistered(address channel, uint256 tokenId, address operator);
```

**Parameters**

| Name       | Type      | Description                                                    |
| ---------- | --------- | -------------------------------------------------------------- |
| `channel`  | `address` | Channel/ledger contract address.                               |
| `tokenId`  | `uint256` | Asset token id.                                                |
| `operator` | `address` | Existing operative contract already registered for this asset. |

## Structs

### IpTrack

Canonical identifier for a tracked digital asset.

```solidity
struct IpTrack {
    address channel;
    uint256 tokenId;
}
```

**Properties**

| Name      | Type      | Description                  |
| --------- | --------- | ---------------------------- |
| `channel` | `address` | Channel contract address.    |
| `tokenId` | `uint256` | Token id inside the channel. |
