@agoric/orchestration 0.1.1-dev-67275c2.0 → 0.1.1-dev-2e66067.0

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

@@ -13,6 +13,6 @@ export const start: (zcf: ZCF<Record<string, unknown>>, privateArgs: {
 import type { NameHub } from '@agoric/vats';
 import type { Remote } from '@agoric/internal';
 import type { LocalChain } from '@agoric/vats/src/localchain.js';
-import type { CosmosInterchainService } from '../exos/cosmos-interchain-service.js';
+import type { CosmosInterchainService } from '../exos/exo-interfaces.js';
 import type { TimerService } from '@agoric/time';
 //# sourceMappingURL=unbond.contract.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"unbond.contract.d.ts","sourceRoot":"","sources":["unbond.contract.js"],"names":[],"mappings":"AAmDA;iBAhCkB,OAAO,OAAO,CAAC;gBAChB,OAAO,UAAU,CAAC;0BACR,OAAO,uBAAuB,CAAC;iBACxC,OAAO,WAAW,CAAC;gBACpB,UAAU;kBACR,OAAO,YAAY,CAAC;;;;;GA2BU;6BA5CvB,cAAc;4BACf,kBAAkB;gCAFd,gCAAgC;6CAInB,sCAAsC;kCALjD,cAAc"}
+{"version":3,"file":"unbond.contract.d.ts","sourceRoot":"","sources":["unbond.contract.js"],"names":[],"mappings":"AAmDA;iBAhCkB,OAAO,OAAO,CAAC;gBAChB,OAAO,UAAU,CAAC;0BACR,OAAO,uBAAuB,CAAC;iBACxC,OAAO,WAAW,CAAC;gBACpB,UAAU;kBACR,OAAO,YAAY,CAAC;;;;;GA2BU;6BA5CvB,cAAc;4BACf,kBAAkB;gCAFd,gCAAgC;6CAInB,2BAA2B;kCALtC,cAAc"}

package/src/examples/unbond.contract.js

@@ -8,7 +8,7 @@ import * as flows from './unbond.flows.js';
  * @import {NameHub} from '@agoric/vats';
  * @import {Remote} from '@agoric/internal';
  * @import {Zone} from '@agoric/zone';
- * @import {CosmosInterchainService} from '../exos/cosmos-interchain-service.js';
+ * @import {CosmosInterchainService} from '../exos/exo-interfaces.js';
  * @import {OrchestrationTools} from '../utils/start-helper.js';
  */
 

package/src/examples/unbond.flows.js

@@ -5,7 +5,7 @@
  * @import {NameHub} from '@agoric/vats';
  * @import {Remote} from '@agoric/internal';
  * @import {Zone} from '@agoric/zone';
- * @import {CosmosInterchainService} from '../exos/cosmos-interchain-service.js';
+ * @import {CosmosInterchainService} from '../exos/exo-interfaces.js';
  * @import {OrchestrationTools} from '../utils/start-helper.js';
  */
 

package/src/exos/chain-hub-admin.d.ts

@@ -1,8 +1,10 @@
 export function prepareChainHubAdmin(zone: Zone, chainHub: ChainHub): import("@endo/exo").Guarded<{
     /**
-     * @param {string} chainName
+     * Register information for a chain
+     *
+     * @param {string} chainName - must not exist in chainHub
      * @param {CosmosChainInfo} chainInfo
-     * @param {IBCConnectionInfo} connectionInfo
+     * @param {IBCConnectionInfo} connectionInfo - from Agoric chain
      */
     initChain(chainName: string, chainInfo: CosmosChainInfo, connectionInfo: IBCConnectionInfo): Promise<void>;
     /**
@@ -17,9 +19,11 @@ export function prepareChainHubAdmin(zone: Zone, chainHub: ChainHub): import("@e
 }>;
 export type ChainHubAdmin = ReturnType<(zone: Zone, chainHub: ChainHub) => import("@endo/exo").Guarded<{
     /**
-     * @param {string} chainName
+     * Register information for a chain
+     *
+     * @param {string} chainName - must not exist in chainHub
      * @param {CosmosChainInfo} chainInfo
-     * @param {IBCConnectionInfo} connectionInfo
+     * @param {IBCConnectionInfo} connectionInfo - from Agoric chain
      */
     initChain(chainName: string, chainInfo: CosmosChainInfo, connectionInfo: IBCConnectionInfo): Promise<void>;
     /**

package/src/exos/chain-hub-admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-hub-admin.d.ts","sourceRoot":"","sources":["chain-hub-admin.js"],"names":[],"mappings":"AAqBO,2CAHI,IAAI,YACJ,QAAQ;IAeb;;;;OAIG;yBAHQ,MAAM,aACN,eAAe,kBACf,iBAAiB;IAe5B;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;GAU3B;4BAEa,UAAU,QApDb,IAAI,YACJ,QAAQ;IAeb;;;;OAIG;yBAHQ,MAAM,aACN,eAAe,kBACf,iBAAiB;IAe5B;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;GAYkB;0BA9DvB,cAAc;8BAEG,gBAAgB;qCADI,uBAAuB;uCAAvB,uBAAuB;2BAAvB,uBAAuB;iCAC3C,gBAAgB"}
+{"version":3,"file":"chain-hub-admin.d.ts","sourceRoot":"","sources":["chain-hub-admin.js"],"names":[],"mappings":"AAgCO,2CAHI,IAAI,YACJ,QAAQ;IAeb;;;;;;OAMG;yBAHQ,MAAM,aACN,eAAe,kBACf,iBAAiB;IAe5B;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;GAU3B;4BAEa,UAAU,QAtDb,IAAI,YACJ,QAAQ;IAeb;;;;;;OAMG;yBAHQ,MAAM,aACN,eAAe,kBACf,iBAAiB;IAe5B;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;GAYkB;0BA3EvB,cAAc;8BAEG,gBAAgB;qCADI,uBAAuB;uCAAvB,uBAAuB;2BAAvB,uBAAuB;iCAC3C,gBAAgB"}

package/src/exos/chain-hub-admin.js

@@ -16,6 +16,17 @@ import { DenomDetailShape } from './chain-hub.js';
  * developers to add new chain configurations to a local chainHub, in the event
  * the information is not available widely in `agoricNames`.
  *
+ * @example
+ *
+ * ```js
+ * const chainHubAdmin = prepareChainHubAdmin(zone, chainHub);
+ * chainHubAdmin.initChain(
+ *   'hotNewChain',
+ *   hotNewChainInfo,
+ *   agoricTohotNewChainConnectionInfo,
+ * );
+ * ```
+ *
  * @param {Zone} zone
  * @param {ChainHub} chainHub
  */
@@ -33,9 +44,11 @@ export const prepareChainHubAdmin = (zone, chainHub) => {
     }),
     {
       /**
-       * @param {string} chainName
+       * Register information for a chain
+       *
+       * @param {string} chainName - must not exist in chainHub
        * @param {CosmosChainInfo} chainInfo
-       * @param {IBCConnectionInfo} connectionInfo
+       * @param {IBCConnectionInfo} connectionInfo - from Agoric chain
        */
       async initChain(chainName, chainInfo, connectionInfo) {
         // when() because chainHub methods return vows. If this were inside

package/src/exos/chain-hub.d.ts

@@ -14,6 +14,7 @@
  * @typedef {K extends keyof KnownChains
  *   ? ChainInfo & Omit<KnownChains[K], 'connections'>
  *   : ChainInfo} ActualChainInfo
+ * @internal
  */
 /**
  * @typedef {object} DenomDetail
@@ -32,7 +33,6 @@ export const CONNECTIONS_KEY: "chainConnection";
 /** namehub for assets info */
 export const ASSETS_KEY: "chainAssets";
 export function connectionKey(chainId1: string, chainId2: string): string;
-export function reverseConnInfo(connInfo: IBCConnectionInfo): IBCConnectionInfo;
 export function normalizeConnectionInfo(primaryChainId: string, counterChainId: string, directed: IBCConnectionInfo): [string, IBCConnectionInfo];
 export function makeChainHub(agoricNames: Remote<NameHub>, vowTools: VowTools): import("@endo/exo").Guarded<{
     /**

package/src/exos/chain-hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-hub.d.ts","sourceRoot":"","sources":["chain-hub.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,wCAAwC;AACxC,+BADW,aAAa,WAAW,CAAC,CAIlC;AAEF,wCAAwC;AACxC,gCAAiC;AACjC,kCAAkC;AAClC,gDAAiD;AACjD,8BAA8B;AAC9B,uCAAwC;AAqBjC,wCAHI,MAAM,YACN,MAAM,UAUhB;AAQM,0CAHI,iBAAiB,GACf,iBAAiB,CAuB7B;AAUM,wDALI,MAAM,kBACN,MAAM,YACN,iBAAiB,GACf,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAavC;AA0DM,0CAHI,OAAO,OAAO,CAAC,YACf,QAAQ;IA+Gf;;;;;;;;;;;OAWG;wBAFQ,MAAM,aACN,eAAe;IAK1B;;;;OAIG;iBAHmB,CAAC,SAAV,MAAQ,aACV,CAAC,GACC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;IAYpC;;;;OAIG;uCAHQ,MAAM,uBACN,MAAM,kBACN,iBAAiB;IAW5B;;;;OAIG;+BAHQ,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,WAC5B,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAC1B,IAAI,iBAAiB,CAAC;IAmBnC;;;;;;;;OAQG;2BAPmB,EAAE,SAAX,MAAQ,EACC,EAAE,SAAX,MAAQ,eACV,EAAE,eACF,EAAE,GACA,IACZ,CAAK,eAAe,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAC9D;IAOJ;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;IAatB;;;;;OAKG;oBAFQ,KAAK,GACH,WAAW,GAAG,SAAS;IAQpC;;;;;OAKG;oBAFQ,KAAK,GACH,KAAK,GAAG,SAAS;GAWjC;AAQM,yCAJI,QAAQ,QACR,MAAM,UACN,eAAe,EAAE,QAe3B;;;;4BAlaqB,CAAC,SAAV,MAAQ,IACR,CAAC,SAAS,MAAM,WAAW,GACjC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,GAC/C,SAAS;;;;;cAKF,MAAM;;;;eACN,KAAK;;;;eACL,MAAM;;;;;;uBAoYN,UAAU,CAAC,OAAO,YAAY,CAAC;kCApZd,kBAAkB;uCAJqB,kBAAkB;6BAF9D,cAAc;4BAKf,kBAAkB;8BAJX,aAAa;qCACyB,kBAAkB;yBADxD,aAAa;2BAGrB,yBAAyB;qCAFqB,kBAAkB;iCAC/C,kBAAkB;+BAAlB,kBAAkB"}
+{"version":3,"file":"chain-hub.d.ts","sourceRoot":"","sources":["chain-hub.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,wCAAwC;AACxC,+BADW,aAAa,WAAW,CAAC,CAIlC;AAGF,wCAAwC;AACxC,gCAAiC;AACjC,kCAAkC;AAClC,gDAAiD;AACjD,8BAA8B;AAC9B,uCAAwC;AAqBjC,wCAHI,MAAM,YACN,MAAM,UAUhB;AAuCM,wDALI,MAAM,kBACN,MAAM,YACN,iBAAiB,GACf,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAavC;AA0DM,0CAHI,OAAO,OAAO,CAAC,YACf,QAAQ;IA+Gf;;;;;;;;;;;OAWG;wBAFQ,MAAM,aACN,eAAe;IAK1B;;;;OAIG;iBAHmB,CAAC,SAAV,MAAQ,aACV,CAAC,GACC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;IAYpC;;;;OAIG;uCAHQ,MAAM,uBACN,MAAM,kBACN,iBAAiB;IAW5B;;;;OAIG;+BAHQ,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,WAC5B,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAC1B,IAAI,iBAAiB,CAAC;IAmBnC;;;;;;;;OAQG;2BAPmB,EAAE,SAAX,MAAQ,EACC,EAAE,SAAX,MAAQ,eACV,EAAE,eACF,EAAE,GACA,IACZ,CAAK,eAAe,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAC9D;IAOJ;;;;;;;OAOG;yBAHQ,KAAK,UAEL,WAAW;IAatB;;;;;OAKG;oBAFQ,KAAK,GACH,WAAW,GAAG,SAAS;IAQpC;;;;;OAKG;oBAFQ,KAAK,GACH,KAAK,GAAG,SAAS;GAWjC;AAUM,yCAJI,QAAQ,QACR,MAAM,UACN,eAAe,EAAE,QAe3B;;;;4BAtaqB,CAAC,SAAV,MAAQ,IACR,CAAC,SAAS,MAAM,WAAW,GACjC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,GAC/C,SAAS;;;;;cAMF,MAAM;;;;eACN,KAAK;;;;eACL,MAAM;;;;;;uBAqYN,UAAU,CAAC,OAAO,YAAY,CAAC;kCAtZd,kBAAkB;uCAJqB,kBAAkB;6BAF9D,cAAc;4BAKf,kBAAkB;8BAJX,aAAa;qCACyB,kBAAkB;yBADxD,aAAa;2BAGrB,yBAAyB;qCAFqB,kBAAkB;iCAC/C,kBAAkB;+BAAlB,kBAAkB"}

package/src/exos/chain-hub.js

@@ -24,6 +24,7 @@ import { CosmosChainInfoShape, IBCConnectionInfoShape } from '../typeGuards.js';
  * @typedef {K extends keyof KnownChains
  *   ? ChainInfo & Omit<KnownChains[K], 'connections'>
  *   : ChainInfo} ActualChainInfo
+ * @internal
  */
 
 /**
@@ -40,6 +41,7 @@ export const DenomDetailShape = M.splitRecord(
   { brand: BrandShape },
 );
 
+// TODO refactor into an enum-ish object
 /** agoricNames key for ChainInfo hub */
 export const CHAIN_KEY = 'chain';
 /** namehub for connection info */
@@ -82,7 +84,7 @@ export const connectionKey = (chainId1, chainId2) => {
  * @param {IBCConnectionInfo} connInfo
  * @returns {IBCConnectionInfo}
  */
-export const reverseConnInfo = connInfo => {
+const reverseConnInfo = connInfo => {
   const { transferChannel } = connInfo;
   return {
     id: connInfo.counterparty.connection_id,
@@ -421,6 +423,8 @@ export const makeChainHub = (agoricNames, vowTools) => {
 /** @typedef {ReturnType<typeof makeChainHub>} ChainHub */
 
 /**
+ * Register assets with the given ChainHub so they are available for lookup
+ *
  * @param {ChainHub} chainHub
  * @param {string} name
  * @param {CosmosAssetInfo[]} assets

package/src/exos/cosmos-interchain-service.d.ts

@@ -1,21 +1,71 @@
-export function prepareCosmosInterchainService(zone: Zone, vowTools: VowTools): (initialPowers: any) => import("@endo/exo").Guarded<{
+export function prepareCosmosInterchainService(zone: Zone, vowTools: VowTools): (powers: Partial<OrchestrationPowers>) => ReturnType<(powers: Partial<OrchestrationPowers>) => import("@endo/exo").GuardedKit<{
+    requestICAChannelWatcher: {
+        /**
+         * @param {Port} port
+         * @param {{
+         *   chainId: string;
+         *   remoteConnAddr: RemoteIbcAddress;
+         * }} watchContext
+         */
+        onFulfilled(port: Port, { chainId, remoteConnAddr }: {
+            chainId: string;
+            remoteConnAddr: RemoteIbcAddress;
+        }): Vow<any>;
+    };
+    requestICQChannelWatcher: {
+        /**
+         * @param {Port} port
+         * @param {{
+         *   remoteConnAddr: RemoteIbcAddress;
+         *   icqLookupKey: string;
+         * }} watchContext
+         */
+        onFulfilled(port: Port, { remoteConnAddr, icqLookupKey }: {
+            remoteConnAddr: RemoteIbcAddress;
+            icqLookupKey: string;
+        }): Vow<any>;
+    };
     /**
-     * @param {string} chainId
-     * @param {IBCConnectionID} hostConnectionId the counterparty
-     *   connection_id
-     * @param {IBCConnectionID} controllerConnectionId self connection_id
-     * @param {ICAChannelAddressOpts} [opts] optional to configure the
-     *   channel address, such as version and ordering
-     * @returns {Vow<IcaAccount>}
+     * Waits for a channel (ICA, ICQ) to open and returns the consumer-facing
+     * facet of the ConnectionKit, specified by `returnFacet`. Saves the
+     * ConnectionKit if `saveICQConnection` is provided.
      */
-    makeAccount(chainId: string, hostConnectionId: IBCConnectionID, controllerConnectionId: IBCConnectionID, opts?: ICAChannelAddressOpts | undefined): Vow<IcaAccount>;
-    /**
-     * @param {IBCConnectionID} controllerConnectionId
-     * @param {string} [version]
-     * @returns {Vow<ICQConnection> | ICQConnection}
-     */
-    provideICQConnection(controllerConnectionId: IBCConnectionID, version?: string | undefined): Vow<ICQConnection> | ICQConnection;
-}>;
+    channelOpenWatcher: {
+        /**
+         * @param {Connection} _connection
+         * @param {{
+         *   connectionKit: ConnectionKit;
+         *   returnFacet: string;
+         *   icqLookupKey?: string;
+         * }} watchContext
+         */
+        onFulfilled(_connection: Connection, { connectionKit, returnFacet, icqLookupKey }: {
+            connectionKit: ConnectionKit;
+            returnFacet: string;
+            icqLookupKey?: string;
+        }): any;
+    };
+    public: {
+        /**
+         * @satisfies {CosmosInterchainService['makeAccount']}
+         * @param {string} chainId
+         * @param {IBCConnectionID} hostConnectionId the counterparty
+         *   connection_id
+         * @param {IBCConnectionID} controllerConnectionId self connection_id
+         * @param {ICAChannelAddressOpts} [opts] optional to configure the
+         *   channel address, such as version and ordering
+         * @returns {Vow<IcaAccount>}
+         */
+        makeAccount(chainId: string, hostConnectionId: IBCConnectionID, controllerConnectionId: IBCConnectionID, opts?: ICAChannelAddressOpts | undefined): Vow<IcaAccount>;
+        /**
+         * @satisfies {CosmosInterchainService['provideICQConnection']}
+         * @param {IBCConnectionID} controllerConnectionId
+         * @param {string} [version]
+         * @returns {Vow<ICQConnection> | ICQConnection}
+         */
+        provideICQConnection(controllerConnectionId: IBCConnectionID, version?: string | undefined): Vow<ICQConnection> | ICQConnection;
+    };
+}>>["public"];
 export type OrchestrationPowers = {
     portAllocator: Remote<PortAllocator>;
     /**
@@ -31,17 +81,18 @@ export type OrchestrationState = {
     sharedICQPort: Remote<Port> | undefined;
 } & OrchestrationPowers;
 export type MakeCosmosInterchainService = ReturnType<typeof prepareCosmosInterchainService>;
-export type CosmosInterchainService = ReturnType<MakeCosmosInterchainService>;
 import type { Zone } from '@agoric/base-zone';
 import type { VowTools } from '@agoric/vow';
+import type { Port } from '@agoric/network';
+import type { RemoteIbcAddress } from '@agoric/vats/tools/ibc-utils.js';
+import type { Vow } from '@agoric/vow';
+import type { Connection } from '@agoric/network';
 import type { IBCConnectionID } from '@agoric/vats';
 import type { ICAChannelAddressOpts } from '../utils/address.js';
 import type { IcaAccount } from '../types.js';
-import type { Vow } from '@agoric/vow';
 import type { ICQConnection } from '../types.js';
 import type { PortAllocator } from '@agoric/network';
 import type { Remote } from '@agoric/internal';
 import type { ICQConnectionKit } from '../types.js';
 import type { IcaAccountKit } from '../types.js';
-import type { Port } from '@agoric/network';
 //# sourceMappingURL=cosmos-interchain-service.d.ts.map

package/src/exos/cosmos-interchain-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cosmos-interchain-service.d.ts","sourceRoot":"","sources":["cosmos-interchain-service.js"],"names":[],"mappings":"AA6PO,qDAHI,IAAI,YACJ,QAAQ;IAnEX;;;;;;;;OAQG;yBAPQ,MAAM,oBACN,eAAe,0BAEf,eAAe,6CAGb,IAAI,UAAU,CAAC;IAkB5B;;;;OAIG;iDAHQ,eAAe,iCAEb,IAAI,aAAa,CAAC,GAAG,aAAa;GAwDtD;;mBAjPa,OAAO,aAAa,CAAC;;;;;cACrB,SAAS;;iCAIT,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;4BAElC,aAAa,GAAG,gBAAgB;iCAGjC;IACZ,cAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,SAAS,CAAC;CACzC,GAAG,mBAAmB;0CAuOZ,UAAU,CAAC,OAAO,8BAA8B,CAAC;sCACjD,UAAU,CAAC,2BAA2B,CAAC;0BAlQ9B,mBAAmB;8BAKV,aAAa;qCAFX,cAAc;2CAIR,qBAAqB;gCADgB,aAAa;yBAD1D,aAAa;mCACgC,aAAa;mCAJxC,iBAAiB;4BAD1C,kBAAkB;sCAKkC,aAAa;mCAAb,aAAa;0BAJxC,iBAAiB"}
+{"version":3,"file":"cosmos-interchain-service.d.ts","sourceRoot":"","sources":["cosmos-interchain-service.js"],"names":[],"mappings":"AAmQO,qDAJI,IAAI,YACJ,QAAQ;;QA5IX;;;;;;WAMG;0BALQ,IAAI,+BACJ;YACV,OAAW,EAAE,MAAM,CAAC;YACpB,cAAkB,EAAE,gBAAgB,CAAC;SAClC;;;QAgBJ;;;;;;WAMG;0BALQ,IAAI,oCACJ;YACV,cAAkB,EAAE,gBAAgB,CAAC;YACrC,YAAgB,EAAE,MAAM,CAAC;SACtB;;IAkBN;;;;OAIG;;QAED;;;;;;;WAOG;iCANQ,UAAU,gDACV;YACV,aAAiB,EAAE,aAAa,CAAC;YACjC,WAAe,EAAE,MAAM,CAAC;YACxB,YAAgB,CAAC,EAAE,MAAM,CAAC;SACvB;;;QAaJ;;;;;;;;;WASG;6BAPQ,MAAM,oBACN,eAAe,0BAEf,eAAe,6CAGb,IAAI,UAAU,CAAC;QAkB5B;;;;;WAKG;qDAHQ,eAAe,iCAEb,IAAI,aAAa,CAAC,GAAG,aAAa;;cA6DtD;;mBAxPa,OAAO,aAAa,CAAC;;;;;cACrB,SAAS;;iCAIT,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;4BAElC,aAAa,GAAG,gBAAgB;iCAGjC;IACZ,cAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,SAAS,CAAC;CACzC,GAAG,mBAAmB;0CA8OZ,UAAU,CAAC,OAAO,8BAA8B,CAAC;0BAxQxC,mBAAmB;8BAKV,aAAa;0BAHK,iBAAiB;sCAEhC,iCAAiC;yBACpC,aAAa;gCAHK,iBAAiB;qCACjC,cAAc;2CAIR,qBAAqB;gCADgB,aAAa;mCAAb,aAAa;mCAJxC,iBAAiB;4BAD1C,kBAAkB;sCAKkC,aAAa;mCAAb,aAAa"}

package/src/exos/cosmos-interchain-service.js

@@ -1,15 +1,16 @@
 /** @file Orchestration service */
 
+import { Shape as NetworkShape } from '@agoric/network';
+import { pickFacet } from '@agoric/vat-data';
 import { E } from '@endo/far';
 import { M, mustMatch } from '@endo/patterns';
-import { Shape as NetworkShape } from '@agoric/network';
-import { prepareIcaAccountKit } from './ica-account-kit.js';
-import { prepareICQConnectionKit } from './icq-connection-kit.js';
 import {
   DEFAULT_ICQ_VERSION,
   makeICAChannelAddress,
   makeICQChannelAddress,
 } from '../utils/address.js';
+import { prepareIcaAccountKit } from './ica-account-kit.js';
+import { prepareICQConnectionKit } from './icq-connection-kit.js';
 
 /**
  * @import {Zone} from '@agoric/base-zone';
@@ -183,6 +184,7 @@ const prepareCosmosOrchestrationServiceKit = (
       },
       public: {
         /**
+         * @satisfies {CosmosInterchainService['makeAccount']}
          * @param {string} chainId
          * @param {IBCConnectionID} hostConnectionId the counterparty
          *   connection_id
@@ -208,6 +210,7 @@ const prepareCosmosOrchestrationServiceKit = (
           );
         },
         /**
+         * @satisfies {CosmosInterchainService['provideICQConnection']}
          * @param {IBCConnectionID} controllerConnectionId
          * @param {string} [version]
          * @returns {Vow<ICQConnection> | ICQConnection}
@@ -248,8 +251,11 @@ const prepareCosmosOrchestrationServiceKit = (
   );
 
 /**
+ * Used only by vat-orchestration and tests mocking it
+ *
  * @param {Zone} zone
  * @param {VowTools} vowTools
+ * @internal
  */
 export const prepareCosmosInterchainService = (zone, vowTools) => {
   const makeIcaAccountKit = prepareIcaAccountKit(zone, vowTools);
@@ -262,12 +268,13 @@ export const prepareCosmosInterchainService = (zone, vowTools) => {
       makeICQConnectionKit,
     );
 
-  const makeCosmosInterchainService = initialPowers =>
-    makeCosmosOrchestrationServiceKit(initialPowers).public;
+  const makeCosmosInterchainService = pickFacet(
+    makeCosmosOrchestrationServiceKit,
+    'public',
+  );
 
   return makeCosmosInterchainService;
 };
 harden(prepareCosmosInterchainService);
 
 /** @typedef {ReturnType<typeof prepareCosmosInterchainService>} MakeCosmosInterchainService */
-/** @typedef {ReturnType<MakeCosmosInterchainService>} CosmosInterchainService */

package/src/exos/cosmos-orchestration-account.d.ts

@@ -3,6 +3,7 @@
  * @property {ChainAddress} chainAddress
  */
 /**
+ * @private
  * @typedef {{
  *   topicKit: RecorderKit<ComosOrchestrationAccountNotification>;
  *   account: IcaAccount;
@@ -13,6 +14,7 @@
  *   bondDenom: string;
  *   timer: Remote<TimerService>;
  * }} State
+ *   Internal to the IcaAccountHolder exo
  */
 /**
  * @typedef {{
@@ -211,6 +213,9 @@ export function prepareCosmosOrchestrationAccount(zone: Zone, { chainHub, makeRe
 export type ComosOrchestrationAccountNotification = {
     chainAddress: ChainAddress;
 };
+/**
+ * Internal to the IcaAccountHolder exo
+ */
 export type State = {
     topicKit: RecorderKit<ComosOrchestrationAccountNotification>;
     account: IcaAccount;

package/src/exos/cosmos-orchestration-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cosmos-orchestration-account.d.ts","sourceRoot":"","sources":["cosmos-orchestration-account.js"],"names":[],"mappings":"AAiEA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,mCAAmC;AACnC;;;;;;;;;;;;;;;;;GAeG;AAOH;;;;;;;;;;;GAkBE;AAYK,2DARI,IAAI,gGAEZ;IAAyB,QAAQ,EAAzB,QAAQ;IACgB,eAAe,EAAvC,eAAe;IACc,YAAY,EAAzC,OAAO,YAAY,CAAC;IACH,QAAQ,EAAzB,QAAQ;IACI,GAAG,EAAf,GAAG;CACb;kBA8Dc,YAAY;eACZ,MAAM;kBACN,eAAe;mBACf,gBAAgB;;aAEhB,UAAU;iBACV,OAAO,WAAW,CAAC;mBACnB,aAAa,GAAG,SAAS;WACzB,OAAO,YAAY,CAAC;;;QAgC3B,wDAAwD;;;QAWxD;;;WAGG;6BAFQ,SAAS,GACP,IAAI;;;QAOjB;;WAEG;8BADQ,SAAS,aAAa,CAAC,EAAE;;;QAYpC;;WAEG;8BADQ,SAAS,aAAa,CAAC,EAAE;;;QAsBpC;;WAEG;4BADQ,MAAM;;IAgBnB;;;OAGG;;QAED,uDAAuD;4BAA3C,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;QAO5C,6BAA6B;4BAAjB,MAAM;;;QAYlB;;;;;;;;;;WAUG;6DATQ,CACV;YAAM,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAA;SAAE,EAC7D,MAAU,CACP,gCACO;YACV,WAAe,EAAE,YAAY,CAAC;YAC9B,IAAQ,CAAC,EAAE,qBAAqB,CAAC;YACjC,KAAS,EAAE,IAAI,CAAC;SACb;;;QA2BJ;;;WAGG;4BAFQ,sBAAsB,UACtB,SAAS;QAUpB;;;;WAIG;iCAHQ,sBAAsB,gBACtB,sBAAsB,UACtB,SAAS;QAYpB,gDAAgD;kCAApC,sBAAsB;QASlC,kEAAkE;gCAAtD,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE;;;;uBAyB9B,YAAY;oBAAU,SAAS;;;uBAa/B,YAAY;qBAAW,SAAS,EAAE;;QAStD;;;;WAIG;;;oBASc,SAAS;yBACJ,YAAY;kBACnB,qBAAqB;;;;QAcpC,iEAAiE;;QAsBjE,+DAA+D;;QAiB/D,0DAA0D;;QAI1D,wDAAwD;;QAuBxD,0DAA0D;;QAyB1D,8DAA8D;;QAgB9D,0DAA0D;;QAmB1D,2DAA2D;;QAkB3D,oDAAoD;;QAqBpD,uDAAuD;;QAqBvD,wDAAwD;;QAkCxD,6DAA6D;;QAM7D,+DAA+D;;QAK/D,0DAA0D;;QAwB1D,+CAA+C;;QAI/C,+CAA+C;;;GAStD;AAsBM,wDAbI,IAAI,8DAEZ;IAAyB,QAAQ,EAAzB,QAAQ;IACgB,eAAe,EAAvC,eAAe;IACc,YAAY,EAAzC,OAAO,YAAY,CAAC;IACH,QAAQ,EAAzB,QAAQ;IACI,GAAG,EAAf,GAAG;CACX,GAAU,CACZ,GAAO,IAAI,EAAE,UAAU,CACvB,UAAgB,CAAC,OAAO,oCAAoC,CAAC,CACxD,KACE,6BAA6B,CAAC,QAAQ,CAAC,CAc9C;;kBAptBa,YAAY;;oBAIb;IACZ,QAAY,EAAE,YAAY,qCAAqC,CAAC,CAAC;IACjE,OAAW,EAAE,UAAU,CAAC;IACxB,YAAgB,EAAE,YAAY,CAAC;IAC/B,YAAgB,EAAE,eAAe,CAAC;IAClC,aAAiB,EAAE,gBAAgB,CAAC;IACpC,aAAiB,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,SAAa,EAAE,MAAM,CAAC;IACtB,KAAS,EAAE,OAAO,YAAY,CAAC,CAAC;CAC7B;qDAIS;IACZ,YAAgB,EAAE,eAAe,CAAC;IAClC,aAAiB,EAAE,gBAAgB,CAAC;CACjC;4CAiqBS,UAAU,CACtB,UAAc,CAAC,OAAO,oCAAoC,CAAC,CACxD;yCA8BU,6BAA6B,CAAC,QAAQ,CAAC;0BAluB9B,cAAc;8BARuK,aAAa;qCAC1K,6CAA6C;kCAK7D,cAAc;4BAFpB,kBAAkB;8BAGX,aAAa;kCAP+J,aAAa;qCAYrK,iCAAiC;sCAAjC,iCAAiC;gCAZuH,aAAa;mCAAb,aAAa;+BAAb,aAAa;0BAElM,kDAAkD;mCAOzC,+CAA+C;8BACpD,sBAAsB;iCAV2J,aAAa;yBAOzL,aAAa;uCAP+J,aAAa;2CAAb,aAAa;4CAAb,aAAa;gCAG5L,wDAAwD;iCAFtC,6CAA6C"}
+{"version":3,"file":"cosmos-orchestration-account.d.ts","sourceRoot":"","sources":["cosmos-orchestration-account.js"],"names":[],"mappings":"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"}

package/src/exos/cosmos-orchestration-account.js

@@ -69,6 +69,7 @@ const { Vow$ } = NetworkShape; // TODO #9611
  */
 
 /**
+ * @private
  * @typedef {{
  *   topicKit: RecorderKit<ComosOrchestrationAccountNotification>;
  *   account: IcaAccount;
@@ -79,6 +80,7 @@ const { Vow$ } = NetworkShape; // TODO #9611
  *   bondDenom: string;
  *   timer: Remote<TimerService>;
  * }} State
+ *   Internal to the IcaAccountHolder exo
  */
 
 /**

package/src/exos/exo-interfaces.d.ts

@@ -0,0 +1,27 @@
+import type { IBCConnectionID } from '@agoric/vats';
+import type { Vow } from '@agoric/vow';
+import type { IcaAccount } from '../cosmos-api.ts';
+import type { ICAChannelAddressOpts } from '../utils/address';
+import type { ICQConnection } from './icq-connection-kit';
+/**
+ * Authority to make a Cosmos interchain account or an interchain query connection.
+ */
+export interface CosmosInterchainService {
+    /**
+     * @param {string} chainId
+     * @param {IBCConnectionID} hostConnectionId the counterparty
+     *   connection_id
+     * @param {IBCConnectionID} controllerConnectionId self connection_id
+     * @param {ICAChannelAddressOpts} [opts] optional to configure the
+     *   channel address, such as version and ordering
+     * @returns {Vow<IcaAccount>}
+     */
+    makeAccount(chainId: string, hostConnectionId: IBCConnectionID, controllerConnectionId: IBCConnectionID, opts?: ICAChannelAddressOpts | undefined): Vow<IcaAccount>;
+    /**
+     * @param {IBCConnectionID} controllerConnectionId
+     * @param {string} [version]
+     * @returns {Vow<ICQConnection> | ICQConnection}
+     */
+    provideICQConnection(controllerConnectionId: IBCConnectionID, version?: string | undefined): Vow<ICQConnection> | ICQConnection;
+}
+//# sourceMappingURL=exo-interfaces.d.ts.map

package/src/exos/exo-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exo-interfaces.d.ts","sourceRoot":"","sources":["exo-interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,eAAe,EACjC,sBAAsB,EAAE,eAAe,EACvC,IAAI,CAAC,EAAE,qBAAqB,GAAG,SAAS,GACvC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnB;;;;OAIG;IACH,oBAAoB,CAClB,sBAAsB,EAAE,eAAe,EACvC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAC3B,GAAG,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CACvC"}

package/src/exos/exo-interfaces.ts

@@ -0,0 +1,35 @@
+import type { IBCConnectionID } from '@agoric/vats';
+import type { Vow } from '@agoric/vow';
+import type { IcaAccount } from '../cosmos-api.ts';
+import type { ICAChannelAddressOpts } from '../utils/address';
+import type { ICQConnection } from './icq-connection-kit';
+
+/**
+ * Authority to make a Cosmos interchain account or an interchain query connection.
+ */
+export interface CosmosInterchainService {
+  /**
+   * @param {string} chainId
+   * @param {IBCConnectionID} hostConnectionId the counterparty
+   *   connection_id
+   * @param {IBCConnectionID} controllerConnectionId self connection_id
+   * @param {ICAChannelAddressOpts} [opts] optional to configure the
+   *   channel address, such as version and ordering
+   * @returns {Vow<IcaAccount>}
+   */
+  makeAccount(
+    chainId: string,
+    hostConnectionId: IBCConnectionID,
+    controllerConnectionId: IBCConnectionID,
+    opts?: ICAChannelAddressOpts | undefined,
+  ): Vow<IcaAccount>;
+  /**
+   * @param {IBCConnectionID} controllerConnectionId
+   * @param {string} [version]
+   * @returns {Vow<ICQConnection> | ICQConnection}
+   */
+  provideICQConnection(
+    controllerConnectionId: IBCConnectionID,
+    version?: string | undefined,
+  ): Vow<ICQConnection> | ICQConnection;
+}

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

@@ -63,7 +63,9 @@ export function prepareIcaAccountKit(zone: Zone, { watch, asVow }: VowTools): (c
         onClose(_connection: Remote<Connection>, reason: unknown): Promise<void>;
     };
 }>;
-export type UnparsableChainAddress = "UNPARSABLE_CHAIN_ADDRESS";
+/**
+ * Internal to the IcaAccountKit exo
+ */
 export type State = {
     chainId: string;
     port: Port;

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

@@ -1 +1 @@
-{"version":3,"file":"ica-account-kit.d.ts","sourceRoot":"","sources":["ica-account-kit.js"],"names":[],"mappings":"AA+BA;;;;;;;;;GAWG;AAmBI,2CAHI,IAAI,oBACJ,QAAQ;;QAgCX,0BAA0B;yBAAd,MAAM;;;QAMlB,8BAA8B;sBAAhB,YAAY;;;;;QAyB1B;;;;;;;;;WASG;+BALQ,OAAO,EAAE,gDAEP,IAAI,MAAM,CAAC;QAgBxB,+CAA+C;;QAS/C,+CAA+C;;;;QAiB/C;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;QAiB3B;;;;;;;;;;;;;;;;WAgBG;6BAHQ,OAAO,UAAU,CAAC,UAClB,OAAO;;GAkBvB;qCAlMW,0BAA0B;oBAiB3B;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;IAC3C,iBAAqB,EAAE,OAAO,CAAC;CAC5B;4BA0KU,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;0BA/M1C,mBAAmB;8BAEF,aAAa;0BADlB,iBAAiB;kCAKT,aAAa;yBAJhB,aAAa;6BAC3B,sBAAsB;4BACvB,8CAA8C;gCAHpC,iBAAiB;4BACZ,aAAa;qCAGD,iCAAiC;sCAAjC,iCAAiC"}
+{"version":3,"file":"ica-account-kit.d.ts","sourceRoot":"","sources":["ica-account-kit.js"],"names":[],"mappings":"AA8BA;;;;;;;;;GAWG;AA0BI,2CAJI,IAAI,oBACJ,QAAQ;;QAiCX,0BAA0B;yBAAd,MAAM;;;QAMlB,8BAA8B;sBAAhB,YAAY;;;;;QAyB1B;;;;;;;;;WASG;+BALQ,OAAO,EAAE,gDAEP,IAAI,MAAM,CAAC;QAgBxB,+CAA+C;;QAS/C,+CAA+C;;;;QAiB/C;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;QAiB3B;;;;;;;;;;;;;;;;WAgBG;6BAHQ,OAAO,UAAU,CAAC,UAClB,OAAO;;GAkBvB;;;;oBAtLU;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;IAC3C,iBAAqB,EAAE,OAAO,CAAC;CAC5B;4BA+KU,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;0BArN1C,mBAAmB;8BAEF,aAAa;0BADlB,iBAAiB;kCAKT,aAAa;yBAJhB,aAAa;6BAC3B,sBAAsB;4BACvB,8CAA8C;gCAHpC,iBAAiB;4BACZ,aAAa;qCAGD,iCAAiC;sCAAjC,iCAAiC"}

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

@@ -26,7 +26,6 @@ import { makeTxPacket, parseTxPacket } from '../utils/packet.js';
 
 const trace = makeTracer('IcaAccountKit');
 
-/** @typedef {'UNPARSABLE_CHAIN_ADDRESS'} UnparsableChainAddress */
 const UNPARSABLE_CHAIN_ADDRESS = 'UNPARSABLE_CHAIN_ADDRESS';
 
 export const IcaAccountI = M.interface('IcaAccount', {
@@ -42,7 +41,9 @@ export const IcaAccountI = M.interface('IcaAccount', {
   reactivate: M.call().returns(VowShape),
 });
 
+// XXX none of these modifiers are working to exclude this type from api-docs
 /**
+ * @private
  * @typedef {{
  *   chainId: string;
  *   port: Port;
@@ -53,11 +54,16 @@ export const IcaAccountI = M.interface('IcaAccount', {
  *   chainAddress: ChainAddress | undefined;
  *   isInitiatingClose: boolean;
  * }} State
+ *   Internal to the IcaAccountKit exo
+ * @internal
  */
 
 /**
+ * Used only by CosmosInterchainService
+ *
  * @param {Zone} zone
  * @param {VowTools} vowTools
+ * @internal
  */
 export const prepareIcaAccountKit = (zone, { watch, asVow }) =>
   zone.exoClassKit(

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;;;;GAIG;AA2BI,8CAHI,IAAI,oBACJ,QAAQ;;;;QAoCX;;;;;WAKG;oBAFQ,SAAS,YAAY,CAAC,EAAE,GACtB,IAAI,SAAS,aAAa,CAAC,EAAE,CAAC;;;QAc3C,wDAAwD;yBAA5C,MAAM;;;QAMlB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;;;GAahC;oCAlGU;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;+BA+FU,UAAU,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;4BACtD,gBAAgB,CAAC,YAAY,CAAC;0BAtHrB,mBAAmB;8BAEF,aAAa;0BADlB,iBAAiB;kCAGN,+CAA+C;8BADlE,sBAAsB;mCACH,+CAA+C;yBAFrD,aAAa;gCADlB,iBAAiB;4BACZ,aAAa;qCAGD,iCAAiC;sCAAjC,iCAAiC"}
+{"version":3,"file":"icq-connection-kit.d.ts","sourceRoot":"","sources":["icq-connection-kit.js"],"names":[],"mappings":"AAoBA;;;;GAIG;AA8BI,8CAJI,IAAI,oBACJ,QAAQ;;;;QAqCX;;;;;WAKG;oBAFQ,SAAS,YAAY,CAAC,EAAE,GACtB,IAAI,SAAS,aAAa,CAAC,EAAE,CAAC;;;QAc3C,wDAAwD;yBAA5C,MAAM;;;QAMlB;;;;WAIG;2BAHQ,OAAO,UAAU,CAAC,aAClB,eAAe,cACf,gBAAgB;;;GAahC;oCArGU;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;+BAkGU,UAAU,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;4BACtD,gBAAgB,CAAC,YAAY,CAAC;0BAzHrB,mBAAmB;8BAEF,aAAa;0BADlB,iBAAiB;kCAGN,+CAA+C;8BADlE,sBAAsB;mCACH,+CAA+C;yBAFrD,aAAa;gCADlB,iBAAiB;4BACZ,aAAa;qCAGD,iCAAiC;sCAAjC,iCAAiC"}

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

@@ -34,6 +34,8 @@ export const ICQConnectionI = M.interface('ICQConnection', {
  */
 
 /**
+ * Used only by CosmosInterchainService
+ *
  * Prepares an ICQ Connection Kit based on the
  * {@link https://github.com/cosmos/ibc-apps/blob/e9b46e4bf0ad0a66cf6bc53b5e5496f6e2b4b02b/modules/async-icq/README.md | `icq/v1` IBC application protocol}.
  *
@@ -48,6 +50,7 @@ export const ICQConnectionI = M.interface('ICQConnection', {
  *
  * @param {Zone} zone
  * @param {VowTools} vowTools
+ * @internal
  */
 export const prepareICQConnectionKit = (zone, { watch, asVow }) =>
   zone.exoClassKit(

package/src/exos/local-chain-facade.d.ts

@@ -174,6 +174,9 @@ export function prepareLocalChainFacade(zone: Zone, powers: LocalChainFacadePowe
         }>;
     };
 }>>["public"];
+/**
+ * Chain facade methods unique to the Agoric (local) chain.
+ */
 export type AgoricChainMethods = {
     /**
      * Get asset info from
@@ -203,7 +206,7 @@ import type { LocalChainAccount } from '@agoric/vats/src/localchain.js';
 import type { ChainAddress } from '../types.js';
 import type { Remote } from '@agoric/internal';
 import type { MakeLocalOrchestrationAccountKit } from './local-orchestration-account.js';
-import type { CosmosInterchainService } from './cosmos-interchain-service.js';
+import type { CosmosInterchainService } from './exo-interfaces.js';
 import type { NameHub } from '@agoric/vats';
 import type { TimerService } from '@agoric/time';
 import type { LocalChain } from '@agoric/vats/src/localchain.js';

package/src/exos/local-chain-facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-chain-facade.d.ts","sourceRoot":"","sources":["local-chain-facade.js"],"names":[],"mappings":"AAuLO,8CAHI,IAAI,UACJ,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;QAlFzB,6DAA6D;uBAA/C,IAAI,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAWzD,iEAAiE;;;;;;;;;;;;;;;;;;;QAIjE,8DAA8D;;;;QAe9D;;WAEG;4BADQ,SAAS,EAAE;;;QAWtB;;WAEG;wCADQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAWrD;;;;;;WAMG;+BALQ,OAAO,WAAW,CAAC,wBACnB;YACV,OAAW,EAAE,iBAAiB,CAAC;YAC/B,OAAW,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;SAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4BX;;;;;;;;uBAhKa,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;;qCAO3B;IACZ,gCAAoC,EAAE,gCAAgC,CAAC;IACvE,aAAiB,EAAE,OAAO,uBAAuB,CAAC,CAAC;IACnD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,KAAS,EAAE,OAAO,YAAY,CAAC,CAAC;IAChC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,QAAY,EAAE,QAAQ,CAAC;CACpB;mCAoJU,UAAU,CAAC,OAAO,uBAAuB,CAAC;+BAC1C,UAAU,CAAC,oBAAoB,CAAC;0BAlLvB,mBAAmB;uCASiE,aAAa;yBAHxF,aAAa;kDAEoC,kCAAkC;+BAJvF,8BAA8B;uCADG,gCAAgC;kCAMc,aAAa;4BAP/F,kBAAkB;sDAMsC,kCAAkC;6CADzE,gCAAgC;6BAFhD,cAAc;kCAJT,cAAc;gCAEgB,gCAAgC;8BAG7D,aAAa"}
+{"version":3,"file":"local-chain-facade.d.ts","sourceRoot":"","sources":["local-chain-facade.js"],"names":[],"mappings":"AA4LO,8CAJI,IAAI,UACJ,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;QApFzB,6DAA6D;uBAA/C,IAAI,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAWzD,iEAAiE;;;;;;;;;;;;;;;;;;;QAIjE,8DAA8D;;;;QAe9D;;WAEG;4BADQ,SAAS,EAAE;;;QAWtB;;WAEG;wCADQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAWrD;;;;;;WAMG;+BALQ,OAAO,WAAW,CAAC,wBACnB;YACV,OAAW,EAAE,iBAAiB,CAAC;YAC/B,OAAW,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;SAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+BX;;;;;;;;;;;uBAnKa,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;;qCAO3B;IACZ,gCAAoC,EAAE,gCAAgC,CAAC;IACvE,aAAiB,EAAE,OAAO,uBAAuB,CAAC,CAAC;IACnD,WAAe,EAAE,OAAO,WAAW,CAAC,CAAC;IACrC,WAAe,EAAE,OAAO,OAAO,CAAC,CAAC;IACjC,KAAS,EAAE,OAAO,YAAY,CAAC,CAAC;IAChC,UAAc,EAAE,OAAO,UAAU,CAAC,CAAC;IACnC,QAAY,EAAE,QAAQ,CAAC;CACpB;mCAuJU,UAAU,CAAC,OAAO,uBAAuB,CAAC;+BAC1C,UAAU,CAAC,oBAAoB,CAAC;0BAvLvB,mBAAmB;uCASiE,aAAa;yBAHxF,aAAa;kDAEoC,kCAAkC;+BAJvF,8BAA8B;uCADG,gCAAgC;kCAMc,aAAa;4BAP/F,kBAAkB;sDAMsC,kCAAkC;6CADzE,qBAAqB;6BAFrC,cAAc;kCAJT,cAAc;gCAEgB,gCAAgC;8BAG7D,aAAa"}

package/src/exos/local-chain-facade.js

@@ -17,12 +17,14 @@ import { chainFacadeMethods, TypedJsonShape } from '../typeGuards.js';
  * @import {AssetInfo} from '@agoric/vats/src/vat-bank.js';
  * @import {NameHub} from '@agoric/vats';
  * @import {Vow, VowTools} from '@agoric/vow';
- * @import {CosmosInterchainService} from './cosmos-interchain-service.js';
+ * @import {CosmosInterchainService} from './exo-interfaces.js';
  * @import {LocalOrchestrationAccountKit, MakeLocalOrchestrationAccountKit} from './local-orchestration-account.js';
  * @import {Chain, ChainAddress, ChainInfo, CosmosChainInfo, IBCConnectionInfo, OrchestrationAccount} from '../types.js';
  */
 
 /**
+ * Chain facade methods unique to the Agoric (local) chain.
+ *
  * @typedef {object} AgoricChainMethods
  * @property {() => Promise<AssetInfo[]>} getVBankAssetInfo Get asset info from
  *   agoricNames.vbankAsset.
@@ -178,8 +180,11 @@ const prepareLocalChainFacadeKit = (
 harden(prepareLocalChainFacadeKit);
 
 /**
+ * Used only by `withOrchestration` helper
+ *
  * @param {Zone} zone
  * @param {LocalChainFacadePowers} powers
+ * @internal
  */
 export const prepareLocalChainFacade = (zone, powers) => {
   const makeLocalChainFacadeKit = prepareLocalChainFacadeKit(zone, powers);

package/src/exos/local-orchestration-account.d.ts

@@ -229,6 +229,9 @@ export function prepareLocalOrchestrationAccountKit(zone: Zone, { makeRecorderKi
 export type LocalChainAccountNotification = {
     address: string;
 };
+/**
+ * Internal to the LocalOrchestrationAccount exo
+ */
 export type State = {
     topicKit: RecorderKit<LocalChainAccountNotification>;
     packetTools: PacketTools;

package/src/exos/local-orchestration-account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-orchestration-account.d.ts","sourceRoot":"","sources":["local-orchestration-account.js"],"names":[],"mappings":"AA4FO,0DATI,IAAI,0EAEZ;IAAgC,eAAe,EAAvC,eAAe;IACH,GAAG,EAAf,GAAG;IAC0B,YAAY,EAAzC,OAAO,YAAY,CAAC;IACH,QAAQ,EAAzB,QAAQ;IACS,QAAQ,EAAzB,QAAQ;IACmB,UAAU,EAArC,OAAO,UAAU,CAAC;CAC5B;aAsEc,iBAAiB;aACjB,YAAY;iBACZ,OAAO,WAAW,CAAC;;;QAc1B;;;WAGG;6BAFQ,SAAS,GACP,IAAI;;;QAOjB;;;WAGG;mCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;QAYxB;;;WAGG;qCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;;;uBAmBJ,YAAY;oBAAU,SAAS;;;uBAa/B,YAAY;qBAAW,SAAS,EAAE;;;oBAcrC,SAAS;yBACJ,YAAY;kBACnB,qBAAqB;;;;QAcpC;;;;;;WAMG;8BALQ,CACV,SACA,UAAgB,+CAA+C,CAAC,CAC3D,CACF;;;QAcJ;;;;;;;;;;WAUG;6DATQ,CACV;YAAM,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAA;SAAE,EAC7D,MAAU,CACP,iCACO;YACV,WAAe,EAAE,YAAY,CAAC;YAC9B,IAAQ,CAAC,EAAE,qBAAqB,CAAC;YACjC,MAAU,EAAE,WAAW,CAAC;SACrB;;IAqCN;;;OAGG;;QAED;;WAEG;6BADQ,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;;;;;IAavC;;;OAGG;;QAED;;;;WAIG;+BAHQ,MAAM,CAAC,KAAK,CAAC,SACb,WAAW,CAAC,OAAO,CAAC,GAClB,WAAW;;IAM1B;;;OAGG;;QAED;;;;;WAKG;4BAJQ,WACV,UAAc,0CAA0C,CAAC,CACtD,GACS,WAAW;;IAU1B;;;OAGG;;QAED;;;;;WAKG;4BAJQ,WACV,UAAc,8CAA8C,CAAC,CAC1D,GACS,WAAW,EAAE;;;QAW1B,iEAAiE;;QAsBjE;;WAEG;;QA+BH,2DAA2D;;QAY3D;;WAEG;;QAiBH;;;WAGG;mCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;QAmBxB;;;;WAIG;qCAHQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC,GACX,IAAI,IAAI,GAAG,eAAe,CAAC;QAgBxC;;;;WAIG;QACH,mDAAmD;;QAOnD,oDAAoD;;QAIpD,qDAAqD;;;;;;;;;;QAIrD,kDAAkD;;QAIlD;;;;WAIG;;QAiBH;;;;WAIG;;QAiBH;;;;;;;;WAQG;yBAPQ,SAAS,eAET,YAAY,6CAIV,IAAI,GAAG,CAAC;QAmCrB,6DAA6D;;QAO7D,wDAAwD;;QAMxD,sDAAsD;;;;;QAItD,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;GAQnE;;aAjmBa,MAAM;;oBAIP;IACZ,QAAY,EAAE,YAAY,6BAA6B,CAAC,CAAC;IACzD,WAAe,EAAE,WAAW,CAAC;IAC7B,OAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAW,EAAE,YAAY,CAAC;CACvB;+CA0lBU,UAAU,CAAC,OAAO,mCAAmC,CAAC;2CACtD,UAAU,CAAC,gCAAgC,CAAC;0BAxnBnC,cAAc;qCADU,6CAA6C;kCAI5C,cAAc;4BAFrC,kBAAkB;8BAGX,aAAa;8BAIlB,gBAAgB;gCAXK,gCAAgC;uCAAhC,gCAAgC;kCACwC,uBAAuB;+BAAvB,uBAAuB;0BAQxH,kDAAkD;yBAFzC,aAAa;qCADG,cAAc;2CAL0D,uBAAuB;+BAO7F,sBAAsB;8BAAtB,sBAAsB;uCAPgD,uBAAuB;iCAAvB,uBAAuB;gCAO7F,sBAAsB;iCANzB,6CAA6C;iCAU9D,mBAAmB"}
+{"version":3,"file":"local-orchestration-account.d.ts","sourceRoot":"","sources":["local-orchestration-account.js"],"names":[],"mappings":"AA8FO,0DATI,IAAI,0EAEZ;IAAgC,eAAe,EAAvC,eAAe;IACH,GAAG,EAAf,GAAG;IAC0B,YAAY,EAAzC,OAAO,YAAY,CAAC;IACH,QAAQ,EAAzB,QAAQ;IACS,QAAQ,EAAzB,QAAQ;IACmB,UAAU,EAArC,OAAO,UAAU,CAAC;CAC5B;aAsEc,iBAAiB;aACjB,YAAY;iBACZ,OAAO,WAAW,CAAC;;;QAc1B;;;WAGG;6BAFQ,SAAS,GACP,IAAI;;;QAOjB;;;WAGG;mCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;QAYxB;;;WAGG;qCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;;;uBAmBJ,YAAY;oBAAU,SAAS;;;uBAa/B,YAAY;qBAAW,SAAS,EAAE;;;oBAcrC,SAAS;yBACJ,YAAY;kBACnB,qBAAqB;;;;QAcpC;;;;;;WAMG;8BALQ,CACV,SACA,UAAgB,+CAA+C,CAAC,CAC3D,CACF;;;QAcJ;;;;;;;;;;WAUG;6DATQ,CACV;YAAM,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAA;SAAE,EAC7D,MAAU,CACP,iCACO;YACV,WAAe,EAAE,YAAY,CAAC;YAC9B,IAAQ,CAAC,EAAE,qBAAqB,CAAC;YACjC,MAAU,EAAE,WAAW,CAAC;SACrB;;IAqCN;;;OAGG;;QAED;;WAEG;6BADQ,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;;;;;IAavC;;;OAGG;;QAED;;;;WAIG;+BAHQ,MAAM,CAAC,KAAK,CAAC,SACb,WAAW,CAAC,OAAO,CAAC,GAClB,WAAW;;IAM1B;;;OAGG;;QAED;;;;;WAKG;4BAJQ,WACV,UAAc,0CAA0C,CAAC,CACtD,GACS,WAAW;;IAU1B;;;OAGG;;QAED;;;;;WAKG;4BAJQ,WACV,UAAc,8CAA8C,CAAC,CAC1D,GACS,WAAW,EAAE;;;QAW1B,iEAAiE;;QAsBjE;;WAEG;;QA+BH,2DAA2D;;QAY3D;;WAEG;;QAiBH;;;WAGG;mCAFQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC;QAmBxB;;;;WAIG;qCAHQ,MAAM,cACN,MAAM,CAAC,KAAK,CAAC,GACX,IAAI,IAAI,GAAG,eAAe,CAAC;QAgBxC;;;;WAIG;QACH,mDAAmD;;QAOnD,oDAAoD;;QAIpD,qDAAqD;;;;;;;;;;QAIrD,kDAAkD;;QAIlD;;;;WAIG;;QAiBH;;;;WAIG;;QAiBH;;;;;;;;WAQG;yBAPQ,SAAS,eAET,YAAY,6CAIV,IAAI,GAAG,CAAC;QAmCrB,6DAA6D;;QAO7D,wDAAwD;;QAMxD,sDAAsD;;;;;QAItD,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;GAQnE;;aAnmBa,MAAM;;;;;oBAKP;IACZ,QAAY,EAAE,YAAY,6BAA6B,CAAC,CAAC;IACzD,WAAe,EAAE,WAAW,CAAC;IAC7B,OAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAW,EAAE,YAAY,CAAC;CACvB;+CA2lBU,UAAU,CAAC,OAAO,mCAAmC,CAAC;2CACtD,UAAU,CAAC,gCAAgC,CAAC;0BA1nBnC,cAAc;qCADU,6CAA6C;kCAI5C,cAAc;4BAFrC,kBAAkB;8BAGX,aAAa;8BAIlB,gBAAgB;gCAXK,gCAAgC;uCAAhC,gCAAgC;kCACwC,uBAAuB;+BAAvB,uBAAuB;0BAQxH,kDAAkD;yBAFzC,aAAa;qCADG,cAAc;2CAL0D,uBAAuB;+BAO7F,sBAAsB;8BAAtB,sBAAsB;uCAPgD,uBAAuB;iCAAvB,uBAAuB;gCAO7F,sBAAsB;iCANzB,6CAA6C;iCAU9D,mBAAmB"}