@agoric/governance 0.12.0-u23.0 → 0.12.0-u23.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/governance",
-  "version": "0.12.0-u23.0",
+  "version": "0.12.0-u23.1",
   "description": "Core governance support",
   "type": "module",
   "main": "src/index.js",
@@ -29,13 +29,13 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/ertp": "0.18.0-u23.0",
-    "@agoric/internal": "0.5.0-u23.0",
-    "@agoric/notifier": "0.8.0-u23.0",
+    "@agoric/ertp": "0.18.0-u23.1",
+    "@agoric/internal": "0.5.0-u23.1",
+    "@agoric/notifier": "0.8.0-u23.1",
     "@agoric/store": "0.11.0-u23.0",
     "@agoric/time": "0.5.0-u23.0",
-    "@agoric/vat-data": "0.7.0-u23.0",
-    "@agoric/zoe": "0.28.0-u23.0",
+    "@agoric/vat-data": "0.7.0-u23.1",
+    "@agoric/zoe": "0.28.0-u23.1",
     "@endo/bundle-source": "^4.1.2",
     "@endo/captp": "^4.4.8",
     "@endo/errors": "^1.2.13",
@@ -47,7 +47,7 @@
     "import-meta-resolve": "^4.1.0"
   },
   "devDependencies": {
-    "@agoric/swingset-vat": "0.34.0-u23.0",
+    "@agoric/swingset-vat": "0.34.0-u23.1",
     "@endo/bundle-source": "^4.1.2",
     "@endo/init": "^1.1.12",
     "ava": "^6.4.1",
@@ -76,5 +76,5 @@
   "typeCoverage": {
     "atLeast": 89.5
   },
-  "gitHead": "1147be15b0704de17204d04e2407fa3192b98a1c"
+  "gitHead": "6a6343510742fef366aa7b4a31a862f9ef409656"
 }

package/source-spec-registry.d.ts

@@ -0,0 +1,49 @@
+export namespace governanceSourceSpecRegistry {
+    namespace binaryVoteCounter {
+        let bundleName: string;
+        let packagePath: string;
+        let sourceSpec: string;
+    }
+    namespace committee {
+        let bundleName_1: string;
+        export { bundleName_1 as bundleName };
+        let packagePath_1: string;
+        export { packagePath_1 as packagePath };
+        let sourceSpec_1: string;
+        export { sourceSpec_1 as sourceSpec };
+    }
+    namespace contractGovernor {
+        let bundleName_2: string;
+        export { bundleName_2 as bundleName };
+        let packagePath_2: string;
+        export { packagePath_2 as packagePath };
+        let sourceSpec_2: string;
+        export { sourceSpec_2 as sourceSpec };
+    }
+    namespace puppetContractGovernor {
+        let bundleName_3: string;
+        export { bundleName_3 as bundleName };
+        let packagePath_3: string;
+        export { packagePath_3 as packagePath };
+        let sourceSpec_3: string;
+        export { sourceSpec_3 as sourceSpec };
+    }
+}
+export function getGovernanceSourceSpec(name: keyof typeof governanceSourceSpecRegistry): {
+    bundleName: string;
+    packagePath: string;
+    sourceSpec: string;
+} | {
+    bundleName: string;
+    packagePath: string;
+    sourceSpec: string;
+} | {
+    bundleName: string;
+    packagePath: string;
+    sourceSpec: string;
+} | {
+    bundleName: string;
+    packagePath: string;
+    sourceSpec: string;
+};
+//# sourceMappingURL=source-spec-registry.d.ts.map

package/source-spec-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-spec-registry.d.ts","sourceRoot":"","sources":["source-spec-registry.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCO,8CADK,MAAM,OAAO,4BAA4B;;;;;;;;;;;;;;;;EAEjB"}

package/src/binaryVoteCounter.d.ts

@@ -0,0 +1,21 @@
+/** @type {BuildVoteCounter} */
+export const makeBinaryVoteCounter: BuildVoteCounter;
+/**
+ * @param {ZCF<{questionSpec: QuestionSpec, quorumThreshold: bigint}>} zcf
+ * @param {{outcomePublisher: Publisher<OutcomeRecord>}} outcomePublisher
+ */
+export function start(zcf: ZCF<{
+    questionSpec: QuestionSpec;
+    quorumThreshold: bigint;
+}>, { outcomePublisher }: {
+    outcomePublisher: Publisher<OutcomeRecord>;
+}): {
+    publicFacet: import("./types.js").VoteCounterPublicFacet;
+    creatorFacet: import("./types.js").VoteCounterCreatorFacet;
+};
+import type { BuildVoteCounter } from './types.js';
+import type { QuestionSpec } from './types.js';
+import type { ZCF } from '@agoric/zoe';
+import type { OutcomeRecord } from './types.js';
+import type { Publisher } from '@agoric/notifier';
+//# sourceMappingURL=binaryVoteCounter.d.ts.map

