PyPI - arc-builder-kit - Versions diffs - 0.2.0__py3-none-any.whl - Mend

arc-builder-kit 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (58) hide show

arc_builder_kit/examples/payment-intent-receipt-matcher/index.html ADDED Viewed

@@ -0,0 +1,157 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Payment Intent Receipt Matcher · Arc MCP Builder Assistant</title>
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml;utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Cdefs%3E%3ClinearGradient id='g' x1='0' y1='0' x2='1' y2='1'%3E%3Cstop offset='0' stop-color='%230f766e'/%3E%3Cstop offset='1' stop-color='%232563eb'/%3E%3C/linearGradient%3E%3C/defs%3E%3Crect width='64' height='64' rx='16' fill='url(%23g)'/%3E%3Ctext x='50%25' y='55%25' text-anchor='middle' font-family='Inter,Arial,sans-serif' font-size='34' font-weight='900' fill='white'%3EM%3C/text%3E%3C/svg%3E" />
+  <meta name="description" content="Read-only Arc Testnet payment-intent receipt matcher. Compare a payment intent JSON with an onchain USDC Transfer receipt without wallets, keys, signing, or broadcast." />
+  <meta name="author" content="Arc MCP Builder Assistant contributors" />
+  <meta name="robots" content="index,follow" />
+  <meta name="theme-color" content="#061414" />
+  <meta name="color-scheme" content="dark" />
+  <meta name="referrer" content="no-referrer" />
+  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; connect-src 'self' https://rpc.testnet.arc.network; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; object-src 'none'; base-uri 'none'; form-action 'none'; upgrade-insecure-requests" />
+  <link rel="canonical" href="https://anstrays.github.io/arc-mcp-builder-assistant/examples/payment-intent-receipt-matcher/" />
+  <meta property="og:title" content="Payment Intent Receipt Matcher" />
+  <meta property="og:description" content="Read-only Arc Testnet matcher that compares a payment intent with a transaction receipt's USDC Transfer logs." />
+  <meta property="og:type" content="website" />
+  <style>
+    :root { color-scheme: dark; --bg:#061414; --panel:rgba(7,17,24,.86); --panel-2:rgba(255,255,255,.055); --text:#f8fffc; --muted:#c4d9d2; --soft:#8fa8a1; --line:rgba(255,255,255,.15); --teal:#5eead4; --blue:#9ab1ff; --lime:#d9ff72; --amber:#ffd166; --red:#ff9b9b; font-family: Inter, ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif; }
+    * { box-sizing: border-box; }
+    body { margin:0; min-height:100vh; background: radial-gradient(circle at top right, rgba(94,234,212,.2), transparent 34%), linear-gradient(145deg, #061414 0, #07101c 45%, #0d1726 100%); color:var(--text); padding:32px 0; }
+    main { width:min(1180px, calc(100vw - 32px)); margin:0 auto; display:grid; gap:18px; }
+    a { color:inherit; }
+    a:focus-visible, button:focus-visible, input:focus-visible, textarea:focus-visible { outline:2px solid var(--teal); outline-offset:3px; border-radius:8px; }
+    .breadcrumb { margin:0 0 4px; font-size:13px; color:var(--soft); }
+    .breadcrumb a { color:var(--muted); text-decoration:underline; text-underline-offset:3px; }
+    .card { border:1px solid var(--line); background:var(--panel); border-radius:22px; padding:24px; box-shadow:0 24px 80px rgba(0,0,0,.32); }
+    .notice { border-color:rgba(94,234,212,.3); background:rgba(94,234,212,.075); }
+    .danger { border-color:rgba(255,155,155,.32); background:rgba(255,155,155,.075); }
+    .eyebrow { color:var(--teal); text-transform:uppercase; letter-spacing:.16em; font-size:12px; font-weight:900; }
+    h1 { margin:8px 0 10px; font-size:clamp(34px, 6vw, 70px); line-height:.96; }
+    h2 { margin:8px 0 12px; font-size:clamp(23px, 3vw, 34px); }
+    h3 { margin:12px 0 8px; font-size:20px; }
+    p { color:var(--muted); line-height:1.65; }
+    code { color:#d9fffb; overflow-wrap:anywhere; }
+    .grid { display:grid; grid-template-columns:minmax(300px, .9fr) minmax(340px, 1.1fr); gap:18px; align-items:start; }
+    main > *, .grid > * { min-width:0; }
+    label { display:block; color:var(--muted); font-weight:900; margin:0 0 8px; }
+    input, textarea { width:100%; border:1px solid var(--line); border-radius:14px; background:rgba(0,0,0,.28); color:#d9fffb; padding:14px; font:14px/1.55 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
+    textarea { min-height:220px; resize:vertical; }
+    .actions { display:flex; flex-wrap:wrap; gap:12px; margin-top:14px; }
+    button { border:0; border-radius:999px; padding:13px 18px; font-weight:900; cursor:pointer; background:var(--text); color:#07101c; }
+    button.secondary { background:rgba(255,255,255,.1); color:var(--text); border:1px solid var(--line); }
+    button:disabled { opacity:.55; cursor:not-allowed; }
+    .pill-row { display:flex; gap:10px; flex-wrap:wrap; margin-top:14px; }
+    .pill { border:1px solid var(--line); background:rgba(255,255,255,.06); color:#dce2ff; border-radius:999px; padding:8px 11px; font-size:13px; }
+    .status { display:inline-flex; align-items:center; gap:8px; border:1px solid rgba(255,255,255,.22); background:rgba(255,255,255,.08); color:#eef2ff; border-radius:999px; padding:9px 12px; font-weight:900; overflow-wrap:anywhere; }
+    .status::before { content:""; width:9px; height:9px; border-radius:999px; background:var(--soft); box-shadow:0 0 18px rgba(143,168,161,.7); flex:0 0 auto; }
+    .status.checking::before { background:var(--amber); box-shadow:0 0 18px rgba(255,209,102,.7); }
+    .status.match::before { background:var(--teal); box-shadow:0 0 18px rgba(94,234,212,.8); }
+    .status.success::before { background:var(--teal); box-shadow:0 0 18px rgba(94,234,212,.8); }
+    .status.mismatch::before, .status.revert::before { background:var(--red); box-shadow:0 0 18px rgba(255,155,155,.75); }
+    .status.not_found::before, .status.unknown::before { background:var(--amber); box-shadow:0 0 18px rgba(255,209,102,.7); }
+    .mini-list { margin:12px 0 0; padding-left:18px; color:var(--muted); line-height:1.6; }
+    .mini-list li { margin:6px 0; overflow-wrap:anywhere; }
+    .mini-list li.pass strong { color:var(--lime); }
+    .mini-list li.warn strong { color:var(--amber); }
+    .mini-list li.fail strong { color:#ffdada; }
+    .json-preview { white-space:pre-wrap; overflow:auto; border:1px solid rgba(255,255,255,.1); border-radius:16px; padding:14px; background:rgba(0,0,0,.28); color:#d9fffb; font-size:13px; line-height:1.55; min-height:320px; }
+    .metric-grid { display:grid; gap:10px; grid-template-columns:repeat(3, minmax(0, 1fr)); margin:14px 0; }
+    .metric { border:1px solid rgba(255,255,255,.1); border-radius:16px; background:var(--panel-2); padding:13px; }
+    .metric span { display:block; color:var(--soft); font-size:12px; text-transform:uppercase; letter-spacing:.12em; font-weight:900; }
+    .metric strong { display:block; margin-top:7px; color:var(--text); overflow-wrap:anywhere; }
+    @media (max-width: 860px) { body { padding:18px 0; } .grid, .metric-grid { grid-template-columns:1fr; } }
+    @media (prefers-reduced-motion: reduce) { * { animation-duration: 0s !important; transition: none !important; } }
+  </style>
+  <script src="./matcher.js" integrity="sha384-b+l47wwp114M/vXgjWojdiy76c4WFIwxpJFIr5OU3npT/9gvdn7AX1yFcjsc1g0c" crossorigin="anonymous" defer></script>
+</head>
+<body>
+  <main>
+    <p class="breadcrumb"><a href="../../index.html">&larr; Back to Arc MCP Builder Assistant</a></p>
+    <section class="card" aria-labelledby="matcher-title">
+      <div class="eyebrow">Read-only Arc Testnet RPC</div>
+      <h1 id="matcher-title">Payment Intent Receipt Matcher</h1>
+      <p>Paste a payment intent JSON and an Arc Testnet transaction hash. The matcher fetches the receipt, decodes pinned USDC Transfer logs, and reports whether the onchain transfer matches the expected recipient, token, and amount. It never connects to a wallet, handles private keys, signs, or broadcasts.</p>
+      <div class="pill-row" aria-label="Safety properties">
+        <span class="pill">No wallet connection</span>
+        <span class="pill">No private keys</span>
+        <span class="pill">No signing</span>
+        <span class="pill">No transaction broadcast</span>
+        <span class="pill">Read-only RPC only</span>
+      </div>
+    </section>
+    <section class="grid" aria-label="Matcher workspace">
+      <article class="card" aria-labelledby="input-title">
+        <div class="eyebrow">Payment intent + transaction</div>
+        <h2 id="input-title">Compare intent with receipt</h2>
+        <p>The sample values are placeholders. Use a real Arc Testnet hash and intent only if you already have them from a wallet or ArcScan.</p>
+        <label for="payment-intent">Payment intent JSON</label>
+        <textarea id="payment-intent" autocomplete="off" spellcheck="false">{
+  "version": "2025-06-arc-payment-intent-v1",
+  "network": "Arc Testnet",
+  "chainId": 5042002,
+  "asset": "USDC",
+  "token": "0x3600000000000000000000000000000000000000",
+  "recipient": "0x1111111111111111111111111111111111111111",
+  "amount": "0.01",
+  "amountBaseUnits": "10000",
+  "decimals": 6,
+  "memo": "Demo payment-intent receipt matcher"
+}</textarea>
+        <label for="transaction-hash">Arc Testnet transaction hash</label>
+        <input id="transaction-hash" autocomplete="off" spellcheck="false" value="0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" />
+        <div class="actions" aria-label="Matcher controls">
+          <button type="button" id="match-receipt">Match against receipt</button>
+          <button type="button" id="reset-matcher" class="secondary">Reset sample</button>
+        </div>
+      </article>
+      <article class="card notice" aria-labelledby="result-title">
+        <div class="eyebrow">Match evidence</div>
+        <h2 id="result-title">Read-only verdict</h2>
+        <p>Status: <span id="status-pill" class="status">not_checked</span></p>
+        <ul id="match-summary-list" class="mini-list" aria-live="polite"></ul>
+        <h3>USDC Transfer logs</h3>
+        <ul id="transfer-log-list" class="mini-list" aria-live="polite"></ul>
+        <div class="actions" aria-label="Evidence export controls">
+          <button type="button" id="download-json-evidence" class="secondary" disabled>Download JSON evidence</button>
+          <button type="button" id="download-markdown-evidence" class="secondary" disabled>Download Markdown evidence</button>
+        </div>
+      </article>
+    </section>
+    <section class="card notice" aria-labelledby="states-title">
+      <div class="eyebrow">Match states</div>
+      <h2 id="states-title">What the matcher reports</h2>
+      <div class="metric-grid" aria-label="Arc match states">
+        <div class="metric"><span>match</span><strong>Receipt succeeded and a USDC Transfer log matches the intent recipient, token, and amount.</strong></div>
+        <div class="metric"><span>mismatch</span><strong>Receipt succeeded but no USDC Transfer log matched the intent.</strong></div>
+        <div class="metric"><span>revert</span><strong>Receipt exists and status is 0x0.</strong></div>
+        <div class="metric"><span>not_found</span><strong>No receipt yet for this hash.</strong></div>
+        <div class="metric"><span>unknown</span><strong>RPC unavailable, wrong chain, malformed envelope, or ambiguous status.</strong></div>
+        <div class="metric"><span>Chain</span><strong>5042002 / 0x4cef52</strong></div>
+      </div>
+    </section>
+    <section class="card" aria-labelledby="json-title">
+      <div class="eyebrow">Machine-readable output</div>
+      <h2 id="json-title">Match evidence JSON</h2>
+      <pre id="match-json" class="json-preview" aria-live="polite"></pre>
+    </section>
+    <section class="card danger" aria-labelledby="boundary-title">
+      <div class="eyebrow">Trust boundary</div>
+      <h2 id="boundary-title">What this does not prove</h2>
+      <ul class="mini-list">
+        <li>A <code>match</code> only means the receipt contains a USDC Transfer with the expected recipient and amount. It does not prove business acceptance, offchain fulfillment, or product settlement.</li>
+        <li>The matcher relies on the public Arc Testnet RPC and the pinned USDC address. A different token contract will not match even if the call data looks similar.</li>
+        <li>The matcher does not estimate gas, simulate calls, submit transactions, or retry failed payments.</li>
+        <li>Use the <a href="../receipt-viewer/">receipt viewer</a> and <a href="../transaction-status-playground/">transaction status playground</a> for earlier/later stages of the payment lifecycle.</li>
+      </ul>
+    </section>
+  </main>
+</body>
+</html>