@agoric/client-utils 0.1.1-dev-763bc10.0.763bc10 → 0.1.1-dev-bcbee89.0.bcbee89

package/src/sync-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-tools.d.ts","sourceRoot":"","sources":["sync-tools.js"],"names":[],"mappings":"AAmCO,0BAHI,MAAM,uBACN;IAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,gBAM7E;AAYG,oCAPO,CAAC,uBACJ,MAAM,OAAO,CAAC,CAAC,CAAC,aAChB,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,WACtB,MAAM,iFACN,YAAY,GAAG;IAAC,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,GAC7E,OAAO,CAAC,CAAC,CAAC,CAqEtB;AAiCM,wDAJI,MAAM,oBACN;IAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAE,WAC9F,gBAAgB;;GAiB1B;AA0BM,iDALI,MAAM,MACN;IAAE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,aACtG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,WAC9B,gBAAgB,gBAa1B;AAqCM,2CANI,MAAM,WACN,MAAM,kBACN,OAAO,MACP;IAAE,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAE,WACxF,gBAAgB,gBAmB1B;AAwBM,kDAJI,MAAM,MACN;IAAE,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,WACtF,gBAAgB,gBAa1B;AA0BM,2CALI,MAAM,WACN,MAAM,MACN;IAAE,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,WACtF,gBAAgB,gBAa1B;AA+EM,2DAZI,MAAM,kBACN;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,MACO;IACN,QAAQ,EAAE,OAAO,gBAAgB,EAAE,WAAW,CAAC;IAC/C,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IACxB,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CACrC,WACO,gBAAgB,2BAoB1B;;;;;4BAtZqB,OAAO,KAAK,OAAO;;+BAE5B,YAAY,GAAG;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC;;WAGpC,MAAM;WACN,MAAM;;6BAqTP;IACR,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,eAAe,EAAE,eAAe,CAAA;KAClD,CAAC;IACF,cAAc,EAAE;QACd,WAAW,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,cAAc,EAAE,OAAO,eAAe,EAAE,eAAe,CAAA;KACxD,CAAA;CACF"}

package/src/sync-tools.js

