Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
build/contracts Adding last ropsten deployment. Nov 20, 2018
configuration Updating to a working v2 ZeroEx sub contract Oct 19, 2018
contracts Updating contracts to use the new zeppelin library Nov 13, 2018
ganache-docker adding a docker container for 0x ganache test rpc Oct 16, 2018
installed_contracts/0xV2-contracts/contracts Storing a local copy of 0x contracts for now. Oct 19, 2018
migrations Updating 0x.js and fixing breaking changes Nov 10, 2018
test Adding additional test for the new functions. Nov 13, 2018
.gitignore Refining links and statement on formatter Nov 21, 2018
docker-compose.yml adding a docker container for 0x ganache test rpc Oct 16, 2018
package-lock.json Updating package versions for a successful build Jan 18, 2019
package.json Updating package versions for a successful build Jan 18, 2019
ropsten.js Updating take syntax to react to a stream submission. Oct 23, 2018
truffle.js Adding optimizier config. Nov 13, 2018



The formatter expects a valid ZeroEx signed order and will create a makerValues object to be used as input to initialize a paradigm-connect Order.
The formatter is the default export of the package for javascript use.

import zeroExFormatter from 'paradigm-0x-contracts';

Deployed SubContract Address: 0x0afd97c4548d6a5db854d6b1b4b18138327f944c
Sample transaction passing though the OrderGateway

0xV2 Transaction Full Cycle Example (Ropsten)


To get started, you will need an ethereum address with ether on the ROPSTEN network. ROPSTEN ether can be obtained diretly though MetaMask.

  1. Point MetaMask to the Ropsten network.
  2. Click Deposit
  3. Click Get Ether under the Test Facet label.
  4. Request ether from the faucet.
Example Test Token Addresses:

After you get some test ether you may generate some balance on the following test tokens by sending ether to their address. These test tokens are specially designed to automatically return all ether immediately.

  • DIGM: 0xdbffce76e8ab7b64b8d4400778bf514b92facb66
  • RAIN: 0x842e71cdd25d4b279eb3058a2fb9960b0f10d910
  • SPARK: 0xb2be0b836e7705f6dd8b8f3fc14502072c44c18c
  • FIRE: 0xb71479cc1ff8ed31e9d18bdb7f004964a56fdb89
  • GLOW: 0xbbbb6cca5029690fc56c2af4f5c18c78885a7174
  • HORSE: 0x7022f9e5b700325327dbdefb66fa51865032c093
  • TRUCK: 0xdfbb1f7d9a93bd47857c8362c9497b54aca529e2
  • GOLF: 0x452669b5e77a83779ccd869d7426f06174fffe98
  • BASE: 0x18218faa00502f4ead664f1b77fa905265a3f1f9

Javascript Requirements

The required Javascript is hosted online here, but you may replicate by modifying the following:

import Web3 from 'web3';

import { Dharma, BigNumber } from '@dharmaprotocol/dharma.js';
import {
} from '0x.js';
import { MetamaskSubprovider } from '@0x/subproviders';
import Paradigm from 'paradigm-connect';
import dharmaFormatter from 'paradigm-dharma-contracts';
import zeroExFormatter from 'paradigm-0x-contracts';

global.generatePseudoRandomSalt = generatePseudoRandomSalt;
global.assetDataUtils = assetDataUtils;
global.ContractWrappers = ContractWrappers;
global.signatureUtils = signatureUtils;
global.orderHashUtils = orderHashUtils;
global.Dharma = Dharma;
global.BigNumber = BigNumber;
global.Paradigm = Paradigm;
global.dharmaFormatter = dharmaFormatter;
global.zeroExFormatter = zeroExFormatter;
global.MetamaskSubprovider = MetamaskSubprovider;

(async () => {
  global.web3 = new Web3(web3.currentProvider);

Order Creation

First prepare the Javascript console with the following code:

const paradigm = new Paradigm({ provider: web3.currentProvider });
const makerAddress = await web3.eth.getCoinbase();
const subContract = "0x0afd97c4548d6a5db854d6b1b4b18138327f944c";
const subProvider = new MetamaskSubprovider(web3.currentProvider);
const zeroExContracts = new ContractWrappers(subProvider, { 
    networkId: await 

Select tokens to be used for the transaction. This example is using TKA and TKB from the list above:

const token1 = "0x842e71cdd25d4b279eb3058a2fb9960b0f10d910";
const token2 = "0xb71479cc1ff8ed31e9d18bdb7f004964a56fdb89";

Next provide the 0x proxy with an allowance to transfer The desired token on your behalf (This gives an unlimited approval so it only needs to be done onces per user address per token):

  await zeroExContracts.erc20Token.setUnlimitedProxyAllowanceAsync(token1, makerAddress);

Now create and sign an order with the 0x library:

const zeroExOrder = {
  takerAddress: paradigm.utils.NULL_ADDRESS,  //Customize these freely
  feeRecipientAddress: paradigm.utils.NULL_ADDRESS,  //Customize these freely
  senderAddress: paradigm.utils.NULL_ADDRESS,  //Customize these freely
  makerAssetAmount: new BigNumber(100),  //Customize these freely
  takerAssetAmount: new BigNumber(100),  //Customize these freely
  makerFee: new BigNumber(0),  //Customize these freely
  takerFee: new BigNumber(0),  //Customize these freely
  expirationTimeSeconds: new BigNumber(
    ( //Feel free to customize using the Date api but don't forget to convert to seconds! Ex: Date.parse('Jan 1 1019')/1000
  salt: generatePseudoRandomSalt(),
  makerAssetData: assetDataUtils.encodeERC20AssetData(token1),
  takerAssetData: assetDataUtils.encodeERC20AssetData(token2),
  exchangeAddress: EXCHANGE_ADDRESS

const signedZeroExOrder = {
  signature: await signatureUtils.ecSignHashAsync(
  subProvider, orderHashUtils.getOrderHashHex(zeroExOrder), makerAddress, 'DEFAULT')

Last we will create a Paradigm order and submit the order to the OrderStream:

const makerValues = zeroExFormatter(signedZeroExOrder);
const order = new paradigm.Order({ maker: makerAddress, subContract, makerValues });
await order.prepareForPost();

await paradigm.orderStream.add(order);

Taking the Order

The following will setup the Javascript console to reactively take any orders that are received through the socket connection. The following code will need to be in place prior to an order being sent:

const taker = await web3.eth.getCoinbase();
const zeroExContracts = new ContractWrappers(subProvider, { 
  networkId: await 
const tokenToOffer = "0xb71479cc1ff8ed31e9d18bdb7f004964a56fdb89";
const tokenAssetData = assetDataUtils.encodeERC20AssetData(tokenToOffer)

paradigm.orderStream.listen(async (message) => {
  console.log('Message received.');
  const json = JSON.parse(;
  if(json.event === "order") {
    const order = new paradigm.Order(;
    if(order.subContract === '0x0afd97c4548d6a5db854d6b1b4b18138327f944c' &&
     order.makerValues.takerAssetData === tokenAssetData) {
    console.log('Message contained order:', order.toJSON());

    await zeroExContracts.erc20Token.setUnlimitedAllowanceAsync(tokenToOffer, taker, order.subContract);

    const resp =  await order.take(taker, { taker, takerAssetAmount: new BigNumber(100) });
    } else {
      console.log('Message contained order with wrong SubContract');
  } else {
    console.log('Message is not an order.')
You can’t perform that action at this time.