package/src/binaryVoteCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaryVoteCounter.d.ts","sourceRoot":"","sources":["binaryVoteCounter.js"],"names":[],"mappings":"AA+CA,+BAA+B;AAC/B,oCADW,gBAAgB,CA8JzB;AAMF;;;GAGG;AACH,2BAHW,IAAI;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAC,CAAC,wBAC1D;IAAC,gBAAgB,EAAE,UAAU,aAAa,CAAC,CAAA;CAAC;;;EAoBtD;sCAjNyF,YAAY;kCAAZ,YAAY;yBADhF,aAAa;mCACuD,YAAY;+BAF1E,kBAAkB"}

package/src/breakTie.d.ts

@@ -0,0 +1,3 @@
+export function breakTie(positions: Position[], n: number): Position[];
+import type { Position } from './types.js';
+//# sourceMappingURL=breakTie.d.ts.map

package/src/breakTie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakTie.d.ts","sourceRoot":"","sources":["breakTie.js"],"names":[],"mappings":"AA4BO,oCAJI,QAAQ,EAAE,KACV,MAAM,GACJ,QAAQ,EAAE,CAItB;8BA7B0B,YAAY"}

package/src/closingRule.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @import {CloseVoting} from './types.js';
+ */
+/** @type {CloseVoting} */
+export const scheduleClose: CloseVoting;
+import type { CloseVoting } from './types.js';
+//# sourceMappingURL=closingRule.d.ts.map

package/src/closingRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closingRule.d.ts","sourceRoot":"","sources":["closingRule.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH,0BAA0B;AAC1B,4BADW,WAAW,CASpB;iCAZ4B,YAAY"}

package/src/committee.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @import {Handle} from '@agoric/zoe';
+ * @import {Remote} from '@agoric/internal';
+ * @import {StoredPublishKit} from '@agoric/notifier';
+ * @import {MapStore} from '@agoric/swingset-liveslots';
+ * @import {ContractMeta, Invitation, ZCF} from '@agoric/zoe';
+ * @import {ElectorateCreatorFacet, CommitteeElectoratePublic, QuestionDetails, OutcomeRecord, AddQuestion} from './types.js';
+ * @import {Baggage} from '@agoric/vat-data';
+ * @import {QuestionRecord} from './electorateTools.js';
+ * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
+ */
+/**
+ * @typedef { ElectorateCreatorFacet & {
+ *   getVoterInvitations: () => Promise<Invitation<{ voter: { castBallotFor(handle: any, choice?: any, ): void}}>>[]
+ * }} CommitteeElectorateCreatorFacet
+ */
+/** @type {ContractMeta<typeof start>} */
+export const meta: ContractMeta<typeof start>;
+export function start(zcf: ZCF<{
+    committeeName: string;
+    committeeSize: number;
+}>, privateArgs: {
+    storageNode: Remote<StorageNode>;
+    marshaller: Remote<Marshaller>;
+}, baggage: Baggage): {
+    creatorFacet: CommitteeElectorateCreatorFacet;
+    publicFacet: CommitteeElectoratePublic;
+};
+export type CommitteeElectorateCreatorFacet = ElectorateCreatorFacet & {
+    getVoterInvitations: () => Promise<Invitation<{
+        voter: {
+            castBallotFor(handle: any, choice?: any): void;
+        };
+    }>>[];
+};
+import type { ContractMeta } from '@agoric/zoe';
+import type { ZCF } from '@agoric/zoe';
+import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Remote } from '@agoric/internal';
+import type { Marshaller } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Baggage } from '@agoric/vat-data';
+import type { CommitteeElectoratePublic } from './types.js';
+import type { ElectorateCreatorFacet } from './types.js';
+import type { Invitation } from '@agoric/zoe';
+//# sourceMappingURL=committee.d.ts.map

package/src/committee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"committee.d.ts","sourceRoot":"","sources":["committee.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AAEH,yCAAyC;AACzC,mBADW,aAAa,OAAO,KAAK,CAAC,CAOnC;AAoBK,2BARI,IAAI;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,eACM;IAAE,WAAW,EAAE,OAAO,WAAW,CAAC,CAAC;IAAC,UAAU,EAAE,OAAO,UAAU,CAAC,CAAA;CAAC,WACnE,OAAO,GACL;IAAC,YAAY,EAAE,+BAA+B,CAAC;IAAC,WAAW,EAAE,yBAAyB,CAAA;CAAC,CAuInG;8CArKa,sBAAsB,GAAG;IAClC,mBAAmB,EAAE,MAAM,OAAO,CAAC,WAAW;QAAE,KAAK,EAAE;YAAE,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAK,IAAI,CAAA;SAAC,CAAA;KAAC,CAAC,CAAC,EAAE,CAAA;CAChH;kCAX4C,aAAa;yBAAb,aAAa;iCAI/B,0CAA0C;4BAP/C,kBAAkB;gCAQd,0CAA0C;6BAH7C,kBAAkB;+CADqE,YAAY;4CAAZ,YAAY;gCAD7E,aAAa"}

