feat(auth): add funds transfer functionality (#186)

Introduce funds transfer between teams in auth module. Includes new CLI command, GraphQL query, and bigint support.

Author: steebchen

.gitignore

@@ -1,3 +1,4 @@
 /target
 torii.toml
 katana.toml
+.envrc

Cargo.lock

@@ -22,3 +22,4 @@ serde_json = "1.0.133"
 thiserror = "1.0.32"
 url = "2.2.2"
 starknet = "0.12.0"
+num-bigint = "0.4.3"

Cargo.toml

@@ -1,6 +1,7 @@
 use self::{email::EmailArgs, info::InfoArgs, login::LoginArgs};
 use crate::command::auth::billing::BillingArgs;
 use crate::command::auth::fund::FundArgs;
+use crate::command::auth::transfer::TransferArgs;
 use anyhow::Result;
 use clap::Subcommand;
 
@@ -10,6 +11,7 @@ mod fund;
 mod info;
 mod login;
 mod session;
+mod transfer;
 
 #[derive(Subcommand, Debug)]
 pub enum Auth {
@@ -28,6 +30,9 @@ pub enum Auth {
     #[command(about = "Fund the authenticated user's account.")]
     Fund(FundArgs),
 
+    #[command(about = "Transfer funds to a slot team.")]
+    Transfer(TransferArgs),
+
     // Mostly for testing purposes, will eventually turn it into a library call from `sozo`.
     #[command(hide = true)]
     CreateSession(session::CreateSession),
@@ -42,6 +47,7 @@ impl Auth {
             Auth::SetEmail(args) => args.run().await,
             Auth::EnableSlotBilling(args) => args.run().await,
             Auth::Fund(args) => args.run().await,
+            Auth::Transfer(args) => args.run().await,
         }
     }
 }

cli/src/command/auth/mod.rs

@@ -0,0 +1,42 @@
+use anyhow::Result;
+use clap::Args;
+use slot::graphql::auth::{transfer::*, Transfer};
+use slot::graphql::GraphQLQuery;
+use slot::{api::Client, credential::Credentials};
+
+#[derive(Debug, Args)]
+#[command(next_help_heading = "Transfer")]
+pub struct TransferArgs {
+    #[arg(help = "The team name to transfer funds to.", value_name = "team")]
+    pub team: String,
+
+    #[arg(help = "The amount to transfer.", value_name = "amount")]
+    pub amount: f64,
+}
+
+impl TransferArgs {
+    pub async fn run(&self) -> Result<()> {
+        let credentials = Credentials::load()?;
+        let client = Client::new_with_token(credentials.access_token);
+
+        let request_body = Transfer::build_query(Variables {
+            transfer: TransferInput {
+                amount: self.amount,
+                team: self.team.clone(),
+            },
+        });
+        let res: ResponseData = client.query(&request_body).await?;
+
+        println!("Transferred ${} to {}", self.amount, self.team);
+        println!(
+            "User balance: ${} -> ${}",
+            res.transfer.account_before, res.transfer.account_after
+        );
+        println!(
+            "Team balance: ${} -> ${}",
+            res.transfer.team_before, res.transfer.team_after
+        );
+
+        Ok(())
+    }
+}

cli/src/command/auth/transfer.rs

@@ -29,6 +29,7 @@ hyper.workspace = true
 
 account_sdk = { git = "https://github.com/cartridge-gg/controller", rev = "61d2fd0" }
 base64 = "0.22.1"
+num-bigint = "0.4.6"
 
 [dev-dependencies]
 assert_matches = "1.5.0"