cred402/cli/commands/webhooks.ts
caelum0x 2d43618725 feat: real integrations (Casper Testnet, x402/EIP-712, MCP, RealFi, cross-chain), wallet sign-in, branding
Replace the design-note docs (p1–p7) with the implemented "make it real" phase
docs (p8–p10) and wire production-grade, env-gated real integrations:

- p8 Casper Testnet: byte-exact deploys + WASM install via casper-js-sdk; live
  node reads (node.testnet.casper.network); CRED402_CHAIN=sim|testnet transport.
- p9 x402 + data + MCP: real EIP-712 typed-data digests (@casper-ecosystem/
  casper-eip-712); casper-x402 facilitator client (x402 V2); live Open-Meteo GHI;
  official @modelcontextprotocol/sdk server; casper-sidecar SSE event feed.
- p10 RealFi + cross-chain: real Stripe test-mode webhooks (HMAC-verified) and
  Plaid sandbox → privacy-preserving on-chain envelopes; Base Sepolia EVM deploy
  (Foundry); reachable via /api/realfi/* and /api/x402/facilitator routes.
- Sign-in with Casper Wallet: real extension provider + challenge/ed25519/session
  flow (/v1/auth/wallet/*), console connect + sign-in button.
- Branding: Cred402 logo mark, favicon, OG image; Vercel config for the console.

All env-gated with sim/free-API fallbacks; full suite green, all toolchains
(TS/Rust/Go/Solidity) build.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 00:37:36 +03:00

58 lines
1.8 KiB
TypeScript

/**
* `webhooks` command group: subscribe a URL to protocol events (admin).
*/
import { type CommandContext, emit, requireArg, UsageError } from "../lib/context.js";
import { idempotencyKey } from "../lib/http.js";
import { color, formatTimestamp, heading, keyValues, sym } from "../lib/render.js";
interface Webhook {
id: string;
url: string;
events: string[];
secret: string;
created_at: number;
}
const USAGE = `webhooks — subscribe to protocol events (admin)
Usage:
cred402 webhooks add <url> [event...] defaults to all events (*)
Note: requires an admin key when the server enforces auth: --key <adminKey>`;
export async function webhooksCommand(ctx: CommandContext): Promise<void> {
const sub = ctx.args[0];
switch (sub) {
case "add":
return add(ctx);
case undefined:
case "--help":
case "-h":
process.stdout.write(USAGE + "\n");
return;
default:
throw new UsageError(`unknown subcommand: webhooks ${sub}\n\n${USAGE}`);
}
}
async function add(ctx: CommandContext): Promise<void> {
const url = requireArg(ctx.args, 1, "url");
if (!/^https?:\/\//.test(url)) throw new UsageError(`url must start with http:// or https://, got "${url}"`);
const events = ctx.args.slice(2);
const body: Record<string, unknown> = { url };
if (events.length > 0) body["events"] = events;
const wh = await ctx.client.post<Webhook>("/v1/webhooks", body, idempotencyKey("webhook"));
emit(ctx, wh, () =>
heading(`Subscribed Webhook — ${wh.id}`) +
"\n" +
keyValues([
["url", wh.url],
["events", wh.events.join(", ")],
["secret", color.bold(color.yellow(wh.secret))],
["created_at", formatTimestamp(wh.created_at)],
]) +
`\n\n${sym.info()} ${color.dim("HMAC-sign deliveries with the secret above.")}`,
);
}