{"uid":"cap_rPewLlvvsbVMslD6kDVum","slug":"ospf-graceful-restart-helper-state-recovery-5a8c1fc5","name":"OSPF Graceful Restart Helper State Recovery","description":"Recover OSPF restart helper state and exit duties.","url":"https://detect.halowerk.com/v1/F-TD2000-DATASTRUCTURES-13/rfc3623-ospf-graceful-restart-helper-admission-topology-timeout-ledger?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","$defs":{"s0":{"type":"object","properties":{"options":{"type":"integer","maximum":255,"minimum":0},"body_hex":{"not":{"pattern":"[\\r\\n

]"},"type":"string","pattern":"^(?:[0-9a-f]{2}){0,256}$"}},"minProperties":2,"additionalProperties":false},"s1":{"type":"object","properties":{"lsa":{"type":"integer","maximum":31,"minimum":0},"current":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s2"},"previous":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s2"}},"minProperties":3,"additionalProperties":false},"s2":{"anyOf":[{"type":"null"},{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s0"}]},"s3":{"type":"array","items":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s1"},"maxItems":32},"json":{"anyOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string","maxLength":16000},{"type":"array","items":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"},"maxItems":16000},{"type":"object","maxProperties":16000,"additionalProperties":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"}}]}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"ospfGrace":{"type":"object","properties":{"data":{"type":"object","properties":{"events":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"op":{"enum":["grace"]},"age":{"type":"integer","maximum":3599,"minimum":0},"now":{"type":"integer","maximum":1000000,"minimum":0},"grace":{"type":"integer","maximum":4294967295,"minimum":1},"reason":{"type":"integer","maximum":3,"minimum":0},"segment":{"type":"integer","maximum":15,"minimum":0},"interface_address":{"anyOf":[{"type":"null"},{"type":"integer","maximum":255,"minimum":0}]},"advertising_router":{"type":"integer","maximum":15,"minimum":0}},"minProperties":8,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["grace_flush"]},"now":{"type":"integer","maximum":1000000,"minimum":0},"segment":{"type":"integer","maximum":15,"minimum":0}},"minProperties":3,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["neighbor"]},"now":{"type":"integer","maximum":1000000,"minimum":0},"full":{"type":"boolean"},"segment":{"type":"integer","maximum":15,"minimum":0},"neighbor_dr":{"type":"boolean"}},"minProperties":5,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["retransmissions"]},"now":{"type":"integer","maximum":1000000,"minimum":0},"entries":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s3"},"segment":{"type":"integer","maximum":15,"minimum":0}},"minProperties":4,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["install"]},"lsa":{"type":"integer","maximum":31,"minimum":0},"now":{"type":"integer","maximum":1000000,"minimum":0},"content":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s2"},"would_flood_segments":{"type":"array","items":{"type":"integer","maximum":15,"minimum":0},"maxItems":16}},"minProperties":5,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["self_restart"]},"now":{"type":"integer","maximum":1000000,"minimum":0},"restarting":{"type":"boolean"}},"minProperties":3,"additionalProperties":false},{"type":"object","properties":{"op":{"enum":["tick"]},"now":{"type":"integer","maximum":1000000,"minimum":0}},"minProperties":2,"additionalProperties":false}]},"maxItems":128},"segments":{"type":"array","items":{"type":"object","properties":{"area":{"type":"integer","maximum":7,"minimum":0},"full":{"type":"boolean"},"network":{"enum":["point_to_point","broadcast","nbma","point_to_multipoint","virtual"]},"neighbor":{"type":"integer","maximum":15,"minimum":0},"neighbor_dr":{"type":"boolean"},"transit_area":{"anyOf":[{"type":"null"},{"type":"integer","maximum":7,"minimum":0}]},"retransmissions":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s3"},"interface_address":{"type":"integer","maximum":255,"minimum":0}},"minProperties":8,"additionalProperties":false},"maxItems":16},"lsa_types":{"type":"array","items":{"type":"integer","maximum":11,"minimum":1},"maxItems":32},"restarting":{"type":"boolean"},"maximum_grace":{"type":"integer","maximum":1800,"minimum":1},"helper_support":{"enum":["none","planned","all"]},"initial_contents":{"type":"array","items":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s2"},"maxItems":32},"allowed_neighbors":{"type":"array","items":{"type":"integer","maximum":15,"minimum":0},"maxItems":16},"strict_lsa_checking":{"type":"boolean"}},"minProperties":9,"additionalProperties":false},"claim":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"}},"minProperties":2,"additionalProperties":false}},"minProperties":1,"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3UTaifwdFs8YB9NPO_r75","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Recovers and validates OSPF graceful restart helper state, including admission topology, timeout ledger, and exit duties for RFC 3623 compliance.","exampleAgentPrompt":"Recover the OSPF graceful restart helper state from these grace LSA events — the grace period is 120 seconds, restart reason is 1 (software restart), and I need you to validate the admission topology and return the timeout ledger and exit duties.","exampleUseCases":[{"title":"OSPF restart helper admission audit","prompt":"I have a set of OSPF grace LSA events from a router restart with grace period 90 seconds and reason 0 — can you recover the helper state and tell me whether admission should be granted and what the timeout ledger looks like?"},{"title":"Network topology change detection during restart","prompt":"After an OSPF graceful restart, I need to verify whether the helper detected any topology changes during the grace window. Here are the LSA before/after snapshots — check admission and return the helper exit duties."},{"title":"RFC 3623 compliance validation","prompt":"Validate this OSPF graceful restart sequence against RFC 3623 rules: I'll give you the grace events with interface address and advertising router IDs, and I need to confirm the helper state machine transitions and timeout ledger are correct."}],"resultDescription":"Returns the recovered OSPF graceful restart helper state including admission decision, timeout ledger entries, topology change flags, and exit duty status per RFC 3623 — structured as a JSON object reflecting whether the helper should continue assisting the restarting router and when it should exit helper mode.","failureModes":["Invalid grace period value (outside 1–4294967295 range) causes schema validation failure","Malformed LSA body_hex (non-hex characters or odd length) returns 400 Bad Request","Too many events in array (exceeds 32 items) causes schema rejection","Missing required fields (op, age, now, grace, reason, segment, interface_address, advertising_router) returns validation error","Topology inconsistency detected causing helper to deny admission"],"whenToPreferThis":"Use this endpoint when you need to process and validate OSPF graceful restart helper state according to RFC 3623, particularly when you have raw grace LSA event streams and need to compute helper admission, track timeout ledgers, and determine exit conditions. Prefer this over general routing validators when you specifically need RFC 3623 helper-mode state machine computation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:39:27.122Z","isFirstParty":false,"canonicalSlug":"ospf-graceful-restart-helper-state-recovery-5a8c1fc5"}