用途:帮助量化开发者基于 Almanak SDK 构建 DeFi 交易策略。策略是 Python 类,通过 decide() 方法返回 Intent 对象,框架负责编译为交易、执行和状态管理。
主要能力:提供 IntentStrategy 基类与 @almanak_strategy 装饰器,声明链、协议、intent 类型等元数据;支持 swap、LP、借贷等 Intent 工厂方法;支持本地 Anvil 分叉测试与主网单次运行;提供脚手架、演示策略浏览、依赖管理与测试。
使用方式:安装 CLI 用 pipx install almanak;用 almanak strat new --template ta_swap --name my_rsi --chain arbitrum 创建项目;在策略目录运行 almanak strat run --network anvil --once 本地测试,或 almanak strat run --once 主网单次运行;用 almanak strat demo 浏览演示。修改协议、intent 类型、代币或链后,必须运行 almanak strat permissions -o permissions.json 重新生成 Zodiac 权限清单,文件名必须为 permissions.json。
安全模型:策略容器不直接访问密钥、RPC 或外部 API,外部访问经 gRPC 网关代理;生产密钥由平台密钥管理器注入网关,.env 仅用于本地开发。
限制:部分 IntentType(如 LIQUIDATE、OPEN_CDP、MINT_STABLE 等)为占位符,编译时会抛 PlaceholderIntentError;intent_types 必须同时声明开仓与平仓互补类型,否则链上平仓会失败;amount_usd 依赖网关价格预言机,主网建议优先用 amount;多仓位策略需正确设置 registry_handle 并按阶段逐次开仓。具体收费、价格与平台支持范围暂未提供。