@agoric/orchestration 0.1.1-dev-bc8900d.0 → 0.1.1-dev-9ced650.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/orchestration",
-  "version": "0.1.1-dev-bc8900d.0+bc8900d",
+  "version": "0.1.1-dev-9ced650.0+9ced650",
   "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-bc8900d.0+bc8900d",
-    "@agoric/cosmic-proto": "0.4.1-dev-bc8900d.0+bc8900d",
-    "@agoric/ertp": "0.16.3-dev-bc8900d.0+bc8900d",
-    "@agoric/internal": "0.3.3-dev-bc8900d.0+bc8900d",
-    "@agoric/network": "0.1.1-dev-bc8900d.0+bc8900d",
-    "@agoric/notifier": "0.6.3-dev-bc8900d.0+bc8900d",
-    "@agoric/store": "0.9.3-dev-bc8900d.0+bc8900d",
-    "@agoric/time": "0.3.3-dev-bc8900d.0+bc8900d",
-    "@agoric/vat-data": "0.5.3-dev-bc8900d.0+bc8900d",
-    "@agoric/vats": "0.15.2-dev-bc8900d.0+bc8900d",
-    "@agoric/vow": "0.1.1-dev-bc8900d.0+bc8900d",
-    "@agoric/zoe": "0.26.3-dev-bc8900d.0+bc8900d",
-    "@agoric/zone": "0.2.3-dev-bc8900d.0+bc8900d",
+    "@agoric/async-flow": "0.1.1-dev-9ced650.0+9ced650",
+    "@agoric/cosmic-proto": "0.4.1-dev-9ced650.0+9ced650",
+    "@agoric/ertp": "0.16.3-dev-9ced650.0+9ced650",
+    "@agoric/internal": "0.3.3-dev-9ced650.0+9ced650",
+    "@agoric/network": "0.1.1-dev-9ced650.0+9ced650",
+    "@agoric/notifier": "0.6.3-dev-9ced650.0+9ced650",
+    "@agoric/store": "0.9.3-dev-9ced650.0+9ced650",
+    "@agoric/time": "0.3.3-dev-9ced650.0+9ced650",
+    "@agoric/vat-data": "0.5.3-dev-9ced650.0+9ced650",
+    "@agoric/vats": "0.15.2-dev-9ced650.0+9ced650",
+    "@agoric/vow": "0.1.1-dev-9ced650.0+9ced650",
+    "@agoric/zoe": "0.26.3-dev-9ced650.0+9ced650",
+    "@agoric/zone": "0.2.3-dev-9ced650.0+9ced650",
     "@endo/base64": "^1.0.7",
     "@endo/errors": "^1.2.5",
     "@endo/far": "^1.1.5",
@@ -54,7 +54,7 @@
     "@noble/hashes": "github:paulmillr/noble-hashes#ae060daa6252f3ff2aa2f84e887de0aab491281d"
   },
   "devDependencies": {
-    "@agoric/swingset-liveslots": "0.10.3-dev-bc8900d.0+bc8900d",
+    "@agoric/swingset-liveslots": "0.10.3-dev-9ced650.0+9ced650",
     "@chain-registry/client": "^1.47.4",
     "@cosmjs/amino": "^0.32.3",
     "@cosmjs/proto-signing": "^0.32.3",
@@ -94,5 +94,5 @@
   "typeCoverage": {
     "atLeast": 98.1
   },
-  "gitHead": "bc8900d6cd2a51265533b9731437391f9194ec05"
+  "gitHead": "9ced650db6b0983ae5d060a00b3752c3700c4f06"
 }

package/src/examples/basic-flows.contract.d.ts

@@ -15,17 +15,6 @@ export const start: (zcf: ZCF<Record<string, unknown>>, privateArgs: Orchestrati
         }>>, {
             chainNames: string[];
         }>>;
-        makeSendICQQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
-            chainName: string;
-            msgs: Parameters<import("../cosmos-api.js").ICQQueryFunction>[0];
-        }>>;
-        makeAccountAndSendBalanceQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
-            chainName: string;
-            denom: import("../orchestration-api.js").DenomArg;
-        }>>;
-        makeSendLocalQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
-            msgs: Parameters<import("@agoric/vats/src/localchain.js").QueryManyFn>[0];
-        }>>;
     }>;
 }>;
 export type BasicFlowsSF = typeof start;

package/src/examples/basic-flows.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-flows.contract.d.ts","sourceRoot":"","sources":["basic-flows.contract.js"],"names":[],"mappings":"AAoFA;gBAjEiB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEsB;2BAGnC,OAAO,KAAK;yCA3EY,0BAA0B"}
+{"version":3,"file":"basic-flows.contract.d.ts","sourceRoot":"","sources":["basic-flows.contract.js"],"names":[],"mappings":"AA8DA;gBA3CiB,UAAU;;;;;;;;;;;;;;;;;GA2CsB;2BAGnC,OAAO,KAAK;yCArDY,0BAA0B"}

