Delegation & machine output

Gator/ERC-7710 delegation lifecycle with thirdfy-agent. Create, activate, preflight, run, and JSON automation.

Use thirdfy-agent delegation for Gator-compatible ERC-7710 authority. Alignment with runMode (self, hybrid, thirdfy, agent_wallet) is enforced server-side. See Delegation and protection.

Lifecycle (operator sequence)

1. Create

thirdfy-agent delegation create \
  --agent-api-key "$THIRDFY_AGENT_API_KEY" \
  --chain-id 8453 \
  --json

Returns an EIP-712 payload for the owner wallet to sign. Alias: delegation grant.

2. Activate

After the user signs in MetaMask or another supported wallet:

thirdfy-agent delegation activate \
  --agent-api-key "$THIRDFY_AGENT_API_KEY" \
  --json

Persists the binding. Status becomes active when caveats and expiry are valid.

3. Inspect and balance

thirdfy-agent delegation status --json
thirdfy-agent delegation inspect --json
thirdfy-agent delegation balance --json

Use before live writes to confirm expiry, executor, and remaining period allowance.

4. Preflight and run

thirdfy-agent preflight --json ...
thirdfy-agent run --json ...
thirdfy-agent intent-status --intent-id <id> --json

Preflight surfaces delegation, policy, and catalog blockers before execution.

5. Revoke or redeem

thirdfy-agent delegation revoke --json
thirdfy-agent delegation redeem --json

Revocation stops future authorizations. See Delegation and protection.

Run modes and delegation

runModeDelegation
thirdfy / hybridActive Gator binding required for delegated user capital
agent_walletAgent-owned wallet. No user delegation binding.
selfLocal signer. Delegation optional depending on action.

Machine output (--json)

Treat --json as the stable integration surface for scripts and CI:

  • Parse fields defensively. Unknown keys may appear as the CLI evolves.
  • Prefer exit codes plus structured error / blockedReason fields for automation.
  • Pair with REST Delegation API or MCP for non-shell agents.

Related

Run & status
thirdfy-agent run and intent-status for execute-intent jobs; JSON fields for automation.
CLI command reference
Full thirdfy-agent command reference — every flag, JSON shape, and example.