Kaspa Development
Overview
This skill provides comprehensive support for Kaspa blockchain development across multiple programming languages and use cases. Whether you're building a simple wallet integration, a full dApp, a block explorer, or working with KRC20 tokens, this skill provides the patterns, SDK references, and boilerplate code you need.
Quick Start
Choose Your SDK
Kaspa provides official SDKs for multiple languages:
- JavaScript/TypeScript:
kaspa-wasm - WebAssembly-based SDK for browser and Node.js
- Rust:
kaspa-rpc-client and kaspa-wallet-core - Native Rust SDK
- Go:
github.com/kaspanet/kaspad - Official Go implementation
- Python: Community SDKs available via PyPI
- Motoko:
kaspa package on Mops for Internet Computer integration
Common Tasks
Generate a Kaspa Address
JavaScript/TypeScript:
import { PrivateKey, NetworkType } from 'kaspa-wasm';
const privateKey = PrivateKey.random(NetworkType.Mainnet);
const publicKey = privateKey.toPublicKey();
const address = publicKey.toAddress(NetworkType.Mainnet);
console.log('Address:', address.toString());
console.log('Private Key:', privateKey.toString());
Rust:
use kaspa_wallet_core::keys::{PrivateKey, PublicKey};
use kaspa_consensus_core::network::NetworkType;
let private_key = PrivateKey::random(NetworkType::Mainnet);
let public_key = private_key.to_public_key();
let address = public_key.to_address(NetworkType::Mainnet);
println!("Address: {}", address.to_string());
Go:
import (
"github.com/kaspanet/kaspad/domain/consensus/model/externalapi"
"github.com/kaspanet/kaspad/util"
)
privateKey, _ := util.GeneratePrivateKey()
publicKey := privateKey.PublicKey()
address, _ := util.NewAddressPublicKey(publicKey.Serialize(), util.Bech32PrefixKaspaMain)
fmt.Printf("Address: %s\n", address.String())
Build and Broadcast a Transaction
JavaScript/TypeScript:
import { Transaction, RpcClient, NetworkType } from 'kaspa-wasm';
const rpc = new RpcClient({
url: 'wss://api.kaspa.org',
network: NetworkType.Mainnet
});
await rpc.connect();
// Get UTXOs for the sender address
const utxos = await rpc.getUtxosByAddresses([senderAddress]);
// Build transaction
const tx = new Transaction({
version: 0,
inputs: utxos.map(utxo => ({
previousOutpoint: utxo.outpoint,
signatureScript: '', // Will be filled after signing
sequence: 0,
sigOpCount: 1
})),
outputs: [{
amount: amount,
scriptPublicKey: recipientScriptPublicKey
}],
lockTime: 0,
subnetworkId: '00000000000000000000000000000000'
});
// Sign transaction
const signedTx = await signTransaction(tx, privateKey);
// Broadcast
const txId = await rpc.submitTransaction(signedTx);
console.log('Transaction ID:', txId);
SDK References
For detailed SDK documentation and examples:
Integration Guides
Wallet Integration
For integrating Kaspa into wallets like RainbowKit, OisyWallet, or custom wallets:
See references/wallet-integration.md for:
- Wallet connection patterns
- Transaction signing flows
- Address management
- Network switching
Node Operations
For setting up and operating Kaspa nodes:
See references/node-operations.md for:
- Docker deployment
- Binary installation
- Building from source
- Configuration options
- RPC node setup
- Monitoring and maintenance
dApp Development
When building a Kaspa dApp:
- Setup: Use the WASM SDK for browser compatibility
- Wallet Connection: Implement wallet adapter pattern
- State Management: Track balances, transactions, and UTXOs
- Transaction Building: Use UTXO selection algorithms
- Error Handling: Handle network failures and reorgs
Block Explorer
To build a block explorer:
- Data Source: Use Kaspa Developer Platform API or run your own node
- Indexing: Index blocks, transactions, and addresses
- API Layer: Build REST/GraphQL API for frontend
- Frontend: Display blocks, transactions, addresses, and network stats
See API reference for available endpoints.
KRC20 Tokens
Kaspa supports KRC20 tokens (similar to ERC20 on Ethereum). For token development:
See references/krc20-tokens.md for:
- Token contract structure
- Transfer and approval mechanisms
- Token metadata
- Integration patterns
Network Types
Kaspa has three network types:
- Mainnet: Production network (prefix:
kaspa:)
- Testnet: Testing network (prefix:
kaspatest:)
- Devnet: Development network (prefix:
kaspadev:)
Always use the correct network type for your use case.
Address Formats
Kaspa uses Bech32 encoding for addresses:
- Mainnet:
kaspa:qqkqkzjvr7zwxxmjxjkmxx (62 characters total)
- Testnet:
kaspatest:qqkqkzjvr7zwxxmjxjkmxx
- Devnet:
kaspadev:qqkqkzjvr7zwxxmjxjkmxx
Scripts and Utilities
The scripts/ directory contains utility scripts:
generate-address.py: Generate Kaspa addressesbuild-transaction.py: Build and sign transactionsmonitor-address.py: Monitor address for incoming transactions
Resources
References
- api-reference.md: Kaspa Developer Platform API documentation
- kaspa-wasm-sdk.md: JavaScript/TypeScript WASM SDK guide
- kaspa-rust-sdk.md: Rust SDK documentation
- kaspa-go-sdk.md: Go SDK documentation
- kaspa-python-sdk.md: Python SDK documentation
- krc20-tokens.md: KRC20 token standard documentation
- wallet-integration.md: Wallet integration patterns and examples
- node-operations.md: Complete guide for running Kaspa nodes
Assets
The assets/ directory contains boilerplate templates:
dapp-template/: React/Next.js dApp starterexplorer-template/: Block explorer starterwallet-adapter/: Wallet adapter implementation
Best Practices
- Always validate addresses before using them
- Handle UTXO selection carefully to avoid dust outputs
- Implement proper error handling for network failures
- Test on testnet before mainnet deployment
- Monitor for chain reorganizations when confirming transactions
- Use fee estimation for timely transaction confirmation
- Secure private keys - never expose them in client-side code
Getting Help
