DXdao Snapshot DB Tool

Install

yarn

And configure your .env file with your Infura, Etherscan and Tenderly API keys.

KEY_INFURA_API_KEY="xxxx"
KEY_ETHERSCAN="xxxx"
KEY_TENDERLY="xxxx" (optional)

Commands

With yarn start it will use the default snapshot provided form the repository, get the transactions and generate the snapshot. Use TO_BLOCK with the maximum block you want to analyze parameter you want to use, using latest provided by the web3 provider by default.

Get Transactions

yarn transactions

Build Snapshopt

yarn snapshot

Snapshot Viewer

You can view, navigate and search in the snapshot file by using an online json viewer, https://jsoneditoronline.org/. Just import the DXdaoSnapshot.json file from your disk.

Simulate Transactions

At the end of the snapshot script it will log the proposals that will execute a generic call. This calls can be simulated using a free account in (tenderly)[https://dashboard.tenderly.co/]

For example, for the proposal:

Generic proposal 0xe7d3b81c6221a5e39bfeac13d61ae559fd783f62340f1051da2d7d474e32070d in EnsRegistryScheme active to simulate 
 { to: '0x9f828AC3baA9003e8a4e0b24bcaE7b027B6740b0',
  from: '0x9CEA0DD05C4344A769B2F4C2f8890EDa8a700d64',
  data:
   '0xd1b7089a00000000000000000000000000000000000c2e074ec69a0dfb2997ba6c7d2e1e0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000519b70055af55a007110b4ff99b0ea33071c720a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000441896f70af8fabcf7d9650c93acc010dba6eae53a9732022d237a5bcb5226c62af6755e710000000000000000000000004976fb03c32e5b8cfe2b6ccb31c09ba78ebaba4100000000000000000000000000000000000000000000000000000000',
  value: '0' }

Snapshot Format

{
  fromBlock: Number,
  toBlock: Number,
  controller: {
    txs: [ {
      hash: "32 Bytes: String: Hash of the transaction."
      nonce: "Number: The number of transactions made by the sender prior to this one."
      blockHash: " Bytes - String: Hash of the block where this transaction was in. null when its pending."
      blockNumber: "Number: Block number where this transaction was in. null when its pending."
      transactionIndex: "Number: Integer of the transactions index position in the block. null when its pending."
      from: "String: Address of the sender."
      to: "String: Address of the receiver. null when its a contract creation transaction."
      value: "String: Value transferred in wei."
      gasPrice: "String: Gas price provided by the sender in wei."
      gas: "Number: Gas provided by the sender."
      input: "String: The data sent along with the transaction."
      receipt: {
        status: "Boolean: TRUE if the transaction was successful, FALSE, if the EVM reverted the transaction."
        blockHash: "32 Bytes: Hash of the block where this transaction was in."
        blockNumber: "Number: Block number where this transaction was in."
        transactionHash: "32 Bytes: Hash of the transaction."
        transactionIndex: "Number: Integer of the transactions index position in the block."
        from: "String: Address of the sender."
        to: "String: Address of the receiver. null when its a contract creation transaction."
        contractAddress: "String: The contract address created, if the transaction was a contract creation, otherwise null."
        cumulativeGasUsed: "Number: The total amount of gas used when this transaction was executed in the block."
        gasUsed: "Number: The amount of gas used by this specific transaction alone."
        logs: "Array: Array of log objects, which this transaction generated."
      }
    } ... ],
    internalTxs: [ {
      status: "Boolean: TRUE if the transaction was successful, FALSE, if the EVM reverted the transaction."
      blockHash: "32 Bytes: Hash of the block where this transaction was in."
      blockNumber: "Number: Block number where this transaction was in."
      transactionHash: "32 Bytes: Hash of the transaction."
      transactionIndex: "Number: Integer of the transactions index position in the block."
      from: "String: Address of the sender."
      to: "String: Address of the receiver. null when its a contract creation transaction."
      contractAddress: "String: The contract address created, if the transaction was a contract creation, otherwise null."
      cumulativeGasUsed: "Number: The total amount of gas used when this transaction was executed in the block."
      gasUsed: "Number: The amount of gas used by this specific transaction alone."
      logs: "Array: Array of log objects, which this transaction generated."
    } ... ],
    events: [ {
      event: "String: The event name."
      signature: "String|Null: The event signature, null if it’s an anonymous event."
      address: "String: Address this event originated from."
      returnValues: "Object: The return values coming from the event, e.g. {myVar: 1, myVar2: '0x234...'}."
      logIndex: "Number: Integer of the event index position in the block."
      transactionIndex: "Number: Integer of the transaction’s index position the event was created in."
      transactionHash: " Bytes - String: Hash of the transaction this event was created in."
      blockHash: "Bytes - String: Hash of the block this event was created in. null when it’s still pending."
      blockNumber: "Number: The block number this log was created in. null when still pending."
      raw.data: "String: The data containing non-indexed log parameter."
      raw.topics: "Array: An array with max 4 32 Byte topics, topic 1-3 contains indexed parameters of the event."
    } ... ]
  },
  avatar: {
    txs: [ Tx ],
    internalTxs: [ TxReceipt ],
    events: [ Event ]
  },
  reputation: {
    txs: [ Tx ],
    internalTxs: [ TxReceipt ],
    events: [ Event ]
  },
  token: {
    txs: [ Tx ],
    internalTxs: [ TxReceipt ],
    events: [ Event ]
  },
  schemes: {
    scheme1: {
      txs: [ Tx ],
      internalTxs: [ TxReceipt ],
      events: [ Event ]
    },
    ...
    schemeX: {
      txs: [ Tx ],
      internalTxs: [ TxReceipt ],
      events: [ Event ]
    }
  }
}