{
"_meta": {
"description": "Use case mappings for the Tether WDK ecosystem",
"documentation": {
"patterns": "See pattern-map.json for implementation patterns",
"skills": "See skills/ directory for API examples",
"integration": "See hyper-fleeky/hyper-wallet/ for production implementation"
},
"realWorldExamples": "PearPass (desktop/mobile), Rumble Wallet (announced)",
"lastUpdated": "2026-01-23",
"phase": "Phase 1 - Initial Use Case Mapping"
},
"useCases": {
"multi-chain-wallet": {
"description": "Single wallet supporting multiple blockchains from one seed phrase",
"requiredRepos": [
"wdk-core",
"wdk-wallet-btc",
"wdk-wallet-evm"
],
"optionalRepos": [
"wdk-wallet-ton",
"wdk-wallet-tron",
"wdk-wallet-solana"
],
"patterns": [
"hd-wallet",
"multi-chain",
"protocol-registry"
],
"examples": ["hyper-wallet"],
"difficulty": "intermediate"
},
"lightning-payments": {
"description": "Instant, low-fee Bitcoin Lightning Network payments",
"requiredRepos": [
"wdk-core",
"wdk-wallet-spark"
],
"optionalRepos": [],
"patterns": [
"lightning-invoice",
"instant-settlement"
],
"examples": [],
"difficulty": "intermediate",
"notes": "Spark blockchain provides Lightning, NOT traditional Bitcoin Lightning"
},
"stablecoin-wallet": {
"description": "USDT stablecoin wallet across multiple chains",
"requiredRepos": [
"wdk-core",
"wdk-wallet-evm"
],
"optionalRepos": [
"wdk-wallet-ton",
"wdk-wallet-tron",
"wdk-protocol-bridge-usdt0-evm"
],
"patterns": [
"multi-chain",
"stablecoin-support"
],
"examples": ["Rumble Wallet"],
"difficulty": "beginner"
},
"defi-integration": {
"description": "Integrate DeFi protocols (swap, lending) into wallet",
"requiredRepos": [
"wdk-core",
"wdk-wallet-evm",
"wdk-protocol-swap-velora-evm"
],
"optionalRepos": [
"wdk-protocol-lending-aave-evm"
],
"patterns": [
"protocol-registry",
"defi-composition"
],
"examples": [],
"difficulty": "advanced"
},
"cross-chain-bridge": {
"description": "Move USDT between different blockchains",
"requiredRepos": [
"wdk-core",
"wdk-protocol-bridge-usdt0-evm",
"wdk-protocol-bridge-usdt0-ton"
],
"optionalRepos": [
"wdk-wallet-evm",
"wdk-wallet-ton"
],
"patterns": [
"cross-chain-transfer",
"bridge-protocol"
],
"examples": [],
"difficulty": "advanced"
},
"gasless-wallet": {
"description": "Wallet with sponsored gas fees (ERC-4337 account abstraction)",
"requiredRepos": [
"wdk-core",
"wdk-wallet-evm-erc-4337"
],
"optionalRepos": [],
"patterns": [
"account-abstraction",
"sponsored-transactions"
],
"examples": [],
"difficulty": "advanced"
},
"pear-wallet-app": {
"description": "P2P wallet application built with Pear runtime",
"requiredRepos": [
"pear-wrk-wdk",
"wdk-core",
"wdk-wallet-btc"
],
"optionalRepos": [
"wdk-wallet-evm",
"wdk-wallet-spark"
],
"patterns": [
"pear-integration",
"bare-worklet",
"p2p-sync"
],
"examples": ["hyper-wallet"],
"difficulty": "advanced",
"notes": "Requires Bare runtime, uses worklets for crypto operations"
},
"mobile-wallet": {
"description": "React Native mobile wallet with WDK",
"requiredRepos": [
"wdk-core",
"wdk-starter-react-native"
],
"optionalRepos": [
"wdk-wallet-evm",
"wdk-wallet-btc"
],
"patterns": [
"mobile-integration",
"react-native-wdk"
],
"examples": [],
"difficulty": "intermediate"
},
"bitcoin-segwit-wallet": {
"description": "Bitcoin-only wallet with native SegWit (bech32) addresses",
"requiredRepos": [
"wdk-core",
"wdk-wallet-btc"
],
"optionalRepos": [],
"patterns": [
"hd-wallet",
"bip84-segwit",
"utxo-management"
],
"examples": [],
"difficulty": "beginner"
}
},
"repoUseCases": {
"wdk-core": [
"multi-chain-wallet",
"lightning-payments",
"stablecoin-wallet",
"defi-integration",
"cross-chain-bridge",
"gasless-wallet",
"pear-wallet-app",
"mobile-wallet",
"bitcoin-segwit-wallet"
],
"wdk-wallet": [
"multi-chain-wallet",
"pear-wallet-app"
],
"pear-wrk-wdk": [
"pear-wallet-app"
],
"wdk-wallet-btc": [
"multi-chain-wallet",
"pear-wallet-app",
"bitcoin-segwit-wallet"
],
"wdk-wallet-evm": [
"multi-chain-wallet",
"stablecoin-wallet",
"defi-integration",
"cross-chain-bridge",
"pear-wallet-app",
"mobile-wallet"
],
"wdk-wallet-spark": [
"lightning-payments",
"pear-wallet-app"
],
"wdk-wallet-ton": [
"multi-chain-wallet",
"stablecoin-wallet",
"cross-chain-bridge"
],
"wdk-wallet-tron": [
"multi-chain-wallet",
"stablecoin-wallet"
],
"wdk-wallet-solana": [
"multi-chain-wallet",
"stablecoin-wallet"
],
"wdk-wallet-evm-erc-4337": [
"gasless-wallet"
],
"wdk-protocol-bridge-usdt0-evm": [
"stablecoin-wallet",
"cross-chain-bridge"
],
"wdk-protocol-bridge-usdt0-ton": [
"cross-chain-bridge"
],
"wdk-protocol-swap-velora-evm": [
"defi-integration"
],
"wdk-protocol-lending-aave-evm": [
"defi-integration"
],
"wdk-starter-react-native": [
"mobile-wallet"
]
}
}