@svsprotocol/solana 0.1.0

package/dist/bot-integration-contract.js

@@ -0,0 +1,41 @@
+import { hashObject } from "./receipt.js";
+
+export const BOT_INTEGRATION_CONTRACT_VERSION = "svs.bot-integration-contract.v1";
+export const BOT_INTEGRATION_QUICKSTART_VERSION = "svs.bot-integration-quickstart.v1";
+
+export function hashBotIntegrationContract(contract) {
+  if (!contract || typeof contract !== "object") {
+    return null;
+  }
+
+  return hashObject(normalizeBotIntegrationContractForHash(contract));
+}
+
+export function normalizeBotIntegrationContractForHash(value) {
+  if (Array.isArray(value)) {
+    return value.map(normalizeBotIntegrationContractForHash);
+  }
+
+  if (value && typeof value === "object") {
+    return Object.keys(value)
+      .filter((key) => key !== "generatedAt")
+      .sort()
+      .reduce((result, key) => {
+        result[key] = normalizeBotIntegrationContractForHash(value[key]);
+        return result;
+      }, {});
+  }
+
+  if (typeof value === "string") {
+    return value.replace(/https?:\/\/[^\s"'<>]+/g, (match) => {
+      try {
+        const parsed = new URL(match);
+        return `<baseUrl>${parsed.pathname}${parsed.search}${parsed.hash}`;
+      } catch {
+        return "<baseUrl>";
+      }
+    });
+  }
+
+  return value;
+}

package/dist/certified-submit-status.js

