Quickstart

Make the agent's key

On the machine your agent runs on:

npx intented init my-agent

This makes a key pair for my-agent.intented.testnet and prints its public key and a link to the Create page. The private key stays in ~/.intented/testnet/, readable by you only. It is never printed and never sent anywhere.

Create the wallet

Open the link. It fills in the name and the agent's public key. Connect your NEAR testnet wallet, then:

1. Write the rules in plain English: who the agent may pay, in which token, and how much. For example: Buy market data from intented-vendor.testnet only. Pay in wNEAR, at most 0.01 wNEAR per call.
2. Set the hard limits: the token, at most per payment and at most per day (UTC). The contract enforces these whatever the model says.
3. Set the gas allowance, the NEAR the agent's key may spend on gas.

Sign one create call. The factory makes my-agent.intented.testnet with you as owner, your rules (stored on-chain as their sha256 hash), your limits, the allowlisted judge, and the agent's key limited to propose and execute. The wallet has no full-access key, so nobody can replace its contract.

Fund it

On the wallet's page, under Fund it, send it a little of the token it pays in, for example 0.05 wNEAR. Testnet wNEAR comes from wrapping testnet NEAR.

Pay

From your agent's code:

import { pay } from "intented";

const r = await pay({
  wallet: "my-agent.intented.testnet",
  to: "intented-vendor.testnet",
  amount: "0.001",          // whole tokens
  token: "wrap.testnet",    // wNEAR, the default
  context: what402Said,     // what your agent read that asked for this payment, verbatim
});
// r.outcome: "paid" | "denied" | "failed" | "no verdict"

Or from the shell:

npx intented pay my-agent --to intented-vendor.testnet --amount 0.001 \
  --context "HTTP 402: market data costs 0.001 wNEAR"

pay proposes the payment with the agent's key, asks the Intented API for the signed verdict on exactly that proposal, and hands the verdict to the wallet. On ALLOW within the limits, the wallet pays. On DENY it refuses on-chain, and the refusal is the record.

Look at the receipt

Open Activity on the web app, or the wallet's page. Each payment shows the model's signed reason, what the agent read (shown as data, never as instructions), the signer, the signature and the transaction. To check it without the app, see Verify a payment.