@agoric/orchestration 0.1.1-dev-9553675.0 → 0.1.1-dev-2dc53d7.0

package/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./src/types.js";
+export * from "./src/service.js";
+export * from "./src/typeGuards.js";
+//# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,4 +1,3 @@
-// eslint-disable-next-line import/export
 export * from './src/types.js';
 export * from './src/service.js';
 export * from './src/typeGuards.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/orchestration",
-  "version": "0.1.1-dev-9553675.0+9553675",
+  "version": "0.1.1-dev-2dc53d7.0+2dc53d7",
   "description": "Chain abstraction for Agoric's orchestration clients",
   "type": "module",
   "main": "index.js",
@@ -10,6 +10,8 @@
   },
   "scripts": {
     "build": "exit 0",
+    "prepack": "tsc --build tsconfig.build.json",
+    "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:xs": "exit 0",
     "lint": "run-s --continue-on-error lint:*",
@@ -29,19 +31,19 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-dev-9553675.0+9553675",
-    "@agoric/cosmic-proto": "0.4.1-dev-9553675.0+9553675",
-    "@agoric/ertp": "0.16.3-dev-9553675.0+9553675",
-    "@agoric/internal": "0.3.3-dev-9553675.0+9553675",
-    "@agoric/network": "0.1.1-dev-9553675.0+9553675",
-    "@agoric/notifier": "0.6.3-dev-9553675.0+9553675",
-    "@agoric/store": "0.9.3-dev-9553675.0+9553675",
-    "@agoric/time": "0.3.3-dev-9553675.0+9553675",
-    "@agoric/vat-data": "0.5.3-dev-9553675.0+9553675",
-    "@agoric/vats": "0.15.2-dev-9553675.0+9553675",
-    "@agoric/vow": "0.1.1-dev-9553675.0+9553675",
-    "@agoric/zoe": "0.26.3-dev-9553675.0+9553675",
-    "@agoric/zone": "0.2.3-dev-9553675.0+9553675",
+    "@agoric/assert": "0.6.1-dev-2dc53d7.0+2dc53d7",
+    "@agoric/cosmic-proto": "0.4.1-dev-2dc53d7.0+2dc53d7",
+    "@agoric/ertp": "0.16.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/internal": "0.3.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/network": "0.1.1-dev-2dc53d7.0+2dc53d7",
+    "@agoric/notifier": "0.6.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/store": "0.9.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/time": "0.3.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/vat-data": "0.5.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/vats": "0.15.2-dev-2dc53d7.0+2dc53d7",
+    "@agoric/vow": "0.1.1-dev-2dc53d7.0+2dc53d7",
+    "@agoric/zoe": "0.26.3-dev-2dc53d7.0+2dc53d7",
+    "@agoric/zone": "0.2.3-dev-2dc53d7.0+2dc53d7",
     "@endo/base64": "^1.0.5",
     "@endo/far": "^1.1.2",
     "@endo/marshal": "^1.5.0",
@@ -83,5 +85,5 @@
   "typeCoverage": {
     "atLeast": 96.18
   },
-  "gitHead": "9553675cd136d389c427e024fc4da78558344779"
+  "gitHead": "2dc53d7552650c5d46319d0cd5341eeec275663a"
 }

