git404hub

what is aiport-verify fr?

aiport-ops/aiport-verify — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A command line tool that independently re-checks whether an AI agent payment on the Agent Commerce Protocol was actually settled on chain.

vibe map

mindmap
  root((acp-verify))
    What it does
      Re-checks escrow verdicts
      Reads chain state
      Reorg check
    Tech stack
      TypeScript
      Node.js
    Use cases
      Audit agent payments
      Verify transaction finality
    Audience
      Developers
      Protocol participants
    Chains
      Base mainnet
      Base Sepolia

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Independently verify that an AI agent's escrow release was justified before trusting it

VIBE 2

Check whether a delivered on-chain transaction actually succeeded and finalized

VIBE 3

Detect when a supposedly final transaction was later reorganized out of the chain

VIBE 4

Audit an Agent Commerce Protocol job from the command line instead of trusting a single signature

what's the stack?

TypeScriptNode.js

how it stacks up fr

aiport-ops/aiport-verify0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node 22+ and an ACP agent identity (wallet credentials) with access to the target job.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

acp-verify is a command line tool that double checks payments made under the Agent Commerce Protocol, a system for AI agents to pay each other for work and release money from escrow. In that protocol, a single reviewer signature is enough to release the funds, with no built in way to recompute that decision or dispute it later. This tool gives anyone a way to independently re-check whether that release was justified, using only public blockchain data. Given a specific job on the protocol, the tool reads the agreed terms and the work that was delivered, finds the on-chain transaction tied to that delivery, and checks whether that transaction actually succeeded and is now permanently settled on the chain, including a check for whether the relevant block was later replaced by a different one. It does not redo the actual work or rerun any calculations. It only confirms that the delivered transaction really happened and stuck, which the README describes as a narrower and more honest claim than fully re-doing the job. The tool returns one of three verdicts: pass, meaning the transaction is confirmed and final, fail, meaning it reverted or was reorganized out of the chain, or unverifiable, meaning there was no on-chain action to check or it is not final yet, which is treated as an honest "cannot tell" rather than a false pass. Running it requires Node.js version 22 or newer and credentials for an agent identity that has access to the specific job, since job details are fetched through an authenticated system. You provide a chain ID and job ID, and it prints a plain summary plus a JSON object with the verdict and cryptographic hashes you can verify yourself against a block explorer. It currently supports the Base mainnet and Base Sepolia test network, is released under the MIT license, and is built by a company called aiport.

prompts (copy fr)

prompt 1
Explain what the Agent Commerce Protocol is and why a re-verifier like this one matters.
prompt 2
Walk me through installing Node 22 and setting up the wallet environment variables for this tool.
prompt 3
What is the difference between the pass, fail, and unverifiable verdicts this tool returns?
prompt 4
Help me understand what poa_hash and deliverable_hash represent in the output.

Frequently asked questions

what is aiport-verify fr?

A command line tool that independently re-checks whether an AI agent payment on the Agent Commerce Protocol was actually settled on chain.

What language is aiport-verify written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

What license does aiport-verify use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is aiport-verify to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aiport-verify for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.