feat(portfolio-contract): resolve USDC issuer/brand (#11628)

refs:
 - https://github.com/Agoric/agoric-private/issues/346

## Description / Upgrade Considerations

resolve USDC issuer/brand in bootstrap promise space,
which was not done 2023-11 in [#59](https://ping.pub/agoric/gov/59) when the USDC issuer was established.

### Security / Scaling Considerations

nothing new

### Documentation Considerations

presumes documentation suitable for proposal to stakers is forthcoming

### Testing Considerations

A PR stacked on this one should build an a3p-integration test using [fetchCoreEvalRelease](https://github.com/Agoric/agoric-sdk/blob/master/packages/boot/tools/supports.ts#L966) and [evalReleasedProposal](https://github.com/Agoric/agoric-sdk/blob/master/packages/fast-usdc-deploy/test/walletFactory.ts) expanded to handle multiple evals as in 100.

cc @LuqiPan

Author: mergify[bot]

packages/portfolio-deploy/src/usdc-resolve.build.js

@@ -0,0 +1,75 @@
+/**
+ * @file resolve USDC issuer/brand in bootstrap promise space,
+ * which was not done in #59 when the USDC issuer was established.
+ *
+ * This is a combined builder and core eval.
+ *
+ * @see resolveUSDC
+ * @see {@link https://ping.pub/agoric/gov/59 59. Start USDC (Noble) PSM} 2023-11-01
+ */
+import { E } from '@endo/eventual-send';
+import { makeTracer } from '@agoric/internal/src/debug.js';
+
+/**
+ * @import {BootstrapManifestPermit} from '@agoric/vats/src/core/lib-boot';
+ * @import {DeployScriptFunction, CoreEvalBuilder} from '@agoric/deploy-script-support/src/externalTypes.js';
+ */
+
+const trace = makeTracer('USDC-R');
+
+/**
+ * XXX: should add this to BootstrapPowers
+ *
+ * @typedef {{
+ *   issuer: PromiseSpaceOf<{USDC: Issuer<'nat'>}>,
+ *   brand: PromiseSpaceOf<{USDC: Brand<'nat'>}>,
+ * }} USDCResolvePowers
+ */
+
+/** @param {BootstrapPowers & USDCResolvePowers} permitted */
+export const resolveUSDC = async permitted => {
+  trace('resolveUSDC...');
+  const { agoricNames } = permitted.consume;
+
+  /** @type {Promise<Issuer<'nat'>>} */
+  const issuerP = E(agoricNames).lookup('issuer', 'USDC');
+  const [issuer, brand] = await Promise.all([issuerP, E(issuerP).getBrand()]);
+
+  const { USDC: produceIssuer } = permitted.issuer.produce;
+  const { USDC: produceBrand } = permitted.brand.produce;
+
+  produceIssuer.resolve(issuer);
+  produceBrand.resolve(brand);
+
+  trace('... resolveUSDC done', { issuer, brand });
+};
+
+export const getManifestForResolveUSDC = _utils => {
+  return {
+    manifest: {
+      /** @type {BootstrapManifestPermit} */
+      [resolveUSDC.name]: {
+        consume: { agoricNames: true },
+        issuer: { produce: { USDC: true } },
+        brand: { produce: { USDC: true } },
+      },
+    },
+  };
+};
+
+/** @type {CoreEvalBuilder} */
+export const defaultProposalBuilder = async _utils =>
+  harden({
+    // Somewhat unorthodox, source the exports from this builder module
+    sourceSpec: './usdc-resolve.build.js',
+    getManifestCall: [getManifestForResolveUSDC.name],
+  });
+
+/** @type {DeployScriptFunction} */
+export default async (homeP, endowments) => {
+  // import dynamically so the module can work in CoreEval environment
+  const dspModule = await import('@agoric/deploy-script-support');
+  const { makeHelpers } = dspModule;
+  const { writeCoreEval } = await makeHelpers(homeP, endowments);
+  await writeCoreEval('eval-usdc-resolve', defaultProposalBuilder);
+};