# @chainlink/token

> The LINK token is an [EIP20](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20-token-standard.md) token with additional [ERC677](https://github.com/ethereum/EIPs/issues/677) functionality.

Latest version **1.1.0** (published 2021-03-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @chainlink/token
pnpm add @chainlink/token
yarn add @chainlink/token
bun add @chainlink/token
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2021-03-24 |
| First published | 2021-03-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 39.9 KB |
| Known vulnerabilities | 0 (+4 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 134 |
| Maintainers | chainlink-steve, thodges, se3000, henrynguyen5, rupurt, chainlink-external-adapter, chainlink-explorer |

## Links

- npm: https://www.npmjs.com/package/@chainlink/token
- Repository: https://github.com/smartcontractkit/LinkToken
- Issues: https://github.com/smartcontractkit/LinkToken/issues
- npm.io page: https://npm.io/package/@chainlink/token

## Dependencies (3)

- [ethers](https://npm.io/package/ethers.md) ^4.0.44
- [@truffle/contract](https://npm.io/package/@truffle/contract.md) ^4.1.8
- [@openzeppelin/contracts](https://npm.io/package/@openzeppelin/contracts.md) ^3.4.0

## Recent versions

- 1.1.0 (latest) — 2021-03-24

## README

# LINK Token Contracts [![Build Status](https://travis-ci.org/smartcontractkit/LinkToken.svg?branch=master)](https://travis-ci.org/smartcontractkit/LinkToken)

The LINK token is an [EIP20](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20-token-standard.md) token with additional [ERC677](https://github.com/ethereum/EIPs/issues/677) functionality.

The total supply of the token is 1,000,000,000, and each token is divisible up to 18 decimal places.

To prevent accidental burns, the token does not allow transfers to the contract itself and to 0x0.

Security audit for [v0.4 version of the contracts](./contracts/v0.4/) is available [here](https://gist.github.com/Arachnid/4aa88041bd6e34835b8c0fd051245e79).

## Details

- Deployments:
  - Ethereum Mainnet [LinkToken v0.4](./flat/v0.4/LinkToken.sol): [0x514910771AF9Ca656af840dff83E8264EcF986CA](https://etherscan.io/address/0x514910771af9ca656af840dff83e8264ecf986ca)
- Decimals: 18
- Name: ChainLink Token
- Symbol: LINK

## Installation

The project contains [v0.4 contracts](./contracts/v0.4/) that were used for LINK Ethereum Mainnet deployment in 2017. For deployments moving forward, we use the updated [v0.6 contracts](./contracts/v0.6/) which use a more recent version of solc and the OpenZeppelin token standards. These updates include a minor ABI change around approval/allowance naming.

```bash
yarn install
```

## Testing

Before running tests, open a new terminal and start Ganache on port `8454`:

```bash
ganache-cli -l 8000000
```

Compile the contracts:

```bash
yarn compile
```

Run tests:

```bash
yarn test
```

This will instruct the tests to run against your locally deployed instance of Ganache.

Or you can test specific version separately:

```bash
yarn test:v0.4
```

## Migration

To migrate v0.4 contracts run:

```bash
yarn migrate:v0.4
```

To migrate v0.6 contracts run:

```bash
yarn migrate:v0.6
```

This will migrate the `LinkToken` contract to your locally deployed instance of Ganache blockchain.

---
_Source: https://npm.io/package/@chainlink/token · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._