@@ -1,427 +0,0 @@
-/**
- * @file The purpose of this file is to bring together a set of tools that
- * developers can use to synchronize operations they carry out in their tests.
- *
- * These operations include;
- * - Making sure a core-eval resulted in successfully deploying a contract
- * - Making sure a core-eval successfully sent zoe invitations to committee members for governance
- * - Making sure an account is successfully funded with vbank assets like IST, BLD etc.
- *  - operation: query dest account's balance
- *  - condition: dest account has a balance >= sent token
- * - Making sure an offer resulted successfully
- * - Making sure an offer was exited successfully
- * - Make sure an election held by a given committee (see @agoric/governance) turned out as expected
- */
-
-/**
- * @typedef {object} RetryOptions
- * @property {number} [maxRetries]
- * @property {number} [retryIntervalMs]
- * @property {boolean} [reusePromise]
- * @property {(value: unknown) => unknown} [renderResult]
- *
- * @typedef {RetryOptions & {errorMessage: string}} WaitUntilOptions
- *
- * @typedef {object} CosmosBalanceThreshold
- * @property {string} denom
- * @property {number} value
- */
-
-/**
- * From https://github.com/Agoric/agoric-sdk/blob/442f07c8f0af03281b52b90e90c27131eef6f331/multichain-testing/tools/sleep.ts#L10
- *
- * @param {number} ms
- * @param {{log: (message: string) => void, setTimeout: typeof global.setTimeout}} io
- */
-export const sleep = (ms, { log = () => {}, setTimeout }) =>
-  new Promise(resolve => {
-    log(`Sleeping for ${ms}ms...`);
-    setTimeout(resolve, ms);
-  });
-
-/**
- * From https://github.com/Agoric/agoric-sdk/blob/442f07c8f0af03281b52b90e90c27131eef6f331/multichain-testing/tools/sleep.ts#L24
- *
- * @template [T=unknown]
- * @param {() => Promise<T>} operation
- * @param {(result: T) => boolean} condition
- * @param {string} message
- * @param {RetryOptions & {log?: typeof console.log, setTimeout: typeof global.setTimeout}} options
- * @returns {Promise<T>}
- */
-export const retryUntilCondition = async (
-  operation,
-  condition,
-  message,
-  {
-    maxRetries = 6,
-    retryIntervalMs = 3500,
-    reusePromise = false,
-    renderResult = x => x,
-    // XXX mixes ocaps with configuration options
-    log = console.log,
-    setTimeout,
-  },
-) => {
-  log({ maxRetries, retryIntervalMs, message });
-
-  await null; // separate sync prologue
-
-  const timedOut = Symbol('timed out');
-  let retries = 0;
-  /** @type {Promise | undefined } */
-  let resultP;
-  while (retries < maxRetries) {
-    try {
-      if (!reusePromise || !resultP) {
-        resultP = operation();
-        const makeCleanup = ref => {
-          const cleanup = () => {
-            if (resultP === ref) {
-              resultP = undefined;
-            }
-          };
-          return cleanup;
-        };
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        resultP.finally(makeCleanup(resultP));
-      }
-      const result = await Promise.race([
-        resultP,
-        // Overload the retryIntervalMs to apply both *to* and *between* iterations
-        sleep(retryIntervalMs, { log() {}, setTimeout }).then(() => timedOut),
-      ]);
-      if (result === timedOut) {
-        log(`Attempt ${retries + 1} timed out`);
-        if (!reusePromise) resultP = undefined;
-      } else {
-        log('RESULT', renderResult(result));
-        if (condition(result)) {
-          return result;
-        }
-      }
-    } catch (error) {
-      if (error instanceof Error) {
-        log(`Error: ${error.message}: ${error.stack}`);
-      } else {
-        log(`Unknown error: ${String(error)}`);
-      }
-    }
-
-    retries += 1;
-    log(
-      `Retry ${retries}/${maxRetries} - Waiting for ${retryIntervalMs}ms for ${message}...`,
-    );
-    await sleep(retryIntervalMs, { log, setTimeout });
-  }
-
-  throw Error(`${message} condition failed after ${maxRetries} retries.`);
-};
-
-/**
- * @param {WaitUntilOptions} options
- * @returns {WaitUntilOptions}
- */
-const overrideDefaultOptions = options => {
-  const defaultValues = {
-    maxRetries: 6,
-    retryIntervalMs: 3500,
-    errorMessage: 'Error',
-  };
-
-  return { ...defaultValues, ...options };
-};
-
-/// ////////// Making sure a core-eval resulted successfully deploying a contract /////////////
-
-const makeGetInstances = follow => async () => {
-  const instanceEntries = await follow(
-    '-lF',
-    `:published.agoricNames.instance`,
-  );
-
-  return Object.fromEntries(instanceEntries);
-};
-
-/**
- *
- * @param {string} contractName
- * @param {{ log: (message: string) => void, follow: () => object, setTimeout: typeof global.setTimeout }} ambientAuthority
- * @param {WaitUntilOptions} options
- */
-export const waitUntilContractDeployed = (
-  contractName,
-  ambientAuthority,
-  options,
-) => {
-  const { log, follow, setTimeout } = ambientAuthority;
-  const getInstances = makeGetInstances(follow);
-  const { errorMessage, ...resolvedOptions } = overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    getInstances,
-    instanceObject => Object.keys(instanceObject).includes(contractName),
-    errorMessage,
-    { log, setTimeout, ...resolvedOptions },
-  );
-};
-
-/// ////////// Making sure an account is successfully funded with vbank assets like IST, BLD etc. ///////////////
-
-const makeQueryCosmosBalance = queryCb => async dest => {
-  const coins = await queryCb('bank', 'balances', dest);
-  return coins.balances;
-};
-
-/**
- *
- * @param {Array} balances
- * @param {CosmosBalanceThreshold} threshold
- * @returns {boolean}
- */
-const checkCosmosBalance = (balances, threshold) => {
-  const balance = [...balances].find(({ denom }) => denom === threshold.denom);
-  return Number(balance.amount) >= threshold.value;
-};
-
-/**
- * @param {string} destAcct
- * @param {{ log?: (message: string) => void, query: () => Promise<object>, setTimeout: typeof global.setTimeout}} io
- * @param {{denom: string, value: number}} threshold
- * @param {WaitUntilOptions} options
- */
-export const waitUntilAccountFunded = (destAcct, io, threshold, options) => {
-  const { log, query, setTimeout } = io;
-  const queryCosmosBalance = makeQueryCosmosBalance(query);
-  const { errorMessage, ...resolvedOptions } = overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    async () => queryCosmosBalance(destAcct),
-    balances => checkCosmosBalance(balances, threshold),
-    errorMessage,
-    { log, setTimeout, ...resolvedOptions },
-  );
-};
-
-/// ////////// Making sure an offers get results  /////////////
-
-const makeQueryWallet = follow => async (/** @type {string} */ addr) => {
-  const update = await follow('-lF', `:published.wallet.${addr}`);
-
-  return update;
-};
-
-/**
- *
- * @param {object} offerStatus
- * @param {boolean} waitForPayouts
- * @param {string} offerId
- */
-const checkOfferState = (offerStatus, waitForPayouts, offerId) => {
-  const { updated, status } = offerStatus;
-
-  if (updated !== 'offerStatus') return false;
-  if (!status) return false;
-  if (status.id !== offerId) return false;
-  if (!status.numWantsSatisfied || status.numWantsSatisfied !== 1) return false;
-  if (waitForPayouts && status.payouts) return true;
-  if (!waitForPayouts && status.result) return true;
-
-  return false;
-};
-
-/**
- *
- * @param {string} addr
- * @param {string} offerId
- * @param {boolean} waitForPayouts
- * @param {{ log?: typeof console.log, follow: () => object, setTimeout: typeof global.setTimeout }} io
- * @param {WaitUntilOptions} options
- */
-export const waitUntilOfferResult = (
-  addr,
-  offerId,
-  waitForPayouts,
-  io,
-  options,
-) => {
-  const { log, follow, setTimeout } = io;
-  const queryWallet = makeQueryWallet(follow);
-  const { errorMessage, ...resolvedOptions } = overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    async () => queryWallet(addr),
-    status => checkOfferState(status, waitForPayouts, offerId),
-    errorMessage,
-    { log, reusePromise: true, setTimeout, ...resolvedOptions },
-  );
-};
-
-/// ////////// Making sure a core-eval successfully sent zoe invitations to committee members for governance /////////////
-
-/**
- *
- * @param {{ updated: string, currentAmount: any }} update
- * @returns {boolean}
- */
-const checkForInvitation = update => {
-  const { updated, currentAmount } = update;
-
-  if (updated !== 'balance') return false;
-  if (!currentAmount || !currentAmount.brand) return false;
-
-  return currentAmount.brand.includes('Invitation');
-};
-
-/**
- *
- * @param {string} addr
- * @param {{ follow: () => object, log: typeof console.log, setTimeout: typeof global.setTimeout}} io
- * @param {WaitUntilOptions} options
- */
-export const waitUntilInvitationReceived = (addr, io, options) => {
-  const { log, follow, setTimeout } = io;
-  const queryWallet = makeQueryWallet(follow);
-  const { errorMessage, ...resolvedOptions } = overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    async () => queryWallet(addr),
-    checkForInvitation,
-    errorMessage,
-    { log, reusePromise: true, setTimeout, ...resolvedOptions },
-  );
-};
-
-/// ////////// Making sure an offer was exited successfully /////////////
-
-const makeQueryWalletCurrent = follow => (/** @type {string} */ addr) =>
-  follow('-lF', `:published.wallet.${addr}.current`);
-
-/**
- * @param {object} update
- * @param {string} offerId
- * @returns {boolean}
- */
-const checkLiveOffers = (update, offerId) => {
-  const liveOffers = update.liveOffers;
-  if (!liveOffers) {
-    return false;
-  }
-  return !liveOffers.some(element => element.includes(offerId));
-};
-
-/**
- * @param {string} addr
- * @param {string} offerId
- * @param {{ follow: () => object, log: typeof console.log, setTimeout: typeof global.setTimeout}} io
- * @param {WaitUntilOptions} options
- */
-export const waitUntilOfferExited = async (addr, offerId, io, options) => {
-  const { log, follow, setTimeout } = io;
-  const queryWalletCurrent = makeQueryWalletCurrent(follow);
-  const { errorMessage, ...resolvedOptions } = overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    async () => queryWalletCurrent(addr),
-    update => checkLiveOffers(update, offerId),
-    errorMessage,
-    { log, setTimeout, ...resolvedOptions },
-  );
-};
-
-/// ////////// Make sure an election held by a given committee //////////
-/// ////////// (see @agoric/governance) turned out as expected //////////
-
-/**
- * @typedef {{
- *   latestOutcome: {
- *     outcome: string;
- *     question: import('@endo/marshal').RemotableObject
- *   },
- *   latestQuestion: {
- *     closingRule: { deadline: bigint },
- *     questionHandle: import('@endo/marshal').RemotableObject
- *   }
- * }} ElectionResult
- */
-
-/**
- * @param {string} basePath
- * @param {import('./vstorage-kit').VstorageKit} vstorage
- * @returns {Promise<ElectionResult>}
- */
-const fetchLatestEcQuestion = async (basePath, vstorage) => {
-  const pathOutcome = `${basePath}.latestOutcome`;
-  const pathQuestion = `${basePath}.latestQuestion`;
-
-  const [latestOutcome, latestQuestion] = await Promise.all([
-    /** @type {Promise<ElectionResult["latestOutcome"]>} */ (
-      vstorage.readLatestHead(pathOutcome)
-    ),
-    /** @type {Promise<ElectionResult["latestQuestion"]>} */ (
-      vstorage.readLatestHead(pathQuestion)
-    ),
-  ]);
-
-  return { latestOutcome, latestQuestion };
-};
-
-/**
- *
- * @param {ElectionResult} electionResult
- * @param {{ outcome: string; deadline: bigint }} expectedResult
- * @returns {boolean}
- */
-const checkCommitteeElectionResult = (electionResult, expectedResult) => {
-  const {
-    latestOutcome: { outcome, question },
-    latestQuestion: {
-      closingRule: { deadline },
-      questionHandle,
-    },
-  } = electionResult;
-  const { outcome: expectedOutcome, deadline: expectedDeadline } =
-    expectedResult;
-
-  return (
-    expectedOutcome === outcome &&
-    deadline === expectedDeadline &&
-    question === questionHandle
-  );
-};
-
-/**
- * Depends on "@agoric/governance" package's committee implementation where for a given committee
- * there's two child nodes in vstorage named "latestOutcome" and "latestQuestion" respectively.
- *
- * @param {string} committeePathBase
- * @param {{
- *   outcome: string;
- *   deadline: bigint;
- * }} expectedResult
- * @param {{
- *   vstorage: import('./vstorage-kit').VstorageKit;
- *   log: typeof console.log,
- *   setTimeout: typeof global.setTimeout
- * }} io
- * @param {WaitUntilOptions} options
- */
-export const waitUntilElectionResult = (
-  committeePathBase,
-  expectedResult,
-  io,
-  options,
-) => {
-  const { vstorage, log, setTimeout } = io;
-
-  const { maxRetries, retryIntervalMs, errorMessage } =
-    overrideDefaultOptions(options);
-
-  return retryUntilCondition(
-    () => fetchLatestEcQuestion(committeePathBase, vstorage),
-    electionResult =>
-      checkCommitteeElectionResult(electionResult, expectedResult),
-    errorMessage,
-    { maxRetries, retryIntervalMs, log, setTimeout },
-  );
-};

