Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

🔐authorization

Struct AgentSkillAuthorization

Scheduled skill-level authorization object.

Scheduled tasks store this keyed object as their durable authorization component. It is intentionally non-copy because it owns the copyable per-vertex grants that are copied into each scheduled execution.

Fields

id: sui::object::UID

Struct AgentSkillAuthorizationInnerV1

Version one stored layout for [AgentSkillAuthorization].

The stable [AgentSkillAuthorization] cannot contain these fields because its published layout must remain unchanged while stored data evolves.

Fields

agent_id: sui::object::IDskill_id: u64interface_version: nexus_interface::version::InterfaceVersionvertex_authorization_grants: vector<nexus_primitives::authorization::Grant<nexus_interface::authorization::AgentVertexAuthorization>>

Struct AgentVertexAuthorization

Per-vertex DAG authorization payload.

Agent identity and recipient binding are enforced by primitive provenance.

Fields

skill_id: u64interface_version: nexus_interface::version::InterfaceVersiondag_id: sui::object::IDvertex: std::ascii::Stringtask_id: sui::object::ID

Struct AgentVertexAuthorizationContext

Full context bound to a worksheet, used to check that a vertex authorization matches an execution.

Fields

agent_id: sui::object::IDskill_id: u64interface_version: nexus_interface::version::InterfaceVersionexecution_id: sui::object::IDvertex: std::ascii::Stringtask_id: sui::object::ID

Struct AgentVertexAuthorizationStamp

Execution stamp that binds vertex authorization context to exact Tool inputs.

[AgentVertexAuthorizationContext] cannot carry the input commitment without changing its published layout, so both values live in this separate worksheet stamp payload.

Fields

Constants

Function agent_vertex_authorization_skill_id

Returns the skill ID of the vertex authorization.

Function agent_vertex_authorization_interface_version

Returns the interface version of the vertex authorization.

Function agent_vertex_authorization_dag_id

Returns the DAG ID of the vertex authorization.

Function agent_vertex_authorization_vertex

Returns the vertex of the vertex authorization.

Function agent_vertex_authorization_task_id

Returns the Task bound to the vertex authorization.

Function agent_vertex_authorization_context

Constructs the exact context bound to a vertex authorization worksheet stamp.

Function encode_agent_vertex_authorization_context

Encodes a vertex authorization context into its BCS byte representation.

Function agent_vertex_authorization_stamp

Constructs the execution stamp stored on a Tool-result worksheet.

Function agent_vertex_authorization_stamp_input_commitment

Returns the canonical 32-byte input commitment carried by the stamp.

Function worksheet_input_commitment

Authenticates the stamp against the worksheet and returns its input commitment.

Function authorization_matches_worksheet

Returns true only if the vertex authorization derives the exact execution stamp on the worksheet.

Function consume_verified_for_worksheet_as_recipient

Consumes an execution-proven vertex authorization for the matching worksheet recipient.

Function agent_skill_authorization_agent_id

Returns the agent ID of the skill authorization.

Function agent_skill_authorization_skill_id

Returns the skill ID of the skill authorization.

Function agent_skill_authorization_interface_version

Returns the interface version of the skill authorization.

Function agent_skill_authorization_grant_count

Returns the number of vertex authorization grants held by the skill authorization.

Function copy_agent_skill_authorization_vertex_grant

Returns a copy of the vertex authorization grant at the given index.

Function destroy_agent_skill_authorization

Destroys a Task authorization after no execution can consume its grants.

Last updated