Intented docs

Manage the wallet

Fund, withdraw, freeze, change the rules and rotate the agent's key.

Everything the owner does happens on the wallet's page in the web app, signed with the owner's own NEAR wallet. The web app holds no key. Connect as the owner to see the controls.

Fund it

Fund it sends the token the wallet pays in from your NEAR account to the wallet, in one transaction you sign. It registers the wallet with the token's contract for storage first (0.00125 NEAR, refunded if it's already registered), and for wNEAR it wraps your NEAR into wNEAR on the way. For a token the app can't fund directly, register the wallet and send it the token from your own NEAR wallet.

The agent's gas also comes from the wallet: the agent's key signs for the wallet's own account. The NEAR locked for the wallet's storage stays put; gas is paid from the NEAR above it, up to the key's gas allowance.

Withdraw

Withdraw from the wallet sends a token, or NEAR above what the wallet's storage needs, back to the owner. It needs no verdict and works while the wallet is frozen.

Freeze

Freeze stops every payment until you unfreeze. Withdraw still works. Use it the moment something looks wrong; the agent's proposals stay pending and can't execute.

Change the rules

Rules, then Edit, then Save and sign. The new text is stored with the API and its hash set on the wallet with set_mandate. It applies from the next payment. See Rules.

The agent's key

Under Agent:

  • Add a key puts a new public key on the wallet, limited to propose and execute, with a gas allowance: the most that key may spend on fees, out of the wallet's free NEAR. Nothing is sent when you add it.
  • Remove the agent key takes a key off the wallet. Do this if the agent's machine is lost or compromised.

When a key has used up its allowance, the agent's calls fail with a plain message saying so. Add the key again with a new allowance.

To rotate a key: run npx intented init <name> on the agent's new machine, add the printed public key, then remove the old one.

Hard limits

The wallet's per-payment and daily caps, its allowlisted token contracts and its allowlisted judge are shown under Hard limits. Changing them is an owner call on the contract (set_token, set_near_caps, allow_receiver, register_signer); see the contract reference.

What the owner can't do

Replace the wallet's contract. A wallet made by the factory has no full-access key, so nobody can, including the owner and the Intented team. If something is ever wrong with the code, withdraw the funds and create a new wallet.

On this page