@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

package/build/src/clients/self-api.js

@@ -0,0 +1,242 @@
+import { SELF_API_BASE, SELF_API_NETWORK, SELF_CHAIN_ID, } from "../config/self.js";
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
+export class SelfApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SelfApiError";
+    }
+}
+export class SelfExpiredSessionError extends Error {
+    constructor(message = "Session expired. Start a new registration flow.") {
+        super(message);
+        this.name = "SelfExpiredSessionError";
+    }
+}
+function resolveApiBase(apiBase) {
+    return (apiBase ?? process.env.SELF_AGENT_API_BASE ?? SELF_API_BASE).replace(/\/+$/, "");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function apiFetch(url, init) {
+    const res = await fetch(url, init);
+    const body = (await res.json());
+    if (!res.ok) {
+        const errorMsg = typeof body.error === "string" ? body.error : `HTTP ${res.status}`;
+        throw new SelfApiError(errorMsg);
+    }
+    return body;
+}
+function sessionAuthHeaders(sessionToken) {
+    return { Authorization: `Bearer ${sessionToken}` };
+}
+async function fetchSessionStatus(apiBase, path, sessionToken) {
+    return apiFetch(`${apiBase}${path}?token=${encodeURIComponent(sessionToken)}`, { headers: sessionAuthHeaders(sessionToken) });
+}
+function handleSessionStatusError(error, expiredMessage) {
+    if (error instanceof SelfApiError &&
+        error.message.toLowerCase().includes("expired")) {
+        throw new SelfExpiredSessionError(expiredMessage);
+    }
+    throw error;
+}
+function optionalScanUrl(data) {
+    return typeof data.scanUrl === "string" ? data.scanUrl : undefined;
+}
+function buildRegistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        agentAddress: String(data.agentAddress),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/register/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Session expired. Start a new registration flow.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return {
+                        agentId: Number(status.agentId),
+                        agentAddress: String(status.agentAddress ?? data.agentAddress),
+                        credentials: status.credentials,
+                        txHash: typeof status.txHash === "string" ? status.txHash : undefined,
+                    };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Registration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError();
+                }
+            }
+            throw new SelfApiError(`Registration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+        async exportKey() {
+            const result = await apiFetch(`${apiBase}/api/agent/register/export`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...sessionAuthHeaders(currentToken),
+                },
+                body: JSON.stringify({ token: currentToken }),
+            });
+            return result.privateKey;
+        },
+    };
+}
+function buildRefreshSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/refresh/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    const expiresAtRaw = status.proofExpiresAt;
+                    const proofExpiresAt = typeof expiresAtRaw === "string" || typeof expiresAtRaw === "number"
+                        ? new Date(expiresAtRaw)
+                        : new Date(Date.now() + 365 * 24 * 60 * 60 * 1000);
+                    return { proofExpiresAt };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Proof refresh failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Proof refresh did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+function buildDeregistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/deregister/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return;
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Deregistration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Deregistration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+export async function requestRegistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const payload = {
+        mode: opts.mode ?? "wallet-free",
+        network: SELF_API_NETWORK,
+        disclosures: opts.disclosures,
+        humanAddress: opts.humanAddress,
+        agentName: opts.agentName,
+        agentDescription: opts.agentDescription,
+    };
+    const data = await apiFetch(`${base}/api/agent/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+    });
+    return buildRegistrationSession(data, base);
+}
+export async function requestDeregistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/deregister`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            network: SELF_API_NETWORK,
+            agentAddress: opts.agentAddress,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildDeregistrationSession(data, base);
+}
+export async function requestProofRefresh(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/refresh`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            agentId: opts.agentId,
+            network: SELF_API_NETWORK,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildRefreshSession(data, base);
+}
+export async function getAgentInfo(agentId, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/info/${SELF_CHAIN_ID}/${agentId}`);
+}
+export async function getAgentsForHuman(address, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/agents/${SELF_CHAIN_ID}/${address}`);
+}
+export function selfQrUrl(sessionToken, apiBase) {
+    return `${resolveApiBase(apiBase)}/scan/${sessionToken}`;
+}
+//# sourceMappingURL=self-api.js.map

package/build/src/clients/self-api.js.map

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

package/build/src/clients/uniswap-sdk.d.ts

