@somm/shared

Shared library for Ymax cross-chain yield management tooling. Used by @somm/ymax-agent-kit and the CLI.

What it exports

• YDS client — typed HTTP client for the Ymax Data Service API (portfolios, instruments, history, operations)
• Strategy engine — constraint-based allocation scoring (yield + curator diversity), rebalance gating
• EIP-712 signing — SetTargetAllocation message signing with Agoric smallcaps encoding
• Vault risk resolver — queries Morpho public GraphQL for per-vault risk scores keyed by YDS instrument ID
• Shared types — Instrument, Portfolio, StrategyConfig, ScoredInstrument, VaultRiskResult, etc.

Install

npm install @somm/shared

Usage

import { resolveVaultRisks } from '@somm/shared/vault-risk-resolver';

const risks = await resolveVaultRisks();
for (const r of risks) {
  console.log(`${r.instrumentId}: ${r.tier} (${r.compositeRisk.toFixed(3)})`);
}

import { YdsClient } from '@somm/shared/yds-client';

const client = new YdsClient('https://ymax.app');
const portfolio = await client.getPortfolio('portfolio145');
console.log(`Value: $${portfolio.latestSnapshot.totalValueUsdc}`);

Subpath exports

| Path | What | |------|------| | @somm/shared | Everything (barrel export) | | @somm/shared/types | Type definitions and constants | | @somm/shared/strategy | Allocation engine and rebalance logic | | @somm/shared/yds-client | YDS API client | | @somm/shared/eip712 | EIP-712 signing and Agoric encoding | | @somm/shared/vault-risk-resolver | Morpho-native vault risk scoring | | @somm/shared/vault-addresses | YDS instrument to vault address mapping | | @somm/shared/mock-data | Test fixtures |

More info

See the repo-level docs for product context, architecture, and roadmap.