Chain Stages · 2 Steps · §21.4 Gated on /acmt_state

1 ROOT · GATED §21.4 gate

eBAM Account Message Flow Validation art-262-validate-ebam-acmt-flow

Validates CGI-MP eBAM 2023 acmt message sequence: acmt.007 (opening request) → acmt.010 (opening confirmation) → acmt.011 (closing request) → acmt.017 (modification) → acmt.019 (modification confirmation). Detects orphan messages (no matching request). Determines final acmt_state. Gate evaluates /acmt_state for STP routing.

§21.4 GATE: input: /acmt_state

▶acmt_state = "OPENING_CONFIRMED" → art-260-allocate-ihb-interest(new account enters IHB pool — proceed to Step 2)

▶default (CLOSURE_CONFIRMED / MODIFICATION_CONFIRMED / PENDING / INVALID) → END(no pool action required)

MCP Call · validate_ebam_acmt_flow

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "validate_ebam_acmt_flow",
    "arguments": {
      "account_reference_id": "ACCT-REF-20240115-001",
      "messages": [
        {
          "msg_type": "acmt.007",
          "msg_id": "MSG-007-001",
          "creation_date": "2024-01-15",
          "is_confirmation": false
        },
        {
          "msg_type": "acmt.010",
          "msg_id": "MSG-010-001",
          "creation_date": "2024-01-16",
          "is_confirmation": true,
          "related_msg_id": "MSG-007-001"
        }
      ]
    }
  },
  "id": 1
}

↓ if OPENING_CONFIRMED

2 TERMINAL · CONDITIONAL node

In-House Bank Interest Allocation art-260-allocate-ihb-interest

Allocates IHB notional pool or ZBA sweep interest for the newly confirmed account being onboarded to the pool. OECD TP Guidelines 2022 Chapter X arm’s-length rate. ACT/360 day-count. Per-member withholding tax. Returns per-member gross_interest, withholding_amount, net_interest, and total_interest_allocated for the opening-day period. Only reached when acmt_state = OPENING_CONFIRMED. Final stage.

MCP Call · allocate_ihb_interest

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "allocate_ihb_interest",
    "arguments": {
      "pool_type": "notional",
      "pool_rate_annual_pct": 5.0,
      "day_count_convention": "ACT/360",
      "period_days": 1,
      "currency": "USD",
      "members": [
        {"member_id": "ACCT-REF-20240115-001", "balance": 500000, "withholding_rate_pct": 0,
         "notes": "newly opened account entering pool"},
        {"member_id": "EXISTING-POOL-ANCHOR", "balance": 2000000, "withholding_rate_pct": 0}
      ]
    }
  },
  "id": 2
}

Treasury Account Lifecycle (eBAM)