wealthineer-program-metadata 0.1.0

A CLI tool for Solana metadata operations
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

# Metadata Rust CLI

This CLI is used to interact with the metadata program.

## Usage

```bash
program-metadata [SUBCOMMAND]
```

### Commands

#### IDL Management

```bash
# Upload an IDL from local file
program-metadata idl upload <IDL_PATH> <PROGRAM_ID> [OPTIONS]

# Upload an IDL from URL
program-metadata idl upload-url <URL> <PROGRAM_ID> [OPTIONS]

# Download an IDL
program-metadata idl download <PROGRAM_ID> [OUTPUT_PATH]

Options:
  -k, --keypair <PATH>           Path to keypair file (optional, defaults to config)
  -p, --priority-fees <NUMBER>   Priority fees per compute unit (default: 0)
  --help                         Print help information
```

#### Metadata Management

```bash
# Upload metadata from local file
program-metadata metadata upload <METADATA_PATH> <PROGRAM_ID> [OPTIONS]

# Upload metadata from URL
program-metadata metadata upload-url <URL> <PROGRAM_ID> [OPTIONS]

# Download metadata
program-metadata metadata download <PROGRAM_ID> [OUTPUT_PATH]

Options:
  -k, --keypair <PATH>           Path to keypair file (optional, defaults to config)
  -p, --priority-fees <NUMBER>   Priority fees per compute unit (default: 0)
  --help                         Print help information
```

Examples:

```bash
# Upload IDL using default keypair
program-metadata idl upload ./target/idl/my_program.json GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7JuSGbpwGY8dxKt6Kj

# Upload IDL from URL with custom keypair and priority fees
program-metadata idl upload-url https://example.com/my_idl.json GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7JuSGbpwGY8dxKt6Kj -k ./my-keypair.json -p 1000

# Upload metadata using default keypair
program-metadata metadata upload ./metadata.json GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7JuSGbpwGY8dxKt6Kj

# Download IDL to default path (idl.json)
program-metadata idl download GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7Ju

# Upload metadata from URL
program-metadata metadata upload-url https://example.com/metadata.json GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7JuSGbpwGY8dxKt6Kj

# Download metadata to custom path
program-metadata metadata download GrAkz4CQ4zKm9KhZ9Q7PkCmqDP7JuSGbpwGY8dxKt6Kj ./my-metadata.json
```

## Testing the Rust CLI against a local validator from within this repository

Start your local validator:

```bash
solana-test-validator --reset
```

Make sure you point your cluster to localnet and fix the program id in `Anchor.toml`.
Fix the program id in `programs/upload-idl-program/src/lib.rs` and `rust_cli/src/codama_sdk/programs.rs`.
Deploy the metadata program using anchor:

```bash
anchor build
anchor deploy
```

Airdrop SOL to your keypair - make sure to point your solana cli to localnet:

```bash
solana config set --url localhost
solana airdrop 20 -k tests/wallet.json  
```

Deploy any program using the keypair in `tests/wallet.json`:

```bash
 solana program deploy <path/to/any-program>.so -k tests/wallet.json
```

Run the CLI upload for the program you just deployed:

```bash
cargo run -- idl upload tests/testidl.json <program-id> -k tests/wallet.json -p 0
```