@agoric/inter-protocol 0.18.0-u23.0 → 0.18.0-u23.1

package/src/price/fluxAggregatorContract.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @import {Baggage} from '@agoric/vat-data'
+ * @import {TimerService} from '@agoric/time'
+ * @import {Remote} from '@agoric/internal';
+ * @import {ChainlinkConfig} from './fluxAggregatorKit.js';
+ * @import {PrioritySendersManager} from '@agoric/internal/src/priority-senders.js';
+ * @import {NameAdmin} from '@agoric/vats';
+ * @import {QuoteKit} from './roundsManager.js';
+ * @import {Invitation} from '@agoric/zoe';
+ * @import {ContractMeta, ZCF} from '@agoric/zoe';
+ * @import {Brand} from '@agoric/ertp';
+ * @import {Amount} from '@agoric/ertp';
+ * @import {Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {ERef} from '@agoric/vow';
+ */
+/** @type {ContractMeta<typeof start>} */
+export const meta: ContractMeta<typeof start>;
+export function start(zcf: ZCF<ChainlinkConfig & {
+    timer: TimerService;
+    brandIn: Brand<"nat">;
+    brandOut: Brand<"nat">;
+    description: string;
+    unitAmountIn?: Amount<"nat">;
+}>, privateArgs: {
+    highPrioritySendersManager?: PrioritySendersManager;
+    initialPoserInvitation: Invitation;
+    marshaller: Remote<Marshaller>;
+    namesByAddressAdmin: ERef<NameAdmin>;
+    storageNode: Remote<StorageNode>;
+}, baggage: Baggage): Promise<{
+    creatorFacet: import("@endo/exo").Guarded<{
+        getParamMgrRetriever: () => {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+                Electorate: "invitation";
+            }>;
+        } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+                Electorate: "invitation";
+            }>;
+        }>;
+        getInvitation: (name: any) => Promise<Invitation>;
+        getLimitedCreatorFacet: () => import("@endo/exo").Guarded<{
+            makeOracleInvitation(oracleId: string): Promise<Invitation<{
+                invitationMakers: {
+                    PushPrice(result: import("./roundsManager.js").PriceRound): Promise<Invitation<void, undefined>>;
+                } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+                    PushPrice(result: import("./roundsManager.js").PriceRound): Promise<Invitation<void, undefined>>;
+                }>;
+                oracle: import("@endo/exo").Guarded<{
+                    pushPrice({ roundId: roundIdRaw, unitPrice: valueRaw, }: PriceDatum): Promise<void>;
+                    getStatus(): OracleStatus;
+                }>;
+            }, undefined>>;
+            removeOracle(oracleId: string): Promise<void>;
+            getRoundData: (roundIdRaw: any) => Promise<import("./roundsManager.js").RoundData>;
+            initOracle(oracleId: string): Promise<import("@endo/exo").GuardedKit<{
+                admin: {
+                    disable(): void;
+                };
+                oracle: {
+                    pushPrice({ roundId: roundIdRaw, unitPrice: valueRaw, }: PriceDatum): Promise<void>;
+                    getStatus(): OracleStatus;
+                };
+            }>>;
+            oracleRoundState(oracleId: string, queriedRoundId: bigint): Promise<RoundState>;
+        }>;
+        getGovernedApis: () => import("@agoric/governance").GovernedApis;
+        getGovernedApiNames: () => string[];
+        setOfferFilter: (strings: any) => Promise<void>;
+    }>;
+    publicFacet: import("@endo/exo").Guarded<{
+        getPriceAuthority(): import("@agoric/zoe/tools/types.js").PriceAuthority;
+        getPublicTopics(): {
+            quotes: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("@agoric/zoe/tools/types.js").PriceDescription>;
+            latestRound: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("./roundsManager.js").LatestRound>;
+        };
+    }>;
+}>;
+export type FluxStartFn = typeof start;
+import type { ContractMeta } from '@agoric/zoe';
+import type { ChainlinkConfig } from './fluxAggregatorKit.js';
+import type { TimerService } from '@agoric/time';
+import type { Brand } from '@agoric/ertp';
+import type { Amount } from '@agoric/ertp';
+import type { ZCF } from '@agoric/zoe';
+import type { PrioritySendersManager } from '@agoric/internal/src/priority-senders.js';
+import type { Invitation } from '@agoric/zoe';
+import type { Marshaller } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Remote } from '@agoric/internal';
+import type { NameAdmin } from '@agoric/vats';
+import type { ERef } from '@agoric/vow';
+import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Baggage } from '@agoric/vat-data';
+//# sourceMappingURL=fluxAggregatorContract.d.ts.map

