@agoric/orchestration 0.1.1-dev-80db38c.0 → 0.1.1-dev-23e1921.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/orchestration",
-  "version": "0.1.1-dev-80db38c.0+80db38c",
+  "version": "0.1.1-dev-23e1921.0+23e1921",
   "description": "Chain abstraction for Agoric's orchestration clients",
   "type": "module",
   "main": "index.js",
@@ -33,20 +33,20 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-dev-80db38c.0+80db38c",
-    "@agoric/async-flow": "0.1.1-dev-80db38c.0+80db38c",
-    "@agoric/cosmic-proto": "0.4.1-dev-80db38c.0+80db38c",
-    "@agoric/ertp": "0.16.3-dev-80db38c.0+80db38c",
-    "@agoric/internal": "0.3.3-dev-80db38c.0+80db38c",
-    "@agoric/network": "0.1.1-dev-80db38c.0+80db38c",
-    "@agoric/notifier": "0.6.3-dev-80db38c.0+80db38c",
-    "@agoric/store": "0.9.3-dev-80db38c.0+80db38c",
-    "@agoric/time": "0.3.3-dev-80db38c.0+80db38c",
-    "@agoric/vat-data": "0.5.3-dev-80db38c.0+80db38c",
-    "@agoric/vats": "0.15.2-dev-80db38c.0+80db38c",
-    "@agoric/vow": "0.1.1-dev-80db38c.0+80db38c",
-    "@agoric/zoe": "0.26.3-dev-80db38c.0+80db38c",
-    "@agoric/zone": "0.2.3-dev-80db38c.0+80db38c",
+    "@agoric/assert": "0.6.1-dev-23e1921.0+23e1921",
+    "@agoric/async-flow": "0.1.1-dev-23e1921.0+23e1921",
+    "@agoric/cosmic-proto": "0.4.1-dev-23e1921.0+23e1921",
+    "@agoric/ertp": "0.16.3-dev-23e1921.0+23e1921",
+    "@agoric/internal": "0.3.3-dev-23e1921.0+23e1921",
+    "@agoric/network": "0.1.1-dev-23e1921.0+23e1921",
+    "@agoric/notifier": "0.6.3-dev-23e1921.0+23e1921",
+    "@agoric/store": "0.9.3-dev-23e1921.0+23e1921",
+    "@agoric/time": "0.3.3-dev-23e1921.0+23e1921",
+    "@agoric/vat-data": "0.5.3-dev-23e1921.0+23e1921",
+    "@agoric/vats": "0.15.2-dev-23e1921.0+23e1921",
+    "@agoric/vow": "0.1.1-dev-23e1921.0+23e1921",
+    "@agoric/zoe": "0.26.3-dev-23e1921.0+23e1921",
+    "@agoric/zone": "0.2.3-dev-23e1921.0+23e1921",
     "@endo/base64": "^1.0.5",
     "@endo/far": "^1.1.2",
     "@endo/marshal": "^1.5.0",
@@ -90,5 +90,5 @@
   "typeCoverage": {
     "atLeast": 97.1
   },
-  "gitHead": "80db38cafed64c67a087c38bda5dd3373564e50e"
+  "gitHead": "23e1921342fd4d3601b036d69d8791e7437707d2"
 }

package/src/examples/sendAnywhere.contract.d.ts

