delegate voucher snippets and cosmetic updates

Author: riseandshaheen

cartesi-rollups_versioned_docs/version-2.0/api-reference/backend/vouchers.md

@@ -204,7 +204,7 @@ func HandleAdvance(data *rollups.AdvanceResponse) error {
 	voucher := rollups.VoucherRequest{
 		Destination: "0x784f0c076CC55EAD0a585a9A13e57c467c91Dc3a", // sample ERC-20 token
 		Payload:     callData,
-		Value:       "0x0",
+		Value:       "0x00",
 	}
 
 	if _, err := rollups.SendVoucher(&voucher); err != nil {
@@ -235,7 +235,7 @@ std::string handle_advance(httplib::Client &cli, picojson::value data)
     picojson::object voucher;
     voucher["destination"] = picojson::value("0x784f0c076CC55EAD0a585a9A13e57c467c91Dc3a");
     voucher["payload"] = picojson::value(call_data);
-    voucher["value"] = picojson::value("0x0");
+    voucher["value"] = picojson::value("0x00");
 
     auto response = cli.Post(
         "/voucher",
@@ -295,6 +295,9 @@ This mechanism, where the Application contract maintains the state and funds whi
 
 - **Ordered Vouchers**: Vouchers that must be executed in a specific sequence. For example, voucher A can only be executed after voucher B has been executed.
 
+The examples below emit a DELEGATECALL voucher by posting to `/delegate-call-voucher`.  
+In these snippets, `destination` is the contract that contains the logic to run, while `payload` is the ABI-encoded function call data (for example, `safeTransfer(address,address,uint256)`).
+
 <Tabs>
   <TabItem value="JavaScript" label="JavaScript" default>
 <pre><code>
@@ -352,6 +355,56 @@ def emit_safe_erc20_transfer(token, to, amount):
 </code></pre>
 </TabItem>
 
+<TabItem value="Rust" label="Rust">
+<pre><code>
+
+```rust
+use ethers_core::abi::{Function, Param, ParamType, StateMutability, Token};
+use json::object;
+
+pub async fn emit_safe_erc20_transfer(
+    client: &hyper::Client<hyper::client::HttpConnector>,
+    server_addr: &str,
+    token: &str,
+    to: &str,
+    amount: u64,
+) -> Result<(), Box<dyn std::error::Error>> {
+    let safe_transfer = Function {
+        name: "safeTransfer".to_string(),
+        inputs: vec![
+            Param { name: "token".to_string(), kind: ParamType::Address, internal_type: None },
+            Param { name: "to".to_string(), kind: ParamType::Address, internal_type: None },
+            Param { name: "amount".to_string(), kind: ParamType::Uint(256), internal_type: None },
+        ],
+        outputs: vec![],
+        constant: None,
+        state_mutability: StateMutability::NonPayable,
+    };
+
+    let payload_bytes = safe_transfer.encode_input(&[
+        Token::Address(token.parse()?),
+        Token::Address(to.parse()?),
+        Token::Uint(amount.into()),
+    ])?;
+
+    let voucher = object! {
+        destination: "0xfafafafafafafafafafafafafafafafafafafafa", // address of the contract containing the logic
+        payload: format!("0x{}", hex::encode(payload_bytes)),
+    };
+
+    let request = hyper::Request::builder()
+        .method(hyper::Method::POST)
+        .header(hyper::header::CONTENT_TYPE, "application/json")
+        .uri(format!("{}/delegate-call-voucher", server_addr))
+        .body(hyper::Body::from(voucher.dump()))?;
+    client.request(request).await?;
+    Ok(())
+}
+```
+
+</code></pre>
+</TabItem>
+
 <TabItem value="Go" label="Go">
 <pre><code>
 
@@ -409,6 +462,50 @@ func emitSafeERC20Transfer(token, to common.Address, amount *big.Int) error {
 }
 ```
 
+</code></pre>
+</TabItem>
+
+<TabItem value="C++" label="C++">
+<pre><code>
+
+```cpp
+#include <string>
+
+#include "3rdparty/cpp-httplib/httplib.h"
+#include "3rdparty/picojson/picojson.h"
+
+std::string emit_safe_erc20_transfer(
+    httplib::Client &cli,
+    const std::string &token,
+    const std::string &to,
+    const std::string &amount_hex_32bytes
+)
+{
+    // safeTransfer(address,address,uint256)
+    const std::string selector = "eb795549";
+    const std::string token_word = "000000000000000000000000" + token.substr(2);
+    const std::string to_word = "000000000000000000000000" + to.substr(2);
+    const std::string payload = "0x" + selector + token_word + to_word + amount_hex_32bytes;
+
+    picojson::object voucher;
+    voucher["destination"] = picojson::value("0xfafafafafafafafafafafafafafafafafafafafa");
+    voucher["payload"] = picojson::value(payload);
+
+    auto response = cli.Post(
+        "/delegate-call-voucher",
+        picojson::value(voucher).serialize(),
+        "application/json"
+    );
+
+    if (!response || response->status >= 400)
+    {
+        return "error";
+    }
+
+    return "ok";
+}
+```
+
 </code></pre>
 </TabItem>
 </Tabs>

cartesi-rollups_versioned_docs/version-2.0/development/snippets/asset_withdraw_erc20_cpp.md

@@ -20,7 +20,7 @@ std::string handle_advance(httplib::Client &cli, picojson::value data)
     picojson::object voucher;
     voucher["destination"] = picojson::value(kErc20TokenAddress);
     voucher["payload"] = picojson::value(call_data);
-    voucher["value"] = picojson::value("0x0");
+    voucher["value"] = picojson::value("0x00");
 
     auto response = cli.Post(
         "/voucher",

cartesi-rollups_versioned_docs/version-2.0/development/snippets/asset_withdraw_erc20_go.md

@@ -26,7 +26,7 @@ func HandleAdvance(data *rollups.AdvanceResponse) error {
 	voucher := rollups.VoucherRequest{
 		Destination: erc20TokenAddress,
 		Payload:     callData,
-		Value:       "0x0",
+		Value:       "0x00",
 	}
 
 	if _, err := rollups.SendVoucher(&voucher); err != nil {

cartesi-rollups_versioned_docs/version-2.0/development/snippets/implementing_outputs_go.md

@@ -73,7 +73,7 @@ func HandleAdvance(data *rollups.AdvanceResponse) error {
 	}
 	voucher := rollups.VoucherRequest{
 		Destination: tokenAddress,
-		Value:       "0x0",
+		Value:       "0x00",
 		Payload:     voucherPayload,
 	}
 	if _, err = rollups.SendVoucher(&voucher); err != nil {

cartesi-rollups_versioned_docs/version-2.0/tutorials/calculator.md

@@ -1,12 +1,12 @@
 ---
 id: calculator
-title: Build a calculator dApp
+title: Build a Calculator Application
 resources:
   - url: https://github.com/Mugen-Builders/calculator
-    title: Source code for the Calculator dApp
+    title: Source code for the Calculator App
 ---
 
-In this tutorial, we will build a simple Calculator dApp to illustrate how requests are sent and processed within Cartesi Rollups Infrastructure.
+In this tutorial, we will build a simple Calculator application to illustrate how requests are sent and processed within Cartesi Rollups Infrastructure.
 
 We provide JavaScript, Python, Rust, Go, and C++ implementations so you can use your preferred backend language.
 

cartesi-rollups_versioned_docs/version-2.0/tutorials/counter.md

@@ -1,9 +1,9 @@
 ---
 id: counter
-title: Build a counter Application
+title: Build a Counter Application
 resources:
   - url: https://github.com/Mugen-Builders/Counter-X-Marketplace-apps
-    title: Source code for the counter Application
+    title: Source code for the Counter Application
 ---
 
 This tutorial aims to guide you through creating and interacting with a basic Cartesi application, it'll take you through setting up your dev environment, creating a project then finally running and interacting with your application locally.

cartesi-rollups_versioned_docs/version-2.0/tutorials/marketplace.md

@@ -1,9 +1,9 @@
 ---
 id: marketplace
-title: Build a marketplace Application
+title: Build a Marketplace Application
 resources:
   - url: https://github.com/Mugen-Builders/Counter-X-Marketplace-apps
-    title: Source code for the marketplace Application
+    title: Source code for the Marketplace Application
 ---
 
 In this tutorial we'll be building a simple NFT Marketplace application, where users are able to deposit a unique token to be sold at a fixed price, then other users are able to purchase and withdraw these purchased tokens to their wallet.

cartesi-rollups_versions.json

@@ -1,8 +1,4 @@
 [
   "2.0",
-  "1.5",
-  "1.3",
-  "1.0",
-  "0.9",
-  "0.8"
+  "1.5"
 ]