@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.3

package/build/src/aa/create-aa-client.js

@@ -0,0 +1,115 @@
+import { createPublicClient, http, } from "viem";
+import { entryPoint07Address } from "viem/account-abstraction";
+import { privateKeyToAccount } from "viem/accounts";
+import { createSmartAccountClient } from "permissionless";
+import { toSimpleSmartAccount } from "permissionless/accounts";
+import { CHAIN, DEFAULT_RPC_URL } from "../config/chains.js";
+import { GasSponsorshipService } from "./gas-sponsorship.js";
+import { preparedStepsToUserOpCalls } from "./prepared-calls.js";
+function resolveOwner(owner) {
+    if (typeof owner === "string") {
+        return privateKeyToAccount(owner);
+    }
+    return owner;
+}
+function defaultPublicClient() {
+    return createPublicClient({
+        chain: CHAIN,
+        transport: http(DEFAULT_RPC_URL),
+    });
+}
+/**
+ * Derive the counterfactual Simple Smart Account address for an EOA owner
+ * (EntryPoint 0.7) without submitting a UserOp.
+ */
+export async function deriveSmartAccountAddress(owner, publicClient) {
+    const eoaAccount = resolveOwner(owner);
+    const client = publicClient ?? defaultPublicClient();
+    const smartAccount = await toSimpleSmartAccount({
+        client,
+        owner: eoaAccount,
+        entryPoint: {
+            address: entryPoint07Address,
+            version: "0.7",
+        },
+    });
+    return {
+        eoaAddress: eoaAccount.address,
+        smartAccountAddress: smartAccount.address,
+    };
+}
+/**
+ * Create an ERC-4337 AA client on Celo mainnet (Simple Smart Account, EntryPoint 0.7).
+ *
+ * Pass an explicit `gasSponsorship` provider object — credentials are app-owned
+ * and never stored by Celina. v1 supports `provider: "pimlico"`.
+ *
+ * Optional `attributionTags` are applied in `sendPreparedFlow` via
+ * `appendCelinaCalldataTag` (same dual format as `prepare*`). Omit them to
+ * pass step calldata through unchanged.
+ */
+export async function createAAClient(options) {
+    const eoaAccount = resolveOwner(options.owner);
+    const publicClient = options.publicClient ?? defaultPublicClient();
+    const attributionTags = options.attributionTags;
+    const gasSponsorship = new GasSponsorshipService(options.gasSponsorship, CHAIN.id);
+    const smartAccount = await toSimpleSmartAccount({
+        client: publicClient,
+        owner: eoaAccount,
+        entryPoint: {
+            address: entryPoint07Address,
+            version: "0.7",
+        },
+    });
+    const paymaster = gasSponsorship.getPaymasterClient();
+    const smartAccountClient = createSmartAccountClient({
+        account: smartAccount,
+        chain: CHAIN,
+        bundlerTransport: gasSponsorship.createBundlerTransport(),
+        paymaster,
+        userOperation: {
+            estimateFeesPerGas: async () => gasSponsorship.estimateFeesPerGas(),
+        },
+    });
+    async function sendPreparedFlow(flow, sendOptions) {
+        const mode = sendOptions?.mode ?? "batch";
+        const calls = preparedStepsToUserOpCalls(flow.steps, attributionTags);
+        const userOpHashes = [];
+        const transactionHashes = [];
+        if (mode === "batch") {
+            const userOpHash = await smartAccountClient.sendUserOperation({ calls });
+            userOpHashes.push(userOpHash);
+            const receipt = await smartAccountClient.waitForUserOperationReceipt({
+                hash: userOpHash,
+            });
+            if (!receipt.success) {
+                return { mode, userOpHashes, transactionHashes, success: false };
+            }
+            transactionHashes.push(receipt.receipt.transactionHash);
+            return { mode, userOpHashes, transactionHashes, success: true };
+        }
+        for (const call of calls) {
+            const userOpHash = await smartAccountClient.sendUserOperation({
+                calls: [call],
+            });
+            userOpHashes.push(userOpHash);
+            const receipt = await smartAccountClient.waitForUserOperationReceipt({
+                hash: userOpHash,
+            });
+            if (!receipt.success) {
+                return { mode, userOpHashes, transactionHashes, success: false };
+            }
+            transactionHashes.push(receipt.receipt.transactionHash);
+        }
+        return { mode, userOpHashes, transactionHashes, success: true };
+    }
+    return {
+        provider: gasSponsorship.provider,
+        eoaAddress: eoaAccount.address,
+        smartAccountAddress: smartAccount.address,
+        gasSponsorship,
+        attributionTags,
+        sendPreparedFlow,
+    };
+}
+//# sourceMappingURL=create-aa-client.js.map

