@ezeonlabs/polestar 0.0.0-stage → 0.1.0

package/dist/governance.js

@@ -0,0 +1,115 @@
+import { base64ToUtf8, contractJson, parsePreservingBigNumbers, toId, toU128, utf8ToBase64 } from "./serialization.js";
+import { TGAS, isValidAccountId } from "./units.js";
+function allows(role, accountId, action) {
+    const member = role.kind === "Everyone" ||
+        ("Group" in role.kind && role.kind.Group.includes(accountId)) ||
+        ("Member" in role.kind && role.kind.Member === accountId);
+    return member && role.permissions.some((p) => p === `*:${action}` || p === `call:${action}` || p === "*:*");
+}
+export function canSubmit(policy, accountId) {
+    return policy.roles.some((role) => allows(role, accountId, "AddProposal"));
+}
+export function canVote(policy, accountId) {
+    return policy.roles.some((role) => allows(role, accountId, "VoteApprove"));
+}
+export function proposalBond(policy) {
+    return toU128(policy.proposal_bond);
+}
+export function approvalCount(proposal) {
+    return Object.values(proposal.votes).filter((vote) => vote === "Approve").length;
+}
+export function decodeProposalAction(proposal) {
+    const call = proposal.kind.FunctionCall;
+    const action = call?.actions[0];
+    if (!call || !action)
+        return null;
+    let args = null;
+    try {
+        args = parsePreservingBigNumbers(base64ToUtf8(action.args));
+    }
+    catch {
+        args = null;
+    }
+    return {
+        receiverId: call.receiver_id,
+        method: action.method_name,
+        args,
+        deposit: toU128(action.deposit),
+        gas: BigInt(action.gas),
+    };
+}
+export function governanceCalls(daoId, contractId) {
+    const propose = (action, options) => ({
+        receiverId: daoId,
+        method: "add_proposal",
+        args: {
+            proposal: {
+                description: options.description,
+                kind: {
+                    FunctionCall: {
+                        receiver_id: action.receiverId,
+                        actions: [
+                            {
+                                method_name: action.method,
+                                args: utf8ToBase64(contractJson(action.args)),
+                                deposit: action.deposit.toString(),
+                                gas: action.gas.toString(),
+                            },
+                        ],
+                    },
+                },
+            },
+        },
+        deposit: toU128(options.bond),
+        gas: 50n * TGAS,
+    });
+    const vote = (proposal, action) => ({
+        receiverId: daoId,
+        method: "act_proposal",
+        args: { id: toId(proposal.id, "proposal id"), action, proposal: proposal.kind, memo: null },
+        deposit: 0n,
+        gas: 300n * TGAS,
+    });
+    return {
+        propose,
+        proposeFundRound(input, options) {
+            const budget = toU128(input.budget);
+            if (budget === 0n)
+                throw new RangeError("budget must be greater than zero");
+            if (input.voterNamespace !== undefined && !isValidAccountId(input.voterNamespace)) {
+                throw new RangeError(`${input.voterNamespace} is not a valid NEAR account id`);
+            }
+            const args = {
+                config: {
+                    budget,
+                    opens_at: toId(input.opensAt, "opensAt"),
+                    closes_at: toId(input.closesAt, "closesAt"),
+                    t_min: toId(input.tMin ?? 0, "tMin"),
+                },
+            };
+            if (input.voterNamespace !== undefined)
+                args.voter_namespace = input.voterNamespace;
+            return propose({ receiverId: contractId, method: "fund_round", args, deposit: budget, gas: 100n * TGAS }, options);
+        },
+        proposeMilestonePayment(input, options) {
+            return propose({
+                receiverId: contractId,
+                method: "attest_milestone",
+                args: {
+                    round_id: toId(input.roundId, "round id"),
+                    project_id: toId(input.projectId, "project id"),
+                    milestone_index: toId(input.milestoneIndex, "milestone index"),
+                },
+                deposit: 0n,
+                gas: 150n * TGAS,
+            }, options);
+        },
+        proposeReturnRemaining(roundId, options) {
+            return propose({ receiverId: contractId, method: "return_remaining", args: { round_id: toId(roundId, "round id") }, deposit: 0n, gas: 50n * TGAS }, options);
+        },
+        vote,
+        approve: (proposal) => vote(proposal, "VoteApprove"),
+        reject: (proposal) => vote(proposal, "VoteReject"),
+    };
+}
+//# sourceMappingURL=governance.js.map

