king-bcolor / dsh-chaingate-wallet-plugin

dsh-chaingate-wallet-plugin

中文文档：README.zh-CN.md

A DeepSeek Harness wallet plugin built with the ChainGate TypeScript SDK.

What it is

dsh-chaingate-wallet-plugin exposes multi-chain wallet capabilities to DSH agents: HD wallet creation/import, address derivation, balances (native, ERC-20, NFT), transaction history, UTXO, fee estimation, gas tracking, signing, and broadcasting — via structured tools.

Features

• HD wallet create/import from mnemonic, private key, WIF, xpriv, xpub, keystore.
• Multi-chain networks: BTC, LTC, DOGE, BCH, ETH, AVAX (full API); Polygon, Arbitrum, Base, BNB Chain, Sonic (RPC-only); any EVM chain via custom RPC.
• Balances with confirmed/unconfirmed split and fiat conversion.
• Native, ERC-20, NFT transfer and contract calls with fee estimation.
• Message signing/verification; AES-256-GCM wallet encryption; view-only wallets.
• Broadcast operations require explicit confirmation.
• Built-in DSH web UI: a sidebar ChainGate 钱包 panel that replaces only the conversation pane. Home shows wallet switching plus BTC/ETH balances in USD/CNY; transfers are AI-assisted — paste the recipient's text or screenshot and AI validates the address/network/amount, prepares fees, and asks for one final confirmation before broadcasting. Advanced tools are collapsed under 高级.

Use cases

• Create or import a wallet and derive addresses.
• Check native/token balances and fiat value.
• Review transaction history and UTXOs.
• Send crypto with recommended fee and explicit confirmation.
• Connect any EVM chain through a custom RPC URL.

See docs/用例目录/README.md for the full SDK use-case catalog (Chinese).

Installation

Preconditions

• Node.js 22+, dsh CLI installed.
• npm install chaingate is bundled as a dependency.

Install from GitHub

dsh plugin --profile default add github:king-bcolor/dsh-chaingate-wallet-plugin
# allowlist build in $DSH_HOME/profiles/default/pnpm-workspace.yaml if requested

Install locally

git clone https://github.com/king-bcolor/dsh-chaingate-wallet-plugin.git
cd dsh-chaingate-wallet-plugin
dsh plugin --profile default add .

Usage

Start the web profile and open the printed URL (default http://127.0.0.1:3080):

dsh web

In the web UI sidebar, click ChainGate 钱包 to open the wallet console. For a CLI-only profile:

dsh --profile default

Example prompts:

• Create a new Bitcoin wallet and show the first address.
• Check the ETH balance of address 0x...
• Estimate fees and send 0.01 ETH to 0x... (you will be asked to confirm)

Configuration

- id: chaingate-wallet
  name: dsh-chaingate-wallet-plugin
  config:
    apiKey: ""
    defaultNetwork: ethereum
    confirmBroadcast: true

Security

Never share your mnemonic or private key. The plugin encrypts wallets with AES-256-GCM and never logs secrets.

Development

TDD is mandatory:

npm install
npm test
npm pack --dry-run

License

MIT