@snapshot-labs/snapshot.js 0.10.1 → 0.11.1

package/dist/utils/delegation.d.ts

@@ -0,0 +1,18 @@
+export declare const SNAPSHOT_SUBGRAPH_URL: {
+    1: string;
+    5: string;
+    10: string;
+    56: string;
+    100: string;
+    137: string;
+    250: string;
+    42161: string;
+};
+declare type Delegation = {
+    delegator: string;
+    delegate: string;
+    space: string;
+    timestamp: number;
+};
+export default function getDelegatesBySpace(network: string, space: string, snapshot?: string | number, options?: any): Promise<Delegation[]>;
+export {};

package/dist/utils.d.ts

@@ -3,6 +3,7 @@ import { getSnapshots } from './utils/blockfinder';
 import getProvider from './utils/provider';
 import { signMessage, getBlockNumber } from './utils/web3';
 import { getHash, verify } from './sign/utils';
+import getDelegatesBySpace, { SNAPSHOT_SUBGRAPH_URL } from './utils/delegation';
 interface Options {
     url?: string;
 }
@@ -11,16 +12,6 @@ interface Strategy {
     network?: string;
     params: any;
 }
-export declare const SNAPSHOT_SUBGRAPH_URL: {
-    1: string;
-    5: string;
-    10: string;
-    56: string;
-    100: string;
-    137: string;
-    250: string;
-    42161: string;
-};
 export declare function call(provider: any, abi: any[], call: any[], options?: any): Promise<any>;
 export declare function multicall(network: string, provider: any, abi: any[], calls: any[], options?: any): Promise<any>;
 export declare function subgraphRequest(url: string, query: any, options?: any): Promise<any>;
