ows-sentinel-sdk
v0.1.6
Published
FICO scores for AI agent wallets — reputation-gated policies for OWS
Maintainers
saura3hReadme
ows-sentinel-sdk
FICO scores for AI agent wallets, enforced by the OWS policy engine.
Sentinel is a reputation system for OWS agent wallets. Agents earn spending capacity through proven on-chain history. New wallets start with tight limits ($5/day). Clean transaction history unlocks higher tiers ($50 → $500 → $5,000/day). Transactions that exceed the limit get sent to Telegram for human approval.
Setup
npm install ows-sentinel-sdk
npx ows-sentinel-sdk initThe CLI automatically creates a wallet, installs the policy, registers it with OWS, and gives you an API key. Zero manual config.
Usage
import { signWithApproval } from "ows-sentinel-sdk"
import { signTransaction } from "@open-wallet-standard/core"
const tx = await signWithApproval(
() => signTransaction("my-wallet", "eip155:84532", txHex, "ows_key_..."),
{ inboxUrl: "https://sentinel-server.saurabh10102.workers.dev" }
)The SDK handles the full flow:
- Calls
signTransaction()→ policy evaluates the tx - If denied (over spend limit or high-value) → queues for Telegram approval
- Polls until human approves or rejects
- Retries
signTransaction()→ policy sees approval → signs
Reputation Tiers
| Score | Tier | Daily Limit | |-------|------|-------------| | 0–14 | New | $5/day | | 15–39 | Established | $50/day | | 40–74 | Trusted | $500/day | | 75+ | Verified | $5,000/day |
Token Support
- ETH — live price from CoinGecko
- USDC / USDT / DAI — recognized as stablecoins
- ERC-20 transfers — calldata decoded automatically
- Dangerous calls blocked —
approve(),increaseAllowance(),setApprovalForAll()always need Telegram approval