@agoric/orchestration 0.1.1-dev-097ef82.0 → 0.1.1-dev-70bc20f.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/orchestration",
-  "version": "0.1.1-dev-097ef82.0+097ef82",
+  "version": "0.1.1-dev-70bc20f.0+70bc20f",
   "description": "Chain abstraction for Agoric's orchestration clients",
   "type": "module",
   "main": "index.js",
@@ -33,19 +33,19 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/async-flow": "0.1.1-dev-097ef82.0+097ef82",
-    "@agoric/cosmic-proto": "0.4.1-dev-097ef82.0+097ef82",
-    "@agoric/ertp": "0.16.3-dev-097ef82.0+097ef82",
-    "@agoric/internal": "0.3.3-dev-097ef82.0+097ef82",
-    "@agoric/network": "0.1.1-dev-097ef82.0+097ef82",
-    "@agoric/notifier": "0.6.3-dev-097ef82.0+097ef82",
-    "@agoric/store": "0.9.3-dev-097ef82.0+097ef82",
-    "@agoric/time": "0.3.3-dev-097ef82.0+097ef82",
-    "@agoric/vat-data": "0.5.3-dev-097ef82.0+097ef82",
-    "@agoric/vats": "0.15.2-dev-097ef82.0+097ef82",
-    "@agoric/vow": "0.1.1-dev-097ef82.0+097ef82",
-    "@agoric/zoe": "0.26.3-dev-097ef82.0+097ef82",
-    "@agoric/zone": "0.2.3-dev-097ef82.0+097ef82",
+    "@agoric/async-flow": "0.1.1-dev-70bc20f.0+70bc20f",
+    "@agoric/cosmic-proto": "0.4.1-dev-70bc20f.0+70bc20f",
+    "@agoric/ertp": "0.16.3-dev-70bc20f.0+70bc20f",
+    "@agoric/internal": "0.3.3-dev-70bc20f.0+70bc20f",
+    "@agoric/network": "0.1.1-dev-70bc20f.0+70bc20f",
+    "@agoric/notifier": "0.6.3-dev-70bc20f.0+70bc20f",
+    "@agoric/store": "0.9.3-dev-70bc20f.0+70bc20f",
+    "@agoric/time": "0.3.3-dev-70bc20f.0+70bc20f",
+    "@agoric/vat-data": "0.5.3-dev-70bc20f.0+70bc20f",
+    "@agoric/vats": "0.15.2-dev-70bc20f.0+70bc20f",
+    "@agoric/vow": "0.1.1-dev-70bc20f.0+70bc20f",
+    "@agoric/zoe": "0.26.3-dev-70bc20f.0+70bc20f",
+    "@agoric/zone": "0.2.3-dev-70bc20f.0+70bc20f",
     "@endo/base64": "^1.0.7",
     "@endo/errors": "^1.2.5",
     "@endo/far": "^1.1.5",
@@ -54,7 +54,7 @@
     "@noble/hashes": "^1.5.0"
   },
   "devDependencies": {
-    "@agoric/swingset-liveslots": "0.10.3-dev-097ef82.0+097ef82",
+    "@agoric/swingset-liveslots": "0.10.3-dev-70bc20f.0+70bc20f",
     "@chain-registry/client": "^1.47.4",
     "@cosmjs/amino": "^0.32.3",
     "@cosmjs/proto-signing": "^0.32.3",
@@ -94,5 +94,5 @@
   "typeCoverage": {
     "atLeast": 97.3
   },
-  "gitHead": "097ef82273611476a5171bd669ab75274e7adf3a"
+  "gitHead": "70bc20f3be992ae1f677f0770aa03a3425967f61"
 }

package/src/exos/combine-invitation-makers.d.ts

