ok

README.md

@@ -1,10 +1,10 @@
-
 # Stargate upgrade
 
 [Join the Cosmos Stargate announcements channel!](Cosmos Stargate announcements channel!)
 
 If you’re running a block explorer, wallet, exchange, validator, or any other service (eg. custody provider) that depends upon the Cosmos Hub or Cosmos ecosystem, you’ll want to pay attention, because this upgrade will involve substantial changes.
 
+- [Collection of breaking changes from changelogs](breaking_changes.md)
 - [Inter-Blockchain Communication (IBC)– cross-chain transactions](https://figment.network/resources/cosmos-stargate-upgrade-overview/#ibc)
 - [Protobuf Migration – blockchain performance & dev acceleration](https://figment.network/resources/cosmos-stargate-upgrade-overview/#proto)
 - [State Sync – minutes to sync new nodes](https://figment.network/resources/cosmos-stargate-upgrade-overview/#sync)
@@ -15,54 +15,61 @@ Help us to get the word out–this is a major leap for the Cosmos Network and we
 
 ## Testnet
 
-We've launched the third public alpha testnet `stargate-3` for the Stargate Upgrade on Monday September 21th.
-
-Stargate-3 is a big testnet milestone for the Stargate initiative. 
-
-This release fixes issues with Legacy Amino that were discovered in `stargate-1/2`. We believe that this version is now good to test for exchanges and wallets.
+### Uncoordinated Upgrade Completed 02-02-2021
 
-The following features are live on the testnet.
+Upgrade instructions:
 
-* Legacy Amino
-* IBC
-* State-Sync 
+1. Stop your gaia v3 instance 
 
+```
+killall gaiad
+```
 
-This testnet is intended for:
+2. Backup your `.gaia` folder
 
-* Testing wallets, exchanges and block explorers against the legacy Amino REST interface
-* Giving node operators and validators an opportunity to test their integrations against a work in progress version
-* Playing with new Stargate features including IBC is possible now with the Akash realyer! Try it out at https://github.com/ovrclk/relayer/releases/tag/stargate-3
+3. Install gaia v4 binary
 
-We anticipate restarting this testnet with future integration targets. Once we have a migration script, we will launch a testnet with a simulated upgrade from cosmoshub-3.
+```
+git checkout v4.0.0
+make install
+```
 
-Our validator node for a persistent peer is available at
+4. Start gaia v4.0.0 binary
 
-``` bash
-00d8e9c0df367296436854b580d9b069d3f1a5fd@34.123.30.100:26656
-```
 
-For users who want to test state sync, our validator node has tendermint rpc open on `34.123.10.100:26657`and we are snapshotting every 1000 blocks.
+### Joining
 
-As of 09/21/2020, the tagged `gaia` version is [stargate-3](https://github.com/cosmos/gaia/releases/tag/stargate-3)
+We are launching the final stargate testnet. We
 
-Remember this version now has a single binary instead of `gaiacli/gaiad` and much more configurable `app.toml`
+- [Genesis file](genesis.json)
 
-```bash
+```
 git clone https://github.com/cosmos/gaia
-git checkout stargate-3
-make build
+git checkout v4.0.0
+make install
 ```
 
+Our validator node for a persistent peer is available at
 
+```bash
+6ae55f60f0951247985ccd52773312aa89413d1c@34.71.170.158:26656
+```
 
-The genesis file is available [here](genesis.json)
-The sha256sum of the genesis is
+Seed Node
 ```bash
-❯ sha256sum genesis.json
-346dac9029a686845ee7ffd711a0c2479a6422c10f92f31ded6da8c6f4efbbc5  genesis.json
+feeb2c3e89a69d09390c292fca9ef1c4eba084c5@35.193.131.167:26656
 ```
 
+Please familiarize your self with the [Running a Node](https://github.com/cosmos/cosmos-sdk/tree/master/docs/run-node) documentation.
+
+
+- Legacy Amino
+- IBC
+- State-Sync
+- Cosmovisor
+
+
+
 
 ## Statesync Configuration Options
 
@@ -78,13 +85,13 @@ Snapshot-interval specifies the block interval at which local state sync snapsho
 
 > NOTE: Please set this value to a non-zero value. This is required in order for other nodes to be able to utilize state-sync.
 
-``` bash
+```bash
 snapshot-interval = {{ .StateSync.SnapshotInterval }}
 ```
 
 Snapshot-keep-recent specifies the number of recent snapshots to keep and serve (0 to keep all).
 
-``` bash
+```bash
 snapshot-keep-recent = {{ .StateSync.SnapshotKeepRecent }}
 ```
 

audit.md

@@ -243,3 +243,234 @@ Stargate offers two modes of constructing transactions.
 Under the hood JSON Legacy Amino transactions are re-encoded as protobuf txs and encoded back to json during signature verification. If you have an existing integration with the Cosmos Hub or other Cosmos-SDK chains, you should expect that your signed and broadcast infrastructure will work without changes.
 
 If you are building a new integration, you should consider if SIGN_MODE_DIRECT and direct protobuf encoding is a better fit for your use case.
+
+
+## Querying Transactions
+
+The `/txs/[hash]` endpoint will continue to be available but there are substantial changes to the JSON that cannot be hidden behind the legacy amino facade that other endpoints use.
+
+A cosmoshub-3 response looks like this:
+```json
+
+{
+  "height": "3544383",
+  "txhash": "BF68CD8E17F6F86996DAF6A667A5E04489A515CA5C1A06D4BD13E8D179A08DF5",
+  "raw_log": "[{\"msg_index\":0,\"success\":true,\"log\":\"\",\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"sender\",\"value\":\"cosmos14kh20jtm3vpsxhh34lpg4g36clralearnp89u9\"},{\"key\":\"module\",\"value\":\"bank\"},{\"key\":\"action\",\"value\":\"send\"}]},{\"type\":\"transfer\",\"attributes\":[{\"key\":\"recipient\",\"value\":\"cosmos1hvsdf03tl6w5pnfvfv5g8uphjd4wfw2hsucxnd\"},{\"key\":\"amount\",\"value\":\"1uatom\"}]}]}]",
+  "logs": [
+    {
+      "msg_index": 0,
+      "success": true,
+      "log": "",
+      "events": [
+        {
+          "type": "message",
+          "attributes": [
+            {
+              "key": "sender",
+              "value": "cosmos14kh20jtm3vpsxhh34lpg4g36clralearnp89u9"
+            },
+            {
+              "key": "module",
+              "value": "bank"
+            },
+            {
+              "key": "action",
+              "value": "send"
+            }
+          ]
+        },
+        {
+          "type": "transfer",
+          "attributes": [
+            {
+              "key": "recipient",
+              "value": "cosmos1hvsdf03tl6w5pnfvfv5g8uphjd4wfw2hsucxnd"
+            },
+            {
+              "key": "amount",
+              "value": "1uatom"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "gas_wanted": "200000",
+  "gas_used": "40126",
+  "tx": {
+    "type": "cosmos-sdk/StdTx",
+    "value": {
+      "msg": [
+        {
+          "type": "cosmos-sdk/MsgSend",
+          "value": {
+            "from_address": "cosmos14kh20jtm3vpsxhh34lpg4g36clralearnp89u9",
+            "to_address": "cosmos1hvsdf03tl6w5pnfvfv5g8uphjd4wfw2hsucxnd",
+            "amount": [
+              {
+                "denom": "uatom",
+                "amount": "1"
+              }
+            ]
+          }
+        }
+      ],
+      "fee": {
+        "amount": [
+          {
+            "denom": "uatom",
+            "amount": "1"
+          }
+        ],
+        "gas": "200000"
+      },
+      "signatures": [
+        {
+          "pub_key": {
+            "type": "tendermint/PubKeySecp256k1",
+            "value": "A5k5Y+HnrqZeDb04fCOKVMw7/egVeAnA8J/WX4Sl2Dbo"
+          },
+          "signature": "WyIXcAUbVr/ILFHyMoS3p+WmZ34LVaIaye7i1BCZ5kciqyxLY9AjSzh12w6Pjq+zr6xi85meAOOhTKZUT57nkw=="
+        }
+      ],
+      "memo": ""
+    }
+  },
+  "timestamp": "2020-09-30T17:53:20Z",
+  "events": [
+    {
+      "type": "message",
+      "attributes": [
+        {
+          "key": "sender",
+          "value": "cosmos14kh20jtm3vpsxhh34lpg4g36clralearnp89u9"
+        },
+        {
+          "key": "module",
+          "value": "bank"
+        },
+        {
+          "key": "action",
+          "value": "send"
+        }
+      ]
+    },
+    {
+      "type": "transfer",
+      "attributes": [
+        {
+          "key": "recipient",
+          "value": "cosmos1hvsdf03tl6w5pnfvfv5g8uphjd4wfw2hsucxnd"
+        },
+        {
+          "key": "amount",
+          "value": "1uatom"
+        }
+      ]
+    }
+  ]
+}
+```
+
+A new Stargate response looks like this:
+
+Take note of the new Auth info fields.
+
+```json
+{
+  "height": "111102",
+  "txhash": "C29C87ED9FD1AA0DA3BDDB396EFE570FDE99D0EB24F10AAF00D46086A7284FCA",
+  "data": "0A060A0473656E64",
+  "raw_log": "[{\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"send\"},{\"key\":\"sender\",\"value\":\"cosmos1h2gacd88hkvlmz5g04md87r54kjf0klnwt25n9\"},{\"key\":\"module\",\"value\":\"bank\"}]},{\"type\":\"transfer\",\"attributes\":[{\"key\":\"recipient\",\"value\":\"cosmos1ne2g0hhejmd6gqy22erty8yt8nknygw026j72c\"},{\"key\":\"sender\",\"value\":\"cosmos1h2gacd88hkvlmz5g04md87r54kjf0klnwt25n9\"},{\"key\":\"amount\",\"value\":\"10000000umuon\"}]}]}]",
+  "logs": [
+    {
+      "events": [
+        {
+          "type": "message",
+          "attributes": [
+            {
+              "key": "action",
+              "value": "send"
+            },
+            {
+              "key": "sender",
+              "value": "cosmos1h2gacd88hkvlmz5g04md87r54kjf0klnwt25n9"
+            },
+            {
+              "key": "module",
+              "value": "bank"
+            }
+          ]
+        },
+        {
+          "type": "transfer",
+          "attributes": [
+            {
+              "key": "recipient",
+              "value": "cosmos1ne2g0hhejmd6gqy22erty8yt8nknygw026j72c"
+            },
+            {
+              "key": "sender",
+              "value": "cosmos1h2gacd88hkvlmz5g04md87r54kjf0klnwt25n9"
+            },
+            {
+              "key": "amount",
+              "value": "10000000umuon"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "gas_wanted": "200000",
+  "gas_used": "53677",
+  "tx": {
+    "body": {
+      "messages": [
+        {
+          "type": "cosmos-sdk/MsgSend",
+          "value": {
+            "from_address": "cosmos1h2gacd88hkvlmz5g04md87r54kjf0klnwt25n9",
+            "to_address": "cosmos1ne2g0hhejmd6gqy22erty8yt8nknygw026j72c",
+            "amount": [
+              {
+                "denom": "umuon",
+                "amount": "10000000"
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "auth_info": {
+      "signer_infos": [
+        {
+          "public_key": {
+            "type": "tendermint/PubKeySecp256k1",
+            "value": "AiSN1louJ7slmWEbfZWv1hmpV97PGnkwjGylRsWTFLTR"
+          },
+          "mode_info": {
+            "Sum": {
+              "type": "cosmos.tx.v1beta1.ModeInfo_Single",
+              "value": {
+                "single": {
+                  "mode": 1
+                }
+              }
+            }
+          },
+          "sequence": "13"
+        }
+      ],
+      "fee": {
+        "amount": [],
+        "gas_limit": "200000"
+      }
+    },
+    "signatures": [
+      "9QQF8c0MNlk7mAXDcB1A3Rwih5iRP2leF/mibEX+n5ssj8f6zL/JRWhPOFNOf2f2RNENhX5Ic2nN3ydcG8iz6A=="
+    ]
+  },
+  "timestamp": "2020-09-29T16:40:54Z"
+}
+```