@agoric/orchestration 0.1.1-dev-d756c83.0.d756c83 → 0.1.1-dev-e9efaa1.0.e9efaa1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/orchestration",
-  "version": "0.1.1-dev-d756c83.0.d756c83",
+  "version": "0.1.1-dev-e9efaa1.0.e9efaa1",
   "description": "Chain abstraction for Agoric's orchestration clients",
   "type": "module",
   "main": "index.js",
@@ -13,8 +13,8 @@
     "codegen:viem-abi": "tsup",
     "build": "yarn esbuild:axelar",
     "codegen": "scripts/fetch-chain-info.ts",
-    "prepack": "yarn run -T tsc --build tsconfig.build.json",
-    "postpack": "git clean -f '*.d.*ts*' '*.tsbuildinfo'",
+    "prepack": "yarn run -T prepack-package",
+    "postpack": "yarn run -T postpack-package",
     "test": "ava",
     "test:c8": "c8 --all ${C8_OPTIONS:-} ava",
     "test:xs": "exit 0",
@@ -35,19 +35,19 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/async-flow": "0.1.1-dev-d756c83.0.d756c83",
-    "@agoric/cosmic-proto": "0.4.1-dev-d756c83.0.d756c83",
-    "@agoric/ertp": "0.16.3-dev-d756c83.0.d756c83",
-    "@agoric/internal": "0.3.3-dev-d756c83.0.d756c83",
-    "@agoric/network": "0.1.1-dev-d756c83.0.d756c83",
-    "@agoric/notifier": "0.6.3-dev-d756c83.0.d756c83",
-    "@agoric/store": "0.9.3-dev-d756c83.0.d756c83",
-    "@agoric/time": "0.3.3-dev-d756c83.0.d756c83",
-    "@agoric/vat-data": "0.5.3-dev-d756c83.0.d756c83",
-    "@agoric/vats": "0.15.2-dev-d756c83.0.d756c83",
-    "@agoric/vow": "0.1.1-dev-d756c83.0.d756c83",
-    "@agoric/zoe": "0.26.3-dev-d756c83.0.d756c83",
-    "@agoric/zone": "0.2.3-dev-d756c83.0.d756c83",
+    "@agoric/async-flow": "0.1.1-dev-e9efaa1.0.e9efaa1",
+    "@agoric/cosmic-proto": "0.4.1-dev-e9efaa1.0.e9efaa1",
+    "@agoric/ertp": "0.16.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/internal": "0.3.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/network": "0.1.1-dev-e9efaa1.0.e9efaa1",
+    "@agoric/notifier": "0.6.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/store": "0.9.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/time": "0.3.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/vat-data": "0.5.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/vats": "0.15.2-dev-e9efaa1.0.e9efaa1",
+    "@agoric/vow": "0.1.1-dev-e9efaa1.0.e9efaa1",
+    "@agoric/zoe": "0.26.3-dev-e9efaa1.0.e9efaa1",
+    "@agoric/zone": "0.2.3-dev-e9efaa1.0.e9efaa1",
     "@cosmjs/encoding": "^0.36.0",
     "@endo/base64": "^1.0.12",
     "@endo/errors": "^1.2.13",
@@ -60,7 +60,7 @@
     "bs58": "^6.0.0"
   },
   "devDependencies": {
-    "@agoric/swingset-liveslots": "0.10.3-dev-d756c83.0.d756c83",
+    "@agoric/swingset-liveslots": "0.10.3-dev-e9efaa1.0.e9efaa1",
     "@chain-registry/client": "^1.53.194",
     "@cosmjs/amino": "^0.36.0",
     "@cosmjs/proto-signing": "^0.36.0",
@@ -106,5 +106,5 @@
   "typeCoverage": {
     "atLeast": 97.63
   },
-  "gitHead": "d756c838c7eb3e3cec4a8bdf5c24b97f942b754e"
+  "gitHead": "e9efaa12254f2c9a6faffc40ade2f1d9a70b87ae"
 }

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/exos/exo-interfaces.js

@@ -0,0 +1,35 @@
+                                                    
+                                       
+                                                   
+                                                                 
+                                                             
+
+/**
+ * Authority to make a Cosmos interchain account or an interchain query connection.
+ */
+                                          
+     
+                            
+                                                               
+                    
+                                                                       
+                                                                    
+                                                    
+                               
+     
+              
+                    
+                                      
+                                            
+                                             
+                     
+     
+                                                    
+                              
+                                                  
+     
+                       
+                                            
+                                 
+                                        
+