package/build/src/aa/create-aa-client.js.map

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

package/build/src/aa/gas-sponsorship.d.ts

@@ -0,0 +1,27 @@
+import { type Transport } from "viem";
+import { createPimlicoClient } from "permissionless/clients/pimlico";
+import type { GasSponsorshipConfig, GasSponsorshipProviderId } from "./types.js";
+type PimlicoClient = ReturnType<typeof createPimlicoClient>;
+/**
+ * Provider-agnostic gas sponsorship wiring (bundler URL, paymaster, fees).
+ * v1 supports `provider: "pimlico"`; add branches for future providers without renaming this type.
+ */
+export declare class GasSponsorshipService {
+    readonly provider: GasSponsorshipProviderId;
+    private readonly config;
+    private readonly chainId;
+    private pimlicoClient;
+    constructor(config: GasSponsorshipConfig, chainId?: number);
+    /** Bundler / paymaster JSON-RPC URL for the configured provider and chain. */
+    getRpcUrl(chainId?: number): string;
+    /** viem transport pointed at the sponsorship backend RPC. */
+    createBundlerTransport(): Transport;
+    /** Provider client used as paymaster (and fee oracle in v1). */
+    getPaymasterClient(): PimlicoClient;
+    /** Fee fields for UserOp construction. */
+    estimateFeesPerGas(): Promise<{
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }>;
+}
+export {};

package/build/src/aa/gas-sponsorship.js

@@ -0,0 +1,65 @@
+import { http } from "viem";
+import { entryPoint07Address } from "viem/account-abstraction";
+import { createPimlicoClient } from "permissionless/clients/pimlico";
+import { CHAIN } from "../config/chains.js";
+/**
+ * Provider-agnostic gas sponsorship wiring (bundler URL, paymaster, fees).
+ * v1 supports `provider: "pimlico"`; add branches for future providers without renaming this type.
+ */
+export class GasSponsorshipService {
+    provider;
+    config;
+    chainId;
+    pimlicoClient = null;
+    constructor(config, chainId = CHAIN.id) {
+        this.config = config;
+        this.provider = config.provider;
+        this.chainId = chainId;
+        if (config.provider === "pimlico") {
+            const key = config.pimlico.apiKey?.trim();
+            if (!key) {
+                throw new Error("gasSponsorship.pimlico.apiKey is required when provider is \"pimlico\"");
+            }
+        }
+    }
+    /** Bundler / paymaster JSON-RPC URL for the configured provider and chain. */
+    getRpcUrl(chainId = this.chainId) {
+        if (this.config.provider === "pimlico") {
+            const apiKey = this.config.pimlico.apiKey.trim();
+            return `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}`;
+        }
+        const _exhaustive = this.config.provider;
+        throw new Error(`Unsupported gas sponsorship provider: ${String(_exhaustive)}`);
+    }
+    /** viem transport pointed at the sponsorship backend RPC. */
+    createBundlerTransport() {
+        return http(this.getRpcUrl());
+    }
+    /** Provider client used as paymaster (and fee oracle in v1). */
+    getPaymasterClient() {
+        if (this.config.provider !== "pimlico") {
+            const _exhaustive = this.config.provider;
+            throw new Error(`Unsupported gas sponsorship provider: ${String(_exhaustive)}`);
+        }
+        if (!this.pimlicoClient) {
+            this.pimlicoClient = createPimlicoClient({
+                transport: this.createBundlerTransport(),
+                entryPoint: {
+                    address: entryPoint07Address,
+                    version: "0.7",
+                },
+            });
+        }
+        return this.pimlicoClient;
+    }
+    /** Fee fields for UserOp construction. */
+    async estimateFeesPerGas() {
+        if (this.config.provider === "pimlico") {
+            const prices = await this.getPaymasterClient().getUserOperationGasPrice();
+            return prices.fast;
+        }
+        const _exhaustive = this.config.provider;
+        throw new Error(`Unsupported gas sponsorship provider: ${String(_exhaustive)}`);
+    }
+}
+//# sourceMappingURL=gas-sponsorship.js.map