@@ -0,0 +1,4 @@
+export declare const Actions: typeof import("@uniswap/v4-sdk").Actions, V4Planner: typeof import("@uniswap/v4-sdk").V4Planner;
+export declare const CommandType: typeof import("@uniswap/universal-router-sdk").CommandType, RoutePlanner: typeof import("@uniswap/universal-router-sdk").RoutePlanner;
+export declare const ChainId: typeof import("@uniswap/sdk-core").ChainId;
+export type { SwapExactInSingle, SwapExactIn } from "@uniswap/v4-sdk";

package/build/src/clients/uniswap-sdk.js

@@ -0,0 +1,13 @@
+/**
+ * CJS re-exports for @uniswap/v4-sdk and @uniswap/universal-router-sdk.
+ * Uses createRequire because upstream ESM builds omit .js extensions on internal imports.
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const v4Sdk = require("@uniswap/v4-sdk");
+const universalRouterSdk = require("@uniswap/universal-router-sdk");
+const sdkCore = require("@uniswap/sdk-core");
+export const { Actions, V4Planner } = v4Sdk;
+export const { CommandType, RoutePlanner } = universalRouterSdk;
+export const { ChainId } = sdkCore;
+//# sourceMappingURL=uniswap-sdk.js.map

package/build/src/clients/uniswap-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-sdk.js","sourceRoot":"","sources":["../../../src/clients/uniswap-sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAqC,CAAC;AAC7E,MAAM,kBAAkB,GACtB,OAAO,CAAC,+BAA+B,CAAmD,CAAC;AAC7F,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;AAEnF,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC;AAChE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC"}

package/build/src/config/aave.d.ts

@@ -0,0 +1,17 @@
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export declare const AAVE_POOL: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export declare const AAVE_CHAIN_ID = 42220;
+/** Underlying and aToken addresses for one Aave V3 market on Celo. */
+export type AaveAsset = {
+    symbol: string;
+    underlying: `0x${string}`;
+    aToken: `0x${string}`;
+};
+export declare const AAVE_ASSETS: Record<string, AaveAsset>;
+export declare const AAVE_SUPPORTED_SYMBOLS: readonly ["USDT", "WETH", "USDm", "USDC", "CELO", "EURm"];
+/**
+ * Resolve an Aave V3 Celo asset by symbol or underlying/aToken address.
+ * @param token - Registry symbol or hex address
+ * @throws When the token is not listed in `AAVE_SUPPORTED_SYMBOLS`
+ */
+export declare function resolveAaveAsset(token: string): AaveAsset;

package/build/src/config/aave.js

@@ -0,0 +1,77 @@
+/**
+ * Aave V3 Celo mainnet pool addresses and supported asset registry.
+ */
+import { findKnownToken } from "./chains.js";
+const HEX_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export const AAVE_POOL = "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export const AAVE_CHAIN_ID = 42220;
+export const AAVE_ASSETS = {
+    USDT: {
+        symbol: "USDT",
+        underlying: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+        aToken: "0xDeE98402A302e4D707fB9bf2bac66fAEEc31e8Df",
+    },
+    WETH: {
+        symbol: "WETH",
+        underlying: "0xD221812de1BD094f35587EE8E174B07B6167D9Af",
+        aToken: "0xf385280F36e009C157697D25E0B802EfaBfd789c",
+    },
+    USDm: {
+        symbol: "USDm",
+        underlying: "0x765DE816845861e75A25fCA122bb6898B8B1282a",
+        aToken: "0xBba98352628B0B0c4b40583F593fFCb630935a45",
+    },
+    USDC: {
+        symbol: "USDC",
+        underlying: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+        aToken: "0xFF8309b9e99bfd2D4021bc71a362aBD93dBd4785",
+    },
+    CELO: {
+        symbol: "CELO",
+        underlying: "0x471EcE3750Da237f93B8E339c536989b8978a438",
+        aToken: "0xC3e77dC389537Db1EEc7C33B95Cf3beECA71A209",
+    },
+    EURm: {
+        symbol: "EURm",
+        underlying: "0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73",
+        aToken: "0x34c02571094e08E935B8cf8dC10F1Ad6795f1f81",
+    },
+};
+export const AAVE_SUPPORTED_SYMBOLS = [
+    "USDT",
+    "WETH",
+    "USDm",
+    "USDC",
+    "CELO",
+    "EURm",
+];
+/**
+ * Resolve an Aave V3 Celo asset by symbol or underlying/aToken address.
+ * @param token - Registry symbol or hex address
+ * @throws When the token is not listed in `AAVE_SUPPORTED_SYMBOLS`
+ */
+export function resolveAaveAsset(token) {
+    const normalized = token.trim();
+    const known = findKnownToken(normalized);
+    if (known) {
+        const byKnownSymbol = AAVE_ASSETS[known.symbol];
+        if (byKnownSymbol) {
+            return byKnownSymbol;
+        }
+    }
+    if (HEX_ADDRESS_RE.test(normalized)) {
+        const lower = normalized.toLowerCase();
+        const byAddress = Object.values(AAVE_ASSETS).find((asset) => asset.underlying.toLowerCase() === lower ||
+            asset.aToken.toLowerCase() === lower);
+        if (byAddress) {
+            return byAddress;
+        }
+    }
+    const bySymbol = Object.values(AAVE_ASSETS).find((asset) => asset.symbol.toLowerCase() === normalized.toLowerCase());
+    if (bySymbol) {
+        return bySymbol;
+    }
+    throw new Error(`Token "${token}" is not supported on Aave V3 Celo. Supported: ${AAVE_SUPPORTED_SYMBOLS.join(", ")}.`);
+}
+//# sourceMappingURL=aave.js.map

