VeChain Development Skill

Scope

Use this Skill for any VeChain development task:

• Frontend dApps (React/Next.js), wallet connection, social login
• Transaction building, sending, confirmation UX
• Solidity smart contracts on VeChainThor
• Multi-clause transactions, fee delegation (VIP-191)
• Testing with Hardhat + Thor Solo
• Security reviews
• VeBetterDAO / X2Earn apps, StarGate staking, governance

Default stack (opinionated)

Operating procedure

1. Detect project structure

• turbo.json present → follow Turborepo conventions (apps/frontend, packages/contracts, packages/*)
• Use useThor for Thor client access (both VeChain Kit and dapp-kit v2). useConnex is deprecated everywhere.
• Apply conditional patterns (Chakra UI, i18n, Zustand) only when the project uses them

2. Classify the task layer

UI/hooks → SDK/scripts → Smart contracts → Testing/CI → Infra

3. Pick building blocks

• UI (full-featured): VeChain Kit hooks + components
• UI (lightweight/non-React): dapp-kit
• Backend/scripts: @vechain/sdk-core + sdk-network directly
• Legacy Connex present: migrate or isolate behind adapter boundary

4. Implement with VeChain-specific correctness

• Network: always explicit (mainnet/testnet/solo)
• Gas: estimate first, use fee delegation where appropriate
• Transactions: use multi-clause when batching benefits atomicity or UX
• Tokens: VET for value, VTHO for gas (dual-token model)
• Social login: Generic Delegator auto-enabled (users pay gas in VET/VTHO/B3TR); app-sponsored delegation optional for better UX; smart accounts; pre-fetch data before sendTransaction

5. Test

• Unit: Hardhat + Thor Solo
• Integration: Thor Solo with realistic state
• Wallet UX: mocked hook/provider tests

6. Deliver

• Files changed + diffs
• Install/build/test commands
• Risk notes for signing, fees, token transfers

Progressive disclosure (load only when needed)