DeBox Community

Manage DeBox communities, DAOs, and NFT groups. Use when you need to verify group membership, check voting/lottery participation, query group info, or validate user eligibility for DAO/NFT communities. Supports group info lookup, member verification, vote/lottery stats, and praise data queries. Ideal for DAO membership verification, NFT community access control, and community analytics.

DeBox Community Management

Manage DeBox communities, verify membership, and analyze community engagement.

Quick Start

Configuration

Set the DEBOX_API_KEY environment variable:

export DEBOX_API_KEY="your-api-key"

Or add to ~/.openclaw/workspace/debox-community/config.json:

{
  "apiKey": "your-api-key",
  "defaultGroupId": "optional-default-group-id"
}

Get your API Key from https://developer.debox.pro

Commands

Personal Data Report (推荐)

查看你的 DeBox 个人数据报告：

node scripts/debox-community.js profile --user-id "abc123"

Returns: 昵称、用户ID、钱包地址、等级、点赞数据

如何获取 user_id：

1. 打开 DeBox App
2. 进入个人主页
3. 点击分享，复制链接
4. 链接中的 id 参数就是 user_id

Group Info

Query group information:

node scripts/debox-community.js info --url "https://m.debox.pro/group?id=fxi3hqo5"

Returns: group name, member count, description, creator.

Member Verification

Check if a user is in a group:

node scripts/debox-community.js check-member --wallet "0x2267..." --group-url "https://m.debox.pro/group?id=fxi3hqo5"

Returns: boolean membership status.

User Profile

Get user profile information (nickname, avatar, wallet address):

node scripts/debox-community.js user-info --user-id "abc123"

Returns: user_id, nickname, avatar, wallet address.

Note: This API only supports user_id, not wallet address.

Vote Stats

Query user's voting activity in a group:

node scripts/debox-community.js vote-stats --wallet "0x2267..." --group-id "fxi3hqo5"

Returns: vote count, recent votes.

Lottery Stats

Query user's lottery participation:

node scripts/debox-community.js lottery-stats --wallet "0x2267..." --group-id "fxi3hqo5"

Returns: lottery count, win history.

Praise Info

Get user's praise/like data:

node scripts/debox-community.js praise-info --wallet "0x2267..." --chain-id 1

Returns: total likes received, recent praise.

Comprehensive Verification

Verify user eligibility with multiple criteria:

node scripts/debox-community.js verify --wallet "0x2267..." --group-url "..." --min-votes 5 --min-lotteries 1

Returns: pass/fail status with detailed breakdown.

API Reference

See references/api.md for complete API documentation.

Use Cases

DAO Membership Verification

Verify if a user is a DAO member with voting history:

node scripts/debox-community.js verify --wallet "0xabc..." --group-url "https://m.debox.pro/group?id=dao123" --min-votes 1

NFT Community Access

Verify NFT holder is in community group:

node scripts/debox-community.js check-member --wallet "0xabc..." --group-url "https://m.debox.pro/group?id=nft456"

Whitelist Generation

Batch verify multiple wallets:

node scripts/debox-community.js batch-verify --file wallets.txt --group-url "..." --min-votes 3

Error Handling

Error	Cause	Solution
INVALID_API_KEY	API key missing or invalid	Check configuration
GROUP_NOT_FOUND	Group ID/URL invalid	Verify group URL format
USER_NOT_FOUND	Wallet address not registered	Confirm user has DeBox account
RATE_LIMIT	Too many requests	Wait and retry

Environment Variables

Variable	Required	Description
DEBOX_API_KEY	Yes	Your DeBox API key
DEBOX_DEFAULT_GROUP	No	Default group ID for commands