package/src/price/fluxAggregatorContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluxAggregatorContract.d.ts","sourceRoot":"","sources":["fluxAggregatorContract.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;GAeG;AAEH,yCAAyC;AACzC,mBADW,aAAa,OAAO,KAAK,CAAC,CAoBnC;AA0BK,2BAlBI,IACV,eAAmB,GAAG;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;IACtB,QAAQ,EAAE,MAAM,KAAK,CAAC,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC;CAC9B,CACF,eACO;IACN,0BAA0B,CAAC,EAAE,sBAAsB,CAAC;IACpD,sBAAsB,EAAE,UAAU,CAAC;IACnC,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC;IAC/B,mBAAmB,EAAE,KAAK,SAAS,CAAC,CAAC;IACrC,WAAW,EAAE,OAAO,WAAW,CAAC,CAAC;CAClC,WACO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuIjB;0BAGa,OAAO,KAAK;kCA9LU,aAAa;qCALf,wBAAwB;kCAF3B,cAAc;2BAQrB,cAAc;4BACb,cAAc;yBAFH,aAAa;4CAJR,0CAA0C;gCAGtD,aAAa;gCAIb,0CAA0C;4BAT9C,kBAAkB;+BAGf,cAAc;0BAQnB,aAAa;iCADN,0CAA0C;6BAZ9C,kBAAkB"}

package/src/price/fluxAggregatorKit.d.ts

@@ -0,0 +1,114 @@
+export const INVITATION_MAKERS_DESC: "oracle invitation";
+export function prepareFluxAggregatorKit(baggage: Baggage, zcf: ZCF<ChainlinkConfig & {
+    timer: TimerService;
+    brandIn: Brand<"nat">;
+    brandOut: Brand<"nat">;
+    unitAmountIn?: Amount<"nat">;
+}>, timerPresence: TimerService, quoteKit: QuoteKit, storageNode: Remote<StorageNode>, makeDurablePublishKit: () => PublishKit<any>, makeRecorder: MakeRecorder): Promise<() => import("@endo/exo").GuardedKit<{
+    creator: {
+        /**
+         * An "oracle invitation" is an invitation to be able to submit data to
+         * include in the priceAggregator's results.
+         *
+         * The offer result from this invitation is a OracleAdmin, which can be
+         * used directly to manage the price submissions as well as to terminate
+         * the relationship.
+         *
+         * @param {string} oracleId unique per contract instance
+         */
+        makeOracleInvitation(oracleId: string): Promise<import("@agoric/zoe").Invitation<{
+            invitationMakers: {
+                /** @param {PriceRound} result */
+                PushPrice(result: PriceRound): Promise<import("@agoric/zoe").Invitation<void, undefined>>;
+            } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+                /** @param {PriceRound} result */
+                PushPrice(result: PriceRound): Promise<import("@agoric/zoe").Invitation<void, undefined>>;
+            }>;
+            oracle: import("@endo/exo").Guarded<{
+                pushPrice({ roundId: roundIdRaw, unitPrice: valueRaw, }: PriceDatum): Promise<void>;
+                getStatus(): OracleStatus;
+            }>;
+        }, undefined>>;
+        /** @param {string} oracleId */
+        removeOracle(oracleId: string): Promise<void>;
+        getRoundData: (roundIdRaw: any) => Promise<import("./roundsManager.js").RoundData>;
+        /** @param {string} oracleId */
+        initOracle(oracleId: string): Promise<import("@endo/exo").GuardedKit<{
+            admin: {
+                disable(): void;
+            };
+            oracle: {
+                pushPrice({ roundId: roundIdRaw, unitPrice: valueRaw, }: PriceDatum): Promise<void>;
+                getStatus(): OracleStatus;
+            };
+        }>>;
+        /**
+         * a method to provide all current info oracleStatuses need. Intended
+         * only only to be callable by oracleStatuses. Not for use by contracts
+         * to read state.
+         *
+         * @param {string} oracleId
+         * @param {bigint} queriedRoundId
+         * @returns {Promise<RoundState>}
+         */
+        oracleRoundState(oracleId: string, queriedRoundId: bigint): Promise<RoundState>;
+    };
+    public: {
+        getPriceAuthority(): PriceAuthority;
+        getPublicTopics(): {
+            quotes: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<PriceDescription>;
+            latestRound: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<LatestRound>;
+        };
+    };
+}>>;
+export type RoundState = {
+    eligibleForSpecificRound: boolean;
+    queriedRoundId: bigint;
+    latestSubmission: bigint;
+    startedAt: Timestamp;
+    roundTimeout: number;
+    oracleCount: number;
+};
+export type ChainlinkConfig = {
+    maxSubmissionCount: number;
+    minSubmissionCount: number;
+    /**
+     * the number of rounds an Oracle has to wait
+     * before they can initiate a round
+     */
+    restartDelay: bigint;
+    /**
+     * an immutable check for a lower bound of
+     * what submission values are accepted from an oracle
+     */
+    minSubmissionValue: number;
+    /**
+     * an immutable check for an upper bound
+     * of what submission values are accepted from an oracle
+     */
+    maxSubmissionValue: number;
+    /**
+     * the number of seconds after the previous round
+     * that allowed to lapse before allowing an oracle to skip an unfinished
+     * round
+     */
+    timeout: number;
+};
+export type FluxAggregatorKit = EReturn<EReturn<typeof prepareFluxAggregatorKit>>;
+import type { Baggage } from '@agoric/vat-data';
+import type { TimerService } from '@agoric/time';
+import type { Brand } from '@agoric/ertp';
+import type { Amount } from '@agoric/ertp';
+import type { ZCF } from '@agoric/zoe';
+import type { QuoteKit } from './roundsManager.js';
+import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Remote } from '@agoric/internal';
+import type { PublishKit } from '@agoric/notifier';
+import type { MakeRecorder } from '@agoric/zoe/src/contractSupport/recorder.js';
+import type { PriceRound } from './roundsManager.js';
+import type { PriceAuthority } from '@agoric/zoe/tools/types.js';
+import type { PriceDescription } from '@agoric/zoe/tools/types.js';
+import type { LatestRound } from './roundsManager.js';
+import type { Timestamp } from '@agoric/time';
+import type { EReturn } from '@endo/far';
+//# sourceMappingURL=fluxAggregatorKit.d.ts.map

