Transaction-Science/open-standards
Watch
1
0
Fork
You've already forked open-standards
 0
Code Issues Pull requests Projects Releases 15 Packages Wiki Activity Actions
open-standards/openpay/examples/demo-merchant
History
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Transaction Science ab59bb39ba Repo-wide toolchain refresh + jouleclaw policy/sandbox updates 
Pin to the repo rust-toolchain and refresh workspace/crate manifests across
openpay, eoc, arl, smart-byte, and joule-ui, and update the jouleclaw
omni/policy/sandbox crates accordingly. No wire-format or conformance-vector
changes.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-06-07 17:04:45 -04:00
..
src Initial import — three open standards under one shelf 2026-05-23 07:58:09 -04:00
Cargo.toml Repo-wide toolchain refresh + jouleclaw policy/sandbox updates 2026-06-07 17:04:45 -04:00
README.md Initial import — three open standards under one shelf 2026-05-23 07:58:09 -04:00

README.md

demo-merchant

The smallest end-to-end OpenPay payment demo. Generates a fresh EVM wallet, listens for op-server webhooks, polls Base for USDC balance changes, and exits on the first observed payment.

Whichever signal arrives first — an op-server intent.approved webhook for our wallet, or a non-zero balanceOf result on the USDC contract — wins.

Run

Terminal 1, op-server:

cargo run --release -p op-server

Terminal 2, demo merchant (testnet first, please):

cargo run --release -p demo-merchant -- --testnet

Output:

Merchant wallet: 0xabc123...
Explorer:        https://sepolia.basescan.org/address/0xabc123...
Listening on http://127.0.0.1:9090 for op-server webhooks at /webhook
Polling https://sepolia.base.org every 30s for balanceOf updates.

Send USDC (Sepolia testnet faucet recommended) to the printed address. The demo prints PAID: ... and exits 0.

Flags

  • --rpc-url URL — EVM JSON-RPC endpoint. Default https://mainnet.base.org.
  • --listen ADDR — webhook bind address. Default 127.0.0.1:9090.
  • --amount-usdc N — expected amount, display only. Default 0.10.
  • --explorer URL — block-explorer base. Default https://basescan.org.
  • --testnet — switch RPC + explorer to Base Sepolia.
  • --poll-secs N — balanceOf poll interval. Default 30.

Caveats

  • Real USDC on mainnet costs real money. Use --testnet for your first run.
  • The private key is generated in-process and never persisted; if you exit the demo, the funds at that address are effectively burned from your control.
  • The webhook endpoint has no signature verification — it's a demo, not a production receiver.