package/build/src/aa/gas-sponsorship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-sponsorship.js","sourceRoot":"","sources":["../../../src/aa/gas-sponsorship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAK5C;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAA2B;IAC3B,MAAM,CAAuB;IAC7B,OAAO,CAAS;IACzB,aAAa,GAAyB,IAAI,CAAC;IAEnD,YAAY,MAA4B,EAAE,UAAkB,KAAK,CAAC,EAAE;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,SAAS,CAAC,UAAkB,IAAI,CAAC,OAAO;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,6BAA6B,OAAO,eAAe,MAAM,EAAE,CAAC;QACrE,CAAC;QACD,MAAM,WAAW,GAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,6DAA6D;IAC7D,sBAAsB;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,gEAAgE;IAChE,kBAAkB;QAChB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,WAAW,GAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,mBAAmB,CAAC;gBACvC,SAAS,EAAE,IAAI,CAAC,sBAAsB,EAAE;gBACxC,UAAU,EAAE;oBACV,OAAO,EAAE,mBAAmB;oBAC5B,OAAO,EAAE,KAAK;iBACf;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,kBAAkB;QAItB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,wBAAwB,EAAE,CAAC;YAC1E,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,MAAM,WAAW,GAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}

package/build/src/aa/index.d.ts

@@ -0,0 +1,4 @@
+export { createAAClient, deriveSmartAccountAddress, type AAClient } from "./create-aa-client.js";
+export { GasSponsorshipService } from "./gas-sponsorship.js";
+export { preparedStepsToUserOpCalls } from "./prepared-calls.js";
+export type { CreateAAClientOptions, GasSponsorshipConfig, GasSponsorshipProviderId, PimlicoGasSponsorshipConfig, SendPreparedFlowMode, SendPreparedFlowOptions, SendPreparedFlowResult, UserOpCall, } from "./types.js";

package/build/src/aa/index.js

@@ -0,0 +1,4 @@
+export { createAAClient, deriveSmartAccountAddress } from "./create-aa-client.js";
+export { GasSponsorshipService } from "./gas-sponsorship.js";
+export { preparedStepsToUserOpCalls } from "./prepared-calls.js";
+//# sourceMappingURL=index.js.map

package/build/src/aa/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/aa/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAiB,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/build/src/aa/prepared-calls.d.ts

@@ -0,0 +1,8 @@
+import type { PreparedTx } from "../types/prepared.js";
+import type { UserOpCall } from "./types.js";
+/**
+ * Map Celina prepared steps to smart-account `calls`.
+ * When `attributionTags` is provided, each step's `data` is dual-tagged
+ * via {@link appendCelinaCalldataTag}; otherwise `data` is preserved as-is.
+ */
+export declare function preparedStepsToUserOpCalls(steps: PreparedTx[], attributionTags?: string[]): UserOpCall[];

package/build/src/aa/prepared-calls.js