package/src/price/fluxAggregatorKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluxAggregatorKit.d.ts","sourceRoot":"","sources":["fluxAggregatorKit.js"],"names":[],"mappings":"AAuCA,qCAAsC,mBAAmB,CAAC;AAgEnD,kDAfI,OAAO,OACP,IACN,eAAe,GAAG;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;IACtB,QAAQ,EAAE,MAAM,KAAK,CAAC,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC;CAC9B,CACF,iBACO,YAAY,YACZ,QAAQ,eACR,OAAO,WAAW,CAAC,yBACnB,MAAM,WAAW,GAAG,CAAC,gBACrB,YAAY;;QAkJf;;;;;;;;;WASG;uCADQ,MAAM;;gBAiBX,iCAAiC;kCAArB,UAAU;;gBAAtB,iCAAiC;kCAArB,UAAU;;;;;;;QAqB5B,+BAA+B;+BAAnB,MAAM;;QAalB,+BAA+B;6BAAnB,MAAM;;;;;;;;;QAoBlB;;;;;;;;WAQG;mCAHQ,MAAM,kBACN,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC;;;;;;;;;IAqDvC;;8BA3Ua,OAAO;oBACP,MAAM;sBACN,MAAM;eACN,SAAS;kBACT,MAAM;iBACN,MAAM;;;wBAMN,MAAM;wBACN,MAAM;;;;;kBACN,MAAM;;;;;wBAEN,MAAM;;;;;wBAEN,MAAM;;;;;;aAEN,MAAM;;gCA0TN,QAAQ,QAAQ,OAAO,wBAAwB,CAAC,CAAC;6BA1VrC,kBAAkB;kCAKb,cAAc;2BAfrB,cAAc;4BACb,cAAc;yBAPR,aAAa;8BACjB,oBAAoB;iCAOjB,0CAA0C;4BAZjC,kBAAkB;gCAE5B,kBAAkB;kCAIhB,6CAA6C;gCAG/C,oBAAoB;oCAR4C,4BAA4B;sCAA5B,4BAA4B;iCAM3F,oBAAoB;+BActB,cAAc;6BAtBhB,WAAW"}

package/src/price/priceOracleKit.d.ts

