Gas and Webhooks

import { summarizeGasReadiness } from "@arc/shlp-sdk";

const gas = await shlp.getGasStatus(userAddress);
const readiness = summarizeGasReadiness(gas);

if (!readiness.canAskForSignature) {
  showGasRequired(readiness.message);
}

GET /api/v1/gas/status?address=0x...

const result = await shlp.requestGasTopUp(userAddress);

POST /api/v1/gas/top-up
Content-Type: application/json

{ "address": "0x..." }

const webhook = await shlp.upsertPartnerWebhook({
  url: "https://partner.example.com/webhooks/signalite",
  events: ["partner_action.created", "partner_action.submitted"],
  enabled: true,
  rotateSecret: true,
});

storeSecret(webhook.signingSecret);

X-Signalite-Event: partner_action.created
X-Signalite-Delivery: <delivery_id>
X-Signalite-Timestamp: <unix_seconds>
X-Signalite-Signature: v1=<hmac_sha256>

import { verifySignaliteWebhook } from "@arc/shlp-sdk/webhooks";

const result = verifySignaliteWebhook({
  signingSecret: process.env.SIGNALITE_WEBHOOK_SECRET!,
  timestamp: request.headers.get("x-signalite-timestamp")!,
  signature: request.headers.get("x-signalite-signature")!,
  rawBody,
});

if (!result.ok) {
  throw new Error(`invalid Signalite webhook: ${result.reason}`);
}

POST /api/cron/webhooks
Authorization: Bearer <cron_secret>