CraftLABCraftLAB
CraftLAB
DOCUMENTATION

CraftLAB Protocol

On-chain crafting protocol on Solana · v1.0

Overview

CraftLAB is an on-chain crafting protocol built on Solana. Users stake SOL to mine $CRAFT tokens, then combine ingredients in a 3×3 crafting grid to produce blueprints — NFT-like on-chain receipts that grant boosted yield, governance weight, and exclusive access to protocol features.

Inspired by Minecraft's crafting mechanic, CraftLAB translates the joy of recipe discovery into a DeFi-native loop: the more strategically you craft, the higher your returns. An embedded AI advisor analyzes your resource profile and suggests optimal crafting paths.

✦
CraftLAB is non-custodial. Your SOL never leaves your wallet — it is delegated to a Solana native staking validator and yield flows back through the protocol in real-time.

Core Loop

1. Stake SOL  →  delegate to CraftLAB validator
2. Earn yield  →  converted to $CRAFT tokens (daily distribution)
3. Collect ingredients  →  CRAFT 🌿  SOL 💎  STONE 🪨  GOLD ⭐  MANA 🌀
4. Open crafting table  →  fill 3×3 grid with ingredients
5. Mint blueprint  →  on-chain NFT receipt (4 rarity tiers)
6. Hold blueprints  →  earn multiplied yield + governance rights

$CRAFT Token

$CRAFT is the native utility and governance token of the CraftLAB protocol. It is mined exclusively through SOL staking — there is no presale, no VC allocation, and no team mint. Every token in existence has been earned by a real staker.

Token Properties

PropertyValue
Ticker$CRAFT
NetworkSolana (SPL Token)
Max Supply420,000,000 CRAFT
Mining EmissionDynamic — proportional to total SOL staked
Burn Mechanism2% of blueprint crafting fees burned
Governance1 CRAFT = 1 vote in protocol proposals
Decimals9

Earning $CRAFT

Mining rate is calculated per epoch (Solana epoch ≈ 2–3 days). The formula distributes emissions proportionally to each staker's share of total staked SOL:

daily_craft_earned = (your_staked_sol / total_staked_sol) × daily_emission_budget

daily_emission_budget decays by 0.5% per epoch (halving-style softcap)
ℹ
Emissions are front-loaded in the first year to reward early adopters. Total first-year emission cap: 168,000,000 CRAFT (40% of max supply).

Mining System

Mining in CraftLAB is passive. Stake SOL once, and $CRAFT accumulates in your claimable balance every Solana epoch. No active transactions required until you choose to claim or craft.

How Staking Works

CraftLAB uses native Solana liquid staking. Your SOL is delegated to the CraftLAB validator cluster. You receive a cSOL receipt token (1:1 with SOL) that you can unstake at any time with a standard Solana 1–3 epoch cooldown period (~2–7 days).

ParameterValue
Minimum stake0.1 SOL
Unstaking cooldown1–3 Solana epochs (~2–7 days)
Receipt tokencSOL (redeemable 1:1 for SOL)
APY (staking only)~6–8% (Solana native yield)
CRAFT bonus APYVariable — depends on total stakers
Claim frequencyAny time (claim costs ~0.000005 SOL in fees)

Ingredient Generation

Alongside $CRAFT tokens, staking generates crafting ingredients. Each epoch, stakers receive a randomized ingredient drop based on their staked amount:

IngredientDrop RateRequired for
CRAFT 🌿Always (from yield)All recipes
SOL 💎1 per 10 SOL staked / epochSOL Blueprint, CRAFT Overdrive
STONE 🪨Common drop (40%)Basic recipes
GOLD ⭐Uncommon drop (20%)Gold Blueprint (Legendary)
MANA 🌀Rare drop (8%)Overdrive recipes

Crafting System

The crafting table is a 3×3 grid. Place ingredients into cells, and the protocol detects which recipe your arrangement matches. Confirmed recipes are executed on-chain — ingredients are burned and a blueprint NFT is minted to your wallet.

âš 
Crafting is irreversible. Once ingredients are placed and the transaction is confirmed, they are burned. There is no undo.

Recipe Book

