@maci-protocol/coordinator 0.0.0-ci.00107eb

package/build/ts/auth/AccountSignatureGuard.service.js

@@ -0,0 +1,96 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var AccountSignatureGuard_1;
+import { Logger, Injectable, SetMetadata, } from "@nestjs/common";
+import { Reflector } from "@nestjs/core";
+import { ethers } from "ethers";
+import fs from "fs";
+import path from "path";
+import { CryptoService } from "../crypto/crypto.service";
+/**
+ * Public metadata key
+ */
+export const PUBLIC_METADATA_KEY = "isPublic";
+/**
+ * Public decorator to by-pass auth checks
+ *
+ * @returns public decorator
+ */
+export const Public = () => SetMetadata(PUBLIC_METADATA_KEY, true);
+/**
+ * AccountSignatureGuard is responsible for protecting calling controller and websocket gateway functions.
+ * If account address is not added to .env file, you will not be allowed to call any API methods.
+ * Make sure you send `Authorization: Bearer encrypt({signature}:{digest})` header where:
+ * 1. encrypt - RSA public encryption.
+ * 2. signature - eth wallet signature for any message
+ * 3. digest - hex representation of message digest
+ *
+ * ```
+ * const signature = await signer.signMessage("message");
+ * const digest = Buffer.from(getBytes(hashMessage("message"))).toString("hex");
+ * ```
+ * See tests for more details about authorization.
+ */
+let AccountSignatureGuard = AccountSignatureGuard_1 = class AccountSignatureGuard {
+    cryptoService;
+    reflector;
+    /**
+     * Logger
+     */
+    logger;
+    constructor(cryptoService, reflector) {
+        this.cryptoService = cryptoService;
+        this.reflector = reflector;
+        this.logger = new Logger(AccountSignatureGuard_1.name);
+    }
+    /**
+     * This function should return a boolean, indicating  whether the request is allowed or not based on message signature and digest.
+     *
+     * @param ctx - execution context
+     * @returns whether the request is allowed or not
+     */
+    async canActivate(ctx) {
+        try {
+            const isPublic = this.reflector.get(PUBLIC_METADATA_KEY, ctx.getHandler());
+            if (isPublic) {
+                return true;
+            }
+            const request = ctx.switchToHttp().getRequest();
+            const socket = ctx.switchToWs().getClient();
+            const encryptedHeader = socket.handshake?.headers.authorization || request.headers?.authorization;
+            if (!encryptedHeader) {
+                this.logger.warn("No authorization header");
+                return false;
+            }
+            const privateKey = await fs.promises.readFile(path.resolve(process.env.COORDINATOR_PRIVATE_KEY_PATH));
+            const [signature, digest] = this.cryptoService
+                .decrypt(privateKey, encryptedHeader.replace("Bearer", "").trim())
+                .split(":");
+            if (!signature || !digest) {
+                this.logger.warn("No signature or digest");
+                return false;
+            }
+            const address = ethers.recoverAddress(Buffer.from(digest, "hex"), signature).toLowerCase();
+            const coordinatorAddress = process.env.COORDINATOR_ADDRESSES?.split(",").map((value) => value.toLowerCase()) ?? [];
+            return coordinatorAddress.includes(address);
+        }
+        catch (error) {
+            this.logger.error("Error", error);
+            return false;
+        }
+    }
+};
+AccountSignatureGuard = AccountSignatureGuard_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [CryptoService,
+        Reflector])
+], AccountSignatureGuard);
+export { AccountSignatureGuard };
+//# sourceMappingURL=AccountSignatureGuard.service.js.map

package/build/ts/auth/AccountSignatureGuard.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountSignatureGuard.service.js","sourceRoot":"","sources":["../../../ts/auth/AccountSignatureGuard.service.ts"],"names":[],"mappings":"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"}

package/build/ts/auth/__tests__/AccountSignatureGuard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AccountSignatureGuard.test.d.ts.map

package/build/ts/auth/__tests__/AccountSignatureGuard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountSignatureGuard.test.d.ts","sourceRoot":"","sources":["../../../../ts/auth/__tests__/AccountSignatureGuard.test.ts"],"names":[],"mappings":""}

