sardis-payment

# Sardis Payment - Core Payment Execution Skill

> AI agents can reason, but they cannot be trusted with money. Sardis is how they earn that trust.

Sardis provides complete payment infrastructure for AI agents with non-custodial MPC wallets, natural language spending policies, and compliance-first design.

## Capabilities

- **Payment Execution**: Send USDC/USDT/EURC across 5+ chains (Base, Polygon, Ethereum, Arbitrum, Optimism)
- **Balance Checking**: Real-time wallet balance and spending analytics
- **Policy Enforcement**: Natural language spending rules automatically enforced
- **Card Management**: Issue and manage virtual cards for real-world purchases
- **Audit Trail**: Complete transaction history with compliance logging

## Security Requirements

**CRITICAL - ALWAYS ENFORCE:**
- ALWAYS check spending policy before payment execution
- NEVER bypass approval flows for transactions
- NEVER hardcode wallet addresses or private keys
- ALWAYS log transaction attempts for audit trail
- ALWAYS verify recipient address format
- FAIL CLOSED on policy violations (deny by default)

## Quick Setup

```bash
export SARDIS_API_KEY=sk_your_key_here
export SARDIS_WALLET_ID=wallet_abc123
```

## API Endpoint Patterns

All API calls use the base URL: `https://api.sardis.sh/v2`

### Payment Execution

```bash
# Execute a payment (policy automatically enforced)
curl -X POST https://api.sardis.sh/v2/payments \
  -H "Authorization: Bearer $SARDIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "'$SARDIS_WALLET_ID'",
    "to": "0xRecipientAddress",
    "amount": "25.00",
    "token": "USDC",
    "chain": "base",
    "purpose": "OpenAI API credits"
  }'
```

### Check Balance

```bash
# Get wallet balance
curl -X GET https://api.sardis.sh/v2/wallets/$SARDIS_WALLET_ID/balance \
  -H "Authorization: Bearer $SARDIS_API_KEY"
```

### Policy Check (Dry Run)

```bash
# Check if payment would be allowed WITHOUT executing
curl -X POST https://api.sardis.sh/v2/polic...

# sardis-openclaw

OpenClaw skills for Sardis - Payment OS for AI Agents.

> AI agents can reason, but they cannot be trusted with money. Sardis is how they earn that trust.

## What is this?

This package provides OpenClaw skill definitions for Sardis, enabling AI agents to execute payments, manage spending policies, check balances, and control virtual cards with natural language commands.

## Available Skills

### 💳 [sardis-payment](./SKILL.md) - Core Payment Execution

Execute secure, policy-controlled payments across multiple blockchains.

**Capabilities:**
- Send USDC/USDT/EURC on Base, Polygon, Ethereum, Arbitrum, Optimism
- Policy enforcement before every transaction
- Real-time balance checking
- Transaction history and audit trail

**Requirements:** `SARDIS_API_KEY`, `SARDIS_WALLET_ID`

**Use when:** Agent needs to execute payments or manage wallets

---

### 💰 [sardis-balance](./skills/sardis-balance/SKILL.md) - Read-Only Balance & Analytics

Safe, read-only skill for monitoring wallet balances and spending patterns.

**Capabilities:**
- Check wallet balances across chains
- Spending summaries (daily, weekly, monthly)
- Transaction history with filters
- Budget remaining against policy limits
- Multi-wallet monitoring

**Requirements:** `SARDIS_API_KEY` (no wallet ID needed)

**Use when:** Agent needs to check balances without payment risk

---

### 🛡️ [sardis-policy](./skills/sardis-policy/SKILL.md) - Spending Policy Management

Create and manage spending policies using natural language or structured rules.

**Capabilities:**
- Natural language policy creation ("Max $500/day, only Amazon")
- Pre-built policy templates (procurement, API service, trial, employee)
- Policy testing (dry-run transactions)
- Multi-layer limits (per-transaction, daily, weekly, monthly)
- Vendor and category restrictions

**Requirements:** `SARDIS_API_KEY`

**Use when:** Agent needs to create spending rules or test transactions

---

### 💳 [sardis-cards](./skills/sardis-cards/...