@@ -0,0 +1,41 @@
+export const INVITATION_MAKERS_DESC: "oracle invitation";
+export function prepareOracleAdminKit(baggage: any): (args_0: HeldParams) => import("@endo/exo").GuardedKit<{
+    admin: {
+        disable(): void;
+    };
+    oracle: {
+        /**
+         * push a unitPrice result from this oracle
+         *
+         * @param {PriceDatum} datum
+         */
+        pushPrice({ roundId: roundIdRaw, unitPrice: valueRaw, }: PriceDatum): Promise<void>;
+        /** @returns {OracleStatus} */
+        getStatus(): OracleStatus;
+    };
+}>;
+export type HeldParams = {
+    oracleId: string;
+    roundPowers: {
+        handlePush: (status: OracleStatus, result: PriceRound) => Promise<OracleStatus>;
+    };
+};
+export type PriceDatum = {
+    roundId: number | undefined;
+    unitPrice: NatValue;
+};
+export type OracleStatus = {
+    disabled?: boolean | undefined;
+    lastReportedRound: bigint;
+    lastStartedRound: bigint;
+    latestSubmission: bigint;
+    oracleId: string;
+};
+export type ImmutableState = Readonly<HeldParams & {}>;
+export type MutableState = OracleStatus & {};
+export type State = ImmutableState & MutableState;
+export type OracleKit = EReturn<EReturn<typeof prepareOracleAdminKit>>;
+import type { PriceRound } from './roundsManager.js';
+import type { NatValue } from '@agoric/ertp';
+import type { EReturn } from '@endo/far';
+//# sourceMappingURL=priceOracleKit.d.ts.map

package/src/price/priceOracleKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priceOracleKit.d.ts","sourceRoot":"","sources":["priceOracleKit.js"],"names":[],"mappings":"AAMA,qCAAsC,mBAAmB,CAAC;AAkEnD;;;;;QAcC;;;;WAIG;iEADQ,UAAU;QA0BrB,8BAA8B;qBAAhB,YAAY;;GAa/B;yBAjHU;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE;QACX,UAAU,EAAE,CACV,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,YAAY,CAAC,CAAC;KAC5B,CAAC;CACH;yBAGU;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAE;;;uBAKpD,MAAM;sBACN,MAAM;sBACN,MAAM;cACN,MAAM;;6BAGP,QAAQ,CAAC,UAAU,GAAG,EAAE,CAAC;2BAEzB,YAAY,GAAG,EAAE;oBAEhB,cAAc,GAAG,YAAY;wBAyF7B,QAAQ,QAAQ,OAAO,qBAAqB,CAAC,CAAC;gCAxH/B,oBAAoB;8BACtB,cAAc;6BAFf,WAAW"}

package/src/price/roundsManager.d.ts

