convert fast-usdc contract to .ts (#10480)

refs: #5760

## Description

Convert some `.js` files of the fast-usdc packages to `.ts`.

I'd like to migrate to `.ts` incrementally because this package is in active development and if I were to migrate the whole thing now there would be lots of merge conflicts.

### Security Considerations

As usual, readers must keep in mind that the types are advisory and be sure that adequate runtime validation is also in place.

### Scaling Considerations
none

### Documentation Considerations
Once this is working, we should convert the demo dapps to it to make them more accessible.

### Testing Considerations
CI should cover it.

### Upgrade Considerations
Should have no runtime impacts.

Author: mergify[bot]

packages/fast-usdc-contract/src/exos/advancer.js

@@ -27,7 +27,7 @@ import { makeFeeTools } from '@agoric/fast-usdc/src/utils/fees.js';
  * @import {VowTools} from '@agoric/vow';
  * @import {Zone} from '@agoric/zone';
  * @import {AddressHook, EvmHash, FeeConfig, LogFn, NobleAddress, EvidenceWithRisk} from '@agoric/fast-usdc/src/types.js';
- * @import {StatusManager} from './status-manager.js';
+ * @import {StatusManager} from './status-manager.ts';
  * @import {LiquidityPoolKit} from './liquidity-pool.js';
  */
 

packages/fast-usdc-contract/src/exos/operator-kit.js renamed to packages/fast-usdc-contract/src/exos/operator-kit.ts

@@ -1,43 +1,45 @@
+import { OperatorKitI } from '@agoric/fast-usdc/src/operator-kit-interface.js';
 import { makeTracer } from '@agoric/internal';
+import type { Zone } from '@agoric/zone';
 import { Fail } from '@endo/errors';
-import { OperatorKitI } from '@agoric/fast-usdc/src/operator-kit-interface.js';
-
-const trace = makeTracer('TxOperator');
+import type {
+  CctpTxEvidence,
+  RiskAssessment,
+} from '@agoric/fast-usdc/src/types.js';
 
-/**
- * @import {Zone} from '@agoric/zone';
- * @import {CctpTxEvidence, RiskAssessment} from '@agoric/fast-usdc/src/types.js';
- */
+const trace: (...args: unknown[]) => void = makeTracer('TxOperator');
 
-/**
- * @typedef {object} OperatorPowers
- * @property {(evidence: CctpTxEvidence, riskAssessment: RiskAssessment, operatorId: string) => void} attest
- */
+interface OperatorPowers {
+  attest: (
+    evidence: CctpTxEvidence,
+    riskAssessment: RiskAssessment,
+    operatorId: string,
+  ) => void;
+}
 
-/**
- * @typedef {object} OperatorStatus
- * @property {boolean} [disabled]
- * @property {string} operatorId
- */
+interface OperatorStatus {
+  disabled?: boolean;
+  operatorId: string;
+}
 
-/**
- * @typedef {Readonly<{ operatorId: string, powers: OperatorPowers }> & {disabled: boolean}} State
- */
+interface State {
+  operatorId: string;
+  powers: OperatorPowers;
+  disabled: boolean;
+}
 
-/**
- * @param {Zone} zone
- * @param {{ makeInertInvitation: Function }} staticPowers
- */
-export const prepareOperatorKit = (zone, staticPowers) =>
+export const prepareOperatorKit = (
+  zone: Zone,
+  staticPowers: { makeInertInvitation: () => Promise<Invitation> },
+) =>
   zone.exoClassKit(
     'Operator Kit',
     OperatorKitI,
     /**
-     * @param {string} operatorId
-     * @param {OperatorPowers} powers facet of the durable transaction feed
-     * @returns {State}
+     * @param operatorId
+     * @param powers facet of the durable transaction feed
      */
-    (operatorId, powers) => {
+    (operatorId: string, powers: OperatorPowers): State => {
       return {
         operatorId,
         powers,
@@ -64,33 +66,34 @@ export const prepareOperatorKit = (zone, staticPowers) =>
          * place, rather than as a means of performing it as in the
          * fluxAggregator contract used for price oracles.
          *
-         * @param {CctpTxEvidence} evidence
-         * @param {RiskAssessment} [riskAssessment]
-         * @returns {Promise<Invitation>}
+         * @param evidence
+         * @param riskAssessment
          */
-        async SubmitEvidence(evidence, riskAssessment) {
+        async SubmitEvidence(
+          evidence: CctpTxEvidence,
+          riskAssessment: RiskAssessment,
+        ): Promise<Invitation> {
           const { operator } = this.facets;
           operator.submitEvidence(evidence, riskAssessment);
-          return staticPowers.makeInertInvitation(
-            'evidence was pushed in the invitation maker call',
-          );
+          return staticPowers.makeInertInvitation();
         },
       },
       operator: {
         /**
          * submit evidence from this operator
          *
-         * @param {CctpTxEvidence} evidence
-         * @param {RiskAssessment} [riskAssessment]
-         * @returns {void}
+         * @param evidence
+         * @param riskAssessment
          */
-        submitEvidence(evidence, riskAssessment = {}) {
+        submitEvidence(
+          evidence: CctpTxEvidence,
+          riskAssessment: RiskAssessment = {},
+        ): void {
           const { state } = this;
           !state.disabled || Fail`submitEvidence for disabled operator`;
           state.powers.attest(evidence, riskAssessment, state.operatorId);
         },
-        /** @returns {OperatorStatus} */
-        getStatus() {
+        getStatus(): OperatorStatus {
           const { state } = this;
           return {
             operatorId: state.operatorId,
@@ -101,4 +104,4 @@ export const prepareOperatorKit = (zone, staticPowers) =>
     },
   );
 
-/** @typedef {ReturnType<ReturnType<typeof prepareOperatorKit>>} OperatorKit */
+export type OperatorKit = ReturnType<ReturnType<typeof prepareOperatorKit>>;

packages/fast-usdc-contract/src/exos/settler.js

@@ -26,7 +26,7 @@ import { asMultiset } from '../utils/store.js';
  * @import {HostOf, HostInterface} from '@agoric/async-flow';
  * @import {TargetRegistration} from '@agoric/vats/src/bridge-target.js';
  * @import {NobleAddress, FeeConfig, EvmHash, LogFn, CctpTxEvidence} from '@agoric/fast-usdc/src/types.js';
- * @import {StatusManager} from './status-manager.js';
+ * @import {StatusManager} from './status-manager.ts';
  * @import {LiquidityPoolKit} from './liquidity-pool.js';
  */