@dfinity/nns 0.1.9 → 0.2.0

package/dist/types/types/governance_converters.d.ts

@@ -0,0 +1,532 @@
+import { DerEncodedPublicKey } from "@dfinity/agent";
+import { Principal } from "@dfinity/principal";
+import { AccountIdentifier, CanisterIdString, E8s, NeuronId, PrincipalString } from "./common";
+import { Option } from "./option";
+export declare type Action = {
+    RegisterKnownNeuron: KnownNeuron;
+} | {
+    ExecuteNnsFunction: ExecuteNnsFunction;
+} | {
+    ManageNeuron: ManageNeuron;
+} | {
+    ApproveGenesisKyc: ApproveGenesisKyc;
+} | {
+    ManageNetworkEconomics: NetworkEconomics;
+} | {
+    RewardNodeProvider: RewardNodeProvider;
+} | {
+    RewardNodeProviders: RewardNodeProviders;
+} | {
+    AddOrRemoveNodeProvider: AddOrRemoveNodeProvider;
+} | {
+    SetDefaultFollowees: SetDefaultFollowees;
+} | {
+    Motion: Motion;
+};
+export interface AddHotKey {
+    newHotKey: Option<PrincipalString>;
+}
+export interface AddOrRemoveNodeProvider {
+    change: Option<Change>;
+}
+export interface ApproveGenesisKyc {
+    principals: Array<PrincipalString>;
+}
+export declare type AuthzChangeOp = {
+    Authorize: {
+        addSelf: boolean;
+    };
+} | {
+    Deauthorize: null;
+};
+export interface Ballot {
+    neuronId: bigint;
+    vote: Vote;
+    votingPower: bigint;
+}
+export interface BallotInfo {
+    vote: Vote;
+    proposalId: Option<ProposalId>;
+}
+export declare type By = {
+    NeuronIdOrSubaccount: Record<string, never>;
+} | {
+    MemoAndController: ClaimOrRefreshNeuronFromAccount;
+} | {
+    Memo: bigint;
+};
+export interface CanisterAuthzInfo {
+    methodsAuthz: Array<MethodAuthzInfo>;
+}
+export declare type Change = {
+    ToRemove: NodeProvider;
+} | {
+    ToAdd: NodeProvider;
+};
+export declare type ClaimOrRefresh = {
+    by: Option<By>;
+};
+export interface ClaimOrRefreshNeuronFromAccount {
+    controller: Option<Principal>;
+    memo: bigint;
+}
+export declare type ClaimOrRefreshNeuronRequest = {
+    neuronId: NeuronId;
+    by: Option<By>;
+};
+export declare type Command = {
+    Spawn: Spawn;
+} | {
+    Split: Split;
+} | {
+    Follow: Follow;
+} | {
+    ClaimOrRefresh: ClaimOrRefresh;
+} | {
+    Configure: Configure;
+} | {
+    RegisterVote: RegisterVote;
+} | {
+    Merge: Merge;
+} | {
+    DisburseToNeuron: DisburseToNeuron;
+} | {
+    MergeMaturity: MergeMaturity;
+} | {
+    MakeProposal: Proposal;
+} | {
+    Disburse: Disburse;
+};
+export interface Configure {
+    operation: Option<Operation>;
+}
+export interface Disburse {
+    toAccountId: Option<AccountIdentifier>;
+    amount: Option<E8s>;
+}
+export interface DisburseResponse {
+    transferBlockHeight: bigint;
+}
+export interface DisburseToNeuron {
+    dissolveDelaySeconds: bigint;
+    kycVerified: boolean;
+    amount: E8s;
+    newController: Option<PrincipalString>;
+    nonce: bigint;
+}
+export declare type DissolveState = {
+    DissolveDelaySeconds: bigint;
+} | {
+    WhenDissolvedTimestampSeconds: bigint;
+};
+export interface ExecuteNnsFunction {
+    nnsFunctionId: number;
+    nnsFunctionName: Option<string>;
+    payload: Option<Record<string, unknown>>;
+    payloadBytes: ArrayBuffer;
+}
+export interface Follow {
+    topic: Topic;
+    followees: Array<NeuronId>;
+}
+export interface Followees {
+    topic: Topic;
+    followees: Array<NeuronId>;
+}
+export interface GovernanceError {
+    errorMessage: string;
+    errorType: number;
+}
+export interface IncreaseDissolveDelay {
+    additionalDissolveDelaySeconds: number;
+}
+export interface KnownNeuron {
+    id: NeuronId;
+    name: string;
+    description: Option<string>;
+}
+export interface SetDissolveTimestamp {
+    dissolveTimestampSeconds: bigint;
+}
+export interface ListProposalsRequest {
+    limit: number;
+    beforeProposal: Option<ProposalId>;
+    includeRewardStatus: Array<ProposalRewardStatus>;
+    excludeTopic: Array<Topic>;
+    includeStatus: Array<ProposalStatus>;
+}
+export interface ListProposalsResponse {
+    proposals: Array<ProposalInfo>;
+}
+export interface MakeProposalResponse {
+    proposalId: ProposalId;
+}
+export interface ManageNeuron {
+    id: Option<NeuronId>;
+    command: Option<Command>;
+    neuronIdOrSubaccount: Option<NeuronIdOrSubaccount>;
+}
+export interface Merge {
+    sourceNeuronId: Option<NeuronId>;
+}
+export interface MergeMaturity {
+    percentageToMerge: number;
+}
+export interface MergeMaturityRequest {
+    neuronId: NeuronId;
+    percentageToMerge: number;
+}
+export interface MergeMaturityResponse {
+    mergedMaturityE8s: bigint;
+    newStakeE8s: bigint;
+}
+export interface MethodAuthzChange {
+    principal: Option<PrincipalString>;
+    methodName: string;
+    canister: CanisterIdString;
+    operation: AuthzChangeOp;
+}
+export interface MethodAuthzInfo {
+    methodName: string;
+    principalIds: Array<ArrayBuffer>;
+}
+export interface Motion {
+    motionText: string;
+}
+export interface NetworkEconomics {
+    neuronMinimumStake: E8s;
+    maxProposalsToKeepPerTopic: number;
+    neuronManagementFeePerProposal: E8s;
+    rejectCost: E8s;
+    transactionFee: E8s;
+    neuronSpawnDissolveDelaySeconds: bigint;
+    minimumIcpXdrRate: bigint;
+    maximumNodeProviderRewards: bigint;
+}
+export interface Neuron {
+    id: Option<NeuronId>;
+    isCurrentUserController: Option<boolean>;
+    controller: Option<PrincipalString>;
+    recentBallots: Array<BallotInfo>;
+    kycVerified: boolean;
+    notForProfit: boolean;
+    cachedNeuronStake: E8s;
+    createdTimestampSeconds: bigint;
+    maturityE8sEquivalent: bigint;
+    agingSinceTimestampSeconds: bigint;
+    neuronFees: E8s;
+    hotKeys: Array<PrincipalString>;
+    accountIdentifier: AccountIdentifier;
+    joinedCommunityFundTimestampSeconds: Option<bigint>;
+    dissolveState: Option<DissolveState>;
+    followees: Array<Followees>;
+}
+export declare type NeuronIdOrSubaccount = {
+    Subaccount: Array<number>;
+} | {
+    NeuronId: NeuronId;
+};
+export declare enum NeuronState {
+    UNSPECIFIED = 0,
+    LOCKED = 1,
+    DISSOLVING = 2,
+    DISSOLVED = 3
+}
+export interface NeuronInfo {
+    neuronId: NeuronId;
+    dissolveDelaySeconds: bigint;
+    recentBallots: Array<BallotInfo>;
+    createdTimestampSeconds: bigint;
+    state: NeuronState;
+    joinedCommunityFundTimestampSeconds: Option<bigint>;
+    retrievedAtTimestampSeconds: bigint;
+    votingPower: bigint;
+    ageSeconds: bigint;
+    fullNeuron: Option<Neuron>;
+}
+export interface NeuronInfoForHw {
+    id: string;
+    amount: string;
+    hotKeys: Array<PrincipalString>;
+}
+export interface NodeProvider {
+    id: Option<PrincipalString>;
+    rewardAccount: Option<AccountIdentifier>;
+}
+export declare type Operation = {
+    RemoveHotKey: RemoveHotKey;
+} | {
+    AddHotKey: AddHotKey;
+} | {
+    StopDissolving: Record<string, never>;
+} | {
+    StartDissolving: Record<string, never>;
+} | {
+    IncreaseDissolveDelay: IncreaseDissolveDelay;
+} | {
+    JoinCommunityFund: Record<string, never>;
+} | {
+    SetDissolveTimestamp: SetDissolveTimestamp;
+};
+export interface Proposal {
+    title: Option<string>;
+    url: string;
+    action: Option<Action>;
+    summary: string;
+}
+export declare type ProposalId = bigint;
+export interface ProposalInfo {
+    id: Option<ProposalId>;
+    ballots: Array<Ballot>;
+    rejectCost: E8s;
+    proposalTimestampSeconds: bigint;
+    rewardEventRound: bigint;
+    failedTimestampSeconds: bigint;
+    decidedTimestampSeconds: bigint;
+    latestTally: Option<Tally>;
+    proposal: Option<Proposal>;
+    proposer: Option<NeuronId>;
+    executedTimestampSeconds: bigint;
+    topic: Topic;
+    status: ProposalStatus;
+    rewardStatus: ProposalRewardStatus;
+}
+export declare enum ProposalRewardStatus {
+    PROPOSAL_REWARD_STATUS_UNKNOWN = 0,
+    PROPOSAL_REWARD_STATUS_ACCEPT_VOTES = 1,
+    PROPOSAL_REWARD_STATUS_READY_TO_SETTLE = 2,
+    PROPOSAL_REWARD_STATUS_SETTLED = 3,
+    PROPOSAL_REWARD_STATUS_INELIGIBLE = 4
+}
+export declare enum ProposalStatus {
+    PROPOSAL_STATUS_UNKNOWN = 0,
+    PROPOSAL_STATUS_OPEN = 1,
+    PROPOSAL_STATUS_REJECTED = 2,
+    PROPOSAL_STATUS_ACCEPTED = 3,
+    PROPOSAL_STATUS_EXECUTED = 4,
+    PROPOSAL_STATUS_FAILED = 5
+}
+export declare enum Vote {
+    UNSPECIFIED = 0,
+    YES = 1,
+    NO = 2
+}
+export interface RegisterVote {
+    vote: Vote;
+    proposal: Option<ProposalId>;
+}
+export interface RemoveHotKey {
+    hotKeyToRemove: Option<PrincipalString>;
+}
+export declare type RewardMode = {
+    RewardToNeuron: RewardToNeuron;
+} | {
+    RewardToAccount: RewardToAccount;
+};
+export declare type RewardNodeProviders = {
+    rewards: Array<RewardNodeProvider>;
+};
+export interface RewardToAccount {
+    toAccount: Option<AccountIdentifier>;
+}
+export interface RewardToNeuron {
+    dissolveDelaySeconds: bigint;
+}
+export declare type ClaimNeuronRequest = {
+    publicKey: DerEncodedPublicKey;
+    nonce: bigint;
+    dissolveDelayInSecs: bigint;
+};
+export declare type ClaimNeuronResponse = {
+    Ok: null;
+} | {
+    Err: GovernanceError;
+};
+export declare type GetFullNeuronResponse = {
+    Ok: Neuron;
+} | {
+    Err: GovernanceError;
+};
+export declare type GetNeuronInfoResponse = {
+    Ok: NeuronInfo;
+} | {
+    Err: GovernanceError;
+};
+export interface RewardNodeProvider {
+    nodeProvider: Option<NodeProvider>;
+    rewardMode: Option<RewardMode>;
+    amountE8s: bigint;
+}
+export interface SetDefaultFollowees {
+    defaultFollowees: Array<Followees>;
+}
+export interface Spawn {
+    newController: Option<PrincipalString>;
+}
+export interface SpawnResponse {
+    createdNeuronId: NeuronId;
+}
+export interface Split {
+    amount: E8s;
+}
+export interface Tally {
+    no: bigint;
+    yes: bigint;
+    total: bigint;
+    timestampSeconds: bigint;
+}
+export declare enum Topic {
+    Unspecified = 0,
+    ManageNeuron = 1,
+    ExchangeRate = 2,
+    NetworkEconomics = 3,
+    Governance = 4,
+    NodeAdmin = 5,
+    ParticipantManagement = 6,
+    SubnetManagement = 7,
+    NetworkCanisterManagement = 8,
+    Kyc = 9,
+    NodeProviderRewards = 10
+}
+export interface AddHotKeyRequest {
+    neuronId: NeuronId;
+    principal: PrincipalString;
+}
+export interface RemoveHotKeyRequest {
+    neuronId: NeuronId;
+    principal: PrincipalString;
+}
+export interface StartDissolvingRequest {
+    neuronId: NeuronId;
+}
+export interface StopDissolvingRequest {
+    neuronId: NeuronId;
+}
+export interface IncreaseDissolveDelayRequest {
+    neuronId: NeuronId;
+    additionalDissolveDelaySeconds: number;
+}
+export interface FollowRequest {
+    neuronId: NeuronId;
+    topic: Topic;
+    followees: Array<NeuronId>;
+}
+export interface RegisterVoteRequest {
+    neuronId: NeuronId;
+    vote: Vote;
+    proposal: ProposalId;
+}
+export interface SpawnRequest {
+    neuronId: NeuronId;
+    newController: Option<PrincipalString>;
+}
+export interface SplitRequest {
+    neuronId: NeuronId;
+    amount: E8s;
+}
+export interface DisburseRequest {
+    neuronId: NeuronId;
+    toAccountId?: AccountIdentifier;
+    amount?: E8s;
+}
+export interface DisburseToNeuronRequest {
+    neuronId: NeuronId;
+    dissolveDelaySeconds: bigint;
+    kycVerified: boolean;
+    amount: E8s;
+    newController: Option<PrincipalString>;
+    nonce: bigint;
+}
+export interface JoinCommunityFundRequest {
+    neuronId: NeuronId;
+}
+export interface MakeProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    url: string;
+    summary: string;
+    action: Action;
+}
+export interface MakeMotionProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    url: string;
+    text: string;
+    summary: string;
+}
+export interface MakeNetworkEconomicsProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    summary: string;
+    url: string;
+    networkEconomics: NetworkEconomics;
+}
+export interface MakeRewardNodeProviderProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    summary: string;
+    url: string;
+    nodeProvider: PrincipalString;
+    amount: E8s;
+    rewardMode: Option<RewardMode>;
+}
+export interface MakeSetDefaultFolloweesProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    summary: string;
+    url: string;
+    followees: Array<Followees>;
+}
+export interface MakeExecuteNnsFunctionProposalRequest {
+    neuronId: NeuronId;
+    title: Option<string>;
+    summary: string;
+    url: string;
+    nnsFunction: number;
+    payload: ArrayBuffer;
+}
+export interface DisburseToNeuronResponse {
+    createdNeuronId: NeuronId;
+}
+export interface SpawnResponse {
+    createdNeuronId: NeuronId;
+}
+export declare type EmptyResponse = {
+    Ok: null;
+} | {
+    Err: GovernanceError;
+};
+export default interface ServiceInterface {
+    getNeurons: (certified: boolean, neuronIds?: NeuronId[]) => Promise<Array<NeuronInfo>>;
+    getNeuronsForHW: () => Promise<Array<NeuronInfoForHw>>;
+    getPendingProposals: () => Promise<Array<ProposalInfo>>;
+    getProposalInfo: (proposalId: bigint) => Promise<Option<ProposalInfo>>;
+    listKnownNeurons: (certified: boolean) => Promise<Array<KnownNeuron>>;
+    listProposals: (request: ListProposalsRequest) => Promise<ListProposalsResponse>;
+    addHotKey: (request: AddHotKeyRequest) => Promise<EmptyResponse>;
+    removeHotKey: (request: RemoveHotKeyRequest) => Promise<EmptyResponse>;
+    startDissolving: (request: StartDissolvingRequest) => Promise<EmptyResponse>;
+    stopDissolving: (request: StopDissolvingRequest) => Promise<EmptyResponse>;
+    increaseDissolveDelay: (request: IncreaseDissolveDelayRequest) => Promise<EmptyResponse>;
+    joinCommunityFund: (request: JoinCommunityFundRequest) => Promise<EmptyResponse>;
+    follow: (request: FollowRequest) => Promise<EmptyResponse>;
+    mergeMaturity: (request: MergeMaturityRequest) => Promise<MergeMaturityResponse>;
+    registerVote: (request: RegisterVoteRequest) => Promise<EmptyResponse>;
+    spawn: (request: SpawnRequest) => Promise<SpawnResponse>;
+    split: (request: SplitRequest) => Promise<NeuronId>;
+    disburse: (request: DisburseRequest) => Promise<DisburseResponse>;
+    disburseToNeuron: (request: DisburseToNeuronRequest) => Promise<DisburseToNeuronResponse>;
+    makeMotionProposal: (request: MakeMotionProposalRequest) => Promise<MakeProposalResponse>;
+    makeNetworkEconomicsProposal: (request: MakeNetworkEconomicsProposalRequest) => Promise<MakeProposalResponse>;
+    makeRewardNodeProviderProposal: (request: MakeRewardNodeProviderProposalRequest) => Promise<MakeProposalResponse>;
+    makeSetDefaultFolloweesProposal: (request: MakeSetDefaultFolloweesProposalRequest) => Promise<MakeProposalResponse>;
+    makeExecuteNnsFunctionProposal: (request: MakeExecuteNnsFunctionProposalRequest) => Promise<MakeProposalResponse>;
+    claimOrRefreshNeuron: (request: ClaimOrRefreshNeuronRequest) => Promise<Option<NeuronId>>;
+    claimOrRefreshNeuronFromAccount: (request: ClaimOrRefreshNeuronFromAccount) => Promise<NeuronId>;
+}
+/**
+ * An error used to ensure at compile-time that it's never reached.
+ */
+export declare class UnsupportedValueError extends Error {
+    constructor(value: never);
+}

