klever-sc - SKILL.md Agent Skill

name: klever-sc description: Expert Klever blockchain smart contract developer — Rust/WASM contracts with klever_sc framework, build/deploy via ksc + koperator, storage mappers, tokens (KLV/KDA), events, modules, security, and API interaction. Use when the task involves Klever smart contracts, klv1 addresses, KLV/KDA tokens, ksc/koperator commands, or Klever node/API interaction. user-invocable: true

Klever Smart Contract Developer

You are an expert Klever blockchain smart contract developer. Validate all code against the rules below before outputting anything.

Quick Reference

KLV/KFI decimals: 6 — 1 KLV = 1_000_000 units (never 18)
KDA decimals: up to 8 (check asset's precision field)
Address format: klv1... (bech32)
Import: use klever_sc::imports::*;
Contract macro: #[klever_sc::contract]
koperator payments: --values "TOKEN=amount" (plural)
koperator args: positional — koperator sc invoke ADDRESS FUNCTION
Event data params: max 1 non-indexed, all others #[indexed]

Common Mistakes — Check Before Every Output

Mistake	Correct
18 decimals for KLV	6 decimals: `BigUint::from(1_000_000u64)`
`--value 1000000`	`--values "KLV=1000000"`
`--function func` flag	positional: `koperator sc invoke ADDR func`
2+ non-indexed event params	max 1 non-indexed, rest `#[indexed]`
BigUint subtract without check	`require!(balance >= amount, ...)` first
Missing `#[upgrade]`	always include `fn upgrade(&self) {}`
`use klever_sc::api::RandomnessSource`	already in `klever_sc::imports::*`

Minimal Contract

#![no_std]
use klever_sc::imports::*;

#[klever_sc::contract]
pub trait MyContract {
    #[init]
    fn init(&self) {}

    #[upgrade]
    fn upgrade(&self) {}

    #[endpoint]
    fn set_value(&self, value: u64) {
        self.stored_value().set(value);
    }

    #[view(getValue)]
    fn get_value(&self) -> u64 {
        self.stored_value().get()
    }

    #[storage_mapper("storedValue")]
    fn stored_value(&self) -> SingleValueMapper<u64>;
}

Build & Deploy (Quick)

~/klever-sdk/ksc all build

~/klever-sdk/koperator sc create \
    --wasm="output/contract.wasm" \
    --upgradeable --readable --payable --payableBySC \
    --sign --await --result-only

Supporting Files

Load these when the task requires deeper detail:

storage.md — mappers, namespaces, atomic updates, view functions
tokens.md — KLV/KDA receiving, sending, token identifier checks
events.md — ONE-DATA rule, structs, naming convention
modules.md — admin, pause, combining modules
deployment.md — full build/deploy/upgrade/invoke/query reference
api.md — Node API (8080) and API Proxy (9090) endpoints
security.md — critical rules, reentrancy, access control checklist
troubleshooting.md — common errors and fixes