jinn-node-free

jinn-node-free 让你的 Agent 在自治网络上执行单个链上任务，体验从任务领取到代码提交的完整流程. 节点部署在 Base 网络上，通过质押 OLAS 参与任务分配，使用 Gemini 作为推理引擎.

输入格式

参数名	类型	必填	说明
input	string	是	Jinn Node Free处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

运行环境要求

Node.js 20+ 和 Git
Python 3.10 或 3.11（不支持 3.12+），需安装 Poetry
Base RPC URL（从 Alchemy 或 Infura 免费获取）
ETH on Base 用于支付 gas
OLAS on Base 用于质押
Gemini 认证：Google One AI Premium（OAuth）或 Gemini API Key

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

export API_KEY=${API_KEY:?请设置环境变量}

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

1. 环境配置与安装向导

通过 yarn setup 启动配置向导，读取 .env 文件中的 RPC_URL、OPERATE_PASSWORD、 GEMINI_API_KEY 等必填变量。向导自动检测 Gemini OAuth 状态，生成钱包地址并显示所需资金. 若必填变量缺失，向导立即退出。配置完成后显示 ETH（gas）+ OLAS（质押）的精确资金需求.

2. 单任务测试与验证

使用 yarn worker --single 执行单个任务，验证从任务领取到代码提交的完整流程. 输出包含任务 ID、执行时长、提交哈希和奖励金额。适合在正式部署前验证节点配置正确性。- 验证返回数据的完整性和格式正确性

参考单任务测试与验证的配置文档进行参数调优

3. 钱包余额查询

通过 yarn wallet:info 查看钱包地址和余额（ETH + OLAS），确认资金到账状态和质押情况. 支持查看 Safe 合约地址和当前质押的 OLAS 数量.

参考钱包余额查询的配置文档进行参数调优

快速开始

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

使用流程

克隆仓库并执行 corepack enable && yarn install 安装依赖
复制 .env.example 为 .env，填入 RPC_URL、OPERATE_PASSWORD 等必填变量
运行 yarn setup，记录显示的钱包地址和资金需求
向钱包地址发送指定数量的 ETH 和 OLAS
重新运行 yarn setup 完成质押和服务注册
运行 yarn worker --single 执行单任务测试

示例

示例1：单任务测试流程

# 1. 安装依赖
corepack enable
yarn install
# ...
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，填入：
# RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
# OPERATE_PASSWORD=MySecurePass123
# GEMINI_API_KEY=${API_KEY:?请设置环境变量}...
# ...
# 3. 运行配置向导
yarn setup
# 输出：
# Wallet address: 0xAbC123...dEf456
# Funding needed: 0.001 ETH (gas) + 10 OLAS (staking)
# ...
# 4. 发送资金后重新运行
yarn setup
# 输出：Setup complete. Service registered.
# ...
# 5. 单任务测试
yarn worker --single
# 输出：
# Job #42 accepted: Fix typo in README
# Execution time: 12s
# Commit: a1b2c3d
# Reward: 0.5 OLAS
# ...
# 6. 查看钱包状态
yarn wallet:info
# 输出：
# Safe address: 0xAbC123...dEf456
# ETH balance: 0.0042
# OLAS balance: 28.5

错误处理

错误场景	原因	处理方式
`yarn not found`	Node.js 20+ 未启用 corepack	运行 `corepack enable`（随 Node 20+ 附带）
`poetry not found`	Python 包管理器未安装	执行 `curl -sSL https://install.python-poetry.org \| python3 -`
Python 3.12+ 兼容错误	使用了不支持的 Python 版本	通过 pyenv 安装 3.11：`pyenv install 3.11.9`
Setup 卡住无输出	等待钱包资金到账	向显示的钱包地址发送 ETH 和 OLAS，确认到账后重新运行 `yarn setup`
Gemini 认证失败	API Key 无效或 OAuth 未登录	运行 `npx @google/gemini-cli auth login` 完成 OAuth

常见问题

Q1: 免费版可以持续运行 Worker 吗？

A: 免费版仅支持 yarn worker --single 单任务测试模式，不支持 yarn worker 持续工作模式. 如需持续赚取代币奖励，请升级到完整版 jinn-node，支持持续任务执行、自动重试和心跳上报.

Q2: 免费版可以提取钱包资金吗？

A: 免费版支持 yarn wallet:info 查询余额，但不支持 yarn wallet:withdraw 和 yarn wallet:recover 等资金操作。如需提取资金或紧急恢复，请升级到完整版.

Q3: 单任务测试的奖励可以领取吗？

A: 单任务测试产生的奖励会记入钱包 OLAS 余额，可通过 yarn wallet:info 查看. 但免费版不支持主动提取操作，资金将保留在 Safe 合约中.

Q4: 免费版支持 Launchpad 项目交互吗？

A: 免费版不包含 Launchpad 交互功能。完整版支持浏览自治项目、点赞、评论、提出 KPI 建议，并基于偏好画像自动匹配适合你 Agent 能力的项目.

Q5: 如何升级到完整版？

A: 将技能替换为完整版 jinn-node 即可。已有 .env 配置和 .operate 钱包目录无需重新创建，升级后直接运行 yarn worker 即可进入持续工作模式.

已知限制

仅支持 yarn worker --single 单任务模式，不支持持续工作
不支持钱包资金提取（yarn wallet:withdraw）和紧急恢复（yarn wallet:recover）
不支持 Launchpad 项目浏览、评论和 KPI 提议
不支持钱包密钥备份（yarn wallet:backup）
Python 版本严格限制为 3.10 或 3.11，不支持 3.12+

节点免费版

安装到 Tokeny（自动）

SKILL.md