@@ -0,0 +1,27 @@
+import { appendCelinaCalldataTag } from "../config/celina-tag.js";
+/**
+ * Map Celina prepared steps to smart-account `calls`.
+ * When `attributionTags` is provided, each step's `data` is dual-tagged
+ * via {@link appendCelinaCalldataTag}; otherwise `data` is preserved as-is.
+ */
+export function preparedStepsToUserOpCalls(steps, attributionTags) {
+    if (!steps.length) {
+        throw new Error("prepared flow has no steps");
+    }
+    const shouldTag = attributionTags !== undefined;
+    return steps.map((step) => {
+        const value = step.value !== undefined && step.value !== ""
+            ? BigInt(step.value)
+            : undefined;
+        let data = step.data;
+        if (shouldTag && data !== undefined) {
+            data = appendCelinaCalldataTag(data, attributionTags);
+        }
+        return {
+            to: step.to,
+            ...(data !== undefined ? { data } : {}),
+            ...(value !== undefined && value > 0n ? { value } : {}),
+        };
+    });
+}
+//# sourceMappingURL=prepared-calls.js.map

package/build/src/aa/prepared-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-calls.js","sourceRoot":"","sources":["../../../src/aa/prepared-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIlE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAmB,EACnB,eAA0B;IAE1B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,KAAK,SAAS,CAAC;IAChD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE;YAC3C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/build/src/aa/types.d.ts

@@ -0,0 +1,61 @@
+import type { Hex, PrivateKeyAccount, PublicClient } from "viem";
+/** Supported gas sponsorship backends. Extends with new union members over time. */
+export type GasSponsorshipProviderId = "pimlico";
+/** Pimlico-specific credentials (app-owned; never stored by Celina). */
+export type PimlicoGasSponsorshipConfig = {
+    /** App-owned Pimlico API key. */
+    apiKey: string;
+};
+/**
+ * Explicit gas sponsorship config for {@link createAAClient}.
+ * Discriminant `provider` selects which nested object is required.
+ */
+export type GasSponsorshipConfig = {
+    provider: "pimlico";
+    pimlico: PimlicoGasSponsorshipConfig;
+};
+/**
+ * Options for {@link createAAClient}.
+ *
+ * Set `attributionTags` here for hand-built prepared steps (tagged at `sendPreparedFlow`).
+ * For `prepare*` flows, you can set the same tags on `createCelinaClient` instead —
+ * use one consistent list per send path so suffixes do not stack with mismatched tags.
+ */
+export type CreateAAClientOptions = {
+    /** EOA owner of the Simple Smart Account (account or private key hex). */
+    owner: PrivateKeyAccount | Hex;
+    /** Explicit sponsorship provider + credentials. */
+    gasSponsorship: GasSponsorshipConfig;
+    /** Optional Celo public client; defaults to Forno mainnet. */
+    publicClient?: PublicClient;
+    /**
+     * Optional custom tags applied via `appendCelinaCalldataTag` on each step's `data`
+     * in `sendPreparedFlow` (legacy `CELINA|…` + ERC-8021). When omitted, step data
+     * is passed through unchanged.
+     */
+    attributionTags?: string[];
+};
+/** How to map prepared transactions (`prepare*` output / ordered `steps`) into UserOperations. */
+export type SendPreparedFlowMode = "batch" | "sequential";
+export type SendPreparedFlowOptions = {
+    /**
+     * How to submit the prepared transactions (`steps`).
+     * `batch` (default): all steps in one UserOp.
+     * `sequential`: one UserOp per step.
+     */
+    mode?: SendPreparedFlowMode;
+};
+export type UserOpCall = {
+    to: `0x${string}`;
+    data?: `0x${string}`;
+    value?: bigint;
+};
+/** Result of submitting prepared transactions as sponsored UserOp(s). */
+export type SendPreparedFlowResult = {
+    mode: SendPreparedFlowMode;
+    /** UserOperation hash(es) submitted to the bundler. */
+    userOpHashes: `0x${string}`[];
+    /** Transaction hash(es) from UserOp receipt(s). */
+    transactionHashes: `0x${string}`[];
+    success: boolean;
+};

package/build/src/aa/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/src/aa/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/aa/types.ts"],"names":[],"mappings":""}

package/build/src/abis/aave-pool.d.ts