@@ -1,5 +1,6 @@
 export function prepareCombineInvitationMakers(zone: Zone, ...interfaceGuards: import("@endo/patterns").InterfaceGuard[]): <IM extends InvitationMakers[]>(...invitationMakers: IM) => IM[number];
 export type MakeCombineInvitationMakers = ReturnType<typeof prepareCombineInvitationMakers>;
+export type CombinedInvitationMakers = ReturnType<MakeCombineInvitationMakers>;
 import type { Zone } from '@agoric/zone';
 import type { InvitationMakers } from '@agoric/smart-wallet/src/types.js';
 //# sourceMappingURL=combine-invitation-makers.d.ts.map

package/src/exos/combine-invitation-makers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combine-invitation-makers.d.ts","sourceRoot":"","sources":["combine-invitation-makers.js"],"names":[],"mappings":"AAmBO,qDAHI,IAAI,sBACJ,OAAO,gBAAgB,EAAE,cAAc,EAAE,IAchB,EAAE,SAAtB,gBAAgB,EAAG,uBACtB,EAAE,KACA,EAAE,CAAC,MAAM,CAAC,CAiBxB;0CAEa,UAAU,CAAC,OAAO,8BAA8B,CAAC;0BA3CxC,cAAc;sCADF,mCAAmC"}
+{"version":3,"file":"combine-invitation-makers.d.ts","sourceRoot":"","sources":["combine-invitation-makers.js"],"names":[],"mappings":"AAwBO,qDAHI,IAAI,sBACJ,OAAO,gBAAgB,EAAE,cAAc,EAAE,IAchB,EAAE,SAAtB,gBAAgB,EAAG,uBACtB,EAAE,KACA,EAAE,CAAC,MAAM,CAAC,CAiBxB;0CAEa,UAAU,CAAC,OAAO,8BAA8B,CAAC;uCACjD,UAAU,CAAC,2BAA2B,CAAC;0BAjD9B,cAAc;sCADF,mCAAmC"}

package/src/exos/combine-invitation-makers.js

@@ -13,6 +13,11 @@ import { getMethodNames } from '@agoric/internal';
 // TODO use a helper from Endo https://github.com/endojs/endo/issues/2448
 /**
  * Takes two or more InvitationMaker exos and combines them into a new one.
+ * Combine with `publicTopics` to form a {@link ContinuingOfferResult} that can
+ * be returned to a smart-wallet client.
+ *
+ * Useful for writing your own invitationMakers while preserving
+ * platform-provided ones like `Delegate`, `Transfer`, `Send`.
  *
  * @param {Zone} zone
  * @param {import('@endo/patterns').InterfaceGuard[]} interfaceGuards
@@ -51,3 +56,4 @@ export const prepareCombineInvitationMakers = (zone, ...interfaceGuards) => {
 };
 
 /** @typedef {ReturnType<typeof prepareCombineInvitationMakers>} MakeCombineInvitationMakers */
+/** @typedef {ReturnType<MakeCombineInvitationMakers>} CombinedInvitationMakers */

