@agoric/orchestration 0.2.0 → 0.2.1-upgrade-23-dev-bd79330.0.bd79330

package/src/cosmos-api.js

@@ -0,0 +1,585 @@
+/* eslint-disable @typescript-eslint/no-unused-vars -- fails to notice the @see uses */
+             
+          
+           
+              
+                  
+            
+              
+                              
+                                                                             
+             
+                       
+                      
+                                                                
+                                                                           
+                                                                                           
+                                                                                                           
+             
+                           
+        
+                                                             
+                                                                                                             
+             
+               
+                
+                                                       
+                                                                 
+                                            
+                                                 
+             
+               
+                  
+            
+                 
+                  
+                    
+                      
+             
+            
+                     
+                                           
+             
+                  
+                   
+                                         
+                                                        
+             
+            
+            
+                
+                     
+        
+              
+                
+                    
+
+/**
+ * Record of Network API traffic for a specific data packet sent between two
+ * chains.
+ */
+                         
+                                     
+                                                         
+                             
+                                       
+     
+                                                                   
+             
+                                                                  
+                       
+                                                   
+                           
+                                                        
+                           
+                                                                         
+                                                                    
+  
+
+                                                   
+                                             
+  
+
+/**
+ * The type of the `executeEncodedTx` options parameter on the underlying ICA.
+ */
+                                                                           
+                                      
+
+                                                    
+                                                           
+  
+
+/**
+ * @example
+ *
+ *    agoric1megzytg65cyrgzs6fvzxgrcqvwwl7ugpt62346
+ *    cosmosvaloper1npm9gvss52mlmk
+ */
+                                                  
+
+/** An address for a validator on some blockchain, e.g., cosmos, eth, etc. */
+                                                           
+                                                                                                    
+                                     
+                     
+  
+
+/** Represents an IBC Connection between two chains, which can contain multiple Channels. */
+                                    
+                                           
+                                         
+                            
+                 
+                      
+                                   
+    
+                    
+                   
+                            
+                               
+                                        
+                    
+                           
+                                       
+    
+ 
+
+/**
+ * https://github.com/cosmos/chain-registry/blob/master/assetlist.schema.json
+ */
+                                                                  
+              
+               
+                  
+                 
+                                                         
+                  
+                
+                   
+                         
+                        
+                               
+      
+            
+                               
+                   
+      
+     
+ 
+
+/**
+ * Info for a Cosmos-based chain.
+ */
+                                                        
+                                                                        
+                       
+                                                                                                
+                  
+                                                                         
+                                                  
+                                                                                                                       
+                       
+     
+                                                                                                                                   
+    
+                                                                                                                                                                  
+     
+                       
+                      
+     
+                                                                                
+                                                  
+     
+                       
+     
+                                                                                   
+     
+                                                     
+ 
+
+// #region Orchestration views on Cosmos response types
+// Naming scheme: Cosmos for the chain system, Rewards b/c getRewards function,
+// and Response because it's the return value.
+
+/** @see {QueryDelegationTotalRewardsResponse} */
+                                        
+                                                                          
+                       
+ 
+
+/** @see {DelegationResponse} */
+                                           
+                                
+                                    
+                      
+ 
+// #endregion
+
+/**
+ * Queries for the staking properties of an account.
+ *
+ * @see {@link https://docs.cosmos.network/main/build/modules/staking#messages x/staking messages}
+ * {@link https://cosmos.github.io/cosmjs/latest/stargate/interfaces/StakingExtension.html StakingExtension} in cosmjs
+ */
+                                        
+     
+                                                                                      
+     
+                   
+                                
+                                           
+     
+                                                                                       
+                                                
+     
+                  
+                                      
+                                
+                                         
+
+     
+                                                                                         
+     
+                            
+                                
+                                      
+
+     
+                                                                                                
+     
+                           
+                                      
+                                
+                                    
+
+                     
+                                
+                                       
+
+     
+                                             
+                                                                              
+     
+                                                                              
+
+     
+                                                       
+                                                          
+                                                                                   
+     
+              
+                                      
+                                
+                              
+ 
+
+/**
+ * Transactions for doing staking operations on an individual account.
+ *
+ * @see {@link https://docs.cosmos.network/main/build/modules/staking#messages x/staking messages} and
+ * {@link https://cosmos.github.io/cosmjs/latest/stargate/interfaces/StakingExtension.html StakingExtension} in cosmjs
+ */
+                                        
+     
+                                                                                            
+                                                    
+                                            
+                                                   
+                     
+     
+             
+                                      
+                      
+                               
+                        
+
+     
+                                              
+                                                                     
+                                                                    
+                                                                          
+                                            
+                                                   
+             
+     
+               
+                                         
+                                         
+                      
+                               
+                        
+
+     
+                                                                                                            
+                                                                                                            
+                                                                          
+                                                      
+                                                   
+     
+               
+                  
+                        
+                                     
+                                        
+        
+                               
+                        
+
+     
+                                                                                              
+                                                   
+                                                    
+     
+                                                                          
+
+     
+                                                                                                    
+                                                              
+                                                   
+             
+     
+                   
+                                      
+                               
+                              
+ 
+
+/**
+ * Low level methods from IcaAccount that we pass through to CosmosOrchestrationAccount
+ */
+
+                                        
+     
+                                                                                            
+                                              
+                                                                                                                                     
+                                                             
+     
+                     
+                             
+                                                                               
+                            
+                                         
+                       
+     
+                                                                          
+                                                                               
+                                         
+                                                                  
+                                                                          
+     
+                                  
+     
+                                                                          
+                                         
+                                                                               
+                                                                               
+                             
+                                                      
+     
+                                  
+ 
+
+/**
+ * Low level object that supports queries and operations for an account on a remote chain.
+ */
+                                                           
+     
+                                                            
+     
+                                       
+
+     
+                                                                                            
+                                              
+                             
+     
+                                                    
+                                                   
+                                           
+                                                  
+                                         
+                                                      
+                      
+ 
+
+/**
+ * ICA-related account methods exposed on the Cosmos Orchestration Account
+ * holder facet.
+ */
+                                                                  
+     
+                                                                          
+                                               
+    
+                                                                     
+    
+                                                                          
+                                                             
+    
+                                              
+                                                                                                                                     
+                                                 
+     
+                                                                          
+                    
+                                        
+       
+                               
+                                                                           
+     
+                                                                          
+                                                      
+    
+                                                                     
+    
+                                                                          
+                                                             
+    
+                                              
+                                                                                                                                     
+                                                             
+     
+                             
+                             
+                               
+                       
+ 
+
+/** Methods on chains that support Liquid Staking */
+                                       
+                
+                      
+                               
+                        
+ 
+
+/**
+ * Noble is the gateway to transferring USDC among Cosmos chains. We can
+ * transfer funds from any cosmos account using depositForBurn().
+ */
+                               
+                                                                    
+                   
+                             
+                      
+                                                                                       
+                       
+                               
+                        
+ 
+
+// TODO support StakingAccountQueries
+/** Methods supported only on Agoric chain accounts */
+                                                                    
+                                                               
+                                                               
+                                            
+                                                               
+     
+                                                                             
+                                                
+    
+                                                   
+                                                                            
+    
+                                                                             
+    
+                                                                          
+                                                                         
+                                   
+    
+               
+     
+                                                                    
+     
+                                                               
+     
+                                                                  
+                        
+                        
+                      
+                               
+     
+ 
+
+/**
+ * Options for {@link OrchestrationAccountI} `transfer` method.
+ *
+ * If specifying a custom timeout, use one of `timeoutHeight`, `timeoutTimestamp`, or `timeoutRelativeSeconds`.
+ *
+ * @see {@link https://github.com/cosmos/ibc/tree/master/spec/app/ics-020-fungible-token-transfer#data-structures ICS 20 Data Structures}
+ */
+                                     
+                                               
+                                                     
+                                                                                                                  
+                                  
+                
+                 
+                                                                                                  
+                                               
+                                                
+                                                
+    
+                        
+
+/**
+ * Cosmos-specific methods to extend `OrchestrationAccountI`, parameterized
+ * by `CosmosChainInfo`.
+ *
+ * In particular, if the chain info includes a staking token, {@link StakingAccountActions}
+ * are available.
+ *
+ * @see {OrchestrationAccountI}
+ */
+                                                                        
+                     
+                  
+                            
+     
+                                                     
+                
+
+                                
+                                 
+                                        
+
+/**
+ * Message structure for PFM memo
+ *
+ * @see {@link https://github.com/cosmos/chain-registry/blob/58b603bbe01f70e911e3ad2bdb6b90c4ca665735/_memo_keys/ICS20_memo_keys.json#L38-L60}
+ */
+                              
+            
+                                          
+                    
+                          
+                     
+                        
+                        
+                    
+            
+                           
+      
+    
+ 
+
+/**
+ * Object used to help build MsgTransfer parameters for IBC transfers.
+ *
+ * If `forwardInfo` is present:
+ * - it must be stringified and provided as the `memo` field value for
+ * use with `MsgTransfer`.
+ * - `receiver` will be set to `"pfm"` - purposely invalid bech32. see {@link https://github.com/cosmos/ibc-apps/blob/26f3ad8f58e4ffc7769c6766cb42b954181dc100/middleware/packet-forward-middleware/README.md#minimal-example---chain-forward-a-b-c}
+ */
+                             
+                              
+                     
+                              
+              
+     
+     
+                                                                  
+                                         
+                               
+     
+     
+                       
+                          
+     
+  
+
+/** Single units allowed in Go time duration strings */
+                                                           
+
+/**
+ * Type for a time duration string in Go (cosmos-sdk). For example, "1h", "3m".
+ *
+ * Note: this does not support composite values like "1h30m", "1m30s",
+ * which are allowed in Go.
+ *
+ * @see https://pkg.go.dev/time#ParseDuration
+ */
+                                                      