@@ -0,0 +1,211 @@
+/** @type {bigint} */
+export const ROUND_MAX: bigint;
+export function prepareRoundsManagerKit(baggage: any): (args_0: Readonly<ChainlinkConfig & {
+    quoteKit: QuoteKit;
+    answerPublisher: Publisher<void>;
+    brandIn: Brand<"nat">;
+    brandOut: Brand<"nat">;
+    latestRoundPublisher: Recorder<LatestRound>;
+    timerPresence: TimerService;
+}> & {
+    unitAmountIn: Amount<"nat">;
+}) => import("@endo/exo").GuardedKit<{
+    helper: {
+        /** @param {bigint} roundId */
+        acceptingSubmissions(roundId: bigint): boolean;
+        /**
+         * @param {OracleStatus} status
+         * @param {bigint} roundId
+         */
+        delayed(status: OracleStatus, roundId: bigint): boolean;
+        /** @param {bigint} roundId */
+        deleteRoundDetails(roundId: bigint): void;
+        /** @param {bigint} roundId */
+        isNextRound(roundId: bigint): boolean;
+        /**
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         * @param {string} oracleId
+         */
+        initializeNewRound(roundId: bigint, blockTimestamp: Timestamp, oracleId: string): void;
+        /**
+         * @param {bigint} roundId
+         * @param {bigint} rrId reporting round ID
+         */
+        previousAndCurrentUnanswered(roundId: bigint, rrId: bigint): boolean;
+        /**
+         * @param {bigint} roundId
+         * @param {OracleStatus} status
+         * @param {Timestamp} blockTimestamp
+         * @returns {OracleStatus | undefined} the new status
+         */
+        proposeNewRound(roundId: bigint, status: OracleStatus, blockTimestamp: Timestamp): OracleStatus | undefined;
+        /**
+         * @param {bigint} submission
+         * @param {bigint} roundId
+         * @param {OracleStatus} status
+         * @returns {OracleStatus} the new status
+         */
+        recordSubmission(submission: bigint, roundId: bigint, status: OracleStatus): OracleStatus;
+        /**
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         */
+        supersedable(roundId: bigint, blockTimestamp: Timestamp): boolean;
+        /**
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         */
+        timedOut(roundId: bigint, blockTimestamp: Timestamp): boolean;
+        /**
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         */
+        updateRoundAnswer(roundId: bigint, blockTimestamp: Timestamp): (number | boolean)[] | (bigint | boolean)[];
+        /**
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         */
+        updateTimedOutRoundInfo(roundId: bigint, blockTimestamp: Timestamp): void;
+        /**
+         * @param {OracleStatus} status
+         * @param {bigint} roundId
+         * @param {Timestamp} blockTimestamp
+         * @returns {string | null} error message, if there is one
+         */
+        validateOracleRound(status: OracleStatus, roundId: bigint, blockTimestamp: Timestamp): string | null;
+    };
+    contract: {
+        /** @param {PriceQuoteValue} quote */
+        authenticateQuote(quote: PriceQuoteValue): Promise<{
+            quoteAmount: import("@agoric/ertp").SetAmount<PriceDescription>;
+            quotePayment: import("@agoric/ertp").Payment<"set", PriceDescription>;
+        }>;
+        /**
+         * @param {object} param0
+         * @param {number} [param0.overrideValueOut]
+         * @param {Timestamp} [param0.timestamp]
+         */
+        makeCreateQuote({ overrideValueOut, timestamp }?: {
+            overrideValueOut?: number | undefined;
+            timestamp?: Timestamp | undefined;
+        }): ((priceQuery: any) => Promise<{
+            quoteAmount: import("@agoric/ertp").SetAmount<PriceDescription>;
+            quotePayment: import("@agoric/ertp").Payment<"set", PriceDescription>;
+        }> | undefined) & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, (priceQuery: any) => Promise<{
+            quoteAmount: import("@agoric/ertp").SetAmount<PriceDescription>;
+            quotePayment: import("@agoric/ertp").Payment<"set", PriceDescription>;
+        }> | undefined>;
+        /**
+         * @param {OracleStatus} status
+         * @param {bigint} queriedRoundId
+         * @param {Timestamp} blockTimestamp
+         */
+        eligibleForSpecificRound(status: OracleStatus, queriedRoundId: bigint, blockTimestamp: Timestamp): boolean;
+        /**
+         * consumers are encouraged to check that they're receiving fresh data
+         * by inspecting the updatedAt and answeredInRound return values.
+         *
+         * @param {bigint | number} roundIdRaw
+         * @returns {Promise<RoundData>}
+         */
+        getRoundData(roundIdRaw: bigint | number): Promise<RoundData>;
+        getRoundStatus(roundId: bigint): Readonly<RoundDetails & Round>;
+        /**
+         * a method to provide all current info oracleStatuses need. Intended
+         * only to be callable by oracleStatuses. Not for use by contracts to
+         * read state.
+         *
+         * @param {OracleStatus} status
+         * @param {Timestamp} blockTimestamp
+         */
+        oracleRoundStateSuggestRound(status: OracleStatus, blockTimestamp: Timestamp): {
+            eligibleForSpecificRound: boolean;
+            queriedRoundId: bigint;
+            latestSubmission: bigint;
+            startedAt: Timestamp;
+            roundTimeout: number;
+        };
+    };
+    oracle: {
+        /**
+         * push a unitPrice result from this oracle
+         *
+         * @param {OracleStatus} status
+         * @param {PriceRound} result
+         */
+        handlePush(status: OracleStatus, { roundId: roundIdRaw, unitPrice: valueRaw }: PriceRound): Promise<OracleStatus>;
+    };
+}>;
+export type PriceRound = {
+    roundId: number | undefined;
+    unitPrice: NatValue;
+};
+export type LatestRound = Pick<RoundData, "roundId" | "startedAt"> & {
+    startedBy: string;
+};
+export type RoundData = Round & {
+    roundId: bigint;
+};
+export type Round = {
+    /**
+     * the answer for the given round
+     */
+    answer: bigint;
+    /**
+     * the timestamp when the round was started.
+     * This is 0 if the round hasn't been started yet.
+     */
+    startedAt: Timestamp;
+    /**
+     * the timestamp when the round last was updated
+     * (i.e. answer was last computed)
+     */
+    updatedAt: Timestamp;
+    /**
+     * the round ID of the round in which the
+     * answer was computed. answeredInRound may be smaller than roundId when the
+     * round timed out. answeredInRound is equal to roundId when the round didn't
+     * time out and was completed regularly.
+     */
+    answeredInRound: bigint;
+};
+export type RoundDetails = {
+    submissions: bigint[];
+    maxSubmissions: number;
+    minSubmissions: number;
+    roundTimeout: number;
+};
+export type QuoteKit = IssuerKit<"set", PriceDescription>;
+export type HeldParams = Readonly<ChainlinkConfig & {
+    quoteKit: QuoteKit;
+    answerPublisher: Publisher<void>;
+    brandIn: Brand<"nat">;
+    brandOut: Brand<"nat">;
+    latestRoundPublisher: Recorder<LatestRound>;
+    timerPresence: TimerService;
+}>;
+export type ImmutableState = Readonly<HeldParams & {
+    details: MapStore<bigint, RoundDetails>;
+    rounds: MapStore<bigint, Round>;
+    unitIn: bigint;
+}>;
+export type MutableState = {
+    lastValueOutForUnitIn: bigint | null;
+    reportingRoundId: bigint;
+};
+export type State = ImmutableState & MutableState;
+import type { ChainlinkConfig } from './fluxAggregatorKit.js';
+import type { Publisher } from '@agoric/notifier';
+import type { Brand } from '@agoric/ertp';
+import type { Recorder } from '@agoric/zoe/src/contractSupport/recorder.js';
+import type { TimerService } from '@agoric/time';
+import type { Amount } from '@agoric/ertp';
+import type { OracleStatus } from './priceOracleKit.js';
+import type { Timestamp } from '@agoric/time';
+import type { PriceQuoteValue } from '@agoric/zoe/tools/types.js';
+import type { PriceDescription } from '@agoric/zoe/tools/types.js';
+import type { NatValue } from '@agoric/ertp';
+import type { IssuerKit } from '@agoric/ertp';
+import type { MapStore } from '@agoric/store';
+//# sourceMappingURL=roundsManager.d.ts.map

