Skip to main content
Challenge

Build a Corporate Sanctions Contagion and Lineage Graph Visualizer

Trace corporate restructuring events using GLEIF relationship records and screen historical entities against yente sanctions data. Map merger and spin-off events to detect inherited sanctions risk.

CybersecurityHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Trace corporate restructuring events using GLEIF relationship records and screen historical entities against yente sanctions data. Map merger and spin-off events to detect inherited sanctions risk.

Corporate entity resolution officer

Ingest legal entity relationship records detailing parent, successor, and predecessor associations from GLEIF structures.

Reconstruct the chronological restructuring DAG encompassing corporate acquisitions, spin-offs, and absorbed entities.

Evaluate sanctions list records against all historical corporate nodes to identify inherited risk.

Produce an audit lineage report mapping sanctions contagion across corporate successor transitions.

Interactive timeline and graph visualizer displaying corporate lineage transitions, split events, and historical sanctions matches.

Construct a mock dataset of 40 legal entities undergoing mergers and carve-outs using simplified GLEIF relationship schema records. Starter examples below are synthetic. They are not downloaded records.

GLEIF API Leverages GLEIF corporate structure records capturing parent and child relationships as described in source excerpt 0.

langgraph, networkx, fastapi. LangGraph manages stateful traversal and cycle detection across historical corporate merger and split graphs. Lightweight local model (Ollama or hosted API) to summarize complex lineage paths into human-readable briefs.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Successfully identifies all predecessor legal entities across a minimum 3-tier merger chain.

Detects corporate spin-offs where legacy obligations attach to newly created entities.

Exports a validated JSON lineage graph with timestamps for each restructuring action.

```json [ { "input": { "target_lei": "984500A1B2C3D4E5F677", "relationship_records": [ { "relationship_type": "IS_SUCCESSOR_TO", "predecessor": "11223344556677889900", "successor": "984500A1B2C3D4E5F677", "effective_date": "2022-04-01" } ] }, "expected_output": { "root_lei": "984500A1B2C3D4E5F677", "predecessors": [ "11223344556677889900" ], "lineage_depth": 1, "has_split_events": false } }, { "input": { "target_lei": "55667788990011223344", "relationship_records": [ { "relationship_type": "SPUN_OFF_FROM", "predecessor": "99887766554433221100", "successor": "55667788990011223344", "effective_date": "2023-01-15" }, { "relationship_type": "ACQUIRED_ASSETS_FROM", "predecessor": "22334455667788990011", "successor": "55667788990011223344", "effective_date": "2023-06-10" } ] }, "expected_output": { "root_lei": "55667788990011223344", "predecessors": [ "99887766554433221100", "22334455667788990011" ], "lineage_depth": 1, "has_split_events": true } } ] ```

Performs analytical historical lineage audits; does not alter legal corporate records or trigger regulatory enforcement. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Performs analytical historical lineage audits; does not alter legal corporate records or trigger regulatory enforcement. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Successfully identifies all predecessor legal entities across a minimum 3-tier merger chain. Detects corporate spin-offs where legacy obligations attach to newly created entities. Exports a validated JSON lineage graph with timestamps for each restructuring action.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Ingest legal entity relationship records detailing parent, successor, and predecessor associations from GLEIF structures. Reconstruct the chronological restructuring DAG encompassing corporate acquisitions, spin-offs, and absorbed entities. Evaluate sanctions list records against all historical corporate nodes to identify inherited risk. Produce an audit lineage report mapping sanctions contagion across corporate successor transitions.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Successfully identifies all predecessor legal entities across a minimum 3-tier merger chain. Detects corporate spin-offs where legacy obligations attach to newly created entities. Exports a validated JSON lineage graph with timestamps for each restructuring action.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Interactive timeline and graph visualizer displaying corporate lineage transitions, split events, and historical sanctions matches.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Performs analytical historical lineage audits; does not alter legal corporate records or trigger regulatory enforcement.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Ingest legal entity relationship records detailing parent, successor, and predecessor associations from GLEIF structures.

  • Reconstruct the chronological restructuring DAG encompassing corporate acquisitions, spin-offs, and absorbed entities.

  • Evaluate sanctions list records against all historical corporate nodes to identify inherited risk.

  • Produce an audit lineage report mapping sanctions contagion across corporate successor transitions.

Resources and assets

Reference links and supporting material

Dataset notes

Construct a mock dataset of 40 legal entities undergoing mergers and carve-outs using simplified GLEIF relationship schema records. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

LangGraph

Runtime for stateful agent workflows.

Evaluated output

No output checks are configured.

Evaluation checks
  • Ingest legal entity relationship records detailing parent, successor, and predecessor associations from GLE...
  • Successfully identifies all predecessor legal entities across a minimum 3-tier merger chain. Detects corpor...
  • Interactive timeline and graph visualizer displaying corporate lineage transitions, split events, and histo...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • LangGraph · Optional
Orchestration
  • LangGraph · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Corporate Sanctions Contagion and Lineage Graph Visualizer