ClawdWallet 🐾

Multi-chain Web3 wallet extension controlled by your Clawdbot agent — powered by ShapeShift hdwallet.

Quick Start (Pre-built)

The dist/ folder contains the ready-to-use extension:

1. Clone: git clone https://github.com/NeOMakinG/clawdwallet.git
2. Open chrome://extensions → Enable Developer mode
3. Click Load unpacked → select the dist/ folder
4. Click extension icon → enter your Clawdbot WebSocket URL

That's it! No build required.

For Clawdbot Agents

Copy skill/SKILL.md to your skills folder to get full integration instructions.

Supported Chains

Family	Chains
EVM	Ethereum, Polygon, Optimism, Arbitrum, Base, Avalanche, Gnosis, BSC
UTXO	Bitcoin, Litecoin, Dogecoin, Bitcoin Cash
Cosmos	Cosmos Hub, Osmosis, THORChain, Mayachain, Kava
Other	Solana, TON, Near, Sui, Tron, Binance Chain

More chains than Bankr. 💪

How It Works

┌─────────────┐     ┌──────────────┐     ┌────────────┐
│   dApp      │────▶│  ClawdWallet │────▶│  Clawdbot  │
│ (webpage)   │◀────│  (extension) │◀────│  (agent)   │
└─────────────┘     └──────────────┘     └────────────┘

1. dApp requests signature via window.ethereum or window.solana
2. ClawdWallet forwards request to Clawdbot via WebSocket
3. Agent reviews and approves/rejects
4. ClawdWallet signs with hdwallet-native and returns result

Installation

Build

cd clawdwallet
npm install
npm run build

Load in Chrome

1. Navigate to chrome://extensions
2. Enable Developer mode
3. Click Load unpacked → select dist folder

Configure

Click extension icon → enter Clawdbot WebSocket URL (default: ws://localhost:3033/clawdwallet)

Agent Commands

Initialize Wallet

{
  "type": "init_wallet",
  "mnemonic": "your twenty four word seed phrase..."
}

Generate New Wallet

{
  "type": "generate_wallet"
}

Response:

{
  "type": "wallet_generated",
  "mnemonic": "...",
  "addresses": {
    "ethereum": "0x...",
    "bitcoin": "bc1...",
    "cosmos": "cosmos1...",
    "solana": "..."
  }
}

Approve Request

{
  "type": "sign_and_respond",
  "requestId": "request-uuid"
}

Reject Request

{
  "type": "reject_request",
  "requestId": "request-uuid",
  "reason": "Transaction looks suspicious"
}

Get Status

{
  "type": "get_status"
}

Incoming Requests

When a dApp requests a signature:

{
  "type": "wallet_request",
  "id": "request-uuid",
  "chain": "ethereum",
  "method": "eth_sendTransaction",
  "params": [{ "to": "0x...", "value": "0x..." }],
  "origin": "https://app.uniswap.org",
  "metadata": {
    "title": "Uniswap",
    "favicon": "https://..."
  }
}

Supported Methods

EVM (window.ethereum)

• eth_requestAccounts - Connect
• eth_accounts - Get accounts
• eth_chainId - Get chain ID
• personal_sign - Sign message
• eth_signTypedData_v4 - Sign typed data (EIP-712)
• eth_sendTransaction - Send transaction
• eth_signTransaction - Sign transaction
• wallet_switchEthereumChain - Switch chain

Solana (window.solana)

• connect - Connect
• disconnect - Disconnect
• signMessage - Sign message
• signTransaction - Sign transaction
• signAndSendTransaction - Sign and broadcast

Bitcoin / UTXO

• Sign PSBTs
• Sign messages

Cosmos

• Sign Amino transactions
• Sign Direct transactions

Roadmap

• ShapeShift swap integration
• Multi-account support
• Hardware wallet passthrough
• Transaction simulation
• Auto-approve rules

Security

⚠️ This extension gives your Clawdbot agent control over wallet keys.

• Only use with trusted agents
• Consider using a dedicated wallet for agent-controlled operations
• Never share mnemonics or WebSocket URLs

Architecture

src/
├── background/       # Service worker - signing & Clawdbot connection
├── content/          # Content script - page ↔ background bridge
├── provider/         # Injected provider - window.ethereum/solana
├── popup/            # Extension popup UI
└── lib/
    ├── wallet-core.ts  # hdwallet-native integration
    └── types.ts        # TypeScript types

Credits

Built on ShapeShift hdwallet - the same wallet library powering app.shapeshift.com.

License

MIT