package/src/chain-info.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file static declaration of known chain types will allow type support for
+ * additional chain-specific operations like `liquidStake`
+ */
+import type { CosmosChainInfo, EthChainInfo, IcaAccount, ICQConnection, LiquidStakingMethods, StakingAccountActions, StakingAccountQueries } from './types.js';
+export type KnownChains = {
+    stride: {
+        info: CosmosChainInfo;
+        methods: IcaAccount & ICQConnection & StakingAccountActions & StakingAccountQueries & LiquidStakingMethods;
+    };
+    cosmos: {
+        info: CosmosChainInfo;
+        methods: IcaAccount & ICQConnection & StakingAccountActions & StakingAccountQueries;
+    };
+    agoric: {
+        info: CosmosChainInfo;
+        methods: {
+            /**
+             * Register a hook to intercept an incoming IBC Transfer and handle it.
+             * Calling without arguments will unregister the hook.
+             */
+            interceptTransfer: (tap?: {
+                upcall: (args: any) => Promise<any>;
+            }) => Promise<void>;
+        };
+    };
+    celestia: {
+        info: CosmosChainInfo;
+        methods: IcaAccount & ICQConnection & StakingAccountActions & StakingAccountQueries;
+    };
+    osmosis: {
+        info: CosmosChainInfo;
+        methods: IcaAccount & ICQConnection & StakingAccountActions & StakingAccountQueries;
+    };
+};
+export type ChainInfo = CosmosChainInfo | EthChainInfo;
+//# sourceMappingURL=chain-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain-info.d.ts","sourceRoot":"","sources":["chain-info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAKpB,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,UAAU,GACjB,aAAa,GACb,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,UAAU,GACjB,aAAa,GACb,qBAAqB,GACrB,qBAAqB,CAAC;KACzB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE;YAEP;;;eAGG;YACH,iBAAiB,EAAE,CAAC,GAAG,CAAC,EAAE;gBACxB,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;aACrC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,UAAU,GACjB,aAAa,GACb,qBAAqB,GACrB,qBAAqB,CAAC;KACzB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,UAAU,GACjB,aAAa,GACb,qBAAqB,GACrB,qBAAqB,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,YAAY,CAAC"}

package/src/chain-info.ts

@@ -0,0 +1,64 @@
+/**
+ * @file static declaration of known chain types will allow type support for
+ * additional chain-specific operations like `liquidStake`
+ */
+
+import type {
+  CosmosChainInfo,
+  EthChainInfo,
+  IcaAccount,
+  ICQConnection,
+  LiquidStakingMethods,
+  StakingAccountActions,
+  StakingAccountQueries,
+} from './types.js';
+
+// TODO generate this automatically with a build script drawing on data sources such as https://github.com/cosmos/chain-registry
+
+// XXX methods ad-hoc and not fully accurate
+export type KnownChains = {
+  stride: {
+    info: CosmosChainInfo;
+    methods: IcaAccount &
+      ICQConnection &
+      StakingAccountActions &
+      StakingAccountQueries &
+      LiquidStakingMethods;
+  };
+  cosmos: {
+    info: CosmosChainInfo;
+    methods: IcaAccount &
+      ICQConnection &
+      StakingAccountActions &
+      StakingAccountQueries;
+  };
+  agoric: {
+    info: CosmosChainInfo;
+    methods: {
+      // TODO reference type from #8624 `packages/vats/src/localchain.js`
+      /**
+       * Register a hook to intercept an incoming IBC Transfer and handle it.
+       * Calling without arguments will unregister the hook.
+       */
+      interceptTransfer: (tap?: {
+        upcall: (args: any) => Promise<any>;
+      }) => Promise<void>;
+    };
+  };
+  celestia: {
+    info: CosmosChainInfo;
+    methods: IcaAccount &
+      ICQConnection &
+      StakingAccountActions &
+      StakingAccountQueries;
+  };
+  osmosis: {
+    info: CosmosChainInfo;
+    methods: IcaAccount &
+      ICQConnection &
+      StakingAccountActions &
+      StakingAccountQueries;
+  };
+};
+
+export type ChainInfo = CosmosChainInfo | EthChainInfo;

package/src/cosmos-api.d.ts