package/dist/governance.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { DEFAULT_COUNTING_STEPS, polestarCalls, type PolestarCalls, type RegisterProjectInput } from "./calls.js";
+export { DEFAULT_TESTNET_RPC, PolestarClient, PolestarGovernanceReader, PolestarGovernanceWriter, PolestarWriter, mapAllocationResult, mapProject, mapRound, sendTransaction, type CountingOptions, type CountingProgress, type CountingResult, type PolestarClientOptions, } from "./client.js";
+export { isDirectSubAccount, voterStatus, type EligibilityRound, type VoterStatus } from "./eligibility.js";
+export { ContractError, ContractPanicError, ERROR_CODES, NetworkError, PolestarError, TransactionCancelledError, TransactionOutcomeUnknownError, ViewError, classifySendError, errorCode, readOutcome, } from "./errors.js";
+export { parseEvent, parseEvents, type PolestarEvent, type PolestarEventType } from "./events.js";
+export { approvalCount, canSubmit, canVote, decodeProposalAction, governanceCalls, proposalBond, type DaoPolicy, type DaoProposal, type DecodedAction, type FundRoundInput, type GovernanceCalls, type MilestonePaymentInput, type PolicyRole, type ProposalAction, type ProposalKind, type ProposalOptions, type ProposalStatus, type VoteAction, } from "./governance.js";
+export { rpcBlock, rpcView, type BlockFn, type ViewFn } from "./rpc.js";
+export { base64ToUtf8, contractJson, parsePreservingBigNumbers, toId, toU128, utf8ToBase64 } from "./serialization.js";
+export type * from "./types.js";
+export { NEAR_DECIMALS, TGAS, YOCTO_PER_NEAR, formatNearAmount, isValidAccountId, parseNear } from "./units.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+export { DEFAULT_COUNTING_STEPS, polestarCalls } from "./calls.js";
+export { DEFAULT_TESTNET_RPC, PolestarClient, PolestarGovernanceReader, PolestarGovernanceWriter, PolestarWriter, mapAllocationResult, mapProject, mapRound, sendTransaction, } from "./client.js";
+export { isDirectSubAccount, voterStatus } from "./eligibility.js";
+export { ContractError, ContractPanicError, ERROR_CODES, NetworkError, PolestarError, TransactionCancelledError, TransactionOutcomeUnknownError, ViewError, classifySendError, errorCode, readOutcome, } from "./errors.js";
+export { parseEvent, parseEvents } from "./events.js";
+export { approvalCount, canSubmit, canVote, decodeProposalAction, governanceCalls, proposalBond, } from "./governance.js";
+export { rpcBlock, rpcView } from "./rpc.js";
+export { base64ToUtf8, contractJson, parsePreservingBigNumbers, toId, toU128, utf8ToBase64 } from "./serialization.js";
+export { NEAR_DECIMALS, TGAS, YOCTO_PER_NEAR, formatNearAmount, isValidAccountId, parseNear } from "./units.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAiD,MAAM,YAAY,CAAC;AAClH,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,eAAe,GAKhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAA2C,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,yBAAyB,EACzB,8BAA8B,EAC9B,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAC;AAClG,OAAO,EACL,aAAa,EACb,SAAS,EACT,OAAO,EACP,oBAAoB,EACpB,eAAe,EACf,YAAY,GAab,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAA6B,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvH,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/near-api-js.d.ts

@@ -0,0 +1,3 @@
+import { type Account } from "near-api-js";
+import type { Signer } from "./types.js";
+export declare function fromNearApiAccount(account: Account): Signer;