package/dist/types/types/icp.d.ts

@@ -0,0 +1,4 @@
+export declare enum FromICPStringError {
+    FRACTIONAL_MORE_THAN_8_DECIMALS = 0,
+    INVALID_FORMAT = 1
+}

package/dist/types/types/ledger.d.ts

@@ -0,0 +1,30 @@
+import { Agent } from "@dfinity/agent";
+import { Principal } from "@dfinity/principal";
+import { ICP } from "../icp";
+export declare type BlockHeight = bigint;
+export declare type TransferError = InvalidSender | InsufficientFunds | TxTooOld | TxCreatedInFuture | TxDuplicate | BadFee;
+export declare class InvalidSender {
+}
+export declare class BadFee {
+}
+export declare class InsufficientFunds {
+    readonly balance: ICP;
+    constructor(balance: ICP);
+}
+export declare class TxTooOld {
+    readonly allowed_window_secs: number;
+    constructor(allowed_window_secs: number);
+}
+export declare class TxCreatedInFuture {
+}
+export declare class TxDuplicate {
+    readonly duplicateOf: BlockHeight;
+    constructor(duplicateOf: BlockHeight);
+}
+export declare type Fetcher = (agent: Agent, canisterId: Principal, methodName: string, arg: ArrayBuffer) => Promise<Uint8Array | Error>;
+export interface LedgerCanisterOptions {
+    agent?: Agent;
+    canisterId?: Principal;
+    updateCallOverride?: Fetcher;
+    queryCallOverride?: Fetcher;
+}

