Merge branch 'master' into xunilrj/enum-const-generics

Author: IGI-111

.github/workflows/ci.yml

@@ -903,9 +903,42 @@ jobs:
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_NOTIFY_BUILD }}
 
+  publish-sway-lib-std:
+    needs: publish
+    if: github.event_name == 'release' && github.event.action == 'published'
+    runs-on: buildjet-4vcpu-ubuntu-2204
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: ${{ env.RUST_VERSION }}
+
+      - name: Publish sway-lib-std
+        run: |
+          cd sway-lib-std
+          cargo run --locked -p forc-publish
+        env:
+          FORC_PUB_TOKEN: ${{ secrets.FORCPUB_TOKEN }}
+
+      - name: Notify if Job Fails
+        uses: ravsamhq/notify-slack-action@v2
+        if: always()
+        with:
+          status: ${{ job.status }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          notification_title: "{workflow} has {status_message}"
+          message_format: "{emoji} *{workflow}* {status_message} in <{repo_url}|{repo}> : <{run_url}|View Run Results>"
+          footer: ""
+          notify_when: "failure"
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_NOTIFY_BUILD }}
+
   build-publish-release-image:
     # Build & Publish Docker Image Per Sway Release
-    needs: publish
+    needs: [publish, publish-sway-lib-std]
     runs-on: buildjet-4vcpu-ubuntu-2204
     permissions:
       contents: read
@@ -962,7 +995,7 @@ jobs:
     name: Build and upload forc binaries to release
     runs-on: ${{ matrix.job.os }}
     if: github.event_name == 'release' && github.event.action == 'published'
-    needs: publish
+    needs: [publish, publish-sway-lib-std]
     strategy:
       matrix:
         job:

Cargo.lock

@@ -68,7 +68,39 @@ forc call \
 
 ## Usage
 
-The basic syntax for `forc call` is:
+Forc call has **3** usage modes:
+
+### List functions
+
+Syntax for `forc call` for listing supported functions from the ABI - with example command to perform call operation:
+
+```bash
+forc call --abi <ABI-PATH/URL> <CONTRACT_ID> --list-functions
+```
+
+Where the following arguments are required:
+
+- `ABI-PATH/URL` is the path or URL to the contract's JSON ABI file
+- `CONTRACT_ID` is the ID of the deployed contract you want to interact with
+
+### Transfer assets
+
+Syntax for `forc call` for transferring assets:
+
+```bash
+forc call <RECEIVER_ADDRESS> --amount <AMOUNT> --mode=live
+```
+
+Where the following arguments are required:
+
+- `RECEIVER_ADDRESS` is address of the receiver (identity or contract).
+- `AMOUNT` is the amount of assets to transfer.
+
+Note: only live mode `--mode=live` is supported; transfers cannot be simulated.
+
+### Call contracts
+
+Syntax for `forc call` for contract calls:
 
 ```bash
 forc call [OPTIONS] --abi <ABI-PATH/URL> <CONTRACT_ID> <SELECTOR> [ARGS]...

docs/book/src/testing/testing_with_forc_call.md

@@ -1,10 +1,18 @@
 use clap::Parser;
-use forc_tracing::{init_tracing_subscriber, println_error};
+use forc_tracing::{init_tracing_subscriber, println_error, TracingSubscriberOptions};
 
 #[tokio::main]
 async fn main() {
-    init_tracing_subscriber(Default::default());
     let command = forc_client::cmd::Call::parse();
+
+    // Initialize tracing with verbosity from command
+    init_tracing_subscriber(TracingSubscriberOptions {
+        verbosity: Some(command.verbosity),
+        writer_mode: Some(command.output.clone().into()),
+        regex_filter: Some("forc_tracing".to_string()),
+        ..Default::default()
+    });
+
     let operation = match command.validate_and_get_operation() {
         Ok(operation) => operation,
         Err(err) => {

forc-plugins/forc-client/src/bin/call.rs

@@ -4,7 +4,7 @@ use either::Either;
 use fuel_crypto::SecretKey;
 use fuels::programs::calls::CallParameters;
 use fuels_core::types::{Address, AssetId, ContractId};
-use std::{path::PathBuf, str::FromStr};
+use std::{io::Write, path::PathBuf, str::FromStr};
 use url::Url;
 
 pub use forc::cli::shared::{BuildOutput, BuildProfile, Minify, Pkg, Print};
@@ -57,34 +57,34 @@ pub enum OutputFormat {
     Default,
     /// Raw unformatted output
     Raw,
+    /// JSON output with full tracing information (logs, errors, and result)
+    Json,
 }
 
-/// Verbosity level for log output
-#[derive(Debug, Clone, PartialEq, Default)]
-#[repr(transparent)]
-pub struct Verbosity(pub u8);
-
-impl Verbosity {
-    /// Verbose mode (-v)
-    pub(crate) fn v1(&self) -> bool {
-        self.0 >= 1
+impl Write for OutputFormat {
+    fn write(&mut self, buf: &[u8]) -> Result<usize, std::io::Error> {
+        match self {
+            OutputFormat::Default => std::io::stdout().write(buf),
+            OutputFormat::Raw => std::io::stdout().write(buf),
+            OutputFormat::Json => Ok(buf.len()), // no-op for json
+        }
     }
 
-    /// Very Verbose mode (-vv)
-    pub(crate) fn v2(&self) -> bool {
-        self.0 >= 2
-    }
-}
-
-impl From<u8> for Verbosity {
-    fn from(level: u8) -> Self {
-        Verbosity(level)
+    fn flush(&mut self) -> Result<(), std::io::Error> {
+        match self {
+            OutputFormat::Default => std::io::stdout().flush(),
+            OutputFormat::Raw => std::io::stdout().flush(),
+            OutputFormat::Json => Ok(()),
+        }
     }
 }
 
-impl From<Verbosity> for u8 {
-    fn from(verbosity: Verbosity) -> Self {
-        verbosity.0
+impl From<OutputFormat> for forc_tracing::TracingWriter {
+    fn from(format: OutputFormat) -> Self {
+        match format {
+            OutputFormat::Json => forc_tracing::TracingWriter::Json,
+            _ => forc_tracing::TracingWriter::Stdio,
+        }
     }
 }
 
@@ -316,7 +316,7 @@ pub struct Command {
     pub external_contracts: Option<Vec<ContractId>>,
 
     /// Output format for the call result
-    #[clap(long, default_value = "default", help_heading = "OUTPUT")]
+    #[clap(long, short = 'o', default_value = "default", help_heading = "OUTPUT")]
     pub output: OutputFormat,
 
     /// Set verbosity levels; currently only supports max 2 levels