docs(near): add near guides

Author: Reisen

target_chains/near/README.md

@@ -0,0 +1,24 @@
+# Pyth NEAR
+
+This directory contains the Pyth contract for NEAR, examples, and utilities to deploy. Within the `example/`
+directory you will find an example skeleton NEAR contract that updates and uses a price. You can find
+updates to test with from the Hermes API. Additionally see the `scripts/update.sh` script for an example
+of how to manually submit a price update from the CLI.
+
+## Deployment
+
+Deploying the NEAR contract has three steps:
+
+1. Create a NEAR key with `near generate-key`
+2. Fetch NEAR tokens from an available faucet, at last deploy around 100~ NEAR were needed.
+3. See the example deploy script in `scripts/deploy.sh` to deploy the contract. You can find a codehash by:
+   - `sha256sum pyth.wasm` after building the contract.
+   - `list(bytes.fromhex(hash))` in Python to get a byte array.
+   - Replace the `codehash` field in deploy.sh for the initial codehash.
+
+## Further Documentation
+
+You can find more in-depth documentation on the [Pyth Website][pyth website] for a more in-depth guide to
+working with Pyth concepts in general in the context of NEAR.
+
+[pyth website]: https://docs.pyth.network/documentation/pythnet-price-feeds/near

target_chains/near/receiver/deploy.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+
+# This is an example payload for deploying the NEAR receiver contract. Note that the codehash can be obtained
+# by `sha256sum` on the compiled contract. The initial and governance sources are the PythNet emitters for
+# governance payloads.
+INIT_ARGS=$(
+	cat <<-EOF
+		{
+		    "wormhole": "wormhole.wormhole.testnet",
+		    "codehash": [113, 49, 20, 252, 226, 220, 48, 15, 139, 92, 255, 117, 94, 178, 130, 162, 252, 5, 252, 188, 87, 122, 50, 175, 109, 12, 26, 189, 9, 107, 214, 116],
+		    "initial_source": {
+		        "emitter": [225, 1, 250, 237, 172, 88, 81, 227, 43, 155, 35, 181, 249, 65, 26, 140, 43, 172, 74, 174, 62, 212, 221, 123, 129, 29, 209, 167, 46, 164, 170, 113],
+		        "chain": 26
+		    },
+		    "gov_source": {
+		        "emitter": [86, 53, 151, 154, 34, 28, 52, 147, 30, 50, 98, 11, 146, 147, 164, 99, 6, 85, 85, 234, 113, 254, 151, 205, 98, 55, 173, 232, 117, 177, 46, 158],
+		        "chain": 1
+		    },
+		    "update_fee": "1",
+		    "stale_threshold": 60
+		}
+	EOF
+)
+
+# Feed through jq to get compressed JSON to avoid CLI weirdness.
+INIT_JSON=$(echo "$INIT_ARGS" | jq -c '.' -M)
+
+# Deploy..
+near deploy \
+	--accountId "pyth.testnet" \
+	--wasmFile pyth.wasm \
+	--initFunction new \
+	--initArgs "$INIT_JSON"

target_chains/near/receiver/transfers.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 
+# This is an example payload for subitting a price update from Hermes to a NEAR contract.
 UPDATE_ARGS=$(
 	cat <<-EOF
 		{
@@ -8,12 +9,14 @@ UPDATE_ARGS=$(
 	EOF
 )
 
+# Feed through jq to get compressed JSON to avoid CLI weirdness.
 UPDATE_JSON=$(echo "$UPDATE_ARGS" | jq -c '.' -M)
 
+# Submit.
 near call \
-	--accountId "780e82bd52465f8a4f5ed8cf5a30666eb41208849956bf87a377da9d8174e2b7" \
+    --accountId "780e82bd52465f8a4f5ed8cf5a30666eb41208849956bf87a377da9d8174e2b7" \
     780e82bd52465f8a4f5ed8cf5a30666eb41208849956bf87a377da9d8174e2b7 \
-	update_price_feed \
+    update_price_feed \
     --gas 300000000000000 \
     --deposit 1 \
-	--args "$UPDATE_JSON"
+    --args "$UPDATE_JSON"