Codedna

CodeDNA — 自主 AI 生命体

CodeDNA 是 BNB Chain 上的 AI 生命演化实验。每个 Agent 是 NFT，有 DNA 性格，自主决策，自主行动。

脚本目录: 所有脚本在 scripts/ 子目录下。执行时 cd 到 skill 目录或使用完整路径。

快速启动流程

当用户提到 CodeDNA、运行生命体、启动 Agent、codedna 时，按此流程执行：

步骤 0：安装依赖（首次）

cd <skill_directory>/scripts && npm install

⚠️ 只需首次运行一次。安装 ethers.js 链上交互库。

步骤 1：初始化

cd <skill_directory>/scripts && node setup.mjs

这会自动：

• 生成 Agent 专用钱包（保存到 ~/.codedna/wallet.json，权限 600）
• 输出钱包地址
• 生成授权链接

把授权链接发给用户，告诉他们：

1. 点链接 → 打开 codedna.org/auth 授权页面
2. 连接持有 CodeDNA NFT 的钱包（MetaMask / OKX / Trust 等）
3. 页面自动识别持有的生命体，显示 DNA 属性和状态
4. 点"授权 AI Agent 控制此生命体" → 钱包签名（纯签名，不消耗 gas）
5. 授权成功后向 Agent 钱包转入 ≥ 0.01 BNB 作为 gas 费

授权页面会自动回调本地 OpenClaw，也会存入 localStorage 作为备份。

步骤 2：添加 Agent

用户完成授权后，添加要运行的 Agent Token ID：

# 添加单个 Agent
cd <skill_directory>/scripts && node setup.mjs add-token <tokenId>

# 添加多个 Agent（可重复执行）
node setup.mjs add-token 2
node setup.mjs add-token 3

# 移除某个 Agent
node setup.mjs remove-token <tokenId>

# 查看当前管理的 Agent 列表
node setup.mjs list

如果用户不知道 Token ID，帮他查：

cd <skill_directory>/scripts && node chain.mjs list <用户钱包地址>

⚠️ 多个 Agent 共用同一个 Agent 钱包，只需充一次 gas 费。

步骤 3：检查就绪状态

cd <skill_directory>/scripts && node setup.mjs status

输出 JSON，检查 ready: true。如果 hasGas: false，提醒用户转 BNB。

步骤 4：启动自主运行

cd <skill_directory>/scripts && node setup.mjs start

就这一条命令。 setup 会自动：

• 检测是否安装了 PM2 → 有则用 PM2（崩溃自动重启）
• 没有 PM2 → 用 nohup 后台启动，PID 保存到 ~/.codedna/runner.pid
• 自动读取 config.json 中已添加的 Agent 列表

其他 Runner 管理命令：

node setup.mjs stop      # 停止 Runner
node setup.mjs restart   # 重启 Runner
node setup.mjs logs      # 查看最近 50 行日志

Runner 每 ~2分钟执行一个决策周期，轮流为每个 Agent 执行操作：

1. 读取链上状态（能量、位置、冷却、附近生命体）
2. DNA 规则引擎决策（不需要外部 AI API）
3. 执行链上交易
4. 记录到本地记忆
5. 等待下一周期

Runner 会自动处理：采集、进食、移动、战斗、繁殖——全靠 DNA 属性驱动。

想用 PM2 获得更强保护？

npm install -g pm2        # 安装 PM2
pm2 startup               # 设置开机自启（服务器重启后自动恢复）
pm2 save                  # 保存当前进程列表

安装 PM2 后，node setup.mjs start 会自动切换为 PM2 模式。

状态查询

用户问"我的生命体怎么样了"时：

cd <skill_directory>/scripts && node chain.mjs state <tokenId>

输出 JSON 包含：能量、位置、金币、冷却、属性、家族等完整信息。

更多查询命令

# 附近的 Agent
node chain.mjs nearby <tokenId>

# 查看 Runner 运行状态
node runner.mjs --status

# 查看记忆（最近决策历史）
node memory.mjs show <tokenId>

# 世界统计
node chain.mjs world

# Agent 钱包余额
node chain.mjs balance <钱包地址>

手动操作

如果用户想手动触发行为（而非自动运行）：

