Documentation Index
Fetch the complete documentation index at: https://docs.b1e55ed.permanentupperclass.com/llms.txt
Use this file to discover all available pages before exploring further.
Config surface precedence
b1e55ed merges configuration from multiple “surfaces”. Later surfaces override earlier ones.
config/default.yaml — repo defaultsconfig/presets/*.yaml — preset overlaysconfig/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
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
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
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
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
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..."
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
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
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
export B1E55ED_EAS__ENABLED="true"
export B1E55ED_EAS__RPC_URL="https://eth.llamarpc.com"
export B1E55ED_EAS__ATTESTER_PRIVATE_KEY="0x..."
b1e55ed eas statusb1e55ed 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
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.
