HDP
Human Delegation Provenance Protocol
The normative v0.1 specification of the Human Delegation Provenance Protocol, aligned with IETF draft-02. It defines the token structure, Ed25519 signing procedures, the live-acceptance verification pipeline with verifier-local revocation, historical audit verification, and the HTTP transport bindings.
- Status
- Draft · open for comment
- Version
- v0.1
- Revision
- IETF draft-02
- Updated
- 11 September 2026
- Signing
- Ed25519 · RFC 8032
- Canonicalization
- RFC 8785
- License
- Apache 2.0
- arXiv
- 2604.04522
Contents
Contents
Status of this document
This document is the v0.1 specification of the Human Delegation Provenance Protocol, and is the reference cited as [HDP-SPEC] by the IETF Internet-Draft draft-helixar-hdp-agentic-delegation-02. It is aligned with revision -02 and serves as the standing normative text for that citation.
HDP v0.1 is published for comment and interoperability testing. It is not an IETF standard, and publication of the Internet-Draft does not imply IETF endorsement. The field names, signing procedures, and verification pipeline described here are implemented by the reference libraries.
1Overview#
Autonomous AI agents increasingly execute consequential actions: sending email, modifying files, running code, calling APIs, and transacting on behalf of people. When a human authorizes an orchestrator agent, which delegates to sub-agents, which delegate again to tool-execution agents, the originating human authorization becomes disconnected from the terminal action. There is no standard record of the authorization chain.
That gap creates three concrete problems:
- Downstream agents cannot verify that the action they are being asked to perform was actually authorized by a human.
- Post-hoc audits cannot reconstruct who approved what, and when.
- Prompt injection, where malicious content in the environment instructs an agent to act, cannot be distinguished from legitimate human delegation.
HDP addresses this by defining a token that:
- Records the human principal, their declared scope, and the session binding at issuance.
- Accumulates a cryptographically signed hop record for each agent that handles the token.
- Allows any recipient to verify the entire chain, root signature plus all hop signatures, using only the issuer’s Ed25519 public key and the session identifier.
1.1What HDP is not#
HDP is not an authorization protocol, and an HDP token is not a capability, an access token, or a credential that entitles its holder to anything. Presenting a valid HDP token to a service does not authorize the presenter to perform the requested action. That decision belongs to the service’s own access control mechanism, whether that is OAuth 2.0 (§12.2), a capability system such as UCAN or ZCAP-LD (§12.4, §12.5), or something else. HDP is designed to travel alongside such mechanisms, not to replace them.
Several parts of this document can be misread as authorization if this distinction is not kept in view. The scope object (§3.3) records what the human declared, in fields named authorized_tools and authorized_resources; it is a signed record of the authorization event, not a grant. The verification pipeline (§5) establishes that a token is authentic and intact, not that its presenter may act. The HTTP transport (§8) shows a token accompanying a request because the task travels in the request, not because the token authorizes it.
The primary reader of an HDP token is therefore not the service receiving a request but whoever examines the record afterwards: post-incident reconstruction of which agent did what, under whose authorization, and in what order; compliance evidence that a human authorized a class of action; and human oversight, where an approver inspects the chain a task has accumulated before permitting it to continue. A token is carried at invocation and read at audit.
1.2Motivation#
The need for agentic delegation provenance is not hypothetical. Production deployments of AI orchestration systems, including LangChain, AutoGPT, CrewAI, and similar frameworks, pass natural language task descriptions between agents with no cryptographic binding to the original human authorization. The operational risk compounds as models become more capable and agents receive access to higher-consequence tools.
A provenance token that travels alongside the task, tamper-evident, offline-verifiable, and scoped to what the human actually approved, provides the foundation for auditable, accountable agentic systems.
1.3Design goals#
HDP is designed with the following goals in order of priority:
- 1.Offline verifiability. Verification MUST require only a public key, a session ID, and state held locally by the verifier. No network call, registry lookup, or third-party endpoint is required.
- 2.Self-sovereignty. Any organization MUST be able to issue and verify HDP tokens without registering with a central authority or anchoring to a third-party key.
- 3.Tamper evidence. Any modification to a token’s recorded content, its header, principal, scope, or any recorded hop, MUST be detectable by the verification pipeline. Completeness of the chain, that no trailing hop has been omitted, is a separate property. See §10.4.
- 4.Minimal footprint. The protocol MUST be implementable in any language with Ed25519 and JSON support. No mandatory infrastructure beyond key management is required.
- 5.Privacy by design. Principal identity fields MUST be separable from the audit-relevant parts of the token, so tokens can be transmitted to agents without exposing PII.
1.4Relationship to IPP (draft-haberkamp-ipp-01)#
The Intent Provenance Protocol (IPP) addresses the same problem space. HDP and IPP share the use of Ed25519 signatures and append-only provenance chains but make different architectural trade-offs, which are detailed in §12.1. The two protocols are not interoperable. HDP is offered as a distinct design point, not a revision of IPP.
The full HDP protocol specification is available at [HDP-SPEC]. A TypeScript reference implementation is available at [HDP-IMPL].
1.5Generality of the chain-of-custody mechanism#
The core of HDP is an append-only, cryptographically chained record: each hop extends a signed entry that covers all prior state, gaps in the hop sequence are tamper-evident, and any party can verify the entire chain offline using only a public key. This chain-of-custody mechanism is independent of what the chain carries.
This document profiles that mechanism for one application: human-authorized agentic delegation. In this profile the carried payload is the scope object (§3.3) and each hop record describes an agent delegation action. The same mechanism could carry other payloads, for example data provenance, consent delegation, or physical-world command chains, each as a distinct profile. Such profiles are out of scope for this document; HDP v0.1 defines only the agentic-delegation profile. Where practical, the signing (§4, §4.1, §4.2) and verification (§5) procedures are described in a payload-agnostic way so future profiles can reuse them unchanged.
2Terminology#
The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, NOT RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in RFC 2119 and RFC 8174 when, and only when, they appear in all capitals.
- Issuer
- The system or person that creates and signs an HDP token on behalf of a human principal.
- Principal
- The human who authorized the agentic task. Represented in the token’s
principalobject. - Agent
- Any AI system, model, or automated process that receives and acts upon an HDP token.
- Hop
- A single delegation event, recorded as a signed entry in the token’s
chainarray. - Root signature
- The Ed25519 signature over the header, principal, and scope, computed by the issuer at token creation time.
- Hop signature
- The Ed25519 signature over the cumulative chain state at the time of extension. In v0.1 it is produced by the issuer using the same key as the root signature, and attests that the issuer recorded the hop, not that the named agent signed or consented to it.
- Live acceptance
- Evaluation of a token for use in a request now: the full pipeline of §5, including lifecycle, revocation, and session binding.
- Historical audit
- Examination of a stored token after the fact, reporting record integrity, current acceptance, and historical acceptance separately. See §5.1.
- Session
- A logical unit of work identified by a
session_idstring, established between the issuer and the agent framework before the token is issued. - Verifier
- Any party that checks an HDP token: an agent receiving a task uses the live acceptance pipeline (§5); an audit system or human reviewer’s tooling uses historical audit verification (§5.1).
- Presenter
- The agent that transmits a token to a verifier. In a complete chain the presenter is the agent that appended the final hop.
3Token structure#
An HDP token is a JSON object with six top-level fields. The token MUST conform to the structure below. All integer timestamps are Unix milliseconds, that is, milliseconds since 1970-01-01T00:00:00Z.
{
"hdp" : "0.1", // protocol version
"header" : { ... }, // session binding + lifecycle
"principal" : { ... }, // authorizing human
"scope" : { ... }, // authorized intent + constraints
"chain" : [ ... ], // delegation hops (append-only)
"signature" : { ... } // root Ed25519 signature
}Before signing or verifying a token, implementations MUST validate its JSON representation and all REQUIRED fields, types, and constraints defined in this section. The input MUST satisfy the I-JSON requirements of RFC 8785, including rejection of duplicate object member names, invalid Unicode strings, and non-finite numbers. Duplicate names MUST be detected before parsing discards them. Values MUST NOT be coerced from strings or booleans to satisfy a numeric field’s type.
The integer fields header.issued_at, header.expires_at, and each hop’s timestamp and parent_hop MUST be in the inclusive range 0 through 9007199254740991, that is 253 − 1. Each hop’s seq, and scope.max_hops where present, MUST be in the inclusive range 1 through 9007199254740991. These are JSON numbers, not strings. Implementations MUST check the numeric value before any lossy conversion, and MUST reject fractional or out-of-range values rather than round them. The bounds ensure exact integer representation in the IEEE 754 double-precision model used by RFC 8785. They are representation bounds, not an operational delegation budget. Other numeric values, such as numbers insideprincipal.metadata, remain subject to RFC 8785.
3.1Header#
The header object carries token lifecycle and session binding fields.
{
"token_id" : "550e8400-e29b-41d4-a716-446655440000",
"issued_at" : 1711483200000,
"expires_at" : 1711569600000,
"session_id" : "sess-20260326-abc123",
"version" : "0.1",
"parent_token_id" : "..."
}token_idREQUIRED- A version 4 UUID (RFC 9562). Unique identifier for this token.
issued_atREQUIRED- Unix milliseconds. Time of issuance.
expires_atREQUIRED- Unix milliseconds. MUST be greater than
issued_at. A token MUST NOT be accepted for live use at or after this time. Expiry does not prevent historical integrity verification (§5.1). HDP defines no default lifetime; the value is an issuer choice, and §10 discusses how to make it. session_idREQUIRED- Opaque string, established out of band between issuer and agent framework before token issuance. Provides replay defense: a token is only valid within the session for which it was issued.
versionREQUIRED- MUST equal the value of the top-level
hdpfield.
3.2Principal#
The principal object identifies the authorizing human. It MUST contain id and id_type. All other fields are OPTIONAL.
{
"id" : "usr_alice_opaque",
"id_type" : "opaque",
"display_name" : "Alice Chen",
"poh_credential" : "...",
"metadata" : {}
}idREQUIRED- Identifier for the principal, interpreted according to
id_type. id_typeREQUIRED- One of the defined values below, or a custom string prefixed with
x-. display_nameOPTIONAL- Human-readable name. Omit where the receiving agent does not require a human-readable identity.
poh_credentialOPTIONAL- A Proof-of-Humanity credential. Verification semantics are application-defined. See §9.
metadataOPTIONAL- Application-defined object. Not interpreted by the protocol.
Defined id_type values:
opaque- Application-defined identifier. No resolution semantics are implied.
email- An email address as defined in RFC 5321.
uuid- A UUID as defined in RFC 9562.
did- W3C Decentralized Identifier. DID resolution is application-defined and not required by this protocol.
poh- A Proof-of-Humanity credential identifier. Verification semantics are application-defined; see §9.3.
3.3Scope#
The scope object records what the human authorized. It is signed as part of the root signature and MUST NOT be modified after issuance.
The scope object is a record, not a grant. Its fields describe the authorization the human gave at issuance, so that the record can later be compared with what agents declared they did. Nothing in this object confers authority on an agent that holds the token. See §1.1.
{
"intent" : "Analyze Q1 sales data and report.",
"authorized_tools" : ["database_read", "file_write"],
"authorized_resources" : ["db://sales/q1-2026", "file://reports/"],
"data_classification" : "confidential",
"network_egress" : false,
"persistence" : true,
"max_hops" : 3
}intentREQUIRED- Free-form natural language description of the authorized task. This is the authorization statement, and SHOULD be written to be both human- and agent-readable.
data_classificationREQUIRED- One of
public,internal,confidential, orrestricted. The sensitivity level of data the agent is authorized to access. network_egressREQUIRED- Boolean. Whether the agent is authorized to make outbound network requests.
persistenceREQUIRED- Boolean. Whether the agent is authorized to write persistent state.
authorized_toolsOPTIONAL- Array of tool identifiers the principal declared as authorized. The field records the declaration; it does not grant access to the tools named, and enforcement, if any, is application-defined.
authorized_resourcesOPTIONAL- Array of resource identifiers, such as URIs or paths, the principal declared as authorized. As with authorized_tools, this records the declaration and grants nothing.
max_hopsOPTIONAL- Positive integer, chosen by the issuer, expressing the delegation budget the human authorized for this token. HDP defines no fixed operational budget. Verification MUST reject tokens whose chain length exceeds this value. If
max_hopsis absent, HDP places no limit on chain length and delegation depth is governed by application policy (see §4.3). Issuers SHOULD omit this field unless the delegation budget is itself part of what the human declared; §10 explains why.
3.4Chain#
The chain array is append-only. Each element records a single delegation event, called a hop. The array is empty at issuance and grows as the token passes between agents. Agents MUST NOT remove or modify existing entries.
{
"seq" : 1,
"agent_id" : "orchestrator-v2",
"agent_type" : "orchestrator",
"agent_fingerprint" : "sha256:abc123...",
"timestamp" : 1711483260000,
"action_summary" : "Decompose task; delegate to sub-agents.",
"parent_hop" : 0,
"hop_signature" : "<base64url-encoded Ed25519 signature>"
}seqREQUIRED- Positive integer, starting at 1. MUST be exactly one greater than the previous hop’s
seq. Gaps are a protocol violation. agent_idREQUIRED- Identifier of the agent adding this hop. The identifier need not be globally meaningful; it is sufficient that the delegator that assigned it can interpret it (§9.1).
agent_typeREQUIRED- One of
orchestrator,sub-agent,tool-executor, orcustom. agent_fingerprintOPTIONAL- Model or binary fingerprint for the acting agent.
timestampREQUIRED- Unix milliseconds. Time of hop extension, as declared by the agent extending the chain. The hop signature proves who attested the value, not that it is accurate. MUST be greater than or equal to the previous hop’s timestamp (§4.3).
action_summaryREQUIRED- Description of an action declared by the agent, written to be both human- and agent-readable. The description MUST distinguish an intended action from an attempted, blocked, or observed action whenever that distinction affects its interpretation. Out-of-scope attempts and observed violations MAY be recorded, with the deviation stated explicitly; their inclusion does not imply principal approval. This remains a signed declaration, not proof that an action occurred (§10.1).
parent_hopREQUIRED- Non-negative integer. Index of the hop that triggered this delegation, where
0indicates the root human authorization. hop_signatureREQUIRED- Base64url-encoded, no padding, Ed25519 signature. See §4.2. Absence is a protocol violation.
3.5Signature#
The signature object carries the root signature computed by the issuer.
{
"kid" : "alice-signing-key-v1",
"alg" : "Ed25519",
"value" : "<base64url Ed25519 signature over canonical JSON>"
}algREQUIRED- MUST be
Ed25519for HDP v0.1. Verifiers MUST reject any other value. kidOPTIONAL- Key identifier. SHOULD be used by verifiers to select the correct public key when multiple keys are in circulation.
valueREQUIRED- Base64url-encoded, no padding, Ed25519 signature over the canonical JSON payload. See §4.1.
4Cryptographic signing#
4.1Root signature#
The root signature is computed by the issuer at token creation time. It covers the fields that constitute the human authorization event: the header, principal, and scope.
- 1.Construct the unsigned token object containing the
hdp,header,principal,scope, andchainfields, wherechainis an empty array at issuance. - 2.Serialize the object to canonical JSON per RFC 8785.
- 3.Compute the Ed25519 signature over the canonical JSON bytes using the issuer’s private key.
- 4.Encode the signature bytes as base64url with no padding.
- 5.Attach the
signatureobject, carryingkid,alg, andvalue, to the token.
4.2Hop signature#
Each hop MUST carry a hop_signature. It binds the new hop record to the entire accumulated delegation history and to the root signature, which makes retroactive chain modification detectable.
- 1.Construct the new hop record, with all fields except
hop_signature. - 2.Build the signing payload as a JSON array of the previously signed hops, each WITH its
hop_signature, followed by the new hop WITHOUT itshop_signature. - 3.Prepend the root signature value, a base64url string, as the array’s first element. This chains the hop signature to the root.
- 4.Serialize the array to canonical JSON per RFC 8785.
- 5.Compute the Ed25519 signature over the canonical JSON bytes using the issuer’s private key.
- 6.Encode as base64url and attach as the
hop_signaturefield on the new hop record. - 7.Append the signed hop to the token’s
chainarray.
[ root_signature_value, // base64url string, chains this hop to the root hop_1, // WITH its hop_signature hop_2, // WITH its hop_signature ... new_hop_unsigned // WITHOUT its hop_signature ]
In HDP v0.1 all signatures, the root signature and every hop signature, are produced by the issuer using a single key. An extending agent that is not the issuer submits its hop to the issuer, which signs it and returns the extended token. Two consequences follow, and implementers should weigh both.
First, a v0.1 hop signature attests that the issuer recorded a delegation claim naming the agent in agent_id. It does not attest that the named agent consented to, or knew of, the hop, because the agent signed nothing. The chain is a record of what the issuer recorded, not of what each agent agreed to. Deployments in which that distinction matters need per-agent signing.
Second, the single-key design is practical only where the issuer is reachable whenever any agent wishes to extend the chain. This adds a round trip to every delegation, and it makes delegation across trust domains awkward, since an issuer in one domain must sign on behalf of agents in another. Only verification is offline; extension is not.
The single-key design does not, however, gain anything for offline verification that per-agent signing would lose. If each hop carried the public key of the agent appending it, signed into the chain by that agent’s delegator, a verifier would authenticate every key after the first from the chain itself and would still resolve exactly one key out of band: the issuer’s. Per-agent hop signing on that pattern is the planned extension for a future version. It is not part of v0.1, and v0.1 tokens carry no per-agent keys.
4.3Chain integrity rules#
These rules govern chain construction and MUST be enforced by both extenders and verifiers.
- 1.Hop
seqvalues MUST start at 1 and increment by exactly 1. No gaps are permitted. - 2.Existing hop records MUST NOT be modified or removed.
- 3.A hop’s
parent_hopMUST reference a valid prior hop index:0for the root human authorization, or theseqvalue of a prior hop. - 4.If
scope.max_hopsis set, the chain length MUST NOT exceed it. A token with a full chain MUST NOT be extended. - 5.Each hop’s
timestampMUST be greater than or equal to the timestamp of the hop before it. A verifier MUST reject a chain in which a hop’s timestamp is less than its predecessor’s (§5, step 4). Because the issuer signs every hop in v0.1, all hop timestamps pass through one clock domain, which is what makes this rule enforceable. - 6.The
hop_signaturefield MUST be present on every hop. A hop without one is a protocol violation and MUST cause verification to fail.
5Verification pipeline#
For live acceptance, a verifier MUST first validate the input as specified in §3, then execute the following seven steps in order. A failure at any step MUST cause immediate rejection for live use with an appropriate error, and the live acceptance pipeline MUST NOT proceed to subsequent steps. Historical audit is a separate procedure, defined in §5.1. Rejecting live use does not prohibit that procedure from examining the same record.
- 1.Version check. The
hdpfield MUST contain a recognized protocol version string. For this specification the only recognized value is0.1. Theheader.versionfield MUST equal thehdpfield; a mismatch MUST cause rejection. A verifier MAY reject a version it no longer supports. - 2.Lifecycle check. The current time MUST be greater than or equal to
header.issued_atand strictly less thanheader.expires_at. A token outside that interval MUST be rejected for live use. The verifier MUST also consult its local revocation state and MUST reject live use ifheader.token_idis present there. See §10.6. - 3.Root signature verification. Reconstruct the canonical JSON payload by removing the
signaturefield and resettingchainto an empty array, then serializing per RFC 8785. Verify thatsignature.algisEd25519, then verifysignature.valueagainst this payload using the issuer’s public key. Failure indicates tampering with the header, principal, or scope. - 4.Hop sequence and structure integrity. For each hop, verify that
seqequals its index plus one; any gap or duplication MUST cause rejection. Verify that eachparent_hopreferences either0or theseqof a prior hop; an out-of-range value MUST cause rejection. Verify that each hop’stimestampis greater than or equal to that of the hop before it; a decrease MUST cause rejection. - 5.Hop signature verification. For each hop at index
i: confirmhop_signatureis present, where absence MUST cause rejection; reconstruct the signing payload described in §4.2 using hops0throughi-1with their signatures, plus the hop atiwithout its own, prepended by the root signature value; then serialize per RFC 8785 and verify against the issuer’s public key. - 6.max_hops check. If
scope.max_hopsis defined, the length ofchainMUST NOT exceed it. - 7.Session binding check.
header.session_idMUST exactly match the session identifier supplied by the verifying application. This prevents token replay across sessions.
An optional eighth step MAY be performed where the application has registered a Proof-of-Humanity verifier: if principal.poh_credential is present and a verifier callback is configured, the credential MUST be validated by that callback, and the token MUST be rejected if validation fails. The callback runs last because it is application-defined and may be remote, costly, or side-effecting. Ordering it after Steps 1 through 7 keeps those steps offline and ensures that no external verifier is invoked for a token that fails its cryptographic checks. See §9.3.
A token that passes all seven steps is authentic and intact: its header, principal, and scope are as the issuer signed them, and every recorded hop is as the issuer recorded it. Passing verification establishes nothing about whether the presenter may perform any action. That determination is made by the application’s own authorization mechanism, to which the verified token is an input. See §1.1.
5.1Historical audit verification#
An auditor MUST be able to examine an expired or revoked token without treating it as acceptable for a new request. Audit tooling MUST report the following three results separately. They are verification results, not new fields in an HDP token.
- Record integrity
- Whether the record conforms to the format and its root and hop signatures verify. Apply the input validation in §3 and steps 1, 3, 4, 5, and 6 of §5, using a trusted archived issuer key. Failure of one of these checks MUST NOT be reported as valid integrity. Expiry and revocation do not invalidate the signature mathematics and are reported separately. If the key or the supported verification algorithm is unavailable, integrity is unverified rather than valid.
- Current acceptance
- Whether the live acceptance pipeline succeeds now. It MAY be reported as not evaluated when no current request or session exists. Successful integrity verification MUST NOT be used as a substitute for live acceptance.
- Historical acceptance
- Whether evidence establishes acceptance conditions at a particular verifier and time. The auditor MUST identify that verifier and evaluation time, check the recorded session context using step 7, check that the time falls within the token’s signed issuance and expiry interval, and evaluate the revocation state and any additional acceptance policy applicable there at that time. A positive result MUST require valid record integrity and authenticated evidence bound to the token and evaluation context. Missing evidence MUST produce an indeterminate result, not a claim that the token was historically accepted.
Historical evidence SHOULD include an authenticated receipt or integrity-protected verifier log binding the complete token digest (§8.2), the observed request or event, the session identifier, the verifier identity, the time, the decision, and the relevant revocation and policy state. Any required Proof-of-Humanity result belongs in that evidence; a credential check performed today is not evidence of its status then. A declared hop timestamp alone is not trusted time evidence, and an empty current revocation set does not establish past status. These records are application-layer artifacts whose encoding is outside HDP v0.1, and they can be retained and checked offline.
6Re-authorization#
Long-running or streaming sessions may exhaust the max_hops limit, require scope expansion, or reach a high-risk action that warrants fresh human confirmation. In these cases the issuer, acting on behalf of the human principal, issues a new token that supersedes the original.
Re-authorization is indicated by setting header.parent_token_id to the token_id of the token being superseded. This field MUST be set before computing the root signature, so the parentage link is cryptographically covered by the new token’s root signature.
A re-authorized token:
- Has a new
token_id,issued_at, andexpires_at. - Inherits
session_id,principal, andscopefrom the original unless explicitly overridden. - Starts with an empty chain, so the delegation count resets.
- Records
parent_token_idpointing at the original, creating an auditable lineage of scope evolution.
Verifiers that require re-authorization chain traversal SHOULD retain all tokens in a session and verify the full parent_token_id linkage.
7Multi-principal delegation#
HDP v0.1 supports one principal per token. Joint authorization by multiple humans is achieved by sequential chaining: Human A issues token T1, then Human B issues token T2 with parent_token_id equal to T1’s token_id. Each token is independently signed with its issuer’s key. To verify a multi-principal chain, a verifier MUST:
- 1.Verify each token individually against its issuer’s public key using the live acceptance pipeline (§5), or historical audit verification when examining past records (§5.1).
- 2.Verify that
T[i].header.parent_token_idequalsT[i-1].header.token_idfor alligreater than 0. - 3.Verify that all tokens in the chain share the same
session_id. - 4.Obtain trusted application context identifying each parent-child relationship as joint authorization. Without that context, report linked records with an unknown relationship, not established joint authorization.
This provides auditable joint authorization without a threshold signature scheme. Each principal’s authorization is a distinct signed artifact. Simultaneous multi-signature primitives using threshold schemes are planned for a future version.
An alternative to chaining is composition: each principal issues an independent token, and the verifier’s policy requires that both be presented. Composition is more general and composes further downstream, and a verifier MAY adopt it. Chaining is specified here because T2 signs a reference to T1, making the linkage part of the record. The link alone does not state that the authorizations were conjunctive or approved the same action; that meaning requires the application context described below. Composition can also provide auditable evidence when an authenticated receipt binds both token digests to the request and to the policy requiring them. Without such retained context, neither a bare parent link nor two independent tokens establishes joint approval.
8Transport#
The HTTP header field names defined below do not use the X- prefix, in accordance with RFC 6648.
8.1HTTP header: HDP-Token#
Tokens MAY be transmitted in HTTP requests and responses using the HDP-Token header. The value is the base64url encoding, no padding, of the UTF-8 JSON serialization of the complete token object.
POST /api/task HTTP/1.1 Host: agent.example.com HDP-Token: eyJoZHAiOiIwLjEiLCJoZWFkZXIiOnsi... Content-Type: application/json
A token accompanies a request because the task it records travels in that request. Its presence does not authorize the request (§1.1). The receiving service decides whether to act by its own means and MAY use the verified token as an input to that decision.
HTTP header values are routinely written to access logs, proxy logs, and error reports, and the HDP-Token value contains the principal object and the full chain. Deployments SHOULD configure logging to treat HDP-Token as sensitive, as they would an Authorization header.
8.2Token by reference: HDP-Token-Ref#
Where token size is a concern, for example with large chains, the token MAY be stored server-side and referenced using the HDP-Token-Ref header. The reference is either the token’s token_id, or a content-addressed reference: the string sha256: followed by the base64url encoding, no padding, of the SHA-256 digest (RFC 6234) of the token’s canonical JSON serialization per RFC 8785.
POST /api/task HTTP/1.1 Host: agent.example.com HDP-Token-Ref: 550e8400-e29b-41d4-a716-446655440000
A recipient resolving a content-addressed reference MUST validate the resolved token’s input representation, serialize the complete token, including signature and all hop signatures, with RFC 8785, encode the result as UTF-8, compute SHA-256, and compare the digest with the reference. The digest MUST be exactly 32 bytes encoded as canonical unpadded base64url; a malformed encoding or a digest mismatch MUST cause rejection. The comparison commits to canonical JSON, not to whitespace or member ordering in the stored serialization. For a UUID reference, the resolved header.token_id MUST identify the same UUID, compared by its 128-bit value rather than hexadecimal letter case; a mismatch MUST be rejected.
Successful reference resolution MUST be followed by live acceptance or historical audit verification as appropriate. A valid signature alone does not establish that the requested reference was resolved correctly. Implementations using token-by-reference MUST secure the token store and use TLS for all reference resolution.
8.3Key distribution#
Issuers that wish to publish their Ed25519 public keys for automated discovery SHOULD serve a JSON document at /.well-known/hdp-keys.json with the following structure.
{
"keys": [
{
"kid" : "alice-signing-key-v1",
"alg" : "Ed25519",
"pub" : "<base64url-encoded 32-byte Ed25519 public key>"
}
]
}This endpoint is a discovery convenience only. It is not part of verification, which takes the issuer’s public key as an input and remains fully offline (§10.11). A verifier that has obtained the key by other means has no reason to consult it.
The format is intentionally minimal and implementations MAY extend it with additional metadata. The alg field MUST be Ed25519 for v0.1 keys. Consumers MUST reject entries with unrecognized alg values, and MUST validate that the decoded public key is exactly 32 bytes.
9Privacy considerations#
9.1Minimum-disclosure principal fields#
The principal object may contain PII, including an email address or display name. Issuers SHOULD apply the principle of minimum disclosure when constructing tokens that will traverse multiple agents.
- Use
id_type: "opaque"with an application-internal identifier rather than embedding the user’s email address in tokens that will be sent to third-party agents. - Omit
display_namewhen the receiving agent does not require a human-readable identity.
The same principle applies to the agent_id field in hop records (§3.4). An agent_id need not be meaningful to anyone but the delegator that assigned it. This is sufficient because accountability in a delegation chain is recursive: a delegator is responsible for how its direct delegate uses the delegation, even when the use occurred further down the chain, and that delegate is in turn responsible for its own direct delegate. A verifier or auditor therefore never needs to resolve an agent_id globally. It needs the delegator at each step to be able to identify the party it delegated to, and the agent_id and its action_summary are bound into the signed chain for exactly that purpose.
Which identifier to use is context dependent, and HDP does not prescribe one. Non-exhaustively, a widely known identifier, such as an enterprise employee or service number, suits deployments where correlation is not a concern; an identifier meaningful only to the delegator suits deployments where an observer must be prevented from correlating requests across chains; a DID (W3C DID) suits deployments where a trusted authority exists to assert claims about it. An issuer or extending agent MAY use a fresh identifier for every delegation.
HDP v0.1 offers no field-level confidentiality: a token is either presented whole for verification or stripped and marked audit-only, as above. Encrypting principal fields is not specified, because the keys in circulation are Ed25519 signing keys rather than encryption keys and because the set of verifiers is deliberately open, so there is no defined party to encrypt to. Selective disclosure of principal fields and of individual hops, which would allow a token to be verified with parts withheld, is planned for a future version.
9.2Data retention and the right to erasure#
HDP tokens may constitute personal data under applicable privacy regulations, such as GDPR Article 4(1), when the principal.id or principal.display_name fields contain directly or indirectly identifying information.
Implementations SHOULD:
- Store tokens with explicit retention periods derived from
header.expires_at. - Provide deletion mechanisms that remove stored tokens upon erasure requests.
- Use opaque identifiers in
principal.idwhere possible, maintaining a separate mapping that can be destroyed independently of the token audit log.
Encrypting stored tokens does not by itself discharge an erasure obligation, since the ciphertext remains personal data for as long as the key exists. Destroying the key, crypto-shredding, is a recognised technique for rendering retained tokens unreadable and MAY be used together with the mapping-destruction approach above.
9.3Proof of humanity#
The optional principal.poh_credential field MAY carry a credential attesting that the principal is a human, for example a Worldcoin World ID proof, a CAPTCHA session token, or a biometric attestation identifier. The HDP protocol does not define the semantics of this field; verification is entirely application-defined.
When a PoH verifier is configured, the verification pipeline MUST validate the credential as the final step, after session binding, and MUST reject the token if validation fails. The verifier callback SHOULD be idempotent and SHOULD NOT have side effects. §5 explains why the callback is ordered last.
10Security considerations#
10.1Threat model#
HDP is designed to provide provenance and tamper evidence, not runtime enforcement. An agent that exceeds its declared scope is still a bad actor; HDP creates an evidence trail, not a capability boundary. Applications requiring runtime enforcement MUST implement it at the application layer using the HDP token as audit input. HDP is not an authorization protocol (§1.1); the properties discussed below are properties of the record: who could have produced it, whether it has been altered, and what it does and does not establish.
10.2Token forgery#
A forged token, one whose header, principal, or scope fields do not match the original issuance, will fail §5, step 3, the root signature check. The security of this step relies on the unforgeability of Ed25519 signatures and the collision resistance of SHA-512, used internally by Ed25519. An attacker that does not possess the issuer’s private key cannot produce a valid root signature for a modified token.
10.3Chain tampering#
Modification, reordering, or removal of any non-trailing hop is detectable: it either breaks the hop sequence check (§5, step 4) or invalidates the hop signatures of all subsequent hops (step 5), because each hop signature covers all previous hops and the root signature. Insertion of a fabricated hop similarly fails unless the attacker possesses the issuer’s private key. Removal of one or more trailing hops is a distinct case that these checks do not detect; see §10.4.
10.4Chain truncation and completeness#
Each hop signature covers only the hops that precede it and the root signature. Consequently, deleting one or more hops from the end of the chain, or presenting an earlier and shorter copy of a token, yields a token that still passes every step of the verification pipeline. HDP therefore provides tamper evidence for the hops that are present, but does not by itself prove that the chain is complete.
Relatedly, a non-cooperating or compromised agent can decline to append a hop for an action it takes. HDP records declared delegation actions and cannot compel an agent to record one. HDP is an evidence trail, not an enforcement mechanism (§10.1).
A verifier that can authenticate the presenter, for example because the transport identifies the calling agent, SHOULD require that the final hop’s agent_id correspond to that presenter. This is cheap and closes one truncation case: a third party holding a shorter, earlier copy of the token cannot present it, because the final hop of that copy names someone else. Capability systems impose the same requirement; UCAN Invocation requires the delegation chain to end at the invoker, and a ZCAP-LD invocation proof is rooted in the invoker’s key. See §12.4 and §12.5.
The presenter check does not make the chain complete. In a capability chain, truncation gains an attacker nothing beyond what the presenter check catches, because authority only narrows toward the tail: a truncated prefix is usable only by the delegatee of its last remaining hop, who holds that authority legitimately. HDP hops record actions, not grants, and there is no attenuation; a truncated chain carries the full original scope. The case HDP must consider is an intermediate agent that deletes the hops appended after its own, in order to hide what its sub-agents did. After truncation that agent genuinely is the presenter, and the presenter check passes.
Concurrent extensions from the same prefix can produce two valid branches with the same token_id, hop count, and final agent_id, but different recorded actions. A hop count or presenter check cannot distinguish them. The signature pipeline verifies the supplied branch; it does not discover other branches or select a uniquely final one.
Deployments that require one linear record per token MUST serialize extensions at the issuer. The issuer MUST atomically check that the submitted prefix matches its accepted chain head and advance that head when committing an extension. A stale prefix MUST be rejected for reconciliation against the current head. An already signed hop cannot simply be transplanted onto another branch; extending the reconciled prefix requires a new signature. Retries SHOULD return an already committed result when the application identifies the same extension request. Deployments that intentionally allow branching MUST retain and identify the branches separately and define how their audit process accounts for them. HDP v0.1 defines no branch merge operation. Issuer serialization is state used for construction, not a network dependency of verification.
Applications requiring evidence of a particular observed or final record SHOULD retain an authenticated receipt or settlement record binding the token_id, session_id, complete token digest as defined in §8.2, observation time, and observing party. It MUST distinguish an observed snapshot from a claimed final record. A verifier relying on that receipt MUST validate its authenticity and compare the token digest. A hop count MAY be included for diagnostics but MUST NOT be treated as a substitute for the digest. The receipt establishes which branch was observed or finalized under the application’s policy; it does not prove that no unrecorded action or undisclosed branch exists. Off-record delegation remains a separate limitation (§10.7). These receipts are application-layer artifacts, not new token fields.
10.5Replay attack defense#
HDP provides two orthogonal replay defenses:
- 1.Expiry. Every token carries
expires_at. An expired token is rejected at §5, step 2, regardless of network conditions. - 2.Session binding. The token carries the
session_idestablished out of band between issuer and verifier. A token is valid only within the session for which it was issued. Even a non-expired token cannot be replayed across sessions.
Together, these defenses ensure that a stolen token is useful to an attacker only within the original session and only until it expires or is revoked (§10.6).
HDP specifies no default lifetime, deliberately. Expiry alone forces a choice between tokens that lapse just before they are needed and tokens that outlive a detected compromise, and the tendency in deployed systems is for lifetimes to lengthen over time as the first kind of failure accumulates operational friction. Issuers SHOULD choose the shortest lifetime the task permits, and SHOULD rely on revocation rather than on long lifetimes to avoid disruption, since revocation is what bounds the exposure of a compromised token regardless of the lifetime it was issued with.
Session binding says nothing about replay of the same token within its session. Whether a presenter may present one token for two requests is an application-layer question on which HDP takes no position. Applications for which it matters SHOULD record the requests each token has accompanied, for example by retaining a hash of each request until the token expires, and reject repeats.
Because session_id anchors the session-binding defense, it SHOULD be unguessable. Issuers SHOULD generate session_id values with at least 128 bits of entropy from a cryptographically secure random source. A predictable session_id weakens replay protection.
10.6Revocation#
A verifier MUST support being instructed to stop honouring a token. The instruction identifies the token by header.token_id; the verifier records that identifier in local revocation state and thereafter rejects the token at §5, step 2. Revocation MUST NOT prevent separate historical integrity verification (§5.1). No central registry, no publication mechanism, and no network access at verification time are involved. The revocation state is held by the verifier, as the session_id already is, and verification remains fully offline (§10.11).
HDP does not specify who may revoke, how the instruction reaches the verifier, or the retention period for revocation evidence; these are verifier policy. Retaining an entry until the corresponding token’s expires_at is sufficient for live rejection, since the token is rejected on expiry thereafter. Historical audit may require longer retention of revocation events and effective times, as described in §5.1. The range of reasonable policies is illustrated by existing capability systems: UCAN allows a delegator to revoke and makes the right to revoke itself delegable, and ZCAP-LD allows any delegator in a chain to revoke what it delegated. See §12.4 and §12.5.
Some designs obtain bounded revocation freshness differently, by requiring the verifier to fetch a short-lived status assertion from the issuer before honouring a token. HDP does not, because that makes every verification depend on the issuer being reachable. The trade is deliberate: HDP keeps verification offline and leaves the freshness of revocation state to whoever populates it.
Revocation is per token, not per hop. There is no mechanism to revoke authorization for a single delegate in the middle of an otherwise valid chain while leaving the token valid; the token is revoked and, if the task is to continue, re-authorized (§6). Deployments that require per-delegate revocation SHOULD layer a capability system that supports cascade revocation at the application layer. Retaining accountability for each delegate, for example through distinct per-hop identifiers (§9.1), is what makes such application-layer revocation actionable.
A consequence of any revocation mechanism is that proof an action was authorized is not, by itself, proof that the authorization was still current when the action was taken. An auditor reading a token after the fact cannot tell from the token whether it had been revoked at a verifier; that information lives in the verifier’s state and SHOULD be retained alongside stored tokens where audit requires it.
10.7Delegation budgets and off-record delegation#
The scope.max_hops field (§3.3) creates an incentive that works against the purpose of this protocol, and issuers need to understand it before setting the field. When an application gates actions on a valid chain and the hop budget is exhausted, an agent that still needs to delegate has two options: seek re-authorization (§6), or delegate without appending a hop. The second is off-record delegation. It produces a chain that verifies, an action that occurred, and no record connecting them, which is the worst outcome a provenance protocol can produce. A limit meant to constrain delegation instead constrains the recording of it.
The usual motivation for limiting delegation depth is to bound the cost of verifying, storing, or reasoning about long chains. That is a verifier concern and belongs at the verifier: a verifier MAY reject or flag chains longer than a locally configured limit, as a heuristic it controls and can adjust without reissuing tokens. Placing the limit in the token binds every verifier to a number chosen at issuance and hands the incentive above to every agent that carries the token.
Accordingly, issuers SHOULD omit max_hops unless the delegation budget is itself part of what the human declared and recording it has evidentiary value. Where the field is set, applications SHOULD make re-authorization readily available to agents that exhaust it, so that the honest path is not more costly than the off-record one. The field is retained in v0.1 because it is optional and because, where a human did declare a budget, the declaration is provenance.
10.8Attribution across concurrent tokens#
An agent may hold more than one valid token whose scope covers the same resource: for example, one issued for Alice authorizing a read of a dataset and one issued for Carol authorizing an update to it. Applications MUST bind an action or attempted action to the task and token that actually triggered it, and agents MUST record it under that context. They MUST NOT select a different token merely because its scope would make the action appear authorized. A deviation from the triggering token’s scope SHOULD be recorded under that token, explicitly identified as an attempted, blocked, or observed violation in action_summary. Recording the deviation does not amend scope or assert that the principal approved it. If the triggering context is unknown, the application MUST preserve that uncertainty in its audit record rather than assign an unrelated principal.
HDP cannot detect a violation of this rule. A hop appended to the wrong token verifies at every step of the pipeline, because the pipeline establishes that the hop was recorded, not that it was recorded in the right place. The consequence is borne at audit: an update performed in Carol’s task but recorded under Alice’s token misattributes the triggering context and leaves Carol’s token silent. Conversely, an update that actually occurred in Alice’s read-only task belongs in Alice’s task record as a violation; it MUST NOT be moved to Carol’s token to make it appear permitted. A signed record alone cannot prove correct task attribution, and inclusion of an action MUST NOT be interpreted as proof that the principal approved it.
Where more than one task could legitimately initiate an action, selecting the initiating task is application policy. Applications SHOULD define and record that choice before execution, together with a request or event identifier. Once selected, the triggering context governs provenance even if the action deviates from its scope. Multi-principal delegation (§7) does not address this case: it covers tokens linked by parent_token_id that share a session_id, and the tokens here are unrelated. The neighbouring question of how a service decides which of several grants applies to a request is an authorization-layer question and is outside HDP (§1.1).
10.9Prompt injection#
Prompt injection attacks attempt to cause an agent to act as if it received instructions from a legitimate principal, when in fact the instructions originate from adversarial content in the agent’s environment, such as a malicious web page or document. HDP mitigates but does not fully prevent this attack.
Applications SHOULD detect and block actions that contradict the human’s declared scope using their own enforcement mechanisms. The semantic comparison is application-defined. Blocking an action MUST NOT require suppressing its evidence: an HDP-aware agent SHOULD record the attempted action, the detected scope deviation, and whether it was blocked in action_summary under the triggering task’s token. If a violation is observed after execution, it SHOULD likewise be recorded as an observed violation, without claiming that the principal approved it or that the signature proves execution. The hop timestamp remains the extension time, not a backdated event time. If the token cannot be extended, for example because its hop budget is exhausted, the application SHOULD retain an integrity-protected incident record linked to the token digest and triggering request. HDP v0.1 adds no status field for this purpose; the distinction is explicit in the declaration.
The mitigation HDP provides is evidentiary: an HDP-aware agent records each delegation action it takes as a signed hop, so an action carried out under a legitimately issued token leaves an auditable record, supporting post-hoc detection of prompt injection. This mitigation depends on agents actually recording their actions; an agent that omits a hop is discussed in §10.4.
10.10Key management#
The security of all HDP guarantees depends on the confidentiality of the issuer’s Ed25519 private key. Implementations MUST:
- Store private keys in a secrets manager, HSM, or equivalent secure enclave. Private keys MUST NOT be stored in source code, configuration files, or environment variables in production.
- Use distinct key pairs per environment, development, staging, and production.
- Support key rotation by issuing new tokens with a new
kidwhile maintaining the old public key in the verifier’s registry until all tokens signed with it have expired. Applications requiring historical audit SHOULD retain trusted public keys and relevant compromise history for the audit retention period (§5.1). This does not require retaining retired private keys.
10.11Offline verification guarantee#
HDP makes a strong architectural guarantee: a correct implementation of the seven-step verification pipeline requires no network calls, no registry lookups, and no third-party contact. The complete trust state required for verification is:
- The issuer’s Ed25519 public key, 32 bytes.
- The current session identifier, a string.
- The current time, for expiry checking.
- The verifier’s own revocation state: a set of
token_idvalues, possibly empty (§10.6).
This guarantee is a property of the verification procedure, not of the single-key signing model of v0.1. Per-agent hop signing on the pattern described in §4.2 would preserve it, since the verifier would still resolve only the issuer’s key out of band.
This guarantee enables HDP verification in air-gapped environments, edge deployments with intermittent connectivity, and latency-sensitive contexts where a network round-trip before every action is unacceptable.
11IANA considerations#
11.1HTTP header field registration#
This document requests registration of the following HTTP header fields in the Hypertext Transfer Protocol (HTTP) Field Name Registry.
- HDP-Token
HDP-Token
Status: provisional
Reference: this document, §8.1
Comments: Carries a base64url-encoded HDP token for agentic delegation provenance.- HDP-Token-Ref
HDP-Token-Ref
Status: provisional
Reference: this document, §8.2
Comments: Carries a UUIDtoken_ididentifying a fixed token snapshot, or asha256content-addressed reference to a complete HDP token.
11.2Media type registration#
This document requests registration of the application/hdp-token+json media type in the Media Types registry, following the procedures of RFC 6838.
- Type name
application- Subtype name
hdp-token+json- Required parameters
- N/A
- Optional parameters
- N/A
- Encoding considerations
- Binary; the token is a UTF-8 JSON object (RFC 8259).
- Security considerations
- See §10 of this document.
- Interoperability considerations
- The token uses the
+jsonstructured syntax suffix (RFC 6839); generic JSON processors can parse it. HDP-specific semantics are defined in this document. - Published specification
- This document.
- Applications that use this media type
- Agentic AI frameworks and services that exchange HDP delegation-provenance tokens.
- Fragment identifier considerations
- N/A
- Additional information
- Deprecated alias names: none. Magic number(s): none. File extension(s): none. Macintosh file type code(s): none.
- Person and email address to contact
- Asiri Dalugoda <[email protected]>
- Intended usage
- COMMON
- Restrictions on usage
- None
- Author
- Asiri Dalugoda
- Change controller
- IETF
11.3Well-known URI registration#
This document requests registration of the following entry in the Well-Known URIs registry, per RFC 8615.
- URI suffix
hdp-keys.json- Change controller
- IETF
- Specification document
- This document, §8.3.
- Status
- provisional
- Related information
- Serves a JSON document listing an issuer’s Ed25519 public keys for HDP token verification.
12Comparison with related work#
12.1IPP (draft-haberkamp-ipp-01)#
The Intent Provenance Protocol (IPP) and HDP address the same root problem with different architectural trade-offs. The key differences are:
- 1.Revocation model. IPP -01 Section 8 describes its revocation registry as a distributed service at an endpoint specified by the token. IPP requires agents to poll at the configured interval, with a recommended default of 5,000 milliseconds; for high-stakes actions IPP recommends an additional check immediately before acting. When the registry is unreachable, IPP permits action only if the token supplies
offline_grace_period_msand the offline duration remains within that period. Otherwise IPP prohibits proceeding. HDP instead consults verifier-local revocation state at verification time (§10.6). HDP does not require polling, but it also provides no protocol-defined bound on the freshness of that local state. - 2.Trust anchor. IPP tokens contain a genesis object, the Genesis Seal, a cryptographic artifact linking every token to the specification author’s public key at the IPP founding public key. Self-hosted IPP deployments are cryptographically bound to this third-party key. HDP tokens carry no genesis seal and no specification-level attribution; any organization can issue and verify HDP tokens without anchoring to a third party.
- 3.Identity model. IPP mandates W3C DID Core-conformant principal identifiers. HDP supports
id_type: "opaque"as a first-class option, making DID infrastructure optional rather than required.
These are design choices, not defects. Deployments with reliable connectivity to a revocation service, existing DID infrastructure, and a requirement for revocation across token ancestry may prefer IPP. Deployments that prioritize offline operability, self-sovereignty, and minimal infrastructure may prefer HDP.
12.2OAuth 2.0 Token Exchange (RFC 8693)#
OAuth 2.0 Token Exchange defines a mechanism for exchanging one security token for another, including delegation and impersonation use cases. HDP and RFC 8693 are complementary rather than competing: RFC 8693 governs access token issuance and delegation in an OAuth 2.0 authorization server context, while HDP governs the provenance record that travels with an agentic task regardless of the authentication mechanism used.
HDP tokens do not replace OAuth access tokens. An agent framework MAY use OAuth 2.0 for resource authorization and HDP for delegation provenance simultaneously.
12.3JSON Web Token (RFC 7519)#
JSON Web Token provides a general-purpose signed claims format. HDP differs from JWT in three respects:
- HDP tokens carry an append-only, per-hop-signed delegation chain (
chain) that has no equivalent in the JWT standard claims set. - HDP uses RFC 8785 canonical JSON for signing payloads, rather than the base64url-encoded header.payload convention used by JWS (RFC 7515). This allows direct JSON manipulation without base64 decoding.
- HDP’s verification pipeline is domain-specific to agentic delegation, including session binding, hop verification, and
max_hops, rather than general-purpose.
12.4UCAN (User Controlled Authorization Networks)#
UCAN (User Controlled Authorization Networks) defines a capability-based authorization token system with chained delegation. HDP and UCAN share the concept of delegation chains but differ significantly in scope: UCAN is a general capability authorization system, while HDP is specifically a provenance record for human-authorized agentic tasks. HDP makes no claims about capability enforcement; UCAN tokens carry executable capabilities that are enforced by receiving systems.
A UCAN delegation records the authorization provenance of a capability: who delegated what to whom. UCAN’s separate Invocation and Receipt objects can record individual invocations and their results; HDP instead keeps the execution record inline in the delegation chain itself, as the signed action_summarydeclared at each hop, so that the human authorization and the subsequent declared actions travel together in a single offline-verifiable record. In this sense HDP complements capability systems rather than competing with them: a deployment MAY use UCAN, or ZCAP-LD, for capability delegation and HDP alongside it for the tamper-evident execution record.
12.5ZCAP-LD (Authorization Capabilities for Linked Data)#
ZCAP-LD expresses delegated authorization capabilities as Linked Data, with invocation and delegation rooted in a controller’s key. As with UCAN, a ZCAP-LD delegation chain captures the authorization provenance of a capability but not a record of the delegate’s subsequent actions. HDP neither defines nor enforces capabilities; it records the human authorization event and the subsequent execution history. Deployments that already use ZCAP-LD MAY use HDP alongside it to supply the execution audit trail ZCAP-LD does not itself provide.
12.6ODRL and the Verifiable Credentials Data Model#
The Open Digital Rights Language (ODRL) (W3C ODRL) is a W3C Recommendation for expressing permissions, prohibitions, and constraints. Several fields in HDP’s scope object (§3.3) overlap with concepts ODRL already defines: authorized_tools and authorized_resources correspond to ODRL actions and targets, network_egress and persistence map to ODRL permissions or prohibitions, and quantitative limits such as max_hops map to ODRL constraints.
HDP v0.1 deliberately retains a small, self-contained scope object rather than embedding an ODRL policy. The trade-off is explicit: the minimal object keeps tokens compact and implementable with only JSON and Ed25519, at the cost of the vocabulary reuse, policy composability, and tooling interoperability that ODRL provides. Deployments that already reason over ODRL policies will require a separate mapping to interpret HDP scopes.
A further limitation of the v0.1 scope object is that it is fixed at issuance. HDP has no attenuation: a delegate cannot narrow the scope at its own hop, because hops record actions rather than grants and a hop record has no field in which a narrower scope could be expressed. A delegate that wishes to pass on less than it received must obtain a new token from the issuer with a narrower scope. Per-hop caveats, which only the verifier and any attenuating agent would need to interpret, are planned for a future version.
Because the chain-of-custody mechanism is payload-agnostic (§1.5), a future HDP profile MAY carry an ODRL policy as its payload in place of the native scope object. Such a profile would gain a natural binding to the Verifiable Credentials Data Model 2.0 (W3C VC Data Model 2.0), whose termsOfUse property can carry ODRL policies. This binding is identified as future work and is not specified in this document.
AAppendix A: complete token example#
A complete token with a two-hop delegation chain. Signature values are truncated for readability. This example validates against the published JSON Schema. The scope lists a resource for each tool that acts on one, and each hop names the resource it declares acting on; §3.3 explains why v0.1 cannot bind tools to resources structurally.
{
"hdp": "0.1",
"header": {
"token_id" : "550e8400-e29b-41d4-a716-446655440000",
"issued_at" : 1711483200000,
"expires_at" : 1711569600000,
"session_id" : "sess-20260326-abc123",
"version" : "0.1"
},
"principal": {
"id" : "usr_alice_opaque",
"id_type" : "opaque",
"display_name" : "Alice Chen"
},
"scope": {
"intent" : "Analyze Q1 sales data and report.",
"authorized_tools" : ["database_read", "file_write"],
"authorized_resources": ["db://sales/q1-2026",
"file://reports/"],
"data_classification" : "confidential",
"network_egress" : false,
"persistence" : true,
"max_hops" : 10
},
"chain": [
{
"seq" : 1,
"agent_id" : "orchestrator-v2",
"agent_type" : "orchestrator",
"timestamp" : 1711483260000,
"action_summary" : "Decompose task; delegate to sub-agents.",
"parent_hop" : 0,
"hop_signature" : "base64url-sig-1..."
},
{
"seq" : 2,
"agent_id" : "sql-agent-v1",
"agent_type" : "sub-agent",
"timestamp" : 1711483320000,
"action_summary" : "Execute read query on db://sales/q1-2026.",
"parent_hop" : 1,
"hop_signature" : "base64url-sig-2..."
}
],
"signature": {
"kid" : "alice-signing-key-v1",
"alg" : "Ed25519",
"value" : "base64url-root-sig..."
}
}BAppendix B: revision history#
This document tracks the revisions of the Internet-Draft it is cited by. The token wire format has not changed across any revision listed here and remains HDP v0.1: a token issued under revision -00 has the same structure and the same signature payloads as one issued today. What has changed is what verifiers, implementers, and auditors are required to do with it. Revisions are listed newest first.
- -02 · 11 September 2026 · current
- Adds §1.1, stating that HDP is not an authorization protocol, and aligns the abstract, the scope field descriptions, the verification pipeline, and the transport text with it. Makes revocation normative: a verifier MUST support verifier-local revocation by
token_id, checked at step 2, and re-authorization is described as lineage rather than revocation. Removes the 24-hour default lifetime. Adds §5.1, separating historical audit from live acceptance and requiring record integrity, current acceptance, and historical acceptance to be reported separately. Makes hop timestamp monotonicity a MUST. States what a v0.1 hop signature does and does not attest. Adds a presenter check and a completeness analysis for chain truncation, guidance on delegation budgets and off-record delegation, and rules for attribution across concurrent tokens. Adds content-addressed token references with a write-once store requirement. Requires trusted context before aparent_token_idlink may be read as joint authorization. Notes thatauthorized_toolsandauthorized_resourcesare unbound lists, and corrects the Appendix A example accordingly. Specifies input validation and exact integer bounds. - -01 · 3 August 2026
- Incorporated review feedback from the W3C Credentials Community Group. Renamed the HTTP header fields from
X-HDP-TokenandX-HDP-Token-ReftoHDP-TokenandHDP-Token-Refper RFC 6648. Corrected root signature verification to resetchainto empty before canonicalization, matching the signing procedure, and clarified that in v0.1 the issuer produces all root and hop signatures with a single key. Added the payload-agnostic chain-of-custody framing, chain truncation and revocation as security topics, andsession_identropy guidance. Extended the related-work comparison with ODRL, ZCAP-LD, and a Verifiable Credentials alignment note. The token wire format was unchanged. - -00 · March 2026
- Initial submission. Specified the HDP v0.1 token structure, signing, verification pipeline, re-authorization, multi-principal delegation, transport, privacy considerations, and security analysis.
References and related work
- JSON Schema (token, v0.1)
- Machine-readable token schema.
- draft-helixar-hdp-agentic-delegation-02
- IETF individual Internet-Draft, Informational. Current revision, 11 September 2026.
- draft-helixar-hdp-agentic-delegation-01
- Previous revision. Retained for citations that name it.
- arXiv:2604.04522
- Design rationale and evaluation.
- 10.5281/zenodo.19332023
- Archival DOI.
- Helixar-AI/HDP
- TypeScript and Python reference implementations.
- Google Gemma cookbook
- HDP applied to Gemma 4 function-call security.
- HDP-P
- Companion profile for physical AI systems.
- Announcement
- Background on why HDP was published.
HDP v0.1 is a draft open for comment. This page serves IETF draft-02, dated 11 September 2026. Corrections and implementation reports are welcome at [email protected], or as issues on the reference implementation repository. The full list of changes by revision is in Appendix B.
More from Helixar Labs
All projectsHDP extended to physical AI: robots, vehicles, surgical systems.
Scan, harden, sign and attest build artifacts before they ship.
26-rule security scanner for MCP server infrastructure.