@dfinity/nns 0.1.7 → 0.2.1

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ledger.ts", "../../src/types/ledger.ts", "../../src/utils/proto.utils.ts"],
+  "sourcesContent": ["import { Agent } from \"@dfinity/agent\";\nimport { Principal } from \"@dfinity/principal\";\nimport {\n  AccountBalanceRequest,\n  BlockHeight as PbBlockHeight,\n  ICPTs,\n  Memo,\n  Payment,\n  SendRequest,\n} from \"../proto/ledger_pb\";\nimport { AccountIdentifier } from \"./account_identifier\";\nimport { MAINNET_LEDGER_CANISTER_ID } from \"./constants/canister_ids\";\nimport { ICP } from \"./icp\";\nimport { BlockHeight } from \"./types/common\";\nimport {\n  Fetcher,\n  InsufficientFunds,\n  InvalidSender,\n  LedgerCanisterOptions,\n  TransferError,\n  TxCreatedInFuture,\n  TxDuplicate,\n  TxTooOld,\n} from \"./types/ledger\";\nimport { defaultAgent } from \"./utils/agent.utils\";\nimport { queryCall, updateCall } from \"./utils/proto.utils\";\n\nexport class LedgerCanister {\n  private constructor(\n    private readonly agent: Agent,\n    private readonly canisterId: Principal,\n    private readonly updateFetcher: Fetcher,\n    private readonly queryFetcher: Fetcher\n  ) {}\n\n  public static create(options: LedgerCanisterOptions = {}) {\n    return new LedgerCanister(\n      options.agent ?? defaultAgent(),\n      options.canisterId ?? MAINNET_LEDGER_CANISTER_ID,\n      options.updateCallOverride ?? updateCall,\n      options.queryCallOverride ?? queryCall\n    );\n  }\n\n  /**\n   * Returns the balance of the specified account identifier.\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 accountBalance = async ({\n    accountIdentifier,\n    certified = true,\n  }: {\n    accountIdentifier: AccountIdentifier;\n    certified?: boolean;\n  }): Promise<ICP> => {\n    const callMethod = certified ? this.updateFetcher : this.queryFetcher;\n\n    const request = new AccountBalanceRequest();\n    request.setAccount(accountIdentifier.toProto());\n    const responseBytes = await callMethod(\n      this.agent,\n      this.canisterId,\n      \"account_balance_pb\",\n      request.serializeBinary()\n    );\n\n    if (responseBytes instanceof Error) {\n      // An error is never expected from this endpoint.\n      throw Error;\n    }\n\n    return ICP.fromE8s(\n      BigInt(ICPTs.deserializeBinary(new Uint8Array(responseBytes)).getE8s())\n    );\n  };\n\n  /**\n   * Transfer ICP from the caller to the destination `accountIdentifier`.\n   * Returns the index of the block containing the tx if it was successful.\n   *\n   * TODO: support remaining options (subaccounts, memos, etc.)\n   */\n  public transfer = async ({\n    to,\n    amount,\n    memo,\n  }: {\n    to: AccountIdentifier;\n    amount: ICP;\n    memo?: bigint;\n  }): Promise<BlockHeight | TransferError> => {\n    const request = new SendRequest();\n    request.setTo(to.toProto());\n\n    const payment = new Payment();\n    payment.setReceiverGets(amount.toProto());\n    request.setPayment(payment);\n\n    if (memo) {\n      const memo = new Memo();\n      memo.setMemo(memo.toString());\n      request.setMemo(memo);\n    }\n\n    const responseBytes = await this.updateFetcher(\n      this.agent,\n      this.canisterId,\n      \"send_pb\",\n      request.serializeBinary()\n    );\n\n    if (responseBytes instanceof Error) {\n      if (responseBytes.message.includes(\"Reject code: 5\")) {\n        // Match against the different error types.\n        // This string matching is fragile. It's a stop-gap solution until\n        // we migrate to the candid interface.\n\n        if (responseBytes.message.match(/Sending from (.*) is not allowed/)) {\n          return new InvalidSender();\n        }\n\n        {\n          const m = responseBytes.message.match(\n            /transaction.*duplicate.* in block (\\d+)/\n          );\n          if (m && m.length > 1) {\n            return new TxDuplicate(BigInt(m[1]));\n          }\n        }\n\n        {\n          const m = responseBytes.message.match(\n            /debit account.*, current balance: (\\d*(\\.\\d*)?)/\n          );\n          if (m && m.length > 1) {\n            const balance = ICP.fromString(m[1]);\n            if (balance instanceof ICP) {\n              return new InsufficientFunds(balance);\n            }\n          }\n        }\n\n        if (responseBytes.message.includes(\"is in future\")) {\n          return new TxCreatedInFuture();\n        }\n\n        {\n          const m = responseBytes.message.match(/older than (\\d+)/);\n          if (m && m.length > 1) {\n            return new TxTooOld(Number.parseInt(m[1]));\n          }\n        }\n      }\n\n      // Unknown error. Throw as-is.\n      throw responseBytes;\n    }\n\n    // Successful tx. Return the block height.\n    return BigInt(PbBlockHeight.deserializeBinary(responseBytes).getHeight());\n  };\n}\n", "import { Agent } from \"@dfinity/agent\";\nimport { Principal } from \"@dfinity/principal\";\nimport { ICP } from \"../icp\";\n\nexport type BlockHeight = bigint;\n\nexport type TransferError =\n  | InvalidSender\n  | InsufficientFunds\n  | TxTooOld\n  | TxCreatedInFuture\n  | TxDuplicate\n  | BadFee;\n\nexport class InvalidSender {}\nexport class BadFee {}\nexport class InsufficientFunds {\n  constructor(public readonly balance: ICP) {}\n}\nexport class TxTooOld {\n  constructor(public readonly allowed_window_secs: number) {}\n}\nexport class TxCreatedInFuture {}\nexport class TxDuplicate {\n  constructor(public readonly duplicateOf: BlockHeight) {}\n}\n\nexport type Fetcher = (\n  agent: Agent,\n  canisterId: Principal,\n  methodName: string,\n  arg: ArrayBuffer\n) => Promise<Uint8Array | Error>;\n\n// HttpAgent options that can be used at construction.\nexport interface LedgerCanisterOptions {\n  // The agent to use when communicating with the ledger canister.\n  agent?: Agent;\n  // The ledger canister's ID.\n  canisterId?: Principal;\n  // The method to use for performing an update call. Primarily overridden\n  // in test for mocking.\n  updateCallOverride?: Fetcher;\n  // The method to use for performing a query call. Primarily overridden\n  // in test for mocking.\n  queryCallOverride?: Fetcher;\n}\n", "import { Agent, polling } from \"@dfinity/agent\";\nimport { Principal } from \"@dfinity/principal\";\n\n/**\n * Submits an update call to the IC.\n * @returns The (binary) response if the request succeeded, an error otherwise.\n */\nexport const updateCall = async (\n  agent: Agent,\n  canisterId: Principal,\n  methodName: string,\n  arg: ArrayBuffer\n): Promise<Uint8Array | Error> => {\n  const submitResponse = await agent.call(canisterId, {\n    methodName,\n    arg,\n    effectiveCanisterId: canisterId,\n  });\n\n  if (!submitResponse.response.ok) {\n    return Error(\n      [\n        \"Call failed:\",\n        `  Method: ${methodName}`,\n        `  Canister ID: ${canisterId}`,\n        `  Request ID: ${submitResponse.requestId}`,\n        `  HTTP status code: ${submitResponse.response.status}`,\n        `  HTTP status text: ${submitResponse.response.statusText}`,\n      ].join(\"\\n\")\n    );\n  }\n\n  try {\n    const blob = await polling.pollForResponse(\n      agent,\n      canisterId,\n      submitResponse.requestId,\n      polling.defaultStrategy()\n    );\n    return new Uint8Array(blob);\n  } catch (err) {\n    if (err instanceof Error) {\n      // Return errors rather than throw them so that callers are forced to handle them.\n      return err;\n    }\n\n    // Something very wrong happened, and we don't know how to deal with it. Throw as-is.\n    throw err;\n  }\n};\n\n/**\n * Submits a query call to the IC.\n * @returns The (binary) response if the request succeeded, an error otherwise.\n */\nexport const queryCall = async (\n  agent: Agent,\n  canisterId: Principal,\n  methodName: string,\n  arg: ArrayBuffer\n): Promise<Uint8Array | Error> => {\n  const queryResponse = await agent.query(canisterId, {\n    methodName,\n    arg,\n  });\n\n  if (queryResponse.status == \"rejected\") {\n    return new Error(\n      [\n        \"Call failed:\",\n        `  Method: ${methodName}`,\n        `  Canister ID: ${canisterId}`,\n        `  HTTP status code: ${queryResponse.reject_code}`,\n        `  HTTP status text: ${queryResponse.reject_message}`,\n      ].join(\"\\n\")\n    );\n  }\n\n  return new Uint8Array(queryResponse.reply.arg);\n};\n"],
+  "mappings": "8KAEA,MAOO,OCKA,WAAoB,GACpB,OAAa,GACb,OAAwB,CAC7B,YAA4B,EAAc,CAAd,iBAEvB,OAAe,CACpB,YAA4B,EAA6B,CAA7B,6BAEvB,OAAwB,GACxB,OAAkB,CACvB,YAA4B,EAA0B,CAA1B,qBCjBvB,GAAM,GAAa,MACxB,EACA,EACA,EACA,IACgC,CAChC,GAAM,GAAiB,KAAM,GAAM,KAAK,EAAY,CAClD,aACA,MACA,oBAAqB,IAGvB,GAAI,CAAC,EAAe,SAAS,GAC3B,MAAO,OACL,CACE,eACA,aAAa,IACb,kBAAkB,IAClB,iBAAiB,EAAe,YAChC,uBAAuB,EAAe,SAAS,SAC/C,uBAAuB,EAAe,SAAS,cAC/C,KAAK;AAAA,IAIX,GAAI,CACF,GAAM,GAAO,KAAM,GAAQ,gBACzB,EACA,EACA,EAAe,UACf,EAAQ,mBAEV,MAAO,IAAI,YAAW,SACf,EAAP,CACA,GAAI,YAAe,OAEjB,MAAO,GAIT,KAAM,KAQG,EAAY,MACvB,EACA,EACA,EACA,IACgC,CAChC,GAAM,GAAgB,KAAM,GAAM,MAAM,EAAY,CAClD,aACA,QAGF,MAAI,GAAc,QAAU,WACnB,GAAI,OACT,CACE,eACA,aAAa,IACb,kBAAkB,IAClB,uBAAuB,EAAc,cACrC,uBAAuB,EAAc,kBACrC,KAAK;AAAA,IAIJ,GAAI,YAAW,EAAc,MAAM,MFnDrC,WAAqB,CAClB,YACW,EACA,EACA,EACA,EACjB,CAJiB,aACA,kBACA,qBACA,0BAGL,QAAO,EAAiC,GAAI,CACxD,MAAO,IAAI,GACT,EAAQ,OAAS,IACjB,EAAQ,YAAc,EACtB,EAAQ,oBAAsB,EAC9B,EAAQ,mBAAqB,GAU1B,eAAiB,MAAO,CAC7B,oBACA,YAAY,MAIM,CAClB,GAAM,GAAa,EAAY,KAAK,cAAgB,KAAK,aAEnD,EAAU,GAAI,yBACpB,EAAQ,WAAW,EAAkB,WACrC,GAAM,GAAgB,KAAM,GAC1B,KAAK,MACL,KAAK,WACL,qBACA,EAAQ,mBAGV,GAAI,YAAyB,OAE3B,KAAM,OAGR,MAAO,GAAI,QACT,OAAO,QAAM,kBAAkB,GAAI,YAAW,IAAgB,YAU3D,SAAW,MAAO,CACvB,KACA,SACA,UAK0C,CAC1C,GAAM,GAAU,GAAI,eACpB,EAAQ,MAAM,EAAG,WAEjB,GAAM,GAAU,GAAI,WAIpB,GAHA,EAAQ,gBAAgB,EAAO,WAC/B,EAAQ,WAAW,GAEf,EAAM,CACR,GAAM,GAAO,GAAI,QACjB,EAAK,QAAQ,EAAK,YAClB,EAAQ,QAAQ,GAGlB,GAAM,GAAgB,KAAM,MAAK,cAC/B,KAAK,MACL,KAAK,WACL,UACA,EAAQ,mBAGV,GAAI,YAAyB,OAAO,CAClC,GAAI,EAAc,QAAQ,SAAS,kBAAmB,CAKpD,GAAI,EAAc,QAAQ,MAAM,oCAC9B,MAAO,IAAI,GAGb,CACE,GAAM,GAAI,EAAc,QAAQ,MAC9B,2CAEF,GAAI,GAAK,EAAE,OAAS,EAClB,MAAO,IAAI,GAAY,OAAO,EAAE,KAIpC,CACE,GAAM,GAAI,EAAc,QAAQ,MAC9B,mDAEF,GAAI,GAAK,EAAE,OAAS,EAAG,CACrB,GAAM,GAAU,EAAI,WAAW,EAAE,IACjC,GAAI,YAAmB,GACrB,MAAO,IAAI,GAAkB,IAKnC,GAAI,EAAc,QAAQ,SAAS,gBACjC,MAAO,IAAI,GAGb,CACE,GAAM,GAAI,EAAc,QAAQ,MAAM,oBACtC,GAAI,GAAK,EAAE,OAAS,EAClB,MAAO,IAAI,GAAS,OAAO,SAAS,EAAE,MAM5C,KAAM,GAIR,MAAO,QAAO,cAAc,kBAAkB,GAAe",
+  "names": []
+}

