tiny improvements

Author: aditya520

pages/price-feeds/use-real-time-data/sui.mdx

@@ -6,7 +6,7 @@ This guide explains how to use real-time Pyth data in Sui applications.
 
 ## Install Pyth SDK
 
-Use the following dependency in your `Move.toml` file to use the latest Pyth Sui package and its dependencies.
+Use the following dependency in your `Move.toml` file to use the latest Pyth Sui package and its dependencies:
 
 <Tabs items={['Mainnet', 'Testnet']}>
 <Tabs.Tab>
@@ -21,6 +21,8 @@ git = "https://github.com/wormhole-foundation/wormhole.git"
 subdir = "sui/wormhole"
 rev = "sui-upgrade-mainnet"
 
+# Pyth is locked into this specific `rev` because our package depends on Wormhole and is pinned to this version.
+
 [dependencies.Sui]
 git = "https://github.com/MystenLabs/sui.git"
 subdir = "crates/sui-framework/packages/sui-framework"
@@ -40,6 +42,7 @@ git = "https://github.com/wormhole-foundation/wormhole.git"
 subdir = "sui/wormhole"
 rev = "sui-upgrade-testnet"
 
+# Pyth is locked into this specific `rev` because our package depends on Wormhole and is pinned to this version.
 [dependencies.Sui]
 git = "https://github.com/MystenLabs/sui.git"
 subdir = "crates/sui-framework/packages/sui-framework"
@@ -49,7 +52,7 @@ rev = "041c5f2bae2fe52079e44b70514333532d69f4e6"
 </Tabs.Tab>
 </Tabs>
 
-Pyth provides a javascript SDK to construct transaction blocks that update price feeds.
+Pyth also provides a javascript SDK to construct transaction blocks that update price feeds:
 
 <Tabs items={["npm", "yarn"]}>
   <Tabs.Tab>
@@ -64,7 +67,7 @@ Pyth provides a javascript SDK to construct transaction blocks that update price
 
 Your Sui Move module **should NOT** have a hard-coded call to `pyth::update_single_price_feed.` In other words, a contract should **never call** the Sui Pyth `pyth::update_single_price_feed` entry point. Instead, it should be called directly from client code (e.g., Typescript or Rust).
 
-This is because the new address differs from the original when a Sui contract is [upgraded](https://docs.sui.io/build/package-upgrades). If your module has a hard-coded call to `pyth::update_single_price_feed` living at a fixed call-site, it may eventually get bricked due to how Pyth upgrades are implemented. (We only allow users to interact with the most recent package version for security reasons).
+When Sui contracts are [upgraded](<(https://docs.sui.io/build/package-upgrades)>), the address changes, which makes the old address no longer valid. If your module has a hard-coded call to `pyth::update_single_price_feed` living at a fixed call-site, it may eventually get bricked due to how Pyth upgrades are implemented. (We only allow users to interact with the most recent package version for security reasons).
 
 Therefore, you should build a [Sui programmable transaction](https://docs.sui.io/build/prog-trans-ts-sdk) that first updates the price by calling `pyth::update_single_price_feed` at the latest call-site from the client-side and then call a function in your contract that invokes `pyth::get_price` on the `PriceInfoObject` to get the recently updated price.
 You can use `SuiPythClient` to build such transactions and handle all the complexity of updating the price feeds.
@@ -187,27 +190,8 @@ You may find these additional resources helpful for developing your Sui applicat
 
 ### Contract Addresses
 
-Developers will need the Pyth package IDs to use Pyth.
-Please consult [Sui Contract Addresses](../contract-addresses/sui) to find the package IDs for your blockchain.
-
-## Common Questions on How to Integrate with Pyth on Sui
-
-### What is up with the "sui rev"? Why does it point to a specific commit hash instead of "main" or "devnet"?
-
-Our Pyth `Move.toml` depends on specific versions of the [Sui Framework](https://github.com/MystenLabs/sui) as well as [Wormhole](https://github.com/wormhole-foundation/wormhole).
-To make your Sui package compatible, you must also specify the following dependencies verbatim in your `Move.toml` file. We are locked in to this specific `rev` because our package depends on Wormhole and it is pinned to this
-version.
-
-```sh copy
-[dependencies.Sui]
-git = "https://github.com/MystenLabs/sui.git"
-subdir = "crates/sui-framework/packages/sui-framework"
-rev = "041c5f2bae2fe52079e44b70514333532d69f4e6"
-```
-
-### How do I find the Sui Object ID of a PriceInfoObject for a Pyth Price Feed?
+Consult [Sui Contract Addresses](../contract-addresses/sui) to find the package IDs.
 
-You can use the `getPriceFeedObjectId` function in the js sdk to fetch the object ids.
-This mapping is also stored on-chain, and can be queried on-chain using the getter function `pyth::state::get_price_info_object_id` defined in the Pyth package.
+### Pyth Price Feed IDs
 
-Also recall that the list of Pyth price feed IDs can be found [here](https://pyth.network/developers/price-feed-ids).
+Consult [Pyth Price Feed IDs](https://pyth.network/developers/price-feed-ids) to find Pyth price feed IDs for various assets.