update

Author: bucanero

docs/smart-contracts/global-contracts.md

@@ -30,7 +30,7 @@ When using a reference **by hash**, you reference the global contract by its imm
 
 Global contracts can be deployed in 2 ways: either by their hash or by the owner account ID.
 Contracts deployed by hash are effectively immutable and cannot be updated.
-When deployed by account id the owner can redeploy the contract updating it for all its users.
+When deployed by account ID the owner can redeploy the contract updating it for all its users.
 
 Global contracts can be deployed using `NEAR CLI`.
 The process is similar to [deploying a regular contract](./release/deploy.md#deploying-the-contract) but `deploy-as-global` command should be used instead of `deploy`.

docs/tools/near-api.md

@@ -1235,9 +1235,90 @@ There are two ways to reference a global contract:
   </TabItem>
   </Tabs>
 
+  </TabItem>
+
+  <TabItem value="rust" label="🦀 Rust">
+
+  <Tabs>
+  <TabItem value="account" label="By Account" default>
+
+  Let’s look at an example of deploying a global contract by account.
+  
+  To do this, use the `deploy_global_contract_code` function and use the method `as_account_id`, along with the contract’s code bytes.
+  
+  ```rust
+    let global_account_id: AccountId = "nft-contract.testnet".parse().unwrap();
+    let code = std::fs::read("path/to/your/contract.wasm").unwrap();
+    let signer = Signer::new(Signer::from_ledger()).unwrap();
+
+    let result: FinalExecutionOutcomeView = Contract::deploy_global_contract_code(code)
+        .as_account_id(global_account_id)
+        .with_signer(signer)
+        .send_to_testnet()
+        .await.unwrap();
+  ```
+
+  Once the global contract is deployed, let’s see how an end user can reference and use it in their own account. To do this, they need to call the `use_global_account_id` function and pass the source `accountId` where the contract was originally deployed.
 
+  ```rust
+    let global_account_id: AccountId = "nft-contract.testnet".parse().unwrap();
+    let my_account_id: AccountId = "my-contract.testnet".parse().unwrap();
+    let my_signer = Signer::new(Signer::from_ledger()).unwrap();
+
+    let result: FinalExecutionOutcomeView = Contract::deploy(my_account_id)
+        .use_global_account_id(global_account_id)
+        .without_init_call()
+        .with_signer(my_signer)
+        .send_to_testnet()
+        .await.unwrap();
+  ```
 
+  <a href="https://github.com/near-examples/near-api-examples/blob/adcbba98c0a957bbd3c8146e108dfefa8ed72465/rust/examples/global_contract_accountid.rs" target="_blank" rel="noreferrer noopener" class="text-center">
+    See full example on GitHub
+  </a>
   </TabItem>
+
+  <TabItem value="hash" label="By Hash" default>
+
+  Let’s look at an example of deploying a global contract by hash.
+  
+  To do this, use the `deploy_global_contract_code` function and use the method `as_hash`, along with the contract’s code bytes.
+  
+  ```rust
+    let account_id: AccountId = "my-account.testnet".parse().unwrap();
+    let code = std::fs::read("path/to/your/contract.wasm").unwrap();
+    let signer = Signer::new(Signer::from_ledger()).unwrap();
+
+    let result: FinalExecutionOutcomeView = Contract::deploy_global_contract_code(code)
+        .as_hash()
+        .with_signer(account_id, signer)
+        .send_to_testnet()
+        .await.unwrap();
+  ```
+
+  Once the global contract is deployed, let’s see how an end user can reference and use it in their own account. To do this, they need to call the `use_global_hash` function and pass the source `hash` of the original contract.
+
+  ```rust
+    let global_hash: types::CryptoHash = "DxfRbrjT3QPmoANMDYTR6iXPGJr7xRUyDnQhcAWjcoFF".parse().unwrap();
+    let account_id: AccountId = "my-contract.testnet".parse().unwrap();
+    let signer = Signer::new(Signer::from_ledger()).unwrap();
+
+    let result: FinalExecutionOutcomeView = Contract::deploy(account_id)
+        .use_global_hash(global_hash)
+        .without_init_call()
+        .with_signer(signer)
+        .send_to_testnet()
+        .await.unwrap();
+  ```
+
+  <a href="https://github.com/near-examples/near-api-examples/blob/adcbba98c0a957bbd3c8146e108dfefa8ed72465/rust/examples/global_contract_hash.rs" target="_blank" rel="noreferrer noopener" class="text-center">
+    See full example on GitHub
+  </a>
+  </TabItem>
+  </Tabs>
+
+  </TabItem>
+
 </Tabs>
 
 ---