Carbon Cargo Decoder

Rust decoder for the Star Atlas Cargo program on Solana, generated using Carbon CLI.

Program Information

Program ID: Cargo2VNTPPTi9c1vq1Jw5d3BWUNr18MjRtSupAghKEk
Network: Solana Mainnet
Description: Star Atlas Cargo program for managing resource containers (pods) with dynamic stat tracking, cargo types, and token-based resource management.

Features

Decodes all Cargo account types
Full instruction parsing support
Integration with Carbon indexing framework
Permission bitflags support for cargo operations
Support for dynamic cargo stats and pod management

Usage

Add this crate to your Cargo.toml:

[dependencies]
carbon-cargo-decoder = "0.12.0"

Decoding Accounts

use carbon_cargo_decoder::{CargoDecoder, CargoAccount};
use carbon_core::account::AccountDecoder;

let decoder = CargoDecoder;
let decoded_account = decoder.decode_account(&account);

if let Some(decoded) = decoded_account {
    match decoded.data {
        CargoAccount::CargoPod(pod) => {
            println!("Cargo Pod: {:?}", pod);
            println!("Authority: {}", pod.authority);
            println!("Open Token Accounts: {}", pod.open_token_accounts);
            println!("Cargo Contents: {:?}", pod.cargo_contents);
        }
        CargoAccount::CargoType(cargo_type) => {
            println!("Cargo Type: {:?}", cargo_type);
            println!("Mint: {}", cargo_type.mint);
            println!("Stats Count: {}", cargo_type.stats_count);
            println!("Cargo Stats: {:?}", cargo_type.cargo_stats);
        }
        CargoAccount::CargoStatsDefinition(definition) => {
            println!("Stats Definition: {:?}", definition);
            println!("Authority: {}", definition.authority);
            println!("Sequence ID: {}", definition.seq_id);
        }
    }
}

Working with Permissions

The decoder includes ergonomic permission handling with bitflags:

use carbon_cargo_decoder::CargoPermissions;

// Create permissions from u64 or bytes
let perms = CargoPermissions::from_u64(0b111);

// Check individual permissions
if perms.contains(CargoPermissions::MANAGE_DEFINITION) {
    println!("Can manage cargo definitions");
}

if perms.contains(CargoPermissions::CREATE_CARGO_TYPE) {
    println!("Can create new cargo types");
}

if perms.contains(CargoPermissions::MANAGE_CARGO_TYPE) {
    println!("Can update existing cargo types");
}

// Combine permissions
let admin_perms = CargoPermissions::MANAGE_DEFINITION
    | CargoPermissions::CREATE_CARGO_TYPE
    | CargoPermissions::MANAGE_CARGO_TYPE;

// Convert to/from bytes for storage
let bytes = admin_perms.to_le_bytes();
let restored = CargoPermissions::from_le_bytes(bytes);

Account Types

This decoder supports all Cargo account types:

CargoPod - Container for resources with dynamic stat tracking
- Contains cargo_contents: Vec<u64> with the pod's cargo values
CargoType - Definition of a specific cargo type with associated stats
- Contains cargo_stats: Vec<u64> with stat values (length = stats_count)
CargoStatsDefinition - Global configuration for cargo stat definitions

Permission Flags

The CargoPermissions bitflags type includes:

MANAGE_DEFINITION - Can initialize and update cargo definitions
CREATE_CARGO_TYPE - Can create new cargo types
MANAGE_CARGO_TYPE - Can update existing cargo types

Documentation

Full documentation is available at docs.rs.

Repository

See the main repository for build instructions and contribution guidelines.

License

Licensed under the Apache-2.0 license.

carbon-cargo-decoder 0.12.1