package/src/price/roundsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundsManager.d.ts","sourceRoot":"","sources":["roundsManager.js"],"names":[],"mappings":"AAiCA,qBAAqB;AACrB,wBADW,MAAM,CAC4B;AAqEtC;cA1BU,QAAQ;qBACD,UAAU,IAAI,CAAC;aACvB,MAAM,KAAK,CAAC;cACX,MAAM,KAAK,CAAC;0BACA,SAAS,WAAW,CAAC;mBAC5B,YAAY;;kBAoDU,OAAO,KAAK,CAAC;;;QA2DjD,8BAA8B;sCAAlB,MAAM;QAQlB;;;WAGG;wBAFQ,YAAY,WACZ,MAAM;QAQjB,8BAA8B;oCAAlB,MAAM;QASlB,8BAA8B;6BAAlB,MAAM;QAMlB;;;;WAIG;oCAHQ,MAAM,kBACN,SAAS,YACT,MAAM;QA4CjB;;;WAGG;8CAFQ,MAAM,QACN,MAAM;QAOjB;;;;;WAKG;iCAJQ,MAAM,UACN,YAAY,kBACZ,SAAS,GACP,YAAY,GAAG,SAAS;QAiBrC;;;;;WAKG;qCAJQ,MAAM,WACN,MAAM,UACN,YAAY,GACV,YAAY;QAwBzB;;;WAGG;8BAFQ,MAAM,kBACN,SAAS;QAWpB;;;WAGG;0BAFQ,MAAM,kBACN,SAAS;QAyBpB;;;WAGG;mCAFQ,MAAM,kBACN,SAAS;QAgCpB;;;WAGG;yCAFQ,MAAM,kBACN,SAAS;QA2BpB;;;;;WAKG;oCAJQ,YAAY,WACZ,MAAM,kBACN,SAAS,GACP,MAAM,GAAG,IAAI;;;QA8B1B,qCAAqC;iCAAzB,eAAe;;;;QAQ3B;;;;WAIG;0DAFA;YAAwB,gBAAgB;YACb,SAAS;SAAC;;;;;;;QAwExC;;;;WAIG;yCAHQ,YAAY,kBACZ,MAAM,kBACN,SAAS;QAmBpB;;;;;;WAMG;iCAFQ,MAAM,GAAG,MAAM,GACb,OAAO,CAAC,SAAS,CAAC;gCAwBV,MAAM,GAAK,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC;QAS9D;;;;;;;WAOG;6CAFQ,YAAY,kBACZ,SAAS;;;;;;;;;QAyDpB;;;;;WAKG;2BAFQ,YAAY,gDACZ,UAAU;;GA6G1B;yBAvuBU;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAE;0BAEpD,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE;wBAG/D,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;YAI3B,MAAM;;;;;eACN,SAAS;;;;;eAET,SAAS;;;;;;;qBAET,MAAM;;;iBAQN,MAAM,EAAE;oBACR,MAAM;oBACN,MAAM;kBACN,MAAM;;uBAGN,UAAU,KAAK,EAAE,gBAAgB,CAAC;yBAGnC,QAAQ,CACpB,eAAmB,GAAG;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,UAAU,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;IACtB,QAAQ,EAAE,MAAM,KAAK,CAAC,CAAC;IACvB,oBAAoB,EAAE,SAAS,WAAW,CAAC,CAAC;IAC5C,aAAa,EAAE,YAAY,CAAC;CAC7B,CACF;6BAGS,QAAQ,CAChB,UAAU,GAAG;IACX,OAAO,EAAE,SAAS,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB,CACF;2BAGS;IACR,qBAAqB,EAAE,MAAM,OAAC,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;oBAEU,cAAc,GAAG,YAAY;qCA/ET,wBAAwB;+BAH9B,kBAAkB;2BAQtB,cAAc;8BAJX,6CAA6C;kCAL9B,cAAc;4BAQ/B,cAAc;kCALR,qBAAqB;+BAHV,cAAc;qCADqC,4BAA4B;sCAA5B,4BAA4B;8BAO9F,cAAc;+BACb,cAAc;8BALL,eAAe"}