RecipeIngredients RequiredResultRarity
Starter Blueprint3× CRAFT anywhere in gridStarter Blueprint NFTCommon
Base Blueprint3× CRAFT + 1× SOL (any position)Base Blueprint NFTUncommon
SOL Blueprint2× SOL + 3× CRAFT (any position)SOL Blueprint NFTRare
Gold Blueprint3× GOLD + 3× CRAFT (any position)Gold Blueprint NFTLegendary
CRAFT Overdrive9× CRAFT (fill entire grid)Overdrive Blueprint NFTLegendary

On-chain Recipe Validation

Recipe detection runs entirely on-chain via a Solana program. The program reads the grid state, counts ingredient types, and matches against the recipe registry. No off-chain oracle is involved.

// Pseudo-code: on-chain recipe matcher
pub fn detect_recipe(grid: [Option<Ingredient>; 9]) -> Option<Blueprint> {
    let counts = count_ingredients(grid);
    match counts {
        c if c[CRAFT] == 9                           => Some(Blueprint::Overdrive),
        c if c[GOLD] >= 3 && c[CRAFT] >= 3          => Some(Blueprint::Gold),
        c if c[SOL] >= 2 && c[CRAFT] >= 3           => Some(Blueprint::Sol),
        c if c[CRAFT] >= 3 && c[SOL] >= 1           => Some(Blueprint::Base),
        c if c[CRAFT] >= 3                           => Some(Blueprint::Starter),
        _                                            => None,
    }
}

Blueprint Tiers

Blueprints are on-chain NFTs (Solana compressed NFTs via Metaplex Bubblegum) minted as a result of crafting. They represent your crafting achievement and confer ongoing protocol benefits as long as you hold them.

TierBlueprintYield MultiplierGovernance WeightMax SupplyTradeable
CommonStarter Blueprint1.25×1×UnlimitedYes
UncommonBase Blueprint1.5×2×UnlimitedYes
RareSOL Blueprint2×5×50,000Yes
LegendaryGold / Overdrive3×20×500Yes
ℹ
Blueprints stack additively. Holding 2× Rare blueprints gives 4× yield multiplier on your staked SOL. There is no cap on how many blueprints a wallet can hold.

Blueprint Mechanics

Blueprints are held in your wallet as cNFTs. The protocol reads your blueprint holdings each epoch during yield calculation. Transferring or selling a blueprint immediately transfers the yield multiplier to the new holder.

AI Advisor

CraftLAB integrates an AI crafting advisor powered by Meta Llama 3.1 8B via DeepInfra. The advisor analyzes your current ingredient inventory and suggests the highest-value crafting path given your resources and goals.

How to Use

Open the AI Lab section on the website or use /craft in the Telegram bot. Describe your inventory (e.g., "I have 8 CRAFT, 2 SOL, 1 GOLD") and your goal (maximize yield / save for legendary / diversify). The AI returns a step-by-step crafting plan.

API Endpoint

POST /api/ai/craft
Content-Type: application/json

{
  "resources": "8 CRAFT, 2 SOL, 1 GOLD",
  "goal": "maximize yield multiplier"
}

// Response
{
  "plan": "Craft a SOL Blueprint first (2 SOL + 3 CRAFT → 2× multiplier),
           then save remaining 5 CRAFT + 1 GOLD for a second drop before
           attempting Gold Blueprint.",
  "estimated_multiplier": "2×",
  "ingredients_used": ["2× SOL", "3× CRAFT"]
}
✦
The AI advisor is free to use and requires no wallet connection. It runs off-chain and does not submit any on-chain transactions.

Telegram Bot

The CraftLAB Telegram bot (@craftlabbot) is a full-featured interface to the protocol. Generate wallets, check balances, get AI crafting advice, and receive mining notifications — all from Telegram.

Commands

CommandDescription
/startOpen main menu with inline keyboard
/walletWallet management (generate, import, export)
/balanceCheck SOL balance of connected wallet
/craftOpen AI crafting advisor
/mineView current mining status and claimable CRAFT
/blueprintsList blueprints held by connected wallet
/helpFull command reference

Wallet Security

Private keys are encrypted with AES-256-GCM using a user-provided password. The encrypted blob is stored in SQLite. The password is never stored — only you can decrypt your key. If you lose your password, the key cannot be recovered.

Encryption: AES-256-GCM
KDF: PBKDF2-SHA256, 260,000 iterations
Salt: protocol-specific per-user salt
Storage: encrypted ciphertext only (never plaintext)
âš 
The bot deletes any message containing a private key within 30 seconds of display. Never share your private key or password with anyone.

