---
title: "13.4 Code registry"
url: https://una-lang.org/en/docs/spec/13-diagnostics-and-abi/4-code-registry/
release: v0.4.0
source: https://github.com/una-lang/una/blob/v0.4.0/docs/spec/13-diagnostics-and-abi.md
---

# 13.4 Code registry

(v0.2, ADR 0056.) The codes U2017 to U2021, of the memory model (`spec/17 §10`), are in the table. (v0.2, ADR 0057.) U2022, of fixed-width integers (`spec/18 §8`), is in the table. (v0.2, ADR 0065.) U2023 and U2024, of structured concurrency (`spec/19 §10`), are in the table. (v0.2, ADR 0066.) U2025 to U2027, of constraints on generics (`spec/20 §10`), are in the table.

| Code | Domain | Meaning |
| --- | --- | --- |
| U0001 | syntax | Invalid character, byte order mark or lone carriage return |
| U0002 | syntax | Tab in indentation |
| U0003 | syntax | Inconsistent indentation |
| U0004 | syntax | Unterminated text literal |
| U0005 | syntax | Invalid escape sequence |
| U0006 | syntax | Text literal inside interpolation |
| U0007 | syntax | Malformed literal |
| U0101 | syntax | Unexpected token |
| U0102 | syntax | Clause out of order or repeated |
| U0103 | syntax | Reserved keyword not available in the package's edition |
| U1001 | names | Unresolved name |
| U1002 | names | Duplicate definition |
| U1003 | names | Import cycle |
| U1004 | names | Use of a private declaration from another module |
| U1005 | names | Naming convention violation |
| U1006 | names | Undeclared requirement in `derived from` |
| U1007 | names | Generated requirement marked active |
| U1008 | names | Module path does not match file path |
| U1009 | names | Reserved module name |
| U1010 | names | A module whose first path segment is a dependency's local name |
| U2001 | types | Type mismatch |
| U2002 | types | Unknown or ill-formed type |
| U2003 | types | Wrong number of type arguments |
| U2004 | types | Missing argument label |
| U2005 | types | Unknown argument label |
| U2006 | types | Duplicate argument |
| U2007 | types | Non-exhaustive `when` over variants |
| U2008 | types | Unreachable arm or misplaced `else` |
| U2009 | types | Missing or unknown field in constructor |
| U2010 | types | Cannot infer lambda parameter type |
| U2011 | types | Statement value is not `Unit` |
| U2012 | types | `result` outside `ensures` or `expect` |
| U2013 | types | `it` or `error` outside its allowed position |
| U2014 | types | Expression outside the refinement language |
| U2015 | types | Invalid predicate body (impure, failing, recursive or outside RL for `reflect`) |
| U2016 | types | Opaque predicate called outside `checked` |
| U2017 | types | Use of a binding after it was passed by `take` |
| U2018 | types | An `edit` argument together with another use of its binding in the same call |
| U2019 | types | Assignment to a binding that is not editable |
| U2020 | types | A parameter convention (`edit`, `take`) not matched at the call site, or declared where none is allowed |
| U2021 | types | A function with `edit` or `take` parameters used as a value |
| U2022 | types | Integer literal does not fit its type |
| U2023 | types | A binding declared outside a `together` branch assigned, or passed as `edit` or `take`, inside it |
| U2024 | types | A `together` body with a statement other than `let`, or fewer than two branches |
| U2025 | types | A type argument does not satisfy the constraint of its parameter |
| U2026 | types | An operation on a type parameter that its constraint does not allow |
| U2027 | types | An unknown constraint name |
| U2028 | types | Values of different units meet, or a measured and a unitless value |
| U2029 | types | An invalid unit declaration or unit expression |
| U2030 | types | A unit conversion without an expected unit, or not exact |
| U2031 | types | A float literal rounds to an infinity, or is not zero and rounds to zero |
| U2032 | types | A float literal other than zero, or a float range, as a pattern |
| U2033 | types | A comparison of an `F64` with a float literal zero |
| U2034 | types | `stop` or `skip` outside a loop body, or across a task boundary |
| U2035 | types | `first of` with fewer than two branches, or a line that is not an expression; `start` outside the block of a `tasks`, inside a task within it, or with a `with` clause |
| U2037 | types | A decimal scale out of place |
| U2038 | types | A tensor shape, index, permutation or axis out of place |
| U2039 | types | A `map`, `zip_map` or `update` in a function with `simd required` whose lambda cannot be vectorized for a listed target |
| U2040 | types | A statement after `stop` or `skip` in the same block, which never runs |
| U3001 | authority | Capability not in scope |
| U3002 | authority | Operation not permitted by capability type |
| U3003 | authority | Effects exceed declared `uses` |
| U3004 | authority | Capability used in a pure function |
| U3005 | authority | Capability reference used as a value |
| U3006 | authority | Effectful or failing lambda escapes |
| U3007 | authority | Fallible expression without handling |
| U3008 | authority | `if error pass` with a different error kind |
| U3009 | authority | Failure variant not in the declared error kind |
| U3010 | authority | Handler does not match its capability |
| U3011 | authority | Handler missing an operation |
| U3012 | authority | Host capability in `main` not granted by `una run` |
| U3013 | authority | Effectful or fallible call nested inside an expression |
| U3014 | authority | Host capability used in an example |
| U3015 | authority | `std.testing` used outside a handler or example |
| U3016 | authority | Second-class type used as a type argument |
| U3017 | authority | `of` clause that names no parameter |
| U3018 | authority | `of` clause that names a parameter not of function type |
| U3019 | authority | `of` clause that names a function type with its own `uses` or `fails` |
| U3020 | authority | Call into a boundary module whose capability is not granted with `with` |
| U3021 | authority | Call that grants a boundary module more than its ceiling |
| U3022 | authority | Labeled operation passed to code that reads it lower |
| U3023 | authority | Header that grants more than its lock in `una.toml` |
| U3024 | authority | Call into a boundary module from which a release is reachable |
| U3025 | authority | `if error` clause on an expression that cannot fail |
| U3026 | authority | `attempt` of a call that cannot fail |
| U3027 | authority | Code that may run forever where it is not allowed to |
| U3028 | authority | A function that says `diverges`, used as a value |
| U3029 | authority | A failure that must be handled where it is not |
| U3032 | authority | A `simd required` clause outside a `systems` package of edition `0.5` |
| U3033 | authority | An operation of `HttpServer` in the effect set of a `together` branch, a `together for` body, a `first of` branch, or `handle` or `on_stop` of a `serve` module |
| U4001 | security | Flow to a lower label |
| U4002 | security | Implicit flow through control, failure or call under raised pc |
| U4003 | security | Sink label exceeded |
| U4004 | security | `policy` outside a trusted module |
| U4005 | security | Invalid policy (public `via`, or type mismatch) |
| U4007 | security | Unknown label category |
| U4008 | security | A text literal with interpolation in a pattern |
| U5001 | verification | Obligation refuted |
| U5002 | verification | Obligation unknown |
| U5003 | verification | Solver missing or version mismatch |
| U6001 | runtime | `main` failed |
| U6003 | runtime | Call depth or memory limit exceeded |
| U6004 | runtime | A header value contains a control character |
| U6005 | runtime | A host value is not valid UTF-8 |
| U6006 | runtime | The floating-point environment of the platform is not the default one |
| U6007 | runtime | The host stopped the run before it finished |
| U6009 | runtime | The host gave no random bytes for keyed hashing |
| U7001 | project | Non-canonical formatting |
| U7002 | project | Invalid `una.toml` |
| U7003 | project | Escape budget exceeded |
| U7004 | project | Missing or invalid `verification.lock` |
| U7005 | project | Trusted module not declared in both header and `una.toml` |
| U7008 | project | Invalid `ita.una` or `itaty.una` |
| U7009 | project | Missing, invalid or inconsistent `ita.lock` |
| U7010 | project | A package, archive, statement, root, checkpoint or log proof that fails verification |
| U7011 | project | A locked package that is neither in the vendor directory nor in Itaoca |
| U7012 | project | A dependency the root may not use as written |
| U7013 | project | No resolution: no release meets a need, or a bound of resolution is exceeded |
| U7014 | project | A locked release yanked, under an advisory or signed after a stated compromise, or a pending recovery, a key change or a transfer of its owner |
| U7015 | project | The executable cannot be laid out: a branch beyond its target's range, or a section larger than its format allows |
| U8001 | internal | Internal compiler error (always a bug) |

Codes are never reused. Retired codes stay in this table marked retired. Gaps in the numbering, such as U4006 and U6002, are unassigned numbers, not retired codes (ADR 0012). `una explain <code>` prints a paragraph and a minimal failing and fixed example for every code, but five. U8001 is an internal error, a bug of the compiler, so its text has no example and says how to report it (ADR 0034). U6005 comes from the host's data, which no program text causes, so its text has no example and says how to fix the data (ADR 0086). U6006 comes from the platform's floating-point environment, which no program text causes either (ADR 0114). U7013 comes from `una ita` when it resolves, from `una ita verify` for a package it cannot verify yet, and from a load for a registry package whose provenance cannot be verified offline (`spec/30 §9` rule 9), which only a registry's signed documents cause, so its text has no example either (ADR 0122 and its amendment of 2026-11-03). U7014 comes from `una ita` alone, from `audit`, and from `lock` and `update` for a key change, and `una check` never reports it: its examples are audited against a stated registry state, in which the failing example's locked release is yanked. (v0.4, ADR 0124.) U7015 comes from the linker of `una build` alone, for an executable too large to lay out, which `una check` never reports, so its text has no example either.
