oceanalt-aml

你的 agent 付款前,调一次 OceanAlt。 传将要付的收款地址 → 拿机器可执行决策 allow / review / decline + 可核验证据 + retry 语义。给收据,不给黑箱分。

• 免费决策零依赖 —— 只用内建 fetch,随处可调,零支付、零 key。
• 付费带结算走 x402 —— 同一个决策 + 在合规轨道上把钱结掉;facilitator 代验签+代结算,SDK 不托管你的私钥。

安装

npm i oceanalt-aml
# 仅付费(带结算)端点需要:npm i @x402/core @x402/evm viem

★ 免费:付款前调一次(5 分钟集成)

import { OceanAltAML } from "oceanalt-aml";
const aml = new OceanAltAML();

// 你的 agent 正要付一笔——先问一句能不能付
const { allow, decision, evidence, retry } = await aml.decide({ to: "0x…", amountUsdc: 25 });
if (!allow) return;          // decline / review → 别付,evidence 里是为什么
// allow → 继续你的支付流程

• decision: "allow" | "review" | "decline";allow 是布尔,方便一行拦截。
• evidence: 命中哪个名单 / 链上路径,每条可点开自核(不是黑箱分)。
• retry: 给 agent planner 的重试语义(该不该重试、条件)。
• 升级带结算:aml.decision(input, { privateKey }) —— 同决策,外加把这笔在 x402 上结掉。

免费:单地址筛查(原始数据形态)

import { OceanAltAML } from "oceanalt-aml";
const aml = new OceanAltAML();

const r = await aml.screen("TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t");
// { verdict:"risky", risk:95, blocked:true, signals:[...], evidence:[...], standard:"…/rap" }

const recent = await aml.recent();   // 近期被标记的敏感地址

支持 EVM(0x…)、TRON(T…)、Solana。EVM 可选链:{ network: "ethereum" | "base" | "bsc" | "polygon" | "arbitrum" | "optimism" | "avalanche" }(默认 ethereum)。

付费:网关合规判决 / 深度追踪 / 批量(x402)

const auth = { privateKey: process.env.PAYER_KEY };   // 付款钱包(需 USDC;facilitator 代付 gas)

// 该不该放这笔?($0.30)
const d = await aml.decision({ to: "0x…", amountUsdc: 25, purpose: "invoice" }, auth);
// { data:{ decision:"allow|review|decline", … }, paid:true, settlement:{ transaction:"0x…" } }

await aml.trace("T…", auth);           // 深度沾染追踪 $0.20
await aml.batch(["0x…","T…"], auth);    // 批量筛查(≤25)$0.10

SDK 自动跑完整 402 → 签 EIP-3009 → 重发 → 200,并在 settlement.transaction 给出链上结算交易哈希。

定位

对标慢雾(MistTrack)按次 $0.10–$1.00 更便宜,基础查询免费透明;我们卖【判决 + 证据 + RAP 标准】,不是原始数据。标准见 https://oceanalt.com/en/rap。