package/src/constants.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Enum of parameter types
+ *
+ * UNKNOWN is an escape hatch for types we haven't added yet. If you are
+ * developing a new contract and use UNKNOWN, please also file an issue to ask
+ * us to support the new type.
+ */
+export type ParamType = (typeof ParamType)[keyof typeof ParamType];
+export namespace ParamType {
+    let AMOUNT: "amount";
+    let BRAND: "brand";
+    let INSTALLATION: "installation";
+    let INSTANCE: "instance";
+    let INVITATION: "invitation";
+    let NAT: "nat";
+    let RATIO: "ratio";
+    let STRING: "string";
+    let PASSABLE_RECORD: "record";
+    let TIMESTAMP: "timestamp";
+    let RELATIVE_TIME: "relativeTime";
+    let UNKNOWN: "unknown";
+}
+export namespace ParamTypes {
+    let AMOUNT_1: "amount";
+    export { AMOUNT_1 as AMOUNT };
+    let BRAND_1: "brand";
+    export { BRAND_1 as BRAND };
+    let INSTALLATION_1: "installation";
+    export { INSTALLATION_1 as INSTALLATION };
+    let INSTANCE_1: "instance";
+    export { INSTANCE_1 as INSTANCE };
+    let INVITATION_1: "invitation";
+    export { INVITATION_1 as INVITATION };
+    let NAT_1: "nat";
+    export { NAT_1 as NAT };
+    let RATIO_1: "ratio";
+    export { RATIO_1 as RATIO };
+    let STRING_1: "string";
+    export { STRING_1 as STRING };
+    let PASSABLE_RECORD_1: "record";
+    export { PASSABLE_RECORD_1 as PASSABLE_RECORD };
+    let TIMESTAMP_1: "timestamp";
+    export { TIMESTAMP_1 as TIMESTAMP };
+    let RELATIVE_TIME_1: "relativeTime";
+    export { RELATIVE_TIME_1 as RELATIVE_TIME };
+    let UNKNOWN_1: "unknown";
+    export { UNKNOWN_1 as UNKNOWN };
+}
+//# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["constants.js"],"names":[],"mappings":";;;;;;;wBAMU,CAAA,OAAO,SAAS,EAAC,MAAM,OAAO,SAAS,CAAC"}

package/src/contractGovernance/assertions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @import {Brand} from '@agoric/ertp';
+ */
+export function makeLooksLikeBrand(name: any): (brand: Brand) => void;
+export function makeAssertInstallation(name: any): (installation: any) => void;
+export function makeAssertInstance(name: any): (instance: any) => void;
+export function makeAssertBrandedRatio(name: any, modelRatio: any): (ratio: any) => boolean;
+export function assertRelativeTime(value: any): void;
+export function assertTimestamp(value: any): void;
+import type { Brand } from '@agoric/ertp';
+//# sourceMappingURL=assertions.d.ts.map

package/src/contractGovernance/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["assertions.js"],"names":[],"mappings":"AAMA;;GAEG;AAEH,gDAES,OADK,KACA,UAGb;AAGD,oDACS,iBAAY,UAKpB;AAGD,gDACS,aAAQ,UAKhB;AAGD,qEACS,UAAK,aAQb;AAGD,qDAEC;AAGD,kDAEC;2BAhDuB,cAAc"}

package/src/contractGovernance/governApi.d.ts

@@ -0,0 +1,41 @@
+/**
+ * manage contracts that allow governance to invoke functions.
+ *
+ * @param {() => ERef<GovernedApis>} getGovernedApis
+ * @param {() => Promise<Array<string | symbol>>} getGovernedNames names of the governed API methods
+ * @param {ERef<TimerService>} timer
+ * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
+ * @returns {ApiGovernor}
+ */
+export function setupApiGovernance(getGovernedApis: () => ERef<GovernedApis>, getGovernedNames: () => Promise<Array<string | symbol>>, timer: ERef<TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>): ApiGovernor;
+/**
+ * @import {ContractMeta, Installation, Instance, Invitation, ZCF} from '@agoric/zoe';
+ * @import {Passable, RemotableObject} from '@endo/pass-style';
+ * @import {Position, ApiGovernor, ApiInvocationIssue, PoserFacet, VoteOnApiInvocation, GovernedApis} from '../types.js';
+ * @import {TimerService} from '@agoric/time';
+ * @import {ERef} from '@agoric/vow';
+ */
+/**
+ * Make a pair of positions for a question about whether to invoke an API. If
+ * the vote passes, the method will be called on the governedApis facet with the
+ * arguments that were provided.
+ *
+ * @param {string} apiMethodName
+ * @param {Passable[]} methodArgs
+ */
+export function makeApiInvocationPositions(apiMethodName: string, methodArgs: Passable[]): {
+    positive: {
+        apiMethodName: string;
+        methodArgs: Passable[];
+    };
+    negative: {
+        dontInvoke: string;
+    };
+};
+import type { GovernedApis } from '../types.js';
+import type { ERef } from '@agoric/vow';
+import type { TimerService } from '@agoric/time';
+import type { PoserFacet } from '../types.js';
+import type { ApiGovernor } from '../types.js';
+import type { Passable } from '@endo/pass-style';
+//# sourceMappingURL=governApi.d.ts.map

