xforth 0.1.0

CLI tool for bootstrapping x402 Solana projects.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use clap::{Parser, Subcommand};
use anyhow::Result;

mod init;
mod fund;
mod test;
mod utils;

#[derive(Parser)]
#[command(name = "xforth")]
#[command(version = "0.1.0")]
#[command(about = "CLI tool for bootstrapping x402 Solana projects in under 90 seconds", long_about = None)]
struct Cli {
    #[command(subcommand)]
    command: Commands,

    /// Override RPC endpoint
    #[arg(long, global = true)]
    rpc: Option<String>,

    /// Use local Solana validator
    #[arg(long, global = true)]
    local: bool,

    /// Disable colored output
    #[arg(long, global = true)]
    no_color: bool,

    /// Output in JSON format
    #[arg(long, global = true)]
    json: bool,
}

#[derive(Subcommand)]
enum Commands {
    /// Initialize a new x402 project
    Init {
        /// Project name (default: "my-x402-agent")
        #[arg(default_value = "my-x402-agent")]
        name: String,
    },
    /// Fund wallets with SOL and mint test tokens
    Fund,
    /// Validate payment flow with a test transaction
    Test,
}

#[tokio::main]
async fn main() -> Result<()> {
    let cli = Cli::parse();

    // Set global config
    if cli.no_color {
        colored::control::set_override(false);
    }

    let rpc_url = if cli.local {
        "http://127.0.0.1:8899".to_string()
    } else {
        cli.rpc.unwrap_or_else(|| "https://api.devnet.solana.com".to_string())
    };

    match cli.command {
        Commands::Init { name } => {
            init::run(&name, &rpc_url, cli.json).await?;
        }
        Commands::Fund => {
            fund::run(&rpc_url, cli.json).await?;
        }
        Commands::Test => {
            test::run(&rpc_url, cli.json).await?;
        }
    }

    Ok(())
}