# nikkkitosss/solana-cossack-game architecture

> Architecture diagram of the GitHub repository nikkkitosss/solana-cossack-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nikkkitosss/solana-cossack-game
- Repository: https://github.com/nikkkitosss/solana-cossack-game

## Overview

Cossack Business is a six-program Solana game economy. Players register and search for resources; crafting consumes recipe inputs to create item NFTs; marketplace listings escrow NFTs and purchases burn the NFT while rewarding the seller with MAGIC. Resource management owns resource-token configuration and authorized mint/burn. Edges follow README-described flows and excerpted handlers; unsampled listing, registration, and burn implementation details are not inferred.

Main entry points: [`programs/search/src/instructions/search_resources.rs`](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/instructions/search_resources.rs) (Search Resources), [`programs/crafting/src/instructions/craft_item.rs`](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/crafting/src/instructions/craft_item.rs) (Craft Item), [`programs/marketplace/src/instructions/buy_item.rs`](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/buy_item.rs) (Buy Item), [`programs/item_nft/src/instructions/mint_item_nft.rs`](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/instructions/mint_item_nft.rs) (Mint Item NFT)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Player Activity"]
  node_register["Register Player<br/>[register_player.rs]"]
  node_search["Search Resources"]
  node_random["Resource Selection<br/>[randomness.rs]"]
  node_playerstate[("Player Account<br/>[player_account.rs]")]
end

subgraph group_craft["Crafting and Items"]
  node_crafting["Craft Item<br/>[craft_item.rs]"]
  node_recipes["Item Recipes<br/>[recipes.rs]"]
  node_nftmint["Mint Item NFT<br/>[mint_item_nft.rs]"]
  node_nftburn["Burn Item NFT<br/>[burn_item_nft.rs]"]
  node_metadata[("Item Metadata<br/>[item_metadata.rs]")]
  node_metaplex["NFT Metadata CPI<br/>[metaplex.rs]"]
end

subgraph group_market["Marketplace"]
  node_listing["Listing Lifecycle<br/>[list_item.rs]"]
  node_cancel["Cancel Listing<br/>[cancel_listing.rs]"]
  node_buy["Buy Item<br/>[buy_item.rs]"]
  node_listingstate[("Listing State<br/>[listing.rs]")]
  node_escrow["NFT Escrow<br/>[cpi_item_nft.rs]"]
  node_marketconfig[("Marketplace Config")]
end

subgraph group_tokens["Token Programs"]
  node_resources["Resource Manager<br/>[mint_resource.rs]"]
  node_resourceburn["Burn Resources<br/>[burn_resource.rs]"]
  node_gameconfig[("Game Configuration<br/>[game_config.rs]")]
  node_magic["MAGIC Token<br/>[mint_magic.rs]"]
end

node_player(("Player"))
node_searchactor(("Player"))

node_player -.->|"registers"| node_register
node_player -.->|"searches"| node_search
node_search -->|"checks cooldown"| node_playerstate
node_search -->|"selects resources"| node_random
node_search -->|"mints via CPI"| node_resources
node_player -.->|"crafts item"| node_crafting
node_crafting -->|"validates recipe"| node_recipes
node_crafting -->|"burns inputs"| node_resourceburn
node_crafting -.->|"mints via CPI"| node_nftmint
node_nftmint -->|"stores record"| node_metadata
node_nftmint -->|"creates NFT metadata"| node_metaplex
node_player -.->|"lists NFT"| node_listing
node_listing -.->|"records listing"| node_listingstate
node_listing -.->|"escrows NFT"| node_escrow
node_player -.->|"cancels listing"| node_cancel
node_cancel -.->|"returns NFT"| node_escrow
node_player -.->|"buys listing"| node_buy
node_buy -->|"checks and updates"| node_listingstate
node_buy -.->|"burns escrow NFT"| node_nftburn
node_buy -->|"mints seller reward"| node_magic
node_magic -.->|"uses configured mint"| node_gameconfig