package/src/contractGovernance/governApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governApi.d.ts","sourceRoot":"","sources":["governApi.js"],"names":[],"mappings":"AAkCA;;;;;;;;GAQG;AACH,oDANW,MAAM,KAAK,YAAY,CAAC,oBACxB,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,SACrC,KAAK,YAAY,CAAC,wBAClB,MAAM,OAAO,CAAC,UAAU,CAAC,GACvB,WAAW,CA4FvB;AAzHD;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,0DAHW,MAAM,cACN,QAAQ,EAAE;;;;;;;;EAMpB;kCAjB0G,aAAa;0BAEjG,aAAa;kCADL,cAAc;gCAD8D,aAAa;iCAAb,aAAa;8BAD5E,kBAAkB"}

package/src/contractGovernance/governFilter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Setup to allow governance to block some invitations.
+ *
+ * @param {ERef<TimerService>} timer
+ * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
+ * @param {GovernedCreatorFacet<{}>} governedCF
+ * @returns {FilterGovernor}
+ */
+export function setupFilterGovernance(timer: ERef<TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>, governedCF: GovernedCreatorFacet<{}>): FilterGovernor;
+/**
+ * @import {ContractMeta, Installation, Instance, Invitation, ZCF} from '@agoric/zoe';
+ * @import {Position, ApiGovernor, ApiInvocationIssue, PoserFacet, VoteOnApiInvocation, FilterGovernor, GovernedCreatorFacet, OfferFilterIssue, VoteOnOfferFilter} from '../types.js';
+ * @import {TimerService} from '@agoric/time';
+ * @import {ERef} from '@agoric/vow';
+ */
+/**
+ * Make a pair of positions for a question about whether to update the offer
+ * filter. If the vote passes, the list of blocked invitation strings will be
+ * updated.
+ *
+ * @param {string[]} strings
+ */
+export function makeOfferFilterPositions(strings: string[]): {
+    positive: {
+        strings: string[];
+    };
+    negative: {
+        dontUpdate: string[];
+    };
+};
+import type { TimerService } from '@agoric/time';
+import type { ERef } from '@agoric/vow';
+import type { PoserFacet } from '../types.js';
+import type { GovernedCreatorFacet } from '../types.js';
+import type { FilterGovernor } from '../types.js';
+//# sourceMappingURL=governFilter.d.ts.map

package/src/contractGovernance/governFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governFilter.d.ts","sourceRoot":"","sources":["governFilter.js"],"names":[],"mappings":"AAgCA;;;;;;;GAOG;AACH,6CALW,KAAK,YAAY,CAAC,wBAClB,MAAM,OAAO,CAAC,UAAU,CAAC,cACzB,qBAAqB,EAAE,CAAC,GACtB,cAAc,CAqE1B;AA/FD;;;;;GAKG;AAEH;;;;;;GAMG;AACH,kDAFW,MAAM,EAAE;;;;;;;EAMlB;kCAf8B,cAAc;0BACtB,aAAa;gCAFoI,aAAa;0CAAb,aAAa;oCAAb,aAAa"}

package/src/contractGovernance/governParam.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @param {() => ERef<ParamManagerRetriever>} paramManagerRetrieverAccessor
+ * @param {Instance} contractInstance
+ * @param {TimerService} timer
+ * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
+ * @returns {ParamGovernor}
+ */
+export function setupParamGovernance(paramManagerRetrieverAccessor: () => ERef<ParamManagerRetriever>, contractInstance: Instance, timer: TimerService, getUpdatedPoserFacet: () => Promise<PoserFacet>): ParamGovernor;
+/**
+ * Return a record containing the positive and negative positions for a
+ * question on changing the param to the proposedValue.
+ *
+ * @param {Record<string, ParamValue>} changes
+ * @returns {ParamChangePositions}
+ */
+export function makeParamChangePositions(changes: Record<string, ParamValue>): ParamChangePositions;
+/**
+ * assert that the parameter described by paramSpec is proposed to be changed in
+ * the question described by questionSpec.
+ *
+ * @param {{ parameterName: string, paramPath: unknown}} paramSpec
+ * @param {QuestionSpec<ParamChangeIssue>} questionSpec
+ */
+export function assertBallotConcernsParam(paramSpec: {
+    parameterName: string;
+    paramPath: unknown;
+}, questionSpec: QuestionSpec<ParamChangeIssue>): void;
+/**
+ * @import {ContractMeta, Installation, Instance, Invitation, ZCF} from '@agoric/zoe';
+ * @import {ParamValue, ParamChangePositions, QuestionSpec, ChangeParamsPosition, ParamChangeIssue, ParamGovernor, ParamManagerRetriever, PoserFacet, VoteOnParamChanges} from '../types.js';
+ * @import {TimerService} from '@agoric/time';
+ * @import {Passable} from '@endo/marshal';
+ * @import {ERef} from '@agoric/vow';
+ */
+/**
+ * The electorate that governs changes to the contract's parameters. It must be
+ * declared in the governed contract.
+ */
+export const CONTRACT_ELECTORATE: "Electorate";
+import type { ParamManagerRetriever } from '../types.js';
+import type { ERef } from '@agoric/vow';
+import type { Instance } from '@agoric/zoe';
+import type { TimerService } from '@agoric/time';
+import type { PoserFacet } from '../types.js';
+import type { ParamGovernor } from '../types.js';
+import type { ParamValue } from '../types.js';
+import type { ParamChangePositions } from '../types.js';
+import type { ParamChangeIssue } from '../types.js';
+import type { QuestionSpec } from '../types.js';
+//# sourceMappingURL=governParam.d.ts.map

