{
  "openapi": "3.1.0",
  "info": {
    "title": "Omnisea asset-router read API",
    "version": "1-preview",
    "description": "Source-tree contract for the new asset-router release; verify hosted rollout and /chains. Does not describe legacy Omniassets, Omnipad, Omnigas or operator endpoints."
  },
  "servers": [
    {
      "url": "https://api.omnisea.io"
    },
    {
      "url": "http://localhost:8788",
      "description": "Local development"
    }
  ],
  "security": [],
  "paths": {
    "/chains": {
      "get": {
        "summary": "Deployment registry",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "chainId": {
                            "type": "string",
                            "pattern": "^[0-9]+$",
                            "description": "Integer encoded as a decimal string"
                          },
                          "eid": {
                            "type": "string",
                            "pattern": "^[0-9]+$",
                            "description": "Integer encoded as a decimal string"
                          },
                          "protocolVersion": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "vm": {
                            "type": "string"
                          },
                          "deployed": {
                            "type": "boolean"
                          },
                          "indexed": {
                            "type": "boolean"
                          },
                          "contracts": {
                            "type": "object",
                            "properties": {
                              "router": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "vault": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "lens": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "oftImplementation": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "adapterImplementation": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          },
                          "blockExplorerUrl": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/contracts": {
      "get": {
        "summary": "Indexed contract records",
        "parameters": [
          {
            "name": "chainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/chains/{chainId}/peers": {
      "get": {
        "summary": "Observed peers",
        "parameters": [
          {
            "name": "chainId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/assets": {
      "get": {
        "summary": "Newest assets",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Opaque nextCursor; keep other filters unchanged"
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "originChainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "originToken",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 64
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items",
                    "page"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Asset"
                      }
                    },
                    "page": {
                      "$ref": "#/components/schemas/Page"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/assets/{assetId}": {
      "get": {
        "summary": "Asset detail by ID",
        "parameters": [
          {
            "name": "assetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "$ref": "#/components/schemas/AssetDetail"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/assets/{chainId}/{token}/{creator}": {
      "get": {
        "summary": "Asset detail by permanent identity",
        "parameters": [
          {
            "name": "chainId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "token",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "creator",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "$ref": "#/components/schemas/AssetDetail"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/tokens/{chainId}/{address}": {
      "get": {
        "summary": "Original-token identities and/or facade lookup; up to 100 origin assets",
        "parameters": [
          {
            "name": "chainId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chainId": {
                      "type": "string",
                      "pattern": "^[0-9]+$",
                      "description": "Integer encoded as a decimal string"
                    },
                    "address": {
                      "type": "string",
                      "pattern": "^0x[0-9a-fA-F]{40}$"
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Asset"
                      },
                      "maxItems": 100
                    },
                    "omniseaToken": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/Asset"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/messages": {
      "get": {
        "summary": "All message kinds",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Opaque nextCursor; keep other filters unchanged"
            }
          },
          {
            "name": "assetId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "wallet",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "chainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "delivered",
                "failed",
                "restored"
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "transfer",
                "restore",
                "sync",
                "owner"
              ]
            }
          },
          {
            "name": "txHash",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items",
                    "page"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Message"
                      }
                    },
                    "page": {
                      "$ref": "#/components/schemas/Page"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/transfers": {
      "get": {
        "summary": "Transfer and restore messages only",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Opaque nextCursor; keep other filters unchanged"
            }
          },
          {
            "name": "assetId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "wallet",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "chainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "delivered",
                "failed",
                "restored"
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "transfer",
                "restore",
                "sync",
                "owner"
              ]
            }
          },
          {
            "name": "txHash",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items",
                    "page"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Message"
                      }
                    },
                    "page": {
                      "$ref": "#/components/schemas/Page"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/messages/{guid}": {
      "get": {
        "summary": "Message by GUID",
        "parameters": [
          {
            "name": "guid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "$ref": "#/components/schemas/Message"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/wallets/{address}/activity": {
      "get": {
        "summary": "Wallet messages and issuer actions",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Opaque nextCursor; keep other filters unchanged"
            }
          },
          {
            "name": "assetId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "chainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "delivered",
                "failed",
                "restored"
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "transfer",
                "restore",
                "sync",
                "owner"
              ]
            }
          },
          {
            "name": "txHash",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items",
                    "page"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Message"
                      }
                    },
                    "page": {
                      "$ref": "#/components/schemas/Page"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/monitoring/stuck-messages": {
      "get": {
        "summary": "Pending or failed messages, oldest first; no cursor",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "chainId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          {
            "name": "minAgeMinutes",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10080,
              "default": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current indexed observations, not a finality guarantee",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Message"
                      }
                    },
                    "minAgeMinutes": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait"
              }
            }
          },
          "500": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Request failed; details may be absent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "details": {}
        }
      },
      "Page": {
        "type": "object",
        "required": [
          "nextCursor",
          "hasMore"
        ],
        "properties": {
          "nextCursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "hasMore": {
            "type": "boolean"
          }
        }
      },
      "Asset": {
        "type": "object",
        "required": [
          "assetId",
          "creator",
          "originToken",
          "name",
          "symbol"
        ],
        "properties": {
          "assetId": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "originEid": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "Integer encoded as a decimal string"
          },
          "originChainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "originToken": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "originTokenAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "creatorAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "decimals": {
            "type": "integer"
          },
          "sharedDecimals": {
            "type": "integer"
          },
          "complianceMode": {
            "type": "boolean"
          },
          "preEnabledEids": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          "descriptor": {
            "type": "string"
          },
          "createdTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "indexedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "chainCount": {
            "type": "integer"
          },
          "transferCount": {
            "type": "integer"
          }
        }
      },
      "AssetDetail": {
        "type": "object",
        "properties": {
          "assetId": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "originEid": {
            "type": "string",
            "pattern": "^[0-9]+$",
            "description": "Integer encoded as a decimal string"
          },
          "originChainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "originToken": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "originTokenAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "creator": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "creatorAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "decimals": {
            "type": "integer"
          },
          "sharedDecimals": {
            "type": "integer"
          },
          "complianceMode": {
            "type": "boolean"
          },
          "preEnabledEids": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          "descriptor": {
            "type": "string"
          },
          "createdTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "indexedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "chainCount": {
            "type": "integer"
          },
          "transferCount": {
            "type": "integer"
          },
          "enabledEids": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "Integer encoded as a decimal string"
            }
          },
          "chainViews": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "observerChainId": {
                  "type": "string",
                  "pattern": "^[0-9]+$",
                  "description": "Integer encoded as a decimal string"
                },
                "eids": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[0-9]+$",
                    "description": "Integer encoded as a decimal string"
                  }
                }
              }
            }
          },
          "tokens": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "chainId": {
                  "type": "string",
                  "pattern": "^[0-9]+$",
                  "description": "Integer encoded as a decimal string"
                },
                "eid": {
                  "type": "string",
                  "pattern": "^[0-9]+$",
                  "description": "Integer encoded as a decimal string"
                },
                "tokenAddress": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "isOrigin": {
                  "type": "boolean"
                },
                "flatFee": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "feeBps": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "complianceAddress": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "registeredTxHash": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "registeredAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "stats": {
            "type": "object",
            "properties": {
              "transfers": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              },
              "delivered": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              },
              "pending": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              },
              "failed": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              },
              "volumeLD": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              },
              "senders": {
                "type": "string",
                "pattern": "^[0-9]+$",
                "description": "Integer encoded as a decimal string"
              }
            }
          }
        }
      },
      "Message": {
        "type": "object",
        "required": [
          "guid",
          "kind",
          "status"
        ],
        "properties": {
          "guid": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "transfer",
              "restore",
              "sync",
              "owner"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "delivered",
              "failed",
              "restored"
            ]
          },
          "assetId": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "originChainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "originTokenAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "creatorAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "srcChainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "srcEid": {
            "type": [
              "string",
              "null"
            ]
          },
          "dstChainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "dstEid": {
            "type": [
              "string",
              "null"
            ]
          },
          "sender": {
            "type": [
              "string",
              "null"
            ]
          },
          "senderAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "recipient": {
            "type": [
              "string",
              "null"
            ]
          },
          "recipientAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "amountSentLD": {
            "type": [
              "string",
              "null"
            ]
          },
          "amountReceivedLD": {
            "type": [
              "string",
              "null"
            ]
          },
          "amountDeliveredLD": {
            "type": [
              "string",
              "null"
            ]
          },
          "flatFee": {
            "type": [
              "string",
              "null"
            ]
          },
          "feeLD": {
            "type": [
              "string",
              "null"
            ]
          },
          "restoreOfGuid": {
            "type": [
              "string",
              "null"
            ]
          },
          "restoreGuid": {
            "type": [
              "string",
              "null"
            ]
          },
          "compliance": {
            "type": [
              "string",
              "null"
            ]
          },
          "sentTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "sentAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "deliveredTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "deliveredAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "failedTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "failedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "failureReason": {
            "type": [
              "string",
              "null"
            ]
          },
          "failureError": {
            "type": [
              "string",
              "null"
            ]
          },
          "retriedTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "restoredTxHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "restoredAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "layerZeroScanStatus": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "decimals": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ownerOp": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}