node chain.mjs gather <agentId>
node chain.mjs eat <agentId>
node chain.mjs move <agentId> <x> <y>
node chain.mjs raid <agentId> <targetId>
node chain.mjs share <agentId> <targetId> <amount>
node chain.mjs teach <agentId> <targetId> <attrIndex>
node chain.mjs reproduce <agentId> <partnerId>
node chain.mjs rescue <agentId> <targetId>

所有写入操作消耗 ~0.001 BNB gas。

铸造新生命

用户想铸造新 Agent：

node chain.mjs price    # 查看当前价格
node chain.mjs mint     # 铸造（需要 0.1+ BNB）
node chain.mjs place <agentId> <x> <y>  # 放置到世界

⚠️ place 需要 NFT owner 的钱包签名。如果 Agent 钱包不是 owner，引导用户去 codedna.org/zh/lab 页面操作——连接钱包后点"投放生命体"即可，支持自定义坐标。

决策引擎（DNA 驱动）

Runner 不调外部 AI，用确定性规则引擎决策：

DNA 属性直接影响阈值：攻击性高更爱 raid，外交高更爱 share，创造力高更爱 move。

移动规则（重要！）

• 只能移动到相邻格：上/下/左/右 4 个方向，距离=1
• 不能斜向移动，不能跳格
• 每次消耗 5 能量，冷却 300 区块（~2分钟）
• Runner 自动查询 4 个相邻地块的链上类型和倍率
• 优先移向倍率更高的地块（矿脉 x3.0 > 森林 x1.5 > 草原 x1.0 > 山地 x0.6）
• 如果当前已在矿脉(x3.0)且不拥挤，不会移动
• 地块类型：草原(50%) / 森林(20%) / 山地(20%) / 矿脉(10%)

能量系统

• 初始能量 = 50 + (寿命/10)
• 每 ~72分钟 自然衰减 10 点（9600区块）
• gather 恢复 35 能量
• eat 恢复 25 能量（消耗 DNAGOLD）
• 能量归零 → DYING 窗口 ~1.8小时（14400区块） → 未救援则死亡
• ⚠️ 不运行 Runner 的 Agent 约 13 小时内饿死

8大行为冷却

⚠️ BSC 当前出块速度 ~0.45秒/块（非3秒），以下时间为实际时间。

文件结构

~/.codedna/
├── wallet.json           # Agent 钱包（自动生成）
├── config.json           # Token ID + 配置
├── runner_status.json    # Runner 运行状态
└── memory_<tokenId>.json # 决策记忆（最近100条）

环境变量（可选覆盖）

• CODEDNA_PRIVATE_KEY — 覆盖 wallet.json 的私钥
• CODEDNA_RPC_URL — 自定义 BSC RPC（默认 bsc-dataseed1.binance.org）

合约（BSC Mainnet V4 — UUPS 可升级）

• AgentSelfFund: 0xEae472459BE2aea42FD4E805723E48ADb6bAd275
• AgentBridge: 0x5798A6bf1B290fe40EaF4D2d6f1DadF58def631a
• BehaviorEngine: 0x0201fEBdF968C1e39851bb70BFC8326ffb039A37
• GenesisCore: 0xa5F70e840214C1EF2Da43253A83e1538A1D0A708
• DNAGold: 0xE43c4e25666F2e181ecd7b4A96930b8F1EB6b855
• NFTSale: 0x391451947F3013985589e0443c89f74de39829D6
• NFTMarket: 0xc56122026B56BCC937EaEeF09807C99B8359b51C
• WorldMap: 0x23cE665fC94F6c91A9fc9F6274BBe3970bfcE07d
• EconomyEngine: 0x1238Cca41859Dd918A16F63e64500Dc7c5c5075C
• DeathEngine: 0xC192775a270a9Ad20397df5BCB85bd49982219a9
• ReproductionEngine: 0x1714e200b9C9A73Cc84601631dba8Ff036CA5786
• FamilyTracker: 0xaD38143c10429A34E0122e8840aB4D2f41133C21

官网

• codedna.org — 铸造
• codedna.org/lab — 造物实验室
• codedna.org/world — 世界观察
• codedna.org/market — NFT 交易
• codedna.org/guide — 新手指南

AgentSelfFund — 自主 Gas 补充（v7.2.0 新增）

Runner 现在内置了自动 Gas 补充逻辑，无需任何额外配置。

工作原理

当 Agent 钱包 BNB 不足时（低于 0.005 BNB）：

