Run it yourself

Open the hosted app, buy a skill, or run the whole thing locally.

There are three ways in, from fastest to fullest.

1. Just open the hosted app

Nothing to install.

Web app

Browse the registry, open a skill, press “Request the source” to see the live paywall.

Gateway API

The raw discovery directory the agent reads.

2. Buy and run a real skill (one command)

This pays a real testnet micro-payment, takes the licence, and saves the skill’s files locally. It targets the hosted gateway out of the box.

git clone https://github.com/sm-xd/sigil && cd sigil
pnpm install
# fill .env with a Hedera testnet operator account (see .env.example)
E2E_FRESH_PAYER=1 pnpm buy slugify

You will see the 402, the payment settle on Hedera, a licence NFT minted, and the files written under downloads/slugify/.

3. Run the whole loop locally

This runs the full cycle: seed a claim with staked USDC on Arc, then have the agent discover it, pay, probe it in the sandbox, dispute the violation, and settle on-chain. You need Node 22.13, pnpm and Foundry installed.

pnpm install && cp .env.example .env      # fill the keys, see RUN.md
pnpm hedera:bootstrap                      # Hedera topics, licence NFT, agent identity
pnpm deploy                                # SigilStake + DisputeResolver on Arc testnet
pnpm gateway                               # the x402 service on :4021
SEED_STAKE_USDC=10 SEED_ONCHAIN_SKILLS=cloud-helper pnpm seed
pnpm web                                   # the ledger UI on :3000
POLICY_MIN_STAKE_USDC=10 POLICY_MIN_CLAIM_AGE_SEC=0 pnpm e2e   # the agent, end to end

Every command, every environment variable, every expected log line, and the hosted-on-AWS setup are documented in full in the repo’s RUN.md.

The demo

The showpiece is a visitor using a skill that has money behind it:

1. Open Register a skill, pick an example (say git-status, which shells out), press Register, then Open a claim on it with the rule it breaks (NO_CHILD_PROCESS).
2. Open the registry, click a skill with USDC staked on Arc.
3. Press Request the source — the 402 paywall appears.
4. In a terminal, run E2E_FRESH_PAYER=1 POLICY_MIN_STAKE_USDC=10 POLICY_MIN_CLAIM_AGE_SEC=0 pnpm e2e.
5. Watch the payment land, the sandbox find the violation, and the 12.5 USDC pot move on Arc — all on screen.

A settled dispute: the pot has moved to the winner and the outcome is stamped.