NEUS Docs

Grant authority to an agent. Identity alone (agent-identity) does not allow the agent to act. The authority record shows who approved the agent, what it may do, how much it may spend, and when access expires. Check ID: agent-delegation controllerWallet is the approving account — the address that signs this step. See Agent concepts.

Setup

Check

neus_context → neus_agent_link

Create

neus_agent_create. Leave out controllerWallet when the signed-in profile account should approve.

Confirm

neus_agent_link until linked: true

Or finish on NEUS via hosted verify.

SDK

await client.verify({
  verifier: 'agent-delegation',
  data: {
    controllerWallet: '0x...',
    controllerChainRef: 'eip155:8453',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    scope: 'global',
    allowedActions: ['read_proofs'],
  },
  walletAddress: '0x...',
});

Both accounts need a CAIP-2 network reference (controllerChainRef, agentChainRef) unless the request already includes chain or chainId.

App link

One-time user approval lets your backend create receipts without asking for a signature on every request. This is different from creating a portal in your profile for hosted checks. See Integrations.

User signs in on NEUS
User approves the permissions once
Your app stores the receipt ID in qHash
Your backend calls verification with x-neus-app — no per-request signature

await client.verify({
  verifier: 'agent-delegation',
  data: {
    controllerWallet: userWallet,
    agentWallet: userWallet,
    scope: 'app-link',
    permissions: [
      'app:your-app-id',
      'origin:https://yourapp.com',
    ],
    expiresAt: Date.now() + 90 * 24 * 60 * 60 * 1000,
  },
  walletAddress: userWallet,
});

Permissions:

app:<appId> — matches your x-neus-app header
origin:<url> — restrict to your domain
origin:* — any origin

Send x-neus-app: your-app-id and matching site origin on verification requests. On Node, set appOrigin: 'https://yourapp.com' on NeusClient (or pass Origin via extraHeaders).

Payment limits

maxSpend is a whole-number string in token base units. For USDC (6 decimals), 25 USDC = "25000000". Use toAgentDelegationMaxSpend('25', 6) from @neus/sdk. When scope: "payments:x402" and allowedPaymentTypes: ["x402"] are set, the agent can settle metered API calls via x402 without a NEUS account. The calling application enforces the maxSpend cap client-side before signing each payment — the protocol does not decrement maxSpend server-side. When the cap is exhausted, the application stops signing payments and the agent is refused. See x402 pay-per-call for the full settlement flow.

import { toAgentDelegationMaxSpend } from '@neus/sdk';

await client.verify({
  verifier: 'agent-delegation',
  data: {
    controllerWallet: '0x...',
    agentWallet: '0x...',
    scope: 'payments:x402',
    permissions: ['execute', 'read'],
    maxSpend: toAgentDelegationMaxSpend('100.50', 6),
    allowedPaymentTypes: ['x402'],
    receiptDisclosure: 'summary',
    expiresAt: Date.now() + 7 * 24 * 60 * 60 * 1000,
  },
  walletAddress: '0x...',
});

Fields

Field	Required	Description
`controllerWallet`	Yes	Approving account (must match signer)
`controllerChainRef`	Yes*	CAIP-2 chain for the controller wallet. *Optional if the request supplies `chain` or `chainId`
`agentWallet`	Yes	Agent address
`agentChainRef`	Yes*	CAIP-2 chain for the agent wallet. *Optional if the request supplies `chain` or `chainId`
`agentId`	No	Linked identity id
`scope`	No	Permission scope (default: `global`)
`permissions`	No	Allowed actions
`allowedActions`	No	Explicit action allowlist
`deniedActions`	No	Explicit action denylist
`maxSpend`	No	Spend cap in token base units
`allowedPaymentTypes`	No	Payment rails (e.g. `x402`)
`receiptDisclosure`	No	`summary`, `full`, or `none`
`expiresAt`	No	Expiration (Unix ms)
`instructions`	No	Policy text (16000 chars)
`skills`	No	Up to 48 skill objects
`runtimePolicy`	No	Provider/model limits and human-approval requirement
`approvalPolicy`	No	Approval requirements for new claims or content

The protocol accepts bounded action strings in allowedActions and deniedActions. deniedActions always wins over allowedActions.

Human approval pattern

Your application enforces the limits recorded in the permission receipt:

const permissions = {
  controllerWallet,
  agentWallet,
  agentId: 'data-analyst',
  scope: 'global',
  allowedActions: ['read_data', 'draft_report'],
  deniedActions: ['send_message', 'approve_payment'],
  runtimePolicy: {
    requiresHumanApproval: true,
  },
  approvalPolicy: {
    humanApprovalRequiredForNewClaims: true,
    preApprovedContentOnly: true,
  },
  maxSpend: '15000000',
  expiresAt: Date.now() + 30 * 24 * 60 * 60 * 1000,
};

At runtime:

Check the current permission receipt before the tool call.
Apply deniedActions first.
Pause when the policy requires human approval.
Continue only after approval is confirmed.

Schema: agent-delegation.json.

Result

A receipt ID returned in qHash. Check it with neus_agent_link or neus_proofs_check before an action.

Revoke

await client.revokeOwnProof(qHash, walletAddress);

Set expiresAt and maxSpend when money or high-risk actions are in scope.

Agents

Agent authority

Setup

SDK

App link

Payment limits

Fields

Human approval pattern

Result

Revoke

​Setup

​SDK

​App link

​Payment limits

​Fields

​Human approval pattern

​Result

​Revoke

Setup

SDK

App link

Payment limits

Fields

Human approval pattern

Result

Revoke