@@ -0,0 +1,37 @@
+export declare const aavePoolAbi: readonly [{
+    readonly type: "function";
+    readonly name: "supply";
+    readonly inputs: readonly [{
+        readonly name: "asset";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "onBehalfOf";
+        readonly type: "address";
+    }, {
+        readonly name: "referralCode";
+        readonly type: "uint16";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "withdraw";
+    readonly inputs: readonly [{
+        readonly name: "asset";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}];

package/build/src/abis/aave-pool.js

@@ -0,0 +1,26 @@
+export const aavePoolAbi = [
+    {
+        type: "function",
+        name: "supply",
+        inputs: [
+            { name: "asset", type: "address" },
+            { name: "amount", type: "uint256" },
+            { name: "onBehalfOf", type: "address" },
+            { name: "referralCode", type: "uint16" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "function",
+        name: "withdraw",
+        inputs: [
+            { name: "asset", type: "address" },
+            { name: "amount", type: "uint256" },
+            { name: "to", type: "address" },
+        ],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "nonpayable",
+    },
+];
+//# sourceMappingURL=aave-pool.js.map

package/build/src/abis/aave-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-pool.js","sourceRoot":"","sources":["../../../src/abis/aave-pool.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;YACvC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzC;QACD,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,YAAY;KAC9B;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;SAChC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACxC,eAAe,EAAE,YAAY;KAC9B;CACO,CAAC"}

package/build/src/abis/accounts.d.ts

@@ -0,0 +1,13 @@
+export declare const accountsAbi: readonly [{
+    readonly type: "function";
+    readonly name: "getName";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}];

package/build/src/abis/accounts.js

@@ -0,0 +1,10 @@
+export const accountsAbi = [
+    {
+        type: "function",
+        name: "getName",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "string" }],
+        stateMutability: "view",
+    },
+];
+//# sourceMappingURL=accounts.js.map

package/build/src/abis/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/abis/accounts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACvC,eAAe,EAAE,MAAM;KACxB;CACO,CAAC"}

package/build/src/abis/election.d.ts

@@ -0,0 +1,124 @@
+export declare const electionAbi: readonly [{
+    readonly type: "function";
+    readonly name: "getGroupsVotedForByAccount";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPendingVotesForGroupByAccount";
+    readonly inputs: readonly [{
+        readonly name: "group";
+        readonly type: "address";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getActiveVotesForGroupByAccount";
+    readonly inputs: readonly [{
+        readonly name: "group";
+        readonly type: "address";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "hasActivatablePendingVotes";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "group";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getEligibleValidatorGroups";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getActiveVotesForGroup";
+    readonly inputs: readonly [{
+        readonly name: "group";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getTotalVotesForEligibleValidatorGroups";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "groups";
+        readonly type: "address[]";
+    }, {
+        readonly name: "votes";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getTotalVotes";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getElectableValidators";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "min";
+        readonly type: "uint256";
+    }, {
+        readonly name: "max";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "canReceiveVotes";
+    readonly inputs: readonly [{
+        readonly name: "group";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];

package/build/src/abis/election.js

@@ -0,0 +1,88 @@
+export const electionAbi = [
+    {
+        type: "function",
+        name: "getGroupsVotedForByAccount",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "address[]" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getPendingVotesForGroupByAccount",
+        inputs: [
+            { name: "group", type: "address" },
+            { name: "account", type: "address" },
+        ],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getActiveVotesForGroupByAccount",
+        inputs: [
+            { name: "group", type: "address" },
+            { name: "account", type: "address" },
+        ],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "hasActivatablePendingVotes",
+        inputs: [
+            { name: "account", type: "address" },
+            { name: "group", type: "address" },
+        ],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getEligibleValidatorGroups",
+        inputs: [],
+        outputs: [{ name: "", type: "address[]" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getActiveVotesForGroup",
+        inputs: [{ name: "group", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getTotalVotesForEligibleValidatorGroups",
+        inputs: [],
+        outputs: [
+            { name: "groups", type: "address[]" },
+            { name: "votes", type: "uint256[]" },
+        ],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getTotalVotes",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "getElectableValidators",
+        inputs: [],
+        outputs: [
+            { name: "min", type: "uint256" },
+            { name: "max", type: "uint256" },
+        ],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "canReceiveVotes",
+        inputs: [{ name: "group", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+];
+//# sourceMappingURL=election.js.map