@@ -1,21 +1,3 @@
-/**
- * @import {Baggage} from '@agoric/vat-data';
- * @import {CosmosChainInfo, IBCConnectionInfo} from '../cosmos-api';
- * @import {TimerService, TimerBrand} from '@agoric/time';
- * @import {LocalChain} from '@agoric/vats/src/localchain.js';
- * @import {OrchestrationService} from '../service.js';
- * @import {NameHub} from '@agoric/vats';
- * @import {Remote} from '@agoric/vow';
- */
-/**
- * @typedef {{
- *   localchain: Remote<LocalChain>;
- *   orchestrationService: Remote<OrchestrationService>;
- *   storageNode: Remote<StorageNode>;
- *   timerService: Remote<TimerService>;
- *   agoricNames: Remote<NameHub>;
- * }} OrchestrationPowers
- */
 export const SingleAmountRecord: import("@endo/patterns").Matcher;
 export function start(zcf: ZCF, privateArgs: OrchestrationPowers & {
     marshaller: Marshaller;

package/src/examples/sendAnywhere.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sendAnywhere.contract.d.ts","sourceRoot":"","sources":["sendAnywhere.contract.js"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AAEH,kEAKE;AASK,2BANI,GAAG,eACH,mBAAmB,GAAG;IAChC,UAAc,EAAE,UAAU,CAAC;CACxB,WACO,OAAO;;;;;QAyFZ;;;WAGG;4BAFQ,eAAe,kBACf,iBAAiB;;GAmBjC;kCAnIY;IACZ,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;6BAhBsB,kBAAkB;qCACS,eAAe;uCAAf,eAAe;gCAEvC,gCAAgC;4BAGpC,aAAa;0CAFC,eAAe;kCAFX,cAAc;6BAG/B,cAAc"}
+{"version":3,"file":"sendAnywhere.contract.d.ts","sourceRoot":"","sources":["sendAnywhere.contract.js"],"names":[],"mappings":"AAoFA,kEAKE;AASK,2BANI,GAAG,eACH,mBAAmB,GAAG;IAChC,UAAc,EAAE,UAAU,CAAC;CACxB,WACO,OAAO;;;;;QAsDZ;;;WAGG;4BAFQ,eAAe,kBACf,iBAAiB;;GAmBjC;kCAlJY;IACZ,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;6BAlBsB,kBAAkB;qCAKS,eAAe;uCAAf,eAAe;gCAHvC,gCAAgC;4BAEpC,aAAa;0CAEC,eAAe;kCALvB,cAAc;6BAEnB,cAAc"}

package/src/examples/sendAnywhere.contract.js

@@ -2,6 +2,7 @@ import { withdrawFromSeat } from '@agoric/zoe/src/contractSupport/zoeHelpers.js'
 import { InvitationShape } from '@agoric/zoe/src/typeGuards.js';
 import { M, mustMatch } from '@endo/patterns';
 import { heapVowE as E } from '@agoric/vow/vat.js';
+import { makeStateRecord } from '@agoric/async-flow';
 import { AmountShape } from '@agoric/ertp';
 import { CosmosChainInfoShape } from '../typeGuards.js';
 import { provideOrchestration } from '../utils/start-helper.js';
@@ -11,12 +12,14 @@ const { entries } = Object;
 
 /**
  * @import {Baggage} from '@agoric/vat-data';
- * @import {CosmosChainInfo, IBCConnectionInfo} from '../cosmos-api';
- * @import {TimerService, TimerBrand} from '@agoric/time';
+ * @import {TimerService} from '@agoric/time';
  * @import {LocalChain} from '@agoric/vats/src/localchain.js';
- * @import {OrchestrationService} from '../service.js';
  * @import {NameHub} from '@agoric/vats';
  * @import {Remote} from '@agoric/vow';
+ * @import {CosmosChainInfo, IBCConnectionInfo} from '../cosmos-api';
+ * @import {OrchestrationService} from '../service.js';
+ * @import {Orchestrator} from '../types.js'
+ * @import {OrchestrationAccount} from '../orchestration-api.js'
  */
 
 /**
@@ -29,6 +32,56 @@ const { entries } = Object;
  * }} OrchestrationPowers
  */
 
+/**
+ * @param {Orchestrator} orch
+ * @param {object} ctx
+ * @param {ZCF} ctx.zcf
+ * @param {any} ctx.agoricNamesTools TODO Give this a better type
+ * @param {{ account: OrchestrationAccount<any> }} ctx.contractState
+ * @param {ZCFSeat} seat
+ * @param {object} offerArgs
+ * @param {string} offerArgs.chainName
+ * @param {string} offerArgs.destAddr
+ */
+const sendItFn = async (
+  orch,
+  { zcf, agoricNamesTools, contractState },
+  seat,
+  offerArgs,
+) => {
+  mustMatch(offerArgs, harden({ chainName: M.scalar(), destAddr: M.string() }));
+  const { chainName, destAddr } = offerArgs;
+  const { give } = seat.getProposal();
+  const [[kw, amt]] = entries(give);
+  // XXX when() until membrane
+  const { denom } = await E.when(agoricNamesTools.findBrandInVBank(amt.brand));
+  const chain = await orch.getChain(chainName);
+
+  // FIXME ok to use a heap var crossing the membrane scope this way?
+  if (!contractState.account) {
+    const agoricChain = await orch.getChain('agoric');
+    // XXX when() until membrane
+    contractState.account = await E.when(agoricChain.makeAccount());
+    console.log('contractState.account', contractState.account);
+  }
+
+  // XXX when() until membrane
+  const info = await E.when(chain.getChainInfo());
+  console.log('info', info);
+  const { chainId } = info;
+  assert(typeof chainId === 'string', 'bad chainId');
+  const { [kw]: pmtP } = await withdrawFromSeat(zcf, seat, give);
+  await E.when(pmtP, pmt => contractState.account.deposit(pmt));
+  await contractState.account.transfer(
+    { denom, value: amt.value },
+    {
+      address: destAddr,
+      addressEncoding: 'bech32',
+      chainId,
+    },
+  );
+};
+
 export const SingleAmountRecord = M.and(
   M.recordOf(M.string(), AmountShape, {
     numPropertiesLimit: 1,
@@ -55,52 +108,17 @@ export const start = async (zcf, privateArgs, baggage) => {
     vowTools,
   });
 
-  /** @type {import('../orchestration-api.js').OrchestrationAccount<any>} */
-  let contractAccount;
+  const contractState = makeStateRecord(
+    /** @type {{ account: OrchestrationAccount<any> | undefined }} */ {
+      account: undefined,
+    },
+  );
 
   /** @type {OfferHandler} */
   const sendIt = orchestrate(
     'sendIt',
-    { zcf, agoricNamesTools },
-    // eslint-disable-next-line no-shadow -- this `zcf` is enclosed in a membrane
-    async (orch, { zcf, agoricNamesTools }, seat, offerArgs) => {
-      mustMatch(
-        offerArgs,
-        harden({ chainName: M.scalar(), destAddr: M.string() }),
-      );
-      const { chainName, destAddr } = offerArgs;
-      const { give } = seat.getProposal();
-      const [[kw, amt]] = entries(give);
-      // XXX when() until membrane
-      const { denom } = await E.when(
-        agoricNamesTools.findBrandInVBank(amt.brand),
-      );
-      const chain = await orch.getChain(chainName);
-
-      // FIXME ok to use a heap var crossing the membrane scope this way?
-      if (!contractAccount) {
-        const agoricChain = await orch.getChain('agoric');
-        // XXX when() until membrane
-        contractAccount = await E.when(agoricChain.makeAccount());
-        console.log('contractAccount', contractAccount);
-      }
-
-      // XXX when() until membrane
-      const info = await E.when(chain.getChainInfo());
-      console.log('info', info);
-      const { chainId } = info;
-      assert(typeof chainId === 'string', 'bad chainId');
-      const { [kw]: pmtP } = await withdrawFromSeat(zcf, seat, give);
-      await E.when(pmtP, pmt => contractAccount.deposit(pmt));
-      await contractAccount.transfer(
-        { denom, value: amt.value },
-        {
-          address: destAddr,
-          addressEncoding: 'bech32',
-          chainId,
-        },
-      );
-    },
+    { zcf, agoricNamesTools, contractState },
+    sendItFn,
   );
 
   const publicFacet = zone.exo(

package/src/examples/swapExample.contract.d.ts

@@ -1,12 +1,3 @@
-/**
- * @import {Orchestrator, IcaAccount, CosmosValidatorAddress} from '../types.js'
- * @import {TimerService} from '@agoric/time';
- * @import {LocalChain} from '@agoric/vats/src/localchain.js';
- * @import {Remote} from '@agoric/internal';
- * @import {OrchestrationService} from '../service.js';
- * @import {Baggage} from '@agoric/vat-data'
- * @import {NameHub} from '@agoric/vats';
- */
 /** @type {ContractMeta<typeof start>} */
 export const meta: ContractMeta<typeof start>;
 export function makeNatAmountShape(brand: Brand, min?: bigint | undefined): {

package/src/examples/swapExample.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swapExample.contract.d.ts","sourceRoot":"","sources":["swapExample.contract.js"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AAEH,yCAAyC;AACzC,mBADW,YAAY,CAAC,OAAO,KAAK,CAAC,CAWnC;AASK,0CAHI,KAAK;;;EAIsC;AAc/C,2BAXI,GAAG,eACH;IACV,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,UAAc,EAAE,UAAU,CAAC;CACxB,WACO,OAAO;;;oBA+BD,MAAM,CAAC,KAAK,CAAC;uBAAa,sBAAsB;;;;oBAAhD,MAAM,CAAC,KAAK,CAAC;uBAAa,sBAAsB;;;GAsEhE;6BAzIyB,cAAc;4BAHf,kBAAkB;gCADd,gCAAgC;0CAEtB,eAAe;kCAHvB,cAAc;6BAInB,kBAAkB;4CALuB,aAAa"}
+{"version":3,"file":"swapExample.contract.d.ts","sourceRoot":"","sources":["swapExample.contract.js"],"names":[],"mappings":"AAuEA,yCAAyC;AACzC,mBADW,YAAY,CAAC,OAAO,KAAK,CAAC,CAWnC;AASK,0CAHI,KAAK;;;EAIsC;AAc/C,2BAXI,GAAG,eACH;IACV,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,UAAc,EAAE,UAAU,CAAC;CACxB,WACO,OAAO;;;oBA+BD,MAAM,CAAC,KAAK,CAAC;uBAAa,sBAAsB;;;;oBAAhD,MAAM,CAAC,KAAK,CAAC;uBAAa,sBAAsB;;;GAsBhE;6BA5IyB,cAAc;4BAHf,kBAAkB;gCADd,gCAAgC;0CAEtB,eAAe;kCAHvB,cAAc;6BAInB,kBAAkB;4CALuB,aAAa"}

package/src/examples/swapExample.contract.js

@@ -18,6 +18,57 @@ import { provideOrchestration } from '../utils/start-helper.js';
  * @import {NameHub} from '@agoric/vats';
  */
 
+/**
+ * @param {Orchestrator} orch
+ * @param {object} ctx
+ * @param {ZCF} ctx.zcf
+ * @param {ZCFSeat} seat
+ * @param {object} offerArgs
+ * @param {Amount<'nat'>} offerArgs.staked
+ * @param {CosmosValidatorAddress} offerArgs.validator
+ */
+const stackAndSwapFn = async (orch, { zcf }, seat, offerArgs) => {
+  const { give } = seat.getProposal();
+
+  const omni = await orch.getChain('omniflixhub');
+  const agoric = await orch.getChain('agoric');
+
+  const [omniAccount, localAccount] = await Promise.all([
+    // XXX when() until membrane
+    heapVowTools.when(omni.makeAccount()),
+    // XXX when() until membrane
+    heapVowTools.when(agoric.makeAccount()),
+  ]);
+
+  const omniAddress = omniAccount.getAddress();
+
+  // deposit funds from user seat to LocalChainAccount
+  const payments = await withdrawFromSeat(zcf, seat, give);
+  await deeplyFulfilled(
+    objectMap(payments, payment =>
+      // @ts-expect-error payment is ERef<Payment> which happens to work but isn't officially supported
+      localAccount.deposit(payment),
+    ),
+  );
+  seat.exit();
+
+  // build swap instructions with orcUtils library
+  const transferMsg = orcUtils.makeOsmosisSwap({
+    destChain: 'omniflixhub',
+    destAddress: omniAddress,
+    amountIn: give.Stable,
+    brandOut: /** @type {any} */ ('FIXME'),
+    slippage: 0.03,
+  });
+
+  await localAccount
+    .transferSteps(give.Stable, transferMsg)
+    .then(_txResult =>
+      omniAccount.delegate(offerArgs.validator, offerArgs.staked),
+    )
+    .catch(e => console.error(e));
+};
+
 /** @type {ContractMeta<typeof start>} */
 export const meta = {
   privateArgsShape: {
@@ -85,55 +136,7 @@ export const start = async (zcf, privateArgs, baggage) => {
    *   { staked: Amount<'nat'>; validator: CosmosValidatorAddress }
    * >}
    */
-  const swapAndStakeHandler = orchestrate(
-    'LSTTia',
-    { zcf },
-    // eslint-disable-next-line no-shadow -- this `zcf` is enclosed in a membrane
-    async (/** @type {Orchestrator} */ orch, { zcf }, seat, offerArgs) => {
-      const { give } = seat.getProposal();
-
-      const omni = await orch.getChain('omniflixhub');
-      const agoric = await orch.getChain('agoric');
-
-      const [omniAccount, localAccount] = await Promise.all([
-        // XXX when() until membrane
-        heapVowTools.when(omni.makeAccount()),
-        // XXX when() until membrane
-        heapVowTools.when(agoric.makeAccount()),
-      ]);
-
-      const omniAddress = omniAccount.getAddress();
-
-      // deposit funds from user seat to LocalChainAccount
-      const payments = await withdrawFromSeat(zcf, seat, give);
-      await deeplyFulfilled(
-        objectMap(payments, payment =>
-          // @ts-expect-error payment is ERef<Payment> which happens to work but isn't officially supported
-          localAccount.deposit(payment),
-        ),
-      );
-      seat.exit();
-
-      // build swap instructions with orcUtils library
-      const transferMsg = orcUtils.makeOsmosisSwap({
-        destChain: 'omniflixhub',
-        destAddress: omniAddress,
-        amountIn: give.Stable,
-        brandOut: /** @type {any} */ ('FIXME'),
-        slippage: 0.03,
-      });
-
-      await localAccount
-        .transferSteps(give.Stable, transferMsg)
-        .then(_txResult =>
-          omniAccount.delegate(offerArgs.validator, offerArgs.staked),
-        )
-        .catch(e => console.error(e));
-
-      // XXX close localAccount?
-      // return continuing inv since this is an offer?
-    },
-  );
+  const swapAndStakeHandler = orchestrate('LSTTia', { zcf }, stackAndSwapFn);
 
   const makeSwapAndStakeInvitation = () =>
     zcf.makeInvitation(

package/src/examples/unbondExample.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unbondExample.contract.d.ts","sourceRoot":"","sources":["unbondExample.contract.js"],"names":[],"mappings":"AA0BO,2BAXI,GAAG,eACH;IACV,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,UAAc,EAAE,UAAU,CAAC;IAC3B,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;CACpC,WACO,OAAO;;;;;;GA0EjB;6BAzFyB,cAAc;4BACf,kBAAkB;gCAFd,gCAAgC;0CAGtB,eAAe;kCALvB,cAAc;6BACnB,kBAAkB"}
+{"version":3,"file":"unbondExample.contract.d.ts","sourceRoot":"","sources":["unbondExample.contract.js"],"names":[],"mappings":"AAwDO,2BAXI,GAAG,eACH;IACV,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,UAAc,EAAE,UAAU,CAAC;IAC3B,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;CACpC,WACO,OAAO;;;;;;GAkDjB;6BA/FyB,cAAc;4BACf,kBAAkB;gCAFd,gCAAgC;0CAGtB,eAAe;kCALvB,cAAc;6BACnB,kBAAkB"}

package/src/examples/unbondExample.contract.js

@@ -12,6 +12,36 @@ import { provideOrchestration } from '../utils/start-helper.js';
  * @import {OrchestrationService} from '../service.js';
  */
 
+/**
+ * @param {Orchestrator} orch
+ * @param {object} ctx
+ * @param {ZCF} ctx.zcf
+ * @param {ZCFSeat} _seat
+ * @param {undefined} _offerArgs
+ */
+const unbondAndLiquidStakeFn = async (orch, { zcf }, _seat, _offerArgs) => {
+  console.log('zcf within the membrane', zcf);
+  // We would actually alreaady have the account from the orchestrator
+  // ??? could these be passed in? It would reduce the size of this handler,
+  // keeping it focused on long-running operations.
+  const omni = await orch.getChain('omniflixhub');
+  const omniAccount = await omni.makeAccount();
+
+  // TODO implement these
+  // const delegations = await celestiaAccount.getDelegations();
+  // // wait for the undelegations to be complete (may take weeks)
+  // await celestiaAccount.undelegate(delegations);
+  // ??? should this be synchronous? depends on how names are resolved.
+  const stride = await orch.getChain('stride');
+  const strideAccount = await stride.makeAccount();
+
+  // TODO the `TIA` string actually needs to be the Brand from AgoricNames
+  // const tiaAmt = await celestiaAccount.getBalance('TIA');
+  // await celestiaAccount.transfer(tiaAmt, strideAccount.getAddress());
+  // await strideAccount.liquidStake(tiaAmt);
+  console.log(omniAccount, strideAccount);
+};
+
 /**
  * @param {ZCF} zcf
  * @param {{
@@ -51,31 +81,7 @@ export const start = async (zcf, privateArgs, baggage) => {
   const unbondAndLiquidStake = orchestrate(
     'LSTTia',
     { zcf },
-    // eslint-disable-next-line no-shadow -- this `zcf` is enclosed in a membrane
-    async (/** @type {Orchestrator} */ orch, { zcf }, _seat, _offerArgs) => {
-      console.log('zcf within the membrane', zcf);
-      // We would actually alreaady have the account from the orchestrator
-      // ??? could these be passed in? It would reduce the size of this handler,
-      // keeping it focused on long-running operations.
-      const omni = await orch.getChain('omniflixhub');
-      const omniAccount = await omni.makeAccount();
-
-      // TODO implement these
-      // const delegations = await celestiaAccount.getDelegations();
-      // // wait for the undelegations to be complete (may take weeks)
-      // await celestiaAccount.undelegate(delegations);
-
-      // ??? should this be synchronous? depends on how names are resolved.
-      const stride = await orch.getChain('stride');
-      const strideAccount = await stride.makeAccount();
-
-      // TODO the `TIA` string actually needs to be the Brand from AgoricNames
-      // const tiaAmt = await celestiaAccount.getBalance('TIA');
-      // await celestiaAccount.transfer(tiaAmt, strideAccount.getAddress());
-
-      // await strideAccount.liquidStake(tiaAmt);
-      console.log(omniAccount, strideAccount);
-    },
+    unbondAndLiquidStakeFn,
   );
 
   const makeUnbondAndLiquidStakeInvitation = () =>

package/src/exos/chain-account-kit.d.ts

@@ -10,7 +10,7 @@ export const ChainAccountI: import("@endo/patterns").InterfaceGuard<{
     close: import("@endo/patterns").MethodGuard;
     getPurse: import("@endo/patterns").MethodGuard;
 }>;
-export function prepareChainAccountKit(zone: Zone, { watch, when }: VowTools): (chainId: string, port: Port, requestedRemoteAddress: string) => import("@endo/exo").GuardedKit<{
+export function prepareChainAccountKit(zone: Zone, { watch, asVow }: VowTools): (chainId: string, port: Port, requestedRemoteAddress: string) => import("@endo/exo").GuardedKit<{
     parseTxPacketWatcher: {
         /** @param {string} ack */
         onFulfilled(ack: string): string;
@@ -18,31 +18,36 @@ export function prepareChainAccountKit(zone: Zone, { watch, when }: VowTools): (
     account: {
         /** @returns {ChainAddress} */
         getAddress(): ChainAddress;
-        getBalance(_denom: any): never;
-        getBalances(): never;
+        getBalance(_denom: any): Vow<never>;
+        getBalances(): Vow<never>;
         getLocalAddress(): `/ibc-port/${string}`;
         getRemoteAddress(): `/${string}ibc-port/${string}/ordered/${string}` | `/${string}ibc-port/${string}/unordered/${string}`;
         getPort(): Port;
-        executeTx(): never;
+        executeTx(): Vow<never>;
         /**
          * Submit a transaction on behalf of the remote account for execution on
          * the remote chain.
          *
          * @param {AnyJson[]} msgs
          * @param {Omit<TxBody, 'messages'>} [opts]
-         * @returns {Promise<string>} - base64 encoded bytes string. Can be
-         *   decoded using the corresponding `Msg*Response` object.
+         * @returns {Vow<string>} - base64 encoded bytes string. Can be decoded
+         *   using the corresponding `Msg*Response` object.
          * @throws {Error} if packet fails to send or an error is returned
          */
-        executeEncodedTx(msgs: AnyJson[], opts?: Omit<TxBody, "messages"> | undefined): Promise<string>;
-        /** Close the remote account */
-        close(): Promise<void>;
+        executeEncodedTx(msgs: AnyJson[], opts?: Omit<TxBody, "messages"> | undefined): Vow<string>;
+        /**
+         * Close the remote account
+         *
+         * @returns {Vow<void>}
+         * @throws {Error} if connection is not available or already closed
+         */
+        close(): Vow<void>;
         /**
          * get Purse for a brand to .withdraw() a Payment from the account
          *
          * @param {Brand} brand
          */
-        getPurse(brand: Brand): Promise<never>;
+        getPurse(brand: Brand): Vow<never>;
     };
     connectionHandler: {
         /**
@@ -51,8 +56,11 @@ export function prepareChainAccountKit(zone: Zone, { watch, when }: VowTools): (
          * @param {RemoteIbcAddress} remoteAddr
          */
         onOpen(connection: Remote<Connection>, localAddr: LocalIbcAddress, remoteAddr: RemoteIbcAddress): Promise<void>;
-        onClose(_connection: any, reason: any): Promise<void>;
-        onReceive(connection: any, bytes: any): Promise<string>;
+        /**
+         * @param {Remote<Connection>} _connection
+         * @param {unknown} reason
+         */
+        onClose(_connection: Remote<Connection>, reason: unknown): Promise<void>;
     };
 }>;
 export type UnparsableChainAddress = "UNPARSABLE_CHAIN_ADDRESS";
@@ -70,6 +78,7 @@ import type { Zone } from '@agoric/base-zone';
 import type { VowTools } from '@agoric/vow';
 import type { Port } from '@agoric/network';
 import type { ChainAddress } from '../types.js';
+import type { Vow } from '@agoric/vow';
 import type { AnyJson } from '@agoric/cosmic-proto';
 import type { TxBody } from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
 import type { Connection } from '@agoric/network';

package/src/exos/chain-account-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-account-kit.d.ts","sourceRoot":"","sources":["chain-account-kit.js"],"names":[],"mappings":"AA8BA;;;;;;;;;;;GAaG;AAkBI,6CAHI,IAAI,mBACJ,QAAQ;;QA+BX,0BAA0B;yBAAd,MAAM;;;QAMlB,8BAA8B;sBAAhB,YAAY;;;;;;;QAiC1B;;;;;;;;;WASG;+BALQ,OAAO,EAAE,gDAEP,OAAO,CAAC,MAAM,CAAC;QAgB5B,+BAA+B;;QAW/B;;;;WAIG;wBADQ,KAAK;;;QAQhB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;;;;GA0BhC;qCA/KW,0BAA0B;oBAmB3B;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,IAAQ,EAAE,IAAI,CAAC;IACf,UAAc,EAAE,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/C,YAAgB,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,sBAA0B,EAAE,MAAM,CAAC;IACnC,aAAiB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,YAAgB,EAAE,YAAY,GAAG,SAAS,CAAC;CACxC;8BAsJU,UAAU,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;0BA7L5C,mBAAmB;8BAEP,aAAa;0BADb,iBAAiB;kCAKrB,aAAa;6BAHlB,sBAAsB;4BACvB,8CAA8C;gCAHpC,iBAAiB;4BACjB,aAAa;qCAGI,iCAAiC;sCAAjC,iCAAiC"}
+{"version":3,"file":"chain-account-kit.d.ts","sourceRoot":"","sources":["chain-account-kit.js"],"names":[],"mappings":"AA8BA;;;;;;;;;;;GAaG;AAkBI,6CAHI,IAAI,oBACJ,QAAQ;;QA+BX,0BAA0B;yBAAd,MAAM;;;QAMlB,8BAA8B;sBAAhB,YAAY;;;;;;;QAiC1B;;;;;;;;;WASG;+BALQ,OAAO,EAAE,gDAEP,IAAI,MAAM,CAAC;QAcxB;;;;;WAKG;iBAFU,IAAI,IAAI,CAAC;QAatB;;;;WAIG;wBADQ,KAAK;;;QAQhB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;QAe3B;;;WAGG;6BAFQ,OAAO,UAAU,CAAC,UAClB,OAAO;;GASvB;qCAlLW,0BAA0B;oBAmB3B;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,IAAQ,EAAE,IAAI,CAAC;IACf,UAAc,EAAE,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/C,YAAgB,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,sBAA0B,EAAE,MAAM,CAAC;IACnC,aAAiB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,YAAgB,EAAE,YAAY,GAAG,SAAS,CAAC;CACxC;8BAyJU,UAAU,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;0BAhM5C,mBAAmB;8BAEF,aAAa;0BADlB,iBAAiB;kCAKrB,aAAa;yBAJJ,aAAa;6BAC3B,sBAAsB;4BACvB,8CAA8C;gCAHpC,iBAAiB;4BACZ,aAAa;qCAGD,iCAAiC;sCAAjC,iCAAiC"}

package/src/exos/chain-account-kit.js

@@ -1,12 +1,12 @@
 /** @file ChainAccount exo */
 import { NonNullish } from '@agoric/assert';
-import { PurseShape } from '@agoric/ertp';
 import { makeTracer } from '@agoric/internal';
+import { VowShape } from '@agoric/vow';
 import { E } from '@endo/far';
 import { M } from '@endo/patterns';
 import {
   ChainAddressShape,
-  ConnectionHandlerI,
+  OutboundConnectionHandlerI,
   Proto3Shape,
 } from '../typeGuards.js';
 import { findAddressField } from '../utils/address.js';
@@ -15,7 +15,7 @@ import { makeTxPacket, parseTxPacket } from '../utils/packet.js';
 /**
  * @import {Zone} from '@agoric/base-zone';
  * @import {Connection, Port} from '@agoric/network';
- * @import {Remote, VowTools} from '@agoric/vow';
+ * @import {Remote, Vow, VowTools} from '@agoric/vow';
  * @import {AnyJson} from '@agoric/cosmic-proto';
  * @import {TxBody} from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
  * @import {LocalIbcAddress, RemoteIbcAddress} from '@agoric/vats/tools/ibc-utils.js';
@@ -30,17 +30,17 @@ const UNPARSABLE_CHAIN_ADDRESS = 'UNPARSABLE_CHAIN_ADDRESS';
 
 export const ChainAccountI = M.interface('ChainAccount', {
   getAddress: M.call().returns(ChainAddressShape),
-  getBalance: M.callWhen(M.string()).returns(M.any()),
-  getBalances: M.callWhen().returns(M.any()),
+  getBalance: M.call(M.string()).returns(VowShape),
+  getBalances: M.call().returns(VowShape),
   getLocalAddress: M.call().returns(M.string()),
   getRemoteAddress: M.call().returns(M.string()),
   getPort: M.call().returns(M.remotable('Port')),
-  executeTx: M.call(M.arrayOf(M.record())).returns(M.promise()),
+  executeTx: M.call(M.arrayOf(M.record())).returns(VowShape),
   executeEncodedTx: M.call(M.arrayOf(Proto3Shape))
     .optional(M.record())
-    .returns(M.promise()),
-  close: M.callWhen().returns(M.undefined()),
-  getPurse: M.callWhen().returns(PurseShape),
+    .returns(VowShape),
+  close: M.call().returns(VowShape),
+  getPurse: M.call().returns(VowShape),
 });
 
 /**
@@ -59,12 +59,12 @@ export const ChainAccountI = M.interface('ChainAccount', {
  * @param {Zone} zone
  * @param {VowTools} vowTools
  */
-export const prepareChainAccountKit = (zone, { watch, when }) =>
+export const prepareChainAccountKit = (zone, { watch, asVow }) =>
   zone.exoClassKit(
     'ChainAccountKit',
     {
       account: ChainAccountI,
-      connectionHandler: ConnectionHandlerI,
+      connectionHandler: OutboundConnectionHandlerI,
       parseTxPacketWatcher: M.interface('ParseTxPacketWatcher', {
         onFulfilled: M.call(M.string())
           .optional(M.arrayOf(M.undefined())) // does not need watcherContext
@@ -103,11 +103,11 @@ export const prepareChainAccountKit = (zone, { watch, when }) =>
         },
         getBalance(_denom) {
           // UNTIL https://github.com/Agoric/agoric-sdk/issues/9326
-          throw new Error('not yet implemented');
+          return asVow(() => Fail`'not yet implemented'`);
         },
         getBalances() {
           // UNTIL https://github.com/Agoric/agoric-sdk/issues/9326
-          throw new Error('not yet implemented');
+          return asVow(() => Fail`'not yet implemented'`);
         },
         getLocalAddress() {
           return NonNullish(
@@ -125,7 +125,7 @@ export const prepareChainAccountKit = (zone, { watch, when }) =>
           return this.state.port;
         },
         executeTx() {
-          throw new Error('not yet implemented');
+          return asVow(() => Fail`'not yet implemented'`);
         },
         /**
          * Submit a transaction on behalf of the remote account for execution on
@@ -133,41 +133,44 @@ export const prepareChainAccountKit = (zone, { watch, when }) =>
          *
          * @param {AnyJson[]} msgs
          * @param {Omit<TxBody, 'messages'>} [opts]
-         * @returns {Promise<string>} - base64 encoded bytes string. Can be
-         *   decoded using the corresponding `Msg*Response` object.
+         * @returns {Vow<string>} - base64 encoded bytes string. Can be decoded
+         *   using the corresponding `Msg*Response` object.
          * @throws {Error} if packet fails to send or an error is returned
          */
-        async executeEncodedTx(msgs, opts) {
-          const { connection } = this.state;
-          // TODO #9281 do not throw synchronously when returning a promise; return a rejected Vow
-          /// see https://github.com/Agoric/agoric-sdk/pull/9454#discussion_r1626898694
-          if (!connection) throw Fail`connection not available`;
-          return when(
-            watch(
+        executeEncodedTx(msgs, opts) {
+          return asVow(() => {
+            const { connection } = this.state;
+            if (!connection) throw Fail`connection not available`;
+            return watch(
               E(connection).send(makeTxPacket(msgs, opts)),
               this.facets.parseTxPacketWatcher,
-            ),
-          );
+            );
+          });
         },
-        /** Close the remote account */
-        async close() {
-          /// TODO #9192 what should the behavior be here? and `onClose`?
-          // - retrieve assets?
-          // - revoke the port?
-          const { connection } = this.state;
-          // TODO #9281 do not throw synchronously when returning a promise; return a rejected Vow
-          /// see https://github.com/Agoric/agoric-sdk/pull/9454#discussion_r1626898694
-          if (!connection) throw Fail`connection not available`;
-          return when(watch(E(connection).close()));
+        /**
+         * Close the remote account
+         *
+         * @returns {Vow<void>}
+         * @throws {Error} if connection is not available or already closed
+         */
+        close() {
+          return asVow(() => {
+            /// TODO #9192 what should the behavior be here? and `onClose`?
+            // - retrieve assets?
+            // - revoke the port?
+            const { connection } = this.state;
+            if (!connection) throw Fail`connection not available`;
+            return E(connection).close();
+          });
         },
         /**
          * get Purse for a brand to .withdraw() a Payment from the account
          *
          * @param {Brand} brand
          */
-        async getPurse(brand) {
+        getPurse(brand) {
           console.log('getPurse got', brand);
-          throw new Error('not yet implemented');
+          return asVow(() => Fail`'not yet implemented'`);
         },
       },
       connectionHandler: {
@@ -189,15 +192,15 @@ export const prepareChainAccountKit = (zone, { watch, when }) =>
             addressEncoding: 'bech32',
           });
         },
+        /**
+         * @param {Remote<Connection>} _connection
+         * @param {unknown} reason
+         */
         async onClose(_connection, reason) {
           trace(`ICA Channel closed. Reason: ${reason}`);
           // FIXME handle connection closing https://github.com/Agoric/agoric-sdk/issues/9192
           // XXX is there a scenario where a connection will unexpectedly close? _I think yes_
         },
-        async onReceive(connection, bytes) {
-          trace(`ICA Channel onReceive`, connection, bytes);
-          return '';
-        },
       },
     },
   );

package/src/exos/icq-connection-kit.d.ts

@@ -27,7 +27,6 @@ export function prepareICQConnectionKit(zone: Zone, { watch, when }: VowTools):
          */
         onOpen(connection: Remote<Connection>, localAddr: LocalIbcAddress, remoteAddr: RemoteIbcAddress): Promise<void>;
         onClose(_connection: any, reason: any): Promise<void>;
-        onReceive(connection: any, bytes: any): Promise<string>;
     };
 }>;
 export type ICQConnectionKitState = {

package/src/exos/icq-connection-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icq-connection-kit.d.ts","sourceRoot":"","sources":["icq-connection-kit.js"],"names":[],"mappings":"AAoBA,2DAGE;AAEF;;;;GAIG;AA2BI,8CAHI,IAAI,mBACJ,QAAQ;;;;QAoCX;;;;WAIG;oBAHQ,SAAS,YAAY,CAAC,EAAE,GACtB,OAAO,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC;;;QAiB/C,wDAAwD;yBAA5C,MAAM;;;QAMlB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;;;;GAiBhC;oCAvGU;IACZ,IAAQ,EAAE,IAAI,CAAC;IACf,UAAc,EAAE,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/C,YAAgB,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,aAAiB,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC7C;+BAoGU,UAAU,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;4BACtD,gBAAgB,CAAC,YAAY,CAAC;0BAjIrB,mBAAmB;8BAEP,aAAa;0BADb,iBAAiB;kCAGN,+CAA+C;8BADlE,sBAAsB;mCACH,+CAA+C;gCAH1D,iBAAiB;4BACjB,aAAa;qCAGI,iCAAiC;sCAAjC,iCAAiC"}
+{"version":3,"file":"icq-connection-kit.d.ts","sourceRoot":"","sources":["icq-connection-kit.js"],"names":[],"mappings":"AAoBA,2DAGE;AAEF;;;;GAIG;AA2BI,8CAHI,IAAI,mBACJ,QAAQ;;;;QAoCX;;;;WAIG;oBAHQ,SAAS,YAAY,CAAC,EAAE,GACtB,OAAO,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC;;;QAiB/C,wDAAwD;yBAA5C,MAAM;;;QAMlB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;;;GAahC;oCAnGU;IACZ,IAAQ,EAAE,IAAI,CAAC;IACf,UAAc,EAAE,OAAO,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/C,YAAgB,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,aAAiB,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC7C;+BAgGU,UAAU,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;4BACtD,gBAAgB,CAAC,YAAY,CAAC;0BA7HrB,mBAAmB;8BAEP,aAAa;0BADb,iBAAiB;kCAGN,+CAA+C;8BADlE,sBAAsB;mCACH,+CAA+C;gCAH1D,iBAAiB;4BACjB,aAAa;qCAGI,iCAAiC;sCAAjC,iCAAiC"}

package/src/exos/icq-connection-kit.js

@@ -4,7 +4,7 @@ import { makeTracer } from '@agoric/internal';
 import { E } from '@endo/far';
 import { M } from '@endo/patterns';
 import { makeQueryPacket, parseQueryPacket } from '../utils/packet.js';
-import { ConnectionHandlerI } from '../typeGuards.js';
+import { OutboundConnectionHandlerI } from '../typeGuards.js';
 
 /**
  * @import {Zone} from '@agoric/base-zone';
@@ -59,7 +59,7 @@ export const prepareICQConnectionKit = (zone, { watch, when }) =>
     'ICQConnectionKit',
     {
       connection: ICQConnectionI,
-      connectionHandler: ConnectionHandlerI,
+      connectionHandler: OutboundConnectionHandlerI,
       parseQueryPacketWatcher: M.interface('ParseQueryPacketWatcher', {
         onFulfilled: M.call(M.string())
           .optional(M.arrayOf(M.undefined())) // does not need watcherContext
@@ -127,10 +127,6 @@ export const prepareICQConnectionKit = (zone, { watch, when }) =>
         async onClose(_connection, reason) {
           trace(`ICQ Channel closed. Reason: ${reason}`);
         },
-        async onReceive(connection, bytes) {
-          trace(`ICQ Channel onReceive`, connection, bytes);
-          return '';
-        },
       },
     },
   );

package/src/facade.d.ts

@@ -15,20 +15,31 @@ export function makeOrchestrationFacade({ zone, timerService, zcf, storageNode,
     asyncFlowTools: AsyncFlowTools;
 }): {
     /**
-     * @template Return
-     * @template Context
-     * @template {any[]} Args
+     * @template GuestReturn
+     * @template HostReturn
+     * @template GuestContext
+     * @template HostContext
+     * @template {any[]} GuestArgs
+     * @template {any[]} HostArgs
      * @param {string} durableName - the orchestration flow identity in the zone
      *   (to resume across upgrades)
-     * @param {Context} ctx - values to pass through the async flow membrane
+     * @param {HostContext} hostCtx - values to pass through the async flow
+     *   membrane
      * @param {(
-     *   orc: Orchestrator,
-     *   ctx2: Context,
-     *   ...args: Args
-     * ) => Promise<Return>} fn
-     * @returns {(...args: Args) => Promise<Return>}
+     *   guestOrc: Orchestrator,
+     *   guestCtx: GuestContext,
+     *   ...args: GuestArgs
+     * ) => Promise<GuestReturn>} guestFn
+     * @returns {(...args: HostArgs) => Promise<HostReturn>} TODO returns a
+     *   Promise for now for compat before use of asyncFlow. But really should
+     *   be `Vow<HostReturn>`
      */
-    orchestrate<Return, Context, Args extends any[]>(durableName: string, ctx: Context, fn: (orc: Orchestrator, ctx2: Context, ...args: Args) => Promise<Return>): (...args: Args) => Promise<Return>;
+    orchestrate<GuestReturn, HostReturn, GuestContext, HostContext, GuestArgs extends any[], HostArgs extends any[]>(durableName: string, hostCtx: HostContext, guestFn: (guestOrc: Orchestrator, guestCtx: GuestContext, ...args: GuestArgs) => Promise<GuestReturn>): (...args: HostArgs) => Promise<HostReturn>;
+    adminAsyncFlow: import("@endo/exo").Guarded<{
+        getFailures(): import("@endo/patterns").CopyMap<any, import("@endo/pass-style").Passable>;
+        wakeAll(): void;
+        getFlowForOutcomeVow(outcomeVow: any): any;
+    }>;
 };
 export type OrchestrationFacade = ReturnType<typeof makeOrchestrationFacade>;
 import type { Zone } from '@agoric/zone';

package/src/facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["facade.js"],"names":[],"mappings":"AAwCO,yPAjBI;IACV,IAAQ,EAAE,IAAI,CAAC;IACf,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,GAAO,EAAE,GAAG,CAAC;IACb,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,QAAY,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAC;IACrD,gCAAoC,EAAE,gCAAgC,CAAC;IACvE,eAAmB,EAAE,eAAe,CAAC;IACrC,8BAAkC,EAAE,GAAG,CAAC;IACxC,oBAAwB,EAAE,oBAAoB,CAAC;IAC/C,qBAAyB,EAAE,qBAAqB,CAAC;IACjD,QAAY,EAAE,QAAQ,CAAC;IACvB,cAAkB,EAAE,cAAc,CAAC;CAChC;IA+CA;;;;;;;;;;;;;OAaG;gBAZU,MAAM,EACN,OAAO,EACC,IAAI,SAAX,GAAG,EAAG,eACT,MAAM,OAEN,OAAO,MACP,CACV,GAAO,EAAE,YAAY,EACrB,IAAQ,EAAE,OAAO,EACjB,GAAO,IAAI,EAAE,IAAI,KACV,OAAO,CAAC,MAAM,CAAC,GACV,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC;EAQlD;kCAEa,UAAU,CAAC,OAAO,uBAAuB,CAAC;0BAnGjC,cAAc;kCAEN,cAAc;4BAIpB,kBAAkB;0CACJ,cAAc;gCAHxB,gCAAgC;sDAOV,uCAAuC;qCAN3C,6CAA6C;0CAIrD,8BAA8B;2CAC7B,+BAA+B;8BATvC,aAAa;oCAFZ,oBAAoB;kCASsD,YAAY"}
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["facade.js"],"names":[],"mappings":"AAwCO,yPAjBI;IACV,IAAQ,EAAE,IAAI,CAAC;IACf,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,GAAO,EAAE,GAAG,CAAC;IACb,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,QAAY,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAC;IACrD,gCAAoC,EAAE,gCAAgC,CAAC;IACvE,eAAmB,EAAE,eAAe,CAAC;IACrC,8BAAkC,EAAE,GAAG,CAAC;IACxC,oBAAwB,EAAE,oBAAoB,CAAC;IAC/C,qBAAyB,EAAE,qBAAqB,CAAC;IACjD,QAAY,EAAE,QAAQ,CAAC;IACvB,cAAkB,EAAE,cAAc,CAAC;CAChC;IAmDA;;;;;;;;;;;;;;;;;;;OAmBG;gBAlBU,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACH,SAAS,SAAhB,GAAG,EAAG,EACC,QAAQ,SAAf,GAAG,EAAG,eACT,MAAM,WAEN,WAAW,WAEX,CACV,QAAY,EAAE,YAAY,EAC1B,QAAY,EAAE,YAAY,EAC1B,GAAO,IAAI,EAAE,SAAS,KACf,OAAO,CAAC,WAAW,CAAC,GACf,CAAC,GAAG,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC;;;;;;EAwB1D;kCAEa,UAAU,CAAC,OAAO,uBAAuB,CAAC;0BA3HjC,cAAc;kCAEN,cAAc;4BAIpB,kBAAkB;0CACJ,cAAc;gCAHxB,gCAAgC;sDAOV,uCAAuC;qCAN3C,6CAA6C;0CAIrD,8BAA8B;2CAC7B,+BAA+B;8BATvC,aAAa;oCAFZ,oBAAoB;kCASsD,YAAY"}

package/src/facade.js

@@ -82,26 +82,50 @@ export const makeOrchestrationFacade = ({
   });
   const makeOrchestrator = pickFacet(makeOrchestratorKit, 'orchestrator');
 
+  const { prepareEndowment, asyncFlow, adminAsyncFlow } = asyncFlowTools;
+
+  const { when } = vowTools;
+
   return {
     /**
-     * @template Return
-     * @template Context
-     * @template {any[]} Args
+     * @template GuestReturn
+     * @template HostReturn
+     * @template GuestContext
+     * @template HostContext
+     * @template {any[]} GuestArgs
+     * @template {any[]} HostArgs
      * @param {string} durableName - the orchestration flow identity in the zone
      *   (to resume across upgrades)
-     * @param {Context} ctx - values to pass through the async flow membrane
+     * @param {HostContext} hostCtx - values to pass through the async flow
+     *   membrane
      * @param {(
-     *   orc: Orchestrator,
-     *   ctx2: Context,
-     *   ...args: Args
-     * ) => Promise<Return>} fn
-     * @returns {(...args: Args) => Promise<Return>}
+     *   guestOrc: Orchestrator,
+     *   guestCtx: GuestContext,
+     *   ...args: GuestArgs
+     * ) => Promise<GuestReturn>} guestFn
+     * @returns {(...args: HostArgs) => Promise<HostReturn>} TODO returns a
+     *   Promise for now for compat before use of asyncFlow. But really should
+     *   be `Vow<HostReturn>`
      */
-    orchestrate(durableName, ctx, fn) {
-      const orc = makeOrchestrator();
+    orchestrate(durableName, hostCtx, guestFn) {
+      const subZone = zone.subZone(durableName);
+
+      const hostOrc = makeOrchestrator();
+
+      const [wrappedOrc, wrappedCtx] = prepareEndowment(subZone, 'endowments', [
+        hostOrc,
+        hostCtx,
+      ]);
+
+      const hostFn = asyncFlow(subZone, 'asyncFlow', guestFn);
 
-      return async (...args) => vowTools.when(fn(orc, ctx, ...args));
+      const orcFn = (...args) =>
+        // TODO remove the `when` after fixing the return type
+        // to `Vow<HostReturn>`
+        when(hostFn(wrappedOrc, wrappedCtx, ...args));
+      return harden(orcFn);
     },
+    adminAsyncFlow,
   };
 };
 harden(makeOrchestrationFacade);

package/src/typeGuards.d.ts

@@ -1,7 +1,11 @@
-export const ConnectionHandlerI: import("@endo/patterns").InterfaceGuard<{
+/**
+ * Used for IBC Channel Connections that only send outgoing transactions. If
+ * your channel expects incoming transactions, please extend this interface to
+ * include the `onReceive` handler.
+ */
+export const OutboundConnectionHandlerI: import("@endo/patterns").InterfaceGuard<{
     onOpen: import("@endo/patterns").MethodGuard;
     onClose: import("@endo/patterns").MethodGuard;
-    onReceive: import("@endo/patterns").MethodGuard;
 }>;
 export namespace ChainAddressShape {
     let address: import("@endo/patterns").Matcher;

package/src/typeGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["typeGuards.js"],"names":[],"mappings":"AAIA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;AAiBH,8DAAkE;;;;;AAOlE,uEAUE;AAEF,iEAA4C;AAC5C,mEAQG;AACH,oEAA+C;AAC/C,sEAYG;AAEH,oEAUE;AAGF,8DAAsC;AACtC,sEAAuE;AACvE,0DAAqC;AAErC,8DAAsC;;;;;;AAItC,mBAAmB;AACnB;;;GAGG"}
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["typeGuards.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;;;GAQE;;;;;;;;;;;;;;;;;;;;;AAiBF,8DAAkE;;;;;AAOlE,uEAUE;AAEF,iEAA4C;AAC5C,mEAQG;AACH,oEAA+C;AAC/C,sEAYG;AAEH,oEAUE;AAGF,8DAAsC;AACtC,sEAAuE;AACvE,0DAAqC;AAErC,8DAAsC;;;;;;AAItC,mBAAmB;AACnB;;;GAGG"}

package/src/typeGuards.js

@@ -2,11 +2,20 @@ import { AmountShape } from '@agoric/ertp';
 import { VowShape } from '@agoric/vow';
 import { M } from '@endo/patterns';
 
-export const ConnectionHandlerI = M.interface('ConnectionHandler', {
-  onOpen: M.callWhen(M.any(), M.string(), M.string(), M.any()).returns(M.any()),
-  onClose: M.callWhen(M.any(), M.any(), M.any()).returns(M.any()),
-  onReceive: M.callWhen(M.any(), M.string()).returns(M.any()),
-});
+/**
+ * Used for IBC Channel Connections that only send outgoing transactions. If
+ * your channel expects incoming transactions, please extend this interface to
+ * include the `onReceive` handler.
+ */
+export const OutboundConnectionHandlerI = M.interface(
+  'OutboundConnectionHandler',
+  {
+    onOpen: M.callWhen(M.any(), M.string(), M.string(), M.any()).returns(
+      M.any(),
+    ),
+    onClose: M.callWhen(M.any(), M.any(), M.any()).returns(M.any()),
+  },
+);
 
 export const ChainAddressShape = {
   address: M.string(),

package/src/utils/start-helper.d.ts

@@ -15,10 +15,15 @@ export function provideOrchestration(zcf: ZCF, baggage: Baggage, remotePowers: O
         watch: <T = any, TResult1 = T, TResult2 = never, C extends any[] = any[]>(specimenP: import("@agoric/vow").ERef<T | import("@agoric/vow").Vow<T>>, watcher?: import("@agoric/vow").Watcher<T, TResult1, TResult2, C> | undefined, ...watcherArgs: C) => import("@agoric/vow").Vow<Exclude<TResult1, void> | Exclude<TResult2, void> extends never ? TResult1 : Exclude<TResult1, void> | Exclude<TResult2, void>>;
         makeVowKit: <T>() => import("@agoric/vow").VowKit<T>;
         allVows: (vows: unknown[]) => import("@agoric/vow").Vow<any[]>;
-        asVow: <T extends unknown>(fn: (...args: any[]) => import("@agoric/vow").Vow<Awaited<T>> | Awaited<T>) => import("@agoric/vow").Vow<Awaited<T>>;
+        asVow: <T extends unknown>(fn: (...args: any[]) => import("@agoric/vow").Vow<Awaited<T>> | Awaited<T> | import("@agoric/vow").PromiseVow<T>) => import("@agoric/vow").Vow<Awaited<T>>;
     };
     zone: import("@agoric/base-zone").Zone;
-    orchestrate<Return, Context, Args extends any[]>(durableName: string, ctx: Context, fn: (orc: import("../orchestration-api.js").Orchestrator, ctx2: Context, ...args: Args) => Promise<Return>): (...args: Args) => Promise<Return>;
+    orchestrate<GuestReturn, HostReturn, GuestContext, HostContext, GuestArgs extends any[], HostArgs extends any[]>(durableName: string, hostCtx: HostContext, guestFn: (guestOrc: import("../orchestration-api.js").Orchestrator, guestCtx: GuestContext, ...args: GuestArgs) => Promise<GuestReturn>): (...args: HostArgs) => Promise<HostReturn>;
+    adminAsyncFlow: import("@endo/exo").Guarded<{
+        getFailures(): import("@endo/patterns").CopyMap<any, import("@endo/pass-style").Passable>;
+        wakeAll(): void;
+        getFlowForOutcomeVow(outcomeVow: any): any;
+    }>;
 };
 export type OrchestrationPowers = {
     localchain: Remote<LocalChain>;

package/src/utils/start-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-helper.d.ts","sourceRoot":"","sources":["start-helper.js"],"names":[],"mappings":"AAwCO,0CALI,GAAG,WACH,OAAO,gBACP,mBAAmB,cACnB,UAAU;;;;;;;;;;;;;;;;;wCAyCjB,GAAF;;;iKAmBG,GAAa,kCAEI,GAAG;EAOxB;kCArFY;IACZ,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;6BAbsB,kBAAkB;gCAFf,gCAAgC;4BAIpC,aAAa;0CACC,eAAe;kCAJX,cAAc;6BAE/B,cAAc"}
+{"version":3,"file":"start-helper.d.ts","sourceRoot":"","sources":["start-helper.js"],"names":[],"mappings":"AAwCO,0CALI,GAAG,WACH,OAAO,gBACP,mBAAmB,cACnB,UAAU;;;;;;;;;;;;;;;;;wCAyCV,GAAG;;;4PA6BS,GACjB,4CAA4E,GAAG;;;;;;EAFpF;kCArFY;IACZ,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,oBAAwB,EAAE,OAAO,oBAAoB,CAAC,CAAC;IACvD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,YAAgB,EAAE,OAAO,YAAY,CAAC,CAAC;IACvC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;6BAbsB,kBAAkB;gCAFf,gCAAgC;4BAIpC,aAAa;0CACC,eAAe;kCAJX,cAAc;6BAE/B,cAAc"}