package/src/types-index.d.ts

@@ -1,2 +0,0 @@
-// Export all the types this package provides
-export type * from './types.js';

package/src/types-index.js

@@ -1,2 +0,0 @@
-// Dummy for d.ts twin
-export {};

package/src/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAC5H,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACb,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAGpE,KAAK,gBAAgB,GAAG;IACtB,oBAAoB,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACtD,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,sBAAsB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,mBAAmB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,oBAAoB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,wBAAwB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACrD,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB,EAAE,SAAS,CAAC;IAChC,sBAAsB,EAAE,WAAW,CAAC;IACpC,kBAAkB,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,gBAAgB,GAC3E,gBAAgB,CAAC,CAAC,CAAC,GACnB,CAAC,SAAS,UAAU,MAAM,UAAU,GAClC,mBAAmB,GACnB,CAAC,SAAS,UAAU,MAAM,EAAE,GAC1B,YAAY,GACZ,CAAC,SAAS,cAAc,MAAM,iBAAiB,GAC7C,eAAe,GACf,CAAC,SAAS,cAAc,MAAM,gBAAgB,GAC5C,aAAa,GACb,CAAC,SAAS,gCAAgC,MAAM,UAAU,GACxD,oBAAoB,GACpB,CAAC,SAAS,iBAAiB,MAAM,EAAE,GACjC,iBAAiB,GACjB,CAAC,SAAS,eAAe,MAAM,EAAE,GAC/B,oBAAoB,GACpB,OAAO,CAAC"}

