Try Gazelle in Local

Following this document, you will be able to build secure and scalable Dapps using Plasma. For this quick start document using Typescript SDK, you need Node.js with the version higher than v.10.x.


  • Python (for node-gyp)
  • Node v10.x
  • Docker

Setup aggregator

1. Run test aggregator

Get Plasma aggregator from gazelle repository.

$ git clone -b v0.4.1
$ cd gazelle
$ npm run docker:build
$ npm run docker:cp
$ npm run docker:start

Contracts config file config.local.json is generated at the root directory after npm run docker:build if you have not installed them yet.

Create your application

1. Install

Install the following libraries using npm to enable fund transfers in Plasma.

  • @cryptoeconomicslab/eth-plasma-light-client
    • A client for communication between Plasma and Application.
  • @cryptoeconomicslab/primitives
    • A primitive type to be handled on OVM.
  • @cryptoeconomicslab/level-kvs
    • A database used by the Client.
$ npm i ethers
$ npm i @cryptoeconomicslab/eth-plasma-light-client@0.4.1 @cryptoeconomicslab/primitives @cryptoeconomicslab/level-kvs

Copy config.local.json file to your application repository root.

$ cp -p <your gazelle path>/integration-test/aggregator/src/config.local.json ./config.local.json

2. Instantiate

You can instantiate light client object using Wallet class of ethers.js.

const ethers = require("ethers")
const { Bytes } = require("@cryptoeconomicslab/primitives")
const { LevelKeyValueStore } = require("@cryptoeconomicslab/level-kvs")
const initializeLightClient = require("@cryptoeconomicslab/eth-plasma-light-client")
const config = require("./config.local.json")
async function main() {
const kvs = new LevelKeyValueStore(Bytes.fromString("plasma_light_client"))
const wallet = new ethers.Wallet(
"your private key here",
new ethers.providers.JsonRpcProvider("")
const lightClient = await initializeLightClient({
aggregatorEndpoint: "http://localhost:3000"
await lightClient.start()

Do you want to run client on browser? You can choose IndexedDb for client database.

const { IndexedDbKeyValueStore } = require("@cryptoeconomicslab/indexeddb-kvs")

3. Get balance

You can get balance on Plasma.

const balance = await lightClient.getBalance()
console.log("balance", balance)

4. Deposit to Plasma

Let's say you want to deposit L1 token to Plasma. Plasma requires a contract to deposit L1 tokens to Plasma. You can get default Deposit Contract for ETH.

const config = require("./config.local.json")
// Get default Deposit Contract address

Deposit 10 wei to Plasma.

await lightClient.deposit(10, TOKEN_CONTRACT_ADDRESS)

5. Transfer

You can make your first Plasma transaction!

await lightClient.transfer(10, TOKEN_CONTRACT_ADDRESS, to)

6. Withdraw assets from Plasma

Start withdraw your asset from Plasma.

await lightClient.startWithdrawal(10, TOKEN_CONTRACT_ADDRESS)
const exitList = await lightClient.getPendingWithdrawals()
console.log("new exits", exitList)

After dispute period, you can withdraw your asset to Ethereum.

const exitList = await lightClient.getPendingWithdrawals()
if (exitList[0]) {
await lightClient.completeWithdrawal(exitList[0])