@libertasinception/governance

On-chain governance client — proposals, voting, delegation, ISF management, and draft simulation

Installation

npm install @libertasinception/governance

Quick Start

import { GovernanceClient } from "@libertasinception/governance";

const gov = new GovernanceClient(httpClient);

// Draft with friction pattern (3-step)
const draft = await gov.drafts.create({ title: "Increase validators", type: "parameter-change" });
const sim = await gov.drafts.simulate(draft.id);
const proposal = await gov.submit(draft.id, { deposit: "10000000uphi" });

await gov.vote({ proposalId: proposal.id, option: "yes" });
await gov.delegate({ validator: "n1avaloper1...", amount: "5000000uphi" });
const isf = await gov.isf.balance("n1a1addr...");

Features

• 3-step friction pattern: draft -> simulate -> submit
• Impact simulation before proposal submission
• Weighted voting (yes/no/abstain/no_with_veto)
• Delegation management
• ISF (Isolation/Staking Fund) balance queries
• Constitution and article queries

API Reference

Classes

• GovernanceClient

Types

• Constitution
• Proposal
• ProposalDraft
• SimulationResult
• VoteParams
• DelegateParams
• ISFBalance

Dependencies

• @libertasinception/core
• zod

Requirements

• Node.js >= 18.0.0
• TypeScript >= 5.7 (recommended)

Links

• Documentation
• Guides
• Tutorials
• GitLab

License

MIT - see LICENSE for details.