package/src/types.ts

@@ -1,63 +0,0 @@
-// @file types for the client-utils package
-// NB: this doesn't follow best practices for TS in JS because this package will likely soon be written in TS
-
-import type { Brand, Issuer } from '@agoric/ertp';
-import type {
-  ContractRecord,
-  FeeConfig,
-  PoolMetrics,
-  TransactionRecord,
-} from '@agoric/fast-usdc';
-import type {
-  OutcomeRecord,
-  QuestionDetails,
-} from '@agoric/governance/src/types.js';
-import type { BookDataNotification } from '@agoric/inter-protocol/src/auction/auctionBook.js';
-import type { AuctionParamRecord } from '@agoric/inter-protocol/src/auction/params.js';
-import type { ScheduleNotification } from '@agoric/inter-protocol/src/auction/scheduler.js';
-import type { MetricsNotification as VaultDirectorMetrics } from '@agoric/inter-protocol/src/vaultFactory/vaultDirector.js';
-import type {
-  CurrentWalletRecord,
-  UpdateRecord,
-} from '@agoric/smart-wallet/src/smartWallet.js';
-import type { AssetInfo } from '@agoric/vats/src/vat-bank.js';
-import type { StatusFor } from '@aglocal/portfolio-contract/src/type-guards.js';
-import type { Instance } from '@agoric/zoe/src/zoeService/types.js';
-
-// For static string key types. String template matching has to be in the ternary below.
-type PublishedTypeMap = {
-  'auction.governance': { current: AuctionParamRecord };
-  'auction.schedule': ScheduleNotification;
-  'vaultFactory.metrics': VaultDirectorMetrics;
-  'agoricNames.instance': Array<[string, Instance]>;
-  'agoricNames.brand': Array<[string, Brand]>;
-  'agoricNames.issuer': Array<[string, Issuer]>;
-  'agoricNames.vbankAsset': Array<[string, AssetInfo]>;
-  fastUsdc: ContractRecord;
-  'fastUsdc.feeConfig': FeeConfig;
-  'fastUsdc.poolMetrics': PoolMetrics;
-  'ymax0.portfolios': StatusFor['portfolios'];
-};
-
-/**
- * Utility type to the type that would result from unmarshalling the latest
- * value at a vstorage `published` path.
- */
-export type TypedPublished<T extends string> = T extends keyof PublishedTypeMap
-  ? PublishedTypeMap[T]
-  : T extends `wallet.${string}.current`
-    ? CurrentWalletRecord
-    : T extends `wallet.${string}`
-      ? UpdateRecord
-      : T extends `committees.${string}.latestQuestion`
-        ? QuestionDetails
-        : T extends `committees.${string}.latestOutcome`
-          ? OutcomeRecord
-          : T extends `vaultFactory.managers.manager${number}.metrics`
-            ? VaultDirectorMetrics
-            : T extends `fastUsdc.txns.${string}`
-              ? TransactionRecord
-              : T extends `auction.book${number}`
-                ? BookDataNotification
-                : unknown;
-// static string keys are defined in PublishedTypeMap