package/src/proposals/utils.d.ts

@@ -0,0 +1,27 @@
+export function reserveThenGetNamePaths(nameAdmin: ERef<NameAdmin>, paths: string[][]): Promise<unknown[]>;
+export function reserveThenGetNames(nameAdmin: ERef<NameAdmin>, names: string[]): Promise<any[]>;
+export function reserveThenDeposit(debugName: string, namesByAddressAdmin: ERef<NameAdmin>, addr: string, payments: ERef<Payment>[]): Promise<void>;
+export function makeInstallCache(homeP: Promise<{
+    scratch: ERef<ScratchPad>;
+}>, { installCacheKey, loadBundle }: {
+    loadBundle: (specifier: string) => Promise<{
+        default: Bundle;
+    }>;
+    installCacheKey?: string | undefined;
+}): Promise<{
+    wrapInstall: (install: any) => (mPath: any, bPath: any, opts: any) => Promise<any>;
+    saveCache: () => Promise<void>;
+}>;
+export function oracleBrandFeedName(inBrandName: any, outBrandName: any): string;
+export function scaledPriceFeedName(issuerName: any): string;
+/** @type {(name: string) => string} */
+export const sanitizePathSegment: (name: string) => string;
+export function provideRetiredInstances(consume: Promise<MapStore>, produce: Producer<MapStore>): Promise<MapStore>;
+import type { NameAdmin } from '@agoric/vats';
+import type { ERef } from '@agoric/vow';
+import type { Payment } from '@agoric/ertp';
+import type { ScratchPad } from '@agoric/internal/src/scratch.js';
+import type { Bundle } from '@agoric/swingset-vat';
+import type { MapStore } from '@agoric/store';
+import type { Producer } from '@agoric/vats/src/core/types.js';
+//# sourceMappingURL=utils.d.ts.map

package/src/proposals/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.js"],"names":[],"mappings":"AAuBO,mDAHI,KAAK,SAAS,CAAC,SACf,MAAM,EAAE,EAAE,sBAgCpB;AAOM,+CAJI,KAAK,SAAS,CAAC,SACf,MAAM,EAAE,GACN,OAAO,CAAC,GAAG,EAAE,CAAC,CAMxB;AAQI,8CALI,MAAM,uBACN,KAAK,SAAS,CAAC,QACf,MAAM,YACN,KAAK,OAAO,CAAC,EAAE,iBAwBzB;AA2BM,wCAPI,OAAO,CAAC;IACd,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC;CAC3B,CAAC,mCAEF;IAAkE,UAAU,EAApE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,eAAe;CAAC;oCAkCD,UAAK,EAAE,UAAK,EAAE,SAAI;;GAkBzD;AAEM,iFACsC;AAEtC,6DAC+B;AAEtC,uCAAuC;AACvC,kCADW,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAKjC;AAUK,iDAJI,OAAO,CAAC,QAAQ,CAAC,WACjB,SAAS,QAAQ,CAAC,GAChB,OAAO,CAAC,QAAQ,CAAC,CAW7B;+BAjM2B,cAAc;0BAKnB,aAAa;6BADV,cAAc;gCAHX,iCAAiC;4BACrC,sBAAsB;8BAHV,eAAe;8BAOzB,gCAAgC"}

