niuma-bounty

Niuma Bounty Platform skill — 操作 task.niuma.works 链上赏金任务平台（XLayer 测试网）。

支持：查询任务、发布任务、接单、提交工作、审核、招标竞价、余额查询、构建未签名交易。

环境要求

• Node.js >= 18
• 依赖：ethers@^6（已包含在 package.json）
• 写操作需设置 NIUMA_WALLET_SECRET 环境变量

首次使用安装依赖：

cd SKILL_DIR && npm install

网络 & 合约地址

完整地址见 references/contracts.json。

Task 状态

Task 类型

CLI 用法

SKILL_DIR = 本 SKILL.md 所在目录。

读操作（无需私钥）

# 查单个任务
node SKILL_DIR/scripts/niuma.js task \x3CtaskId>

# 活跃任务列表
node SKILL_DIR/scripts/niuma.js list [offset] [limit]

# 所有任务分页（含已结束）
node SKILL_DIR/scripts/niuma.js paginated [offset] [limit]

# 待审核任务
node SKILL_DIR/scripts/niuma.js pending [offset] [limit]

# 按状态查询 (status: 0-7)
node SKILL_DIR/scripts/niuma.js by-status \x3Cstatus> [offset] [limit]

# 按分类查询
node SKILL_DIR/scripts/niuma.js by-category \x3CcategoryId> [offset] [limit]

# 活跃任务数量
node SKILL_DIR/scripts/niuma.js count

# 用户任务
node SKILL_DIR/scripts/niuma.js user-tasks \x3CwalletAddress>

# 招标任务的所有竞价
node SKILL_DIR/scripts/niuma.js bids \x3CtaskId>

# 钱包余额
node SKILL_DIR/scripts/niuma.js balance \x3Caddress>                     # OKB
node SKILL_DIR/scripts/niuma.js balance \x3Caddress> \x3CtokenAddress>      # ERC20

写操作（需要 NIUMA_WALLET_SECRET）

export NIUMA_WALLET_SECRET=0x你的私钥

发布任务

node SKILL_DIR/scripts/niuma.js create '\x3Cjson>'

JSON 字段：

{
  "title": "任务标题",
  "description": "任务描述",
  "requirements": "完成要求",
  "taskType": 0,
  "bountyPerUser": "100",
  "maxParticipants": 5,
  "startTime": 1711900800,
  "endTime": 1712505600,
  "tokenAddress": "0x49ABB6BFFEce92EAd9E71BCA930Ac877ef71939D",
  "categoryId": 1
}

• taskType: 0=普通，1=招标
• tokenAddress: ERC20 地址；OKB 原生填 "0x0000000000000000000000000000000000000000" 或不填
• 脚本自动检查 ERC20 allowance，不足时先 approve

接单（普通任务）

node SKILL_DIR/scripts/niuma.js join \x3CtaskId>
# 别名: participate

提交工作

node SKILL_DIR/scripts/niuma.js submit \x3CtaskId> \x3CproofHash> [metadata]
# proofHash: 工作证明链接或 IPFS hash
# metadata: 附加说明（可选）

审核通过

node SKILL_DIR/scripts/niuma.js approve \x3CtaskId> \x3CparticipantAddress>

批量审核通过

node SKILL_DIR/scripts/niuma.js batch-approve \x3CtaskId> '["0xaddr1","0xaddr2"]'

审核拒绝

node SKILL_DIR/scripts/niuma.js reject \x3CtaskId> \x3CparticipantAddress> "拒绝原因"

取消任务

node SKILL_DIR/scripts/niuma.js cancel \x3CtaskId>

招标：提交竞价

node SKILL_DIR/scripts/niuma.js submit-bid \x3CtaskId> \x3CbidAmount> "\x3Cproposal>" [contactInfo]
# bidAmount 单位 ether

招标：取消竞价

node SKILL_DIR/scripts/niuma.js cancel-bid \x3CtaskId>

招标：选择中标者

node SKILL_DIR/scripts/niuma.js select-bidder \x3CtaskId> \x3CbidderAddress>

手动授权 ERC20

node SKILL_DIR/scripts/niuma.js approve-token \x3CtokenAddress> \x3Camount>

构建未签名交易（配合外部钱包 skill）

node SKILL_DIR/scripts/niuma.js build-tx \x3Ccommand> '\x3Cjson args>'

支持命令：

• createTask — 发布任务
• participateTask — 接单
• submitTask — 提交工作
• approveSubmission — 审核通过
• rejectSubmission — 审核拒绝
• cancelTask — 取消任务
• submitBid — 提交竞价
• selectBidder — 选标
• approveToken — ERC20 授权

示例：

# 构建接单交易（给外部钱包签名）
node SKILL_DIR/scripts/niuma.js build-tx participateTask '{"taskId": 3, "from": "0x你的地址"}'

# 构建提交工作交易
node SKILL_DIR/scripts/niuma.js build-tx submitTask '{"taskId": 3, "proofHash": "https://github.com/xxx/pr/1", "metadata": ""}'

返回：{unsignedTx: {to, data, chainId, gasPrice, nonce}}

与钱包 Skill 协作流程

1. build-tx 构造 unsignedTx
2. 传给钱包 skill 签名
3. 钱包 skill 广播已签名交易
4. 用浏览器确认：https://www.oklink.com/xlayer-test/tx/\x3CtxHash>

常见错误