package/dist/near-api-js.js

@@ -0,0 +1,12 @@
+import { actions } from "near-api-js";
+export function fromNearApiAccount(account) {
+    return {
+        accountId: account.accountId,
+        signAndSendTransaction: ({ receiverId, actions: calls }) => account.signAndSendTransaction({
+            receiverId,
+            actions: calls.map((call) => actions.functionCall(call.params.methodName, call.params.args, BigInt(call.params.gas), BigInt(call.params.deposit))),
+            throwOnFailure: false,
+        }),
+    };
+}
+//# sourceMappingURL=near-api-js.js.map

package/dist/near-api-js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"near-api-js.js","sourceRoot":"","sources":["../src/near-api-js.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAC;AAGpD,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,sBAAsB,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CACzD,OAAO,CAAC,sBAAsB,CAAC;YAC7B,UAAU;YACV,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1B,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CACrH;YACD,cAAc,EAAE,KAAK;SACtB,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,5 @@
+import type { Block } from "./types.js";
+export type ViewFn = (method: string, args: Record<string, unknown>, contractId: string) => Promise<unknown>;
+export type BlockFn = (ref: "final" | number) => Promise<Block>;
+export declare function rpcView(rpcUrl: string, fetchImpl?: typeof fetch): ViewFn;
+export declare function rpcBlock(rpcUrl: string, fetchImpl?: typeof fetch): BlockFn;

package/dist/rpc.js

@@ -0,0 +1,64 @@
+import { ContractPanicError, ViewError } from "./errors.js";
+import { parsePreservingBigNumbers, utf8ToBase64 } from "./serialization.js";
+function panicMessage(raw) {
+    return /panic_msg: "([^"]*)"/.exec(raw)?.[1] ?? raw;
+}
+async function post(rpcUrl, fetchImpl, label, body) {
+    let res;
+    try {
+        res = await fetchImpl(rpcUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (error) {
+        throw new ViewError(`${label}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!res.ok)
+        throw new ViewError(`${label}: RPC request failed (${res.status})`);
+    return res.json();
+}
+export function rpcView(rpcUrl, fetchImpl = globalThis.fetch) {
+    return async (method, args, contractId) => {
+        const body = (await post(rpcUrl, fetchImpl, method, {
+            jsonrpc: "2.0",
+            id: "polestar-sdk",
+            method: "query",
+            params: {
+                request_type: "call_function",
+                finality: "optimistic",
+                account_id: contractId,
+                method_name: method,
+                args_base64: utf8ToBase64(JSON.stringify(args)),
+            },
+        }));
+        if (body.error) {
+            if (body.error.cause?.name === "CONTRACT_EXECUTION_ERROR") {
+                throw new ContractPanicError(method, panicMessage(body.error.cause.info?.error_message ?? ""));
+            }
+            throw new ViewError(`${method}: ${body.error.cause?.name ?? body.error.message ?? "unknown RPC error"}`);
+        }
+        if (body.result?.error !== undefined)
+            throw new ContractPanicError(method, panicMessage(body.result.error));
+        if (!body.result?.result)
+            throw new ViewError(`${method}: malformed RPC response`);
+        const text = new TextDecoder().decode(Uint8Array.from(body.result.result));
+        return text ? parsePreservingBigNumbers(text) : undefined;
+    };
+}
+export function rpcBlock(rpcUrl, fetchImpl = globalThis.fetch) {
+    return async (ref) => {
+        const body = (await post(rpcUrl, fetchImpl, "block", {
+            jsonrpc: "2.0",
+            id: "polestar-sdk",
+            method: "block",
+            params: ref === "final" ? { finality: "final" } : { block_id: ref },
+        }));
+        if (!body.result)
+            throw new ViewError("block: malformed RPC response");
+        const { height, timestamp_nanosec } = body.result.header;
+        return { height, timestampMs: Number(BigInt(timestamp_nanosec) / 1000000n) };
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/serialization.d.ts

@@ -0,0 +1,6 @@
+export declare function contractJson(value: unknown, indent?: number): string;
+export declare function parsePreservingBigNumbers(json: string): unknown;
+export declare function utf8ToBase64(text: string): string;
+export declare function base64ToUtf8(encoded: string): string;
+export declare function toU128(value: bigint | string | number): bigint;
+export declare function toId(value: unknown, what?: string): number;

package/dist/serialization.js

@@ -0,0 +1,33 @@
+const MAX_U128 = (1n << 128n) - 1n;
+export function contractJson(value, indent) {
+    const json = JSON.stringify(value, (_key, v) => (typeof v === "bigint" ? `__big__${v}` : v), indent);
+    return json.replace(/"__big__(-?\d+)"/g, "$1");
+}
+export function parsePreservingBigNumbers(json) {
+    const trimmed = json.trim();
+    if (/^\d{16,}$/.test(trimmed))
+        return trimmed;
+    return JSON.parse(json.replace(/(?<=[:,[])(\d{16,})(?=[,}\]])/g, '"$1"'));
+}
+export function utf8ToBase64(text) {
+    let binary = "";
+    new TextEncoder().encode(text).forEach((byte) => (binary += String.fromCharCode(byte)));
+    return btoa(binary);
+}
+export function base64ToUtf8(encoded) {
+    const binary = atob(encoded);
+    return new TextDecoder().decode(Uint8Array.from(binary, (c) => c.charCodeAt(0)));
+}
+export function toU128(value) {
+    const big = typeof value === "bigint" ? value : BigInt(value);
+    if (big < 0n || big > MAX_U128)
+        throw new RangeError(`${value} is outside the u128 range`);
+    return big;
+}
+export function toId(value, what = "id") {
+    const n = typeof value === "number" ? value : Number(value);
+    if (!Number.isSafeInteger(n) || n < 0)
+        throw new RangeError(`${what} ${String(value)} is not a safe non-negative integer`);
+    return n;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;AAEnC,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,MAAe;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAA+B;IACpD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,4BAA4B,CAAC,CAAC;IAC3F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAc,EAAE,IAAI,GAAG,IAAI;IAC9C,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC3H,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,100 @@
+export type RoundPhase = "Registration" | "Declaration" | "Allocation" | "Settlement";
+export type ProjectStatus = "Pending" | "Funded" | "Unfunded";
+export type FundingStage = "Mes" | "Completion";
+export interface RoundConfig {
+    budget: bigint;
+    opensAt: number;
+    closesAt: number;
+    tMin: number;
+}
+export interface Round {
+    id: number;
+    config: RoundConfig;
+    phase: RoundPhase;
+    remaining: bigint;
+    remainingReturned: boolean;
+    voterNamespace: string | null;
+    projectCount: number;
+    ballotCount: number;
+}
+export interface Milestone {
+    amount: bigint;
+    attested: boolean;
+}
+export interface Project {
+    id: number;
+    proposer: string;
+    recipient: string;
+    title: string;
+    summary: string;
+    cost: bigint;
+    milestones: Milestone[];
+    status: ProjectStatus;
+}
+export interface Ballot {
+    voter: string;
+    approved: number[];
+}
+export interface FundingRecord {
+    project: number;
+    stage: FundingStage;
+    amount: bigint;
+}
+export interface AllocationResult {
+    budget: bigint;
+    funded: FundingRecord[];
+    unfunded: number[];
+    remaining: bigint;
+}
+export interface Block {
+    height: number;
+    timestampMs: number;
+}
+export interface ChainClock extends Block {
+    msPerBlock: number | null;
+}
+export interface Transaction {
+    receiverId: string;
+    method: string;
+    args: Record<string, unknown>;
+    deposit: bigint;
+    gas: bigint;
+}
+export interface TransactionOutcome {
+    hash: string | null;
+    logs: string[];
+    value: unknown;
+}
+export interface FunctionCallAction {
+    type: "FunctionCall";
+    params: {
+        methodName: string;
+        args: Uint8Array;
+        gas: string;
+        deposit: string;
+    };
+}
+export interface RawOutcome {
+    transaction?: {
+        hash?: string;
+    };
+    transaction_outcome?: {
+        id?: string;
+    };
+    receipts_outcome?: {
+        outcome?: {
+            logs?: string[];
+        };
+    }[];
+    status?: {
+        SuccessValue?: string;
+        Failure?: unknown;
+    } | string;
+}
+export interface Signer {
+    accountId?: string;
+    signAndSendTransaction(transaction: {
+        receiverId: string;
+        actions: FunctionCallAction[];
+    }): Promise<unknown>;
+}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/units.d.ts

@@ -0,0 +1,8 @@
+export declare const NEAR_DECIMALS = 24;
+export declare const YOCTO_PER_NEAR: bigint;
+export declare const TGAS: bigint;
+export declare function parseNear(input: string): bigint | null;
+export declare function formatNearAmount(yocto: bigint | string | number, options?: {
+    exact?: boolean;
+}): string;
+export declare function isValidAccountId(id: string): boolean;

package/dist/units.js

@@ -0,0 +1,32 @@
+export const NEAR_DECIMALS = 24;
+export const YOCTO_PER_NEAR = 10n ** BigInt(NEAR_DECIMALS);
+export const TGAS = 10n ** 12n;
+const NAMED_ACCOUNT = /^(([a-z\d]+[-_])*[a-z\d]+\.)*([a-z\d]+[-_])*[a-z\d]+$/;
+export function parseNear(input) {
+    const text = input.trim();
+    const match = /^(\d+)(?:\.(\d*))?$/.exec(text) ?? /^()\.(\d+)$/.exec(text);
+    if (!match)
+        return null;
+    const [, whole, frac = ""] = match;
+    if (frac.length > NEAR_DECIMALS)
+        return null;
+    return BigInt(whole || "0") * YOCTO_PER_NEAR + BigInt(frac.padEnd(NEAR_DECIMALS, "0") || "0");
+}
+export function formatNearAmount(yocto, options = {}) {
+    const value = typeof yocto === "bigint" ? yocto : BigInt(yocto);
+    const negative = value < 0n;
+    const abs = negative ? -value : value;
+    const whole = abs / YOCTO_PER_NEAR;
+    const frac = (abs % YOCTO_PER_NEAR)
+        .toString()
+        .padStart(NEAR_DECIMALS, "0")
+        .slice(0, options.exact ? NEAR_DECIMALS : 5);
+    const trimmed = frac.replace(/0+$/, "").padEnd(2, "0");
+    return `${negative ? "-" : ""}${whole.toLocaleString("en-US")}.${trimmed}`;
+}
+export function isValidAccountId(id) {
+    if (id.length < 2 || id.length > 64)
+        return false;
+    return NAMED_ACCOUNT.test(id) || /^[0-9a-f]{64}$/.test(id) || /^0x[0-9a-f]{40}$/.test(id);
+}
+//# sourceMappingURL=units.js.map

package/dist/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC;AAE/B,MAAM,aAAa,GAAG,uDAAuD,CAAC;AAE9E,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA+B,EAAE,UAA+B,EAAE;IACjG,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,GAAG,cAAc,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,cAAc,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@ezeonlabs/polestar",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "TypeScript client for Polestar participatory budgeting on NEAR",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maelstrom0x8/polestar.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/maelstrom0x8/polestar/tree/main/packages/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/maelstrom0x8/polestar/issues"
+  },
+  "keywords": [
+    "near",
+    "sputnik-dao",
+    "participatory-budgeting",
+    "dao",
+    "method-of-equal-shares"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./near-api-js": {
+      "types": "./dist/near-api-js.d.ts",
+      "default": "./dist/near-api-js.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "peerDependencies": {
+    "near-api-js": ">=7.4.0"
+  },
+  "peerDependenciesMeta": {
+    "near-api-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "near-api-js": "7.4.0",
+    "typescript": "~6.0.2",
+    "vitest": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}