Section A• Last verified November 2026

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

1. Supported NEAR Wallet

A browser wallet compatible with @hot-labs/near-connect (HOT Wallet, Meteor, Intear, MyNearWallet, or Ledger).

2. NEAR Testnet Balance

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).
Personal vs Agent Wallet
Connecting your personal wallet does NOT grant agents access to your balance. Your personal wallet is only used to fund the agent's separate custody account and sign manual approvals.

Step 2: Create Your First Agent

Go to Agents and click Create Agent:

Agent Name: research-scout
Role: DeFi Intelligence & Protocol Verification
Capabilities: Select web_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:

ParameterExample ValueEnforcement Purpose
total_budget0.5 NEARHard lifetime ceiling for this mandate
per_tx_limit0.1 NEARMaximum amount in a single operation
approval_threshold0.05 NEARRequires human signature if tx exceeds this
allowed_recipientsresearcher.testnetStrict 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.

Custodial Isolation
Even if you deposit 10 NEAR into the agent's wallet, if its mandate budget is set to 0.5 NEAR, the policy engine will mathematically refuse to authorize more than 0.5 NEAR.

Step 5: Create and Authorize an Objective

Go to Objectives and enter your goal in natural language:

“Query validator performance data, compile report, and transfer 0.05 NEAR compensation to researcher.testnet upon successful verification.”

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.