click node_register "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/instructions/register_player.rs"
click node_search "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/instructions/search_resources.rs"
click node_random "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/utils/randomness.rs"
click node_playerstate "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/state/player_account.rs"
click node_crafting "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/crafting/src/instructions/craft_item.rs"
click node_recipes "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/crafting/src/constants/recipes.rs"
click node_nftmint "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/instructions/mint_item_nft.rs"
click node_nftburn "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/instructions/burn_item_nft.rs"
click node_metadata "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/state/item_metadata.rs"
click node_metaplex "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/utils/metaplex.rs"
click node_listing "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/list_item.rs"
click node_cancel "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/cancel_listing.rs"
click node_buy "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/buy_item.rs"
click node_listingstate "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/state/listing.rs"
click node_escrow "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/utils/cpi_item_nft.rs"
click node_resources "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/instructions/mint_resource.rs"
click node_resourceburn "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/instructions/burn_resource.rs"
click node_gameconfig "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/state/game_config.rs"
click node_magic "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/magic_token/src/instructions/mint_magic.rs"
click node_marketconfig "https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/state/marketplace_config.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_register,node_search,node_random,node_playerstate toneBlue
class node_crafting,node_recipes,node_nftmint,node_nftburn,node_metadata,node_metaplex toneAmber
class node_listing,node_cancel,node_buy,node_listingstate,node_escrow,node_marketconfig toneMint
class node_resources,node_resourceburn,node_gameconfig,node_magic toneRose
class node_player,node_searchactor toneIndigo
```

## Components

### Player Activity

- [Register Player](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/instructions/register_player.rs): `programs/search/src/instructions/register_player.rs`
- [Search Resources](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/instructions/search_resources.rs): `programs/search/src/instructions/search_resources.rs`
- [Resource Selection](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/utils/randomness.rs): `programs/search/src/utils/randomness.rs`
- [Player Account](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/search/src/state/player_account.rs): `programs/search/src/state/player_account.rs`

### Crafting and Items

- [Craft Item](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/crafting/src/instructions/craft_item.rs): `programs/crafting/src/instructions/craft_item.rs`
- [Item Recipes](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/crafting/src/constants/recipes.rs): `programs/crafting/src/constants/recipes.rs`
- [Mint Item NFT](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/instructions/mint_item_nft.rs): `programs/item_nft/src/instructions/mint_item_nft.rs`
- [Burn Item NFT](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/instructions/burn_item_nft.rs): `programs/item_nft/src/instructions/burn_item_nft.rs`
- [Item Metadata](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/state/item_metadata.rs): `programs/item_nft/src/state/item_metadata.rs`
- [NFT Metadata CPI](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/item_nft/src/utils/metaplex.rs): `programs/item_nft/src/utils/metaplex.rs`

### Marketplace

- [Listing Lifecycle](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/list_item.rs): `programs/marketplace/src/instructions/list_item.rs`
- [Cancel Listing](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/cancel_listing.rs): `programs/marketplace/src/instructions/cancel_listing.rs`
- [Buy Item](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/instructions/buy_item.rs): `programs/marketplace/src/instructions/buy_item.rs`
- [Listing State](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/state/listing.rs): `programs/marketplace/src/state/listing.rs`
- [NFT Escrow](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/utils/cpi_item_nft.rs): `programs/marketplace/src/utils/cpi_item_nft.rs`
- [Marketplace Config](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/marketplace/src/state/marketplace_config.rs): `programs/marketplace/src/state/marketplace_config.rs`

### Token Programs

- [Resource Manager](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/instructions/mint_resource.rs): `programs/resource_manager/src/instructions/mint_resource.rs`
- [Burn Resources](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/instructions/burn_resource.rs): `programs/resource_manager/src/instructions/burn_resource.rs`
- [Game Configuration](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/resource_manager/src/state/game_config.rs): `programs/resource_manager/src/state/game_config.rs`
- [MAGIC Token](https://github.com/nikkkitosss/solana-cossack-game/blob/main/programs/magic_token/src/instructions/mint_magic.rs): `programs/magic_token/src/instructions/mint_magic.rs`

### Other components

- **Player**
- **Player**

## Connections

- Player → Register Player: registers
- Player → Search Resources: searches
- Search Resources → Player Account: checks cooldown (evidence: `programs/search/src/instructions/search_resources.rs`)
- Search Resources → Resource Selection: selects resources (evidence: `programs/search/src/instructions/search_resources.rs`)
- Search Resources → Resource Manager: mints via CPI
- Player → Craft Item: crafts item
- Craft Item → Item Recipes: validates recipe (evidence: `programs/crafting/src/instructions/craft_item.rs`)
- Craft Item → Burn Resources: burns inputs
- Craft Item → Mint Item NFT: mints via CPI
- Mint Item NFT → Item Metadata: stores record (evidence: `programs/item_nft/src/instructions/mint_item_nft.rs`)
- Mint Item NFT → NFT Metadata CPI: creates NFT metadata (evidence: `programs/item_nft/src/instructions/mint_item_nft.rs`)
- Player → Listing Lifecycle: lists NFT
- Listing Lifecycle → Listing State: records listing
- Listing Lifecycle → NFT Escrow: escrows NFT
- Player → Cancel Listing: cancels listing
- Cancel Listing → NFT Escrow: returns NFT
- Player → Buy Item: buys listing
- Buy Item → Listing State: checks and updates (evidence: `programs/marketplace/src/instructions/buy_item.rs`)
- Buy Item → Burn Item NFT: burns escrow NFT
- Buy Item → MAGIC Token: mints seller reward (evidence: `programs/marketplace/src/instructions/buy_item.rs`)
- MAGIC Token → Game Configuration: uses configured mint