package/src/exos/portfolio-holder-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio-holder-kit.d.ts","sourceRoot":"","sources":["portfolio-holder-kit.js"],"names":[],"mappings":"AAuKO,6CANI,IAAI,YACJ,QAAQ,GACN,CACZ,GAAO,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,KAC9D,UAAU,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAKzE;mCAvJY;IACR,QAAQ,EAAE,SAAS,MAAM,EAAE,cAAc,qBAAqB,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,YAAY,EAAE,SAAS,MAAM,EAAE,oBAAoB,OAAO,CAAC,CAAC,CAAC;CAC9D;kCAqJU,UAAU,CAAC,OAAO,sBAAsB,CAAC;8BACzC,UAAU,CAAC,mBAAmB,CAAC;0BA9JtB,cAAc;8BAFV,aAAa;AAqBxC;;;;;;GAMG;AACH,iDAHW,IAAI,mBACJ,QAAQ;;QAkDX;;;;;;WAMG;iBALsB,EAAE,SAAb,OAAO,EAAG,aACb,MAAM,UACN,MAAM,oCAEJ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;;;;;;;;gBAL7C;;;;;;mBAMG;yBALsB,EAAE,SAAb,OAAO,EAAG,aACb,MAAM,UACN,MAAM,oCAEJ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;;;;;;QA+B7C;;;;WAIG;8BAHQ,MAAM,WACN,cAAc,qBAAqB,GAAG,CAAC,CAAC,eACxC,oBAAoB,OAAO,CAAC;QAgBvC;;WAEG;8BADQ,MAAM;;GAQxB;0CAzI6D,uBAAuB;mCAL7C,oBAAoB;8BACjC,eAAe;yCAEJ,2CAA2C;2CAEnB,uBAAuB"}
+{"version":3,"file":"portfolio-holder-kit.d.ts","sourceRoot":"","sources":["portfolio-holder-kit.js"],"names":[],"mappings":"AAgOO,6CANI,IAAI,YACJ,QAAQ,GACN,CACZ,GAAO,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,KAC9D,UAAU,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAKzE;mCAhNY;IACR,QAAQ,EAAE,SAAS,MAAM,EAAE,cAAc,qBAAqB,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,YAAY,EAAE,SAAS,MAAM,EAAE,oBAAoB,OAAO,CAAC,CAAC,CAAC;CAC9D;kCA8MU,UAAU,CAAC,OAAO,sBAAsB,CAAC;8BACzC,UAAU,CAAC,mBAAmB,CAAC;0BAvNtB,cAAc;8BAFV,aAAa;AAqBxC;;;;;;GAMG;AACH,iDAHW,IAAI,mBACJ,QAAQ;;QAkDX;;;;;;WAMG;iBALsB,EAAE,SAAb,OAAO,EAAG,aACb,MAAM,UACN,MAAM,oCAEJ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;;;;;;;;gBAL7C;;;;;;mBAMG;yBALsB,EAAE,SAAb,OAAO,EAAG,aACb,MAAM,UACN,MAAM,oCAEJ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;;;;;;QA+B7C;;;;WAIG;8BAHQ,MAAM,WACN,cAAc,qBAAqB,GAAG,CAAC,CAAC,eACxC,oBAAoB,OAAO,CAAC;QAgBvC;;WAEG;8BADQ,MAAM;;GAQxB;0CAzI0F,uBAAuB;mCAL1E,oBAAoB;8BACjC,eAAe;yCAEJ,2CAA2C;2CAEU,uBAAuB"}

package/src/exos/portfolio-holder-kit.js

@@ -13,7 +13,7 @@ const { fromEntries } = Object;
  * @import {VowTools} from '@agoric/vow';
  * @import {ResolvedPublicTopic} from '@agoric/zoe/src/contractSupport/topics.js';
  * @import {Zone} from '@agoric/zone';