package/src/{ethereum-api.ts → ethereum-api.js}

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-unused-vars -- fails to notice the @see uses */
-import type { BaseChainInfo } from './orchestration-api.ts';
+                                                            
 
 /**
  * @file

package/src/examples/auto-stake-it-tap-kit.d.ts

@@ -28,18 +28,19 @@ declare function prepareStakingTapKit(zone: Zone, { watch }: VowTools): (initial
          *
          * @param {VTransferIBCEvent} event
          */
-        receiveUpcall(event: VTransferIBCEvent): import("@agoric/vow").Vow<void> | undefined;
+        receiveUpcall(event: VTransferIBCEvent): import("@agoric/vow").Vow<unknown> | undefined;
     };
     transferWatcher: {
         /**
-         * @param {void} _result
+         * @param {any} _result
          * @param {bigint} value the qty of uatom to delegate
          */
-        onFulfilled(_result: void, value: bigint): import("@agoric/vow").Vow<void>;
+        onFulfilled(_result: any, value: bigint): import("@agoric/vow").Vow<unknown>;
     };
 }>;
 import type { OrchestrationAccount } from '@agoric/orchestration';
 import type { StakingAccountActions } from '@agoric/orchestration';
+import type { ERef } from '@agoric/vow';
 import type { CosmosValidatorAddress } from '@agoric/orchestration';
 import type { CosmosChainAddress } from '@agoric/orchestration';
 import type { IBCChannelID } from '@agoric/vats';