package/src/vstorage-kit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vstorage-kit.d.ts","sourceRoot":"","sources":["vstorage-kit.js"],"names":[],"mappings":";AAgBO;;EAWN;;IAMe,2BADD;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,MAAM;;;kBAuBhB,MAAM;mBAAS,MAAM,EAAE;;MAd3C;IAKe,6BAHJ;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,MAAM,OACzB,KAAK,SAOf;IAEU,mCADC,MAAM,EAAE;cAGC,MAAM;eAAS,MAAM,EAAE;QAS3C;;AAUI,qCAJI,KAAK,YACL,QAAQ,GACN,OAAO,CAAC,OAAO,mCAAmC,EAAE,kBAAkB,CAAC,CAqBnF;AAMM,2CAHI;IAAE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,CAAA;CAAE,UAC9B,oBAAoB;;;;;2BAeV,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC;oBAajC,CAAC,SAAS,MAAM,WAAW,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;2BAnBrD,MAAM,GAAG;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,KAAK,OAAO;;;;;;;;;;;EAoCxD;oBAlHa,UAAU,CAAC,OAAO,aAAa,CAAC;0BAmHhC,UAAU,CAAC,OAAO,eAAe,CAAC;wCA5IzC,mCAAmC;8BASf,eAAe;0CAFH,qBAAqB;oCAC3B,kBAAkB"}

