[erc20-votes-undelegated-balance] new erc20-votes-undelegated-balance strategy (#1778)

Author: ChaituVR

src/strategies/erc20-votes-undelegated-balance/README.md

@@ -0,0 +1,35 @@
+# erc20-votes-undelegated-balance
+
+This strategy gives voting power based on token balance, but only to users who haven't delegated their voting power at all (including self-delegation).
+
+## How it works
+
+1. **Checks delegation status**: Calls `delegates()` to see who the user has delegated their voting power to
+2. **Gets token balance**: Calls `balanceOf()` to get the token balance of each address
+3. **Calculates voting power**:
+   - If user has delegated to anyone (including themselves): voting power = 0
+   - If user hasn't delegated at all (delegates() returns zero address): voting power = token balance
+
+This ensures only users who haven't participated in the delegation system at all get voting power from their token balance.
+
+## Parameters
+
+- `address` - (**Required**, `string`) The address of the ERC-20 Votes token contract
+- `decimals` - (*Optional*, `number`) The number of decimals for the token. Defaults to 18
+
+## Examples
+
+```json
+{
+  "symbol": "VOTE",
+  "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
+  "decimals": 18
+}
+```
+
+In this example:
+
+- Alice has 100 tokens and hasn't delegated at all → gets 100 voting power
+- Bob has 50 tokens and delegated to Charlie → gets 0 voting power  
+- Charlie has 75 tokens and self-delegated → gets 0 voting power (because he has delegated, even to himself)
+- Dave has 25 tokens and hasn't delegated at all → gets 25 voting power

src/strategies/erc20-votes-undelegated-balance/examples.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "Example query",
+    "strategy": {
+      "name": "erc20-votes-undelegated-balance",
+      "params": {
+        "address": "0xAcd2c239012D17BEB128B0944D49015104113650",
+        "decimals": 18
+      }
+    },
+    "network": "1",
+    "addresses": [
+      "0xAcd2c239012D17BEB128B0944D49015104113650",
+      "0x30320770c27c747E6C9CD30F5046c5313b0a1858",
+      "0xb656015c94a4516fae9fa744b78e050299d5201d",
+      "0x6dE6AbF292224b9b293f304388735D08b4Db1398",
+      "0xe068F7e056380e460DE88cd8290C5596F0803D53",
+      "0x13883dc4326fe65a3ae0383d509166dfad620cc4"
+    ],
+    "snapshot": 22926406
+  }
+]

src/strategies/erc20-votes-undelegated-balance/index.ts

@@ -0,0 +1,57 @@
+import { formatUnits } from '@ethersproject/units';
+import { getAddress, isAddress } from '@ethersproject/address';
+import { multicall } from '../../utils';
+
+export const author = 'snapshot-labs';
+export const version = '0.1.0';
+
+const abi = [
+  'function delegates(address account) view returns (address)',
+  'function balanceOf(address account) view returns (uint256)'
+];
+
+export async function strategy(
+  space,
+  network,
+  provider,
+  addresses,
+  options,
+  snapshot
+) {
+  const blockTag = typeof snapshot === 'number' ? snapshot : 'latest';
+
+  // Combine both delegates and balanceOf calls in a single multicall
+  const calls = addresses.flatMap((address: any) => [
+    [options.address, 'delegates', [address.toLowerCase()]],
+    [options.address, 'balanceOf', [address.toLowerCase()]]
+  ]);
+
+  const response = await multicall(network, provider, abi, calls, { blockTag });
+
+  return Object.fromEntries(
+    addresses.map((address, i) => {
+      const delegatesIndex = i * 2;
+      const balanceOfIndex = i * 2 + 1;
+
+      const delegateTo = response[delegatesIndex]?.toString().toLowerCase();
+      const balance = parseFloat(
+        formatUnits(response[balanceOfIndex].toString(), options.decimals || 18)
+      );
+
+      // If user has delegated their voting power (to anyone, including themselves), their voting power is 0
+      // Otherwise, they get their balance as voting power
+      const hasDelegated = hasDelegateAddress(delegateTo);
+      const totalVotingPower = hasDelegated ? 0 : balance;
+
+      return [getAddress(address), totalVotingPower];
+    })
+  );
+}
+
+function hasDelegateAddress(delegateAddress: string | undefined): boolean {
+  return (
+    !!delegateAddress &&
+    isAddress(delegateAddress) &&
+    delegateAddress !== '0x0000000000000000000000000000000000000000'
+  );
+}

src/strategies/erc20-votes-undelegated-balance/schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/Strategy",
+  "definitions": {
+    "Strategy": {
+      "title": "Strategy",
+      "type": "object",
+      "properties": {
+        "symbol": {
+          "type": "string",
+          "title": "Symbol",
+          "examples": ["e.g. VOTE"],
+          "maxLength": 16
+        },
+        "address": {
+          "type": "string",
+          "title": "Contract address",
+          "examples": ["e.g. 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984"],
+          "pattern": "^0x[a-fA-F0-9]{40}$",
+          "minLength": 42,
+          "maxLength": 42
+        },
+        "decimals": {
+          "type": "number",
+          "title": "Decimals",
+          "examples": ["e.g. 18"],
+          "minimum": 0,
+          "default": 18
+        }
+      },
+      "required": ["address"],
+      "additionalProperties": false
+    }
+  }
+}

src/strategies/index.ts

@@ -13,6 +13,7 @@ import * as dpsNFTStrategyNova from './dps-nft-strategy-nova';
 import * as nounsPower from './nouns-rfp-power';
 import * as erc20Votes from './erc20-votes';
 import * as erc20VotesWithOverride from './erc20-votes-with-override';
+import * as erc20VotesUndelegatedBalance from './erc20-votes-undelegated-balance';
 import * as antiWhale from './anti-whale';
 import * as balancer from './balancer';
 import * as balancerSmartPool from './balancer-smart-pool';
@@ -538,6 +539,7 @@ const strategies = {
   'erc20-balance-of-at': erc20BalanceOfAt,
   'erc20-votes': erc20Votes,
   'erc20-votes-with-override': erc20VotesWithOverride,
+  'erc20-votes-undelegated-balance': erc20VotesUndelegatedBalance,
   'erc721-multi-registry-weighted': erc721MultiRegistryWeighted,
   'erc20-balance-of-fixed-total': erc20BalanceOfFixedTotal,
   'erc20-balance-of-cv': erc20BalanceOfCv,