package/src/examples/auto-stake-it-tap-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-stake-it-tap-kit.d.ts","sourceRoot":"","sources":["auto-stake-it-tap-kit.js"],"names":[],"mappings":"AAmJO,wCANI,IAAI,YACJ,QAAQ,GACN,CACZ,GAAO,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,KACzD,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAKjE;8BAlIY;IACR,cAAc,EAAE,IAAI,CAAC,qBAAqB,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC;IACxE,YAAY,EAAE,IAAI,CAAC,qBAAqB;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE,SAAS,EAAE,sBAAsB,CAAC;IAClC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;CACnB;6BA2HU,UAAU,CAAC,OAAO,iBAAiB,CAAC;yBACpC,UAAU,CAAC,cAAc,CAAC;0BA7IjB,cAAc;8BADV,aAAa;AAkCxC;;;GAGG;AACH,4CAHW,IAAI,aACJ,QAAQ;;QAwBX;;;;;;WAMG;6BADQ,iBAAiB;;;QAqC5B;;;WAGG;6BAFQ,IAAI,SACJ,MAAM;;GAcxB;0CAnHgH,uBAAuB;2CAAvB,uBAAuB;4CAAvB,uBAAuB;wCAAvB,uBAAuB;kCAJtF,cAAc;2BAIiD,uBAAuB;uCAJtF,cAAc"}
+{"version":3,"file":"auto-stake-it-tap-kit.d.ts","sourceRoot":"","sources":["auto-stake-it-tap-kit.js"],"names":[],"mappings":"AAkJO,wCANI,IAAI,YACJ,QAAQ,GACN,CACZ,GAAO,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,KACzD,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAKjE;8BAhIY;IACR,cAAc,EAAE,KAAK,qBAAqB,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC;IACxE,YAAY,EAAE,KAAK,qBAAqB;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE,SAAS,EAAE,sBAAsB,CAAC;IAClC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;CACnB;6BAyHU,UAAU,CAAC,OAAO,iBAAiB,CAAC;yBACpC,UAAU,CAAC,cAAc,CAAC;0BA5IjB,cAAc;8BADV,aAAa;AAmCxC;;;GAGG;AACH,4CAHW,IAAI,aACJ,QAAQ;;QAsBX;;;;;;WAMG;6BADQ,iBAAiB;;;QAqC5B;;;WAGG;6BAFQ,GAAG,SACH,MAAM;;GAcxB;0CAlHgH,uBAAuB;2CAAvB,uBAAuB;0BAGjH,aAAa;4CAH6E,uBAAuB;wCAAvB,uBAAuB;kCAJtF,cAAc;2BAIiD,uBAAuB;uCAJtF,cAAc"}