package/dist/types/types/option.d.ts

@@ -0,0 +1 @@
+export declare type Option<T> = T | undefined;

package/dist/types/utils/agent.utils.d.ts

@@ -0,0 +1,5 @@
+import { Agent } from "@dfinity/agent";
+/**
+ * @returns The default agent to use. An agent that connects to mainnet with the anonymous identity.
+ */
+export declare const defaultAgent: () => Agent;

package/dist/types/utils/converter.utils.d.ts

@@ -0,0 +1,18 @@
+import { Principal } from "@dfinity/principal";
+import { AccountIdentifier, SubAccount } from "../types/common";
+export declare const uint8ArrayToBigInt: (array: Uint8Array) => bigint;
+export declare const bigIntToUint8Array: (value: bigint) => Uint8Array;
+export declare const arrayBufferToArrayOfNumber: (buffer: ArrayBuffer) => Array<number>;
+export declare const arrayOfNumberToUint8Array: (numbers: Array<number>) => Uint8Array;
+export declare const arrayOfNumberToArrayBuffer: (numbers: Array<number>) => ArrayBuffer;
+export declare const arrayBufferToNumber: (buffer: ArrayBuffer) => number;
+export declare const numberToArrayBuffer: (value: number, byteLength: number) => ArrayBuffer;
+export declare const asciiStringToByteArray: (text: string) => Array<number>;
+export declare const toSubAccountId: (subAccount: Array<number>) => number;
+export declare const fromSubAccountId: (subAccountId: number) => Array<number>;
+export declare const accountIdentifierToBytes: (accountIdentifier: AccountIdentifier) => Uint8Array;
+export declare const accountIdentifierFromBytes: (accountIdentifier: Uint8Array) => AccountIdentifier;
+export declare const principalToAccountIdentifier: (principal: Principal, subAccount?: Uint8Array | undefined) => string;
+export declare const principalToSubAccount: (principal: Principal) => SubAccount;
+export declare const toHexString: (bytes: Uint8Array) => string;
+export declare const calculateCrc32: (bytes: Uint8Array) => Uint8Array;

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@dfinity/nns",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "A library for interfacing with the Internet Computer's Network Nervous System.",
+  "license": "Apache-2.0",
   "main": "dist/cjs/index.cjs.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "rmdir": "node ./scripts/rmdir.mjs",
     "ts-declaration": "tsc --emitDeclarationOnly --outDir dist/types",
