@agoric/internal 0.4.0-u19.2 → 0.4.0-u21.0

package/src/marshal.d.ts

@@ -4,6 +4,11 @@ export function makeBoardRemote({ boardId, iface }: {
 }): BoardRemote;
 export function slotToBoardRemote(boardId: string, iface: string): BoardRemote;
 export function boardSlottingMarshaller(slotToVal?: (slot: string, iface: string) => any): Omit<import("@endo/marshal").Marshal<string | null>, "serialize" | "unserialize">;
+/**
+ * @type {TypedPattern<CapData<any>>}
+ */
+export const CapDataShape: TypedPattern<CapData<any>>;
+export function assertCapData(data: unknown): asserts data is CapData<unknown>;
 export function unmarshalFromVstorage(data: Map<string, string>, key: string, fromCapData: ReturnType<typeof import("@endo/marshal").makeMarshal>["fromCapData"], index: number): any;
 export function makeHistoryReviver(entries: [string, string][], slotToVal?: (slot: string, iface?: string) => any): {
     getItem: (key: string) => any;
@@ -11,10 +16,10 @@ export function makeHistoryReviver(entries: [string, string][], slotToVal?: (slo
     has: (k: string) => boolean;
 };
 export const pureDataMarshaller: {
-    toCapData: import("@endo/marshal").ToCapData<import("@endo/marshal").CapData<unknown>>;
-    fromCapData: import("@endo/marshal").FromCapData<import("@endo/marshal").CapData<unknown>>;
-    serialize: import("@endo/marshal").ToCapData<import("@endo/marshal").CapData<unknown>>;
-    unserialize: import("@endo/marshal").FromCapData<import("@endo/marshal").CapData<unknown>>;
+    toCapData: import("@endo/marshal").ToCapData<CapData<unknown>>;
+    fromCapData: import("@endo/marshal").FromCapData<CapData<unknown>>;
+    serialize: import("@endo/marshal").ToCapData<CapData<unknown>>;
+    unserialize: import("@endo/marshal").FromCapData<CapData<unknown>>;
 };
 /**
  * Should be a union with Remotable, but that's `any`, making this type
@@ -23,4 +28,6 @@ export const pureDataMarshaller: {
 export type BoardRemote = {
     getBoardId: () => string | null;
 };
+import type { CapData } from '@endo/marshal';
+import type { TypedPattern } from './types.js';
 //# sourceMappingURL=marshal.d.ts.map

package/src/marshal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marshal.d.ts","sourceRoot":"","sources":["marshal.js"],"names":[],"mappings":"AAiBO,oDAHI;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,WAAW,CAKvB;AAMM,2CAHI,MAAM,SACN,MAAM,eAGoB;AAqB9B,oDANI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,GAClC,IAAI,CAChB,OAAW,eAAe,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAClD,WAAe,GAAG,aAAa,CAC5B,CAMH;AA6BM,4CATI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OACnB,MAAM,eACN,UAAU,CACpB,cAAkB,eAAe,EAAE,WAAW,CAC3C,CAAC,aAAa,CAAC,SACR,MAAM,GAEJ,GAAG,CAwBf;AASM,4CAHI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,cAClB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG;mBAQlC,MAAM;uBAEN,MAAM;aAYN,MAAM;EAInB;AAID;;;;;EAEG;;;;;0BApIU;IAAE,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAAE"}
+{"version":3,"file":"marshal.d.ts","sourceRoot":"","sources":["marshal.js"],"names":[],"mappings":"AAuBO,oDAHI;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,WAAW,CAKvB;AAMM,2CAHI,MAAM,SACN,MAAM,eAGoB;AAqB9B,oDANI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,GAClC,IAAI,CAChB,OAAW,eAAe,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAClD,WAAe,GAAG,aAAa,CAC5B,CAMH;AAGD;;GAEG;AACH,2BAFU,aAAa,QAAQ,GAAG,CAAC,CAAC,CAE+B;AAS5D,oCAHI,OAAO,GACL,QAAQ,IAAI,IAAI,QAAQ,OAAO,CAAC,CAO5C;AAeM,4CATI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OACnB,MAAM,eACN,UAAU,CACpB,cAAkB,eAAe,EAAE,WAAW,CAC3C,CAAC,aAAa,CAAC,SACR,MAAM,GAEJ,GAAG,CAwBf;AASM,4CAHI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,cAClB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG;mBAQlC,MAAM;uBAEN,MAAM;aAYN,MAAM;EAInB;AAID;;;;;EAEG;;;;;0BA1IU;IAAE,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAAE;6BARtB,eAAe;kCACV,YAAY"}

package/src/marshal.js

@@ -2,8 +2,14 @@
 import { Fail } from '@endo/errors';
 import { Far } from '@endo/far';
 import { makeMarshal } from '@endo/marshal';
+import { M } from '@endo/patterns';
 import { isStreamCell } from './lib-chainStorage.js';
 
+/**
+ * @import {CapData} from '@endo/marshal';
+ * @import {TypedPattern} from './types.js';
+ */
+
 /**
  * Should be a union with Remotable, but that's `any`, making this type
  * meaningless
@@ -52,18 +58,24 @@ export const boardSlottingMarshaller = (slotToVal = undefined) => {
   });
 };
 
-// TODO: Consolidate with `insistCapData` functions from swingset-liveslots,
-// swingset-xsnap-supervisor, etc.
+// TODO move CapDataShape to Endo
 /**
+ * @type {TypedPattern<CapData<any>>}
+ */
+export const CapDataShape = { body: M.string(), slots: M.array() };
+harden(CapDataShape);
+
+/**
+ * Assert that this is CapData
+ *
  * @param {unknown} data
- * @returns {asserts data is import('@endo/marshal').CapData<string>}
+ * @returns {asserts data is CapData<unknown>}
  */
-const assertCapData = data => {
+export const assertCapData = data => {
   assert.typeof(data, 'object');
   assert(data);
-  assert.typeof(data.body, 'string');
-  assert(Array.isArray(data.slots));
-  // XXX check that the .slots array elements are actually strings
+  typeof data.body === 'string' || Fail`data has non-string .body ${data.body}`;
+  Array.isArray(data.slots) || Fail`data has non-Array slots ${data.slots}`;
 };
 harden(assertCapData);
 

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

@@ -1 +1 @@
-{"version":3,"file":"method-tools.d.ts","sourceRoot":"","sources":["method-tools.js"],"names":[],"mappings":"AA0CO,+BAJoB,CAAC,SAAd,WAAY,OACf,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GACZ,CAAC,EAAE,CAsBf;AAUM,qCAJoB,CAAC,SAAd,WAAY,OACf,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GACZ,MAAM,EAAE,CAKlB;AA+BI,+BAJiC,CAAC,SAA3B,MAAM,CAAC,WAAW,EAAE,GAAG,CAAE,OAC5B,CAAC,GACC,CAAC,CAiBX"}
+{"version":3,"file":"method-tools.d.ts","sourceRoot":"","sources":["method-tools.js"],"names":[],"mappings":"AAmBO,+BAJoB,CAAC,SAAd,WAAY,OACf,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GACZ,CAAC,EAAE,CAG8B;AAUvC,qCAJoB,CAAC,SAAd,WAAY,OACf,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GACZ,MAAM,EAAE,CAKlB;AA+BI,+BAJiC,CAAC,SAA3B,MAAM,CAAC,WAAW,EAAE,GAAG,CAAE,OAC5B,CAAC,GACC,CAAC,CAiBX"}

package/src/method-tools.js

@@ -1,66 +1,24 @@
 // @ts-check
-import { isObject } from '@endo/marshal';
+import { getMethodNames as realGetMethodNames } from '@endo/eventual-send/utils.js';
 
 /**
  * @file method-tools use dynamic property lookup, which is not
  *   Jessie-compatible
  */
 
-const { getPrototypeOf, create, fromEntries, getOwnPropertyDescriptors } =
-  Object;
-const { ownKeys, apply } = Reflect;
-
-/**
- * Prioritize symbols as earlier than strings.
- *
- * @param {string | symbol} a
- * @param {string | symbol} b
- * @returns {-1 | 0 | 1}
- */
-const compareStringified = (a, b) => {
-  if (typeof a === typeof b) {
-    const left = String(a);
-    const right = String(b);
-    // eslint-disable-next-line no-nested-ternary
-    return left < right ? -1 : left > right ? 1 : 0;
-  }
-  if (typeof a === 'symbol') {
-    assert(typeof b === 'string');
-    return -1;
-  }
-  assert(typeof a === 'string');
-  assert(typeof b === 'symbol');
-  return 1;
-};
+const { create, fromEntries } = Object;
+const { apply } = Reflect;
 
 /**
  * TODO Consolidate with the `getMethodNames` in `@endo/eventual-send`
  *
+ * @deprecated Use `getMethodNames` from `@endo/eventual-send/utils.js` instead.
  * @template {PropertyKey} K
  * @param {Record<K, any>} val
  * @returns {K[]}
  */
-export const getMethodNames = val => {
-  let layer = val;
-  const names = new Set(); // Set to deduplicate
-  while (layer !== null && layer !== Object.prototype) {
-    // be tolerant of non-objects
-    const descs = getOwnPropertyDescriptors(layer);
-    const ownNames = /** @type {K[]} */ (ownKeys(descs));
-    for (const name of ownNames) {
-      // In case a method is overridden by a non-method,
-      // test `val[name]` rather than `layer[name]`
-      if (typeof val[name] === 'function') {
-        names.add(name);
-      }
-    }
-    if (!isObject(val)) {
-      break;
-    }
-    layer = getPrototypeOf(layer);
-  }
-  return harden([...names].sort(compareStringified));
-};
+export const getMethodNames = val =>
+  /** @type {K[]} */ (realGetMethodNames(val));
 harden(getMethodNames);
 
 /**
@@ -72,7 +30,7 @@ harden(getMethodNames);
  */
 export const getStringMethodNames = val =>
   /** @type {string[]} */ (
-    getMethodNames(val).filter(name => typeof name === 'string')
+    realGetMethodNames(val).filter(name => typeof name === 'string')
   );
 
 /**
@@ -109,7 +67,7 @@ export const bindAllMethods = obj =>
     create(
       obj,
       fromEntries(
-        getMethodNames(obj).map(name => [
+        realGetMethodNames(obj).map(name => [
           name,
           {
             value: (/** @type {unknown[]} */ ...args) =>

package/src/metrics.d.ts

@@ -0,0 +1,183 @@
+export namespace HISTOGRAM_METRICS {
+    namespace swingset_crank_processing_time {
+        let description: "Processing time per crank (ms)";
+        let unit: "ms";
+        let boundaries: number[];
+    }
+    namespace swingset_block_processing_seconds {
+        let description_1: "Processing time per block";
+        export { description_1 as description };
+        let unit_1: "s";
+        export { unit_1 as unit };
+        export { HISTOGRAM_SECONDS_LATENCY_BOUNDARIES as boundaries };
+    }
+    namespace swingset_vat_startup {
+        let description_2: "Vat startup time (ms)";
+        export { description_2 as description };
+        let unit_2: "ms";
+        export { unit_2 as unit };
+        export { HISTOGRAM_MS_LATENCY_BOUNDARIES as boundaries };
+    }
+    namespace swingset_vat_delivery {
+        let description_3: "Vat delivery time (ms)";
+        export { description_3 as description };
+        let unit_3: "ms";
+        export { unit_3 as unit };
+        export { HISTOGRAM_MS_LATENCY_BOUNDARIES as boundaries };
+    }
+    namespace swingset_meter_usage {
+        let description_4: "Vat meter usage";
+        export { description_4 as description };
+        let unit_4: "ms";
+        export { unit_4 as unit };
+        export { HISTOGRAM_MS_LATENCY_BOUNDARIES as boundaries };
+    }
+}
+export namespace BLOCK_HISTOGRAM_METRICS {
+    namespace swingsetRunSeconds {
+        let unit_5: string;
+        export { unit_5 as unit };
+        export namespace advice {
+            let explicitBucketBoundaries: number[];
+        }
+        let description_5: "Per-block time spent executing SwingSet";
+        export { description_5 as description };
+    }
+    namespace swingsetChainSaveSeconds {
+        let unit_6: string;
+        export { unit_6 as unit };
+        export namespace advice_1 { }
+        export { advice_1 as advice };
+        let description_6: "Per-block time spent propagating SwingSet state into cosmos";
+        export { description_6 as description };
+    }
+    namespace swingsetCommitSeconds {
+        let unit_7: string;
+        export { unit_7 as unit };
+        export namespace advice_2 { }
+        export { advice_2 as advice };
+        let description_7: "Per-block time spent committing SwingSet state to host storage";
+        export { description_7 as description };
+    }
+    namespace cosmosCommitSeconds {
+        let unit_8: string;
+        export { unit_8 as unit };
+        export namespace advice_3 { }
+        export { advice_3 as advice };
+        let description_8: "Per-block time spent committing cosmos state";
+        export { description_8 as description };
+    }
+    namespace fullCommitSeconds {
+        let unit_9: string;
+        export { unit_9 as unit };
+        export namespace advice_4 { }
+        export { advice_4 as advice };
+        let description_9: "Per-block time spent committing state, inclusive of COMMIT_BLOCK processing plus time spent [outside of cosmic-swingset] before and after it";
+        export { description_9 as description };
+    }
+    namespace interBlockSeconds {
+        let unit_10: string;
+        export { unit_10 as unit };
+        export namespace advice_5 { }
+        export { advice_5 as advice };
+        let description_10: "Time spent idle between blocks";
+        export { description_10 as description };
+    }
+    namespace afterCommitHangoverSeconds {
+        let unit_11: string;
+        export { unit_11 as unit };
+        export namespace advice_6 { }
+        export { advice_6 as advice };
+        let description_11: "Per-block time spent waiting for previous-block afterCommit work";
+        export { description_11 as description };
+    }
+    namespace blockLagSeconds {
+        export namespace advice_7 {
+            let explicitBucketBoundaries_1: number[];
+            export { explicitBucketBoundaries_1 as explicitBucketBoundaries };
+        }
+        export { advice_7 as advice };
+        let unit_12: string;
+        export { unit_12 as unit };
+        let description_12: "The delay of each block from its expected begin time";
+        export { description_12 as description };
+    }
+}
+export type QueueMetricAspect = (typeof QueueMetricAspect)[keyof typeof QueueMetricAspect];
+export namespace QueueMetricAspect {
+    let Length: "length";
+    let IncrementCount: "increments";
+    let DecrementCount: "decrements";
+}
+export function makeQueueMetricsMeta(namePrefix: string, descPrefix: string): Record<QueueMetricAspect, {
+    name: string;
+    options: MetricAttributes;
+}>;
+export function makeQueueMetrics<QueueName extends string>({ otelMeter, namePrefix, descPrefix, console, }: {
+    otelMeter: OTelMeter;
+    namePrefix: string;
+    descPrefix: string;
+    console?: Pick<Console, "warn"> | undefined;
+}): QueueMetrics<QueueName>;
+/**
+ * @typedef KernelMetricMeta
+ * @property {string} key
+ * @property {string} name
+ * @property {{ dimension: string; value: string }} [sub]
+ * @property {string} description
+ * @property {boolean} [consensus]
+ * @property {MetricType} metricType
+ */
+/** @type {Omit<KernelMetricMeta, 'metricType'>[]} */
+export const KERNEL_STATS_SUM_METRICS: Omit<KernelMetricMeta, "metricType">[];
+/** @type {Omit<KernelMetricMeta, 'metricType'>[]} */
+export const KERNEL_STATS_UPDOWN_METRICS: Omit<KernelMetricMeta, "metricType">[];
+/** @type {KernelMetricMeta[]} */
+export const KERNEL_STATS_METRICS: KernelMetricMeta[];
+export type QueueMetrics<QueueName extends string> = {
+    /**
+     * must be
+     * called before any other function
+     */
+    initLengths: (lengths: Record<QueueName, number>) => void;
+    updateLengths: (lengths: Record<QueueName, number>) => void;
+    /**
+     * for a
+     * non-negative delta
+     */
+    incLength: (queue: QueueName, delta?: number) => void;
+    /**
+     * for a
+     * non-negative delta
+     */
+    decLength: (queue: QueueName, delta?: number) => void;
+};
+export type KernelMetricMeta = {
+    key: string;
+    name: string;
+    sub?: {
+        dimension: string;
+        value: string;
+    } | undefined;
+    description: string;
+    consensus?: boolean | undefined;
+    metricType: MetricType;
+};
+declare const HISTOGRAM_SECONDS_LATENCY_BOUNDARIES: number[];
+/**
+ * @import {Meter as OTelMeter, MetricAttributes} from '@opentelemetry/api';
+ * @import {TotalMap} from '@agoric/internal';
+ */
+declare const HISTOGRAM_MS_LATENCY_BOUNDARIES: number[];
+import type { MetricAttributes } from '@opentelemetry/api';
+import type { Meter as OTelMeter } from '@opentelemetry/api';
+/**
+ * MetricType
+ */
+type MetricType = (typeof MetricType)[keyof typeof MetricType];
+declare namespace MetricType {
+    let Counter: "counter";
+    let Gauge: "gauge";
+}
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/src/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["metrics.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAqH2C,MAAM,EAAE;;;;;;;;;;gCAQxC,CAAC,OAAO,iBAAiB,EAAE,MAAM,OAAO,iBAAiB,CAAC;;;;;;AAiB9D,iDAPI,MAAM,cACN,MAAM,GACJ,MAAM,CACd,iBAAiB,EACrB;IAAM,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAC5C,CAoBH;AA0BM,iCARe,SAAS,SAAlB,MAAQ,mDAElB;IAA0B,SAAS,EAA3B,SAAS;IACM,UAAU,EAAzB,MAAM;IACS,UAAU,EAAzB,MAAM;IACyB,OAAO;CAC9C,GAAU,YAAY,CAAC,SAAS,CAAC,CA8GnC;AAQD;;;;;;;;GAQG;AACH,qDAAqD;AACrD,uCADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CAkF/C;AAEF,qDAAqD;AACrD,0CADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CA4D/C;AAGF,iCAAiC;AACjC,mCADW,gBAAgB,EAAE,CAI1B;yBA3SmB,SAAS,SAAlB,MAAQ;;;;;iBAEP,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;mBAE5C,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;;;;;eAC5C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;;;;eAE1C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;;SAsI1C,MAAM;UACN,MAAM;;mBACO,MAAM;eAAS,MAAM;;iBAClC,MAAM;;gBAEN,UAAU;;AAnRxB,6DACuD;AApBvD;;;GAGG;AAEH,wDAaE;sCAjBqD,oBAAoB;wCAApB,oBAAoB;;;;kBAyRhE,CAAC,OAAO,UAAU,EAAE,MAAM,OAAO,UAAU,CAAC"}