package/dist/esm/governance.js

@@ -1,2 +1,2 @@
-import{a}from"./chunk-AAXRCEPL.js";import"./chunk-QXLTRMTU.js";import"./chunk-AV2V5I5D.js";import"./chunk-UJYSTOZE.js";export{a as GovernanceCanister};
+import{g as a}from"./chunk-RPOIUQZO.js";import"./chunk-LNMGZ6W7.js";import"./chunk-HMU24NWJ.js";import"./chunk-FVDRR6PO.js";import"./chunk-4FZAJTYF.js";export{a as GovernanceCanister};
 //# sourceMappingURL=governance.js.map

package/dist/esm/icp.js

@@ -1,2 +1,2 @@
-import{a,b}from"./chunk-YXM7FYC5.js";import"./chunk-NR65YN67.js";import"./chunk-UJYSTOZE.js";export{b as FromStringError,a as ICP};
+import{b as a}from"./chunk-X2SHUWG3.js";import"./chunk-NYI672WX.js";import"./chunk-4FZAJTYF.js";export{a as ICP};
 //# sourceMappingURL=icp.js.map

package/dist/esm/index.js

@@ -1,2 +1,2 @@
-import{a as r,b as e}from"./chunk-XN3QHASA.js";import{a as o}from"./chunk-AAXRCEPL.js";import{g as n}from"./chunk-RKZCM7KO.js";import"./chunk-QXLTRMTU.js";import"./chunk-AV2V5I5D.js";import{a as t}from"./chunk-YXM7FYC5.js";import"./chunk-NR65YN67.js";import"./chunk-UJYSTOZE.js";export{r as AccountIdentifier,o as GovernanceCanister,t as ICP,n as LedgerCanister,e as SubAccount};
+import{a as r,b as o}from"./chunk-SO23SIWX.js";import{a as m,b as p,c as x,d as n,e as c,f as i,g as e}from"./chunk-RPOIUQZO.js";import"./chunk-LNMGZ6W7.js";import{a as u,b as C,c as d,d as s,e as A,f as I,g as f}from"./chunk-YL3F3CIN.js";import"./chunk-HMU24NWJ.js";import"./chunk-FVDRR6PO.js";import{a,b as t}from"./chunk-X2SHUWG3.js";import"./chunk-NYI672WX.js";import"./chunk-4FZAJTYF.js";export{r as AccountIdentifier,C as BadFee,a as FromICPStringError,e as GovernanceCanister,t as ICP,d as InsufficientFunds,u as InvalidSender,f as LedgerCanister,m as NeuronState,p as ProposalRewardStatus,x as ProposalStatus,o as SubAccount,c as Topic,A as TxCreatedInFuture,I as TxDuplicate,s as TxTooOld,i as UnsupportedValueError,n as Vote};
 //# sourceMappingURL=index.js.map

