Skip to content
Menu

almanak-co sdk

Utility

Verified Builder

Production-grade DeFi strategy framework for Quantitative Analysts, Traders and Researchers

ShippingLast ship 1h ago
WebsiteGitHubSources

Latest ship

Active development: 100 commits across 1 contributor

Code ActivitySource linked

15 active day(s) in almanak-co/sdk.

View evidence ↗

Builder activity

Meaningful, source-backed updates per week. Commits are aggregated, not counted individually.

Build timeline

  1. v2.27.0

    Github ReleaseSource verified

    ## Features - **Self-describing pool prices** — `get_pool_state` / `ax pool` now carry both price directions plus a unit-labeled price string, and the ALMANAK token resolves to its liquid Ethereum market. (#3813) - **Lending market inspection from the CLI** — new `ax lending-market` command verifies on-chain lending market identity before execution. (#3838) - **Exact-address venues for Aerodrome and TraderJoe V2** — bare pool addresses are authenticated on-chain for LP flows, and Aerodrome swaps honor pool pinning. (#3828) - **Year-long hourly backtests** — hosted budget and adaptive page fetc

    View evidence

  2. v2.26.2

    Github ReleaseSource verified

    ## Features - **Verified pool discovery and inspection** — inspect Curve, Aerodrome Classic, and Uniswap V4 pools by pair or address, with connector-owned factory/registry verification. (#3800, #3801, #3802) - **Managed data gateway safety** — persistent credential-isolated sidecar, readiness reporting, and an explicit no-spawn guard for managed environments. (#3803) - **Almanak Code v1.0.55** — mid-turn steering, stronger linked-repository layout handling, and cleaner completion/cancellation behavior. (#3798, #3808, #3809, #3811, #3812) ## Fixes - **Debt-correct lending NAV** — gross supply a

    View evidence

  3. v2.26.1

    Github ReleaseSource verified

    ## Features - **Exact-pool OHLCV observations** — candles bind to the exact venue/pool, authenticated end-to-end through the gateway. (#3777) - **Exact Uniswap-V3 TWAP observations** — resolve the exact pool; fail closed on provider/transport faults. (#3749) - **Exact-venue binding for Curve swaps** — bind to a verified pool identity, reject malformed venue identity. (#3768) - **Exact-venue binding for Slipstream (Aerodrome CL) LP** — bind to receipt-derived NPM manager generation; teardown resolves CL manager authority from connector-owned roles. (#3747) - **Fail-closed exact data consumer ac

    View evidence

  4. v2.26.0

    Github ReleaseSource verified

    ## Features - Verified exact-venue data plane for pool snapshots, history, and fail-closed venue contracts (#3721, #3744, #3745, #3748) - Historical exact-pool backtesting, including Curve APY history (#3760, #3763) - Typed asset identity and token metadata across chain-aware market-data paths (#3730, #3743, #3752) - Safer canonical slippage and basis-point-native bounds (#3728, #3766) - Measured price provenance and exact-address stablecoin depeg checks (#3727, #3729) - Dynamic, verified GMX market discovery (#3756) - PEP 561 typing, expanded DTO docs, and Almanak Code v1.0.48 guidance (#3719

    View evidence

  5. v2.25.1

    Github ReleaseSource verified

    Highlights since v2.25.0. See the [CHANGELOG](https://github.com/almanak-co/almanak-sdk-private/blob/main/CHANGELOG.md) for the full detail. ## Features - **Aave V3 expected-pool assertion.** Supply and withdraw intents accept an optional `expected_pool` address, validated and matched against the canonical registry Pool before any approval or calldata, failing closed on drift. Never a routing override. (#3707) - **`almanak strat test` lifecycle path coverage.** Test output now classifies action and teardown evidence and exposes `requested_paths_exercised`, so a HOLD or empty teardown is never

    View evidence

  6. v2.25.0

    Github ReleaseSource verified

    Highlights across 227 merged PRs since v2.24.0. See the [CHANGELOG](https://github.com/almanak-co/almanak-sdk-private/blob/main/CHANGELOG.md) for the full detail. ## Breaking Changes - **GMX V2 markets are address-first.** Declare the market-token address (`Intent.perp_open(market="0x…")`); the curated `GMX_V2_MARKETS` / `GMX_V2_INDEX_TOKEN_DECIMALS` tables and `index_price_symbol` / `index_token_decimals` are deleted from `almanak.connectors.gmx_v2.addresses`. **Migration:** add `market_address` to GMX configs and run `almanak/framework/cli/repair_position_references.py` on legacy symbol-shap

    View evidence

  7. v2.24.0

    Github ReleaseSource verified

    ## Features - **LiFi compiles `BridgeIntent` directly.** The LiFi manifest advertised `BRIDGE` but `LiFiCompiler` only declared `SWAP`, so production bridging had to be expressed as a cross-chain `SwapIntent`. `compile_bridge` now routes through LiFi's cross-chain route path. (#3397, #3388) - **Verified lending-market resolution (VIB-5985).** A `market_id` can only enter a config after on-chain proof. `ListLendingMarkets` returns every curated-catalog candidate (address-resolved filters; never ranks or auto-picks), `GetLendingMarket` recomputes the id from `idToMarketParams(id)` and compares —

    View evidence

  8. v2.23.0

    Github ReleaseSource verified

    ## Breaking Changes - **Hyperliquid perp opens fail closed on non-1x leverage.** CoreWriter has no set-leverage action, so a requested `leverage` was never applied on-venue — positions opened at the account's per-asset default (e.g. 20x cross), surfaced only as a warning. `PERP_OPEN` requesting non-1x leverage is now **rejected at compile time** unless the strategy explicitly opts in with the new `Intent.perp_open(accept_venue_leverage=True)` (default `False`); the venue-observed leverage is still recorded post-fill. Venues that do set leverage on-venue (GMX V2) ignore the flag. (#3354) ## Fea

    View evidence

  9. v2.22.0

    Github ReleaseSource verified

    ## Breaking Changes - **aave_v3 on `plasma` no longer passes the runtime chain gate** (config-level). The chain was never proven and is no longer advertised; a config pairing `aave_v3` with `plasma` now fails at boot with a `ConfigurationError` instead of failing on-chain later. Re-enabling requires a manifest + proof run (see the VIB-5916 pattern). ## Features - **Aave V3 on Linea** — the aave_v3 connector declares `linea`, backed by four-layer intent tests on a Linea fork, Safe permission regression, managed-Anvil + separate-signal teardown E2E, and a chain-confirmed mainnet round trip. Line

    View evidence

  10. v2.21.0

    Github ReleaseSource verified

    ## Breaking Changes - **The `Chain` enum is removed** (`almanak.Chain`, `almanak.core.enums.Chain`, VIB-4851). Chain identity is the canonical lowercase name string resolved through `almanak.core.chains.ChainRegistry`. Migration: `Chain.ETHEREUM` → `"ethereum"`; `Chain[s]` / `Chain(s)` → `ChainRegistry.resolve(s)` (or `try_resolve`); `list(Chain)` → `ChainRegistry.names()`. Serialized wire/DB chain values are now lowercase; read paths stay case-insensitive forever, so existing persisted records keep deserializing. Chains are fully self-registered — adding a chain is one descriptor file under `

    View evidence

  11. v2.20.0

    Github ReleaseSource verified

    ## Features - **Pendle PT accounting vertical** — completes Principal-Token accounting on the 2.19.0 PT/YT price foundation: PT Accountant gate (matrix + CLI + QA checklist), typed `PendleAccountingEvent` cells, open-PT mark-to-market via the gateway implied-price, realized-yield PnL on disposal, held-PT inventory in the dashboard, PT/YT price telemetry, and a `pendle_basics` demo. - **CAIP-2 / CAIP-19 identity layer** — additive interop for chain ids (`eip155:42161`) and asset ids, built on a new typed `TokenRef`; `resolve("eip155:42161") ≡ resolve("arbitrum")`. Native `slip44` for ETH-chains

    View evidence

  12. v2.19.1

    Github ReleaseSource verified

    ## Changed - **Backtesting is enabled by default** (VIB-5130). The `ALMANAK_ENABLE_BACKTESTING` opt-in flag is removed now that the backtesting v1 conservation work (VIB-5079) has landed in v2.19.0 — `almanak strat backtest` and `almanak backtest-service` run without it. Treat PnL-engine output as carrying the documented variance bounds (blueprint 31 §7) and certify on the paper trader before going live; perp support remains beta. Any existing `ALMANAK_ENABLE_BACKTESTING=1` setting is now a harmless no-op. --- **Full changelog**: compare [`v2.19.0...v2.19.1`](https://github.com/almanak-co/alma

    View evidence

  13. v2.19.0

    Github ReleaseSource verified

    ## Features - **Pendle PT/YT vertical** (#2945, #2949, #2950, #2951, #2940): gateway PT/USD price provider (composes the on-chain PT rate with the underlying price), `MarketSnapshot.pt_price` over a new `GetPtPrice` gateway contract, and PT/LP USD valuation with buy-time cost basis. - **Fluid connectors** (#2802, #2765, #2806): `fluid_dex_lp` (Fluid SmartLending fungible DEX LP) and `fluid_vault` (NFT-CDP borrow/repay). - **Accounting valuation hardening** (#2904, #2906, #2907, #2908, #2910, #2911, #2913, #2914, #2857, #2830): typed `MeasuredMoney` (Empty≠Zero by construction) and `PrimitiveMo

    View evidence

  14. v2.18.0

    Github ReleaseSource verified

    ## Features - **Safer leverage teardown** (#2542): health-factor-aware unwind for leverage loops, plus Morpho health and market-state fixes. - **Strategy quote assets** (#2659, #2734): scaffolds and demos now emit explicit `quote_asset` metadata. - **Fluid support expansion** (#2682, #2723): Fluid DEX swaps and fToken lending supply/withdraw flows. - **Uniswap V4 accounting and valuation** (#2681, #2680, #2732): position registry support, high-confidence LP valuation, and measured uncollected fees. - **Deterministic mainnet probes** (#2748): nightly probe runner with budget gates and structure

    View evidence

  15. v2.17.0

    Github ReleaseSource verified

    ## Features **Three new lending connectors and a unified lending read path** Benqi, Euler V2, and Silo V2 are now first-class lending connectors with full pre/post-state readers. Spark joins Aave V3, Compound V3, and Morpho Blue on a single generic `LendingAccountStateCapability`, so adding the next lending protocol is now a connector-local change rather than a framework rewrite. (VIB-4929, VIB-4963–VIB-4967) **Connector self-containment epic — first major drop** Protocol code (intent compilers, address tables, receipt parsers, capability registries, synthetic-intent discovery, contract-role t

    View evidence

  16. v2.16.0

    Github ReleaseSource verified

    # v2.16.0 First minor release since v2.15.0 (April 23, 2026). 248 PRs across breaking changes, accounting infrastructure, new chains/connectors, dashboard, gateway services, and bug fixes. ## Breaking Changes ### PAUSE / RESUME lifecycle commands retired (VIB-4281) The `PAUSE` and `RESUME` lifecycle commands have been removed from the gateway's `LifecycleService`; the runner accepts only `STOP`. The V2 platform pause/resume endpoints return `410 Gone`. The new three-action UX model is **Stop** / **Teardown** / **Emergency Stop**. CLI surfaces `almanak strat pause` / `almanak strat resume` stil

    View evidence

  17. v2.15.0

    Github ReleaseSource verified

    ## Highlights - **Aerodrome Slipstream (CL)** connector on Base — tick-based concentrated liquidity LP with open/close/collect lifecycle and an `aerodrome_slipstream_lp` demo strategy. - **Generalized ERC-4626 vaults** — `Intent.vault_deposit/redeem` now dispatches to any ERC-4626 compliant vault, not just MetaMorpho. - **`StrategyDataRequirements`** — declare which market data your strategy needs; the runner skips unused fetches. - **Zodiac on-chain permission harness** — SWAP, LEND, and LP connector coverage verified against a real Roles Modifier on every PR. - **`DATA_ERROR` escalation** —

    View evidence

  18. v2.14.0

    Github ReleaseSource verified

    ## Highlights - Curvance isolated lending on Monad (new connector). - Aster Perps Phase 1 extraction: canonical `aster_perps` package, `PerpCloseIntent.position_id` for direct compiler close, 3x BNB/USD demo strategy. `pancakeswap_perps` becomes a shim with a one-shot `DeprecationWarning`. - Four new CLI surfaces: `almanak strat pnl`, `almanak strat check`, `almanak ax lp-list` / `lending-list` / `portfolio`, and `almanak ax lending-*` action shortcuts. - **Fail-closed semantics** in the compiler and `ResultEnricher`: no more placeholder prices feeding slippage math; pool/tick validation raise

    View evidence

  19. v2.13.0

    Github ReleaseSource verified

    ## Features - **PancakeSwap Perps** - Full connector on BSC (ApolloX) with 4-layer intent tests, demo strategy, and delta-neutral dynamic LP strategy (PCS V3 + PCS Perps hedge) (#1506, #1511) - **Morpho Blue on Monad & Polygon** - Chain-specific deployments with 5 new markets, WPOL/POL token aliases (#1526, #1529) - **Token resolution overhaul** - 2500-token pre-populated JSON registry, negative cache, DexScreener fallback for EVM symbol resolution, address-based pricing for unknown tokens, `almanak ax resolve` CLI (#1525, #1530, #1532) - **5 new demo strategies** - Silo V2, Joe Lend, Euler V2

    View evidence

  20. v2.12.0

    Github ReleaseSource verified

    ## Features - **5 new lending connectors** - Euler V2 (Avalanche + Ethereum), Silo V2, Joe Lend, BenQi on Avalanche (#1409, #1453, #1407, #1404, #1402) - **0G Chain integration** - Full chain support with Gimo Finance liquid staking connector and demo strategies (#1456) - **Yield-aware paper trading** - Persistent Anvil fork, YieldPoker for protocol-specific yield accrual (Aave V3, Compound V3, Morpho Blue), PnLBreakdown, and teardown on shutdown (#1428, #1441) - **Dashboard Accounting (Phases 1-4)** - Rich accounting data, three-tier identity model, equity curve, metrics engine, write-side tr

    View evidence

  21. v2.11.1

    Github ReleaseSource verified

    ## Changes - **Scaffold in dotfile directories** - `almanak strat new -o .` now works in directories that only contain dotfiles like `.almanak/` (#1374) - **almanak-code v0.2.13** - Workflow audit fixes, agent prompt corrections, unified create-and-deploy workflow (#1362) ## Fixes - Fix nightly probe bugs: stranded LP position from int/str mismatch, phase corruption on execute failure, missing pre-flight balance checks (#1373) - Default `balancer_flash_arb` demo to HOLD to eliminate spurious nightly reverts (#1370) - Fix flaky copy replay test under pytest-xdist (#1375) - Update gateway troubl

    View evidence

  22. v2.11.0

    Github ReleaseSource verified

    ## Features - **Radiant V2 lending connector** - New Aave V3-fork lending protocol on Arbitrum (#1334) - **Paper trading system** - Bootstrap config with decide() dry-run inference, paper-local token override registry, and two-tier validation (#1355, #1356, #1297) - **Paper Trading Dashboard** - Full dashboard integration with portfolio tracking, transaction ledger, data export, and PM integration (#1342, #1327) - **Portfolio valuation pipeline** - Multi-provider valuation with circuit-breaker failover, Zerion integration, reconciliation, and SavePortfolioMetrics/GetPortfolioMetrics gRPC endpo

    View evidence

  23. v2.10.0

    Github ReleaseSource verified

    ## Features - **X-Layer chain support** - Aave V3.6 carry trade and LP rebalance demo strategies on X-Layer (#1252) - **Monad production activation** - Demo strategies and full infra support for Monad mainnet (#1248) - **Lido stETH + Aave V3 composition** - Stake ETH, wrap to wstETH, supply to Aave V3 on Ethereum (#1228) - **Morpho Blue wstETH lifecycle** - Full borrow/repay/withdraw lifecycle on Base (#1238, #1261) - **SushiSwap V3 + Aave V3 composition** - First SushiSwap V3 execution on Arbitrum with Aave V3 lending (#1256) - **Morpho Blue + Enso lifecycle** - Cross-protocol composition on

    View evidence

  24. v2.9.0

    Github ReleaseSource verified

    ## Features - **Intent.wrap() and Intent.unwrap()** - New factory methods for native token wrapping/unwrapping (ETH<->WETH, etc.) (#1196) - **Polish circuit breaker** - Quality gates for strategy execution (#1229) - **Lido enricher** - Exposes wstETH amount for `receive_wrapped=True` (#1230) - **GeckoTerminal DEX OHLCV** - Fallback price source with gRPC proxy for deployed mode (#1112, #1200) - **Teardown intent introspection** - Automatic protocol discovery from teardown intents (#1193) - **Morpho Blue on Arbitrum** - New chain support with Uniswap V3 yield stack strategy (#1234) - **Curve St

    View evidence

Research notes

Written by HEY researchers and reviewed before publishing. Commentary with sources — not the project's own claims, and not evidence of shipping.

No published notes on almanak-co sdk yet.

    Know something about almanak-co sdk? Sign in with GitHub to submit a research note. Notes are reviewed before they appear here.

    Sources