package/src/contractGovernance/governParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governParam.d.ts","sourceRoot":"","sources":["governParam.js"],"names":[],"mappings":"AA4DA;;;;;;GAMG;AACH,oEANW,MAAM,KAAK,qBAAqB,CAAC,oBACjC,QAAQ,SACR,YAAY,wBACZ,MAAM,OAAO,CAAC,UAAU,CAAC,GACvB,aAAa,CA0FzB;AAhID;;;;;;GAMG;AACH,kDAHW,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACxB,oBAAoB,CAQhC;AAED;;;;;;GAMG;AACH,qDAHW;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAC,gBAC5C,aAAa,gBAAgB,CAAC,QAWxC;AA7CD;;;;;;GAMG;AAEH;;;GAGG;AACH,kCAA4B,YAAY,CAAC;2CAVsI,aAAa;0BAGrK,aAAa;8BAJoC,aAAa;kCAEtD,cAAc;gCADkI,aAAa;mCAAb,aAAa;gCAAb,aAAa;0CAAb,aAAa;sCAAb,aAAa;kCAAb,aAAa"}

package/src/contractGovernance/paramManager.d.ts

@@ -0,0 +1,75 @@
+export type ParamManagerBuilder = {
+    addAmount: (name: string, value: Amount) => ParamManagerBuilder;
+    addBrand: (name: string, value: Brand) => ParamManagerBuilder;
+    addInstallation: (name: string, value: Installation) => ParamManagerBuilder;
+    addInstance: (name: string, value: Instance) => ParamManagerBuilder;
+    addInvitation: (name: string, value: Invitation) => ParamManagerBuilder;
+    addNat: (name: string, value: bigint) => ParamManagerBuilder;
+    addRatio: (name: string, value: Ratio) => ParamManagerBuilder;
+    addRecord: (name: string, value: CopyRecord<any>) => ParamManagerBuilder;
+    addString: (name: string, value: string) => ParamManagerBuilder;
+    addTimestamp: (name: string, value: Timestamp) => ParamManagerBuilder;
+    addRelativeTime: (name: string, value: RelativeTime) => ParamManagerBuilder;
+    addUnknown: (name: string, value: any) => ParamManagerBuilder;
+    build: () => AnyParamManager;
+};
+/**
+ * @import {MapStore} from '@agoric/swingset-liveslots';
+ * @import {ContractMeta, Installation, Instance, Invitation, Keyword, ZCF, ZoeService} from '@agoric/zoe';
+ * @import {AnyParamManager, GovernanceSubscriptionState, ParamManagerBase, ParamStateRecord, ParamValueTyped, UpdateParams} from '../types.js';
+ * @import {CopyRecord} from '@endo/marshal';
+ * @import {Timestamp} from '@agoric/time';
+ * @import {RelativeTime} from '@agoric/time';
+ * @import {StoredPublisherKit} from '@agoric/notifier';
+ * @import {ParamType} from '../constants.js';
+ * @import {Ratio} from '@agoric/ertp';
+ * @import {Amount} from '@agoric/ertp';
+ * @import {Brand} from '@agoric/ertp';
+ * @import {ERef} from '@agoric/vow';
+ */
+/**
+ * @param {ParamManagerBase} paramManager
+ * @param {{[CONTRACT_ELECTORATE]: ParamValueTyped<'invitation'>}} governedParams
+ */
+export function assertElectorateMatches(paramManager: ParamManagerBase, governedParams: {
+    [CONTRACT_ELECTORATE]: ParamValueTyped<"invitation">;
+}): void;
+/**
+ * @typedef {object} ParamManagerBuilder
+ * @property {(name: string, value: Amount) => ParamManagerBuilder} addAmount
+ * @property {(name: string, value: Brand) => ParamManagerBuilder} addBrand
+ * @property {(name: string, value: Installation) => ParamManagerBuilder} addInstallation
+ * @property {(name: string, value: Instance) => ParamManagerBuilder} addInstance
+ * @property {(name: string, value: Invitation) => ParamManagerBuilder} addInvitation
+ * @property {(name: string, value: bigint) => ParamManagerBuilder} addNat
+ * @property {(name: string, value: Ratio) => ParamManagerBuilder} addRatio
+ * @property {(name: string, value: CopyRecord<any>) => ParamManagerBuilder} addRecord
+ * @property {(name: string, value: string) => ParamManagerBuilder} addString
+ * @property {(name: string, value: Timestamp) => ParamManagerBuilder} addTimestamp
+ * @property {(name: string, value: RelativeTime) => ParamManagerBuilder} addRelativeTime
+ * @property {(name: string, value: any) => ParamManagerBuilder} addUnknown
+ * @property {() => AnyParamManager} build
+ */
+/**
+ * @param {StoredPublisherKit<GovernanceSubscriptionState>} publisherKit
+ * @param {ERef<ZoeService>} [zoe]
+ */
+export function makeParamManagerBuilder(publisherKit: StoredPublisherKit<GovernanceSubscriptionState>, zoe?: ERef<ZoeService>): ParamManagerBuilder;
+import type { Amount } from '@agoric/ertp';
+import type { Brand } from '@agoric/ertp';
+import type { Installation } from '@agoric/zoe';
+import type { Instance } from '@agoric/zoe';
+import type { Invitation } from '@agoric/zoe';
+import type { Ratio } from '@agoric/ertp';
+import type { CopyRecord } from '@endo/marshal';
+import type { Timestamp } from '@agoric/time';
+import type { RelativeTime } from '@agoric/time';
+import type { AnyParamManager } from '../types.js';
+import type { ParamManagerBase } from '../types.js';
+import { CONTRACT_ELECTORATE } from './governParam.js';
+import type { ParamValueTyped } from '../types.js';
+import type { GovernanceSubscriptionState } from '../types.js';
+import type { StoredPublisherKit } from '@agoric/notifier';
+import type { ZoeService } from '@agoric/zoe';
+import type { ERef } from '@agoric/vow';
+//# sourceMappingURL=paramManager.d.ts.map