package/dist/esm/ledger.js

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f,g}from"./chunk-RKZCM7KO.js";import"./chunk-QXLTRMTU.js";import"./chunk-AV2V5I5D.js";import"./chunk-YXM7FYC5.js";import"./chunk-NR65YN67.js";import"./chunk-UJYSTOZE.js";export{b as BadFee,c as InsufficientFunds,a as InvalidSender,g as LedgerCanister,e as TxCreatedInFuture,f as TxDuplicate,d as TxTooOld};
+import{g as a}from"./chunk-YL3F3CIN.js";import"./chunk-HMU24NWJ.js";import"./chunk-FVDRR6PO.js";import"./chunk-X2SHUWG3.js";import"./chunk-NYI672WX.js";import"./chunk-4FZAJTYF.js";export{a as LedgerCanister};
 //# sourceMappingURL=ledger.js.map

package/dist/types/account_identifier.d.ts

@@ -1,10 +1,13 @@
-import { AccountIdentifier as AccountIdentifierPb } from "../proto/ledger_pb";
 import { Principal } from "@dfinity/principal";
+import { AccountIdentifier as AccountIdentifierPb } from "../proto/ledger_pb";
 export declare class AccountIdentifier {
     private readonly bytes;
     private constructor();
     static fromHex(hex: string): AccountIdentifier;
-    static fromPrincipal(principal: Principal, subAccount?: SubAccount): AccountIdentifier;
+    static fromPrincipal({ principal, subAccount, }: {
+        principal: Principal;
+        subAccount?: SubAccount;
+    }): AccountIdentifier;
     /**
      * @returns An AccountIdentifier protobuf object.
      */

package/dist/types/canisters/governance/payloads.d.ts

@@ -0,0 +1,3 @@
+import { Option } from "../../types/option";
+export declare const getNnsFunctionName: (nnsFunction: number) => string;
+export declare const convertNnsFunctionPayload: (nnsFunction: number, payload: ArrayBuffer) => Option<Record<string, unknown>>;

package/dist/types/canisters/governance/request.converters.d.ts

@@ -0,0 +1,27 @@
+import { ListNeurons as RawListNeurons, ListProposalInfo, ManageNeuron as RawManageNeuron } from "../../../candid/governanceTypes.d";
+import { ClaimNeuronRequest, ClaimOrRefreshNeuronRequest, DisburseToNeuronRequest, ListProposalsRequest, MakeProposalRequest, ManageNeuron, SplitRequest } from "../../types/governance_converters";
+export declare class RequestConverters {
+    private readonly principal?;
+    constructor();
+    fromListNeurons: (neuronIds?: bigint[] | undefined) => RawListNeurons;
+    fromManageNeuron: (manageNeuron: ManageNeuron) => RawManageNeuron;
+    fromClaimNeuronRequest: (request: ClaimNeuronRequest) => [Array<number>, bigint, bigint];
+    fromListProposalsRequest: (request: ListProposalsRequest) => ListProposalInfo;
+    fromClaimOrRefreshNeuronRequest: (request: ClaimOrRefreshNeuronRequest) => RawManageNeuron;
+    fromSplitRequest: (request: SplitRequest) => RawManageNeuron;
+    fromDisburseToNeuronRequest: (request: DisburseToNeuronRequest) => RawManageNeuron;
+    fromMakeProposalRequest: (request: MakeProposalRequest) => RawManageNeuron;
+    private fromFollowees;
+    private fromNeuronId;
+    private fromNeuronIdOrSubaccount;
+    private fromProposalId;
+    private fromAction;
+    private fromCommand;
+    private fromOperation;
+    private fromChange;
+    private fromNodeProvider;
+    private fromAmount;
+    private fromAccountIdentifier;
+    private fromRewardMode;
+    private fromClaimOrRefreshBy;
+}

package/dist/types/canisters/governance/response.converters.d.ts

@@ -0,0 +1,35 @@
+import { Principal } from "@dfinity/principal";
+import { KnownNeuron as RawKnownNeuron, ListNeuronsResponse as RawListNeuronsResponse, ListProposalInfoResponse as RawListProposalInfoResponse, ManageNeuronResponse as RawManageNeuronResponse, ProposalInfo as RawProposalInfo } from "../../../candid/governanceTypes.d";
+import { NeuronId } from "../../types/common";
+import { DisburseToNeuronResponse, KnownNeuron, ListProposalsResponse, MakeProposalResponse, NeuronInfo, ProposalInfo } from "../../types/governance_converters";
+import { Option } from "../../types/option";
+export declare class ResponseConverters {
+    toProposalInfo: (proposalInfo: RawProposalInfo) => ProposalInfo;
+    toArrayOfNeuronInfo: (response: RawListNeuronsResponse, principal: Principal) => Array<NeuronInfo>;
+    private toNeuronInfo;
+    toListProposalsResponse: (response: RawListProposalInfoResponse) => ListProposalsResponse;
+    toKnownNeuron: (response: RawKnownNeuron) => KnownNeuron;
+    toSplitResponse: (response: RawManageNeuronResponse) => NeuronId;
+    toDisburseToNeuronResult: (response: RawManageNeuronResponse) => DisburseToNeuronResponse;
+    toClaimOrRefreshNeuronResponse: (response: RawManageNeuronResponse) => Option<NeuronId>;
+    toMakeProposalResponse: (response: RawManageNeuronResponse) => MakeProposalResponse;
+    private toNeuron;
+    private toBallotInfo;
+    private toDissolveState;
+    private toFollowees;
+    private toNeuronId;
+    private toNeuronIdOrSubaccount;
+    private toBallot;
+    private toProposal;
+    private toAction;
+    private toTally;
+    private toCommand;
+    private toOperation;
+    private toChange;
+    private toNodeProvider;
+    private toAmount;
+    private toAccountIdentifier;
+    private toRewardMode;
+    private toClaimOrRefreshBy;
+    private throwUnrecognisedTypeError;
+}

package/dist/types/constants/canister_ids.d.ts

@@ -0,0 +1,4 @@
+import { Principal } from "@dfinity/principal";
+export declare const GOVERNANCE_CANISTER_ID: Principal;
+export declare const MAINNET_GOVERNANCE_CANISTER_ID: Principal;
+export declare const MAINNET_LEDGER_CANISTER_ID: Principal;

package/dist/types/constants/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const SUB_ACCOUNT_BYTE_LENGTH = 32;
+export declare const CREATE_CANISTER_MEMO: bigint;
+export declare const TOP_UP_CANISTER_MEMO: bigint;
+export declare const TRANSACTION_FEE: bigint;
+export declare const E8S_PER_ICP: bigint;

package/dist/types/governance.d.ts

@@ -1,23 +1,28 @@
-import { Agent } from "@dfinity/agent";
-import { Principal } from "@dfinity/principal";
-import { GovernanceService } from "../candid/governance.idl";
-declare type NeuronId = bigint;
-export declare type KnownNeuron = {
-    id: NeuronId;
-    name: string;
-    description: string | undefined;
-};
-export interface GovernanceCanisterOptions {
-    agent?: Agent;
-    canisterId?: Principal;
-    serviceOverride?: GovernanceService;
-    certifiedServiceOverride?: GovernanceService;
-}
+import { NeuronId } from "./types/common";
+import { GovernanceCanisterOptions } from "./types/governance";
+import { KnownNeuron, ListProposalsRequest, ListProposalsResponse, NeuronInfo } from "./types/governance_converters";
 export declare class GovernanceCanister {
     private readonly service;
     private readonly certifiedService;
+    private readonly requestConverters;
+    private readonly responseConverters;
+    private readonly myPrincipal?;
     private constructor();
     static create(options?: GovernanceCanisterOptions): GovernanceCanister;
+    /**
+     * Returns the list of neurons controlled by the caller.
+     *
+     * If an array of neuron IDs is provided, precisely those neurons will be fetched.
+     *
+     * If `certified` is true, the request is fetched as an update call, otherwise
+     * it is fetched using a query call.
+     *
+     * TODO: Decide: The library method is getNeurons but the raw method is list_neurons.  Do we want this inconsistency?
+     */
+    getNeurons: ({ certified, neuronIds, }: {
+        certified: boolean;
+        neuronIds?: bigint[] | undefined;
+    }) => Promise<NeuronInfo[]>;
     /**
      * Returns the list of neurons who have been approved by the community to
      * appear as the default followee options.
@@ -26,5 +31,15 @@ export declare class GovernanceCanister {
      * it is fetched using a query call.
      */
     listKnownNeurons: (certified?: boolean) => Promise<KnownNeuron[]>;
+    /**
+     * Returns the list of proposals made for the community to vote on,
+     * paginated and filtered by the request.
+     *
+     * If `certified` is true (default), the request is fetched as an update call, otherwise
+     * it is fetched using a query call.
+     */
+    listProposals: ({ request, certified, }: {
+        request: ListProposalsRequest;
+        certified?: boolean | undefined;
+    }) => Promise<ListProposalsResponse>;
 }
-export {};

package/dist/types/icp.d.ts

@@ -1,4 +1,5 @@
 import { ICPTs } from "../proto/ledger_pb";
+import { FromICPStringError } from "./types/icp";
 export declare class ICP {
     private e8s;
     private constructor();
@@ -10,11 +11,7 @@ export declare class ICP {
      * 1'234'567.8901
      * 1,234,567.8901
      */
-    static fromString(amount: string): ICP | FromStringError;
+    static fromString(amount: string): ICP | FromICPStringError;
     toE8s(): bigint;
     toProto(): ICPTs;
 }
-export declare enum FromStringError {
-    FRACTIONAL_MORE_THAN_8_DECIMALS = 0,
-    INVALID_FORMAT = 1
-}

package/dist/types/index.d.ts

@@ -1,4 +1,8 @@
-export { GovernanceCanister } from "./governance";
-export { LedgerCanister } from "./ledger";
 export { AccountIdentifier, SubAccount } from "./account_identifier";
+export { GovernanceCanister } from "./governance";
 export { ICP } from "./icp";
+export { LedgerCanister } from "./ledger";
+export * from "./types/governance";
+export * from "./types/governance_converters";
+export * from "./types/icp";
+export * from "./types/ledger";

package/dist/types/ledger.d.ts

@@ -1,34 +1,7 @@
-import { Agent } from "@dfinity/agent";
-import { Principal } from "@dfinity/principal";
 import { AccountIdentifier } from "./account_identifier";
 import { ICP } from "./icp";
-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);
-}
-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;
-}
+import { BlockHeight } from "./types/common";
+import { LedgerCanisterOptions, TransferError } from "./types/ledger";
 export declare class LedgerCanister {
     private readonly agent;
     private readonly canisterId;
@@ -42,13 +15,19 @@ export declare class LedgerCanister {
      * If `certified` is true, the request is fetched as an update call, otherwise
      * it is fetched using a query call.
      */
-    accountBalance: (accountIdentifier: AccountIdentifier, certified?: boolean) => Promise<ICP>;
+    accountBalance: ({ accountIdentifier, certified, }: {
+        accountIdentifier: AccountIdentifier;
+        certified?: boolean | undefined;
+    }) => Promise<ICP>;
     /**
      * Transfer ICP from the caller to the destination `accountIdentifier`.
      * Returns the index of the block containing the tx if it was successful.
      *
      * TODO: support remaining options (subaccounts, memos, etc.)
      */
-    transfer: (to: AccountIdentifier, amount: ICP, memo?: bigint | undefined) => Promise<BlockHeight | TransferError>;
+    transfer: ({ to, amount, memo, }: {
+        to: AccountIdentifier;
+        amount: ICP;
+        memo?: bigint | undefined;
+    }) => Promise<BlockHeight | TransferError>;
 }
-export {};

package/dist/types/types/common.d.ts

@@ -0,0 +1,8 @@
+export declare type CanisterIdString = string;
+export declare type NeuronId = bigint;
+export declare type AccountIdentifier = string;
+export declare type BlockHeight = bigint;
+export declare type E8s = bigint;
+export declare type Memo = bigint;
+export declare type PrincipalString = string;
+export declare type SubAccount = Uint8Array;

package/dist/types/types/governance.d.ts

@@ -0,0 +1,9 @@
+import { Agent } from "@dfinity/agent";
+import { Principal } from "@dfinity/principal";
+import { GovernanceService } from "../../candid/governance.idl";
+export interface GovernanceCanisterOptions {
+    agent?: Agent;
+    canisterId?: Principal;
+    serviceOverride?: GovernanceService;
+    certifiedServiceOverride?: GovernanceService;
+}