giveaway-skills
Call guide and best practices for the BSC on-chain giveaway contract based on contracts/contracts/Giveaway.sol, including contract address, core method signatures, parameter meanings, and conventions for calling the contract from scripts, frontends, or OpenClow workflows via ethers/web3. Use this skill when you need to create giveaways, claim giveaways, manage whitelists, or withdraw expired giveaways on BSC.
Why use this skill?
Learn to manage on-chain giveaways on BSC using OpenClaw. Automate token distribution, set claim restrictions, and handle contract logic easily.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/franckstone/giveaway-skillsWhat This Skill Does
The giveaway-skills module is an essential OpenClaw toolkit for interacting with the BSC-based Giveaway smart contract (0x0...5B9). It provides a unified interface to automate the lifecycle of on-chain giveaways on the Binance Smart Chain. Whether you are a project manager running an airdrop, a DAO leader distributing community rewards, or a developer integrating token distribution into your application, this skill abstracts the complexities of ERC-20 approvals, fee calculations, and chain-specific transaction logic. It supports various distribution models (average vs. random) and claim restrictions (public, token-holder, or whitelist), ensuring precise control over your promotional activities.
Installation
To integrate this skill into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/franckstone/giveaway-skills
Ensure your OpenClaw agent has a pre-configured wallet connected to the BSC mainnet (RPC: https://bsc-dataseed.binance.org) and sufficient gas tokens to facilitate contract interactions.
Use Cases
- Token Airdrops: Create automated token distribution events where claimers must meet specific token holding criteria to prevent bots.
- Community Incentives: Deploy random-distribution giveaways to boost engagement on BSC-based social platforms.
- Whitelist Campaigns: Manage private giveaways for early supporters or competition winners by utilizing the whitelist restriction feature.
- Automated Withdrawals: Programmatically recover unclaimed funds from expired giveaway pools to maintain liquidity for the next event.
Example Prompts
- "Create a public giveaway for 1000 USDT on BSC. Use random distribution for 50 slots, set the expiration to 48 hours from now, and ensure the content says 'Community Rewards'."
- "Deploy a token-holder giveaway for 500 units of my custom token. Restrict claims to users holding at least 1000 GALA tokens. Use average distribution for 100 slots."
- "Check the status of giveaway ID #42 and claim it using my currently connected wallet address."
Tips & Limitations
When creating a giveaway, remember that the contract deducts a fee immediately. For ERC-20 tokens, ensure you have executed an approve transaction for the contract address beforehand; failing to do so will result in transaction reverts. The amount / count must result in a value greater than zero. Note that the restrictionToken field is strictly for TOKEN_HOLDER scenarios; setting it for other modes may cause unexpected behavior. Always verify the lastDate timestamp in seconds to avoid premature or delayed expirations.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-franckstone-giveaway-skills": {
"enabled": true,
"auto_update": true
}
}
}Tags
Flags: network-access, code-execution
Related Skills
okx-dex-swap
Execute token swaps on-chain via OKX DEX Aggregator API (v6). Use this skill when a user wants to: 1. Build a complete swap flow: get swap calldata -> sign transaction -> broadcast to chain 2. Execute token-to-token swaps with slippage protection, MEV protection, and Jito tips (Solana) 3. Integrate OKX DEX swap + broadcast into applications, bots, or scripts This skill covers the FULL lifecycle: /swap endpoint (get tx data) + /broadcast-transaction endpoint (submit signed tx). For quote-only (no execution), use the okx-dex-quote skill instead.
Zerion Api
Skill by abishekdharshan
Zerion Api Skill
Skill by abishekdharshan
okx-dex-quote
Fetch optimal swap quotes from OKX DEX Aggregator API (v6). Use this skill when a user wants to: 1. Get the best price for swapping tokens on any supported EVM/Solana chain 2. Compare DEX routing paths and price impact for token swaps 3. Build applications or scripts that query real-time DEX aggregator pricing Core value: Generates correct, authenticated API calls with proper token decimals, amount formatting, HMAC-SHA256 signing, and comprehensive error handling.
etherlink
Etherlink blockchain interaction - EVM-compatible L2 on Tezos. Supports mainnet and shadownet testnet via MCP server. Use for balance checks, transactions, smart contracts, and token operations on Etherlink.