package/src/contractGovernance/paramManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paramManager.d.ts","sourceRoot":"","sources":["paramManager.js"],"names":[],"mappings":";eAqDc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,mBAAmB;cACpD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,mBAAmB;qBACnD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,mBAAmB;iBAC1D,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,mBAAmB;mBACtD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,mBAAmB;YACxD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,mBAAmB;cACpD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,mBAAmB;eACnD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,CAAC,KAAK,mBAAmB;eAC7D,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,mBAAmB;kBACpD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,mBAAmB;qBACvD,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,mBAAmB;gBAC1D,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,mBAAmB;WACjD,MAAM,eAAe;;AA7CnC;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,sDAHW,gBAAgB,kBAChB;IAAC,CAAC,mBAAmB,CAAC,EAAE,gBAAgB,YAAY,CAAC,CAAA;CAAC,QAYhE;AAED;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,sDAHW,mBAAmB,2BAA2B,CAAC,QAC/C,KAAK,UAAU,CAAC,uBAgX1B;4BAxZwB,cAAc;2BACf,cAAc;kCATuD,aAAa;8BAAb,aAAa;gCAAb,aAAa;2BAOlF,cAAc;gCALT,eAAe;+BAChB,cAAc;kCACX,cAAc;qCAHqF,aAAa;sCAAb,aAAa;oCAL3G,kBAAkB;qCAK4E,aAAa;iDAAb,aAAa;wCAI1G,kBAAkB;gCALsC,aAAa;0BAUnF,aAAa"}

package/src/contractGovernance/typedParamManager.d.ts

@@ -0,0 +1,41 @@
+export function makeParamManager<T extends Record<Keyword, AsyncSpecTuple | SyncSpecTuple>>(publisherKit: StoredPublisherKit<GovernanceSubscriptionState>, spec: T, zcf: ZCF): TypedParamManager<{ [K in keyof T]: T[K][0]; }>;
+export function makeParamManagerSync<T extends Record<Keyword, SyncSpecTuple>>(publisherKit: StoredPublisherKit<GovernanceSubscriptionState>, spec: T): TypedParamManager<{ [K in keyof T]: T[K][0]; }>;
+export function makeParamManagerFromTerms<I extends Record<string, Invitation> & {
+    Electorate: Invitation;
+}, M extends ParamTypesMap>(publisherKit: StoredPublisherKit<GovernanceSubscriptionState>, zcf: ZCF<GovernanceTerms<M>>, invitations: I, paramTypesMap: M, overrides?: object): TypedParamManager<M & { [K in keyof I]: "invitation"; }>;
+export type ParamTypesMap = Record<Keyword, ParamType>;
+export type ParamTypesMapFromRecord<M extends ParamStateRecord> = { [R in keyof M]: M[R]["type"]; };
+export type ParamRecordsFromTypes<M extends ParamTypesMap> = { [T in keyof M]: {
+    type: M[T];
+    value: ParamValueForType<M[T]>;
+}; };
+export type Getters<M extends ParamTypesMap> = { [K in keyof M as `get${string & K}`]: () => ParamValueForType<M[K]>; };
+export type Updaters<T extends ParamTypesMap> = { [K in keyof T as `update${string & K}`]: (value: ParamValueForType<T[K]>) => void; };
+export type TypedParamManager<M extends ParamTypesMap> = ParamManagerBase & Getters<M> & Updaters<M> & {
+    readonly: () => Getters<M>;
+} & {
+    updateParams: UpdateParams;
+};
+/**
+ * param spec tuple
+ */
+export type ST<T extends ParamType> = [type: T, value: ParamValueForType<T>];
+export type InvitationParam = {
+    type: "invitation";
+    value: Amount<"set">;
+};
+export type SyncSpecTuple = ST<"amount"> | ST<"brand"> | ST<"installation"> | ST<"instance"> | ST<"nat"> | ST<"ratio"> | ST<"string"> | ST<"timestamp"> | ST<"relativeTime"> | ST<"unknown">;
+export type AsyncSpecTuple = ["invitation", Invitation];
+import type { Keyword } from '@agoric/zoe';
+import type { GovernanceSubscriptionState } from '../types.js';
+import type { StoredPublisherKit } from '@agoric/notifier';
+import type { ZCF } from '@agoric/zoe';
+import type { Invitation } from '@agoric/zoe';
+import type { GovernanceTerms } from '../types.js';
+import type { ParamType } from '../constants.js';
+import type { ParamStateRecord } from '../types.js';
+import type { ParamValueForType } from '../types.js';
+import type { ParamManagerBase } from '../types.js';
+import type { UpdateParams } from '../types.js';
+import type { Amount } from '@agoric/ertp';
+//# sourceMappingURL=typedParamManager.d.ts.map

