EasyClaw User DEX Skill
Run only user workflows:
- - balance and open-order checks
- order submission (place order)
- backend position/order/fill/history/orderbook/chart queries
- authenticated agent/strategy controls and safety kill-switch
- realtime websocket monitoring and signal-driven auto order execution
Do not run admin/bootstrap/keeper workflows in this skill.
Runtime & Credential Requirements
- - Wallet signer source:
KEYPAIR_PATH or ANCHOR_WALLET (fallback ~/.config/solana/id.json). - Solana RPC source:
SOLANA_RPC_URL or ANCHOR_PROVIDER_URL (fallback http://127.0.0.1:8899). - Backend endpoint source:
EASYCLAW_API_BASE_URL / EASYCLAW_WS_URL (or alias vars in backend-common.js). - Optional API credential:
EASYCLAW_API_TOKEN (required for protected backend controls). - Local process usage: onboarding probes
solana config get and can spawn child Node.js processes for autotrade execution. - Local file writes:
- onboarding persists selected wallet envs into
easyclaw-skill/.env
- strategy onboarding writes files into INLINECODE12
Command Interface
Use {baseDir}/scripts/dex-agent.sh:
CODEBLOCK0
Files
- -
scripts/balance.js: user balance and order summary - INLINECODE15 : user order submission helper
- INLINECODE16 : backend REST API query helper
- INLINECODE17 : backend websocket channel subscriber
- INLINECODE18 : signal-driven auto-order loop
- INLINECODE19 : interactive onboarding flow (wallet selection, registration wait, strategy capture, autotrade kickoff)
- INLINECODE20 : backend endpoint/auth helpers
- INLINECODE21 : PDA, signer, tx, and decode utilities
- INLINECODE22 : local runtime dependencies
- INLINECODE23 : required environment keys
Setup
- 1. Copy
.env.example to .env. - Fill signer and RPC values.
- Run
dex-agent.sh install. - Run
dex-agent.sh balance first to validate access. - Run
dex-agent.sh backend doctor and dex-agent.sh watch --channel system.status. - Run
dex-agent.sh onboard --market-id <id> --margin <u64> for guided onboarding.
For env definitions and option details, read references/dex-env.md.
Safety
- - Keep
KEYPAIR_PATH and private keys local. - Use devnet/localnet unless explicitly instructed otherwise.
- Confirm
ORDER_ENGINE_PROGRAM_ID and MARKET_REGISTRY_PROGRAM_ID before placing orders.
EasyClaw 用户 DEX 技能
仅运行用户工作流：
- - 余额和未成交订单检查
- 订单提交（下单）
- 后端持仓/订单/成交/历史/订单簿/图表查询
- 认证代理/策略控制及安全终止开关
- 实时 WebSocket 监控及信号驱动的自动订单执行
本技能不运行管理/引导/维护工作流。
运行时与凭证要求
- - 钱包签名者来源：KEYPAIRPATH 或 ANCHORWALLET（回退至 ~/.config/solana/id.json）。
- Solana RPC 来源：SOLANARPCURL 或 ANCHORPROVIDERURL（回退至 http://127.0.0.1:8899）。
- 后端端点来源：EASYCLAWAPIBASEURL / EASYCLAWWSURL（或 backend-common.js 中的别名变量）。
- 可选 API 凭证：EASYCLAWAPI_TOKEN（受保护的后端控制所需）。
- 本地进程使用：引导程序探测 solana config get，并可生成子 Node.js 进程用于自动交易执行。
- 本地文件写入：
- 引导程序将所选钱包环境持久化至 easyclaw-skill/.env
- 策略引导程序将文件写入 easyclaw-skill/state/strategies/
命令接口
使用 {baseDir}/scripts/dex-agent.sh：
bash
工具链 + 环境诊断
{baseDir}/scripts/dex-agent.sh doctor
安装本地技能依赖
{baseDir}/scripts/dex-agent.sh install
钱包、USDC、保证金和未成交订单
{baseDir}/scripts/dex-agent.sh balance
{baseDir}/scripts/dex-agent.sh balance --json
提交订单交易
{baseDir}/scripts/dex-agent.sh order --market-id 1 --side buy --type market --margin 1000000
{baseDir}/scripts/dex-agent.sh order --market-id 2 --side sell --type limit --margin 2000000 --price 3000000000
后端 REST 查询
{baseDir}/scripts/dex-agent.sh backend positions --mine --limit 20
{baseDir}/scripts/dex-agent.sh backend position-history --mine --limit 20
{baseDir}/scripts/dex-agent.sh backend chart-candles --market BTCUSDT --timeframe 1m --limit 120
{baseDir}/scripts/dex-agent.sh backend orderbook-heatmap --exchange binance --symbol BTCUSDT --limit 30
{baseDir}/scripts/dex-agent.sh backend portfolio --period 7d
{baseDir}/scripts/dex-agent.sh backend strategy-templates
{baseDir}/scripts/dex-agent.sh backend agent-risk --agent-id agent-001
实时 WS 监控
{baseDir}/scripts/dex-agent.sh watch --channels agent.signals,portfolio.updates,market.price.BTCUSDT
实时信号 -> 自动订单执行
{baseDir}/scripts/dex-agent.sh autotrade --market-id 1 --margin 1000000 --min-confidence 0.75
引导式入门 + 策略捕获 + 自动交易启动
{baseDir}/scripts/dex-agent.sh onboard --market-id 1 --margin 1000000
文件
- - scripts/balance.js：用户余额和订单摘要
- scripts/order-execute.js：用户订单提交辅助工具
- scripts/backend.js：后端 REST API 查询辅助工具
- scripts/ws-watch.js：后端 WebSocket 频道订阅器
- scripts/realtime-agent.js：信号驱动的自动订单循环
- scripts/onboard.js：交互式引导流程（钱包选择、注册等待、策略捕获、自动交易启动）
- scripts/backend-common.js：后端端点/认证辅助工具
- scripts/common.js：PDA、签名者、交易和解码工具
- package.json：本地运行时依赖
- .env.example：所需环境密钥
设置
- 1. 将 .env.example 复制为 .env。
- 填写签名者和 RPC 值。
- 运行 dex-agent.sh install。
- 首先运行 dex-agent.sh balance 以验证访问权限。
- 运行 dex-agent.sh backend doctor 和 dex-agent.sh watch --channel system.status。
- 运行 dex-agent.sh onboard --market-id --margin 进行引导式入门。
有关环境定义和选项详情，请阅读 references/dex-env.md。
安全
- - 将 KEYPAIRPATH 和私钥保存在本地。
- 除非另有明确指示，否则使用 devnet/localnet。
- 在下单前确认 ORDERENGINEPROGRAMID 和 MARKETREGISTRYPROGRAM_ID。