package/src/examples/basic-flows.contract.js

@@ -40,10 +40,6 @@ const contract = async (
     M.interface('Basic Flows PF', {
       makeOrchAccountInvitation: M.callWhen().returns(InvitationShape),
       makePortfolioAccountInvitation: M.callWhen().returns(InvitationShape),
-      makeSendICQQueryInvitation: M.callWhen().returns(InvitationShape),
-      makeAccountAndSendBalanceQueryInvitation:
-        M.callWhen().returns(InvitationShape),
-      makeSendLocalQueryInvitation: M.callWhen().returns(InvitationShape),
     }),
     {
       makeOrchAccountInvitation() {
@@ -58,24 +54,6 @@ const contract = async (
           'Make an Orchestration Account',
         );
       },
-      makeSendICQQueryInvitation() {
-        return zcf.makeInvitation(
-          orchFns.sendICQQuery,
-          'Submit a query to a remote chain',
-        );
-      },
-      makeAccountAndSendBalanceQueryInvitation() {
-        return zcf.makeInvitation(
-          orchFns.makeAccountAndSendBalanceQuery,
-          'Make an account and submit a balance query',
-        );
-      },
-      makeSendLocalQueryInvitation() {
-        return zcf.makeInvitation(
-          orchFns.sendLocalQuery,
-          'Submit a query to the local chain',
-        );
-      },
     },
   );
 

package/src/examples/basic-flows.flows.d.ts

@@ -13,21 +13,7 @@ export function makePortfolioAccount(orch: Orchestrator, { makePortfolioHolder }
         MakeInvitation<IA extends unknown[]>(chainName: string, action: string, invitationArgs: IA): Promise<Invitation<unknown, IA>>;
     }>;
 }>>;
-export function sendICQQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { chainName, msgs }: {
-    chainName: string;
-    msgs: Parameters<ICQQueryFunction>[0];
-}): Promise<string>;
-export function makeAccountAndSendBalanceQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { chainName, denom }: {
-    chainName: string;
-    denom: DenomArg;
-}): Promise<string>;
-export function sendLocalQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { msgs }: {
-    msgs: Parameters<QueryManyFn>[0];
-}): Promise<string>;
 import type { Orchestrator } from '@agoric/orchestration';
 import type { MakePortfolioHolder } from '../exos/portfolio-holder-kit.js';
 import type { ResolvedPublicTopic } from '@agoric/zoe/src/contractSupport/topics.js';
-import type { ICQQueryFunction } from '@agoric/orchestration';
-import type { DenomArg } from '@agoric/orchestration';
-import type { QueryManyFn } from '@agoric/vats/src/localchain.js';
 //# sourceMappingURL=basic-flows.flows.d.ts.map

package/src/examples/basic-flows.flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-flows.flows.d.ts","sourceRoot":"","sources":["basic-flows.flows.js"],"names":[],"mappings":"AA+BO,sCALI,YAAY,QACZ,GAAG,QACH,OAAO,iBACP;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,0EAQ/B;AAgBM,2CANI,YAAY,2BAEpB;IAAiC,mBAAmB,EAA5C,mBAAmB;CAC3B,QAAQ,OAAO,kBACP;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;;;IAkClC;AAeM,mCALI,YAAY,QACZ,GAAG,QACH,OAAO,uBACP;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,mBActE;AAeM,qDALI,YAAY,QACZ,GAAG,QACH,OAAO,wBACP;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,mBAiBhD;AAiBM,qCAPI,YAAY,QACZ,GAAG,QACH,OAAO,YACP;IACV,IAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,mBASH;kCA3J+J,uBAAuB;yCAMjJ,iCAAiC;yCALjC,2CAA2C;sCAD+E,uBAAuB;8BAAvB,uBAAuB;iCAGzJ,gCAAgC"}
+{"version":3,"file":"basic-flows.flows.d.ts","sourceRoot":"","sources":["basic-flows.flows.js"],"names":[],"mappings":"AA0BO,sCALI,YAAY,QACZ,GAAG,QACH,OAAO,iBACP;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,0EAS/B;AAgBM,2CANI,YAAY,2BAEpB;IAAiC,mBAAmB,EAA5C,mBAAmB;CAC3B,QAAQ,OAAO,kBACP;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;;;IAmClC;kCAvEuE,uBAAuB;yCAEzD,iCAAiC;yCADjC,2CAA2C"}

package/src/examples/basic-flows.flows.js

