Grantline Documentation

Grantline is the financial authority layer between an AI agent's intent and execution. An agent proposes an action, Grantline checks the active Mandate, and the authority layer returns ALLOW, ESCALATE, or DENY before the Vault moves capital.

The concepts explain the model. Enforcement and execution show how the current contracts apply it. Guides and reference pages then give integrators the exact fields, calls, and evidence.

Start with the model

• Strategy vs authority explains the distinction between an agent's intent and Grantline's authorisation decision.
• Mandates explains the rules that bind an agent to a Vault, including lifecycle, validity windows, and native-USD limits.
• Vaults explains the custody boundary around controlled capital, including UUPS upgrades and pausing.
• Action Plans explains the structured proposal format with TRANSFER and SWAP actions.
• Decisions explains the ALLOW, ESCALATE, and DENY outcomes.
• Delegation explains how authority moves to a sub-agent without becoming broader.
• Preflight explains the native-balance and native-USD balance checks.
• Guardians explains the planned model for adding external conditions.
• Records explains how authority, decisions, and execution outcomes stay traceable.

Follow an action through the system

• Security model explains the current boundaries between agent intent, authority, execution, and custody, including the GrantlineAdmin coordinator.
• Enforcement boundary follows the contract path from a signed plan to the Vault.
• Action commitments, signatures and nonces explains the canonical plan digest, domain binding, replay protection, escalation reservations, and nonce cancellation.
• Escalation explains controller approval and current-state re-evaluation.
• Revocation explains how authority stops without erasing its history, including pausing as a lighter alternative.
• Transaction lifecycle separates authorisation, execution, and receipt status.
• X Layer testnet records the current network and environment-specific integration boundaries.
• Contracts and deployments explains the manifest and contract wiring.

Guides

• Vault and Mandate setup walks through creating a Vault, funding it, and creating a Mandate.
• Normal execution covers signing, evaluating, and executing TRANSFER and SWAP plans.
• Escalated execution covers the full escalation lifecycle from submission to execution.
• Delegation covers creating child Mandates and managing inherited authority.
• Lifecycle management covers pausing, revoking, cancelling nonces, updating rules, and validity windows.
• Inspecting evidence shows how to read receipts, events, and explorer data.

Reference

• Mandate rules lists the exact rule fields, units, zero-disabled values, and inheritance behaviour.
• Action Plan reference lists the current action types, parameter encoding, and signature fields.
• Decisions and failures lists evaluator outputs and failure codes without treating them as execution records.
• Events explains the current registry, escalation, Vault, executor, and facade event surface.

Current implementation

The current contracts run on X Layer testnet and include:

• Vault custody, UUPS upgrades, and onchain execution events
• typed TRANSFER and SWAP Action Plans with EIP-712 signatures
• Mandates with validity windows, native-amount limits, and native-USD limits
• inherited Mandate rules, native-balance Preflight, and native-USD Preflight
• controller-approved escalation and revocation
• Vault and Mandate pausing for temporary suspension
• targeted nonce cancellation for recovery
• delegation to sub-agents with bounded authority and depth cap of 2
• GrantlineAdmin as the non-upgradeable protocol coordinator
• native-asset USD valuation through Chainlink price feeds

For AI agents and tools

• /llms.txt provides a concise index of the documentation.
• /llms-full.txt provides all documentation as one plain-text resource.
• Add .mdx to any docs URL to fetch that page as Markdown, such as /docs/concepts/mandates.mdx.
• /sitemap.xml provides the canonical URL map for crawlers and tools.