Fast USDC a3p deployment proposal (#10517)

closes: #10492

## Description

Adds `f:fast-usdc` that invokes `init-fast-usdc.js` and such.

### Security / Scaling / Upgrade Considerations

Nothing novel to this PR.

### Documentation Considerations

DRAFT until:
 - [x] Update a3p-integration documentation with how to get a chain running at a particular post-proposal configuration.

### Testing Considerations

tests that `agoricNames.instance.fastUsdc` is present.

includes a work-around for...
 - Agoric/agoric-3-proposals#192

a3p-integration/README.md

@@ -1,8 +1,12 @@
-# Overview
+# a3p-integration overview
 
 This directory contains an end-to-end integration test executed against a synthetic agoric-3 chain. The test performs a chain software upgrade to the software contained in the enclosing `agoric-sdk` repository, then executes a series of functional tests verifying the upgrade accomplished its goal.
 
-# How to run
+## Quick-Start: How to Get a Chain Running
+
+To get a chain running with an existing proposal such as `f:fast-usdc`, run `yarn test -m fast-usdc --debug`; likewise `yarn test -m <proposal-name-substring> --debug` for any other proposal name.
+
+## How to run
 
 The synthetic chain testing infrastructure relies on Docker, Docker Buildx extended build capabilities, and the experimental Buildx Bake extension. Make sure you have a recent Docker engine installed for your system.
 

a3p-integration/proposals/f:fast-usdc/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

a3p-integration/proposals/f:fast-usdc/deploy.test.js

@@ -0,0 +1,18 @@
+// @ts-check
+/* global globalThis */
+import test from 'ava';
+import '@endo/init/legacy.js'; // axios compat
+import { makeVstorageKit } from '@agoric/client-utils';
+
+const io = { fetch: globalThis.fetch };
+const networkConfig = {
+  rpcAddrs: ['http://0.0.0.0:26657'],
+  chainName: 'agoriclocal',
+};
+
+test('fastUsdc is in agoricNames.instance', async t => {
+  const { agoricNames } = await makeVstorageKit(io, networkConfig);
+
+  t.log('agoricNames.instance keys', Object.keys(agoricNames.instance));
+  t.truthy(agoricNames.instance.fastUsdc);
+});

a3p-integration/proposals/f:fast-usdc/package.json

@@ -0,0 +1,30 @@
+{
+  "agoricProposal": {
+    "source": "subdir",
+    "$UNTIL": "write-chain-info to agoricNames until #10445 and chainHub setup",
+    "sdk-generate": [
+      "orchestration/write-chain-info.js",
+      "fast-usdc/init-fast-usdc.js submission --oracleSet A3P_INTEGRATION"
+    ],
+    "type": "/agoric.swingset.CoreEvalProposal"
+  },
+  "type": "module",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@agoric/client-utils": "dev",
+    "@agoric/synthetic-chain": "^0.4.3",
+    "@endo/init": "^1.1.7",
+    "ava": "^5.3.1"
+  },
+  "ava": {
+    "concurrency": 1,
+    "timeout": "2m",
+    "files": [
+      "!submission"
+    ]
+  },
+  "scripts": {
+    "agops": "yarn --cwd /usr/src/agoric-sdk/ --silent agops"
+  },
+  "packageManager": "[email protected]"
+}

a3p-integration/proposals/f:fast-usdc/test.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+yarn ava