Skip to main content

​
Config surface precedence

b1e55ed merges configuration from multiple “surfaces”. Later surfaces override earlier ones.
  1. config/default.yaml — repo defaults
  2. config/presets/*.yaml — preset overlays
  3. config/user.yaml — operator overlay
  4. 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.
ScenarioEffective scoring universe
Bundles configured, symbols emptyUnion of all enabled bundle symbols
Bundles configured, symbols setBundle symbols + explicit symbols (deduplicated)
No bundles, symbols setExplicit symbols only (backward-compatible)
Both emptyNo 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.