strategies.md

Strategies

A strategy is a JavaScript function that returns a score for a set of addresses. Strategies are being used on Snapshot to calculate the result for a proposal. A proposal can have multiple strategies. The default strategy is to calculate the balance of an ERC20 for each voter. A strategy can send a call to a node or subgraph.

All the strategies are visible here: https://snapshot.page/#/strategies

1: This is the default strategy used erc20-balance-of:

{% embed url="https://github.com/bonustrack/snapshot.js/blob/master/src/strategies/erc20-balance-of/index.ts" caption="" %}

import { formatUnits } from '@ethersproject/units';
import { multicall } from '../../utils';
import { abi } from './TestToken.json';

export async function strategy(provider, addresses, options, snapshot) {
  const blockTag = typeof snapshot === 'number' ? snapshot : 'latest';
  const response = await multicall(
    provider,
    abi,
    addresses.map((address: any) => [options.address, 'balanceOf', [address]]),
    { blockTag }
  );
  return Object.fromEntries(
    response.map((value, i) => [
      addresses[i],
      parseFloat(formatUnits(value.toString(), options.decimals))
    ])
  );
}

Strategies are defined in the space index.json file level. This is how to add strategies to calculate the balance of voters in BAL and balance of BAL in Balancer pools where they provide liquidity.

{% embed url="https://github.com/bonustrack/snapshot-spaces/blob/master/spaces/balancer/index.json\#L20-L30" caption="" %}

{
  ...
  "strategies": [
    [
      "erc20-balance-of",
      {
        "address": "0xba100000625a3754423978a60c9317c58a424e3D",
        "symbol": "BAL",
        "decimals": 18
      }
    ],
    [
      "balancer",
      {
        "address": "0xba100000625a3754423978a60c9317c58a424e3D",
        "symbol": "BAL BPT"
      }
    ]
  ]
}

Strategies can be used to create a score from on-chain data, the data does not necessarily need to be monetary, we can imagine a strategy that calculates how many POAP you own or use any other data available on-chain to issue a score.

More strategies are on Snapshot.js here:

{% embed url="https://github.com/bonustrack/snapshot.js/tree/master/src/strategies" caption="" %}