Config Reference

Config surface precedence

b1e55ed merges configuration from multiple “surfaces”. Later surfaces override earlier ones.

config/default.yaml — repo defaults
config/presets/*.yaml — preset overlays
config/user.yaml — operator overlay
Environment variables (B1E55ED_*) — overrides and secrets

Operationally: keep structure in YAML, keep secrets in environment variables.

Environment variable mapping

The config model maps nested keys using:

Prefix: B1E55ED_
Nested delimiter: __

Examples:

export B1E55ED_API__AUTH_TOKEN="..."
export B1E55ED_EXECUTION__MODE="paper"
export B1E55ED_EAS__ENABLED="true"

`weights`

Domain synthesis weights. Must sum to 1.0 (±0.001).

weights:
  curator: 0.25
  onchain: 0.25
  tradfi: 0.20
  social: 0.15
  technical: 0.10
  events: 0.05

Env var equivalents:

export B1E55ED_WEIGHTS__CURATOR="0.25"
export B1E55ED_WEIGHTS__ONCHAIN="0.25"
export B1E55ED_WEIGHTS__TRADFI="0.20"
export B1E55ED_WEIGHTS__SOCIAL="0.15"
export B1E55ED_WEIGHTS__TECHNICAL="0.10"
export B1E55ED_WEIGHTS__EVENTS="0.05"

`risk`

Risk controls and hard limits.

risk:
  max_leverage: 2.0
  max_position_pct: 0.10
  max_portfolio_heat_pct: 0.06
  daily_loss_limit_pct: 0.03
  max_drawdown_pct: 0.30

Env var equivalents (examples):

export B1E55ED_RISK__MAX_LEVERAGE="2.0"
export B1E55ED_RISK__DAILY_LOSS_LIMIT_PCT="0.03"

`brain`

Brain cycle timing.

brain:
  cycle_interval_seconds: 1800

Env:

export B1E55ED_BRAIN__CYCLE_INTERVAL_SECONDS="1800"

`execution`

Execution mode and paper-trading defaults.

execution:
  mode: paper                 # paper|live
  paper_start_balance: 10000
  confirmation_threshold_usd: 500
  paper_min_days: 14

Env (examples):

export B1E55ED_EXECUTION__MODE="paper"
export B1E55ED_EXECUTION__PAPER_START_BALANCE="10000"

paper_min_days: 14 is the recommended minimum time in paper mode before going live.

`kill_switch`

Kill switch thresholds (risk tripwires).

kill_switch:
  l1_daily_loss_pct: 0.03
  l2_portfolio_heat_pct: 0.06
  l3_crisis_threshold: 2
  l4_max_drawdown_pct: 0.30

Env (examples):

export B1E55ED_KILL_SWITCH__L1_DAILY_LOSS_PCT="0.03"
export B1E55ED_KILL_SWITCH__L2_PORTFOLIO_HEAT_PCT="0.06"

`karma`

Karma configuration and treasury routing.

karma:
  enabled: true
  percentage: 0.005
  settlement_mode: manual     # manual|daily|weekly|threshold
  threshold_usd: 50
  treasury_address: "0x..."

Env (examples):

export B1E55ED_KARMA__ENABLED="true"
export B1E55ED_KARMA__PERCENTAGE="0.005"
export B1E55ED_KARMA__TREASURY_ADDRESS="0x..."

`universe`

Defines which symbols b1e55ed collects/scores.

universe:
  # symbols: []  # Optional — see auto-derivation note below
  bundles: []
  max_size: 100

Scoring universe auto-derivation

The brain’s scoring universe is automatically derived from your enabled bundle symbols. You do not need to maintain a separate universe.symbols list when bundles are configured.

Scenario	Effective scoring universe
Bundles configured, `symbols` empty	Union of all enabled bundle symbols
Bundles configured, `symbols` set	Bundle symbols + explicit symbols (deduplicated)
No bundles, `symbols` set	Explicit symbols only (backward-compatible)
Both empty	No symbols scored (brain idles)

universe.symbols is an optional supplement, not a replacement. If you set it, those symbols are appended to the bundle-derived universe (deduplicating any overlaps). This is useful for scoring symbols you want to monitor but haven’t placed into a bundle yet. Disabled bundles are never included. Env (examples):

export B1E55ED_UNIVERSE__SYMBOLS='["BTC","ETH","SOL"]'
export B1E55ED_UNIVERSE__MAX_SIZE="100"

If you’re unsure what to trade, configure a bundle with your core symbols and leave universe.symbols empty. The brain will automatically score everything in the enabled bundle.

`api`

API server settings.

api:
  host: "127.0.0.1"
  port: 5050
  auth_token: ""             # required unless B1E55ED_INSECURE_OK=1

Env:

export B1E55ED_API__HOST="127.0.0.1"
export B1E55ED_API__PORT="5050"
export B1E55ED_API__AUTH_TOKEN="your-secret-token"

`dashboard`

Dashboard server settings.

dashboard:
  host: "127.0.0.1"
  port: 5051
  auth_token: ""             # optional in this version

Env:

export B1E55ED_DASHBOARD__HOST="127.0.0.1"
export B1E55ED_DASHBOARD__PORT="5051"

`eas` (Ethereum Attestation Service)

Optional EAS integration (disabled by default).

eas:
  enabled: false
  rpc_url: "https://eth.llamarpc.com"
  eas_contract: "0xA1207F3BBa224E2c9c3c6D5aF63D0eb1582Ce587"
  schema_registry: "0xA7b39296258348C78294F95B872b282326A97BDF"
  schema_uid: ""               # set after schema registration
  attester_private_key: ""     # required for creating attestations
  mode: offchain               # onchain|offchain

Env (examples):

export B1E55ED_EAS__ENABLED="true"
export B1E55ED_EAS__RPC_URL="https://eth.llamarpc.com"
export B1E55ED_EAS__ATTESTER_PRIVATE_KEY="0x..."

Related CLI:

b1e55ed eas status
b1e55ed eas verify --uid <uid>

`publish.github` (GitHub auto-publish)

Optional publishing of contributor attestations to GitHub as issues.

publish:
  github:
    owner: ""            # GitHub org or user
    repo: ""             # repo name (or full "owner/repo" depending on deployment)
    token: ""            # personal access token (ghp_...)
    labels:
      - "attestation"
      - "offchain"
    mode: "issues"       # default

If token is empty, publishing is skipped with a WARN log entry — registration still succeeds.

`export`

Defaults for b1e55ed export karma.

export:
  default_format: jsonl
  include_chain: false

Env:

export B1E55ED_EXPORT__DEFAULT_FORMAT="jsonl"
export B1E55ED_EXPORT__INCLUDE_CHAIN="false"

Webhooks

Webhook subscriptions are database-backed and managed via CLI (there is no YAML block in this version):

b1e55ed webhooks add <url> --events "alert.*,system.kill_switch.*"
b1e55ed webhooks list --json
b1e55ed webhooks remove <id>

Authoritative schema/model: engine/core/config.py.

See also: Legacy Configuration Guide for additional context.

Getting Started

Setup

Producers

Operations

Features

Integrations

API Reference

Contributing

Reference

Config Reference

Config surface precedence

Environment variable mapping

`weights`

`risk`

`brain`

`execution`

`kill_switch`

`karma`

`universe`

Scoring universe auto-derivation

`api`

`dashboard`

`eas` (Ethereum Attestation Service)

`publish.github` (GitHub auto-publish)

`export`

Webhooks

​Config surface precedence

​Environment variable mapping

​weights

​risk

​brain

​execution

​kill_switch

​karma

​universe

​Scoring universe auto-derivation

​api

​dashboard

​eas (Ethereum Attestation Service)

​publish.github (GitHub auto-publish)

​export

​Webhooks

Config surface precedence

Environment variable mapping

`weights`

`risk`

`brain`

`execution`

`kill_switch`

`karma`

`universe`

Scoring universe auto-derivation

`api`

`dashboard`

`eas` (Ethereum Attestation Service)

`publish.github` (GitHub auto-publish)

`export`

Webhooks