@@ -40,10 +31,10 @@ export declare function getEnsTextRecord(ens: string, record: string, network?:
 export declare function getSpaceUri(id: string, network?: string, options?: any): Promise<string | null>;
 export declare function getEnsOwner(ens: string, network?: string, options?: any): Promise<string | null>;
 export declare function getSpaceController(id: string, network?: string, options?: any): Promise<string | null>;
-export declare function getDelegatesBySpace(network: string, space: string, snapshot?: string, options?: any): Promise<never[]>;
 export declare function clone(item: any): any;
 export declare function sleep(time: any): Promise<unknown>;
 export declare function getNumberWithOrdinal(n: any): string;
+export { getDelegatesBySpace, SNAPSHOT_SUBGRAPH_URL };
 declare const _default: {
     call: typeof call;
     multicall: typeof multicall;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snapshot-labs/snapshot.js",
-  "version": "0.10.1",
+  "version": "0.11.1",
   "repository": "snapshot-labs/snapshot.js",
   "license": "MIT",
   "main": "dist/snapshot.cjs.js",
@@ -18,6 +18,7 @@
     "@ethersproject/units": "^5.7.0",
     "@ethersproject/wallet": "^5.6.2",
     "ajv": "^8.11.0",
+    "ajv-errors": "^3.0.0",
     "ajv-formats": "^2.1.1",
     "cross-fetch": "^3.1.6",
     "json-to-graphql-query": "^2.2.4",

package/src/schemas/space.json

@@ -282,11 +282,19 @@
           "properties": {
             "delay": {
               "type": "integer",
-              "minimum": 0
+              "minimum": 0,
+              "maximum": 2592000,
+              "errorMessage": {
+                "maximum": "Delay must be less than 30 days"
+              }
             },
             "period": {
               "type": "integer",
-              "minimum": 0
+              "minimum": 0,
+              "maximum": 15552000,
+              "errorMessage": {
+                "maximum": "Delay must be less than 180 days"
+              }
             },
             "type": {
               "type": "string",

package/src/utils/delegation.ts

@@ -0,0 +1,117 @@
+import { subgraphRequest } from '../utils';
+import delegationSubgraphs from '../delegationSubgraphs.json';
+
+export const SNAPSHOT_SUBGRAPH_URL = delegationSubgraphs;
+const PAGE_SIZE = 1000;
+
+type Delegation = {
+  delegator: string;
+  delegate: string;
+  space: string;
+  timestamp: number;
+};
+
+export default async function getDelegatesBySpace(
+  network: string,
+  space: string,
+  snapshot: string | number = 'latest',
+  options: any = {}
+) {
+  const subgraphUrl = options.subgraphUrl || SNAPSHOT_SUBGRAPH_URL[network];
+  if (!subgraphUrl) {
+    return Promise.reject(
+      `Delegation subgraph not available for network ${network}`
+    );
+  }
+
+  let pivot = 0;
+  const result = new Map<string, Delegation>();
+  const spaceIn = buildSpaceIn(space);
+
+  while (true) {
+    const newResults = await fetchData({
+      url: subgraphUrl,
+      spaces: spaceIn,
+      pivot,
+      snapshot
+    });
+
+    if (checkAllDuplicates(newResults)) {
+      throw new Error('Unable to paginate delegation');
+    }
+
+    newResults.forEach((delegation) => {
+      concatUniqueDelegation(result, delegation);
+      pivot = delegation.timestamp;
+    });
+
+    if (newResults.length < PAGE_SIZE) break;
+  }
+
+  return [...result.values()];
+}
+
+function checkAllDuplicates(delegations: Delegation[]) {
+  return (
+    delegations.length === PAGE_SIZE &&
+    delegations[0].timestamp === delegations[delegations.length - 1].timestamp
+  );
+}
+
+function delegationKey(delegation: Delegation) {
+  return `${delegation.delegator}-${delegation.delegate}-${delegation.space}`;
+}
+
+function concatUniqueDelegation(
+  result: Map<string, Delegation>,
+  delegation: Delegation
+): void {
+  const key = delegationKey(delegation);
+  if (!result.has(key)) {
+    result.set(key, delegation);
+  }
+}
+
+function buildSpaceIn(space: string) {
+  const spaces = ['', space];
+  if (space.includes('.eth')) spaces.push(space.replace('.eth', ''));
+
+  return spaces;
+}
+
+async function fetchData({
+  url,
+  spaces,
+  pivot,
+  snapshot
+}: {
+  url: string;
+  spaces: string[];
+  pivot: number;
+  snapshot: string | number;
+}): Promise<Delegation[]> {
+  const params: any = {
+    delegations: {
+      __args: {
+        where: {
+          space_in: spaces,
+          timestamp_gte: pivot
+        },
+        first: PAGE_SIZE,
+        skip: 0,
+        orderBy: 'timestamp',
+        orderDirection: 'asc'
+      },
+      delegator: true,
+      space: true,
+      delegate: true,
+      timestamp: true
+    }
+  };
+
+  if (snapshot !== 'latest') {
+    params.delegations.__args.block = { number: snapshot };
+  }
+
+  return (await subgraphRequest(url, params)).delegations || [];
+}

package/src/utils.ts

@@ -7,6 +7,7 @@ import { namehash, ensNormalize } from '@ethersproject/hash';
 import { jsonToGraphQLQuery } from 'json-to-graphql-query';
 import Ajv from 'ajv';
 import addFormats from 'ajv-formats';
+import addErrors from 'ajv-errors';
 import Multicaller from './utils/multicaller';
 import { getSnapshots } from './utils/blockfinder';
 import getProvider from './utils/provider';
@@ -14,8 +15,8 @@ import { signMessage, getBlockNumber } from './utils/web3';
 import { getHash, verify } from './sign/utils';
 import gateways from './gateways.json';
 import networks from './networks.json';
-import delegationSubgraphs from './delegationSubgraphs.json';
 import voting from './voting';
+import getDelegatesBySpace, { SNAPSHOT_SUBGRAPH_URL } from './utils/delegation';
 
 interface Options {
   url?: string;
@@ -27,7 +28,6 @@ interface Strategy {
   params: any;
 }
 
-export const SNAPSHOT_SUBGRAPH_URL = delegationSubgraphs;
 const ENS_RESOLVER_ABI = [
   'function text(bytes32 node, string calldata key) external view returns (string memory)'
 ];
@@ -46,6 +46,7 @@ const ajv = new Ajv({
 });
 // @ts-ignore
 addFormats(ajv);
+addErrors(ajv);
 
 ajv.addFormat('address', {
   validate: (value: string) => {
@@ -572,55 +573,6 @@ export async function getSpaceController(
   return await getEnsOwner(id, network, options);
 }
 
-export async function getDelegatesBySpace(
-  network: string,
-  space: string,
-  snapshot = 'latest',
-  options: any = {}
-) {
-  const subgraphUrl = options.subgraphUrl || SNAPSHOT_SUBGRAPH_URL[network];
-  if (!subgraphUrl) {
-    return Promise.reject(
-      `Delegation subgraph not available for network ${network}`
-    );
-  }
-  const spaceIn = ['', space];
-  if (space.includes('.eth')) spaceIn.push(space.replace('.eth', ''));
-
-  const PAGE_SIZE = 1000;
-  let result = [];
-  let page = 0;
-  const params: any = {
-    delegations: {
-      __args: {
-        where: {
-          space_in: spaceIn
-        },
-        first: PAGE_SIZE,
-        skip: 0
-      },
-      delegator: true,
-      space: true,
-      delegate: true
-    }
-  };
-  if (snapshot !== 'latest') {
-    params.delegations.__args.block = { number: snapshot };
-  }
-
-  while (true) {
-    params.delegations.__args.skip = page * PAGE_SIZE;
-
-    const pageResult = await subgraphRequest(subgraphUrl, params);
-    const pageDelegations = pageResult.delegations || [];
-    result = result.concat(pageDelegations);
-    page++;
-    if (pageDelegations.length < PAGE_SIZE) break;
-  }
-
-  return result;
-}
-
 export function clone(item) {
   return JSON.parse(JSON.stringify(item));
 }
@@ -656,6 +608,8 @@ function inputError(message: string) {
   return Promise.reject(new Error(message));
 }
 
+export { getDelegatesBySpace, SNAPSHOT_SUBGRAPH_URL };
+
 export default {
   call,
   multicall,