package/src/vstorage-kit.js

@@ -1,144 +0,0 @@
-import {
-  boardSlottingMarshaller,
-  makeBoardRemote,
-} from '@agoric/vats/tools/board-utils.js';
-import { assertAllDefined } from '@agoric/internal';
-import { makeVStorage } from './vstorage.js';
-
-export { boardSlottingMarshaller };
-
-/**
- * @import {MinimalNetworkConfig} from './network-config.js';
- * @import {TypedPublished} from './types-index.js';
- * @import {VStorage} from './vstorage.js';
- */
-
-/** @deprecated */
-export const makeFromBoard = () => {
-  const cache = new Map();
-  const convertSlotToVal = (boardId, iface) => {
-    if (cache.has(boardId)) {
-      return cache.get(boardId);
-    }
-    const val = makeBoardRemote({ boardId, iface });
-    cache.set(boardId, val);
-    return val;
-  };
-  return harden({ convertSlotToVal });
-};
-/** @typedef {ReturnType<typeof makeFromBoard>} IdMap */
-
-/** @deprecated */
-export const storageHelper = {
-  /** @param { {value: string} | string } txt */
-  parseCapData: txt => {
-    /** @type {{ value: string }} */
-    const { value } = typeof txt === 'string' ? JSON.parse(txt) : txt;
-    const specimen = JSON.parse(value);
-    const { blockHeight, values } = specimen;
-    assert(values, `empty values in specimen ${value}`);
-    const capDatas = storageHelper.parseMany(values);
-    return { blockHeight, capDatas };
-  },
-  /**
-   * @param { {value: string} | string } txt
-   * @param {IdMap} ctx
-   */
-  unserializeTxt: (txt, ctx) => {
-    const { capDatas } = storageHelper.parseCapData(txt);
-    return capDatas.map(capData =>
-      boardSlottingMarshaller(ctx.convertSlotToVal).fromCapData(capData),
-    );
-  },
-  /** @param {string[]} capDataStrings array of stringified capData */
-  parseMany: capDataStrings => {
-    assert(capDataStrings && capDataStrings.length);
-    /** @type {{ body: string, slots: string[] }[]} */
-    const capDatas = capDataStrings.map(s => JSON.parse(s));
-    for (const capData of capDatas) {
-      assert(typeof capData === 'object' && capData !== null);
-      assert('body' in capData && 'slots' in capData);
-      assert(typeof capData.body === 'string');
-      assert(Array.isArray(capData.slots));
-    }
-    return capDatas;
-  },
-};
-harden(storageHelper);
-
-/**
- * @deprecated
- * @param {IdMap} ctx
- * @param {VStorage} vstorage
- * @returns {Promise<import('@agoric/vats/tools/board-utils.js').AgoricNamesRemotes>}
- */
-export const makeAgoricNames = async (ctx, vstorage) => {
-  assertAllDefined({ ctx, vstorage });
-  const reverse = {};
-  const entries = await Promise.all(
-    ['brand', 'instance', 'vbankAsset'].map(async kind => {
-      const content = await vstorage.readLatest(
-        `published.agoricNames.${kind}`,
-      );
-      /** @type {Array<[string, import('@agoric/vats/tools/board-utils.js').BoardRemote]>} */
-      const parts = storageHelper.unserializeTxt(content, ctx).at(-1);
-      for (const [name, remote] of parts) {
-        if ('getBoardId' in remote) {
-          reverse[remote.getBoardId()] = name;
-        }
-      }
-      return [kind, Object.fromEntries(parts)];
-    }),
-  );
-  return { ...Object.fromEntries(entries), reverse };
-};
-
-/**
- * @param {{ fetch: typeof window.fetch }} io
- * @param {MinimalNetworkConfig} config
- */
-export const makeVstorageKit = ({ fetch }, config) => {
-  try {
-    const vstorage = makeVStorage({ fetch }, config);
-    const fromBoard = makeFromBoard();
-
-    const marshaller = boardSlottingMarshaller(fromBoard.convertSlotToVal);
-
-    /** @type {(txt: string | {value: string}) => unknown} */
-    const unserializeHead = txt =>
-      storageHelper.unserializeTxt(txt, fromBoard).at(-1);
-
-    /**
-     * Read latest at path and unmarshal it
-     * @type {(path: string) => Promise<unknown>}
-     */
-    const readLatestHead = path =>
-      vstorage.readLatest(path).then(unserializeHead);
-
-    /**
-     * Read latest at published path and unmarshal it.
-     *
-     * Note this does not perform a runtime check to verify the shape. The
-     * static types come from the spec of what is supposed to be written to
-     * vstorage, which is validated in testing of the chain code that is run
-     * in consensus.
-     *
-     * @type {<T extends string>(subpath: T) => Promise<TypedPublished<T>>}
-     */
-    const readPublished = subpath =>
-      // @ts-expect-error cast
-      readLatestHead(`published.${subpath}`);
-
-    return {
-      fromBoard,
-      marshaller,
-      readLatestHead,
-      readPublished,
-      unserializeHead,
-      vstorage,
-    };
-  } catch (err) {
-    throw Error(`RPC failure (${config.rpcAddrs}): ${err.message}`);
-  }
-};
-/** @typedef {ReturnType<typeof makeVstorageKit>} VstorageKit */