@@ -0,0 +1,159 @@
+import type { AnyJson } from '@agoric/cosmic-proto';
+import type { Delegation, Redelegation, UnbondingDelegation } from '@agoric/cosmic-proto/cosmos/staking/v1beta1/staking.js';
+import type { TxBody } from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
+import type { Brand, Payment, Purse } from '@agoric/ertp/exported.js';
+import type { Port } from '@agoric/network';
+import type { LocalIbcAddress, RemoteIbcAddress } from '@agoric/vats/tools/ibc-utils.js';
+import type { AmountArg, ChainAddress, DenomAmount } from './types.js';
+/** A helper type for type extensions. */
+export type TypeUrl = string;
+export type Proto3JSONMsg = {
+    '@type': TypeUrl;
+    value: Record<string, unknown>;
+};
+/** An address for a validator on some blockchain, e.g., cosmos, eth, etc. */
+export type CosmosValidatorAddress = ChainAddress & {
+    address: `${string}valoper${string}`;
+    addressEncoding: 'bech32';
+};
+/**
+ * Info for a Cosmos-based chain.
+ */
+export type CosmosChainInfo = {
+    chainId: string;
+    ibcConnectionInfo: {
+        id: string;
+        client_id: string;
+        state: 'OPEN' | 'TRYOPEN' | 'INIT' | 'CLOSED';
+        counterparty: {
+            client_id: string;
+            connection_id: string;
+            prefix: {
+                key_prefix: string;
+            };
+        };
+        versions: {
+            identifier: string;
+            features: string[];
+        }[];
+        delay_period: bigint;
+    };
+    icaEnabled: boolean;
+    icqEnabled: boolean;
+    pfmEnabled: boolean;
+    ibcHooksEnabled: boolean;
+    /**
+     *
+     */
+    allowedMessages: TypeUrl[];
+    allowedQueries: TypeUrl[];
+};
+export interface StakingAccountQueries {
+    /**
+     * @returns all active delegations from the account to any validator (or [] if none)
+     */
+    getDelegations: () => Promise<Delegation[]>;
+    /**
+     * @returns the active delegation from the account to a specific validator. Return an
+     * empty Delegation if there is no delegation.
+     */
+    getDelegation: (validator: CosmosValidatorAddress) => Promise<Delegation>;
+    /**
+     * @returns the unbonding delegations from the account to any validator (or [] if none)
+     */
+    getUnbondingDelegations: () => Promise<UnbondingDelegation[]>;
+    /**
+     * @returns the unbonding delegations from the account to a specific validator (or [] if none)
+     */
+    getUnbondingDelegation: (validator: CosmosValidatorAddress) => Promise<UnbondingDelegation>;
+    getRedelegations: () => Promise<Redelegation[]>;
+    getRedelegation: (srcValidator: CosmosValidatorAddress, dstValidator?: CosmosValidatorAddress) => Promise<Redelegation>;
+    /**
+     * Get the pending rewards for the account.
+     * @returns the amounts of the account's rewards pending from all validators
+     */
+    getRewards: () => Promise<DenomAmount[]>;
+    /**
+     * Get the rewards pending with a specific validator.
+     * @param validator - the validator address to query for
+     * @returns the amount of the account's rewards pending from a specific validator
+     */
+    getReward: (validator: CosmosValidatorAddress) => Promise<DenomAmount[]>;
+}
+export interface StakingAccountActions {
+    /**
+     * Delegate an amount to a validator. The promise settles when the delegation is complete.
+     * @param validator - the validator to delegate to
+     * @param amount  - the amount to delegate
+     * @returns void
+     */
+    delegate: (validator: CosmosValidatorAddress, amount: AmountArg) => Promise<void>;
+    /**
+     * Redelegate from one delegator to another.
+     * Settles when the redelegation is established, not 21 days later.
+     * @param srcValidator - the current validator for the delegation.
+     * @param dstValidator - the validator that will receive the delegation.
+     * @param amount - how much to redelegate.
+     * @returns
+     */
+    redelegate: (srcValidator: CosmosValidatorAddress, dstValidator: CosmosValidatorAddress, amount: AmountArg) => Promise<void>;
+    /**
+     * Undelegate multiple delegations (concurrently). To delegate independently, pass an array with one item.
+     * Resolves when the undelegation is complete and the tokens are no longer bonded. Note it may take weeks.
+     * The unbonding time is padded by 10 minutes to account for clock skew.
+     * @param {Delegation[]} delegations - the delegation to undelegate
+     */
+    undelegate: (delegations: Delegation[]) => Promise<void>;
+    /**
+     * Withdraw rewards from all validators. The promise settles when the rewards are withdrawn.
+     * @returns The total amounts of rewards withdrawn
+     */
+    withdrawRewards: () => Promise<DenomAmount[]>;
+    /**
+     * Withdraw rewards from a specific validator. The promise settles when the rewards are withdrawn.
+     * @param validator - the validator to withdraw rewards from
+     * @returns
+     */
+    withdrawReward: (validator: CosmosValidatorAddress) => Promise<DenomAmount[]>;
+}
+/**
+ * Low level object that supports queries and operations for an account on a remote chain.
+ */
+export interface IcaAccount {
+    /**
+     * @returns the address of the account on the remote chain
+     */
+    getAddress: () => ChainAddress;
+    /**
+     * Submit a transaction on behalf of the remote account for execution on the remote chain.
+     * @param msgs - records for the transaction
+     * @returns acknowledgement string
+     */
+    executeTx: (msgs: Proto3JSONMsg[]) => Promise<string>;
+    /**
+     * Submit a transaction on behalf of the remote account for execution on the remote chain.
+     * @param {AnyJson[]} msgs - records for the transaction
+     * @param {Partial<Omit<TxBody, 'messages'>>} [opts] - optional parameters for the Tx, like `timeoutHeight` and `memo`
+     * @returns acknowledgement string
+     */
+    executeEncodedTx: (msgs: AnyJson[], opts?: Partial<Omit<TxBody, 'messages'>>) => Promise<string>;
+    /** deposit payment from zoe to the account*/
+    deposit: (payment: Payment) => Promise<void>;
+    /** get Purse for a brand to .withdraw() a Payment from the account */
+    getPurse: (brand: Brand) => Promise<Purse>;
+    /**
+     * Close the remote account
+     */
+    close: () => Promise<void>;
+    prepareTransfer: () => Promise<Invitation>;
+    /** @returns the address of the remote channel */
+    getRemoteAddress: () => RemoteIbcAddress;
+    /** @returns the address of the local channel */
+    getLocalAddress: () => LocalIbcAddress;
+    /** @returns the port the ICA channel is bound to */
+    getPort: () => Port;
+}
+export type LiquidStakingMethods = {
+    liquidStake: (amount: AmountArg) => Promise<void>;
+};
+//# sourceMappingURL=cosmos-api.d.ts.map

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

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

