Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ConsenSys/Tokens
Ethereum Token Contracts
https://github.com/ConsenSys/Tokens
Last synced: 15 days ago
JSON representation
Ethereum Token Contracts
- Host: GitHub
- URL: https://github.com/ConsenSys/Tokens
- Owner: Consensys
- License: mit
- Created: 2015-05-10T21:28:55.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-06-24T13:24:34.000Z (5 months ago)
- Last Synced: 2024-10-16T14:31:20.745Z (23 days ago)
- Language: JavaScript
- Homepage:
- Size: 1.2 MB
- Stars: 2,060
- Watchers: 146
- Forks: 1,194
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-smart-contracts - ConsenSys/Tokens - Solidity smart contract code to issue simple, standards-compliant tokens on Ethereum. It can be used to create any form of asset, currency, coin, hours, usage tokens, vunk, etc. (Libraries)
README
# DEPRECATED
We recommend using the thoroughly vetted OpenZeppelin token implementations.
# Tokens
[ ](https://app.codeship.com/projects/233433) [](https://coveralls.io/github/ConsenSys/Tokens?branch=coverage_test) [](https://opensource.org/licenses/MIT) [](https://david-dm.org/ConsenSys/Tokens) []() [](https://github.com/airbnb/javascript) [](https://github.com/ConsenSys/Tokens/issues)
This repo contains Solidity smart contract code for simple, standards-compliant tokens on Ethereum. Adhering to standards allows other contract developers to easily incorporate your token into their applications.
The repo currently implements [EIP20](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20-token-standard.md) tokens, and more may be added in the future.
## Guiding Principles
While other projects provide custom and feature-complete token implementations, the contracts found in this repository attempt to suit a slightly different purpose: to serve as the baseline reference implementations of token standards and to capture their essence. We strive to eschew bells and whistles and instead provide minimalist implementations that maximize learning and provide sturdy foundations. Contracts shall be thoroughly documented, detailing the implementation's rationale and evolution as it has been used across production-grade projects.
Here are the guiding principles for this repository:
1. *Simplicity:* Our contracts shall be simple, keeping functionality to a minimum of what is necessary to implement the token standard.
2. *Readability:* Solutions that make sense to humans should be prioritized over those heavily optimized or complex.
3. *Secure:* Modifications to the master branch will only be accepted after thorough review and scrutinization from the community, the project maintainers, and at least one professional vendor to ensure no security vulnerabilities are introduced.
## Initialize
The only environmental dependency you need is Node. Presently we can guarantee this all works with Node 8.
```
npm install
npm run compile
```
## Tests
The repo has a comprehensive test suite. You can run it with `npm run test`.
## ethpm
The contracts in this repo are published under `tokens` on EPM. EPM is the recommended means of consuming token contracts in this repo. Copy-pasting code is highly discouraged.
## Contributing
Pull requests are welcome! Please keep standards discussions to the EIP repos.
When submitting a pull request, please do so to the `staging` branch. For a pull request to be accepted, they must pass the test suite. If a pull request adds features, it should add test coverage for those features.