@@ -0,0 +1,176 @@
+export const CERTIFIED_SUBMIT_OPERATOR_STATUS_VERSION = "svs.certified-submit-operator-status.v1";
+export const CERTIFIED_SUBMIT_OPERATOR_READY_STATUSES = Object.freeze([
+  "ready",
+  "production_ready"
+]);
+
+export function isCertifiedSubmitOperatorStatusReady(certifiedSubmitStatus) {
+  return certifiedSubmitStatus?.checkOk === true &&
+    certifiedSubmitStatus?.ok === true &&
+    CERTIFIED_SUBMIT_OPERATOR_READY_STATUSES.includes(certifiedSubmitStatus?.status);
+}
+
+export function createCertifiedSubmitOperatorStatus({
+  response,
+  serverUrl = null,
+  staleAfterMs = null,
+  evidenceEndpoint = "/api/bots/certified-submit-evidence",
+  statusEndpoint = "/api/bots/certified-submit-status"
+} = {}) {
+  const evidence = response?.evidence ?? null;
+  const candidate = normalizeCertifiedSubmitOperatorCandidate({
+    candidate: response?.candidate ?? null,
+    productionActionId: evidence?.actionId ?? null,
+    productionReady: response?.ok === true && response?.productionReady === true
+  });
+  const lifecycle = candidate?.actionLifecycle ?? response?.actionLifecycle ?? evidence?.actionLifecycle ?? null;
+  const nextAction = selectCertifiedSubmitNextAction({ response, evidence, candidate, lifecycle });
+
+  return {
+    version: CERTIFIED_SUBMIT_OPERATOR_STATUS_VERSION,
+    ok: response?.ok === true,
+    status: response?.status ?? "unknown",
+    serverUrl,
+    staleAfterMs,
+    endpoints: {
+      status: statusEndpoint,
+      evidence: evidenceEndpoint
+    },
+    production: evidence
+      ? summarizeCertifiedSubmitEvidence({
+          ...evidence,
+          ok: response?.ok,
+          productionReady: response?.productionReady,
+          proofValidityStatus: response?.proofValidityStatus,
+          actionLifecycle: response?.actionLifecycle ?? evidence.actionLifecycle
+        })
+      : null,
+    candidate: candidate?.found
+      ? summarizeCertifiedSubmitEvidence(candidate)
+      : null,
+    nextAction
+  };
+}
+
+export function normalizeCertifiedSubmitOperatorCandidate({
+  candidate,
+  productionActionId = null,
+  productionReady = false
+} = {}) {
+  if (!candidate?.found || !productionReady || !productionActionId || candidate.actionId !== productionActionId) {
+    return candidate;
+  }
+
+  return {
+    ...candidate,
+    ok: true,
+    status: "current_production_proof",
+    promotionReady: false,
+    productionReady: true,
+    alreadyPromoted: true,
+    nextAction: {
+      code: "none",
+      message: "Candidate is already the current production certified-submit proof."
+    }
+  };
+}
+
+export function summarizeCertifiedSubmitEvidence(evidence) {
+  return {
+    ok: evidence?.ok === true || evidence?.productionReady === true,
+    status: evidence?.status ?? null,
+    botId: evidence?.botId ?? null,
+    actionId: evidence?.actionId ?? null,
+    evidenceHash: evidence?.evidenceHash ?? null,
+    proofValidityStatus: evidence?.proofValidityStatus ?? null,
+    productionReady: evidence?.productionReady ?? evidence?.productionProofReady ?? null,
+    promotionReady: evidence?.promotionReady ?? null,
+    alreadyPromoted: evidence?.alreadyPromoted === true,
+    proofWait: {
+      enabled: evidence?.productionProofWait?.enabled === true,
+      ok: evidence?.productionProofWait?.ok === true,
+      status: evidence?.productionProofWait?.status ?? null,
+      ready: evidence?.productionProofWait?.ready ?? null,
+      proofFetched: evidence?.productionProofWait?.proofFetched ?? null,
+      verificationSetHash: evidence?.productionProofWait?.verificationSetHash ?? null,
+      helper: evidence?.productionProofWait?.helper ?? null
+    },
+    actionLifecycle: evidence?.actionLifecycle
+      ? {
+          ok: evidence.actionLifecycle.ok === true,
+          status: evidence.actionLifecycle.status ?? null,
+          nextAction: evidence.actionLifecycle.nextAction ?? null,
+          humanApproval: evidence.actionLifecycle.humanApproval?.approved ?? null,
+          broadcast: evidence.actionLifecycle.broadcast?.confirmed ?? null,
+          registry: evidence.actionLifecycle.registry?.confirmed ?? null,
+          independentVerification: evidence.actionLifecycle.independentVerification?.verified ?? null
+        }
+      : null
+  };
+}
+
+export function selectCertifiedSubmitNextAction({ response, evidence, candidate, lifecycle } = {}) {
+  const productionActionId = evidence?.actionId ?? null;
+  const promotedCandidateCurrent = response?.ok === true &&
+    response?.productionReady === true &&
+    candidate?.found === true &&
+    candidate?.actionId &&
+    candidate.actionId === productionActionId;
+
+  if (promotedCandidateCurrent) {
+    return {
+      code: "none",
+      message: "Certified-submit production evidence is ready for the latest candidate action."
+    };
+  }
+
+  if (candidate?.promotionReady === true) {
+    return {
+      code: "promote_certified_submit_evidence",
+      message: "Candidate action is production verified. Run npm run bot:certified-submit:promote."
+    };
+  }
+
+  if (candidate?.found && (
+    candidate.proofValidityStatus === "failed" ||
+    candidate.status === "failed"
+  )) {
+    return {
+      code: "run_certified_submit",
+      message: "Certified-submit candidate evidence is not valid for the current integration contract. Run npm run bot:certified-submit -- --wait-production-proof true --production-proof-check-receipt-registry-chain true."
+    };
+  }
+
+  if (candidate?.found && lifecycle?.nextAction) {
+    return {
+      code: "complete_candidate_action",
+      message: lifecycle.nextAction
+    };
+  }
+
+  if (response?.proofValidityStatus === "failed" || response?.status === "failed") {
+    return {
+      code: "run_certified_submit",
+      message: "Certified-submit production evidence is not ready. Run npm run bot:certified-submit -- --wait-production-proof true --production-proof-check-receipt-registry-chain true."
+    };
+  }
+
+  if (response?.ok === true && response?.productionReady === true) {
+    return {
+      code: "none",
+      message: "Certified-submit production evidence is ready."
+    };
+  }
+
+  if (response?.summary) {
+    return {
+      code: "review_certified_submit_status",
+      message: response.summary
+    };
+  }
+
+  return {
+    code: "run_certified_submit",
+    message: "Run npm run bot:certified-submit -- --wait-production-proof true --production-proof-check-receipt-registry-chain true."
+  };
+}