Node.js Gate

npm install @agent-score/gate

import express from "express";
import { agentscoreGate } from "@agent-score/gate";

const app = express();

// Gate all routes behind a B-grade minimum
app.use(
  agentscoreGate({
    apiKey: process.env.AGENTSCORE_API_KEY,
    minGrade: "B",
    minScore: 50,
  })
);

app.post("/api/execute", (req, res) => {
  // Only wallets with grade B+ and score 50+ reach here
  res.json({ status: "executed" });
});

import { agentscoreGate } from "@agent-score/gate";
import type { AgentScoreGateOptions } from "@agent-score/gate";

agentscoreGate({
  // Required
  apiKey: string,

  // Policy (optional)
  minGrade: "A" | "B" | "C" | "D" | "F",
  minScore: number,                          // minimum score (0-100)
  requireVerifiedActivity: boolean,          // default: false

  // Wallet extraction (optional)
  extractAddress: (req) => string | undefined,  // default: reads X-Wallet-Address header
  extractChain: (req) => string | undefined,    // default: "base"

  // Behavior (optional)
  failOpen: boolean,         // default: false — deny on API errors
  cacheSeconds: number,      // default: 300 — TTL for cached results
  baseUrl: string,           // default: "https://api.agentscore.sh"
  onDenied: (req, res, reason) => void,  // custom deny handler
})

app.post("/api/execute", (req, res) => {
  const reputation = req.agentscore;
  console.log(`Score: ${reputation.score.value}, Grade: ${reputation.score.grade}`);

  // Use score for tiered behavior
  if (reputation.score.value >= 90) {
    // Premium path for high-trust wallets
  }

  res.json({ status: "executed" });
});

import type { DenialReason } from "@agent-score/gate";

app.use(
  agentscoreGate({
    apiKey: process.env.AGENTSCORE_API_KEY,
    minGrade: "B",
    onDenied: (req, res, reason: DenialReason) => {
      res.status(403).json({
        error: reason.code,
        decision: reason.decision,
        reasons: reason.reasons,
      });
    },
  })
);

agentscoreGate({
  apiKey: process.env.AGENTSCORE_API_KEY,
  minGrade: "C",
  failOpen: true,  // allow requests if AgentScore API is down
})

// Loose policy for reads
app.get(
  "/api/data",
  agentscoreGate({ apiKey, minGrade: "D" }),
  dataHandler
);

// Strict policy for writes
app.post(
  "/api/execute",
  agentscoreGate({ apiKey, minGrade: "B", minScore: 50 }),
  executeHandler
);

agentscoreGate({
  apiKey: process.env.AGENTSCORE_API_KEY,
  minGrade: "C",
  extractAddress: (req) => req.query.wallet as string,
  extractChain: (req) => (req.query.chain as string) || "base",
})