@ezeonlabs/polestar 0.0.0-stage → 0.1.0

package/dist/client.js

@@ -0,0 +1,249 @@
+import { DEFAULT_COUNTING_STEPS, polestarCalls } from "./calls.js";
+import { classifySendError, readOutcome } from "./errors.js";
+import { canSubmit, canVote, governanceCalls, proposalBond, } from "./governance.js";
+import { rpcBlock, rpcView } from "./rpc.js";
+import { contractJson, toId, toU128 } from "./serialization.js";
+export const DEFAULT_TESTNET_RPC = "https://test.rpc.fastnear.com";
+export function mapRound(raw) {
+    return {
+        id: toId(raw.id, "round id"),
+        config: {
+            budget: toU128(raw.config.budget),
+            opensAt: toId(raw.config.opens_at, "opens_at"),
+            closesAt: toId(raw.config.closes_at, "closes_at"),
+            tMin: toId(raw.config.t_min, "t_min"),
+        },
+        phase: raw.phase,
+        remaining: toU128(raw.remaining),
+        remainingReturned: raw.remaining_returned ?? false,
+        voterNamespace: raw.voter_namespace ?? null,
+        projectCount: toId(raw.project_count, "project_count"),
+        ballotCount: toId(raw.ballot_count, "ballot_count"),
+    };
+}
+export function mapProject(raw) {
+    return {
+        id: toId(raw.id, "project id"),
+        proposer: raw.proposer,
+        recipient: raw.recipient,
+        title: raw.title,
+        summary: raw.summary,
+        cost: toU128(raw.cost),
+        milestones: raw.milestones.map((m) => ({ amount: toU128(m.amount), attested: m.attested })),
+        status: raw.status,
+    };
+}
+export function mapAllocationResult(raw) {
+    return {
+        budget: toU128(raw.budget),
+        funded: raw.funded.map((f) => ({ project: toId(f.project, "project id"), stage: f.stage, amount: toU128(f.amount) })),
+        unfunded: raw.unfunded.map((id) => toId(id, "project id")),
+        remaining: toU128(raw.remaining),
+    };
+}
+export async function sendTransaction(signer, transaction) {
+    let raw;
+    try {
+        raw = await signer.signAndSendTransaction({
+            receiverId: transaction.receiverId,
+            actions: [
+                {
+                    type: "FunctionCall",
+                    params: {
+                        methodName: transaction.method,
+                        args: new TextEncoder().encode(contractJson(transaction.args)),
+                        gas: transaction.gas.toString(),
+                        deposit: transaction.deposit.toString(),
+                    },
+                },
+            ],
+        });
+    }
+    catch (error) {
+        throw classifySendError(error);
+    }
+    return readOutcome((raw ?? {}));
+}
+export class PolestarClient {
+    contractId;
+    daoId;
+    calls;
+    governance;
+    viewFn;
+    blockFn;
+    constructor(options) {
+        const rpcUrl = options.rpcUrl ?? DEFAULT_TESTNET_RPC;
+        this.contractId = options.contractId;
+        this.daoId = options.daoId;
+        this.viewFn = options.view ?? rpcView(rpcUrl, options.fetch);
+        this.blockFn = options.block ?? rpcBlock(rpcUrl, options.fetch);
+        this.calls = polestarCalls(options.contractId);
+        this.governance = new PolestarGovernanceReader(this);
+    }
+    view(method, args = {}, contractId = this.contractId) {
+        return this.viewFn(method, args, contractId);
+    }
+    async getRoundCount() {
+        return toId(await this.view("get_round_count"), "round count");
+    }
+    async getRound(roundId) {
+        const raw = await this.view("get_round", { round_id: toId(roundId, "round id") });
+        return raw ? mapRound(raw) : null;
+    }
+    async getRoundPhase(roundId) {
+        return (await this.view("get_round_phase", { round_id: toId(roundId, "round id") })) ?? null;
+    }
+    async getProjects(roundId) {
+        const raw = await this.view("get_projects", { round_id: toId(roundId, "round id") });
+        return raw.map(mapProject);
+    }
+    async getProject(roundId, projectId) {
+        const raw = await this.view("get_project", {
+            round_id: toId(roundId, "round id"),
+            project_id: toId(projectId, "project id"),
+        });
+        return raw ? mapProject(raw) : null;
+    }
+    async getProjectSupport(roundId, projectId) {
+        const raw = await this.view("get_project_support", {
+            round_id: toId(roundId, "round id"),
+            project_id: toId(projectId, "project id"),
+        });
+        return toId(raw, "support count");
+    }
+    async getBallot(roundId, voter) {
+        const raw = await this.view("get_ballot", {
+            round_id: toId(roundId, "round id"),
+            voter,
+        });
+        return raw ? { voter: raw.voter, approved: raw.approved.map((id) => toId(id, "project id")) } : null;
+    }
+    async getFirstSeen(accountId) {
+        const raw = await this.view("get_first_seen", { account_id: accountId });
+        return raw === null || raw === undefined ? null : toId(raw, "block height");
+    }
+    async getAllocationResult(roundId) {
+        const raw = await this.view("get_allocation_result", { round_id: toId(roundId, "round id") });
+        return raw ? mapAllocationResult(raw) : null;
+    }
+    async getRemaining(roundId) {
+        const raw = await this.view("get_remaining", { round_id: toId(roundId, "round id") });
+        return raw === null || raw === undefined ? null : toU128(raw);
+    }
+    getBlock(ref = "final") {
+        return this.blockFn(ref);
+    }
+    async getChainClock(sampleSpan = 1_000) {
+        const head = await this.blockFn("final");
+        const past = await this.blockFn(head.height - sampleSpan).catch(() => null);
+        const msPerBlock = past ? (head.timestampMs - past.timestampMs) / (head.height - past.height) : null;
+        return { ...head, msPerBlock: msPerBlock && msPerBlock > 0 ? msPerBlock : null };
+    }
+    withSigner(signer) {
+        return new PolestarWriter(this, signer);
+    }
+}
+export class PolestarGovernanceReader {
+    calls;
+    client;
+    constructor(client) {
+        this.client = client;
+        this.calls = governanceCalls(client.daoId, client.contractId);
+    }
+    getPolicy() {
+        return this.client.view("get_policy", {}, this.client.daoId);
+    }
+    async getOpenProposals(window = 50) {
+        const last = toId(await this.client.view("get_last_proposal_id", {}, this.client.daoId), "proposal id");
+        const from = Math.max(0, last - window);
+        const proposals = await this.client.view("get_proposals", { from_index: from, limit: window }, this.client.daoId);
+        return proposals
+            .filter((p) => p.status === "InProgress" && p.kind.FunctionCall?.receiver_id === this.client.contractId)
+            .sort((a, b) => b.id - a.id);
+    }
+    async canSubmit(accountId) {
+        return canSubmit(await this.getPolicy(), accountId);
+    }
+    async canVote(accountId) {
+        return canVote(await this.getPolicy(), accountId);
+    }
+}
+export class PolestarWriter {
+    client;
+    signer;
+    governance;
+    constructor(client, signer) {
+        this.client = client;
+        this.signer = signer;
+        this.governance = new PolestarGovernanceWriter(this);
+    }
+    send(transaction) {
+        return sendTransaction(this.signer, transaction);
+    }
+    registerVoter() {
+        return this.send(this.client.calls.registerVoter());
+    }
+    async registerProject(input) {
+        const outcome = await this.send(this.client.calls.registerProject(input));
+        return { projectId: toId(outcome.value, "project id"), outcome };
+    }
+    submitBallot(roundId, projectIds) {
+        return this.send(this.client.calls.submitBallot(roundId, projectIds));
+    }
+    startVoting(roundId) {
+        return this.send(this.client.calls.startVoting(roundId));
+    }
+    endVoting(roundId) {
+        return this.send(this.client.calls.endVoting(roundId));
+    }
+    async processAllocationStep(roundId) {
+        const outcome = await this.send(this.client.calls.processAllocationStep(roundId));
+        return { done: outcome.value === true, outcome };
+    }
+    async processAllocationSteps(roundId, maxSteps = DEFAULT_COUNTING_STEPS) {
+        const outcome = await this.send(this.client.calls.processAllocationSteps(roundId, maxSteps));
+        return { done: outcome.value === true, outcome };
+    }
+    async runCounting(roundId, options = {}) {
+        const outcomes = [];
+        const limit = options.maxTransactions ?? Number.POSITIVE_INFINITY;
+        while (outcomes.length < limit) {
+            if (options.signal?.aborted)
+                return { done: false, transactions: outcomes.length, outcomes };
+            const { done, outcome } = await this.processAllocationSteps(roundId, options.maxStepsPerTransaction);
+            outcomes.push(outcome);
+            options.onProgress?.({ transactions: outcomes.length, outcome, done });
+            if (done)
+                return { done: true, transactions: outcomes.length, outcomes };
+        }
+        return { done: false, transactions: outcomes.length, outcomes };
+    }
+}
+export class PolestarGovernanceWriter {
+    writer;
+    constructor(writer) {
+        this.writer = writer;
+    }
+    async options(description, bond) {
+        return { description, bond: bond ?? proposalBond(await this.writer.client.governance.getPolicy()) };
+    }
+    get calls() {
+        return this.writer.client.governance.calls;
+    }
+    async proposeFundRound(input, options) {
+        return this.writer.send(this.calls.proposeFundRound(input, await this.options(options.description, options.bond)));
+    }
+    async proposeMilestonePayment(input, options) {
+        return this.writer.send(this.calls.proposeMilestonePayment(input, await this.options(options.description, options.bond)));
+    }
+    async proposeReturnRemaining(roundId, options) {
+        return this.writer.send(this.calls.proposeReturnRemaining(roundId, await this.options(options.description, options.bond)));
+    }
+    approve(proposal) {
+        return this.writer.send(this.calls.approve(proposal));
+    }
+    reject(proposal) {
+        return this.writer.send(this.calls.reject(proposal));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/eligibility.d.ts

@@ -0,0 +1,10 @@
+export type VoterStatus = "eligible" | "too-late" | "not-registered" | "not-member";
+export interface EligibilityRound {
+    config: {
+        opensAt: number;
+        tMin: number;
+    };
+    voterNamespace: string | null;
+}
+export declare function isDirectSubAccount(account: string, parent: string): boolean;
+export declare function voterStatus(round: EligibilityRound, accountId: string, firstSeen: number | null): VoterStatus;

package/dist/eligibility.js

@@ -0,0 +1,16 @@
+export function isDirectSubAccount(account, parent) {
+    const suffix = `.${parent}`;
+    if (!account.endsWith(suffix))
+        return false;
+    const label = account.slice(0, -suffix.length);
+    return label.length > 0 && !label.includes(".");
+}
+export function voterStatus(round, accountId, firstSeen) {
+    if (round.voterNamespace && !isDirectSubAccount(accountId, round.voterNamespace))
+        return "not-member";
+    if (firstSeen === null)
+        return "not-registered";
+    const { opensAt, tMin } = round.config;
+    return firstSeen < opensAt && firstSeen + tMin <= opensAt ? "eligible" : "too-late";
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../src/eligibility.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAc;IAChE,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,SAAiB,EAAE,SAAwB;IAC9F,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC;QAAE,OAAO,YAAY,CAAC;IACtG,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,gBAAgB,CAAC;IAChD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IACvC,OAAO,SAAS,GAAG,OAAO,IAAI,SAAS,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;AACtF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+import type { RawOutcome, TransactionOutcome } from "./types.js";
+export declare class PolestarError extends Error {
+    constructor(message: string);
+}
+export declare class ViewError extends PolestarError {
+}
+export declare class ContractPanicError extends ViewError {
+    readonly method: string;
+    readonly panic: string;
+    readonly code: string | null;
+    constructor(method: string, panic: string);
+}
+export declare class TransactionCancelledError extends PolestarError {
+}
+export declare class ContractError extends PolestarError {
+    readonly code: string;
+    readonly raw: string;
+    constructor(code: string, raw: string);
+}
+export declare class NetworkError extends PolestarError {
+}
+export declare class TransactionOutcomeUnknownError extends PolestarError {
+}
+export declare const ERROR_CODES: Readonly<Record<string, string>>;
+export declare function errorCode(text: string): string | null;
+export declare function classifySendError(error: unknown): PolestarError;
+export declare function readOutcome(raw: RawOutcome): TransactionOutcome;

package/dist/errors.js

@@ -0,0 +1,103 @@
+import { base64ToUtf8, parsePreservingBigNumbers } from "./serialization.js";
+export class PolestarError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class ViewError extends PolestarError {
+}
+export class ContractPanicError extends ViewError {
+    method;
+    panic;
+    code;
+    constructor(method, panic) {
+        super(`${method}: ${panic}`);
+        this.method = method;
+        this.panic = panic;
+        this.code = errorCode(panic);
+    }
+}
+export class TransactionCancelledError extends PolestarError {
+}
+export class ContractError extends PolestarError {
+    code;
+    raw;
+    constructor(code, raw) {
+        super(`${code}: ${raw}`);
+        this.code = code;
+        this.raw = raw;
+    }
+}
+export class NetworkError extends PolestarError {
+}
+export class TransactionOutcomeUnknownError extends PolestarError {
+}
+export const ERROR_CODES = {
+    ERR_NOT_SPUTNIK_DAO: "Only the configured SputnikDAO account can call this; submit it as a DAO proposal.",
+    ERR_DEPOSIT_MISMATCH: "fund_round must attach exactly the round's budget.",
+    ERR_INVALID_CONFIG: "closes_at must be after opens_at.",
+    ERR_ROUND_NOT_FOUND: "No round with this id.",
+    ERR_WRONG_PHASE: "The round is not in the stage this call needs.",
+    ERR_NO_DEPOSIT: "register_project needs a non-zero deposit.",
+    ERR_ZERO_COST: "A project's cost must be greater than zero.",
+    ERR_TITLE_TOO_LONG: "Title is longer than 200 bytes.",
+    ERR_SUMMARY_TOO_LONG: "Summary is longer than 2000 bytes.",
+    ERR_TOO_MANY_PROJECTS: "The round already has the maximum of 50 projects.",
+    ERR_MILESTONE_SUM_MISMATCH: "Milestone amounts must add up exactly to the cost.",
+    ERR_NO_PROJECTS: "Voting can only start once the round has a project.",
+    ERR_DECLARATION_CLOSED: "Voting has closed for this round.",
+    ERR_DECLARATION_NOT_YET_CLOSED: "Voting can only be ended after closes_at.",
+    ERR_NOT_IN_VOTER_NAMESPACE: "This round only accepts votes from direct sub-accounts of its voter namespace.",
+    ERR_ALREADY_VOTED: "This account has already voted in this round.",
+    ERR_EMPTY_APPROVAL: "A ballot must approve at least one project.",
+    ERR_UNREGISTERED_PROJECT: "A ballot named a project that is not in this round.",
+    ERR_NO_PRIOR_INTERACTION: "The account was not registered (register_voter or register_project) before opens_at.",
+    ERR_ACCOUNT_TOO_NEW: "The account registered later than opens_at minus t_min.",
+    ERR_INVALID_STEP_COUNT: "max_steps must be at least 1.",
+    ERR_PROJECT_NOT_FOUND: "No project with this id in the round.",
+    ERR_PROJECT_NOT_FUNDED: "Only funded projects have payable milestones.",
+    ERR_INVALID_MILESTONE_INDEX: "The project has no milestone at this index.",
+    ERR_ALREADY_ATTESTED: "This milestone has already been paid.",
+    ERR_ALREADY_RETURNED: "This round's remainder has already been returned.",
+    ERR_NOTHING_TO_RETURN: "This round has no unallocated budget.",
+    ERR_INSUFFICIENT_BALANCE: "The contract's available balance cannot cover this transfer.",
+    ERR_RATIONAL_OVERFLOW: "Allocation arithmetic overflowed; the round cannot be counted by this build.",
+    ERR_ALLOCATION_INVARIANT_VIOLATED: "An internal allocation invariant failed; report this.",
+};
+const CANCEL_PATTERN = /reject|cancel|denied|closed|user (?:closed|abort)/i;
+export function errorCode(text) {
+    return /\b(ERR_[A-Z_]+)\b/.exec(text)?.[1] ?? null;
+}
+export function classifySendError(error) {
+    if (error instanceof PolestarError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    const code = errorCode(message);
+    if (code)
+        return new ContractError(code, message);
+    if (CANCEL_PATTERN.test(message))
+        return new TransactionCancelledError(message);
+    return new TransactionOutcomeUnknownError(message);
+}
+export function readOutcome(raw) {
+    const hash = raw.transaction?.hash ?? raw.transaction_outcome?.id ?? null;
+    const logs = (raw.receipts_outcome ?? []).flatMap((receipt) => receipt.outcome?.logs ?? []);
+    const status = raw.status;
+    if (status && typeof status === "object" && "Failure" in status && status.Failure !== undefined) {
+        const text = JSON.stringify(status.Failure);
+        throw new ContractError(errorCode(text) ?? "UNKNOWN", text);
+    }
+    let value = null;
+    const encoded = status && typeof status === "object" ? status.SuccessValue : undefined;
+    if (encoded) {
+        try {
+            value = parsePreservingBigNumbers(base64ToUtf8(encoded));
+        }
+        catch {
+            value = null;
+        }
+    }
+    return { hash, logs, value };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,7 @@
+export type PolestarEventType = "RoundFunded" | "ProjectRegistered" | "DeclarationOpened" | "BallotSubmitted" | "DeclarationClosed" | "ProjectFunded" | "ProjectUnfunded" | "AllocationFinalized" | "MilestoneAttested" | "MilestoneReleaseFailed" | "RemainingReturned" | "RemainingReturnFailed";
+export interface PolestarEvent {
+    type: PolestarEventType;
+    data: Record<string, string>;
+}
+export declare function parseEvent(line: string): PolestarEvent | null;
+export declare function parseEvents(logs: string[]): PolestarEvent[];

package/dist/events.js

@@ -0,0 +1,34 @@
+const TYPES = new Set([
+    "RoundFunded",
+    "ProjectRegistered",
+    "DeclarationOpened",
+    "BallotSubmitted",
+    "DeclarationClosed",
+    "ProjectFunded",
+    "ProjectUnfunded",
+    "AllocationFinalized",
+    "MilestoneAttested",
+    "MilestoneReleaseFailed",
+    "RemainingReturned",
+    "RemainingReturnFailed",
+]);
+export function parseEvent(line) {
+    const [type, ...pairs] = line.trim().split(/\s+/);
+    if (!type || !TYPES.has(type))
+        return null;
+    const data = {};
+    for (const pair of pairs) {
+        const eq = pair.indexOf("=");
+        if (eq <= 0)
+            return null;
+        data[pair.slice(0, eq)] = pair.slice(eq + 1);
+    }
+    return { type: type, data };
+}
+export function parseEvents(logs) {
+    return logs.flatMap((line) => {
+        const event = parseEvent(line);
+        return event ? [event] : [];
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAmBA,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS;IAC5B,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,qBAAqB;IACrB,mBAAmB;IACnB,wBAAwB;IACxB,mBAAmB;IACnB,uBAAuB;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAyB,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/governance.d.ts

@@ -0,0 +1,78 @@
+import type { Transaction } from "./types.js";
+export interface PolicyRole {
+    name: string;
+    kind: "Everyone" | {
+        Group: string[];
+    } | {
+        Member: string;
+    };
+    permissions: string[];
+}
+export interface DaoPolicy {
+    roles: PolicyRole[];
+    proposal_bond: string;
+    [field: string]: unknown;
+}
+export interface ProposalAction {
+    method_name: string;
+    args: string;
+    deposit: string;
+    gas: string;
+}
+export interface ProposalKind {
+    FunctionCall?: {
+        receiver_id: string;
+        actions: ProposalAction[];
+    };
+    [other: string]: unknown;
+}
+export type ProposalStatus = "InProgress" | "Approved" | "Rejected" | "Removed" | "Expired" | "Moved" | "Failed";
+export interface DaoProposal {
+    id: number;
+    proposer: string;
+    description: string;
+    kind: ProposalKind;
+    status: ProposalStatus;
+    vote_counts: Record<string, string[]>;
+    votes: Record<string, string>;
+    [field: string]: unknown;
+}
+export interface DecodedAction {
+    receiverId: string;
+    method: string;
+    args: Record<string, unknown> | null;
+    deposit: bigint;
+    gas: bigint;
+}
+export interface FundRoundInput {
+    budget: bigint;
+    opensAt: number;
+    closesAt: number;
+    tMin?: number;
+    voterNamespace?: string;
+}
+export interface MilestonePaymentInput {
+    roundId: number;
+    projectId: number;
+    milestoneIndex: number;
+}
+export interface ProposalOptions {
+    description: string;
+    bond: bigint;
+}
+export type VoteAction = "VoteApprove" | "VoteReject" | "VoteRemove";
+export declare function canSubmit(policy: DaoPolicy, accountId: string): boolean;
+export declare function canVote(policy: DaoPolicy, accountId: string): boolean;
+export declare function proposalBond(policy: DaoPolicy): bigint;
+export declare function approvalCount(proposal: DaoProposal): number;
+export declare function decodeProposalAction(proposal: DaoProposal): DecodedAction | null;
+export declare function governanceCalls(daoId: string, contractId: string): {
+    propose: (action: Transaction, options: ProposalOptions) => Transaction;
+    proposeFundRound(input: FundRoundInput, options: ProposalOptions): Transaction;
+    proposeMilestonePayment(input: MilestonePaymentInput, options: ProposalOptions): Transaction;
+    proposeReturnRemaining(roundId: number, options: ProposalOptions): Transaction;
+    vote: (proposal: DaoProposal, action: VoteAction) => Transaction;
+    approve: (proposal: DaoProposal) => Transaction;
+    reject: (proposal: DaoProposal) => Transaction;
+};
+export type GovernanceCalls = ReturnType<typeof governanceCalls>;