package/src/contractGovernance/typedParamManager.d.ts.map

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

package/src/contractGovernor.d.ts

@@ -0,0 +1,40 @@
+/** @type {ContractMeta<typeof start>} */
+export const meta: ContractMeta<typeof start>;
+export function validateQuestionDetails(zoe: ERef<ZoeService>, electorate: Instance, details: ParamChangeIssueDetails): Promise<[void, void, void]>;
+export function validateQuestionFromCounter(zoe: ERef<ZoeService>, electorate: Instance, voteCounter: Instance): Promise<[void, void, void]>;
+export function start<SF extends GovernableStartFn>(zcf: ZCF<{
+    timer: TimerService;
+    governedContractInstallation: Installation<SF>;
+    governed: {
+        issuerKeywordRecord: IssuerKeywordRecord;
+        terms: {
+            governedParams: {
+                [CONTRACT_ELECTORATE]: InvitationParam;
+            };
+        };
+        label?: string;
+    };
+}>, privateArgs: {
+    governed: Record<string, unknown>;
+}, baggage: Baggage): Promise<{
+    creatorFacet: GovernorCreatorFacet<SF>;
+    publicFacet: GovernorPublic;
+}>;
+export type ContractGovernorTerms = StandardTerms;
+import type { ContractMeta } from '@agoric/zoe';
+import type { ZoeService } from '@agoric/zoe';
+import type { ERef } from '@agoric/vow';
+import type { Instance } from '@agoric/zoe';
+import type { ParamChangeIssueDetails } from './types.js';
+import type { GovernableStartFn } from './types.js';
+import type { TimerService } from '@agoric/time';
+import type { Installation } from '@agoric/zoe';
+import type { IssuerKeywordRecord } from '@agoric/zoe';
+import { CONTRACT_ELECTORATE } from './contractGovernance/governParam.js';
+import type { InvitationParam } from './contractGovernance/typedParamManager.js';
+import type { ZCF } from '@agoric/zoe';
+import type { Baggage } from '@agoric/vat-data';
+import type { GovernorCreatorFacet } from './types.js';
+import type { GovernorPublic } from './types.js';
+import type { StandardTerms } from '@agoric/zoe';
+//# sourceMappingURL=contractGovernor.d.ts.map

package/src/contractGovernor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractGovernor.d.ts","sourceRoot":"","sources":["contractGovernor.js"],"names":[],"mappings":"AAqBA,yCAAyC;AACzC,mBADW,aAAa,OAAO,KAAK,CAAC,CAGnC;AAYK,6CAJI,KAAK,UAAU,CAAC,cAChB,QAAQ,WACR,uBAAuB,+BAkBjC;AAYM,iDAJI,KAAK,UAAU,CAAC,cAChB,QAAQ,eACR,QAAQ,+BAYlB;AA0FM,sBAnB0B,EAAE,SAAtB,iBAAmB,OACrB,IAAI;IACV,KAAK,EAAE,YAAY,CAAC;IACpB,4BAA4B,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/C,QAAQ,EAAE;QACR,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,KAAK,EAAE;YAAC,cAAc,EAAE;gBAAC,CAAC,mBAAmB,CAAC,EAAE,eAAe,CAAA;aAAC,CAAA;SAAC,CAAC;QAClE,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAA;CACF,CAAC,eACM;IACN,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,WAKO,OAAO,GAJL,OAAO,CAAC;IAChB,YAAY,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACvC,WAAW,EAAE,cAAc,CAAC;CAC7B,CAAC,CA8DJ;oCAjJY,aAAa;kCAnE8F,aAAa;gCAAb,aAAa;0BAK9G,aAAa;8BALoF,aAAa;6CAClC,YAAY;uCAAZ,YAAY;kCAChF,cAAc;kCAF2E,aAAa;yCAAb,aAAa;oCALjG,qCAAqC;qCAQvC,2CAA2C;yBAH2C,aAAa;6BAI3G,kBAAkB;0CAHuD,YAAY;oCAAZ,YAAY;mCADS,aAAa"}