- * @import {OrchestrationAccount, OrchestrationAccountI} from '@agoric/orchestration';
+ * @import {OrchestrationAccount, OrchestrationAccountI, MakeCombineInvitationMakers} from '@agoric/orchestration';
  */
 
 /**
@@ -156,8 +156,65 @@ const preparePortfolioHolderKit = (zone, { asVow, when }) => {
  * A portfolio holder stores two or more OrchestrationAccounts and combines
  * ContinuingOfferResult's from each into a single result.
  *
- * XXX consider an interface for extending the exo maker with additional
- * invitation makers.
+ * The invitationMakers can be accessed via the `Proxy` invitationMaker, which
+ * calls out to other invitationMakers.
+ *
+ * See {@link MakeCombineInvitationMakers} for an exo that allows a developer to
+ * define extra invitationMakers to combine with platform-provided ones.
+ *
+ * @example
+ *
+ * ```js
+ * // in contract start/prepare
+ * const makePortfolioHolder = preparePortfolioHolder(
+ *   rootZone.subZone('portfolio'),
+ *   vowTools,
+ * );
+ *
+ * // in a flow
+ * const accounts = {
+ *   cosmoshub: await cosmosChain.makeAccount(),
+ *   agoric: await agoricChain.makeAccount(),
+ * };
+ * const accountEntries = harden(Object.entries(accounts));
+ * const publicTopicEntries = harden(
+ *   await Promise.all(
+ *     Object.entries(accounts).map(async ([chainName, holder]) => {
+ *       const { account } = await E(holder).getPublicTopics();
+ *       return [chainName, account];
+ *     }),
+ *   ),
+ * );
+ * const holder = makePortfolioHolder(accountEntries, publicTopicEntries);
+ *
+ * // return ContinuingOfferResult to client
+ * return E(holder).asContinuingOffer();
+ *
+ * const { invitationMakers } = await E(holder).asContinuingOffer();
+ *
+ * // with invitationArgs
+ * const delegateInv = await E(invitationMakers).Proxying(
+ *   'cosmoshub',
+ *   'Delegate',
+ *   [
+ *     {
+ *       value: 'cosmos1valoper',
+ *       chainId: 'cosmoshub-99',
+ *       encoding: 'bech32',
+ *     },
+ *     {
+ *       denom: 'uatom',
+ *       value: 10n,
+ *     },
+ *   ],
+ * );
+ *
+ * // without invitationArgs
+ * const transferInv = await E(invitationMakers).Proxying(
+ *   'cosmoshub',
+ *   'Transfer',
+ * );
+ * ```
  *
  * @param {Zone} zone
  * @param {VowTools} vowTools

package/src/types.d.ts

@@ -2,13 +2,15 @@
 export type * from './chain-info.js';
 export type * from './cosmos-api.js';
 export type * from './ethereum-api.js';
+export type * from './exos/chain-hub.js';
+export type * from './exos/combine-invitation-makers.js';
+export type * from './exos/cosmos-interchain-service.js';
+export type * from './exos/exo-interfaces.js';
 export type * from './exos/ica-account-kit.js';
-export type * from './exos/local-chain-facade.js';
 export type * from './exos/icq-connection-kit.js';
-export type * from './exos/exo-interfaces.js';
+export type * from './exos/local-chain-facade.js';
+export type * from './exos/portfolio-holder-kit.js';
 export type * from './orchestration-api.js';
-export type * from './exos/cosmos-interchain-service.js';
-export type * from './exos/chain-hub.js';
 export type * from './vat-orchestration.js';
 /**
  * ({@link ZCF})-like tools for use in {@link OrchestrationFlow}s.

package/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,qCAAqC,CAAC;AACzD,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,wBAAwB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mBAAmB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChD,eAAe,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACxC,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;CACvC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,qCAAqC,CAAC;AACzD,mBAAmB,qCAAqC,CAAC;AACzD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,gCAAgC,CAAC;AACpD,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,wBAAwB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mBAAmB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChD,eAAe,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACxC,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;CACvC"}

package/src/types.ts

@@ -3,13 +3,15 @@
 export type * from './chain-info.js';
 export type * from './cosmos-api.js';
 export type * from './ethereum-api.js';
+export type * from './exos/chain-hub.js';
+export type * from './exos/combine-invitation-makers.js';
+export type * from './exos/cosmos-interchain-service.js';
+export type * from './exos/exo-interfaces.js';
 export type * from './exos/ica-account-kit.js';
-export type * from './exos/local-chain-facade.js';
 export type * from './exos/icq-connection-kit.js';
-export type * from './exos/exo-interfaces.js';
+export type * from './exos/local-chain-facade.js';
+export type * from './exos/portfolio-holder-kit.js';
 export type * from './orchestration-api.js';
-export type * from './exos/cosmos-interchain-service.js';
-export type * from './exos/chain-hub.js';
 export type * from './vat-orchestration.js';
 
 /**