FIX: Updated links for Endpoints, PRFCs and very_light client

Author: parallelchainlab

docs/getting_started/contract_publish.md

@@ -18,7 +18,6 @@ The ParallelChain F smart contract publishing service provides a platform for sm
 
 1. The service generates identity verification bytes using the contract address and transaction hash provided by the user.
 2. The user then signs the ID bytes with the help of our `very_light` client using the instructions on the front end which generates a signature.
-3. The back end accepts the signature, github link and commit SHA of the source code, builds the  
-   source code with `pchain_compile` and verifies the generated binary against that existing on ParallelChain F. The service returns Status Code 200 
+3. The back end accepts the signature, github link and commit SHA of the source code, builds the source code with `pchain_compile` and verifies the generated binary against that existing on ParallelChain F. The service returns Status Code 200 
    to the user if the contract is successfully verified.
 

docs/getting_started/installation.md

@@ -17,7 +17,7 @@ Throughout the section [Getting Started](installation.md), we will describe how
 ## For Windows 
 ---
 
-Download the compressed zip file from [https://cms.parallelchain.io/parallelchain-very-light_win_v0.1.0.zip](https://cms.parallelchain.io/parallelchain-very-light_win_v0.1.0.zip)
+Download the compressed zip file from [https://cms.parallelchain.io/parallelchain-very-light_win_v0.2.0.zip](https://cms.parallelchain.io/parallelchain-very-light_win_v0.2.0.zip)
 
 Unzip the file to extract the executable `pchain.exe`. 
 
@@ -43,26 +43,26 @@ Open up `PowerShell` using the `run` keyboard shortcut. That is *WIN+R* and type
 
 Unzip the compressed zip file by `Expand-Archive`. Please specify the source path and destination path for your command parameters:
 
--  `<SOURCE_PATH>`: the directory where `parallelchain-very-light_win_v0.1.0.zip` is located.
+-  `<SOURCE_PATH>`: the directory where `parallelchain-very-light_win_v0.2.0.zip` is located.
 -  `<DESTINATION_PATH>`: the directory you intend to install `pchain`. 
 
 ```PowerShell
-Expand-Archive -LiteralPath 'C:\<SOURCE_PATH>\parallelchain-very-light_win_v0.1.0.zip' -DestinationPath 'C:\<DESTINATION_PATH>\parallelchain-very-light_win_v0.1.0.exe'
+Expand-Archive -LiteralPath 'C:\<SOURCE_PATH>\parallelchain-very-light_win_v0.2.0.zip' -DestinationPath 'C:\<DESTINATION_PATH>\parallelchain-very-light_win_v0.2.0.exe'
 ```
 
 To switch the operating mode of `PowerShell` from a normal mode to administrator mode:
 ```PowerShell
 Start-Process powershell -Verb runAs
 ```
 
-Head to the destination directory where `parallelchain-very-light_win_v0.1.0.exe` is extracted:
+Head to the destination directory where `parallelchain-very-light_win_v0.2.0.exe` is extracted:
 ```PowerShell
 Set-Location C:\<DESTINATION_PATH>\
 ```
 
 In the destination directory (`<DESTINATION_PATH>`), it is suggested to rename the binary to `pchain` so that it becomes easier to follow this guide:
 ```PowerShell
-Rename-Item -Path 'parallelchain-very-light_win_v0.1.0.exe' -NewName 'pchain.exe'
+Rename-Item -Path 'parallelchain-very-light_win_v0.2.0.exe' -NewName 'pchain.exe'
 ```
 
 Run the command `pchain` to see if it launches.
@@ -73,7 +73,7 @@ pchain.exe
   <summary>To verify that the Light Client works</summary>
     pchain is now an executable from anywhere on your system
     ```bash
-    verylight 0.1.0
+    verylight 0.2.0
     <Parallel Chain Lab>
     Parallel Chain Mainnet verylight
     ```
@@ -100,26 +100,26 @@ To download the precompiled compressed binaries, use:
 
 === "Linux"
     ```bash
-    wget https://cms.parallelchain.io/parallelchain-very-light_linux_v0.1.0.tar.xz
+    wget https://cms.parallelchain.io/parallelchain-very-light_linux_v0.2.0.tar.xz
     ```
 === "macOS"
     ```bash
-    curl -O https://cms.parallelchain.io/parallelchain-very-light_mac_x86_v0.1.0.tar.xz
+    curl -O https://cms.parallelchain.io/parallelchain-very-light_mac_x86_v0.2.0.tar.xz
     ```
 
-To extract the client program, head to the directory where the downloaded file `parallelchain-very-light_linux_v0.1.0.tar.xz` or  `parallelchain-very-light_mac_x86_v0.1.0.tar.xz` is located and extract via `tar`:
+To extract the client program, head to the directory where the downloaded file `parallelchain-very-light_linux_v0.2.0.tar.xz` or  `parallelchain-very-light_mac_x86_v0.2.0.tar.xz` is located and extract via `tar`:
 === "Linux"
     ```bash
-    tar -xvf parallelchain-very-light_linux_v0.1.0.tar.xz 
+    tar -xvf parallelchain-very-light_linux_v0.2.0.tar.xz 
     ```
 === "macOS"
     ```bash
-    tar -xvf parallelchain-very-light_mac_x86_v0.1.0.tar.xz
+    tar -xvf parallelchain-very-light_mac_x86_v0.2.0.tar.xz
     ```
 
 Rename the client program to `pchain` so that it becomes easier to follow this guide:
 ```bash
-mv parallelchain-very-light_linux_v0.1.0 pchain
+mv parallelchain-very-light_linux_v0.2.0 pchain
 ```
 
 Run the command `pchain` to see if it launches.
@@ -149,7 +149,7 @@ Run the command `pchain` to see if it launches.
 <details>
   <summary>To verify that the Light Client works</summary>
     ```bash
-    verylight 0.1.0
+    verylight 0.2.0
     <Parallel Chain Lab>
     Parallel Chain Mainnet verylight
     ```

docs/getting_started/prepare_env.md

@@ -15,14 +15,14 @@ If the link above is working, type the command below to configure `pchain` to co
     ```bash
     ./pchain set config 
       --target-url https://node1.digital-transaction.net 
-      --rich-api-url https://node1.digital-transaction.net/api 
+      --rich-api-url https://node1.digital-transaction.net:33356 
       --analytics-api-url https://node1.digital-transaction.net/analytics
     ```
 === "Windows"
     ```PowerShell
     pchain.exe set config 
       --target-url https://node1.digital-transaction.net 
-      --rich-api-url https://node1.digital-transaction.net/api 
+      --rich-api-url https://node1.digital-transaction.net:33356 
       --analytics-api-url https://node1.digital-transaction.net/analytics
     ```
 
@@ -32,5 +32,3 @@ This command will write a config.json file in `$HOME/.parallelchain/pchain_cli/c
 To verify that our testnet is live and running, please make sure that the following URL is working by clicking on the link below:
 
 * [https://node1.digital-transaction.net](https://node1.digital-transaction.net) 
-* [https://node1.digital-transaction.net/api](https://node1.digital-transaction.net/api)
-* [https://node1.digital-transaction.net/analytics](https://node1.digital-transaction.net/analytics)  

docs/smart_contract_sdk/PRFC1.md

@@ -2,7 +2,7 @@
 
 | PRFC | Title | Author | Version | Date First Published |
 | --- | ----- | ---- | --- | --- |
-| 1   | Fungible Token Standard | ParallelChain Lab | 1 | July 7th, 2022 | 
+| 1   | Fungible Token Standard | ParallelChain Lab | 3 | July 23rd, 2022 | 
 
 ## Summary
 
@@ -12,108 +12,91 @@ A standard contract interface for fungible tokens allows more seamless interoper
 
 The below section lists the set of methods that all smart contracts that want to be PRFC 1-compliant must implement, as well as  the behavior that each method must exhibit. Required behavior involves emitting certain events. These are also listed and described.
 
-## Required Methods 
+## Required types 
 
-Note: the following uses syntax from Rust (version 1.59.0).
+```rust
+struct Token {
+    name: String,
+    symbol: String,
 
-**ACTION** 
+    // the number of decimals that should be divided from a token amount (such as that returned by method
+    // 'balance_of') to get its user representation. i.e., `n` means to divide the token amount by `10^n`.
+    decimals: u8,
 
-`fn transfer(to_address: protocol_types:Public_Address, value: u64)`
+    // ‘Supply’ here means the sum of token balances over *all* addresses at any given point of time.
+    // Total supply may increase, for example, when new tokens are minted, or decrease, for example,
+    // when tokens are burned.
+    total_supply: u64
+}
+```
 
-'transfer' transfers 'value' tokens to address 'to_address' from the account identified by txn.from_address.
+## Required Views 
 
-Transfer must panic if txn.from_address's balance is less than amount.
-
-Event `Transfer` must be emitted if 'transfer' is successful.
+The following uses syntax from Rust (version 1.59.0).
 
+### `fn token() -> Token`
 
-**ACTION** 
+Returns information about the Token implemented by this contract.
 
-`fn transfer_from(from_address: protocol_types:Public_Address, to_address: protocol_types:Public_Address, value: u64)`
+### `fn allowance(owner: PublicAddress, spender: PublicAddress) -> u64`
 
-'transfer_from' transfers 'amount' tokens to address 'to_address' on behalf of ‘owner’.
+Returns the number of tokens currently in spender's allowance that they can spend on ‘owner’s’ behalf.
 
-transfer_from must panic if get_allowance_from(owner) < value.
+### `fn balance_of(address: PublicAddress) -> u64`
 
-Event `Transfer` must trigger if ‘transfer_from’ is successful. Note that the value of the `Transfer` event should contain the owner address, not txn.from_address.
+Queries the balance for an owner account 'address'.
 
 
-**ACTION** 
-
-`fn set_allowance(spender: PublicAddress, value: u64)`
-
-'set_allowance' allows 'spender' to withdraw from your account multiple times, up to 'value' amount. If this function is called again it overwrites the current allowance with 'value'.
+## Required Actions
 
-set_allowance must panic if txn.from_address's balance is less than 'value'.
+### `fn transfer(to_address: Option<Public_Address>, amount: u64)`
 
-Event `SetAllowance` must be emitted if set_allowance is successful.
+'transfer' transfers 'amount' tokens to address 'to_address' from the account identified by txn.from_address. If `to_address` is None, this burns the amount.
 
+Transfer must panic if txn.from_address's balance is less than amount.
 
-**VIEW** 
+Event `Transfer` must be emitted if 'transfer' is successful.
 
-`fn get_allowance(owner: PublicAddress, spender: PublicAddress) -> u64`
 
-‘get_allowance’ returns the number of tokens currently in spender's allowance that they can spend on ‘owner’s’ behalf.
+### `fn transfer_from(from_address: PublicAddress, to_address: Option<PublicAddress>, value: u64)`
 
+'transfer_from' transfers 'amount' tokens to address 'to_address' on behalf of ‘owner’. If `to_address` is None, this burns the amount.
 
-**VIEW**
+transfer_from must panic if get_allowance_from(owner) < value.
 
-`fn total_supply() -> u64`
+Event `Transfer` must trigger if ‘transfer_from’ is successful. Note that the value of the `Transfer` event must contain the owner address, not txn.from_address.
 
-'total_supply' returns the total token supply. ‘Supply’ here means the sum of token balances over *all* addresses at any given point of time. Total supply may increase, for example, when new tokens are minted, or decrease, for example, when tokens are burned. PRFC 1 has no opinion about how to implement minting and burning, nor does not require that contracts implement them.
 
+### `fn set_allowance(spender: PublicAddress, value: u64)`
 
-**VIEW** 
+'set_allowance' allows 'spender' to withdraw from your account multiple times, up to 'value' amount. If this function is called again it overwrites the current allowance with 'value'.
 
-`fn balance_of(address: PublicAddress) -> u64`
+set_allowance must panic if txn.from_address's balance is less than 'value'.
 
-'balance_of' queries the balance for an owner account 'address'.
+Event `SetAllowance` must be emitted if set_allowance is successful.
 
 ## Required Events
 
-`Transfer`
+In this section, `++` denotes bytes concatenation.
+
+### `Transfer`
 
 | Field | Value |
 | ----- | ----- |
-| Topic | `0u8` |
-| Value | `owner_address: PublicAddress \|\| recipient_address: PublicAddress` |
+| Topic | `0u8 ++ owner_address ++ recipient_address: Option<PublicAddress>`  |
+| Value | `amount` |
 
 Gets emitted on successful token transfer through methods 'transfer' and 'transfer_from'.
 
-`SetAllowance`
+### `SetAllowance`
 
 | Field | Value |
 | ----- | ----- |
-| Topic | `1u8` |
-| Value | `owner_address: PublicAddress \|\| spender_address: PublicAddress` |
+| Topic | `1u8 ++ owner_address ++ spender_address` |
+| Value | `amount` |
 
 Gets triggered on successful delegation of tokens through method 'set_allowance'. 
 
-## Optional Methods 
-
-**VIEW**
-
-`fn name() -> String`
-
-'name' returns the name of the token.
-
-**VIEW**
-
-`fn symbol() -> String`
-
-'symbol' returns the symbol of the token.
-
-**VIEW**
-
-`fn decimals() -> u8`
-
-'decimals' returns the number of decimals that should be divided from a token amount (such as that returned by method 'balance_of') to get its user representation. i.e., `n` means to divide the token amount by `10^n`.
-
-## Implementation 
-
-An example smart contract implementing the token standard is available.
-See [here](https://github.com/parallelchain-io/example-smart-contracts).
-
 ## License
 
 [GNU Public License 3](https://www.gnu.org/licenses/gpl-3.0.en.html).