SkillsSOL Skills

AsterPay KYA — Agent Trust Score & EUR Settlement

paymentstrustx402compliancesettlementagentsEURSEPA
npx skills add https://github.com/Hubra-labs/sol-skills --skill asterpay-kya

Purpose

Know Your Agent (KYA) trust scoring, sanctions screening, and USDC-to-EUR settlement via SEPA Instant. Score any wallet 0-100, check ERC-8004 identity, screen sanctions (Chainalysis), and settle stablecoins to EUR bank accounts. x402-native, MiCA-compliant.

Trusted sources

Execution flow

1. Check Agent Trust

const res = await fetch('https://x402.asterpay.io/v1/agent/trust-score/' + address);
const { data } = await res.json();
// data.score (0-100), data.tier, data.blocked, data.sanctions.clean

2. Verify Identity

const res = await fetch('https://x402.asterpay.io/v1/agent/verify/' + address);
const { data } = await res.json();
// data.verified, data.agentId (#16850), data.registry

3. Estimate EUR Settlement

const res = await fetch('https://x402.asterpay.io/v1/settlement/estimate?amount=100');
const { data } = await res.json();
// data.netEurAmount, data.eurRate, data.asterpayFeeEur

Failure handling

Common errors

  • 402: Payment required (for paid endpoints like deep-analysis)
  • blocked: true → Sanctioned wallet, do NOT transact
  • simulated: true → Expected for estimates, actual settlement via facilitator

Full guide

AsterPay KYA — Agent Trust Score & EUR Settlement

AsterPay is the trust and settlement layer for AI agent commerce. Two core capabilities:

  1. KYA Trust Score — Score any wallet 0-100 based on 7 on-chain signals + Chainalysis sanctions screening + InsumerAPI attestations. Free API, no key needed.
  2. EUR Settlement — Convert USDC/EURC/EURCV to EUR via SEPA Instant (<10 seconds). x402-native, MiCA-compliant.

Listed on x402 Foundation ecosystem. Circle Alliance member. ERC-8004 Agent #16850.

Base URL

https://x402.asterpay.io

KYA Trust Score (FREE — No Auth Required)

GET /v1/agent/trust-score/:address

Full trust assessment for any Ethereum-compatible address.

curl https://x402.asterpay.io/v1/agent/trust-score/0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Response:

{
  "score": 65,
  "tier": "trusted",
  "maxPerTx": 10000,
  "blocked": false,
  "components": {
    "walletAge": 12,
    "walletActivity": 10,
    "sanctionsClean": 20,
    "erc8004Identity": 15,
    "operatorKyb": 0,
    "transactionHistory": 5,
    "trustBond": 3
  },
  "sanctions": { "clean": true, "provider": "chainalysis" }
}

GET /v1/agent/verify/:address

ERC-8004 identity check.

GET /v1/agent/tier/:address

Fast tier + limits lookup.

POST /v1/agent/trust-score/batch

Batch scoring up to 50 addresses.

Trust Tiers

| Tier | Score | Max/Tx | Daily Limit | |------|-------|--------|-------------| | Open | 0-19 | $1 | $10 | | Verified | 20-49 | $1,000 | $5,000 | | Trusted | 50-79 | $10,000 | $50,000 | | Enterprise | 80-100 | Unlimited | Unlimited |

EAS On-Chain Attestation (Base Mainnet)

KYA Trust Scores are attested on-chain via Ethereum Attestation Service (EAS) on Base:

  • Schema: 12 fields, gas-optimized (<$0.01 per attestation)
  • Schema UID: 0x34d8d84158b4d965687d5a4585b2e437f381371fa935c225e8a128ca57c675ca
  • Any smart contract can read an agent's trust profile directly from the chain.

EUR Settlement (x402 Facilitator)

GET /v1/settlement/estimate

curl "https://x402.asterpay.io/v1/settlement/estimate?amount=100.0&currency=USDC"

Returns EUR amount, fees, exchange rate.

POST /v2/x402/verify + POST /v2/x402/settle

x402 v2 facilitator — verify payment signature, settle on-chain, trigger EUR SEPA payout.

Usage Pattern: Trust-Gated Transaction

const BASE = 'https://x402.asterpay.io';

// 1. Check trust before transacting
const { data } = await fetch(`${BASE}/v1/agent/trust-score/${address}`).then(r => r.json());

if (data.blocked) throw new Error('Sanctioned wallet');
if (data.score < 20) throw new Error('Trust too low');

// 2. Estimate EUR settlement
const est = await fetch(`${BASE}/v1/settlement/estimate?amount=100`).then(r => r.json());
console.log(`100 USDC → ${est.data.netEurAmount} EUR`);

Supported Chains

Base (primary), Ethereum, Polygon, Arbitrum, Optimism, Solana, XRPL.

Rules

  • NEVER trust a wallet with blocked: true — sanctions compliance block.
  • ALWAYS check sanctions.clean before transacting with unknown agents.
  • Cache trust scores for 5 minutes.
  • Default to Base network for lowest fees.
  • For >$1,000 transactions, use deep analysis endpoint ($0.01 via x402).