package/build/ts/auth/__tests__/AccountSignatureGuard.test.js

@@ -0,0 +1,113 @@
+import dotenv from "dotenv";
+import { getBytes, hashMessage } from "ethers";
+import hardhat from "hardhat";
+import { AccountSignatureGuard, PUBLIC_METADATA_KEY, Public } from "../AccountSignatureGuard.service";
+dotenv.config();
+jest.mock("../../crypto/crypto.service", () => ({
+    CryptoService: {
+        getInstance: jest.fn(),
+    },
+}));
+describe("AccountSignatureGuard", () => {
+    const mockRequest = {
+        headers: { authorization: "data" },
+    };
+    const mockContext = {
+        getHandler: jest.fn(),
+        switchToHttp: jest.fn().mockReturnValue({
+            getRequest: jest.fn(() => mockRequest),
+        }),
+        switchToWs: jest.fn().mockReturnValue({
+            getClient: jest.fn(() => ({ handshake: mockRequest })),
+        }),
+    };
+    const mockSignature = "0xc0436b6fbd5ff883fe88367f081d0780706b5c29fbfde8db2c1d607510f9095a73b3bc9b94a1588d561eaf49d195b134e3f92c36449c017ecf92c5e4d84a32131c";
+    const mockDigest = "7f6c0e5c497ded52462ec18daeb1c94cefa11cd6949ebdb7074b2a32cac13fba";
+    const mockCryptoService = {
+        decrypt: jest.fn(),
+    };
+    const reflector = {
+        get: jest.fn(),
+    };
+    beforeEach(() => {
+        mockCryptoService.decrypt = jest.fn(() => `${mockSignature}:${mockDigest}`);
+        reflector.get.mockReturnValue(false);
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    test("should create public decorator properly", () => {
+        const decorator = Public();
+        expect(decorator.KEY).toBe(PUBLIC_METADATA_KEY);
+    });
+    test("should return false if there is no Authorization header", async () => {
+        const ctx = {
+            getHandler: jest.fn(),
+            switchToHttp: jest.fn().mockReturnValue({
+                getRequest: jest.fn(() => ({
+                    headers: { authorization: "" },
+                })),
+            }),
+            switchToWs: jest.fn().mockReturnValue({
+                getClient: jest.fn(() => ({ handshake: { headers: { authorization: "" } } })),
+            }),
+        };
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(ctx);
+        expect(result).toBe(false);
+    });
+    test("should return false if there is no signature", async () => {
+        mockCryptoService.decrypt.mockReturnValue(`:${mockDigest}`);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(false);
+    });
+    test("should return false if there is no digest", async () => {
+        mockCryptoService.decrypt.mockReturnValue(mockSignature);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(false);
+    });
+    test("should return false if signature or digest are invalid", async () => {
+        mockCryptoService.decrypt.mockReturnValue(`signature:digest`);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(false);
+    });
+    test("should return false if signer is different", async () => {
+        const [, signer] = await hardhat.ethers.getSigners();
+        const signature = await signer.signMessage("message");
+        const digest = Buffer.from(getBytes(hashMessage("message"))).toString("hex");
+        mockCryptoService.decrypt.mockReturnValue(`${signature}:${digest}`);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(false);
+    });
+    test("should return true if authorization is passed properly", async () => {
+        const [signer] = await hardhat.ethers.getSigners();
+        process.env.COORDINATOR_ADDRESSES = await signer.getAddress();
+        const signature = await signer.signMessage("message");
+        const digest = Buffer.from(getBytes(hashMessage("message"))).toString("hex");
+        mockCryptoService.decrypt.mockReturnValue(`${signature}:${digest}`);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(true);
+    });
+    test("should return false if there is no COORDINATOR_ADDRESSES env", async () => {
+        const [signer] = await hardhat.ethers.getSigners();
+        process.env.COORDINATOR_ADDRESSES = undefined;
+        const signature = await signer.signMessage("message");
+        const digest = Buffer.from(getBytes(hashMessage("message"))).toString("hex");
+        mockCryptoService.decrypt.mockReturnValue(`${signature}:${digest}`);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(false);
+    });
+    test("should return true if can skip authorization", async () => {
+        reflector.get.mockReturnValue(true);
+        const guard = new AccountSignatureGuard(mockCryptoService, reflector);
+        const result = await guard.canActivate(mockContext);
+        expect(result).toBe(true);
+    });
+});
+//# sourceMappingURL=AccountSignatureGuard.test.js.map

package/build/ts/auth/__tests__/AccountSignatureGuard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountSignatureGuard.test.js","sourceRoot":"","sources":["../../../../ts/auth/__tests__/AccountSignatureGuard.test.ts"],"names":[],"mappings":"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"}

package/build/ts/common/__tests__/common.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.test.d.ts.map

package/build/ts/common/__tests__/common.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.test.d.ts","sourceRoot":"","sources":["../../../../ts/common/__tests__/common.test.ts"],"names":[],"mappings":""}

package/build/ts/common/__tests__/common.test.js

@@ -0,0 +1,77 @@
+import { ESupportedChains } from "@maci-protocol/sdk";
+import { mainnet, sepolia, arbitrum, localhost, arbitrumSepolia, baseSepolia, lineaSepolia, scrollSepolia, scroll, base, linea, gnosis, polygon, optimism, optimismSepolia, hardhat, polygonAmoy, polygonZkEvm, polygonZkEvmCardona, zksyncSepoliaTestnet, zksync, gnosisChiado, } from "viem/chains";
+import { getBundlerClient, getPublicClient, getZeroDevBundlerRPCUrl } from "../accountAbstraction";
+import { getRpcUrl } from "../chain";
+import { ErrorCodes } from "../errors";
+import { viemChain } from "../networks";
+describe("common", () => {
+    describe("getPublicClient", () => {
+        test("should return a public client", async () => {
+            const publicClient = await getPublicClient(ESupportedChains.Sepolia);
+            expect(publicClient).toBeDefined();
+        });
+        test("should throw when given an unsupported network", async () => {
+            await expect(() => getPublicClient("Unsupported")).rejects.toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+    });
+    describe("getZeroDevBundlerRPCUrl", () => {
+        test("should throw when the network is not supported", () => {
+            expect(() => getZeroDevBundlerRPCUrl("Unsupported")).toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+        test("should return an RPCUrl for a supported network", () => {
+            const rpcUrlOPS = getZeroDevBundlerRPCUrl(ESupportedChains.OptimismSepolia);
+            expect(rpcUrlOPS).toBeDefined();
+            const rpcUrlSepolia = getZeroDevBundlerRPCUrl(ESupportedChains.Sepolia);
+            expect(rpcUrlSepolia).toBeDefined();
+            const rpcUrlOP = getZeroDevBundlerRPCUrl(ESupportedChains.Optimism);
+            expect(rpcUrlOP).toBeDefined();
+        });
+        test("should throw when a unsupported zero dev network is given", () => {
+            expect(() => getZeroDevBundlerRPCUrl(ESupportedChains.Base)).toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+    });
+    describe("getBundlerClient", () => {
+        test("should throw when the network is not supported", () => {
+            expect(() => getBundlerClient("Unsupported")).toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+    });
+    describe("getRpcUrl", () => {
+        test("should throw when given an unsupported network", async () => {
+            await expect(() => getRpcUrl("Unsupported")).rejects.toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+        test("should throw when COORDINATOR_RPC_URL is not set", async () => {
+            delete process.env.COORDINATOR_RPC_URL;
+            await expect(() => getRpcUrl(ESupportedChains.OptimismSepolia)).rejects.toThrow(ErrorCodes.COORDINATOR_RPC_URL_NOT_SET.toString());
+        });
+    });
+    describe("viemChain", () => {
+        test("should return correct chain for all supported networks", () => {
+            expect(viemChain(ESupportedChains.Mainnet)).toBe(mainnet);
+            expect(viemChain(ESupportedChains.Sepolia)).toBe(sepolia);
+            expect(viemChain(ESupportedChains.Optimism)).toBe(optimism);
+            expect(viemChain(ESupportedChains.OptimismSepolia)).toBe(optimismSepolia);
+            expect(viemChain(ESupportedChains.Scroll)).toBe(scroll);
+            expect(viemChain(ESupportedChains.ScrollSepolia)).toBe(scrollSepolia);
+            expect(viemChain(ESupportedChains.Arbitrum)).toBe(arbitrum);
+            expect(viemChain(ESupportedChains.ArbitrumSepolia)).toBe(arbitrumSepolia);
+            expect(viemChain(ESupportedChains.Base)).toBe(base);
+            expect(viemChain(ESupportedChains.BaseSepolia)).toBe(baseSepolia);
+            expect(viemChain(ESupportedChains.Gnosis)).toBe(gnosis);
+            expect(viemChain(ESupportedChains.GnosisChiado)).toBe(gnosisChiado);
+            expect(viemChain(ESupportedChains.Polygon)).toBe(polygon);
+            expect(viemChain(ESupportedChains.PolygonAmoy)).toBe(polygonAmoy);
+            expect(viemChain(ESupportedChains.Linea)).toBe(linea);
+            expect(viemChain(ESupportedChains.LineaSepolia)).toBe(lineaSepolia);
+            expect(viemChain(ESupportedChains.ZkSyncEra)).toBe(zksync);
+            expect(viemChain(ESupportedChains.ZkSyncSepolia)).toBe(zksyncSepoliaTestnet);
+            expect(viemChain(ESupportedChains.PolygonZkEvm)).toBe(polygonZkEvm);
+            expect(viemChain(ESupportedChains.PolygonCardonaZkEvm)).toBe(polygonZkEvmCardona);
+            expect(viemChain(ESupportedChains.Hardhat)).toBe(hardhat);
+            expect(viemChain(ESupportedChains.Localhost)).toBe(localhost);
+        });
+        test("should throw error for unsupported network", () => {
+            expect(() => viemChain("UNSUPPORTED_NETWORK")).toThrow(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+        });
+    });
+});
+//# sourceMappingURL=common.test.js.map

package/build/ts/common/__tests__/common.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.test.js","sourceRoot":"","sources":["../../../../ts/common/__tests__/common.test.ts"],"names":[],"mappings":"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"}

package/build/ts/common/accountAbstraction.d.ts

@@ -0,0 +1,38 @@
+import { ESupportedChains } from "@maci-protocol/sdk";
+import { type Hex } from "viem";
+import type { BundlerClientType, KernelClientType, PublicClientHTTPType } from "./types";
+/**
+ * Get a public client
+ *
+ * @param chainName - the name of the chain to use
+ * @returns the public client
+ */
+export declare const getPublicClient: (chainName: ESupportedChains) => Promise<PublicClientHTTPType>;
+/**
+ * Get the ZeroDev bundler RPC URL based on the network
+ *
+ * @param network - the network we are on
+ * @returns the ZeroDev bundler RPC URL
+ */
+export declare const getZeroDevBundlerRPCUrl: (network: ESupportedChains) => string;
+/**
+ * Get a bundler client
+ *
+ * @param chainName - the chain name
+ * @returns the bundler client
+ */
+export declare const getBundlerClient: (chainName: ESupportedChains) => BundlerClientType;
+/**
+ * The offset for the address in the contract creation event
+ */
+export declare const addressOffset = 26;
+/**
+ * Get a Kernel account handle given a session key
+ *
+ * @param sessionKey - the session key to use
+ * @param approval - the approval to the session key
+ * @param chain - the chain to use
+ * @returns the kernel client
+ */
+export declare const getKernelClient: (sessionKey: Hex, approval: string, chain: ESupportedChains) => Promise<KernelClientType>;
+//# sourceMappingURL=accountAbstraction.d.ts.map

package/build/ts/common/accountAbstraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountAbstraction.d.ts","sourceRoot":"","sources":["../../../ts/common/accountAbstraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,OAAO,EAA4B,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAI1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAQzF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,WAAW,gBAAgB,KAAG,OAAO,CAAC,oBAAoB,CAI5F,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,gBAAgB,KAAG,MAWnE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,gBAAgB,KAAG,iBAI3D,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,GAAG,EACf,UAAU,MAAM,EAChB,OAAO,gBAAgB,KACtB,OAAO,CAAC,gBAAgB,CA0B1B,CAAC"}

package/build/ts/common/accountAbstraction.js

@@ -0,0 +1,83 @@
+import { ESupportedChains } from "@maci-protocol/sdk";
+import { deserializePermissionAccount } from "@zerodev/permissions";
+import { toECDSASigner } from "@zerodev/permissions/signers";
+import { createKernelAccountClient } from "@zerodev/sdk";
+import { getEntryPoint, KERNEL_V3_1 } from "@zerodev/sdk/constants";
+import dotenv from "dotenv";
+import { createPublicClient, http } from "viem";
+import { createBundlerClient } from "viem/account-abstraction";
+import { privateKeyToAccount } from "viem/accounts";
+import { getRpcUrl } from "./chain";
+import { ErrorCodes } from "./errors";
+import { viemChain } from "./networks";
+dotenv.config();
+/**
+ * Get a public client
+ *
+ * @param chainName - the name of the chain to use
+ * @returns the public client
+ */
+export const getPublicClient = async (chainName) => createPublicClient({
+    transport: http(await getRpcUrl(chainName)),
+    chain: viemChain(chainName),
+});
+/**
+ * Get the ZeroDev bundler RPC URL based on the network
+ *
+ * @param network - the network we are on
+ * @returns the ZeroDev bundler RPC URL
+ */
+export const getZeroDevBundlerRPCUrl = (network) => {
+    switch (network) {
+        case ESupportedChains.OptimismSepolia:
+            return process.env.ZERODEV_BUNDLER_RPC_OP_SEPOLIA || "";
+        case ESupportedChains.Optimism:
+            return process.env.ZERODEV_BUNDLER_RPC_OP || "";
+        case ESupportedChains.Sepolia:
+            return process.env.ZERODEV_BUNDLER_RPC_SEPOLIA || "";
+        default:
+            throw new Error(ErrorCodes.UNSUPPORTED_NETWORK.toString());
+    }
+};
+/**
+ * Get a bundler client
+ *
+ * @param chainName - the chain name
+ * @returns the bundler client
+ */
+export const getBundlerClient = (chainName) => createBundlerClient({
+    transport: http(getZeroDevBundlerRPCUrl(chainName)),
+    chain: viemChain(chainName),
+});
+/**
+ * The offset for the address in the contract creation event
+ */
+export const addressOffset = 26;
+/**
+ * Get a Kernel account handle given a session key
+ *
+ * @param sessionKey - the session key to use
+ * @param approval - the approval to the session key
+ * @param chain - the chain to use
+ * @returns the kernel client
+ */
+export const getKernelClient = async (sessionKey, approval, chain) => {
+    const bundlerUrl = getZeroDevBundlerRPCUrl(chain);
+    const publicClient = await getPublicClient(chain);
+    // Using a stored private key
+    const sessionKeySigner = await toECDSASigner({
+        signer: privateKeyToAccount(sessionKey),
+    });
+    try {
+        const sessionKeyAccount = await deserializePermissionAccount(publicClient, getEntryPoint("0.7"), KERNEL_V3_1, approval, sessionKeySigner);
+        return createKernelAccountClient({
+            bundlerTransport: http(bundlerUrl),
+            account: sessionKeyAccount,
+            chain: viemChain(chain),
+        });
+    }
+    catch (error) {
+        throw new Error(ErrorCodes.INVALID_APPROVAL.toString());
+    }
+};
+//# sourceMappingURL=accountAbstraction.js.map

package/build/ts/common/accountAbstraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountAbstraction.js","sourceRoot":"","sources":["../../../ts/common/accountAbstraction.ts"],"names":[],"mappings":"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"}

package/build/ts/common/chain.d.ts

@@ -0,0 +1,22 @@
+import { ESupportedChains } from "@maci-protocol/sdk";
+import { type HDNodeWallet, type Signer, Wallet } from "ethers";
+/**
+ * Get the RPC url for the chain we need to interact with
+ *
+ * @param network - the network we want to interact with
+ * @returns the RPC url for the network
+ */
+export declare const getRpcUrl: (network: ESupportedChains) => Promise<string>;
+/**
+ * Get wallet from private key or mnemonic env variable
+ *
+ * @returns wallet
+ */
+export declare const getWallet: () => Wallet | HDNodeWallet;
+/**
+ * Get a Ethers Signer given a chain and private key
+ * @param chain
+ * @returns
+ */
+export declare const getSigner: (chain: ESupportedChains) => Promise<Signer>;
+//# sourceMappingURL=chain.d.ts.map

package/build/ts/common/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../ts/common/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,MAAM,EAAmB,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIjF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAYzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,YACoE,CAAC;AAE3G;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAU,OAAO,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAOvE,CAAC"}

package/build/ts/common/chain.js

@@ -0,0 +1,37 @@
+import { ESupportedChains } from "@maci-protocol/sdk";
+import { JsonRpcProvider, Wallet } from "ethers";
+import { ErrorCodes } from "./errors";
+/**
+ * Get the RPC url for the chain we need to interact with
+ *
+ * @param network - the network we want to interact with
+ * @returns the RPC url for the network
+ */
+export const getRpcUrl = async (network) => {
+    const rpcUrl = process.env.COORDINATOR_RPC_URL;
+    if (!rpcUrl) {
+        return Promise.reject(new Error(ErrorCodes.COORDINATOR_RPC_URL_NOT_SET.toString()));
+    }
+    if (!Object.values(ESupportedChains).includes(network)) {
+        return Promise.reject(new Error(ErrorCodes.UNSUPPORTED_NETWORK.toString()));
+    }
+    return Promise.resolve(rpcUrl);
+};
+/**
+ * Get wallet from private key or mnemonic env variable
+ *
+ * @returns wallet
+ */
+export const getWallet = () => process.env.PRIVATE_KEY ? new Wallet(process.env.PRIVATE_KEY) : Wallet.fromPhrase(process.env.MNEMONIC);
+/**
+ * Get a Ethers Signer given a chain and private key
+ * @param chain
+ * @returns
+ */
+export const getSigner = async (chain) => {
+    const wallet = getWallet();
+    const alchemyRpcUrl = await getRpcUrl(chain);
+    const provider = new JsonRpcProvider(alchemyRpcUrl);
+    return wallet.connect(provider);
+};
+//# sourceMappingURL=chain.js.map

package/build/ts/common/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../ts/common/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAkC,eAAe,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAyB,EAAmB,EAAE;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAE/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,2BAA2B,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAA0B,EAAE,CACnD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,QAAS,CAAC,CAAC;AAE3G;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAuB,EAAmB,EAAE;IAC1E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;IAEpD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/build/ts/common/coordinatorKeypair.d.ts

@@ -0,0 +1,7 @@
+import { Keypair } from "@maci-protocol/domainobjs";
+/**
+ * Instantiate the MACI Coordinator keypair.
+ * @returns {Keypair} - The MACI Coordinator keypair.
+ */
+export declare const getCoordinatorKeypair: () => Keypair;
+//# sourceMappingURL=coordinatorKeypair.d.ts.map

package/build/ts/common/coordinatorKeypair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinatorKeypair.d.ts","sourceRoot":"","sources":["../../../ts/common/coordinatorKeypair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,2BAA2B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,OAUxC,CAAC"}

package/build/ts/common/coordinatorKeypair.js

@@ -0,0 +1,14 @@
+import { Keypair, PrivateKey } from "@maci-protocol/domainobjs";
+/**
+ * Instantiate the MACI Coordinator keypair.
+ * @returns {Keypair} - The MACI Coordinator keypair.
+ */
+export const getCoordinatorKeypair = () => {
+    const privateKey = String(process.env.COORDINATOR_MACI_PRIVATE_KEY);
+    if (!privateKey) {
+        throw new Error("COORDINATOR_MACI_PRIVATE_KEY environment variable is not set.");
+    }
+    const maciPrivateKey = PrivateKey.deserialize(privateKey);
+    return new Keypair(maciPrivateKey);
+};
+//# sourceMappingURL=coordinatorKeypair.js.map

package/build/ts/common/coordinatorKeypair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinatorKeypair.js","sourceRoot":"","sources":["../../../ts/common/coordinatorKeypair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,EAAE;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAEpE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE1D,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC,CAAC"}

package/build/ts/common/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Error codes that are used for api responses
+ */
+export declare enum ErrorCodes {
+    NOT_MERGED_STATE_TREE = 0,
+    PRIVATE_KEY_MISMATCH = 1,
+    POLL_NOT_FOUND = 2,
+    DECRYPTION = 3,
+    ENCRYPTION = 4,
+    FILE_NOT_FOUND = 5,
+    SUBGRAPH_DEPLOY = 6,
+    SUBGRAPH_DEPLOY_KEY_NOT_FOUND = 7,
+    SESSION_KEY_NOT_FOUND = 8,
+    INVALID_APPROVAL = 9,
+    UNSUPPORTED_NETWORK = 10,
+    COORDINATOR_RPC_URL_NOT_SET = 11,
+    FAILED_TO_MERGE_STATE_TREE = 12,
+    FAILED_TO_MERGE_MESSAGE_SUBTREES = 13,
+    FAILED_TO_MERGE_MESSAGE_TREE = 14,
+    UNSUPPORTED_VOICE_CREDIT_PROXY_FACTORY = 15,
+    UNSUPPORTED_VOICE_CREDIT_PROXY = 16,
+    UNSUPPORTED_POLICY = 17,
+    FAILED_TO_DEPLOY_CONTRACT = 18,
+    FAILED_TO_SET_MACI_INSTANCE_ON_POLICY = 19,
+    MACI_NOT_DEPLOYED = 20,
+    VERIFIER_NOT_DEPLOYED = 21,
+    VERIFYING_KEYS_REGISTRY_NOT_DEPLOYED = 22,
+    FAILED_TO_SET_VERIFYING_KEYS = 23,
+    FAILED_TO_DEPLOY_MACI = 24,
+    FAILED_TO_DEPLOY_POLL = 25,
+    NOT_MERGED_MESSAGE_TREE = 26,
+    FAILED_TO_UPDATE_SCHEDULED_POLL = 27,
+    POLL_ALREADY_SCHEDULED = 28,
+    POLL_ALREADY_TALLIED = 29
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/ts/common/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../ts/common/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,UAAU;IACpB,qBAAqB,IAAA;IACrB,oBAAoB,IAAA;IACpB,cAAc,IAAA;IACd,UAAU,IAAA;IACV,UAAU,IAAA;IACV,cAAc,IAAA;IACd,eAAe,IAAA;IACf,6BAA6B,IAAA;IAC7B,qBAAqB,IAAA;IACrB,gBAAgB,IAAA;IAChB,mBAAmB,KAAA;IACnB,2BAA2B,KAAA;IAC3B,0BAA0B,KAAA;IAC1B,gCAAgC,KAAA;IAChC,4BAA4B,KAAA;IAC5B,sCAAsC,KAAA;IACtC,8BAA8B,KAAA;IAC9B,kBAAkB,KAAA;IAClB,yBAAyB,KAAA;IACzB,qCAAqC,KAAA;IACrC,iBAAiB,KAAA;IACjB,qBAAqB,KAAA;IACrB,oCAAoC,KAAA;IACpC,4BAA4B,KAAA;IAC5B,qBAAqB,KAAA;IACrB,qBAAqB,KAAA;IACrB,uBAAuB,KAAA;IACvB,+BAA+B,KAAA;IAC/B,sBAAsB,KAAA;IACtB,oBAAoB,KAAA;CACrB"}