package/build/src/config/aave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.js","sourceRoot":"","sources":["../../../src/config/aave.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,4CAAqD,CAAC;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AASnC,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,KAAK;YACxC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CACvC,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CACnE,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,kDAAkD,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtG,CAAC;AACJ,CAAC"}

package/build/src/config/celina-tag.d.ts

@@ -0,0 +1,4 @@
+/** Calldata suffix appended to prepared transactions for on-chain Celina attribution. */
+export declare const CELINA_DATA_SUFFIX: `0x${string}`;
+/** Append CELINA suffix to calldata; no-op when empty or already tagged. */
+export declare function appendCelinaCalldataTag(data: `0x${string}`): `0x${string}`;

package/build/src/config/celina-tag.js

@@ -0,0 +1,13 @@
+import { concat, stringToHex } from "viem";
+/** Calldata suffix appended to prepared transactions for on-chain Celina attribution. */
+export const CELINA_DATA_SUFFIX = stringToHex("CELINA");
+/** Append CELINA suffix to calldata; no-op when empty or already tagged. */
+export function appendCelinaCalldataTag(data) {
+    if (!data || data === "0x")
+        return data;
+    const suffix = CELINA_DATA_SUFFIX.slice(2);
+    if (data.toLowerCase().endsWith(suffix.toLowerCase()))
+        return data;
+    return concat([data, CELINA_DATA_SUFFIX]);
+}
+//# sourceMappingURL=celina-tag.js.map

package/build/src/config/celina-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celina-tag.js","sourceRoot":"","sources":["../../../src/config/celina-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAE3C,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAExD,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,IAAmB;IACzD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/build/src/config/celo-core-contracts.d.ts

@@ -0,0 +1,8 @@
+/** Celo mainnet core contract addresses (Election, Governance, etc.). */
+export declare const CELO_CORE_CONTRACTS: {
+    readonly governance: "0xD533Ca259b330c7A88f74E000a3FaEa2d63B7972";
+    readonly election: "0x8D6677192144292870907E3Fa8A5527fE55A7ff6";
+    readonly validators: "0xaEb865bCa93DdC8F47b8e29F40C5399cE34d0C58";
+    readonly accounts: "0x7d21685C17607338b313a7174bAb6620baD0aaB7";
+    readonly lockedGold: "0x6cC083Aed9e3ebe302A6336dBC7c921C9f03349E";
+};

package/build/src/config/celo-core-contracts.js

@@ -0,0 +1,9 @@
+/** Celo mainnet core contract addresses (Election, Governance, etc.). */
+export const CELO_CORE_CONTRACTS = {
+    governance: "0xD533Ca259b330c7A88f74E000a3FaEa2d63B7972",
+    election: "0x8D6677192144292870907E3Fa8A5527fE55A7ff6",
+    validators: "0xaEb865bCa93DdC8F47b8e29F40C5399cE34d0C58",
+    accounts: "0x7d21685C17607338b313a7174bAb6620baD0aaB7",
+    lockedGold: "0x6cC083Aed9e3ebe302A6336dBC7c921C9f03349E",
+};
+//# sourceMappingURL=celo-core-contracts.js.map

package/build/src/config/celo-core-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-core-contracts.js","sourceRoot":"","sources":["../../../src/config/celo-core-contracts.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,UAAU,EAAE,4CAA4C;CAChD,CAAC"}