@graphprotocol/graph-cli 0.29.0 → 0.30.0-alpha.1

package/src/migrations/mapping_api_version_0_0_5.js

@@ -21,7 +21,7 @@ module.exports = {
 
     let manifest = loadManifest(manifestFile)
     return (
-      // Only migrate if the graph-ts version is >= 0.23.0...
+      // Only migrate if the graph-ts version is >= 0.24.0...
       // Coerce needed because we may be dealing with an alpha version
       // and in the `semver` library this would not return true on equality.
       semver.gte(semver.coerce(graphTsVersion), '0.24.0') &&

package/src/migrations/mapping_api_version_0_0_6.js

@@ -0,0 +1,74 @@
+const fs = require('fs-extra')
+const semver = require('semver')
+const toolbox = require('gluegun/toolbox')
+const yaml = require('js-yaml')
+const { loadManifest } = require('./util/load-manifest')
+const { getGraphTsVersion } = require('./util/versions')
+
+// If any of the manifest apiVersions are 0.0.6, replace them with 0.0.7
+module.exports = {
+  name: 'Bump mapping apiVersion from 0.0.6 to 0.0.7',
+  predicate: async ({ sourceDir, manifestFile }) => {
+    // Obtain the graph-ts version, if possible
+    let graphTsVersion
+    try {
+      graphTsVersion = await getGraphTsVersion(sourceDir)
+    } catch (_) {
+      // If we cannot obtain the version, return a hint that the graph-ts
+      // hasn't been installed yet
+      return 'graph-ts dependency not installed yet'
+    }
+
+    let manifest = loadManifest(manifestFile)
+    return (
+      // Only migrate if the graph-ts version is >= 0.27.0...
+      // Coerce needed because we may be dealing with an alpha version
+      // and in the `semver` library this would not return true on equality.
+      semver.gte(semver.coerce(graphTsVersion), '0.27.0') &&
+      // ...and we have a manifest with mapping > apiVersion = 0.0.6
+      manifest &&
+      typeof manifest === 'object' &&
+      Array.isArray(manifest.dataSources) &&
+      (manifest.dataSources.reduce(
+        (hasOldMappings, dataSource) =>
+          hasOldMappings ||
+          (typeof dataSource === 'object' &&
+            dataSource.mapping &&
+            typeof dataSource.mapping === 'object' &&
+            dataSource.mapping.apiVersion === '0.0.6'),
+        false,
+      ) ||
+        (Array.isArray(manifest.templates) &&
+          manifest.templates.reduce(
+            (hasOldMappings, template) =>
+              hasOldMappings ||
+              (typeof template === 'object' &&
+                template.mapping &&
+                typeof template.mapping === 'object' &&
+                template.mapping.apiVersion === '0.0.6'),
+            false,
+          )))
+    )
+  },
+  apply: async ({ manifestFile }) => {
+    // Make sure we catch all variants; we could load the manifest
+    // and replace the values in the data structures here; unfortunately
+    // writing that back to the file messes with the formatting more than
+    // we'd like; that's why for now, we use a simple patching approach
+    await toolbox.patching.replace(
+      manifestFile,
+      new RegExp('apiVersion: 0.0.6', 'g'),
+      'apiVersion: 0.0.7',
+    )
+    await toolbox.patching.replace(
+      manifestFile,
+      new RegExp("apiVersion: '0.0.6'", 'g'),
+      "apiVersion: '0.0.7'",
+    )
+    await toolbox.patching.replace(
+      manifestFile,
+      new RegExp('apiVersion: "0.0.6"', 'g'),
+      'apiVersion: "0.0.7"',
+    )
+  },
+}

package/src/migrations/spec_version_0_0_2.js

@@ -6,7 +6,7 @@ const { loadManifest } = require('./util/load-manifest')
 // Spec version to 0.0.2 uses top level templates. graph-cli no longer supports
 // 0.0.1 which used nested templates.
 module.exports = {
-  name: 'Bump mapping specVersion from 0.0.1 to 0.0.2',
+  name: 'Bump manifest specVersion from 0.0.1 to 0.0.2',
   predicate: async ({ sourceDir, manifestFile }) => {
     let manifest = await loadManifest(manifestFile)
     return (

package/src/migrations/spec_version_0_0_3.js

@@ -0,0 +1,29 @@
+const fs = require('fs-extra')
+const toolbox = require('gluegun/toolbox')
+const yaml = require('js-yaml')
+const { loadManifest } = require('./util/load-manifest')
+
+// Spec version 0.0.4 uses feature management, but features are
+// detected and validated by the graph-node instance during subgraph
+// deployment.
+//
+// Also, we skip spec version 0.0.3, which is considered invalid and
+// non-canonical.
+module.exports = {
+  name: 'Bump manifest specVersion from 0.0.2 to 0.0.4',
+  predicate: async ({ sourceDir, manifestFile }) => {
+    let manifest = await loadManifest(manifestFile)
+    return (
+      manifest &&
+      typeof manifest === 'object' &&
+      manifest.specVersion &&
+      (manifest.specVersion === '0.0.2' || manifest.specVersion === '0.0.3')
+    )
+  },
+  apply: async ({ manifestFile }) => {
+    await toolbox.patching.patch(manifestFile, {
+      insert: 'specVersion: 0.0.4',
+      replace: new RegExp(`specVersion: ['"]?0.0.[23]['"]?`),
+    })
+  },
+}

package/src/migrations/spec_version_0_0_4.js

@@ -0,0 +1,25 @@
+const fs = require('fs-extra')
+const toolbox = require('gluegun/toolbox')
+const yaml = require('js-yaml')
+const { loadManifest } = require('./util/load-manifest')
+
+// Spec version 0.0.5 let event handlers require transaction receipt
+// data to be accessed in the runtime.
+module.exports = {
+  name: 'Bump manifest specVersion from 0.0.4 to 0.0.5',
+  predicate: async ({ sourceDir, manifestFile }) => {
+    let manifest = await loadManifest(manifestFile)
+    return (
+      manifest &&
+      typeof manifest === 'object' &&
+      manifest.specVersion &&
+      manifest.specVersion === '0.0.4'
+    )
+  },
+  apply: async ({ manifestFile }) => {
+    await toolbox.patching.patch(manifestFile, {
+      insert: 'specVersion: 0.0.5',
+      replace: new RegExp(`specVersion: ['"]?0.0.4['"]?`),
+    })
+  },
+}

package/src/migrations.js

@@ -5,7 +5,11 @@ const MIGRATIONS = [
   require('./migrations/mapping_api_version_0_0_2'),
   require('./migrations/mapping_api_version_0_0_3'),
   require('./migrations/mapping_api_version_0_0_4'),
+  require('./migrations/mapping_api_version_0_0_5'),
+  require('./migrations/mapping_api_version_0_0_6'),
   require('./migrations/spec_version_0_0_2'),
+  require('./migrations/spec_version_0_0_3'),
+  require('./migrations/spec_version_0_0_4'),
 ]
 
 const applyMigrations = async options =>

package/src/protocols/ethereum/manifest.graphql

@@ -7,6 +7,7 @@
 scalar String
 scalar File
 scalar BigInt
+scalar Boolean
 
 type SubgraphManifest {
   specVersion: String!
@@ -72,6 +73,7 @@ type ContractEventHandler {
   event: String!
   topic0: String
   handler: String!
+  receipt: Boolean
 }
 
 type Graft {

package/src/protocols/index.js

@@ -19,7 +19,7 @@ module.exports = class Protocol {
   }
 
   constructor(name) {
-    this.name = this.normalizeName(name)
+    this.name = Protocol.normalizeName(name)
   }
 
   static availableProtocols() {
@@ -67,7 +67,7 @@ module.exports = class Protocol {
     })
   }
 
-  normalizeName(name) {
+  static normalizeName(name) {
     return Protocol.availableProtocols().findKey(possibleNames =>
       possibleNames.includes(name),
     )

package/src/scaffold/index.js

@@ -50,7 +50,7 @@ module.exports = class Scaffold {
         },
         dependencies: {
           '@graphprotocol/graph-cli': GRAPH_CLI_VERSION,
-          '@graphprotocol/graph-ts': `0.26.0`,
+          '@graphprotocol/graph-ts': `0.27.0-alpha.1`,
         },
       }),
       { parser: 'json' },

package/src/validation/manifest.js

@@ -2,6 +2,8 @@ const immutable = require('immutable')
 const yaml = require('js-yaml')
 const path = require('path')
 
+const Protocol = require('../protocols')
+
 const List = immutable.List
 const Map = immutable.Map
 
@@ -204,6 +206,18 @@ const validators = immutable.fromJS({
             message: `Expected filename, found ${typeName(value)}:\n${value}`,
           },
         ]),
+
+  Boolean: (value, ctx) =>
+    typeof value === 'boolean'
+      ? List()
+      : immutable.fromJS([
+          {
+            path: ctx.get('path'),
+            message: `Expected true or false, found ${typeName(value)}:\n${toYAML(
+              value,
+            )}`,
+          },
+        ]),
 })
 
 const validateValue = (value, ctx) => {
@@ -229,23 +243,61 @@ const validateValue = (value, ctx) => {
   }
 }
 
-const validateDataSourceForNetwork = (dataSources, protocol) =>
+// Transforms list of data sources like this:
+// [
+//   { name: 'contract0', kind: 'ethereum/contract', network: 'mainnet' },
+//   { name: 'contract1', kind: 'ethereum', network: 'mainnet' },
+//   { name: 'contract2', kind: 'ethereum/contract', network: 'xdai' },
+//   { name: 'contract3', kind: 'near', network: 'near-mainnet' },
+// ]
+//
+// Into Immutable JS structure like this (protocol kind is normalized):
+// {
+//   ethereum: {
+//     mainnet: ['contract0', 'contract1'],
+//     xdai: ['contract2'],
+//   },
+//   near: {
+//     'near-mainnet': ['contract3'],
+//   },
+// }
+const dataSourceListToMap = dataSources =>
   dataSources
-    .filter(dataSource => protocol.isValidKindName(dataSource.kind))
     .reduce(
-      (networks, dataSource) =>
-        networks.update(dataSource.network, dataSources =>
-          (dataSources || immutable.OrderedSet()).add(dataSource.name),
+      (protocolKinds, dataSource) =>
+        protocolKinds.update(Protocol.normalizeName(dataSource.kind), networks =>
+          (networks || immutable.OrderedMap()).update(dataSource.network, dataSourceNames =>
+            (dataSourceNames || immutable.OrderedSet()).add(dataSource.name)),
         ),
       immutable.OrderedMap(),
     )
 
-const validateDataSourceNetworks = (value, protocol) => {
+const validateDataSourceProtocolAndNetworks = value => {
   const dataSources = [...value.dataSources, ...(value.templates || [])]
 
-  // Networks found valid for a protocol.
-  // By searching through all data sources and templates.
-  const networks = validateDataSourceForNetwork(dataSources, protocol)
+  const protocolNetworkMap = dataSourceListToMap(dataSources)
+
+  if (protocolNetworkMap.size > 1) {
+    return immutable.fromJS([
+      {
+        path: [],
+        message: `Conflicting protocol kinds used in data sources and templates:
+${protocolNetworkMap
+  .map(
+    (dataSourceNames, protocolKind) =>
+      `  ${
+        protocolKind === undefined
+          ? 'Data sources and templates having no protocol kind set'
+          : `Data sources and templates using '${protocolKind}'`
+      }:\n${dataSourceNames.valueSeq().flatten().map(ds => `    - ${ds}`).join('\n')}`,
+  )
+  .join('\n')}
+Recommendation: Make all data sources and templates use the same protocol kind.`,
+      },
+    ])
+  }
+
+  const networks = protocolNetworkMap.first()
 
   if (networks.size > 1) {
     return immutable.fromJS([
@@ -298,9 +350,9 @@ const validateManifest = (value, type, schema, protocol, { resolveFile }) => {
     return errors
   }
 
-  // Validate that all data sources are for the same `network` (this includes
-  // _no_ network at all)
-  return validateDataSourceNetworks(value, protocol)
+  // Validate that all data sources are for the same `network` and `protocol` (kind)
+  // (this includes _no_ network/protocol at all)
+  return validateDataSourceProtocolAndNetworks(value)
 }
 
 module.exports = {

package/tests/cli/init/ethereum/from-example/.gitattributes

@@ -0,0 +1 @@
+*.sol linguist-language=Solidity

package/tests/cli/init/ethereum/from-example/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 The Graph
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/tests/cli/init/ethereum/from-example/README.md

@@ -0,0 +1,3 @@
+# Example Subgraph
+
+An example to help you get started with The Graph. For more information see the docs on https://thegraph.com/docs/.

package/tests/cli/init/ethereum/from-example/abis/Gravity.json

@@ -0,0 +1 @@
+[{"constant":false,"inputs":[{"name":"_imageUrl","type":"string"}],"name":"updateGravatarImage","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[],"name":"setMythicalGravatar","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[{"name":"owner","type":"address"}],"name":"getGravatar","outputs":[{"name":"","type":"string"},{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"gravatarToOwner","outputs":[{"name":"","type":"address"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"ownerToGravatar","outputs":[{"name":"","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[{"name":"_displayName","type":"string"}],"name":"updateGravatarName","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_displayName","type":"string"},{"name":"_imageUrl","type":"string"}],"name":"createGravatar","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"gravatars","outputs":[{"name":"owner","type":"address"},{"name":"displayName","type":"string"},{"name":"imageUrl","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"anonymous":false,"inputs":[{"indexed":false,"name":"id","type":"uint256"},{"indexed":false,"name":"owner","type":"address"},{"indexed":false,"name":"displayName","type":"string"},{"indexed":false,"name":"imageUrl","type":"string"}],"name":"NewGravatar","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"id","type":"uint256"},{"indexed":false,"name":"owner","type":"address"},{"indexed":false,"name":"displayName","type":"string"},{"indexed":false,"name":"imageUrl","type":"string"}],"name":"UpdatedGravatar","type":"event"}]

package/tests/cli/init/ethereum/from-example/bin/Counter.bin

@@ -0,0 +1 @@
+60806040526000808190555060f5806100196000396000f3fe6080604052600436106043576000357c0100000000000000000000000000000000000000000000000000000000900480633fa4f245146048578063d09de08a146070575b600080fd5b348015605357600080fd5b50605a6078565b6040518082815260200191505060405180910390f35b6076607e565b005b60005481565b600160008082825401925050819055507f20d8a6f5a693f9d1d627a598e8820f7a55ee74c183aa8f1a30e8d4e8dd9a8d846000546040518082815260200191505060405180910390a156fea165627a7a72305820fca3d11af59a6ac98027ec3bebdb10711f195860d6d9abd07921c88c8c50228f0029

package/tests/cli/init/ethereum/from-example/contracts/Gravity.sol

@@ -0,0 +1,63 @@
+pragma solidity ^0.4.0;
+
+contract GravatarRegistry {
+  event NewGravatar(uint id, address owner, string displayName, string imageUrl);
+  event UpdatedGravatar(uint id, address owner, string displayName, string imageUrl);
+
+  struct Gravatar {
+    address owner;
+    string displayName;
+    string imageUrl;
+  }
+
+  Gravatar[] public gravatars;
+
+  mapping (uint => address) public gravatarToOwner;
+  mapping (address => uint) public ownerToGravatar;
+
+  function createGravatar(string _displayName, string _imageUrl) public {
+    require(ownerToGravatar[msg.sender] == 0);
+    uint id = gravatars.push(Gravatar(msg.sender, _displayName, _imageUrl)) - 1;
+
+    gravatarToOwner[id] = msg.sender;
+    ownerToGravatar[msg.sender] = id;
+
+    emit NewGravatar(id, msg.sender, _displayName, _imageUrl);
+  }
+
+  function getGravatar(address owner) public view returns (string, string) {
+    uint id = ownerToGravatar[owner];
+    return (gravatars[id].displayName, gravatars[id].imageUrl);
+  }
+
+  function updateGravatarName(string _displayName) public {
+    require(ownerToGravatar[msg.sender] != 0);
+    require(msg.sender == gravatars[ownerToGravatar[msg.sender]].owner);
+
+    uint id = ownerToGravatar[msg.sender];
+
+    gravatars[id].displayName = _displayName;
+    emit UpdatedGravatar(id, msg.sender, _displayName, gravatars[id].imageUrl);
+  }
+
+  function updateGravatarImage(string _imageUrl) public {
+    require(ownerToGravatar[msg.sender] != 0);
+    require(msg.sender == gravatars[ownerToGravatar[msg.sender]].owner);
+
+    uint id = ownerToGravatar[msg.sender];
+
+    gravatars[id].imageUrl =  _imageUrl;
+    emit UpdatedGravatar(id, msg.sender, gravatars[id].displayName, _imageUrl);
+  }
+
+  // the gravatar at position 0 of gravatars[]
+  // is fake
+  // it's a mythical gravatar
+  // that doesn't really exist
+  // dani will invoke this function once when this contract is deployed
+  // but then no more
+  function setMythicalGravatar() public {
+    require(msg.sender == 0x8d3e809Fbd258083a5Ba004a527159Da535c8abA);
+    gravatars.push(Gravatar(0x0, " ", " "));
+  }
+}

package/tests/cli/init/ethereum/from-example/contracts/Migrations.sol

@@ -0,0 +1,23 @@
+pragma solidity ^0.4.0;
+
+contract Migrations {
+  address public owner;
+  uint public last_completed_migration;
+
+  constructor() public {
+    owner = msg.sender;
+  }
+
+  modifier restricted() {
+    if (msg.sender == owner) _;
+  }
+
+  function setCompleted(uint completed) public restricted {
+    last_completed_migration = completed;
+  }
+
+  function upgrade(address new_address) public restricted {
+    Migrations upgraded = Migrations(new_address);
+    upgraded.setCompleted(last_completed_migration);
+  }
+}

package/tests/cli/init/ethereum/from-example/docker-compose.yml

@@ -0,0 +1,39 @@
+version: '3'
+services:
+  graph-node:
+    image: graphprotocol/graph-node:v0.22.0
+    ports:
+      - '8000:8000'
+      - '8001:8001'
+      - '8020:8020'
+      - '8030:8030'
+      - '8040:8040'
+    depends_on:
+      - ipfs
+      - postgres
+    environment:
+      postgres_host: postgres
+      postgres_user: graph-node
+      postgres_pass: let-me-in
+      postgres_db: graph-node
+      ipfs: 'ipfs:5001'
+      # Change next line if you want to connect to a different JSON-RPC endpoint
+      ethereum: 'mainnet:http://host.docker.internal:8545'
+      GRAPH_LOG: info
+  ipfs:
+    image: ipfs/go-ipfs:v0.4.23
+    ports:
+      - '5001:5001'
+    volumes:
+      - ./data/ipfs:/data/ipfs
+  postgres:
+    image: postgres
+    ports:
+      - '5432:5432'
+    command: ["postgres", "-cshared_preload_libraries=pg_stat_statements"]
+    environment:
+      POSTGRES_USER: graph-node
+      POSTGRES_PASSWORD: let-me-in
+      POSTGRES_DB: graph-node
+    volumes:
+      - ./data/postgres:/var/lib/postgresql/data

package/tests/cli/init/ethereum/from-example/migrations/1_initial_migration.js

@@ -0,0 +1,5 @@
+var Migrations = artifacts.require('./Migrations.sol')
+
+module.exports = function(deployer) {
+  deployer.deploy(Migrations)
+}

package/tests/cli/init/ethereum/from-example/migrations/2_deploy_contract.js

@@ -0,0 +1,5 @@
+const GravatarRegistry = artifacts.require('./GravatarRegistry.sol')
+
+module.exports = async function(deployer) {
+  await deployer.deploy(GravatarRegistry)
+}

package/tests/cli/init/ethereum/from-example/migrations/3_create_gravatars.js

@@ -0,0 +1,15 @@
+const GravatarRegistry = artifacts.require('./GravatarRegistry.sol')
+
+module.exports = async function(deployer) {
+  const registry = await GravatarRegistry.deployed()
+
+  console.log('Account address:', registry.address)
+
+  let accounts = await web3.eth.getAccounts()
+  await registry.createGravatar('Carl', 'https://thegraph.com/img/team/team_04.png', {
+    from: accounts[0],
+  })
+  await registry.createGravatar('Lucas', 'https://thegraph.com/img/team/bw_Lucas.jpg', {
+    from: accounts[1],
+  })
+}

package/tests/cli/init/ethereum/from-example/networks.json

@@ -0,0 +1,7 @@
+{
+  "mainnet": {
+    "Gravity": {
+      "address": "0x2E645469f354BB4F5c8a05B3b30A929361cf77eC"
+    }
+  }
+}

package/tests/cli/init/ethereum/from-example/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "example-subgraph",
+  "version": "0.1.0",
+  "scripts": {
+    "build-contract": "solc contracts/Gravity.sol --abi -o abis --overwrite && solc contracts/Gravity.sol --bin -o bin --overwrite",
+    "create": "graph create user/example-subgraph --node https://api.thegraph.com/deploy/",
+    "create-local": "graph create user/example-subgraph --node http://127.0.0.1:8020",
+    "codegen": "graph codegen",
+    "build": "graph build",
+    "deploy": "graph deploy user/example-subgraph --ipfs https://api.thegraph.com/ipfs/ --node https://api.thegraph.com/deploy/",
+    "deploy-local": "graph deploy user/example-subgraph --ipfs http://127.0.0.1:5001 --node http://127.0.0.1:8020"
+  },
+  "devDependencies": {
+    "@graphprotocol/graph-ts": "^0.26.0"
+  },
+  "dependencies": {
+    "babel-polyfill": "^6.26.0",
+    "babel-register": "^6.26.0",
+    "truffle": "^5.0.4",
+    "truffle-contract": "^4.0.5",
+    "truffle-hdwallet-provider": "^1.0.4"
+  }
+}

package/tests/cli/init/ethereum/from-example/schema.graphql

@@ -0,0 +1,6 @@
+type Gravatar @entity {
+  id: ID!
+  owner: Bytes!
+  displayName: String!
+  imageUrl: String!
+}

package/tests/cli/init/ethereum/from-example/src/mapping.ts

@@ -0,0 +1,22 @@
+import { NewGravatar, UpdatedGravatar } from '../generated/Gravity/Gravity'
+import { Gravatar } from '../generated/schema'
+
+export function handleNewGravatar(event: NewGravatar): void {
+  let gravatar = new Gravatar(event.params.id.toHex())
+  gravatar.owner = event.params.owner
+  gravatar.displayName = event.params.displayName
+  gravatar.imageUrl = event.params.imageUrl
+  gravatar.save()
+}
+
+export function handleUpdatedGravatar(event: UpdatedGravatar): void {
+  let id = event.params.id.toHex()
+  let gravatar = Gravatar.load(id)
+  if (gravatar == null) {
+    gravatar = new Gravatar(id)
+  }
+  gravatar.owner = event.params.owner
+  gravatar.displayName = event.params.displayName
+  gravatar.imageUrl = event.params.imageUrl
+  gravatar.save()
+}

package/tests/cli/init/ethereum/from-example/subgraph.yaml

@@ -0,0 +1,27 @@
+specVersion: 0.0.2
+description: Gravatar for Ethereum
+repository: https://github.com/graphprotocol/example-subgraph
+schema:
+  file: ./schema.graphql
+dataSources:
+  - kind: ethereum/contract
+    name: Gravity
+    network: mainnet
+    source:
+      address: '0x2E645469f354BB4F5c8a05B3b30A929361cf77eC'
+      abi: Gravity
+    mapping:
+      kind: ethereum/events
+      apiVersion: 0.0.5
+      language: wasm/assemblyscript
+      entities:
+        - Gravatar
+      abis:
+        - name: Gravity
+          file: ./abis/Gravity.json
+      eventHandlers:
+        - event: NewGravatar(uint256,address,string,string)
+          handler: handleNewGravatar
+        - event: UpdatedGravatar(uint256,address,string,string)
+          handler: handleUpdatedGravatar
+      file: ./src/mapping.ts

package/tests/cli/init/ethereum/from-example/truffle.js

@@ -0,0 +1,27 @@
+require('babel-register')
+require('babel-polyfill')
+const HDWalletProvider = require('truffle-hdwallet-provider')
+
+module.exports = {
+  networks: {
+    development: {
+      host: '127.0.0.1',
+      port: 8545,
+      network_id: '*',
+    },
+    ropsten: {
+      provider: function() {
+        return new HDWalletProvider(
+          process.env.MNEMONIC,
+          `https://ropsten.infura.io/v3/${process.env.ROPSTEN_INFURA_API_KEY}`
+        )
+      },
+      network_id: '3',
+    },
+  },
+  compilers: {
+    solc: {
+      version: '0.4.25'    // Fetch exact version from solc-bin (default: truffle's version)
+    }
+  }
+}