Merge pull request #67 from Agoric/type-enforcing-dapp-contracts

Linting dapp-agoric-basics

Author: mujahidkay

contract/.eslintignore

@@ -0,0 +1,2 @@
+bundles
+dist

contract/jsconfig.json

@@ -14,53 +14,53 @@
     "build": "yarn build:deployer",
     "build:deployer": "rollup -c rollup.config.mjs",
     "test": "ava --verbose",
-    "lint": "eslint '**/*.js'",
-    "lint:types": "tsc -p jsconfig.json",
+    "lint": "tsc && eslint '**/*.js'",
     "lint:fix": "eslint --fix '**/*.js'"
   },
   "devDependencies": {
     "@agoric/deploy-script-support": "^0.10.4-u14.0",
-    "@agoric/eslint-config": "dev",
+    "@agoric/eslint-config": "^0.4.1-u16.0",
     "@agoric/smart-wallet": "0.5.4-u14.0",
     "@agoric/store": "0.9.3-u14.0",
     "@agoric/xsnap": "0.14.3-u14.0",
     "@agoric/zone": "0.2.3-u14.0",
-    "@endo/eslint-plugin": "^0.5.2",
+    "@endo/eslint-plugin": "^2.2.1",
     "@endo/nat": "^4.1.27",
     "@endo/promise-kit": "0.2.56",
     "@endo/ses-ava": "^0.2.44",
-    "@jessie.js/eslint-plugin": "^0.4.0",
+    "@jessie.js/eslint-plugin": "^0.4.1",
     "@typescript-eslint/eslint-plugin": "^6.7.0",
     "@typescript-eslint/parser": "^6.7.0",
     "agoric": "^0.21.2-u12.0",
     "ava": "^5.3.0",
     "eslint": "^8.47.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-config-jessie": "^0.0.6",
-    "eslint-config-prettier": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-ava": "^14.0.0",
     "eslint-plugin-github": "^4.10.0",
-    "eslint-plugin-import": "^2.25.3",
-    "eslint-plugin-jsdoc": "^46.4.3",
-    "eslint-plugin-prettier": "^5.0.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-jsdoc": "^48.5.2",
+    "eslint-plugin-prettier": "^5.1.3",
     "import-meta-resolve": "^2.2.1",
     "prettier": "^3.0.3",
     "prettier-plugin-jsdoc": "^1.0.0",
     "type-coverage": "^2.26.3",
-    "typescript": "~5.2.2"
+    "typescript": "^5.5.3",
+    "typescript-eslint": "^7.2.0"
   },
   "dependencies": {
-    "@agoric/ertp": "^0.16.3-u14.0",
+    "@agoric/ertp": "^0.16.3-u16.1",
     "@agoric/governance": "^0.10.4-u14.0",
     "@agoric/inter-protocol": "0.16.2-u14.1",
     "@agoric/vats": "0.15.2-u14.0",
     "@agoric/vat-data": "0.5.3-u14.0",
-    "@agoric/zoe": "^0.26.3-u14.0",
-    "@endo/bundle-source": "^2.8.0",
+    "@agoric/zoe": "^0.26.3-u16.1",
+    "@endo/bundle-source": "^3.4.0",
     "@endo/far": "^0.2.22",
-    "@endo/init": "^0.5.60",
-    "@endo/marshal": "^0.8.9",
-    "@endo/patterns": "^0.2.5"
+    "@endo/init": "^1.1.4",
+    "@endo/marshal": "^1.5.3",
+    "@endo/patterns": "^1.4.3"
   },
   "ava": {
     "files": [
@@ -80,14 +80,35 @@
   },
   "homepage": "https://github.com/Agoric/dapp-agoric-basics#readme",
   "eslintConfig": {
+    "env": {
+      "node": true
+    },
+    "parser": "@typescript-eslint/parser",
     "parserOptions": {
       "sourceType": "module",
       "ecmaVersion": 2021
     },
     "ignorePatterns": "bundles/**.js",
     "extends": [
+      "plugin:@typescript-eslint/recommended",
       "@agoric"
-    ]
+    ],
+    "plugins": [
+      "@typescript-eslint",
+      "prettier"
+    ],
+    "rules": {
+      "prettier/prettier": "warn",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          "vars": "all",
+          "args": "all",
+          "argsIgnorePattern": "^_",
+          "varsIgnorePattern": "^_"
+        }
+      ]
+    }
   },
   "prettier": {
     "trailingComma": "all",

contract/package.json

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-/* global process, fetch, setTimeout */
 // @ts-check
 import '@endo/init';
 import fsp from 'node:fs/promises';

contract/scripts/deploy-contract.js

@@ -2,6 +2,8 @@
 
 import { atomicTransfer } from '@agoric/zoe/src/contractSupport/index.js';
 
+/** @import {Brand} from '@agoric/ertp/src/types.js'; */
+
 /**
  * Provide shared support for providing access to fees from a service contract.
  *

contract/src/collectFees.js

@@ -3,10 +3,15 @@ import { E, Far } from '@endo/far';
 
 const { Fail } = assert;
 
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {NameAdmin} from '@agoric/vats';
+ */
+
 /**
  * ref https://github.com/Agoric/agoric-sdk/issues/8408#issuecomment-1741445458
  *
- * @param {ERef<import('@agoric/vats').NameAdmin>} namesByAddressAdmin
+ * @param {ERef<NameAdmin>} namesByAddressAdmin
  */
 export const fixHub = async namesByAddressAdmin => {
   assert(namesByAddressAdmin, 'no namesByAddressAdmin???');

contract/src/fixHub.js

@@ -3,6 +3,8 @@ import { E } from '@endo/far';
 
 const { entries, fromEntries } = Object;
 
+/** @import {ERef} from '@endo/far'; */
+
 /**
  * Given a record whose values may be promise, return a promise for a record with all the values resolved.
  *

contract/src/objectTools.js

@@ -1,17 +1,26 @@
 // @ts-check
+/// <reference types="@agoric/vats/src/core/types-ambient.js"/>
 import { E, Far } from '@endo/far';
 
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {StorageNode,Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {Zone} from '@agoric/zone';
+ * @import {Brand} from '@agoric/ertp/src/types.js';
+ * @import {Board} from '@agoric/vats';
+ */
+
 const { Fail } = assert;
 
 // vstorage paths under published.*
 // and zone store key
 export const BOARD_AUX = 'boardAux';
 
 /**
- * @param {import('@agoric/zone').Zone} zone
+ * @param {Zone} zone
  * @param {Marshaller} marshalData
  * @param {{
- *   board: ERef<import('@agoric/vats').Board>;
+ *   board: ERef<Board>;
  *   chainStorage: ERef<StorageNode>;
  * }} powers
  */
@@ -73,7 +82,6 @@ export const makeBoardAuxManager = (zone, marshalData, powers) => {
 /**
  * @typedef {PromiseSpaceOf<{
  *   brandAuxPublisher: BrandAuxPublisher;
- *   boardAuxTOFU: BoardAuxTOFU;
  *   boardAuxAdmin: BoardAuxAdmin;
  * }>} BoardAuxPowers
  */
@@ -86,12 +94,12 @@ export const marshalData = harden({
   unserialize: () => Fail`not implemented`,
 });
 
-/** @param {BootstrapPowers} powers */
+/**
+ * @param {BootstrapPowers} powers
+ */
 export const produceBoardAuxManager = async powers => {
   const { zone } = powers;
   const { board } = powers.consume;
-  /** @type {import('../types').NonNullChainStorage['consume']} */
-  // @ts-expect-error cast
   const { chainStorage } = powers.consume;
 
   /** @type {BoardAuxPowers['produce']} */
@@ -100,6 +108,7 @@ export const produceBoardAuxManager = async powers => {
 
   const mgr = makeBoardAuxManager(zone, marshalData, { board, chainStorage });
   produce.brandAuxPublisher.reset();
+
   // TODO: powers.produce.boardAuxTOFU.reset();
   produce.boardAuxAdmin.reset();
   produce.brandAuxPublisher.resolve(mgr.brandAuxPublisher);

contract/src/platform-goals/board-aux.core.js

@@ -2,6 +2,8 @@
 import * as marshal from '@endo/marshal';
 import * as patterns from '@endo/patterns';
 
+/** @import {BootstrapManifestPermit} from '@agoric/vats/src/core/lib-boot.js'; */
+
 /**
  * @typedef {{
  *   endo1: {
@@ -23,9 +25,8 @@ export const produceEndoModules = permittedPowers => {
   produce.endo1.resolve(endo);
 };
 
-/** @type {import('@agoric/vats/src/core/lib-boot').BootstrapManifestPermit} */
+/** @type {BootstrapManifestPermit} */
 export const permit = {
-  /** @type {Record<keyof Endo1Modules, true>} */
   produce: { endo1: true },
 };
 

contract/src/platform-goals/endo1.core.js

@@ -3,6 +3,11 @@
 
 import { E } from '@endo/far';
 
+/**
+ * @import {AssetKind, Brand} from '@agoric/ertp/src/types.js';
+ * @import {BoardAuxPowers} from './board-aux.core.js';
+ */
+
 const { Fail } = assert;
 
 /**
@@ -63,7 +68,7 @@ export const startContract = async (
   console.log(name, 'started');
 
   if (issuerNames) {
-    /** @type {BootstrapPowers & import('./board-aux.core').BoardAuxPowers} */
+    /** @type {BootstrapPowers & BoardAuxPowers} */
     // @ts-expect-error cast
     const auxPowers = powers;