Smart Contracts

CraftLAB is implemented as a set of Solana programs (smart contracts) written in Rust using the Anchor framework. All programs are open source and audited prior to mainnet deployment.

ProgramDescriptionAddress
craftlab_coreMain protocol: staking, mining, crafting, blueprint mintingTBD (mainnet)
craftlab_tokenSPL token mint and emission controller for $CRAFTTBD (mainnet)
craftlab_vestingLinear vesting for any team/ecosystem allocationsTBD (mainnet)

Program Architecture

craftlab_core/
├── instructions/
│   ├── stake.rs         # Deposit SOL, mint cSOL receipt
│   ├── unstake.rs       # Burn cSOL, begin cooldown period
│   ├── claim.rs         # Claim accumulated $CRAFT to wallet
│   ├── craft.rs         # Submit grid, validate recipe, mint blueprint
│   └── distribute.rs    # Epoch yield distribution (crank)
├── state/
│   ├── pool.rs          # Global staking pool state
│   ├── user_stake.rs    # Per-user staking account
│   └── recipe_registry.rs
└── errors.rs

Tokenomics

AllocationAmount% of SupplyVesting
Mining Rewards (Community)294,000,00070%Continuous — mined over ~5 years
Ecosystem & Grants63,000,00015%24-month linear vesting, 6-month cliff
Core Team42,000,00010%36-month linear vesting, 12-month cliff
Liquidity Bootstrap21,000,0005%Locked in LP at launch, 12-month unlock
TOTAL420,000,000100%—
✦
There is no presale, no private sale, no VC round. 70% of all tokens can only be obtained by actively staking SOL and mining through the protocol.

Burn Mechanics

2% of all ingredients used in crafting are burned from the ecosystem supply. As crafting volume grows, burn rate increases — creating deflationary pressure on $CRAFT supply over time.

Roadmap

Phase 1FoundationIn Progress
  • ✓Protocol design & tokenomics finalization
  • ✓Smart contract development (Anchor)
  • ✓Telegram bot v1 (wallet + AI advisor)
  • ✓Website v1 launch
  • ✓Testnet deployment & internal testing
Phase 2LaunchUpcoming
  • ✓Independent security audit
  • ✓Mainnet deployment
  • ✓Liquidity bootstrap event
  • ✓PumpFun launch for $CRAFT
  • ✓Blueprint minting live (Starter + Base tiers)
Phase 3ExpansionPlanned
  • ✓Rare + Legendary blueprint tiers unlock
  • ✓Blueprint secondary market integration (Tensor)
  • ✓Governance portal — vote with $CRAFT + blueprints
  • ✓Mobile-optimized app
  • ✓Cross-protocol blueprint composability
Phase 4EcosystemPlanned
  • ✓CraftLAB SDK for third-party integrations
  • ✓Blueprint-gated community features
  • ✓Multi-validator staking diversification
  • ✓DAO transition — full community governance

FAQ

Is CraftLAB audited?

An independent security audit is scheduled for Phase 2 before mainnet launch. All program source code will be public on GitHub prior to audit.

Can I lose my SOL?

No. Your SOL is held in a native Solana staking account. The protocol does not have custody of your principal. The only risk is smart contract bugs (mitigated by audits) or Solana validator downtime (mitigated by diversification).

What happens if I transfer my blueprint?

The yield multiplier transfers instantly to the new holder. Your mining rate drops back to base (1×) until you craft or acquire new blueprints.

Is there a lockup for staked SOL?

There is a 1–3 epoch (~2–7 day) cooldown when unstaking, which is the standard Solana unstaking period. There is no additional protocol lock.

How does the AI advisor work?

The AI runs on Meta Llama 3.1 8B via DeepInfra. It receives your inventory and goal as a prompt, then generates a crafting plan. It is entirely advisory — no on-chain transactions are submitted without your explicit approval.

What is the $CRAFT contract address?

The token will be deployed at mainnet launch (Phase 2). Contract address will be published on this page and all official social channels simultaneously. Do not trust any token claiming to be $CRAFT before the official announcement.

CraftLAB

Ready to mine?

Stake SOL, mine $CRAFT, craft rare blueprints. Non-custodial. Open source. Built on Solana.