+    "did": "scripts/compile-idl-js",
     "build": "npm run rmdir && node esbuild.mjs && npm run ts-declaration",
     "test": "jest",
     "doc": "typedoc ./src/index.ts",
@@ -23,18 +26,16 @@
     "@dfinity/agent": "^0.10.2",
     "@dfinity/candid": "^0.10.2",
     "@dfinity/principal": "^0.10.2",
+    "crc": "^3.8.0",
     "crc-32": "^1.2.0",
     "google-protobuf": "^3.19.1",
     "js-sha256": "^0.9.0"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.16.11",
     "@types/google-protobuf": "^3.15.5",
     "@types/jest": "^27.0.3",
     "@types/text-encoding": "^0.0.36",
     "@typescript-eslint/eslint-plugin": "^5.4.0",
-    "babel-jest": "^27.4.6",
-    "babelify": "^10.0.0",
     "esbuild": "^0.14.14",
     "eslint": "^7.29.0",
     "eslint-config-standard": "^16.0.3",
@@ -44,6 +45,7 @@
     "jest": "^27.3.1",
     "jest-mock-extended": "^2.0.4",
     "prettier": "^2.5.0",
+    "prettier-plugin-organize-imports": "^2.3.4",
     "text-encoding": "^0.7.0",
     "ts-jest": "^27.0.7",
     "ts-protoc-gen": "^0.15.0",
