whatisgithub

What is agent-commerce-kit?

kmjones1979/agent-commerce-kit — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5Setup · hard

In one sentence

A demo AI agent that places real orders and pays with stablecoins, with every secret locked in a vault and every payment gated by a separate approval service.

Mindmap

mindmap
  root((agent-commerce-kit))
    What it does
      Places real vendor orders
      Pays with stablecoins
      Enforces payment policy
    Tech stack
      Next.js
      Foundry
      1Claw vault
      Ampersend
    Use cases
      Order pizza through chat
      Book flights with policy checks
      Send gift cards with audit trail
    Audience
      Developers
      Onchain agent builders

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 build with it?

USE CASE 1

Test an AI agent that places real vendor orders with stablecoin payments

USE CASE 2

Study how a two-key approval system gates every agent payment

USE CASE 3

See how sensitive keys and card details stay out of an LLM's context

USE CASE 4

Try dry run commerce flows before enabling live sandbox ordering

What is it built with?

TypeScriptNext.jsFoundrySQLite

How does it compare?

kmjones1979/agent-commerce-kit0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Node.js 22+, Foundry, a 1Claw vault key, and an Ampersend account with a funded balance.

Unknown from the description, check the repository for license terms.

So what is it?

Agent Commerce Kit is a demo project showing how an AI agent can place real orders against real vendor APIs while keeping every payment locked down. It was scaffolded with a tool called Scaffold Agent, which generated a starting Next.js chat app, a local test blockchain, and an onchain identity for the agent, and commerce features were then added on top. The project combines four pieces. Scaffold Agent produced the base app. A service called 1Claw acts as a vault that holds every sensitive key and card detail, so nothing sensitive sits on disk or is ever shown to the language model itself. The app reads secrets through a wrapper that hides the value everywhere except one narrow point of use. A service called Ampersend sits in front of every payment as a policy and approval layer: the agent holds one signing key and Ampersend holds the other, so a transaction only goes through if Ampersend also signs it within limits set on its dashboard, and it can also issue prepaid Visa cards. A fourth service, Lasso, converts crypto into a Visa card and is used both behind the scenes for Ampersend card issuance and directly if you store your own card details in the vault as a backup payment method. On top of the scaffold, the added code includes a vault client, a driver for the Ampersend command line tool, payment instrument handling, a policy and audit log backed by a small local database, and connectors for a handful of vendors covering things like ordering pizza, booking flights, and sending gift cards. A chat interface lets you type a request such as ordering a pizza, and the agent walks through checking policy, getting approval, and completing the order, with the full history visible on an audit page. Running it locally requires Node.js, a build tool called Just, and a local Ethereum test chain run through Foundry, along with API keys for the vault and Ampersend services, and optionally a card from Lasso and a key for the chat assistant. By default, vendor orders run in a dry run mode that only prints what would happen rather than placing a real order, until you flip specific settings to enable live sandbox ordering.

Copy-paste prompts

Prompt 1
Explain how the two-key approval model between the agent and Ampersend works
Prompt 2
Walk me through setting up the 1Claw vault and seeding commerce credentials
Prompt 3
Show me how to enable live sandbox ordering for the Domino's or Duffel connectors
Prompt 4
Help me understand what the audit page tracks from intent to settlement

Frequently asked questions

What is agent-commerce-kit?

A demo AI agent that places real orders and pays with stablecoins, with every secret locked in a vault and every payment gated by a separate approval service.

What language is agent-commerce-kit written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Foundry.

What license does agent-commerce-kit use?

Unknown from the description, check the repository for license terms.

How hard is agent-commerce-kit to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is agent-commerce-kit for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.