package/src/provisionPool.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @import {Remote} from '@agoric/internal';
+ * @import {Amount, Brand, Payment, Purse} from '@agoric/ertp';
+ * @import {ContractMeta, Invitation, StandardTerms, ZCF} from '@agoric/zoe';
+ * @import {GovernanceTerms} from '@agoric/governance/src/types.js';
+ * @import {ERef} from '@endo/far';
+ * @import {Bank} from '@agoric/vats/src/vat-bank.js';
+ * @import {MetricsNotification} from './provisionPoolKit.js';
+ * @import {Baggage} from '@agoric/vat-data';
+ * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
+ */
+/** @type {ContractMeta<typeof start>} */
+export const meta: ContractMeta<typeof start>;
+export function start(zcf: ZCF<ProvisionTerms>, privateArgs: {
+    poolBank: ERef<Bank>;
+    initialPoserInvitation: Invitation;
+    storageNode: Remote<StorageNode>;
+    marshaller: Remote<Marshaller>;
+    metricsOverride?: MetricsNotification;
+    governedParamOverrides?: Record<string, Amount | undefined>;
+}, baggage: Baggage): Promise<{
+    creatorFacet: import("@endo/exo").Guarded<{
+        getParamMgrRetriever: () => {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+                PerAccountInitialAmount: "amount";
+            } & {
+                Electorate: "invitation";
+            }>;
+        } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+                PerAccountInitialAmount: "amount";
+            } & {
+                Electorate: "invitation";
+            }>;
+        }>;
+        getInvitation: (name: any) => Promise<Invitation>;
+        getLimitedCreatorFacet: () => {
+            addRevivableAddresses: (oldAddresses: string[]) => void;
+            getWalletReviver: () => ERef<any>;
+            setReferences: (erefs: import("./provisionPoolKit.js").ProvisionPoolKitReferences) => Promise<void>;
+            makeHandler: () => ERef<import("@agoric/vats").BridgeHandler>;
+            initPSM: (brand: Brand, instance: import("@agoric/zoe/src/zoeService/utils.js").Instance<typeof import("./psm/psm.js").start>) => void;
+        };
+        getGovernedApis: () => import("@agoric/governance").GovernedApis;
+        getGovernedApiNames: () => string[];
+        setOfferFilter: (strings: any) => Promise<void>;
+    }>;
+    publicFacet: import("@endo/exo").Guarded<{
+        getAmount: (name: string) => Amount;
+        getBrand: (name: string) => Brand;
+        getInstance: (name: string) => import("@agoric/zoe").Instance;
+        getInstallation: (name: string) => import("@agoric/zoe").Installation;
+        getInvitationAmount: (name: string) => import("@agoric/zoe").InvitationAmount;
+        getNat: (name: string) => bigint;
+        getRatio: (name: string) => import("@agoric/ertp").Ratio;
+        getString: (name: string) => string;
+        getTimestamp: (name: string) => import("@agoric/time").TimestampRecord;
+        getRelativeTime: (name: string) => import("@agoric/time").RelativeTimeRecord;
+        getUnknown: (name: string) => any;
+        getSubscription: () => import("@agoric/notifier").StoredSubscription<import("@agoric/governance").GovernanceSubscriptionState>;
+        getGovernedParams: () => ERef<import("@agoric/governance").ParamStateRecord>;
+        getMetrics(): Promise<any>;
+        getPublicTopics(): Promise<any>;
+    }>;
+}>;
+/**
+ * TODO: ERef<GovernedCreatorFacet<ProvisionCreator>>
+ */
+export type ProvisionTerms = StandardTerms & GovernanceTerms<{
+    PerAccountInitialAmount: "amount";
+}>;
+import type { ContractMeta } from '@agoric/zoe';
+import type { ZCF } from '@agoric/zoe';
+import type { Bank } from '@agoric/vats/src/vat-bank.js';
+import type { ERef } from '@endo/far';
+import type { Invitation } 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 { MetricsNotification } from './provisionPoolKit.js';
+import type { Amount } from '@agoric/ertp';
+import type { Baggage } from '@agoric/vat-data';
+import type { Brand } from '@agoric/ertp';
+import type { StandardTerms } from '@agoric/zoe';
+import type { GovernanceTerms } from '@agoric/governance/src/types.js';
+//# sourceMappingURL=provisionPool.d.ts.map

package/src/provisionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisionPool.d.ts","sourceRoot":"","sources":["provisionPool.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;GAWG;AAEH,yCAAyC;AACzC,mBADW,aAAa,OAAO,KAAK,CAAC,CAgBnC;AAoBK,2BAXI,IAAI,cAAc,CAAC,eACnB;IACN,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACrB,sBAAsB,EAAE,UAAU,CAAC;IACnC,WAAW,EAAE,OAAO,WAAW,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC;IAC/B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7D,WACO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EjB;;;;6BA3FY,aAAa,GACzB,gBAAoB;IACd,uBAAuB,EAAE,QAAQ,CAAC;CACnC,CAAC;kCAjCwD,aAAa;yBAAb,aAAa;0BAGrD,8BAA8B;0BAD9B,WAAW;gCAF6B,aAAa;iCAM9C,0CAA0C;4BAR/C,kBAAkB;gCASd,0CAA0C;yCAHjC,uBAAuB;4BALb,cAAc;6BAMpC,kBAAkB;2BANI,cAAc;mCACC,aAAa;qCAC1C,iCAAiC"}