// @ts-check import { E, Far } from '@endo/far'; import { batchVstorageQuery } from './batchQuery.js'; import { makeClientMarshaller } from './marshalTables.js'; /** * @import {VStorage} from './batchQuery.js'; * @import {ERef} from '@agoric/vow'; * @import {UpdateRecord} from '@agoric/smart-wallet/src/smartWallet.js'; * @import {Marshal} from '@endo/marshal'; */ /** * Iter tools... * * @template T * @param {() => Promise} fn * @param {{ delay: (ms: number) => Promise, period?: number }} opts */ export async function* poll(fn, { delay, period = 1000 }) { await null; for (;;) { const x = await fn(); yield x; await delay(period); } } /** * @template T * @param {AsyncGenerator} src * @param {(a: unknown, b: unknown) => boolean} [equal] */ export async function* dedup(src, equal = (x, y) => x === y) { let last; for await (const x of src) { if (!equal(x, last)) { yield x; last = x; } } } /** * @template T * @template U * @param {AsyncGenerator} src * @param {(x: T) => Promise} fn */ export async function* mapIter(src, fn) { for await (const item of src) { yield fn(item); } } /** * @param {string} key * @param {object} io * @param {VStorage} io.vstorage * @param {(ms: number, opts?: unknown) => Promise} io.delay */ export async function* eachVstorageUpdate(key, { vstorage, delay }) { const { stringify: q } = JSON; const updates = dedup( poll(() => vstorage.readCell(key, { kind: 'data' }), { delay, period: 2000, }), (a, b) => q(a) === q(b), ); for await (const cell of updates) { // use blockHeight? const { values } = cell; for (const value of values) { yield value; } } } /** * @param {string} addr * @param {object} powers * @param {QueryTool} powers.query * @param {VStorage} powers.vstorage */ export const makeWalletView = (addr, { query, vstorage }) => { return Far('WalletQuery', { current: () => query.queryData(`published.wallet.${addr}.current`), /** * TODO: visit in chunks by block * @param {ERef<{visit: (r: UpdateRecord) => void}>} visitor * @param {number} [minHeight] */ history: async (visitor, minHeight) => { const history = vstorage.readHistoryBy( s => query.fromCapData(JSON.parse(s)), `published.wallet.${addr}`, minHeight, ); for await (const record of history) { await E(visitor).visit(record); } }, }); }; /** @typedef {ReturnType} WalletView } */ /** * @param {VStorage} vstorage * @param {Marshal} [m] */ export const makeQueryKit = (vstorage, m = makeClientMarshaller()) => { /** @param {['children' | 'data', string][]} paths */ const batchQuery = async paths => batchVstorageQuery(vstorage, m.fromCapData, paths); /** @param {string} path */ const queryData = async path => { const [[_p, answer]] = await batchQuery([['data', path]]); if (typeof answer === 'string') return answer; if ('error' in answer) throw Error(answer.error); return answer.value; }; /** @param {string} path */ const queryChildren = async path => { const [[_p, answer]] = await batchQuery([['children', path]]); if (typeof answer === 'string') return answer; if ('error' in answer) throw Error(answer.error); return answer.value; }; async function* follow(path, { delay }) { for await (const txt of eachVstorageUpdate(path, { vstorage, delay })) { const value = m.fromCapData(JSON.parse(txt)); yield value; } } const query = Far('QueryTool', { batchQuery, queryData, follow, queryChildren, fromCapData: m.fromCapData, toCapData: m.toCapData, // XXX wrong layer? add makeWalletView(query) helper function instead? walletView: addr => makeWalletView(addr, { query, vstorage }), }); return { vstorage, query }; }; /** @typedef {Awaited>['query']} QueryTool */