package/src/cosmos-api.ts

@@ -0,0 +1,199 @@
+import type { AnyJson } from '@agoric/cosmic-proto';
+import type {
+  Delegation,
+  Redelegation,
+  UnbondingDelegation,
+} from '@agoric/cosmic-proto/cosmos/staking/v1beta1/staking.js';
+import type { TxBody } from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
+import type { Brand, Payment, Purse } from '@agoric/ertp/exported.js';
+import type { Port } from '@agoric/network';
+import type {
+  LocalIbcAddress,
+  RemoteIbcAddress,
+} from '@agoric/vats/tools/ibc-utils.js';
+import type { AmountArg, ChainAddress, DenomAmount } from './types.js';
+
+/** A helper type for type extensions. */
+export type TypeUrl = string;
+
+// TODO move into cosmic-proto
+export type Proto3JSONMsg = {
+  '@type': TypeUrl;
+  value: Record<string, unknown>;
+};
+
+/** An address for a validator on some blockchain, e.g., cosmos, eth, etc. */
+export type CosmosValidatorAddress = ChainAddress & {
+  // TODO document why this is the format
+  address: `${string}valoper${string}`;
+  addressEncoding: 'bech32';
+};
+
+/**
+ * Info for a Cosmos-based chain.
+ */
+export type CosmosChainInfo = {
+  chainId: string;
+  ibcConnectionInfo: {
+    id: string; // e.g. connection-0
+    client_id: string; // '07-tendermint-0'
+    state: 'OPEN' | 'TRYOPEN' | 'INIT' | 'CLOSED';
+    counterparty: {
+      client_id: string;
+      connection_id: string;
+      prefix: {
+        key_prefix: string;
+      };
+    };
+    versions: { identifier: string; features: string[] }[];
+    delay_period: bigint;
+  };
+  icaEnabled: boolean;
+  icqEnabled: boolean;
+  pfmEnabled: boolean;
+  ibcHooksEnabled: boolean;
+  /**
+   *
+   */
+  allowedMessages: TypeUrl[];
+  allowedQueries: TypeUrl[];
+};
+
+export interface StakingAccountQueries {
+  /**
+   * @returns all active delegations from the account to any validator (or [] if none)
+   */
+  getDelegations: () => Promise<Delegation[]>;
+
+  /**
+   * @returns the active delegation from the account to a specific validator. Return an
+   * empty Delegation if there is no delegation.
+   */
+  getDelegation: (validator: CosmosValidatorAddress) => Promise<Delegation>;
+
+  /**
+   * @returns the unbonding delegations from the account to any validator (or [] if none)
+   */
+  getUnbondingDelegations: () => Promise<UnbondingDelegation[]>;
+
+  /**
+   * @returns the unbonding delegations from the account to a specific validator (or [] if none)
+   */
+  getUnbondingDelegation: (
+    validator: CosmosValidatorAddress,
+  ) => Promise<UnbondingDelegation>;
+
+  getRedelegations: () => Promise<Redelegation[]>;
+
+  getRedelegation: (
+    srcValidator: CosmosValidatorAddress,
+    dstValidator?: CosmosValidatorAddress,
+  ) => Promise<Redelegation>;
+
+  /**
+   * Get the pending rewards for the account.
+   * @returns the amounts of the account's rewards pending from all validators
+   */
+  getRewards: () => Promise<DenomAmount[]>;
+
+  /**
+   * Get the rewards pending with a specific validator.
+   * @param validator - the validator address to query for
+   * @returns the amount of the account's rewards pending from a specific validator
+   */
+  getReward: (validator: CosmosValidatorAddress) => Promise<DenomAmount[]>;
+}
+export interface StakingAccountActions {
+  /**
+   * Delegate an amount to a validator. The promise settles when the delegation is complete.
+   * @param validator - the validator to delegate to
+   * @param amount  - the amount to delegate
+   * @returns void
+   */
+  delegate: (
+    validator: CosmosValidatorAddress,
+    amount: AmountArg,
+  ) => Promise<void>;
+
+  /**
+   * Redelegate from one delegator to another.
+   * Settles when the redelegation is established, not 21 days later.
+   * @param srcValidator - the current validator for the delegation.
+   * @param dstValidator - the validator that will receive the delegation.
+   * @param amount - how much to redelegate.
+   * @returns
+   */
+  redelegate: (
+    srcValidator: CosmosValidatorAddress,
+    dstValidator: CosmosValidatorAddress,
+    amount: AmountArg,
+  ) => Promise<void>;
+
+  /**
+   * Undelegate multiple delegations (concurrently). To delegate independently, pass an array with one item.
+   * Resolves when the undelegation is complete and the tokens are no longer bonded. Note it may take weeks.
+   * The unbonding time is padded by 10 minutes to account for clock skew.
+   * @param {Delegation[]} delegations - the delegation to undelegate
+   */
+  undelegate: (delegations: Delegation[]) => Promise<void>;
+
+  /**
+   * Withdraw rewards from all validators. The promise settles when the rewards are withdrawn.
+   * @returns The total amounts of rewards withdrawn
+   */
+  withdrawRewards: () => Promise<DenomAmount[]>;
+
+  /**
+   * Withdraw rewards from a specific validator. The promise settles when the rewards are withdrawn.
+   * @param validator - the validator to withdraw rewards from
+   * @returns
+   */
+  withdrawReward: (validator: CosmosValidatorAddress) => Promise<DenomAmount[]>;
+}
+
+/**
+ * Low level object that supports queries and operations for an account on a remote chain.
+ */
+export interface IcaAccount {
+  /**
+   * @returns the address of the account on the remote chain
+   */
+  getAddress: () => ChainAddress;
+
+  /**
+   * Submit a transaction on behalf of the remote account for execution on the remote chain.
+   * @param msgs - records for the transaction
+   * @returns acknowledgement string
+   */
+  executeTx: (msgs: Proto3JSONMsg[]) => Promise<string>;
+  /**
+   * Submit a transaction on behalf of the remote account for execution on the remote chain.
+   * @param {AnyJson[]} msgs - records for the transaction
+   * @param {Partial<Omit<TxBody, 'messages'>>} [opts] - optional parameters for the Tx, like `timeoutHeight` and `memo`
+   * @returns acknowledgement string
+   */
+  executeEncodedTx: (
+    msgs: AnyJson[],
+    opts?: Partial<Omit<TxBody, 'messages'>>,
+  ) => Promise<string>;
+  /** deposit payment from zoe to the account*/
+  deposit: (payment: Payment) => Promise<void>;
+  /** get Purse for a brand to .withdraw() a Payment from the account */
+  getPurse: (brand: Brand) => Promise<Purse>;
+  /**
+   * Close the remote account
+   */
+  close: () => Promise<void>;
+  /* transfer account to new holder */
+  prepareTransfer: () => Promise<Invitation>;
+  /** @returns the address of the remote channel */
+  getRemoteAddress: () => RemoteIbcAddress;
+  /** @returns the address of the local channel */
+  getLocalAddress: () => LocalIbcAddress;
+  /** @returns the port the ICA channel is bound to */
+  getPort: () => Port;
+}
+
+export type LiquidStakingMethods = {
+  liquidStake: (amount: AmountArg) => Promise<void>;
+};