package/src/vstorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vstorage.d.ts","sourceRoot":"","sources":["vstorage.js"],"names":[],"mappings":"AA6CO,8BAP4B,CAAC,SAAtB,MAAM,GAAG,UAAW,SACvB,MAAM,qBAEd;IAAiB,IAAI;IACU,MAAM;CACrC,GAAU,eAAe,MAAM,EAAE,CAYnC;AAOM,wCAHJ;IAAoC,KAAK,EAAjC,OAAO,MAAM,CAAC,KAAK;CAC3B,UAAQ,oBAAoB;kBAsBM,CAAC,SAAtB,UAAU,GAAG,MAAO,SACvB,MAAM,qBAEd;QAAiB,IAAI;QACU,MAAM;KACrC,KAAU,OAAO,CAAC,CAAC,SAAS,UAAU,GAAG,qBAAqB,GAAE,iBAAiB,CAAE;IAuCpF;;;;OAIG;sBAFQ,MAAM,GACJ,OAAO,CAAC,iBAAiB,CAAC;IAKvC;;;;;OAKG;gBAFQ,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC;IAM9B;;;;OAIG;iBAHQ,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,WAAW,OAAO,CAAC,CAAC;IASzC;;;;;;OAMG;oBAHQ,MAAM,cACN,MAAM,GAAG,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC;EAyCjC;uBACa,UAAU,CAAC,OAAO,YAAY,CAAC;0CA5LN,qBAAqB;sCANrD,+CAA+C;kCAA/C,+CAA+C;gCAKzB,0CAA0C"}