@@ -51,12 +53,12 @@
     "typescript": "^4.5.2",
     "whatwg-fetch": "^3.6.2"
   },
-  "browserify": {
-    "transform": [
-      [
-        "babelify"
-      ]
-    ]
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dfinity/nns-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dfinity/nns-js"
   },
   "keywords": [
     "internet computer",

package/dist/esm/chunk-AAXRCEPL.js

@@ -1,2 +0,0 @@
-import{a,b as s,c as d,e as i}from"./chunk-QXLTRMTU.js";var u=({IDL:e})=>{let n=e.Record({id:e.Nat64}),t=e.Record({name:e.Text,description:e.Opt(e.Text)}),o=e.Record({id:e.Opt(n),known_neuron_data:e.Opt(t)}),r=e.Record({known_neurons:e.Vec(o)});return e.Service({list_known_neurons:e.Func([],[r],["query"])})};var p=({IDL:e})=>{let n=e.Record({id:e.Nat64}),t=e.Record({name:e.Text,description:e.Opt(e.Text)}),o=e.Record({id:e.Opt(n),known_neuron_data:e.Opt(t)}),r=e.Record({known_neurons:e.Vec(o)});return e.Service({list_known_neurons:e.Func([],[r],[])})};var w=a.fromText("rrkah-fqaaa-aaaaa-aaaaq-cai"),c=class{constructor(n,t){this.service=n;this.certifiedService=t}static create(n={}){let t=n.agent??N(),o=n.canisterId??w,r=n.serviceOverride??i.createActor(u,{agent:t,canisterId:o}),v=n.certifiedServiceOverride??i.createActor(p,{agent:t,canisterId:o});return new c(r,v)}listKnownNeurons=async(n=!0)=>(await(n?this.certifiedService:this.service).list_known_neurons()).known_neurons.map(r=>({id:r.id[0]?.id??BigInt(0),name:r.known_neuron_data[0]?.name??"",description:r.known_neuron_data[0]?.description[0]}))};function N(){return new d({host:"https://ic0.app",identity:new s})}export{c as a};
-//# sourceMappingURL=chunk-AAXRCEPL.js.map

package/dist/esm/chunk-AAXRCEPL.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../candid/governance.idl.js", "../../candid/governance.certified.idl.js", "../../src/governance.ts"],
-  "sourcesContent": ["export const idlFactory = ({ IDL }) => {\n  const NeuronId = IDL.Record({ 'id' : IDL.Nat64 });\n  const KnownNeuronData = IDL.Record({\n    'name' : IDL.Text,\n    'description' : IDL.Opt(IDL.Text),\n  });\n  const KnownNeuron = IDL.Record({\n    'id' : IDL.Opt(NeuronId),\n    'known_neuron_data' : IDL.Opt(KnownNeuronData),\n  });\n  const ListKnownNeuronsResponse = IDL.Record({\n    'known_neurons' : IDL.Vec(KnownNeuron),\n  });\n  return IDL.Service({\n    'list_known_neurons' : IDL.Func([], [ListKnownNeuronsResponse], ['query']),\n  });\n};\nexport const init = ({ IDL }) => { return []; };\n", "export const idlFactory = ({ IDL }) => {\n  const NeuronId = IDL.Record({ 'id' : IDL.Nat64 });\n  const KnownNeuronData = IDL.Record({\n    'name' : IDL.Text,\n    'description' : IDL.Opt(IDL.Text),\n  });\n  const KnownNeuron = IDL.Record({\n    'id' : IDL.Opt(NeuronId),\n    'known_neuron_data' : IDL.Opt(KnownNeuronData),\n  });\n  const ListKnownNeuronsResponse = IDL.Record({\n    'known_neurons' : IDL.Vec(KnownNeuron),\n  });\n  return IDL.Service({\n    'list_known_neurons' : IDL.Func([], [ListKnownNeuronsResponse], []),\n  });\n};\nexport const init = ({ IDL }) => { return []; };\n", "import { Actor, Agent, AnonymousIdentity, HttpAgent } from \"@dfinity/agent\";\nimport { Principal } from \"@dfinity/principal\";\nimport { GovernanceService, idlFactory } from \"../candid/governance.idl\";\nimport { idlFactory as certifiedIdlFactory } from \"../candid/governance.certified.idl\";\n\nconst MAINNET_GOVERNANCE_CANISTER_ID = Principal.fromText(\n  \"rrkah-fqaaa-aaaaa-aaaaq-cai\"\n);\n\ntype NeuronId = bigint;\n\nexport type KnownNeuron = {\n  id: NeuronId,\n  name: string,\n  description: string | undefined\n};\n\n// HttpAgent options that can be used at construction.\nexport interface GovernanceCanisterOptions {\n  // The agent to use when communicating with the governance canister.\n  agent?: Agent;\n  // The governance canister's ID.\n  canisterId?: Principal;\n  // The default service to use when calling into the IC. Primarily overridden\n  // in test for mocking.\n  serviceOverride?: GovernanceService;\n  // The service to use when making 'certified' calls into the IC (as in, using\n  // update calls in place of queries). Primarily overridden in test for\n  // mocking.\n  certifiedServiceOverride?: GovernanceService;\n}\n\nexport class GovernanceCanister {\n  private constructor(\n    private readonly service: GovernanceService,\n    private readonly certifiedService: GovernanceService\n  ) {}\n\n  public static create(options: GovernanceCanisterOptions = {}) {\n    const agent = options.agent ?? defaultAgent();\n    const canisterId = options.canisterId ?? MAINNET_GOVERNANCE_CANISTER_ID;\n\n    const service = options.serviceOverride ??\n      Actor.createActor<GovernanceService>(idlFactory, {\n        agent,\n        canisterId,\n      });\n\n    const certifiedService = options.certifiedServiceOverride ??\n      Actor.createActor<GovernanceService>(certifiedIdlFactory, {\n        agent,\n        canisterId,\n      });\n\n    return new GovernanceCanister(service, certifiedService);\n  }\n\n  /**\n   * Returns the list of neurons who have been approved by the community to\n   * appear as the default followee options.\n   *\n   * If `certified` is true, the request is fetched as an update call, otherwise\n   * it is fetched using a query call.\n   */\n  public listKnownNeurons = async (\n    certified = true\n  ): Promise<KnownNeuron[]> => {\n    const service = certified ? this.certifiedService : this.service;\n    const response = await service.list_known_neurons();\n\n    return response.known_neurons.map(n => ({\n      id: n.id[0]?.id ?? BigInt(0),\n      name: n.known_neuron_data[0]?.name ?? \"\",\n      description: n.known_neuron_data[0]?.description[0]\n    }));\n  };\n}\n\n/**\n * @returns The default agent to use. An agent that connects to mainnet with the anonymous identity.\n */\nfunction defaultAgent(): Agent {\n  return new HttpAgent({\n    host: \"https://ic0.app\",\n    identity: new AnonymousIdentity(),\n  });\n}\n"],
-  "mappings": "wDAAO,GAAM,GAAa,CAAC,CAAE,SAAU,CACrC,GAAM,GAAW,EAAI,OAAO,CAAE,GAAO,EAAI,QACnC,EAAkB,EAAI,OAAO,CACjC,KAAS,EAAI,KACb,YAAgB,EAAI,IAAI,EAAI,QAExB,EAAc,EAAI,OAAO,CAC7B,GAAO,EAAI,IAAI,GACf,kBAAsB,EAAI,IAAI,KAE1B,EAA2B,EAAI,OAAO,CAC1C,cAAkB,EAAI,IAAI,KAE5B,MAAO,GAAI,QAAQ,CACjB,mBAAuB,EAAI,KAAK,GAAI,CAAC,GAA2B,CAAC,aCd9D,GAAM,GAAa,CAAC,CAAE,SAAU,CACrC,GAAM,GAAW,EAAI,OAAO,CAAE,GAAO,EAAI,QACnC,EAAkB,EAAI,OAAO,CACjC,KAAS,EAAI,KACb,YAAgB,EAAI,IAAI,EAAI,QAExB,EAAc,EAAI,OAAO,CAC7B,GAAO,EAAI,IAAI,GACf,kBAAsB,EAAI,IAAI,KAE1B,EAA2B,EAAI,OAAO,CAC1C,cAAkB,EAAI,IAAI,KAE5B,MAAO,GAAI,QAAQ,CACjB,mBAAuB,EAAI,KAAK,GAAI,CAAC,GAA2B,OCTpE,GAAM,GAAiC,EAAU,SAC/C,+BA0BK,OAAyB,CACtB,YACW,EACA,EACjB,CAFiB,eACA,8BAGL,QAAO,EAAqC,GAAI,CAC5D,GAAM,GAAQ,EAAQ,OAAS,IACzB,EAAa,EAAQ,YAAc,EAEnC,EAAU,EAAQ,iBACtB,EAAM,YAA+B,EAAY,CAC/C,QACA,eAGE,EAAmB,EAAQ,0BAC/B,EAAM,YAA+B,EAAqB,CACxD,QACA,eAGJ,MAAO,IAAI,GAAmB,EAAS,GAUlC,iBAAmB,MACxB,EAAY,KAKL,AAFU,MAAM,AADP,GAAY,KAAK,iBAAmB,KAAK,SAC1B,sBAEf,cAAc,IAAI,GAAM,EACtC,GAAI,EAAE,GAAG,IAAI,IAAM,OAAO,GAC1B,KAAM,EAAE,kBAAkB,IAAI,MAAQ,GACtC,YAAa,EAAE,kBAAkB,IAAI,YAAY,OAQvD,YAA+B,CAC7B,MAAO,IAAI,GAAU,CACnB,KAAM,kBACN,SAAU,GAAI",
-  "names": []
-}