package/src/contractGovernorKit.d.ts

@@ -0,0 +1,50 @@
+export function prepareContractGovernorKit(baggage: Baggage, powers: {
+    timer: TimerService;
+    zoe: ERef<ZoeService>;
+}): (startedInstanceKit: StartedInstanceKit<GovernableStartFn>, limitedCreatorFacet: any) => import("@endo/exo").GuardedKit<{
+    helper: {
+        getElectorateInstance(): Promise<Instance>;
+        getUpdatedPoserFacet(): Promise<PoserFacet>;
+        provideApiGovernance(): Promise<import("./types.js").ApiGovernor>;
+        provideFilterGovernance(): import("./types.js").FilterGovernor;
+        provideParamGovernance(): import("./types.js").ParamGovernor;
+    };
+    creator: {
+        /**
+         * @param {Invitation} poserInvitation
+         * @returns {Promise<void>}
+         */
+        replaceElectorate(poserInvitation: Invitation): Promise<void>;
+        voteOnParamChanges(voteCounterInstallation: Installation, deadline: import("@agoric/time").Timestamp, paramSpec: import("./types.js").ParamChangesSpec): Promise<import("./types.js").ContractGovernanceVoteResult>;
+        voteOnApiInvocation(apiMethodName: string, methodArgs: import("@endo/pass-style").Passable[], voteCounterInstallation: Installation, deadline: import("@agoric/time").Timestamp): Promise<import("./types.js").ContractGovernanceVoteResult>;
+        voteOnOfferFilter(voteCounterInstallation: Installation, deadline: import("@agoric/time").Timestamp, strings: string[]): Promise<import("./types.js").ContractGovernanceVoteResult>;
+        getCreatorFacet(): any;
+        getAdminFacet(): import("@agoric/zoe/src/zoeService/utils.js").AdminFacet<GovernableStartFn>;
+        getInstance(): import("@agoric/zoe/src/zoeService/utils.js").Instance<GovernableStartFn>;
+        getPublicFacet(): object & import("./types.js").GovernedPublicFacetMethods;
+    };
+    public: {
+        getElectorate(): Promise<Instance>;
+        getGovernedContract(): import("@agoric/zoe/src/zoeService/utils.js").Instance<GovernableStartFn>;
+        /** @param {Instance} counter */
+        validateVoteCounter(counter: Instance): Promise<void>;
+        /** @param {Instance} regP */
+        validateElectorate(regP: Instance): Promise<void>;
+        /** @param {ClosingRule} closingRule */
+        validateTimer(closingRule: ClosingRule): void;
+    };
+}>;
+export type ContractGovernorKit = EReturn<EReturn<typeof prepareContractGovernorKit>>;
+import type { Baggage } from '@agoric/vat-data';
+import type { TimerService } from '@agoric/time';
+import type { ZoeService } from '@agoric/zoe';
+import type { ERef } from '@agoric/vow';
+import type { GovernableStartFn } from './types.js';
+import type { StartedInstanceKit } from '@agoric/zoe/src/zoeService/utils.js';
+import type { Instance } from '@agoric/zoe';
+import type { PoserFacet } from './types.js';
+import type { Invitation } from '@agoric/zoe';
+import type { Installation } from '@agoric/zoe';
+import type { ClosingRule } from './types.js';
+import type { EReturn } from '@endo/far';
+//# sourceMappingURL=contractGovernorKit.d.ts.map

package/src/contractGovernorKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractGovernorKit.d.ts","sourceRoot":"","sources":["contractGovernorKit.js"],"names":[],"mappings":"AAyEO,oDANI,OAAO,UACP;IACN,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,KAAK,UAAU,CAAC,CAAC;CACvB;;iCAiCqB,OAAO,CAAC,QAAQ,CAAC;gCAOjB,OAAO,CAAC,UAAU,CAAC;;;;;;QAmEpC;;;WAGG;2CAFQ,UAAU,GACR,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;QAkE1B,gCAAgC;qCAApB,QAAQ;QAepB,6BAA6B;iCAAjB,QAAQ;QAWpB,uCAAuC;mCAA3B,WAAW;;GAY9B;kCAEa,QAAQ,QAAQ,OAAO,0BAA0B,CAAC,CAAC;6BAxQvC,kBAAkB;kCACb,cAAc;gCAHuC,aAAa;0BAM1E,aAAa;uCALgG,YAAY;wCAG3G,qCAAqC;8BAJU,aAAa;gCACmC,YAAY;gCAD5D,aAAa;kCAAb,aAAa;iCACmC,YAAY;6BAFtH,WAAW"}