package/src/ethereum-api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Info for an Ethereum-based chain.
+ */
+export type EthChainInfo = {
+    chainId: string;
+    allegedName: string;
+};
+//# sourceMappingURL=ethereum-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum-api.d.ts","sourceRoot":"","sources":["ethereum-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/src/ethereum-api.ts

@@ -0,0 +1,7 @@
+/**
+ * Info for an Ethereum-based chain.
+ */
+export type EthChainInfo = {
+  chainId: string;
+  allegedName: string;
+};

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

@@ -0,0 +1,84 @@
+export namespace meta {
+    namespace privateArgsShape {
+        export let orchestration: import("@endo/patterns").Matcher;
+        export { StorageNodeShape as storageNode };
+        export let marshaller: import("@endo/patterns").Matcher;
+        export let timer: import("@endo/patterns").Matcher;
+    }
+}
+export namespace privateArgsShape { }
+export function start(zcf: ZCF<StakeAtomTerms>, privateArgs: {
+    orchestration: import("@endo/exo").Guarded<{
+        makeAccount(hostConnectionId: `connection-${number}`, controllerConnectionId: `connection-${number}`): Promise<import("../cosmos-api.js").IcaAccount>;
+        provideICQConnection(controllerConnectionId: `connection-${number}`): Promise<import("@endo/exo").Guarded<{
+            getLocalAddress(): `/ibc-port/${string}`;
+            getRemoteAddress(): `/${string}ibc-port/${string}/ordered/${string}` | `/${string}ibc-port/${string}/unordered/${string}`;
+            query(msgs: import("@agoric/cosmic-proto").JsonSafe<import("@agoric/cosmic-proto/tendermint/abci/types.js").RequestQuery>[]): Promise<import("@agoric/cosmic-proto").Base64Any<import("@agoric/cosmic-proto/tendermint/abci/types.js").ResponseQuery>[]>;
+        }>>;
+    }>;
+    storageNode: StorageNode;
+    marshaller: Marshaller;
+    timer: TimerService;
+}, baggage: Baggage): Promise<{
+    publicFacet: import("@endo/exo").Guarded<{
+        makeAccount(): Promise<import("@endo/exo").Guarded<{
+            getPublicTopics(): {
+                account: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("../exos/stakingAccountKit.js").StakingAccountNotification>;
+                    storagePath: Promise<string>;
+                };
+            };
+            getAddress(): import("../orchestration-api.js").ChainAddress;
+            delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Promise<void>;
+            redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Promise<void>;
+            withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Promise<import("../orchestration-api.js").DenomAmount[]>;
+            getBalance(denom?: string | undefined): Promise<import("../orchestration-api.js").DenomAmount>;
+            withdrawRewards(): never;
+            undelegate(delegations: import("@agoric/cosmic-proto/cosmos/staking/v1beta1/staking.js").Delegation[]): Promise<void>;
+        }>>;
+        makeAcountInvitationMaker(): Promise<Invitation<{
+            publicSubscribers: {
+                account: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("../exos/stakingAccountKit.js").StakingAccountNotification>;
+                    storagePath: Promise<string>;
+                };
+            };
+            invitationMakers: import("@endo/exo").Guarded<{
+                Delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: Amount<"nat">): Promise<Invitation<void, undefined>>;
+                Redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Promise<Invitation<void, undefined>>;
+                WithdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Promise<Invitation<import("../orchestration-api.js").DenomAmount[], undefined>>;
+                Undelegate(delegations: import("@agoric/cosmic-proto/cosmos/staking/v1beta1/staking.js").Delegation[]): Promise<Invitation<void, undefined>>;
+                CloseAccount(): never;
+                TransferAccount(): never;
+            }>;
+            account: import("@endo/exo").Guarded<{
+                getPublicTopics(): {
+                    account: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("../exos/stakingAccountKit.js").StakingAccountNotification>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                getAddress(): import("../orchestration-api.js").ChainAddress;
+                delegate(validator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Promise<void>;
+                redelegate(srcValidator: import("../cosmos-api.js").CosmosValidatorAddress, dstValidator: import("../cosmos-api.js").CosmosValidatorAddress, amount: import("../orchestration-api.js").AmountArg): Promise<void>;
+                withdrawReward(validator: import("../cosmos-api.js").CosmosValidatorAddress): Promise<import("../orchestration-api.js").DenomAmount[]>;
+                getBalance(denom?: string | undefined): Promise<import("../orchestration-api.js").DenomAmount>;
+                withdrawRewards(): never;
+                undelegate(delegations: import("@agoric/cosmic-proto/cosmos/staking/v1beta1/staking.js").Delegation[]): Promise<void>;
+            }>;
+        }, undefined>>;
+    }>;
+}>;
+export type StakeAtomTerms = {
+    hostConnectionId: `connection-${number}`;
+    controllerConnectionId: `connection-${number}`;
+    bondDenom: string;
+};
+export type StakeAtomSF = typeof start;
+import { StorageNodeShape } from '@agoric/internal';
+import type { TimerService } from '@agoric/time';
+import type { Baggage } from '@agoric/vat-data';
+//# sourceMappingURL=stakeAtom.contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stakeAtom.contract.d.ts","sourceRoot":"","sources":["stakeAtom.contract.js"],"names":[],"mappings":";;;;;;;;;AA+CO,2BATI,GAAG,CAAC,cAAc,CAAC;;;;;;;;;iBAGb,WAAW;gBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FAgFooH,OAAO,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;GAH1qH;;;;eAvFc,MAAM;;0BAyFP,OAAO,KAAK;iCAtHmB,kBAAkB;kCAW9B,cAAc;6BAFnB,kBAAkB"}

package/src/examples/stakeAtom.contract.js

@@ -1,4 +1,3 @@
-// @ts-check
 /**
  * @file Example contract that uses orchestration
  */