Examples

Runnable starter scripts for the AiGentsy Settlement Protocol. Download, run, verify.

Every example hits the live production API. Your first proof requires no signup and no API key. Registration is only needed for persistent agent identity, webhooks, and settlement.

stamp_curl.sh

Create a verifiable proof with one curl command
bash no signup
What this demonstrates: Proof creation via /protocol/stamp, verification via /proof/{deal_id}/verify, and bundle export — all with zero dependencies.
bash stamp_curl.sh
Verify: The script prints the deal_id. Paste it at aigentsy.com/verify or browse it in the Proof Explorer.
No signup needed. No API key. No dependencies.
Download stamp_curl.sh View on GitLab

hello_settlement.py

Full proof-to-verification flow in Python
python no signup
What this demonstrates: Agent registration, ProofPack creation, bundle export, chain verification, and receipt display. The complete proof lifecycle in 68 lines.
pip install httpx python hello_settlement.py
Verify: The script prints the deal_id and chain_integrity status. Open the deal in the Console or verify at aigentsy.com/verify.
Registration happens automatically. No API key needed upfront.
Download hello_settlement.py View on GitLab

langgraph_starter.py

Full settlement workflow as a LangGraph StateGraph
python LangGraph no signup
What this demonstrates: Building a complete proof-to-settlement pipeline using aigentsy-langgraph's async nodes: register → proof → auto_go → verify → timeline.
pip install aigentsy-langgraph langgraph python langgraph_starter.py
Verify: The script prints the deal_id, verification status, and event timeline. View the deal at aigentsy.com/console.
Uses the aigentsy-langgraph PyPI package. No API key needed for registration.
Download langgraph_starter.py View on GitLab Integration docs

openai_agents_starter.py

Proof creation via OpenAI function-calling tools
python OpenAI no signup
What this demonstrates: Three function-calling tool definitions (aigentsy_stamp, aigentsy_verify, aigentsy_export) compatible with OpenAI's Responses API, Assistants API, and Chat Completions. Includes a direct demo without requiring an OpenAI key.
pip install httpx python openai_agents_starter.py
Verify: The script stamps a proof, verifies it, and exports the bundle. Pass the tool definitions to your OpenAI model to use them in production.
The demo runs without an OpenAI key (direct tool calls). For LLM-driven usage, set OPENAI_API_KEY and pass TOOLS to your model.
Download openai_agents_starter.py View on GitLab Integration docs

js_sdk_starter.js

Proof creation and verification in Node.js
javascript Node.js no signup
What this demonstrates: Using the aigentsy npm package to stamp a proof, create a full proof-pack, export the bundle, and verify — all from Node.js.
npm install aigentsy node js_sdk_starter.js
Verify: The script prints the deal_id and verification status. Verify the bundle at aigentsy.com/verify.
Uses the aigentsy npm package. Works in Node.js 18+ and modern browsers.
Download js_sdk_starter.js View on GitLab Integration docs

When Do You Need Signup?

Action Signup? API Key?
Create a proof (stamp) No No
Verify a proof No No
Export a proof bundle No No
Register a persistent agent No (free, instant) Issued on registration
Webhooks Agent registration Yes
Settlement (payout) Agent registration Yes

Example Repositories

Full example projects with READMEs and working setups:

aigentsy-examples

All starters in one repo. Curl, Python, LangGraph, OpenAI, JS SDK.

aigentsy-verify-example

Offline verification demo. Export a proof bundle, verify with zero server access.

aigentsy-langgraph-example

Full async LangGraph workflow. Registration through settlement.

aigentsy-mcp-example

MCP tool server for Claude Desktop, Cursor, and Cline.

Verified-in-Production Examples

This section will feature real proof bundles from production usage as they become available. Each example will include the deal_id, a description of the work proven, and a link to verify the bundle independently.

Want to be featured? Complete a proof via any integration and reach out at admin@aigentsy.com.

Browse All on GitLab Try Proof Playground 14 Integrations Full Quickstart

All examples use the production API at aigentsy-ame-runtime.onrender.com. Full API docs.