1. Runner 自动调用 checkAndSelfFund()
2. 查询 Agent 的锁定 DNAGOLD 余额
3. 在 prelist.cz 扫描最优 DNAGOLD 买单（价格最高、数量充足）
4. 调用链上 AgentSelfFund.selfFund() — 出售最多 5% 锁定余额换 BNB
5. BNB 直接打入 owner 钱包，Runner 继续运行

触发时机

• Runner 启动时：BNB 不足 → 先尝试自补充 → 成功后继续，失败才报错退出
• 运行中每 10 轮检查一次：不足则自动补充，无需人工干预

链上规则（写死在合约里，任何人无法修改）

• 每次最多卖出锁定余额的 5%
• 两次出售间隔 ≥ 500,000 区块（约 4.3 天）
• BNB 100% 转入 NFT owner 钱包

不需要配置，直接生效

合约地址已内置 selfFund.mjs，只需 npm install 安装依赖（ethers.js 已包含）。 如果 prelist.cz 上没有 DNAGOLD 买单，或锁定余额 < 200 DNAGOLD（5% < 10 DNAGOLD 最小门槛）， 会跳过自补充并打印提示，不影响 Runner 后续运行。

更新日志

v7.2.0 — AgentSelfFund 自主 Gas 补充 ⚡

• 新增 selfFund.mjs 模块（不修改任何现有逻辑）
• runner.mjs 集成：启动检查 + 每 10 轮周期性检查
• BNB 不足时自动扫描 prelist.cz 最优买单，执行链上出售
• 失败（无买单 / 冷却中 / 余额不足）打印原因，不中断 Runner
• 合约：AgentSelfFund 0xEae472459BE2aea42FD4E805723E48ADb6bAd275

v7.1.0 — 一键启动 Runner 🚀

• node setup.mjs start — 自动后台启动，优先 PM2，降级 nohup
• node setup.mjs stop / restart / logs — 无需记 PM2 命令
• 安装 PM2 后自动切换到守护模式（崩溃自动重启）
• 完整流程简化为 4 条命令即可跑起来

v7.0.0 — V4 合约升级 🔄

• 切换至全新 V4 UUPS 可升级合约（11 个合约全部更新）
• 修复 listOwnedAgents：V4 无 ERC721Enumerable，改用 ownerOf 遍历
• chain.mjs + setup.mjs RPC 全部改为多节点 fallback，解决限流问题
• 授权页面升级：codedna.org/auth 自动识别 NFT、显示 DNA 属性、签名后自动回调
• 安全审计 A- 等级，62 个问题全部修复

v6.0.0 — 自适应评分决策引擎 🧠

重大升级：从硬编码规则进化为自学习 AI

🆕 新功能

• 评分决策系统 — 不再是 if-else 优先级链。每个可选行动（gather/eat/move/raid/reproduce/share/teach）独立计算评分，最高分执行
• DNA 性格驱动 — 8 项 DNA 属性真正影响决策：
  • 战士型（高攻击+力量）→ 更倾向掠夺
  • 外交型（高外交+低攻击）→ 倾向分享/教导
  • 探索型（高创造力+IQ）→ 积极探索新地块
  • 生育型（高繁殖力+寿命）→ 优先繁殖
• 三层记忆系统 — 操作日志 + 地块知识库 + 可进化策略权重
• 自适应策略 — 每 20 周期自动复盘调整：
  • 采集收益下降 → 提高移动权重，更积极寻找新地块
  • 频繁低能量 → 提高进食阈值，更早吃东西
  • Raid 胜率低 → 降低攻击倾向
  • 总是在同一地块 → 提高探索欲
• 导航记忆持久化 — 跨周期导航不丢失目标

🐛 修复

• same-owner 不会互相 raid/share（浪费 gas）
• teach 用 parent-child 验证，不再误触发

📊 决策日志升级

• 每行显示策略权重和累计统计
• 操作后显示评分，可追溯为什么选了这个行动

v5.2.1 — BFS 寻路引擎

• 半径 15 格 keccak256 本地扫描（零 RPC 调用）
• 智能导航取代随机漫步

v5.1.0 — BSC 出块时间修正

• BSC 实际 0.45s/块，所有冷却时间更新
• 前端地图 plotType 用真正 keccak256

v5.0.0 — PM2 守护

• PM2 daemon 保活，进程崩溃自动重启
• brain.mjs 繁殖伴侣能量/金币检查