@agoric/orchestration 0.2.0-upgrade-18-dev-aaebae4.0 → 0.2.0-upgrade-18-dev-bd8fd54.0

package/src/fetched-chain-info.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
     namespace agoric {
+        let bech32Prefix: "agoric";
         let chainId: "agoric-3";
         let stakingTokens: readonly [{
             readonly denom: "ubld";
@@ -135,6 +136,8 @@ declare namespace _default {
         };
     }
     namespace celestia {
+        let bech32Prefix_1: "celestia";
+        export { bech32Prefix_1 as bech32Prefix };
         let chainId_1: "celestia";
         export { chainId_1 as chainId };
         let stakingTokens_1: readonly [{
@@ -238,6 +241,8 @@ declare namespace _default {
         export { connections_1 as connections };
     }
     namespace cosmoshub {
+        let bech32Prefix_2: "cosmos";
+        export { bech32Prefix_2 as bech32Prefix };
         let chainId_2: "cosmoshub-4";
         export { chainId_2 as chainId };
         let stakingTokens_2: readonly [{
@@ -247,24 +252,6 @@ declare namespace _default {
         let icqEnabled_2: false;
         export { icqEnabled_2 as icqEnabled };
         let connections_2: {
-            readonly 'stargaze-1': {
-                readonly id: "connection-918";
-                readonly client_id: "07-tendermint-1188";
-                readonly counterparty: {
-                    readonly client_id: "07-tendermint-320";
-                    readonly connection_id: "connection-256";
-                };
-                readonly state: 3;
-                readonly transferChannel: {
-                    readonly channelId: "channel-730";
-                    readonly portId: "transfer";
-                    readonly counterPartyChannelId: "channel-239";
-                    readonly counterPartyPortId: "transfer";
-                    readonly ordering: 0;
-                    readonly state: 3;
-                    readonly version: "ics20-1";
-                };
-            };
             readonly 'agoric-3': {
                 readonly id: "connection-649";
                 readonly client_id: "07-tendermint-927";
@@ -391,6 +378,24 @@ declare namespace _default {
                     readonly version: "ics20-1";
                 };
             };
+            readonly 'stargaze-1': {
+                readonly id: "connection-918";
+                readonly client_id: "07-tendermint-1188";
+                readonly counterparty: {
+                    readonly client_id: "07-tendermint-320";
+                    readonly connection_id: "connection-256";
+                };
+                readonly state: 3;
+                readonly transferChannel: {
+                    readonly channelId: "channel-730";
+                    readonly portId: "transfer";
+                    readonly counterPartyChannelId: "channel-239";
+                    readonly counterPartyPortId: "transfer";
+                    readonly ordering: 0;
+                    readonly state: 3;
+                    readonly version: "ics20-1";
+                };
+            };
             readonly 'stride-1': {
                 readonly id: "connection-635";
                 readonly client_id: "07-tendermint-913";
@@ -413,6 +418,8 @@ declare namespace _default {
         export { connections_2 as connections };
     }
     namespace dydx {
+        let bech32Prefix_3: "dydx";
+        export { bech32Prefix_3 as bech32Prefix };
         let chainId_3: "dydx-mainnet-1";
         export { chainId_3 as chainId };
         let stakingTokens_3: readonly [{
@@ -516,6 +523,8 @@ declare namespace _default {
         export { connections_3 as connections };
     }
     namespace juno {
+        let bech32Prefix_4: "juno";
+        export { bech32Prefix_4 as bech32Prefix };
         let chainId_4: "juno-1";
         export { chainId_4 as chainId };
         let stakingTokens_4: readonly [{
@@ -655,6 +664,8 @@ declare namespace _default {
         export { connections_4 as connections };
     }
     namespace neutron {
+        let bech32Prefix_5: "neutron";
+        export { bech32Prefix_5 as bech32Prefix };
         let chainId_5: "neutron-1";
         export { chainId_5 as chainId };
         let stakingTokens_5: readonly [{
@@ -830,6 +841,8 @@ declare namespace _default {
         export { connections_5 as connections };
     }
     namespace noble {
+        let bech32Prefix_6: "noble";
+        export { bech32Prefix_6 as bech32Prefix };
         let chainId_6: "noble-1";
         export { chainId_6 as chainId };
         let icqEnabled_6: false;
@@ -1019,6 +1032,8 @@ declare namespace _default {
         export { connections_6 as connections };
     }
     namespace omniflixhub {
+        let bech32Prefix_7: "omniflix";
+        export { bech32Prefix_7 as bech32Prefix };
         let chainId_7: "omniflixhub-1";
         export { chainId_7 as chainId };
         let stakingTokens_6: readonly [{
@@ -1104,6 +1119,8 @@ declare namespace _default {
         export { connections_7 as connections };
     }
     namespace osmosis {
+        let bech32Prefix_8: "osmo";
+        export { bech32Prefix_8 as bech32Prefix };
         let chainId_8: "osmosis-1";
         export { chainId_8 as chainId };
         let stakingTokens_7: readonly [{
@@ -1333,6 +1350,8 @@ declare namespace _default {
         export { connections_8 as connections };
     }
     namespace secretnetwork {
+        let bech32Prefix_9: "secret";
+        export { bech32Prefix_9 as bech32Prefix };
         let chainId_9: "secret-4";
         export { chainId_9 as chainId };
         let stakingTokens_8: readonly [{
@@ -1526,6 +1545,8 @@ declare namespace _default {
         export { connections_9 as connections };
     }
     namespace stargaze {
+        let bech32Prefix_10: "stars";
+        export { bech32Prefix_10 as bech32Prefix };
         let chainId_10: "stargaze-1";
         export { chainId_10 as chainId };
         let stakingTokens_9: readonly [{
@@ -1683,6 +1704,8 @@ declare namespace _default {
         export { connections_10 as connections };
     }
     namespace stride {
+        let bech32Prefix_11: "stride";
+        export { bech32Prefix_11 as bech32Prefix };
         let chainId_11: "stride-1";
         export { chainId_11 as chainId };
         let stakingTokens_10: readonly [{
@@ -1876,6 +1899,8 @@ declare namespace _default {
         export { connections_11 as connections };
     }
     namespace umee {
+        let bech32Prefix_12: "umee";
+        export { bech32Prefix_12 as bech32Prefix };
         let chainId_12: "umee-1";
         export { chainId_12 as chainId };
         let stakingTokens_11: readonly [{

package/src/fetched-chain-info.js

@@ -1,6 +1,7 @@
 /** @file Generated by fetch-chain-info.ts */
 export default /** @type {const} } */ ({
   agoric: {
+    bech32Prefix: 'agoric',
     chainId: 'agoric-3',
     stakingTokens: [
       {
@@ -138,6 +139,7 @@ export default /** @type {const} } */ ({
     },
   },
   celestia: {
+    bech32Prefix: 'celestia',
     chainId: 'celestia',
     stakingTokens: [
       {
@@ -239,6 +241,7 @@ export default /** @type {const} } */ ({
     },
   },
   cosmoshub: {
+    bech32Prefix: 'cosmos',
     chainId: 'cosmoshub-4',
     stakingTokens: [
       {
@@ -247,24 +250,6 @@ export default /** @type {const} } */ ({
     ],
     icqEnabled: false,
     connections: {
-      'stargaze-1': {
-        id: 'connection-918',
-        client_id: '07-tendermint-1188',
-        counterparty: {
-          client_id: '07-tendermint-320',
-          connection_id: 'connection-256',
-        },
-        state: 3,
-        transferChannel: {
-          channelId: 'channel-730',
-          portId: 'transfer',
-          counterPartyChannelId: 'channel-239',
-          counterPartyPortId: 'transfer',
-          ordering: 0,
-          state: 3,
-          version: 'ics20-1',
-        },
-      },
       'agoric-3': {
         id: 'connection-649',
         client_id: '07-tendermint-927',
@@ -391,6 +376,24 @@ export default /** @type {const} } */ ({
           version: 'ics20-1',
         },
       },
+      'stargaze-1': {
+        id: 'connection-918',
+        client_id: '07-tendermint-1188',
+        counterparty: {
+          client_id: '07-tendermint-320',
+          connection_id: 'connection-256',
+        },
+        state: 3,
+        transferChannel: {
+          channelId: 'channel-730',
+          portId: 'transfer',
+          counterPartyChannelId: 'channel-239',
+          counterPartyPortId: 'transfer',
+          ordering: 0,
+          state: 3,
+          version: 'ics20-1',
+        },
+      },
       'stride-1': {
         id: 'connection-635',
         client_id: '07-tendermint-913',
@@ -412,6 +415,7 @@ export default /** @type {const} } */ ({
     },
   },
   dydx: {
+    bech32Prefix: 'dydx',
     chainId: 'dydx-mainnet-1',
     stakingTokens: [
       {
@@ -513,6 +517,7 @@ export default /** @type {const} } */ ({
     },
   },
   juno: {
+    bech32Prefix: 'juno',
     chainId: 'juno-1',
     stakingTokens: [
       {
@@ -650,6 +655,7 @@ export default /** @type {const} } */ ({
     },
   },
   neutron: {
+    bech32Prefix: 'neutron',
     chainId: 'neutron-1',
     stakingTokens: [
       {
@@ -823,6 +829,7 @@ export default /** @type {const} } */ ({
     },
   },
   noble: {
+    bech32Prefix: 'noble',
     chainId: 'noble-1',
     icqEnabled: false,
     connections: {
@@ -1009,6 +1016,7 @@ export default /** @type {const} } */ ({
     },
   },
   omniflixhub: {
+    bech32Prefix: 'omniflix',
     chainId: 'omniflixhub-1',
     stakingTokens: [
       {
@@ -1092,6 +1100,7 @@ export default /** @type {const} } */ ({
     },
   },
   osmosis: {
+    bech32Prefix: 'osmo',
     chainId: 'osmosis-1',
     stakingTokens: [
       {
@@ -1319,6 +1328,7 @@ export default /** @type {const} } */ ({
     },
   },
   secretnetwork: {
+    bech32Prefix: 'secret',
     chainId: 'secret-4',
     stakingTokens: [
       {
@@ -1510,6 +1520,7 @@ export default /** @type {const} } */ ({
     },
   },
   stargaze: {
+    bech32Prefix: 'stars',
     chainId: 'stargaze-1',
     stakingTokens: [
       {
@@ -1665,6 +1676,7 @@ export default /** @type {const} } */ ({
     },
   },
   stride: {
+    bech32Prefix: 'stride',
     chainId: 'stride-1',
     stakingTokens: [
       {
@@ -1856,6 +1868,7 @@ export default /** @type {const} } */ ({
     },
   },
   umee: {
+    bech32Prefix: 'umee',
     chainId: 'umee-1',
     stakingTokens: [
       {

package/src/orchestration-api.d.ts

@@ -51,7 +51,7 @@ export type ChainAddress = {
  *
  * The methods available depend on the chain and its capabilities.
  */
-export type OrchestrationAccount<CI extends ChainInfo> = OrchestrationAccountI & (CI extends CosmosChainInfo ? CI['chainId'] extends `agoric${string}` ? CosmosChainAccountMethods<CI> & LocalAccountMethods : CosmosChainAccountMethods<CI> : {});
+export type OrchestrationAccount<CI extends ChainInfo> = OrchestrationAccountCommon & (CI extends CosmosChainInfo ? CI['chainId'] extends `agoric${string}` ? LocalAccountMethods : CosmosChainAccountMethods<CI> : {});
 /**
  * An object for access the core functions of a remote chain.
  *
@@ -69,6 +69,9 @@ export interface Chain<CI extends ChainInfo> {
         icqEnabled: true;
     } ? ICQQueryFunction : CI['chainId'] extends `agoric${string}` ? QueryManyFn : never;
 }
+/**
+ * Used with `orch.getDenomInfo('ibc/1234')`. See {@link Orchestrator.getDenomInfo}
+ */
 export interface DenomInfo<HoldingChain extends keyof KnownChains, IssuingChain extends keyof KnownChains> {
     /** The well-known Brand on Agoric for the direct asset */
     brand?: Brand;
@@ -95,7 +98,7 @@ export interface Orchestrator {
      * issues the corresponding asset.
      * @param denom
      */
-    getDenomInfo: <HoldingChain extends keyof KnownChains, IssuingChain extends keyof KnownChains>(denom: Denom) => DenomInfo<HoldingChain, IssuingChain>;
+    getDenomInfo: <HoldingChain extends keyof KnownChains, IssuingChain extends keyof KnownChains>(denom: Denom, srcChainName: HoldingChain) => DenomInfo<HoldingChain, IssuingChain>;
     /**
      * Convert an amount described in native data to a local, structured Amount.
      * @param amount - the described amount
@@ -106,7 +109,7 @@ export interface Orchestrator {
 /**
  * An object that supports high-level operations for an account on a remote chain.
  */
-export interface OrchestrationAccountI {
+export interface OrchestrationAccountCommon {
     /**
      * @returns the address of the account on the remote chain
      */
@@ -136,8 +139,8 @@ export interface OrchestrationAccountI {
      * @param destination - the account to transfer the amount to.
      * @param [opts] - an optional memo to include with the transfer, which could drive custom PFM behavior, and timeout parameters
      * @returns void
-     *
-     * TODO document the mapping from the address to the destination chain.
+     * @throws {Error} if route is not determinable, asset is not recognized, or
+     * the transfer is rejected (insufficient funds, timeout)
      */
     transfer: (destination: ChainAddress, amount: AmountArg, opts?: IBCMsgTransferOptions) => Promise<void>;
     /**

package/src/orchestration-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestration-api.d.ts","sourceRoot":"","sources":["orchestration-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestration-api.d.ts","sourceRoot":"","sources":["orchestration-api.ts"],"names":[],"mappings":"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"}

package/src/orchestration-api.ts

@@ -1,4 +1,3 @@
-/* eslint-disable no-use-before-define */
 /**
  * @file General API of orchestration
  * - must not have chain-specific types without runtime narrowing by chain id
@@ -7,10 +6,7 @@
 import type { Amount, Brand, NatAmount } from '@agoric/ertp/src/types.js';
 import type { CurrentWalletRecord } from '@agoric/smart-wallet/src/smartWallet.js';
 import type { Timestamp } from '@agoric/time';
-import type {
-  LocalChainAccount,
-  QueryManyFn,
-} from '@agoric/vats/src/localchain.js';
+import type { QueryManyFn } from '@agoric/vats/src/localchain.js';
 import type { ResolvedPublicTopic } from '@agoric/zoe/src/contractSupport/topics.js';
 import type { Passable } from '@endo/marshal';
 import type {
@@ -73,12 +69,13 @@ export type ChainAddress = {
  *
  * The methods available depend on the chain and its capabilities.
  */
-export type OrchestrationAccount<CI extends ChainInfo> = OrchestrationAccountI &
-  (CI extends CosmosChainInfo
-    ? CI['chainId'] extends `agoric${string}`
-      ? CosmosChainAccountMethods<CI> & LocalAccountMethods
-      : CosmosChainAccountMethods<CI>
-    : {});
+export type OrchestrationAccount<CI extends ChainInfo> =
+  OrchestrationAccountCommon &
+    (CI extends CosmosChainInfo
+      ? CI['chainId'] extends `agoric${string}`
+        ? LocalAccountMethods
+        : CosmosChainAccountMethods<CI>
+      : {});
 
 /**
  * An object for access the core functions of a remote chain.
@@ -106,6 +103,9 @@ export interface Chain<CI extends ChainInfo> {
   // TODO provide a way to get the local denom/brand/whatever for this chain
 }
 
+/**
+ * Used with `orch.getDenomInfo('ibc/1234')`. See {@link Orchestrator.getDenomInfo}
+ */
 export interface DenomInfo<
   HoldingChain extends keyof KnownChains,
   IssuingChain extends keyof KnownChains,
@@ -147,6 +147,7 @@ export interface Orchestrator {
     IssuingChain extends keyof KnownChains,
   >(
     denom: Denom,
+    srcChainName: HoldingChain,
   ) => DenomInfo<HoldingChain, IssuingChain>;
 
   /**
@@ -160,7 +161,7 @@ export interface Orchestrator {
 /**
  * An object that supports high-level operations for an account on a remote chain.
  */
-export interface OrchestrationAccountI {
+export interface OrchestrationAccountCommon {
   /**
    * @returns the address of the account on the remote chain
    */
@@ -195,8 +196,8 @@ export interface OrchestrationAccountI {
    * @param destination - the account to transfer the amount to.
    * @param [opts] - an optional memo to include with the transfer, which could drive custom PFM behavior, and timeout parameters
    * @returns void
-   *
-   * TODO document the mapping from the address to the destination chain.
+   * @throws {Error} if route is not determinable, asset is not recognized, or
+   * the transfer is rejected (insufficient funds, timeout)
    */
   transfer: (
     destination: ChainAddress,

package/src/proposals/start-auto-stake-it.d.ts

@@ -0,0 +1,52 @@
+export function startAutoStakeIt({ consume: { agoricNames, board, chainStorage, chainTimerService, cosmosInterchainService, localchain, startUpgradable, }, installation: { consume: { [contractName]: installation }, }, instance: { produce: { [contractName]: produceInstance }, }, }: BootstrapPowers, { options: { chainInfo, assetInfo } }: {
+    options: {
+        chainInfo: Record<string, CosmosChainInfo>;
+        assetInfo: [Denom, DenomDetail & {
+            brandKey?: string;
+        }][];
+    };
+}): Promise<void>;
+export function getManifest({ restoreRef }: {
+    restoreRef: any;
+}, { installKeys, options }: {
+    installKeys: any;
+    options: any;
+}): {
+    manifest: {
+        [x: string]: {
+            consume: {
+                agoricNames: boolean;
+                board: boolean;
+                chainStorage: boolean;
+                chainTimerService: boolean;
+                cosmosInterchainService: boolean;
+                localchain: boolean;
+                startUpgradable: boolean;
+            };
+            installation: {
+                consume: {
+                    autoAutoStakeIt: boolean;
+                };
+            };
+            instance: {
+                produce: {
+                    autoAutoStakeIt: boolean;
+                };
+            };
+        };
+    };
+    installations: {
+        autoAutoStakeIt: any;
+    };
+    options: any;
+};
+/**
+ * @import {AutoStakeItSF} from '@agoric/orchestration/src/examples/auto-stake-it.contract.js';
+ * @import {CosmosChainInfo, Denom, DenomDetail} from '@agoric/orchestration';
+ */
+declare const contractName: "autoAutoStakeIt";
+import type { CosmosChainInfo } from '@agoric/orchestration';
+import type { Denom } from '@agoric/orchestration';
+import type { DenomDetail } from '@agoric/orchestration';
+export {};
+//# sourceMappingURL=start-auto-stake-it.d.ts.map

package/src/proposals/start-auto-stake-it.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-auto-stake-it.d.ts","sourceRoot":"","sources":["start-auto-stake-it.js"],"names":[],"mappings":"AA4BO,0RARI,eAAe,yCACf;IACN,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC3C,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,EAAE,CAAC;KAC3D,CAAC;CACH,iBAoDH;AAGM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BN;AAhGD;;;GAGG;AAEH,4BAAqB,iBAAiB,CAAC;qCAHe,uBAAuB;2BAAvB,uBAAuB;iCAAvB,uBAAuB"}

package/src/proposals/start-auto-stake-it.js

@@ -0,0 +1,108 @@
+/**
+ * @file A proposal to start the auto-stake-it contract.
+ *
+ *   AutoStakeIt allows users to to create an auto-forwarding address that
+ *   transfers and stakes tokens on a remote chain when received.
+ */
+import { makeTracer } from '@agoric/internal';
+import { makeStorageNodeChild } from '@agoric/internal/src/lib-chainStorage.js';
+import { E } from '@endo/far';
+import { deeplyFulfilled } from '@endo/marshal';
+
+/**
+ * @import {AutoStakeItSF} from '@agoric/orchestration/src/examples/auto-stake-it.contract.js';
+ * @import {CosmosChainInfo, Denom, DenomDetail} from '@agoric/orchestration';
+ */
+
+const contractName = 'autoAutoStakeIt';
+const trace = makeTracer(contractName, true);
+
+/**
+ * @param {BootstrapPowers} powers
+ * @param {{
+ *   options: {
+ *     chainInfo: Record<string, CosmosChainInfo>;
+ *     assetInfo: [Denom, DenomDetail & { brandKey?: string }][];
+ *   };
+ * }} config
+ */
+export const startAutoStakeIt = async (
+  {
+    consume: {
+      agoricNames,
+      board,
+      chainStorage,
+      chainTimerService,
+      cosmosInterchainService,
+      localchain,
+      startUpgradable,
+    },
+    installation: {
+      // @ts-expect-error not a WellKnownName
+      consume: { [contractName]: installation },
+    },
+    instance: {
+      // @ts-expect-error not a WellKnownName
+      produce: { [contractName]: produceInstance },
+    },
+  },
+  { options: { chainInfo, assetInfo } },
+) => {
+  trace(`start ${contractName}`);
+  await null;
+
+  const storageNode = await makeStorageNodeChild(chainStorage, contractName);
+  const marshaller = await E(board).getPublishingMarshaller();
+
+  /** @type {StartUpgradableOpts<AutoStakeItSF>} */
+  const startOpts = {
+    label: 'autoAutoStakeIt',
+    installation,
+    terms: undefined,
+    privateArgs: await deeplyFulfilled(
+      // @ts-expect-error
+      harden({
+        agoricNames,
+        orchestrationService: cosmosInterchainService,
+        localchain,
+        storageNode,
+        marshaller,
+        timerService: chainTimerService,
+        chainInfo,
+        assetInfo,
+      }),
+    ),
+  };
+
+  const { instance } = await E(startUpgradable)(startOpts);
+  produceInstance.resolve(instance);
+};
+harden(startAutoStakeIt);
+
+export const getManifest = ({ restoreRef }, { installKeys, options }) => {
+  return {
+    manifest: {
+      [startAutoStakeIt.name]: {
+        consume: {
+          agoricNames: true,
+          board: true,
+          chainStorage: true,
+          chainTimerService: true,
+          cosmosInterchainService: true,
+          localchain: true,
+          startUpgradable: true,
+        },
+        installation: {
+          consume: { [contractName]: true },
+        },
+        instance: {
+          produce: { [contractName]: true },
+        },
+      },
+    },
+    installations: {
+      [contractName]: restoreRef(installKeys[contractName]),
+    },
+    options,
+  };
+};

package/src/proposals/start-basic-flows.d.ts

@@ -1,9 +1,34 @@
-export function startBasicFlows({ consume: { agoricNames, board, chainStorage, chainTimerService, cosmosInterchainService, localchain, startUpgradable, }, installation: { consume: { [contractName]: installation }, }, instance: { produce: { [contractName]: produceInstance }, }, }: BootstrapPowers): Promise<void>;
+export function startBasicFlows({ consume: { agoricNames, board, chainStorage, chainTimerService, cosmosInterchainService, localchain, startUpgradable, }, installation: { consume: { [contractName]: installation }, }, instance: { produce: { [contractName]: produceInstance }, }, issuer: { consume: { BLD, IST }, }, }: BootstrapPowers & {
+    installation: {
+        consume: {
+            basicFlows: Installation<BasicFlowsSF>;
+        };
+    };
+    instance: {
+        produce: {
+            basicFlows: Producer<Instance>;
+        };
+    };
+    issuer: {
+        consume: {
+            BLD: Issuer<"nat">;
+            IST: Issuer<"nat">;
+            USDC: Issuer<"nat">;
+        };
+    };
+}, { options: { chainInfo, assetInfo } }: {
+    options: {
+        chainInfo: Record<string, CosmosChainInfo>;
+        assetInfo: [Denom, DenomDetail & {
+            brandKey?: string;
+        }][];
+    };
+}): Promise<void>;
 export function getManifestForContract({ restoreRef }: {
     restoreRef: any;
-}, { installKeys, ...options }: {
-    [x: string]: any;
+}, { installKeys, options }: {
     installKeys: any;
+    options: any;
 }): {
     manifest: {
         [x: string]: {
@@ -26,15 +51,23 @@ export function getManifestForContract({ restoreRef }: {
                     basicFlows: boolean;
                 };
             };
+            issuer: {
+                consume: {
+                    BLD: boolean;
+                    IST: boolean;
+                };
+            };
         };
     };
     installations: {
         basicFlows: any;
     };
-    options: {
-        [x: string]: any;
-    };
+    options: any;
 };
+import type { BasicFlowsSF } from '../examples/basic-flows.contract.js';
 declare const contractName: "basicFlows";
+import type { CosmosChainInfo } from '@agoric/orchestration';
+import type { Denom } from '@agoric/orchestration';
+import type { DenomDetail } from '@agoric/orchestration';
 export {};
 //# sourceMappingURL=start-basic-flows.d.ts.map

package/src/proposals/start-basic-flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-basic-flows.d.ts","sourceRoot":"","sources":["start-basic-flows.js"],"names":[],"mappings":"AAsBO,yRAFI,eAAe,iBA4CzB;AAGM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BN;AApFD,yCAAkC"}
+{"version":3,"file":"start-basic-flows.d.ts","sourceRoot":"","sources":["start-basic-flows.js"],"names":[],"mappings":"AAgDO,6TA1BI,eAAe,GAAG;IACxB,YAAY,EAAE;QACZ,OAAO,EAAE;YACP,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;SACxC,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAChC,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE;YACP,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;SACrB,CAAC;KACH,CAAC;CACH,yCACO;IACN,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC3C,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,EAAE,CAAC;KAC3D,CAAC;CACH,iBAsDH;AAGM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCN;kCA9H8B,qCAAqC;AAIpE,4BAAqB,YAAY,CAAC;qCALoB,uBAAuB;2BAAvB,uBAAuB;iCAAvB,uBAAuB"}