Quickstart Guide
Step-by-step walkthrough from wallet connection to your first executed objective.
This guide walks you through creating your first agent, setting a spending mandate, funding the dedicated custody wallet, and executing a real autonomous objective on NEAR Testnet in under 5 minutes.
Prerequisites
A browser wallet compatible with @hot-labs/near-connect (HOT Wallet, Meteor, Intear, MyNearWallet, or Ledger).
At least 1.0 NEAR on NEAR Testnet for funding your agent custody wallet and paying network transaction fees.
Step 1: Connect Your NEAR Wallet
Navigate to the Mandate Dashboard or click the Connect NEAR Wallet button in the top navigation header.
- Select your preferred wallet provider from the official Near Connect modal.
- Approve the connection request. Mandate will establish your session identity based on your NEAR address.
- Your personal account address will appear in the top-right pill (e.g.
alice.testnet).
Step 2: Create Your First Agent
Go to Agents and click Create Agent:
research-scoutweb_search, api_query, and near_transfer.Mandate provisions an isolated agent profile and generates a dedicated 64-character implicit NEAR custody address managed by OutLayer TEE.
Step 3: Issue a Capped Mandate
Click Create Mandate in the dashboard to set the agent's financial boundaries:
| Parameter | Example Value | Enforcement Purpose |
|---|---|---|
| total_budget | 0.5 NEAR | Hard lifetime ceiling for this mandate |
| per_tx_limit | 0.1 NEAR | Maximum amount in a single operation |
| approval_threshold | 0.05 NEAR | Requires human signature if tx exceeds this |
| allowed_recipients | researcher.testnet | Strict allowlist; transfers elsewhere are DENIED |
Step 4: Fund the Agent Custody Account
Click Fund Agent on the dashboard. Deposit 0.5 NEAR from your connected wallet into the agent's OutLayer TEE account.
Step 5: Create and Authorize an Objective
Go to Objectives and enter your goal in natural language:
Mandate synthesizes a structured DAG plan with deterministic SHA-256 plan hash. Review the proposed tasks and click Authorize Objective.
Step 6: Monitor Autonomous Fulfillment
Once authorized, background workers dispatch the DAG tasks to eligible agents. The agent executes research, submits independent verification evidence, and the ExecutionBoundaryService signs the 0.05 NEAR transfer inside OutLayer TEE.
You can monitor real-time execution in the Activity log and review the finalized NEAR transaction hash directly on NEAR Explorer.