urn:local: - A URN Namespace for Context-Local Identifiers
Problem
In the age of LLMs and context-aware computing, we need a simple way to express "this identifier is local to the current context."
Current approaches have issues:
http:// URLs imply dereferenceability (404 errors)
did: methods require resolvers
_: blank nodes are cryptic (RDF-specific)
urn:example: is for documentation only
- Custom namespaces lack universal meaning
Proposal
Adopt urn:local: as a de facto standard for context-local identifiers:
urn:local:treasury → "treasury" in THIS ledger/document/system
urn:local:config → "config" in THIS context
urn:local:user:alice → "alice" in THIS namespace
Why This Matters for LLMs
| Property |
Benefit |
| Self-documenting |
LLM instantly understands scope |
| No resolution needed |
Won't hallucinate external lookups |
| Context-native |
Matches how LLMs process information |
| Collision-free |
Can't conflict with global identifiers |
| Portable |
Copy document anywhere, meaning preserved |
Semantics
When an agent (human or AI) encounters urn:local:X:
- Do NOT attempt to resolve externally
- Interpret X within the current document/context/system
- Treat as equivalent to a local variable or internal reference
Use Cases
- WebLedgers:
urn:local:treasury, urn:local:amm
- Config files:
urn:local:database, urn:local:cache
- JSON-LD documents: Local entity references
- LLM contexts: Scoped identifiers in prompts
- Multi-tenant systems: Per-tenant namespacing
Specification
urn:local:<local-name>
where:
- "urn" = Uniform Resource Name scheme
- "local" = Namespace Identifier (NID) indicating local scope
- <local-name> = Any valid URN Namespace Specific String
Next Steps
- Document usage in WebLedgers
- Create standalone spec page
- Seek adoption in related projects
- Consider W3C Community Group or informal RFC
References
urn:local: - A URN Namespace for Context-Local Identifiers
Problem
In the age of LLMs and context-aware computing, we need a simple way to express "this identifier is local to the current context."
Current approaches have issues:
http://URLs imply dereferenceability (404 errors)did:methods require resolvers_:blank nodes are cryptic (RDF-specific)urn:example:is for documentation onlyProposal
Adopt
urn:local:as a de facto standard for context-local identifiers:Why This Matters for LLMs
Semantics
When an agent (human or AI) encounters
urn:local:X:Use Cases
urn:local:treasury,urn:local:ammurn:local:database,urn:local:cacheSpecification
Next Steps
References