package/src/examples/auto-stake-it-tap-kit.js

@@ -15,6 +15,7 @@ const trace = makeTracer('AutoStakeItTap');
  * @import {CosmosChainAddress, CosmosValidatorAddress, Denom, OrchestrationAccount, StakingAccountActions} from '@agoric/orchestration';
  * @import {FungibleTokenPacketData} from '@agoric/cosmic-proto/ibc/applications/transfer/v2/packet.js';
  * @import {TypedPattern} from '@agoric/internal';
+ * @import {ERef} from '@agoric/vow';
  */
 
 /**
@@ -57,9 +58,7 @@ const prepareStakingTapKit = (zone, { watch }) => {
         ),
       }),
       transferWatcher: M.interface('TransferWatcher', {
-        onFulfilled: M.call(M.undefined())
-          .optional(M.bigint())
-          .returns(VowShape),
+        onFulfilled: M.call(M.any()).optional(M.bigint()).returns(VowShape),
       }),
     },
     /** @param {StakingTapState} initialState */
@@ -112,7 +111,7 @@ const prepareStakingTapKit = (zone, { watch }) => {
       },
       transferWatcher: {
         /**
-         * @param {void} _result
+         * @param {any} _result
          * @param {bigint} value the qty of uatom to delegate
          */
         onFulfilled(_result, value) {

package/src/examples/auto-stake-it.contract.d.ts

@@ -1,17 +1,17 @@
 export const start: (zcf: ZCF<Record<string, unknown>>, privateArgs: OrchestrationPowers & {
-    marshaller: Marshaller;
+    marshaller: Remote<Marshaller>;
     chainInfo?: Record<string, CosmosChainInfo>;
     assetInfo?: [Denom, DenomDetail & {
         brandKey?: string;
     }][];
-}, baggage: Baggage) => Promise<{
+}, baggage: import("@agoric/vat-data").Baggage) => Promise<{
     publicFacet: import("@endo/exo").Guarded<{
-        makeAccountsInvitation(): Promise<globalThis.Invitation<import("@agoric/vow").Vow<import("@agoric/vow").Vow<{
+        makeAccountsInvitation(): Promise<import("@agoric/zoe").Invitation<import("@agoric/vow").Vow<import("@agoric/vow").Vow<{
             publicSubscribers: {
                 [k: string]: import("@agoric/zoe/src/contractSupport/topics.js").ResolvedPublicTopic<unknown>;
             };
             invitationMakers: import("@endo/exo").Guarded<{
-                Proxying<IA extends unknown[]>(chainName: string, action: string, invitationArgs?: IA): Promise<Invitation<unknown, IA>>;
+                Proxying<IA extends unknown[]>(chainName: string, action: string, invitationArgs?: IA): Promise<import("@agoric/zoe").Invitation<unknown, IA>>;
             }>;
         }>>, {
             chainName: string;
@@ -26,6 +26,8 @@ export const start: (zcf: ZCF<Record<string, unknown>>, privateArgs: Orchestrati
 export type AutoStakeItSF = typeof start;
 import type { ZCF } from '@agoric/zoe';
 import type { OrchestrationPowers } from '../utils/start-helper.js';
+import type { Marshaller } from '@agoric/internal/src/lib-chainStorage.js';
+import type { Remote } from '@agoric/internal';
 import type { CosmosChainInfo } from '../types.js';
 import type { Denom } from '../types.js';
 import type { DenomDetail } from '../types.js';

package/src/examples/auto-stake-it.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-stake-it.contract.d.ts","sourceRoot":"","sources":["auto-stake-it.contract.js"],"names":[],"mappings":"AAoFA;gBAzDiB,UAAU;gBACV,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;gBAC/B,CAAC,KAAK,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE;;;;;;;;;;;;;;;;;;;GAuDgB;4BAGjE,OAAO,KAAK;yBAvEJ,aAAa;yCAFuB,0BAA0B;qCAC9B,aAAa;2BAAb,aAAa;iCAAb,aAAa"}
+{"version":3,"file":"auto-stake-it.contract.d.ts","sourceRoot":"","sources":["auto-stake-it.contract.js"],"names":[],"mappings":"AAsFA;gBAzDiB,OAAO,UAAU,CAAC;gBAClB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;gBAC/B,CAAC,KAAK,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE;;;;;;;;;;;;;;;;;;;GAuDgB;4BAGjE,OAAO,KAAK;yBAxEJ,aAAa;yCAFuB,0BAA0B;gCAGvD,0CAA0C;4BAL9C,kBAAkB;qCAGW,aAAa;2BAAb,aAAa;iCAAb,aAAa"}