mantra-claimdrop-std

Common types and error definitions for the Mantra claimdrop contract V2.

Overview

This package provides shared types, message definitions, and error handling for claimdrop (airdrop) contracts in the Mantra ecosystem. It enables code reuse across different claimdrop-related contracts and provides a consistent interface for campaign management, token distribution, and reward claiming.

Features

Message Types: Complete set of execute, query, and response messages for claimdrop operations
Campaign Management: Types for creating, managing, and closing airdrop campaigns
Distribution Types: Support for linear vesting and lump sum distribution mechanisms
Error Handling: Comprehensive error types for validation and runtime errors
Validation: Built-in validation for campaign parameters, distribution settings, and time constraints

Usage

Add this package to your Cargo.toml:

[dependencies]
mantra-claimdrop-std = { version = "1.0.0", path = "path/to/mantra-claimdrop-std" }

Message Types

use mantra_claimdrop_std::msg::{
    ExecuteMsg, QueryMsg, CampaignParams, DistributionType
};

// Create a campaign
let campaign_params = CampaignParams {
    name: "My Airdrop".to_string(),
    description: "Token distribution campaign".to_string(),
    ty: "airdrop".to_string(),
    reward_denom: "umantra".to_string(),
    total_reward: Coin::new(1000000u128, "umantra"),
    distribution_type: vec![DistributionType::LumpSum {
        percentage: Decimal::percent(100),
        start_time: 1640995200, // Unix timestamp
    }],
    start_time: 1640995200,
    end_time: 1672531200,
};

let execute_msg = ExecuteMsg::ManageCampaign {
    action: CampaignAction::CreateCampaign {
        params: Box::new(campaign_params),
    },
};

Error Handling

use mantra_claimdrop_std::error::ContractError;

fn validate_campaign(params: &CampaignParams) -> Result<(), ContractError> {
    params.validate_campaign_name_description()?;
    params.validate_campaign_type()?;
    params.validate_rewards()?;
    Ok(())
}

Types

Campaign Types

Campaign: Complete campaign information including status and claimed amounts
CampaignParams: Parameters for creating new campaigns
CampaignAction: Actions for managing campaigns (create/close)

Distribution Types

DistributionType::LinearVesting: Gradual token release over time with optional cliff
DistributionType::LumpSum: Immediate token release at specified time

Response Types

RewardsResponse: Information about claimed, pending, and available rewards
ClaimedResponse: Details about claimed tokens per address
AllocationsResponse: Address allocation information
BlacklistResponse: Address blacklist status

Validation

The package includes comprehensive validation for:

Campaign name and description length limits
Time constraints (start/end times, distribution schedules)
Distribution percentage totals (must equal 100%)
Reward amounts and denominations
Cliff duration limits for linear vesting

mantra-claimdrop-std 1.1.2