Skip to content
This repository has been archived by the owner. It is now read-only.
Xcert token implementation for the Ethereum blockchain.
Branch: master
Clone or download
xpepermint Merge pull request #44 from MoMannn/master
Update erc721 dependency and fix break because of removed ownable fro…
Latest commit fbae69c Aug 8, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets Add diagram Jun 22, 2018
contracts Update erc721 dependency and fix break because of removed ownable fro… Aug 8, 2018
migrations Refactor migration code style May 29, 2018
.editorconfig Text editor configuration May 9, 2018
.eslintrc.js Adding eslint, package.json update May 18, 2018
.gitignore Add truffle code flattner May 31, 2018
.npmignore Expose as truffle npm module Jun 2, 2018
.travis.yml Travis configuration May 9, 2018 Add contributing page. May 29, 2018
LICENSE Add license May 28, 2018 Add diagram Jun 22, 2018
package-lock.json Update erc721 dependency and fix break because of removed ownable fro… Aug 8, 2018
package.json Update erc721 dependency and fix break because of removed ownable fro… Aug 8, 2018
truffle.js Project initialized May 9, 2018

Build Status NPM Version Dependencies Status Bug Bounty

Xcert token implementation for the Ethereum blockchain.

This is the official implementation of the Xcert token for the Ethereum blockchain. This is an open source project build with Truffle framework.

Purpose of this implemetation is to provide a good starting point for anyone who wants to use and develop the low-level layer of the 0xcert protocol on the Ethereum blockchain. Instead of re-implementing the 0xcert specs yourself you can use this code which has gone through multiple audits and we hope it will be extensively used by the community in the future.

An Xcert is an extension of the ERC-721 implementation. It is an opinionated non-fungible token which carries a proof of a digital asset and supports additional 0xcert protocol features. You can read more about this in the official 0xcert protocol yellow paper.


Since this is a Truffle project, you will find all tokens in contracts/tokens/ directory. There are multiple implementations and you can select between:

  • Xcert.sol: This is the base Xcert token implementation.
  • BurnableXcert.sol: This implements optional support for token burning. It is useful if you want token owners to be able to burn them.
  • MutableXcert.sol: This implements enables token data to be changed by authorized address.
  • PausableXcert.sol: This implements optional freeze for token transfers. It is useful if you want to be able to pause all token transfers at any time.
  • RevokableXcert.sol: This implements optional revoking mechanism. It is useful if you want to allow owner of the Xcert contract to revoke any token at any time.



  • NodeJS 9.0+ recommended.
  • Windows, Linux or Mac OS X.


This is an NPM module for Truffle framework. In order to use it as a dependency in your Javascript project, you must first install it through the npm command:

$ npm install @0xcert/ethereum-xcert


Clone the repository and install the required npm dependencies:

$ git clone
$ cd ethereum-xcert
$ npm install

Make sure that everything has been set up correctly:

$ npm run test

All tests should pass.



To interact with package's contracts within JavaScript code, you simply need to require that package's .json files:

const contract = require("@0xcert/ethereum-xcert/build/contracts/Xcert.json");


The easiest way to start is to create a new file under contracts/tokens/ (e.g. MyXcertToken.sol):

pragma solidity ^0.4.23;

import "../tokens/BurnableXcert.sol";

contract MyXcertToken is BurnableXcert {

    string _name,
    string _symbol,
    bytes4 _conventionId
    nftName = _name;
    nftSymbol = _symbol;
    nftConventionId = _conventionId;


That's it. Let's compile the contract:

$ npm run compile

The easiest way to deploy it locally and start interacting with the contract (minting and transferring tokens) is to deploy it on your personal (local) blockchain using Ganache. Follow the steps in the Truffle documentation which are described here.


See for how to help out.


See LICENSE for details.

You can’t perform that action at this time.