@@ -1,22 +1,17 @@
 /**
- * @file Primarily a testing fixture, but also serves as an example of how to
- *   leverage basic functionality of the Orchestration API with async-flow.
+ * @file An example of how to leverage basic functionality of the Orchestration
+ *   API with async-flow. Each offer returning a ContinuingOfferResult, with
+ *   invitationMakers for Delegate, WithdrawRewards, Transfer, etc.
  */
 import { makeTracer } from '@agoric/internal';
-import { Fail, q } from '@endo/errors';
 import { M, mustMatch } from '@endo/patterns';
 
 const trace = makeTracer('BasicFlows');
 
 /**
- * @import {Chain, DenomArg, OrchestrationAccount, OrchestrationFlow, Orchestrator, KnownChains, OrchestrationAccountI, ICQQueryFunction, CosmosChainInfo} from '@agoric/orchestration';
+ * @import {OrchestrationAccount, OrchestrationFlow, Orchestrator} from '@agoric/orchestration';
  * @import {ResolvedPublicTopic} from '@agoric/zoe/src/contractSupport/topics.js';
- * @import {JsonSafe} from '@agoric/cosmic-proto';
- * @import {QueryManyFn} from '@agoric/vats/src/localchain.js';
- * @import {RequestQuery} from '@agoric/cosmic-proto/tendermint/abci/types.js';
- * @import {OrchestrationPowers} from '../utils/start-helper.js';
  * @import {MakePortfolioHolder} from '../exos/portfolio-holder-kit.js';
- * @import {OrchestrationTools} from '../utils/start-helper.js';
  */
 
 /**
@@ -30,6 +25,7 @@ const trace = makeTracer('BasicFlows');
  * @param {{ chainName: string }} offerArgs
  */
 export const makeOrchAccount = async (orch, _ctx, seat, { chainName }) => {
+  trace('makeOrchAccount', chainName);
   seat.exit(); // no funds exchanged
   mustMatch(chainName, M.string());
   const remoteChain = await orch.getChain(chainName);
@@ -57,6 +53,7 @@ export const makePortfolioAccount = async (
   seat,
   { chainNames },
 ) => {
+  trace('makePortfolioAccount', chainNames);
   seat.exit(); // no funds exchanged
   mustMatch(chainNames, M.arrayOf(M.string()));
   const allChains = await Promise.all(chainNames.map(n => orch.getChain(n)));
@@ -85,84 +82,3 @@ export const makePortfolioAccount = async (
   return portfolioHolder.asContinuingOffer();
 };
 harden(makePortfolioAccount);
-
-/**
- * Send a query to a remote chain and get the response back in an offer result.
- * This invitation is for testing only. In a real scenario it's better to use an
- * RPC or API client and vstorage to retrieve data for a frontend. Queries
- * should only be leveraged if contract logic requires it.
- *
- * @satisfies {OrchestrationFlow}
- * @param {Orchestrator} orch
- * @param {any} _ctx
- * @param {ZCFSeat} seat
- * @param {{ chainName: string; msgs: Parameters<ICQQueryFunction>[0] }} offerArgs
- */
-export const sendICQQuery = async (orch, _ctx, seat, { chainName, msgs }) => {
-  seat.exit(); // no funds exchanged
-  mustMatch(chainName, M.string());
-  if (chainName === 'agoric') throw Fail`ICQ not supported on local chain`;
-  const remoteChain =
-    /** @type {Chain<CosmosChainInfo & { icqEnabled: true }>} */ (
-      await orch.getChain(chainName)
-    );
-  const queryResponse = await remoteChain.query(msgs);
-  trace('SendICQQuery response:', queryResponse);
-  // `quote` to ensure offerResult (array) is visible in smart-wallet
-  return q(queryResponse).toString();
-};
-harden(sendICQQuery);
-
-/**
- * Create an account and send a query and get the response back in an offer
- * result. Like `sendQuery`, this invitation is for testing only. In a real
- * scenario it doesn't make much sense to send a query immediately after the
- * account is created - it won't have any funds.
- *
- * @satisfies {OrchestrationFlow}
- * @param {Orchestrator} orch
- * @param {any} _ctx
- * @param {ZCFSeat} seat
- * @param {{ chainName: string; denom: DenomArg }} offerArgs
- */
-export const makeAccountAndSendBalanceQuery = async (
-  orch,
-  _ctx,
-  seat,
-  { chainName, denom },
-) => {
-  seat.exit(); // no funds exchanged
-  mustMatch(chainName, M.string());
-  if (chainName === 'agoric') throw Fail`ICQ not supported on local chain`;
-  const remoteChain = await orch.getChain(chainName);
-  const orchAccount = await remoteChain.makeAccount();
-  const queryResponse = await orchAccount.getBalance(denom);
-  trace('ICQ Balance Query response:', queryResponse);
-  // `quote` to ensure offerResult (record) is visible in smart-wallet
-  return q(queryResponse).toString();
-};
-harden(makeAccountAndSendBalanceQuery);
-
-/**
- * Send a query to the local chain and get the response back in an offer result.
- * This invitation is for testing only. In a real scenario it's better to use an
- * RPC or API client and vstorage to retrieve data for a frontend. Queries
- * should only be leveraged if contract logic requires it.
- *
- * @satisfies {OrchestrationFlow}
- * @param {Orchestrator} orch
- * @param {any} _ctx
- * @param {ZCFSeat} seat
- * @param {{
- *   msgs: Parameters<QueryManyFn>[0];
- * }} offerArgs
- */
-export const sendLocalQuery = async (orch, _ctx, seat, { msgs }) => {
-  seat.exit(); // no funds exchanged
-  const remoteChain = await orch.getChain('agoric');
-  const queryResponse = await remoteChain.query(msgs);
-  trace('Local Query response:', queryResponse);
-  // `quote` to ensure offerResult (array) is visible in smart-wallet
-  return q(queryResponse).toString();
-};
-harden(sendLocalQuery);

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

@@ -28,10 +28,10 @@ export function start(zcf: ZCF<StakeIcaTerms>, privateArgs: {
             getPublicTopics(): import("@agoric/vow").Vow<Record<string, import("@agoric/zoe/src/contractSupport").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport").ResolvedPublicTopic<unknown>>>>;
             getAddress(): import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").ChainAddress>;
             delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-            getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             getBalance(denom: import("../orchestration-api.js").DenomArg): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+            getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             send(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             sendAll(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             transfer(amount: import("../orchestration-api.js").AmountArg, destination: import("../orchestration-api.js").ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;

package/src/exos/README.md

@@ -1,6 +1,6 @@
 # Exo structure
 
-Last verified 2024-07-31
+Last verified 2024-08-30
 
 ```mermaid
 classDiagram
@@ -117,6 +117,7 @@ classDiagram
       executeEncodedTx()
       getAddress()
       getBalance()
+      getBalances()
       getPublicTopics()
       redelegate()
       send()

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

@@ -72,6 +72,12 @@ export function prepareCosmosOrchestrationAccountKit(zone: Zone, { chainHub, mak
          */
         onFulfilled([result]: JsonSafe<ResponseQuery>[]): DenomAmount;
     };
+    allBalancesQueryWatcher: {
+        /**
+         * @param {JsonSafe<ResponseQuery>[]} results
+         */
+        onFulfilled([result]: JsonSafe<ResponseQuery>[]): DenomAmount[];
+    };
     undelegateWatcher: {
         /**
          * @param {string} result
@@ -157,14 +163,14 @@ export function prepareCosmosOrchestrationAccountKit(zone: Zone, { chainHub, mak
         getAddress(): import("@agoric/async-flow").HostInterface<ChainAddress>;
         /** @type {HostOf<StakingAccountActions['delegate']>} */
         delegate(validator: CosmosValidatorAddress, amount: AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-        /** @type {HostOf<OrchestrationAccountI['getBalances']>} */
-        getBalances(): Vow<DenomAmount[] extends import("@endo/pass-style").Passable ? DenomAmount[] : import("@agoric/async-flow").HostInterface<DenomAmount[]>>;
         /** @type {HostOf<StakingAccountActions['redelegate']>} */
         redelegate(srcValidator: CosmosValidatorAddress, dstValidator: CosmosValidatorAddress, amount: AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
         /** @type {HostOf<StakingAccountActions['withdrawReward']>} */
         withdrawReward(validator: CosmosValidatorAddress): Vow<DenomAmount[] extends import("@endo/pass-style").Passable ? DenomAmount[] : import("@agoric/async-flow").HostInterface<DenomAmount[]>>;
         /** @type {HostOf<OrchestrationAccountI['getBalance']>} */
         getBalance(denom: import("../orchestration-api.js").DenomArg): Vow<DenomAmount extends import("@endo/pass-style").Passable ? DenomAmount : import("@agoric/async-flow").HostInterface<DenomAmount>>;
+        /** @type {HostOf<OrchestrationAccountI['getBalances']>} */
+        getBalances(): Vow<DenomAmount[] extends import("@endo/pass-style").Passable ? DenomAmount[] : import("@agoric/async-flow").HostInterface<DenomAmount[]>>;
         /** @type {HostOf<OrchestrationAccountI['send']>} */
         send(toAccount: ChainAddress, amounts: AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
         /** @type {HostOf<OrchestrationAccountI['sendAll']>} */

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":"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"}
+{"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

@@ -3,6 +3,8 @@ import { toRequestQueryJson } from '@agoric/cosmic-proto';
 import {
   QueryBalanceRequest,
   QueryBalanceResponse,
+  QueryAllBalancesRequest,
+  QueryAllBalancesResponse,
 } from '@agoric/cosmic-proto/cosmos/bank/v1beta1/query.js';
 import { MsgSend } from '@agoric/cosmic-proto/cosmos/bank/v1beta1/tx.js';
 import {
@@ -22,7 +24,7 @@ import { Shape as NetworkShape } from '@agoric/network';
 import { M } from '@agoric/vat-data';
 import { VowShape } from '@agoric/vow';
 import { decodeBase64 } from '@endo/base64';
-import { Fail } from '@endo/errors';
+import { Fail, makeError, q } from '@endo/errors';
 import { E } from '@endo/far';
 import {
   AmountArgShape,
@@ -146,6 +148,11 @@ export const prepareCosmosOrchestrationAccountKit = (
           .optional(M.arrayOf(M.undefined())) // empty context
           .returns(M.or(M.record(), M.undefined())),
       }),
+      allBalancesQueryWatcher: M.interface('allBalancesQueryWatcher', {
+        onFulfilled: M.call(M.arrayOf(M.record())).returns(
+          M.arrayOf(M.record()),
+        ),
+      }),
       undelegateWatcher: M.interface('undelegateWatcher', {
         onFulfilled: M.call(M.string())
           .optional(M.arrayOf(M.undefined())) // empty context
@@ -259,6 +266,29 @@ export const prepareCosmosOrchestrationAccountKit = (
           return harden(toDenomAmount(balance));
         },
       },
+      allBalancesQueryWatcher: {
+        /**
+         * @param {JsonSafe<ResponseQuery>[]} results
+         */
+        onFulfilled([result]) {
+          let response;
+          try {
+            response = QueryAllBalancesResponse.decode(
+              // note: an empty string for result.key is a valid result
+              decodeBase64(result.key),
+            );
+          } catch (cause) {
+            throw makeError(
+              `Error parsing QueryAllBalances result ${q(result)}`,
+              undefined,
+              { cause },
+            );
+          }
+          const { balances } = response;
+          if (!balances) throw Fail`Result lacked balances key: ${q(result)}`;
+          return harden(balances.map(coin => toDenomAmount(coin)));
+        },
+      },
       undelegateWatcher: {
         /**
          * @param {string} result
@@ -514,11 +544,7 @@ export const prepareCosmosOrchestrationAccountKit = (
             return watch(results, this.facets.returnVoidWatcher);
           });
         },
-        /** @type {HostOf<OrchestrationAccountI['getBalances']>} */
-        getBalances() {
-          // TODO https://github.com/Agoric/agoric-sdk/issues/9610
-          return asVow(() => Fail`not yet implemented`);
-        },
+
         /** @type {HostOf<StakingAccountActions['redelegate']>} */
         redelegate(srcValidator, dstValidator, amount) {
           return asVow(() => {
@@ -565,7 +591,7 @@ export const prepareCosmosOrchestrationAccountKit = (
           return asVow(() => {
             const { chainAddress, icqConnection } = this.state;
             if (!icqConnection) {
-              throw Fail`Queries not available for chain ${chainAddress.chainId}`;
+              throw Fail`Queries not available for chain ${q(chainAddress.chainId)}`;
             }
             const results = E(icqConnection).query([
               toRequestQueryJson(
@@ -579,6 +605,24 @@ export const prepareCosmosOrchestrationAccountKit = (
           });
         },
 
+        /** @type {HostOf<OrchestrationAccountI['getBalances']>} */
+        getBalances() {
+          return asVow(() => {
+            const { chainAddress, icqConnection } = this.state;
+            if (!icqConnection) {
+              throw Fail`Queries not available for chain ${q(chainAddress.chainId)}`;
+            }
+            const results = E(icqConnection).query([
+              toRequestQueryJson(
+                QueryAllBalancesRequest.toProtoMsg({
+                  address: chainAddress.value,
+                }),
+              ),
+            ]);
+            return watch(results, this.facets.allBalancesQueryWatcher);
+          });
+        },
+
         /** @type {HostOf<OrchestrationAccountI['send']>} */
         send(toAccount, amount) {
           return asVow(() => {

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

@@ -34,10 +34,10 @@ export function prepareRemoteChainFacade(zone: Zone, powers: RemoteChainFacadePo
             getPublicTopics(): Vow<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>>>>;
             getAddress(): import("@agoric/async-flow").HostInterface<ChainAddress>;
             delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             getBalance(denom: import("../orchestration-api.js").DenomArg): Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             send(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             sendAll(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             transfer(amount: import("../orchestration-api.js").AmountArg, destination: ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
@@ -66,10 +66,10 @@ export function prepareRemoteChainFacade(zone: Zone, powers: RemoteChainFacadePo
             getPublicTopics(): Vow<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>>>>;
             getAddress(): import("@agoric/async-flow").HostInterface<ChainAddress>;
             delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             getBalance(denom: import("../orchestration-api.js").DenomArg): Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             send(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             sendAll(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             transfer(amount: import("../orchestration-api.js").AmountArg, destination: ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
@@ -100,10 +100,10 @@ export function prepareRemoteChainFacade(zone: Zone, powers: RemoteChainFacadePo
             getPublicTopics(): Vow<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>>>>;
             getAddress(): import("@agoric/async-flow").HostInterface<ChainAddress>;
             delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             getBalance(denom: import("../orchestration-api.js").DenomArg): Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+            getBalances(): Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
             send(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             sendAll(toAccount: ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
             transfer(amount: import("../orchestration-api.js").AmountArg, destination: ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;

package/src/fixtures/README.md

@@ -0,0 +1,3 @@
+# Fixtures
+
+This directory contains contracts used for testing. They are NOT representative of patterns we'd like to use in production, and only exist to facilitate testing.

package/src/fixtures/query-flows.contract.d.ts

@@ -0,0 +1,24 @@
+export const start: (zcf: ZCF<Record<string, unknown>>, privateArgs: OrchestrationPowers & {
+    marshaller: Marshaller;
+}, baggage: import("@agoric/vat-data").Baggage) => Promise<{
+    publicFacet: import("@endo/exo").Guarded<{
+        makeSendICQQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
+            chainName: string;
+            msgs: Parameters<import("../cosmos-api.js").ICQQueryFunction>[0];
+        }>>;
+        makeAccountAndGetBalanceQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
+            chainName: string;
+            denom: import("../orchestration-api.js").DenomArg;
+        }>>;
+        makeAccountAndGetBalancesQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
+            chainName: string;
+            denom: import("../orchestration-api.js").DenomArg;
+        }>>;
+        makeSendLocalQueryInvitation(): Promise<Invitation<import("@agoric/vow").Vow<string>, {
+            msgs: Parameters<import("@agoric/vats/src/localchain.js").QueryManyFn>[0];
+        }>>;
+    }>;
+}>;
+export type QueryFlowsSF = typeof start;
+import type { OrchestrationPowers } from '..//utils/start-helper.js';
+//# sourceMappingURL=query-flows.contract.d.ts.map

package/src/fixtures/query-flows.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-flows.contract.d.ts","sourceRoot":"","sources":["query-flows.contract.js"],"names":[],"mappings":"AAkEA;gBAjDiB,UAAU;;;;;;;;;;;;;;;;;;;GAiDsB;2BAGnC,OAAO,KAAK;yCA3DY,2BAA2B"}

package/src/fixtures/query-flows.contract.js

@@ -0,0 +1,70 @@
+/**
+ * @file Testing fixture for Local and Interchain Queries
+ */
+import { InvitationShape } from '@agoric/zoe/src/typeGuards.js';
+import { M } from '@endo/patterns';
+import { withOrchestration } from '../utils/start-helper.js';
+import * as flows from './query-flows.flows.js';
+
+/**
+ * @import {Zone} from '@agoric/zone';
+ * @import {OrchestrationPowers} from '..//utils/start-helper.js';
+ * @import {OrchestrationTools} from '../utils/start-helper.js';
+ */
+
+/**
+ * @param {ZCF} zcf
+ * @param {OrchestrationPowers & {
+ *   marshaller: Marshaller;
+ * }} _privateArgs
+ * @param {Zone} zone
+ * @param {OrchestrationTools} tools
+ */
+const contract = async (zcf, _privateArgs, zone, { orchestrateAll }) => {
+  const orchFns = orchestrateAll(flows, {});
+
+  const publicFacet = zone.exo(
+    'Query Flows Public Facet',
+    M.interface('Query Flows PF', {
+      makeSendICQQueryInvitation: M.callWhen().returns(InvitationShape),
+      makeAccountAndGetBalanceQueryInvitation:
+        M.callWhen().returns(InvitationShape),
+      makeAccountAndGetBalancesQueryInvitation:
+        M.callWhen().returns(InvitationShape),
+      makeSendLocalQueryInvitation: M.callWhen().returns(InvitationShape),
+    }),
+    {
+      makeSendICQQueryInvitation() {
+        return zcf.makeInvitation(
+          orchFns.sendICQQuery,
+          'Submit a query to a remote chain',
+        );
+      },
+      makeAccountAndGetBalanceQueryInvitation() {
+        return zcf.makeInvitation(
+          orchFns.makeAccountAndGetBalanceQuery,
+          'Make an account and submit a balance query',
+        );
+      },
+      makeAccountAndGetBalancesQueryInvitation() {
+        return zcf.makeInvitation(
+          orchFns.makeAccountAndGetBalancesQuery,
+          'Make an account and submit a balance query',
+        );
+      },
+      makeSendLocalQueryInvitation() {
+        return zcf.makeInvitation(
+          orchFns.sendLocalQuery,
+          'Submit a query to the local chain',
+        );
+      },
+    },
+  );
+
+  return { publicFacet };
+};
+
+export const start = withOrchestration(contract);
+harden(start);
+
+/** @typedef {typeof start} QueryFlowsSF */

package/src/fixtures/query-flows.flows.d.ts

@@ -0,0 +1,20 @@
+export function sendICQQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { chainName, msgs }: {
+    chainName: string;
+    msgs: Parameters<ICQQueryFunction>[0];
+}): Promise<string>;
+export function makeAccountAndGetBalanceQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { chainName, denom }: {
+    chainName: string;
+    denom: DenomArg;
+}): Promise<string>;
+export function makeAccountAndGetBalancesQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { chainName }: {
+    chainName: string;
+    denom: DenomArg;
+}): Promise<string>;
+export function sendLocalQuery(orch: Orchestrator, _ctx: any, seat: ZCFSeat, { msgs }: {
+    msgs: Parameters<QueryManyFn>[0];
+}): Promise<string>;
+import type { Orchestrator } from '@agoric/orchestration';
+import type { ICQQueryFunction } from '@agoric/orchestration';
+import type { DenomArg } from '@agoric/orchestration';
+import type { QueryManyFn } from '@agoric/vats/src/localchain.js';
+//# sourceMappingURL=query-flows.flows.d.ts.map

package/src/fixtures/query-flows.flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-flows.flows.d.ts","sourceRoot":"","sources":["query-flows.flows.js"],"names":[],"mappings":"AA0BO,mCALI,YAAY,QACZ,GAAG,QACH,OAAO,uBACP;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,mBActE;AAeM,oDALI,YAAY,QACZ,GAAG,QACH,OAAO,wBACP;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,mBAiBhD;AAeM,qDALI,YAAY,QACZ,GAAG,QACH,OAAO,iBACP;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,mBAiBhD;AAiBM,qCAPI,YAAY,QACZ,GAAG,QACH,OAAO,YACP;IACV,IAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,mBASH;kCAhHqG,uBAAuB;sCAAvB,uBAAuB;8BAAvB,uBAAuB;iCAC/F,gCAAgC"}

package/src/fixtures/query-flows.flows.js

@@ -0,0 +1,124 @@
+/**
+ * @file Testing fixture for Local and Interchain Queries
+ */
+import { makeTracer } from '@agoric/internal';
+import { Fail, q } from '@endo/errors';
+import { M, mustMatch } from '@endo/patterns';
+
+const trace = makeTracer('BasicFlows');
+
+/**
+ * @import {Chain, DenomArg, OrchestrationFlow, Orchestrator, ICQQueryFunction, CosmosChainInfo} from '@agoric/orchestration';
+ * @import {QueryManyFn} from '@agoric/vats/src/localchain.js';
+ */
+
+/**
+ * Send a query to a remote chain and get the response back in an offer result.
+ * This invitation is for testing only. In a real scenario it's better to use an
+ * RPC or API client and vstorage to retrieve data for a frontend. Queries
+ * should only be leveraged if contract logic requires it.
+ *
+ * @satisfies {OrchestrationFlow}
+ * @param {Orchestrator} orch
+ * @param {any} _ctx
+ * @param {ZCFSeat} seat
+ * @param {{ chainName: string; msgs: Parameters<ICQQueryFunction>[0] }} offerArgs
+ */
+export const sendICQQuery = async (orch, _ctx, seat, { chainName, msgs }) => {
+  seat.exit(); // no funds exchanged
+  mustMatch(chainName, M.string());
+  if (chainName === 'agoric') throw Fail`ICQ not supported on local chain`;
+  const remoteChain =
+    /** @type {Chain<CosmosChainInfo & { icqEnabled: true }>} */ (
+      await orch.getChain(chainName)
+    );
+  const queryResponse = await remoteChain.query(msgs);
+  trace('SendICQQuery response:', queryResponse);
+  // `quote` to ensure offerResult (array) is visible in smart-wallet
+  return q(queryResponse).toString();
+};
+harden(sendICQQuery);
+
+/**
+ * Create an account, send a balance query, and get the response back in an
+ * offer result. Like `sendQuery`, this invitation is for testing only. In a
+ * real scenario it doesn't make much sense to send a query immediately after
+ * the account is created - it won't have any funds.
+ *
+ * @satisfies {OrchestrationFlow}
+ * @param {Orchestrator} orch
+ * @param {any} _ctx
+ * @param {ZCFSeat} seat
+ * @param {{ chainName: string; denom: DenomArg }} offerArgs
+ */
+export const makeAccountAndGetBalanceQuery = async (
+  orch,
+  _ctx,
+  seat,
+  { chainName, denom },
+) => {
+  seat.exit(); // no funds exchanged
+  mustMatch(chainName, M.string());
+  if (chainName === 'agoric') throw Fail`ICQ not supported on local chain`;
+  const remoteChain = await orch.getChain(chainName);
+  const orchAccount = await remoteChain.makeAccount();
+  const queryResponse = await orchAccount.getBalance(denom);
+  trace('ICQ Balance Query response:', queryResponse);
+  // `quote` to ensure offerResult (record) is visible in smart-wallet
+  return q(queryResponse).toString();
+};
+harden(makeAccountAndGetBalanceQuery);
+
+/**
+ * Create an account, send an all balances query, and get the response back in
+ * an offer result. Like `sendQuery`, this invitation is for testing only. In a
+ * real scenario it doesn't make much sense to send a query immediately after
+ * the account is created - it won't have any funds.
+ *
+ * @satisfies {OrchestrationFlow}
+ * @param {Orchestrator} orch
+ * @param {any} _ctx
+ * @param {ZCFSeat} seat
+ * @param {{ chainName: string; denom: DenomArg }} offerArgs
+ */
+export const makeAccountAndGetBalancesQuery = async (
+  orch,
+  _ctx,
+  seat,
+  { chainName },
+) => {
+  seat.exit(); // no funds exchanged
+  mustMatch(chainName, M.string());
+  if (chainName === 'agoric') throw Fail`ICQ not supported on local chain`;
+  const remoteChain = await orch.getChain(chainName);
+  const orchAccount = await remoteChain.makeAccount();
+  const queryResponse = await orchAccount.getBalances();
+  trace('ICQ All Balances Query response:', queryResponse);
+  // `quote` to ensure offerResult (record) is visible in smart-wallet
+  return q(queryResponse).toString();
+};
+harden(makeAccountAndGetBalancesQuery);
+
+/**
+ * Send a query to the local chain and get the response back in an offer result.
+ * This invitation is for testing only. In a real scenario it's better to use an
+ * RPC or API client and vstorage to retrieve data for a frontend. Queries
+ * should only be leveraged if contract logic requires it.
+ *
+ * @satisfies {OrchestrationFlow}
+ * @param {Orchestrator} orch
+ * @param {any} _ctx
+ * @param {ZCFSeat} seat
+ * @param {{
+ *   msgs: Parameters<QueryManyFn>[0];
+ * }} offerArgs
+ */
+export const sendLocalQuery = async (orch, _ctx, seat, { msgs }) => {
+  seat.exit(); // no funds exchanged
+  const remoteChain = await orch.getChain('agoric');
+  const queryResponse = await remoteChain.query(msgs);
+  trace('Local Query response:', queryResponse);
+  // `quote` to ensure offerResult (array) is visible in smart-wallet
+  return q(queryResponse).toString();
+};
+harden(sendLocalQuery);

package/src/proposals/start-stakeAtom.d.ts

@@ -14,10 +14,10 @@ export function startStakeAtom({ consume: { agoricNames, board, chainStorage, ch
                         getPublicTopics(): import("@agoric/vow").Vow<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>>>>;
                         getAddress(): import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").ChainAddress>;
                         delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-                        getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         getBalance(denom: import("../orchestration-api.js").DenomArg): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+                        getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         send(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         sendAll(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         transfer(amount: import("../orchestration-api.js").AmountArg, destination: import("../orchestration-api.js").ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;

package/src/proposals/start-stakeOsmo.d.ts

@@ -14,10 +14,10 @@ export function startStakeOsmo({ consume: { agoricNames, board, chainStorage, ch
                         getPublicTopics(): import("@agoric/vow").Vow<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> extends import("@endo/pass-style").Passable ? import("@endo/pass-style").Passable & Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>> : import("@agoric/async-flow").HostInterface<Record<string, import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>>>>;
                         getAddress(): import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").ChainAddress>;
                         delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
-                        getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         getBalance(denom: import("../orchestration-api.js").DenomArg): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount>>;
+                        getBalances(): import("@agoric/vow").Vow<import("../orchestration-api.js").DenomAmount[] extends import("@endo/pass-style").Passable ? import("../orchestration-api.js").DenomAmount[] : import("@agoric/async-flow").HostInterface<import("../orchestration-api.js").DenomAmount[]>>;
                         send(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         sendAll(toAccount: import("../orchestration-api.js").ChainAddress, amounts: import("../orchestration-api.js").AmountArg[]): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;
                         transfer(amount: import("../orchestration-api.js").AmountArg, destination: import("../orchestration-api.js").ChainAddress, opts?: import("../cosmos-api.js").IBCMsgTransferOptions | undefined): import("@agoric/vow").Vow<void extends import("@endo/pass-style").Passable ? void : import("@agoric/async-flow").HostInterface<void>>;