@agoric/vats 0.15.2-dev-ecf2d8e.0 → 0.15.2-other-dev-70beeb7.0

package/src/core/types.d.ts

@@ -0,0 +1,820 @@
+/**
+ * This type conflicts with packages/SwingSet/src/vats/plugin-manager.js
+ */
+type Device<T> = 'Device' & {
+    __deviceType__: T;
+};
+/**
+ * (approximately)
+ */
+type DProxy = <T>(target: Device<T>) => T;
+/**
+ * SwingSet types
+ */
+type BridgeDevice = Device<ReturnType<typeof import('@agoric/swingset-vat/src/devices/bridge/device-bridge.js').buildRootDeviceNode>>;
+/**
+ * SwingSet types
+ */
+type CommandDevice = Device<ReturnType<typeof import('@agoric/swingset-vat/src/devices/command/device-command.js').buildRootDeviceNode>>;
+/**
+ * SwingSet types
+ */
+type MailboxDevice = Device<ReturnType<typeof import('@agoric/swingset-vat/src/devices/mailbox/device-mailbox.js').buildRootDeviceNode>>;
+/**
+ * SwingSet types
+ */
+type PluginDevice = Device<ReturnType<typeof import('@agoric/swingset-vat/src/devices/plugin/device-plugin.js').buildRootDeviceNode>>;
+/**
+ * SwingSet types
+ */
+type TimerDevice = Device<ReturnType<typeof import('@agoric/swingset-vat/src/devices/timer/device-timer.js').buildRootDeviceNode>>;
+/**
+ * SwingSet types
+ */
+type VatAdminDevice = Device<import('@agoric/swingset-vat/src/devices/vat-admin/device-vat-admin.js').VatAdminRootDeviceNode>;
+/**
+ * SwingSet types
+ */
+type VattpVat = ERef<ReturnType<typeof import('@agoric/swingset-vat/src/vats/vattp/vat-vattp.js').buildRootObject>>;
+/**
+ * SwingSet types
+ */
+type VatAdminVat = ERef<ReturnType<typeof import('@agoric/swingset-vat/src/vats/vat-admin/vat-vat-admin.js').buildRootObject>>;
+/**
+ * See deliverToController in packages/SwingSet/src/vats/comms/controller.js
+ */
+type TimerVat = ERef<ReturnType<typeof import('@agoric/swingset-vat/src/vats/timer/vat-timer.js').buildRootObject>>;
+/**
+ * SwingSet types
+ */
+type CommsVatRoot = {
+    addRemote: (name: string, tx: unknown, rx: unknown) => void;
+    addEgress: (addr: string, ix: number, provider: unknown) => void;
+    addIngress: (remoteID: string, remoteRefID: number, label?: string) => Promise<any>;
+} | PromiseLike<{
+    addRemote: (name: string, tx: unknown, rx: unknown) => void;
+    addEgress: (addr: string, ix: number, provider: unknown) => void;
+    addIngress: (remoteID: string, remoteRefID: number, label?: string) => Promise<any>;
+}>;
+/**
+ * SwingSet types
+ */
+type SwingsetVats = {
+    comms: CommsVatRoot;
+    timer: TimerVat;
+    vatAdmin: VatAdminVat;
+    vattp: VattpVat;
+};
+/**
+ * SwingSet types
+ */
+type ChainStorageVatParams = {
+    vatParameters: {
+        chainStorageEntries?: Array<[k: string, v: string]>;
+    };
+};
+type SoloDevices = {
+    vatAdmin: VatAdminDevice;
+    mailbox: MailboxDevice;
+    command: CommandDevice;
+    timer: TimerDevice;
+    plugin: PluginDevice;
+};
+type ChainDevices = {
+    vatAdmin: VatAdminDevice;
+    mailbox: MailboxDevice;
+    timer: TimerDevice;
+    bridge?: BridgeDevice;
+};
+type ClientProvider = {
+    getChainBundle: () => unknown;
+    getChainConfigNotifier: () => Notifier<unknown>;
+};
+/**
+ * <T>
+ */
+type Producer<T> = {
+    resolve: (v: ERef<T>) => void;
+    reject: (r: unknown) => void;
+    reset: (reason?: unknown) => void;
+};
+type VatSourceRef = {
+    bundleName?: string;
+    bundleID?: string;
+};
+/**
+ * <T>
+ */
+type VatLoader<T> = (name: string, sourceRef?: VatSourceRef) => T;
+/**
+ * tool to put properties onto the `home` object of the client
+ */
+type ClientManager = {
+    assignBundle: (ps: PropertyMaker[]) => void;
+};
+/**
+ * callback to assign a property onto the `home` object of the client
+ */
+type PropertyMaker = (addr: string, flags: string[]) => Record<string, unknown>;
+type PromiseSpaceOf<B, C = {}, P = {}> = {
+    consume: B & C extends infer T ? { [K in keyof T]: Promise<(B & C)[K]>; } : never;
+    produce: B & P extends infer T_1 ? { [K_1 in keyof T_1]: Producer<(B & P)[K_1]>; } : never;
+};
+type CreateUserBundle = (nickname: string, clientAddress: string, powerFlags: string[]) => Promise<Record<string, Promise<any>>>;
+type ClientFacet = {
+    /**
+     * Required for ag-solo, but deprecated in favour of getConfiguration
+     * NOTE: we use `any` rather than `unknown` because each client that wants to call a method such as
+     * `E(userBundle.bank).deposit(payment)` has to cast userBundle.bank;
+     * ideally, the cast is to some useful type. But unknown can't be cast directly to some other type;
+     * it has to be cast to any first.
+     */
+    getChainBundle: () => ERef<Record<string, any>>;
+    getConfiguration: () => AsyncIterable<Configuration, Configuration>;
+};
+type Configuration = {
+    clientAddress: string;
+    clientHome: Record<string, any>;
+};
+type ClientCreator = {
+    /**
+     * Required for vat-provisioning, but deprecated in favor of {@link createClient }.
+     */
+    createUserBundle: CreateUserBundle;
+    createClientFacet: (nickname: string, clientAddress: string, powerFlags: string[]) => Promise<ClientFacet>;
+};
+type TokenKeyword = import('../tokens.js').TokenKeyword;
+type WellKnownName = {
+    issuer: TokenKeyword | 'Invitation' | 'AUSD';
+    installation: 'centralSupply' | 'mintHolder' | 'walletFactory' | 'provisionPool' | 'auctioneer' | 'feeDistributor' | 'contractGovernor' | 'committee' | 'noActionElectorate' | 'binaryVoteCounter' | 'VaultFactory' | 'liquidate' | 'Pegasus' | 'reserve' | 'psm' | 'econCommitteeCharter' | 'priceAggregator';
+    instance: 'economicCommittee' | 'feeDistributor' | 'auctioneer' | 'VaultFactory' | 'VaultFactoryGovernor' | 'econCommitteeCharter' | 'walletFactory' | 'provisionPool' | 'reserve' | 'reserveGovernor' | 'Pegasus';
+    oracleBrand: 'USD';
+    uiConfig: 'VaultFactory';
+};
+type WellKnownSpaces = {
+    issuer: {
+        produce: Record<WellKnownName['issuer'], Producer<Issuer>>;
+        consume: Record<WellKnownName['issuer'], Promise<Issuer>> & {
+            BLD: Promise<Issuer<'nat'>>;
+            IST: Promise<Issuer<'nat'>>;
+        };
+    };
+    brand: {
+        produce: Record<WellKnownName['issuer'], Producer<Brand>> & {
+            timer: Producer<import('@agoric/time').TimerBrand>;
+        };
+        consume: Record<WellKnownName['issuer'], Promise<Brand>> & {
+            BLD: Promise<Brand<'nat'>>;
+            IST: Promise<Brand<'nat'>>;
+            timer: Producer<import('@agoric/time').TimerBrand>;
+        };
+    };
+    oracleBrand: {
+        produce: Record<WellKnownName['oracleBrand'], Producer<Brand>>;
+        consume: Record<WellKnownName['oracleBrand'], Promise<Brand>>;
+    };
+    installation: {
+        produce: Record<WellKnownName['installation'], Producer<Installation>>;
+        consume: Record<WellKnownName['installation'], Promise<Installation<unknown>>> & {
+            auctioneer: Promise<Installation<(zcf: ZCF<GovernanceTerms<{
+                Electorate: "invitation";
+                StartFrequency: "relativeTime";
+                ClockStep: "relativeTime";
+                StartingRate: "nat";
+                LowestRate: "nat";
+                DiscountStep: "nat";
+                AuctionStartDelay: "relativeTime";
+                /**
+                 * @typedef {{
+                 *   getChainBundle: () => unknown,
+                 *   getChainConfigNotifier: () => Notifier<unknown>,
+                 * }} ClientProvider
+                 */
+                /**
+                 * @typedef {object} Producer<T>
+                 * @property {(v: ERef<T>) => void} resolve
+                 * @property {(r: unknown) => void} reject
+                 * @property {(reason?: unknown) => void} reset
+                 * @template T
+                 */
+                /**
+                 * @typedef {{ bundleName?: string, bundleID?: string }} VatSourceRef
+                 */
+                /**
+                 * @typedef {(name: string, sourceRef?: VatSourceRef) => T} VatLoader<T>
+                 * @template T
+                 */
+                /**
+                 * @typedef {{
+                 *   assignBundle: (ps: PropertyMaker[]) => void
+                 * }} ClientManager tool to put properties onto the `home` object of the client
+                 *
+                 * @typedef {(addr: string, flags: string[]) => Record<string, unknown>} PropertyMaker callback to assign a property onto the `home` object of the client
+                 */
+                /**
+                 * @template B Bidirectional
+                 * @template [C={}] Consume only
+                 * @template [P={}] Produce only
+                 * @typedef {{
+                 *   consume: { [K in keyof (B & C)]: Promise<(B & C)[K]> },
+                 *   produce: { [K in keyof (B & P)]: Producer<(B & P)[K]> },
+                 * }} PromiseSpaceOf
+                 */
+                /**
+                 * @callback CreateUserBundle
+                 * @param {string} nickname
+                 * @param {string} clientAddress
+                 * @param {string[]} powerFlags
+                 * @returns {Promise<Record<string, Promise<any>>>}
+                 *
+                 * @typedef {object} ClientFacet
+                 * @property {() => ERef<Record<string, any>>} getChainBundle Required for ag-solo, but deprecated in favour of getConfiguration
+                 *   NOTE: we use `any` rather than `unknown` because each client that wants to call a method such as
+                 *   `E(userBundle.bank).deposit(payment)` has to cast userBundle.bank;
+                 *   ideally, the cast is to some useful type. But unknown can't be cast directly to some other type;
+                 *   it has to be cast to any first.
+                 * @property {() => AsyncIterable<Configuration, Configuration>} getConfiguration
+                 *
+                 * @typedef {{ clientAddress: string, clientHome: Record<string, any>}} Configuration
+                 *
+                 * @typedef {object} ClientCreator
+                 * @property {CreateUserBundle} createUserBundle Required for vat-provisioning, but deprecated in favor of {@link createClient}.
+                 * @property {(nickname: string, clientAddress: string, powerFlags: string[]) => Promise<ClientFacet>} createClientFacet
+                 */
+                /**
+                 * @typedef {import('../tokens.js').TokenKeyword} TokenKeyword
+                 *
+                 * @typedef {{
+                 *   issuer: |
+                 *     TokenKeyword | 'Invitation' | 'AUSD',
+                 *   installation: |
+                 *     'centralSupply' | 'mintHolder' |
+                 *     'walletFactory' | 'provisionPool' | 'auctioneer' |
+                 *     'feeDistributor' |
+                 *     'contractGovernor' | 'committee' | 'noActionElectorate' | 'binaryVoteCounter' |
+                 *     'VaultFactory' | 'liquidate' |
+                 *     'Pegasus' | 'reserve' | 'psm' | 'econCommitteeCharter' | 'priceAggregator',
+                 *   instance: |
+                 *     'economicCommittee' | 'feeDistributor' | 'auctioneer' |
+                 *     'VaultFactory' | 'VaultFactoryGovernor' |
+                 *     'econCommitteeCharter' |
+                 *     'walletFactory' | 'provisionPool' |
+                 *     'reserve' | 'reserveGovernor' | 'Pegasus',
+                 *   oracleBrand:
+                 *     'USD',
+                 *   uiConfig: |
+                 *     'VaultFactory'
+                 * }} WellKnownName
+                 *
+                 * @typedef {{
+                 *   issuer: {
+                 *     produce: Record<WellKnownName['issuer'], Producer<Issuer>>,
+                 *     consume: Record<WellKnownName['issuer'], Promise<Issuer>> & { BLD: Promise<Issuer<'nat'>>, IST: Promise<Issuer<'nat'>> },
+                 *   },
+                 *   brand: {
+                 *     produce: Record<WellKnownName['issuer'], Producer<Brand>> &
+                 *              { timer: Producer<import('@agoric/time').TimerBrand> },
+                 *     consume: Record<WellKnownName['issuer'], Promise<Brand>> &
+                 *              { BLD: Promise<Brand<'nat'>>, IST: Promise<Brand<'nat'>>,
+                 *                timer: Producer<import('@agoric/time').TimerBrand> },
+                 *   },
+                 *   oracleBrand: {
+                 *     produce: Record<WellKnownName['oracleBrand'], Producer<Brand>>,
+                 *     consume: Record<WellKnownName['oracleBrand'], Promise<Brand>>,
+                 *   },
+                 *   installation:{
+                 *     produce: Record<WellKnownName['installation'], Producer<Installation>>,
+                 *     consume: Record<WellKnownName['installation'], Promise<Installation<unknown>>> & {
+                 *       auctioneer: Promise<Installation<import('@agoric/inter-protocol/src/auction/auctioneer.js').start>>,
+                 *       centralSupply: Promise<Installation<import('@agoric/vats/src/centralSupply.js').start>>,
+                 *       committee: Promise<Installation<import('@agoric/governance/src/committee.js')['prepare']>>,
+                 *       contractGovernor: Promise<Installation<import('@agoric/governance/src/contractGovernor.js')['prepare']>>,
+                 *       econCommitteeCharter: Promise<Installation<import('@agoric/inter-protocol/src/econCommitteeCharter.js')['prepare']>>,
+                 *       feeDistributor: Promise<Installation<import('@agoric/inter-protocol/src/feeDistributor.js').start>>,
+                 *       mintHolder: Promise<Installation<import('@agoric/vats/src/mintHolder.js').prepare>>,
+                 *       psm: Promise<Installation<import('@agoric/inter-protocol/src/psm/psm.js')['prepare']>>,
+                 *       provisionPool: Promise<Installation<import('@agoric/vats/src/provisionPool.js')['prepare']>>,
+                 *       reserve: Promise<Installation<import('@agoric/inter-protocol/src/reserve/assetReserve.js')['prepare']>>,
+                 *       VaultFactory: Promise<Installation<import('@agoric/inter-protocol/src/vaultFactory/vaultFactory.js')['prepare']>>,
+                 *       walletFactory: Promise<Installation<import('@agoric/smart-wallet/src/walletFactory.js').prepare>>,
+                 *     },
+                 *   },
+                 *   instance:{
+                 *     produce: Record<WellKnownName['instance'], Producer<Instance>>,
+                 *     consume: Record<WellKnownName['instance'], Promise<Instance>>,
+                 *   },
+                 *   uiConfig: {
+                 *     produce: Record<WellKnownName['uiConfig'], Producer<Record<string, any>>>,
+                 *     consume: Record<WellKnownName['uiConfig'], Promise<Record<string, any>>>,
+                 *   },
+                 * }} WellKnownSpaces
+                 */
+                /**
+                 * @template {GovernableStartFn} SF
+                 * @typedef {{
+                 *   installation: ERef<Installation<SF>>,
+                 *   issuerKeywordRecord?: IssuerKeywordRecord,
+                 *   governedParams: Record<string, unknown>,
+                 *   terms: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['terms'], 'brands' | 'issuers' | 'governedParams' | 'electionManager'>,
+                 *   privateArgs: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['privateArgs'], 'initialPoserInvitation'>,
+                 *   label: string,
+                 * }} StartGovernedUpgradableOpts
+                 *
+                 */
+                /**
+                 * @typedef {<SF extends GovernableStartFn>(opts: StartGovernedUpgradableOpts<SF>) => Promise<GovernanceFacetKit<SF>>
+                 * } startGovernedUpgradable
+                 */
+                /**
+                 * @template {import('@agoric/zoe/src/zoeService/utils').ContractStartFunction} SF
+                 * @typedef {{
+                 *   installation: ERef<Installation<SF>>,
+                 *   issuerKeywordRecord?: IssuerKeywordRecord,
+                 *   terms?: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['terms'], 'brands' | 'issuers'>,
+                 *   privateArgs?: import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['privateArgs'],
+                 *   label: string,
+                 * }} StartUpgradableOpts
+                 */
+                /**
+                 * @typedef {<SF extends import('@agoric/zoe/src/zoeService/utils').ContractStartFunction>(opts: StartUpgradableOpts<SF>)
+                 *   => Promise<
+                 *     import('@agoric/zoe/src/zoeService/utils').StartedInstanceKit<SF> &
+                 *     { label: string }
+                 *   >
+                 * } StartUpgradable
+                 */
+                /** @template T @typedef {import('@agoric/zoe/src/zoeService/utils').StartedInstanceKit<T> } StartedInstanceKit */
+                /** @typedef {{label: string} & StartedInstanceKit<import('@agoric/zoe/src/zoeService/utils').ContractStartFunction>} StartedInstanceKitWithLabel */
+                /**
+                 * @typedef {{
+                 *   agoricNames: NameHub,
+                 *   agoricNamesAdmin: import('@agoric/vats').NameAdmin,
+                 *   bankManager: BankManager,
+                 *   bldIssuerKit: RemoteIssuerKit,
+                 *   board: import('@agoric/vats').Board,
+                 *   bridgeManager: import('../types.js').BridgeManager | undefined,
+                 *   chainStorage: StorageNode | null,
+                 *   chainTimerService: import('@agoric/time/src/types').TimerService,
+                 *   client: ClientManager,
+                 *   clientCreator: ClientCreator,
+                 *   coreEvalBridgeHandler: import('../types.js').BridgeHandler,
+                 *   diagnostics: { savePrivateArgs: (instance: Instance, privateArgs: unknown) => void },
+                 *   feeMintAccess: FeeMintAccess,
+                 *   highPrioritySendersManager: import('@agoric/internal/src/priority-senders.js').PrioritySendersManager?,
+                 *   initialSupply: Payment<'nat'>,
+                 *   instancePrivateArgs: Map<Instance, unknown>,
+                 *   namesByAddress: NameHub,
+                 *   namesByAddressAdmin: import('../types').NamesByAddressAdmin,
+                 *   pegasusConnections: import('@agoric/vats').NameHubKit,
+                 *   pegasusConnectionsAdmin: import('@agoric/vats').NameAdmin,
+                 *   priceAuthorityVat: Awaited<PriceAuthorityVat>,
+                 *   priceAuthority: PriceAuthority,
+                 *   priceAuthorityAdmin: PriceAuthorityRegistryAdmin,
+                 *   provisioning: Awaited<ProvisioningVat> | undefined,
+                 *   provisionBridgeManager: import('../types.js').ScopedBridgeManager | undefined,
+                 *   provisionWalletBridgeManager: import('../types.js').ScopedBridgeManager | undefined,
+                 *   storageBridgeManager: import('../types.js').ScopedBridgeManager?,
+                 *   contractKits: MapStore<Instance, StartedInstanceKitWithLabel>,
+                 *   startUpgradable: StartUpgradable,
+                 *   governedContractKits: MapStore<Instance, GovernanceFacetKit<any> & {label: string}>,
+                 *   startGovernedUpgradable: startGovernedUpgradable,
+                 *   testFirstAnchorKit: import('../vat-bank.js').AssetIssuerKit<'nat'>,
+                 *   walletBridgeManager: import('../types.js').ScopedBridgeManager | undefined,
+                 *   walletFactoryStartResult: import('./startWalletFactory').WalletFactoryStartResult,
+                 *   provisionPoolStartResult: unknown,
+                 *   vatStore: import('./utils.js').VatStore,
+                 *   zoe: ZoeService,
+                 * }} ChainBootstrapSpaceT
+                 * @typedef {PromiseSpaceOf<ChainBootstrapSpaceT>} ChainBootstrapSpace
+                 *
+                 * @typedef {import('@agoric/vats').NameHub} NameHub
+                 * IDEA/TODO: make types of demo stuff invisible in production behaviors
+                 * @typedef {{
+                 *   argv: {
+                 *     hardcodedClientAddresses?: string[],
+                 *     FIXME_GCI: string,
+                 *     PROVISIONER_INDEX?: number,
+                 *   },
+                 * }} BootstrapVatParams
+                 * @typedef { BootstrapSpace & {
+                 *   zone: import('@agoric/zone').Zone,
+                 *   devices: SoloDevices | ChainDevices,
+                 *   vats: SwingsetVats,
+                 *   vatPowers: { [prop: string]: any, D: DProxy },
+                 *   vatParameters: BootstrapVatParams,
+                 *   runBehaviors: (manifest: unknown) => Promise<unknown>,
+                 *   modules: Record<string, Record<string, any>>,
+                 * }} BootstrapPowers
+                 * @typedef { WellKnownSpaces & PromiseSpaceOf<ChainBootstrapSpaceT & {
+                 *     vatAdminSvc: VatAdminSvc,
+                 *   }, {}, {
+                 *     loadVat: VatLoader<unknown>,
+                 *     loadCriticalVat: VatLoader<unknown>,
+                 *   }>
+                 * } BootstrapSpace
+                 * @typedef {{ mint: ERef<Mint>, issuer: ERef<Issuer>, brand: Brand }} RemoteIssuerKit
+                 * @typedef {Awaited<ReturnType<Awaited<BankVat>['makeBankManager']>>} BankManager
+                 * @typedef {ERef<ReturnType<import('../vat-agoricNames').buildRootObject>>} AgoricNamesVat
+                 * @typedef {ERef<ReturnType<import('../vat-bank.js').buildRootObject>>} BankVat
+                 * @typedef {ERef<ReturnType<import('../vat-board.js').buildRootObject>>} BoardVat
+                 * @typedef {ERef<ReturnType<import('../vat-bridge.js').buildRootObject>>} ChainStorageVat
+                 * @typedef {ERef<ReturnType<import('../vat-provisioning.js').buildRootObject>>} ProvisioningVat
+                 * @typedef {ERef<ReturnType<import('../vat-mints.js').buildRootObject>>} MintsVat
+                 * @typedef {ERef<ReturnType<import('../vat-priceAuthority.js').buildRootObject>>} PriceAuthorityVat
+                 * @typedef {ERef<ReturnType<import('../vat-network.js').buildRootObject>>} NetworkVat
+                 * @typedef {ERef<ReturnType<import('../vat-ibc.js').buildRootObject>>} IBCVat
+                 * @typedef { import('@agoric/zoe/tools/priceAuthorityRegistry').PriceAuthorityRegistryAdmin } PriceAuthorityRegistryAdmin
+                 *
+                 * @typedef {{ namedVat: PromiseSpaceOf<{
+                 *   agoricNames: Awaited<AgoricNamesVat>,
+                 *   board: Awaited<BoardVat>,
+                 * }> }} NamedVatPowers
+                 */
+                /**
+                 * @typedef {PromiseSpaceOf<{
+                 *   mints: MintsVat
+                 * }>} DemoFaucetPowers
+                 */
+                /**
+                 * @typedef {{
+                 *   spawner: SpawnerVat,
+                 *   http: HttpVat,
+                 *   network: NetworkVat,
+                 *   uploads: UploadsVat,
+                 *   bootstrap: unknown
+                 * }} SoloVats
+                 * @typedef {ERef<ReturnType<import('@agoric/solo/src/vat-spawner.js').buildRootObject>>} SpawnerVat
+                 * @typedef {ERef<ReturnType<import('@agoric/solo/src/vat-http.js').buildRootObject>>} HttpVat
+                 * @typedef {ERef<ReturnType<import('@agoric/solo/src/vat-uploads.js').buildRootObject>>} UploadsVat
+                 */
+                /** @template T @typedef  {{vatPowers: { D: DProxy }, devices: T}} BootDevices<T>  */
+                PriceLockPeriod: "relativeTime";
+            }> & {
+                timerService: import("@agoric/time/src/types").TimerService;
+                reservePublicFacet: GovernedPublicFacet<{
+                    makeAddCollateralInvitation(): Promise<Invitation<string, never>>;
+                    getPublicTopics(): {
+                        metrics: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("@agoric/inter-protocol/src/reserve/assetReserveKit.js").MetricsNotification>;
+                    };
+                }>;
+                priceAuthority: PriceAuthority;
+            }>, privateArgs: {
+                initialPoserInvitation: Invitation<unknown, never>;
+                storageNode: StorageNode;
+                marshaller: Marshaller<unknown>;
+            }, baggage: MapStore<string, unknown>) => Promise<{
+                publicFacet: GovernedPublicFacet<{
+                    getElectorate: () => Amount<"set">;
+                    getStartFrequency: () => import("@agoric/time/src/types").RelativeTime;
+                    getClockStep: () => import("@agoric/time/src/types").RelativeTime;
+                    getStartingRate: () => bigint;
+                    getLowestRate: () => bigint;
+                    getDiscountStep: () => bigint;
+                    getAuctionStartDelay: () => import("@agoric/time/src/types").RelativeTime;
+                    getPriceLockPeriod: () => import("@agoric/time/src/types").RelativeTime;
+                    makeBidInvitation(collateralBrand: Brand<"nat">): Promise<Invitation<string, never>>;
+                    getSchedules(): {
+                        liveAuctionSchedule: import("@agoric/inter-protocol/src/auction/scheduler.js").Schedule | null;
+                        nextAuctionSchedule: import("@agoric/inter-protocol/src/auction/scheduler.js").Schedule | null;
+                    };
+                    getScheduleUpdates(): Subscriber<import("@agoric/inter-protocol/src/auction/scheduler.js").ScheduleNotification>;
+                    getBookDataUpdates(brand: any): Subscriber<import("@agoric/inter-protocol/src/auction/auctionBook.js").BookDataNotification>;
+                    getPublicTopics(brand: any): {
+                        bookData: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("@agoric/inter-protocol/src/auction/auctionBook.js").BookDataNotification>;
+                    } | {
+                        schedule: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("@agoric/inter-protocol/src/auction/scheduler.js").ScheduleNotification>;
+                    };
+                    makeDepositInvitation: () => Promise<Invitation<string, never>>;
+                }>;
+                creatorFacet: GovernedCreatorFacet<{
+                    addBrand(issuer: Issuer<AssetKind>, kwd: string): Promise<void>;
+                    getSchedule(): Promise<import("@agoric/inter-protocol/src/auction/scheduler.js").FullSchedule>;
+                } & import("@endo/eventual-send").RemotableBrand<{}, {
+                    addBrand(issuer: Issuer<AssetKind>, kwd: string): Promise<void>;
+                    getSchedule(): Promise<import("@agoric/inter-protocol/src/auction/scheduler.js").FullSchedule>;
+                }>>;
+            }>>>;
+            centralSupply: Promise<Installation<(zcf: ZCF<{
+                bootstrapPaymentValue: bigint;
+            }>, { feeMintAccess }: {
+                feeMintAccess: FeeMintAccess;
+            }) => Promise<{
+                creatorFacet: {
+                    getBootstrapPayment: () => Payment<any>;
+                } & import("@endo/eventual-send").RemotableBrand<{}, {
+                    getBootstrapPayment: () => Payment<any>;
+                }>;
+            }>>>;
+            committee: Promise<Installation<typeof import("@agoric/governance/src/committee.js")['prepare']>>;
+            contractGovernor: Promise<Installation<typeof import("@agoric/governance/src/contractGovernor.js")['prepare']>>;
+            econCommitteeCharter: Promise<Installation<typeof import("@agoric/inter-protocol/src/econCommitteeCharter.js")['prepare']>>;
+            feeDistributor: Promise<Installation<(zcf: ZCF<{
+                keywordShares: Record<string, bigint>;
+                timerService: ERef<import("@agoric/time/src/types").TimerService>;
+                collectionInterval: import("@agoric/time/src/types").RelativeTime;
+            }>) => Promise<{
+                creatorFacet: {
+                    makeContractFeeCollector: (zoe: ERef<ZoeService>, creatorFacet: ERef<import("@agoric/inter-protocol/src/feeDistributor.js").CollectibleContractFacet>) => {
+                        collectFees: () => Promise<Payment<any>>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        collectFees: () => Promise<Payment<any>>;
+                    }>;
+                    startPeriodicCollection: (debugName: string, collectorP: ERef<import("@agoric/inter-protocol/src/feeDistributor.js").FeeCollector>) => Promise<import("@agoric/inter-protocol/src/feeDistributor.js").PeriodicFeeCollector>;
+                    makeDepositFacetDestination: (depositFacet: import("@endo/eventual-send").ERef<{
+                        /**
+                         * Deposit all the contents of payment into the purse that made this facet,
+                         * returning the amount. If the optional argument `optAmount` does not equal the
+                         * amount of digital assets in the payment, throw an error.
+                         *
+                         * If payment is a promise, throw an error.
+                         */
+                        receive: (args_0: Payment<AssetKind>, args_1?: any) => import("@endo/eventual-send").ERef<Amount<AssetKind>>;
+                    }>) => {
+                        pushPayment: (payment: any, _issuer: any) => Promise<Amount<AssetKind>>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        pushPayment: (payment: any, _issuer: any) => Promise<Amount<AssetKind>>;
+                    }>;
+                    makeOfferDestination: (zoe: ERef<ZoeService>, keyword: string, target: unknown, makeInvitationMethod: PropertyKey, args?: unknown[] | undefined) => {
+                        pushPayment: (payment: any, issuer: any) => Promise<any>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        pushPayment: (payment: any, issuer: any) => Promise<any>;
+                    }>;
+                    setDestinations: (newDestinations: Record<string, ERef<import("@agoric/inter-protocol/src/feeDistributor.js").FeeDestination>>) => Promise<void>;
+                    setKeywordShares: (newShares: Record<string, bigint>) => void;
+                } & import("@endo/eventual-send").RemotableBrand<{}, {
+                    makeContractFeeCollector: (zoe: ERef<ZoeService>, creatorFacet: ERef<import("@agoric/inter-protocol/src/feeDistributor.js").CollectibleContractFacet>) => {
+                        collectFees: () => Promise<Payment<any>>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        collectFees: () => Promise<Payment<any>>;
+                    }>;
+                    startPeriodicCollection: (debugName: string, collectorP: ERef<import("@agoric/inter-protocol/src/feeDistributor.js").FeeCollector>) => Promise<import("@agoric/inter-protocol/src/feeDistributor.js").PeriodicFeeCollector>;
+                    makeDepositFacetDestination: (depositFacet: import("@endo/eventual-send").ERef<{
+                        /**
+                         * Deposit all the contents of payment into the purse that made this facet,
+                         * returning the amount. If the optional argument `optAmount` does not equal the
+                         * amount of digital assets in the payment, throw an error.
+                         *
+                         * If payment is a promise, throw an error.
+                         */
+                        receive: (args_0: Payment<AssetKind>, args_1?: any) => import("@endo/eventual-send").ERef<Amount<AssetKind>>;
+                    }>) => {
+                        pushPayment: (payment: any, _issuer: any) => Promise<Amount<AssetKind>>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        pushPayment: (payment: any, _issuer: any) => Promise<Amount<AssetKind>>;
+                    }>;
+                    makeOfferDestination: (zoe: ERef<ZoeService>, keyword: string, target: unknown, makeInvitationMethod: PropertyKey, args?: unknown[] | undefined) => {
+                        pushPayment: (payment: any, issuer: any) => Promise<any>;
+                    } & import("@endo/eventual-send").RemotableBrand<{}, {
+                        pushPayment: (payment: any, issuer: any) => Promise<any>;
+                    }>;
+                    setDestinations: (newDestinations: Record<string, ERef<import("@agoric/inter-protocol/src/feeDistributor.js").FeeDestination>>) => Promise<void>;
+                    setKeywordShares: (newShares: Record<string, bigint>) => void;
+                }>;
+                publicFacet: {
+                    distributeFees: (payment: Payment<"nat">) => Promise<void>;
+                    getKeywordShares: () => Record<string, bigint>;
+                } & import("@endo/eventual-send").RemotableBrand<{}, {
+                    distributeFees: (payment: Payment<"nat">) => Promise<void>;
+                    getKeywordShares: () => Record<string, bigint>;
+                }>;
+            }>>>;
+            mintHolder: Promise<Installation<(<K extends AssetKind>(zcf: ZCF<import("@agoric/vats/src/mintHolder.js").IssuerInfo<K>>, _privateArgs: undefined, instanceBaggage: MapStore<string, unknown>) => {
+                publicFacet: Issuer<AssetKind>;
+                creatorFacet: Mint<AssetKind>;
+            })>>;
+            psm: Promise<Installation<typeof import("@agoric/inter-protocol/src/psm/psm.js")['prepare']>>;
+            provisionPool: Promise<Installation<typeof import("@agoric/vats/src/provisionPool.js")['prepare']>>;
+            reserve: Promise<Installation<typeof import("@agoric/inter-protocol/src/reserve/assetReserve.js")['prepare']>>;
+            VaultFactory: Promise<Installation<typeof import("@agoric/inter-protocol/src/vaultFactory/vaultFactory.js")['prepare']>>;
+            walletFactory: Promise<Installation<(zcf: ZCF<import("@agoric/smart-wallet/src/walletFactory.js").SmartWalletContractTerms>, privateArgs: {
+                storageNode: ERef<StorageNode>;
+                walletBridgeManager?: ERef<import("@agoric/vats").ScopedBridgeManager> | undefined;
+                walletReviver?: ERef<import("@agoric/smart-wallet/src/walletFactory.js").WalletReviver> | undefined;
+            }, baggage: MapStore<string, unknown>) => Promise<{
+                creatorFacet: {
+                    provideSmartWallet(address: string, bank: ERef<import("../vat-bank.js").Bank>, namesByAddressAdmin: ERef<import("@agoric/vats").NameAdmin>): Promise<[wallet: {
+                        handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string>, canSpend?: boolean | undefined): Promise<void>;
+                        getDepositFacet(): {
+                            receive(payment: Payment<AssetKind>): Promise<Amount<AssetKind>>;
+                        };
+                        getOffersFacet(): {
+                            executeOffer(offerSpec: import("@agoric/smart-wallet/src/offers.js").OfferSpec): Promise<void>;
+                            tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers.js").OfferId): Promise<void>;
+                        };
+                        getCurrentSubscriber(): Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").CurrentWalletRecord>;
+                        getUpdatesSubscriber(): Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").UpdateRecord>;
+                        getPublicTopics(): {
+                            current: {
+                                description: string;
+                                subscriber: Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").CurrentWalletRecord>;
+                                storagePath: Promise<string>;
+                            };
+                            updates: {
+                                description: string;
+                                subscriber: Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").UpdateRecord>;
+                                storagePath: Promise<string>;
+                            };
+                        };
+                    }, isNew: boolean]>;
+                } & import("@endo/eventual-send").RemotableBrand<{}, {
+                    provideSmartWallet(address: string, bank: ERef<import("../vat-bank.js").Bank>, namesByAddressAdmin: ERef<import("@agoric/vats").NameAdmin>): Promise<[wallet: {
+                        handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string>, canSpend?: boolean | undefined): Promise<void>;
+                        getDepositFacet(): {
+                            receive(payment: Payment<AssetKind>): Promise<Amount<AssetKind>>;
+                        };
+                        getOffersFacet(): {
+                            executeOffer(offerSpec: import("@agoric/smart-wallet/src/offers.js").OfferSpec): Promise<void>;
+                            tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers.js").OfferId): Promise<void>;
+                        };
+                        getCurrentSubscriber(): Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").CurrentWalletRecord>;
+                        getUpdatesSubscriber(): Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").UpdateRecord>;
+                        getPublicTopics(): {
+                            current: {
+                                description: string;
+                                subscriber: Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").CurrentWalletRecord>;
+                                storagePath: Promise<string>;
+                            };
+                            updates: {
+                                description: string;
+                                subscriber: Subscriber<import("@agoric/smart-wallet/src/smartWallet.js").UpdateRecord>;
+                                storagePath: Promise<string>;
+                            };
+                        };
+                    }, isNew: boolean]>;
+                }>;
+            }>>>;
+        };
+    };
+    instance: {
+        produce: Record<WellKnownName['instance'], Producer<Instance>>;
+        consume: Record<WellKnownName['instance'], Promise<Instance>>;
+    };
+    uiConfig: {
+        produce: Record<WellKnownName['uiConfig'], Producer<Record<string, any>>>;
+        consume: Record<WellKnownName['uiConfig'], Promise<Record<string, any>>>;
+    };
+};
+type StartGovernedUpgradableOpts<SF extends GovernableStartFn> = {
+    installation: ERef<Installation<SF>>;
+    issuerKeywordRecord?: IssuerKeywordRecord;
+    governedParams: Record<string, unknown>;
+    terms: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['terms'], 'brands' | 'issuers' | 'governedParams' | 'electionManager'>;
+    privateArgs: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['privateArgs'], 'initialPoserInvitation'>;
+    label: string;
+};
+type startGovernedUpgradable = <SF extends GovernableStartFn>(opts: StartGovernedUpgradableOpts<SF>) => Promise<GovernanceFacetKit<SF>>;
+type StartUpgradableOpts<SF extends import("@agoric/zoe/src/zoeService/utils").ContractStartFunction> = {
+    installation: ERef<Installation<SF>>;
+    issuerKeywordRecord?: IssuerKeywordRecord;
+    terms?: Omit<import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['terms'], 'brands' | 'issuers'>;
+    privateArgs?: import('@agoric/zoe/src/zoeService/utils').StartParams<SF>['privateArgs'];
+    label: string;
+};
+type StartUpgradable = <SF extends import("@agoric/zoe/src/zoeService/utils").ContractStartFunction>(opts: StartUpgradableOpts<SF>) => Promise<{
+    instance: import("@agoric/zoe/src/zoeService/utils").Instance<SF>;
+    adminFacet: import("@agoric/zoe/src/zoeService/utils").AdminFacet;
+    creatorFacet: {};
+    publicFacet: {};
+} & (SF extends import("@agoric/zoe/src/zoeService/utils").ContractStartFunction ? Awaited<ReturnType<SF>> : {
+    creatorFacet: any;
+    publicFacet: any;
+}) & {
+    label: string;
+}>;
+type StartedInstanceKit<T> = import('@agoric/zoe/src/zoeService/utils').StartedInstanceKit<T>;
+type StartedInstanceKitWithLabel = {
+    label: string;
+} & StartedInstanceKit<import('@agoric/zoe/src/zoeService/utils').ContractStartFunction>;
+type ChainBootstrapSpaceT = {
+    agoricNames: NameHub;
+    agoricNamesAdmin: import('@agoric/vats').NameAdmin;
+    bankManager: BankManager;
+    bldIssuerKit: RemoteIssuerKit;
+    board: import('@agoric/vats').Board;
+    bridgeManager: import('../types.js').BridgeManager | undefined;
+    chainStorage: StorageNode | null;
+    chainTimerService: import('@agoric/time/src/types').TimerService;
+    client: ClientManager;
+    clientCreator: ClientCreator;
+    coreEvalBridgeHandler: import('../types.js').BridgeHandler;
+    diagnostics: {
+        savePrivateArgs: (instance: Instance, privateArgs: unknown) => void;
+    };
+    feeMintAccess: FeeMintAccess;
+    highPrioritySendersManager: import('@agoric/internal/src/priority-senders.js').PrioritySendersManager | null;
+    initialSupply: Payment<'nat'>;
+    instancePrivateArgs: Map<Instance, unknown>;
+    namesByAddress: NameHub;
+    namesByAddressAdmin: import('../types').NamesByAddressAdmin;
+    pegasusConnections: import('@agoric/vats').NameHubKit;
+    pegasusConnectionsAdmin: import('@agoric/vats').NameAdmin;
+    priceAuthorityVat: Awaited<PriceAuthorityVat>;
+    priceAuthority: PriceAuthority;
+    priceAuthorityAdmin: PriceAuthorityRegistryAdmin;
+    provisioning: Awaited<ProvisioningVat> | undefined;
+    provisionBridgeManager: import('../types.js').ScopedBridgeManager | undefined;
+    provisionWalletBridgeManager: import('../types.js').ScopedBridgeManager | undefined;
+    storageBridgeManager: import('../types.js').ScopedBridgeManager | null;
+    contractKits: MapStore<Instance, StartedInstanceKitWithLabel>;
+    startUpgradable: StartUpgradable;
+    governedContractKits: MapStore<Instance, GovernanceFacetKit<any> & {
+        label: string;
+    }>;
+    startGovernedUpgradable: startGovernedUpgradable;
+    testFirstAnchorKit: import('../vat-bank.js').AssetIssuerKit<'nat'>;
+    walletBridgeManager: import('../types.js').ScopedBridgeManager | undefined;
+    walletFactoryStartResult: import('./startWalletFactory').WalletFactoryStartResult;
+    provisionPoolStartResult: unknown;
+    vatStore: import('./utils.js').VatStore;
+    zoe: ZoeService;
+};
+type ChainBootstrapSpace = PromiseSpaceOf<ChainBootstrapSpaceT>;
+/**
+ * IDEA/TODO: make types of demo stuff invisible in production behaviors
+ */
+type NameHub = import('@agoric/vats').NameHub;
+type BootstrapVatParams = {
+    argv: {
+        hardcodedClientAddresses?: string[];
+        FIXME_GCI: string;
+        PROVISIONER_INDEX?: number;
+    };
+};
+type BootstrapPowers = WellKnownSpaces & PromiseSpaceOf<ChainBootstrapSpaceT & {
+    vatAdminSvc: import("@agoric/swingset-vat").VatAdminSvc;
+}, {}, {
+    loadVat: VatLoader<unknown>;
+    loadCriticalVat: VatLoader<unknown>;
+}> & {
+    zone: import('@agoric/zone').Zone;
+    devices: SoloDevices | ChainDevices;
+    vats: SwingsetVats;
+    vatPowers: {
+        [prop: string]: any;
+        D: DProxy;
+    };
+    vatParameters: BootstrapVatParams;
+    runBehaviors: (manifest: unknown) => Promise<unknown>;
+    modules: Record<string, Record<string, any>>;
+};
+type BootstrapSpace = WellKnownSpaces & PromiseSpaceOf<ChainBootstrapSpaceT & {
+    vatAdminSvc: VatAdminSvc;
+}, {}, {
+    loadVat: VatLoader<unknown>;
+    loadCriticalVat: VatLoader<unknown>;
+}>;
+type RemoteIssuerKit = {
+    mint: ERef<Mint>;
+    issuer: ERef<Issuer>;
+    brand: Brand;
+};
+type BankManager = Awaited<ReturnType<Awaited<BankVat>['makeBankManager']>>;
+type AgoricNamesVat = ERef<ReturnType<(_vatPowers: unknown, _vatParameters: unknown, baggage: MapStore<string, unknown>) => {
+    getNameHub: () => import("@agoric/vats").NameHub;
+    getNameHubKit: () => import("@agoric/vats").NameHubKit;
+    publishNameHubs: (nameStorage: ERef<StorageNode>, vatBoard: ERef<BoardVat>, kinds: string[]) => Promise<void>;
+    provideInertBrand: (keyword: string, displayInfo: DisplayInfo<AssetKind>) => any;
+} & import("@endo/eventual-send").RemotableBrand<{}, {
+    getNameHub: () => import("@agoric/vats").NameHub;
+    getNameHubKit: () => import("@agoric/vats").NameHubKit;
+    publishNameHubs: (nameStorage: ERef<StorageNode>, vatBoard: ERef<BoardVat>, kinds: string[]) => Promise<void>;
+    provideInertBrand: (keyword: string, displayInfo: DisplayInfo<AssetKind>) => any;
+}>>>;
+type BankVat = ERef<ReturnType<typeof import("../vat-bank.js").buildRootObject>>;
+type BoardVat = ERef<ReturnType<typeof import("../vat-board.js").buildRootObject>>;
+type ChainStorageVat = ERef<ReturnType<typeof import("../vat-bridge.js").buildRootObject>>;
+type ProvisioningVat = ERef<ReturnType<typeof import("../vat-provisioning.js").buildRootObject>>;
+type MintsVat = ERef<ReturnType<typeof import("../vat-mints.js").buildRootObject>>;
+type PriceAuthorityVat = ERef<ReturnType<typeof import("../vat-priceAuthority.js").buildRootObject>>;
+type NetworkVat = ERef<ReturnType<typeof import("../vat-network.js").buildRootObject>>;
+type IBCVat = ERef<ReturnType<typeof import("../vat-ibc.js").buildRootObject>>;
+type PriceAuthorityRegistryAdmin = import('@agoric/zoe/tools/priceAuthorityRegistry').PriceAuthorityRegistryAdmin;
+type NamedVatPowers = {
+    namedVat: PromiseSpaceOf<{
+        agoricNames: Awaited<AgoricNamesVat>;
+        board: Awaited<BoardVat>;
+    }>;
+};
+type DemoFaucetPowers = PromiseSpaceOf<{
+    mints: MintsVat;
+}>;
+type SoloVats = {
+    spawner: SpawnerVat;
+    http: HttpVat;
+    network: NetworkVat;
+    uploads: UploadsVat;
+    bootstrap: unknown;
+};
+type SpawnerVat = ERef<ReturnType<typeof import("@agoric/solo/src/vat-spawner.js").buildRootObject>>;
+type HttpVat = ERef<ReturnType<typeof import("@agoric/solo/src/vat-http.js").buildRootObject>>;
+type UploadsVat = ERef<ReturnType<typeof import("@agoric/solo/src/vat-uploads.js").buildRootObject>>;
+/**
+ * <T>
+ */
+type BootDevices<T> = {
+    vatPowers: {
+        D: DProxy;
+    };
+    devices: T;
+};
+//# sourceMappingURL=types.d.ts.map