Installation

# Full installation (all features)
pip install sardis[all]

# Individual features
pip install sardis[chain]       # Blockchain execution
pip install sardis[compliance]  # KYC/AML integrations
pip install sardis[cards]       # Virtual card issuance
pip install sardis[ledger]      # Audit ledger
pip install sardis[protocols]   # AP2/TAP/UCP protocols

# Development tools
pip install sardis[dev]         # Testing and linting

import sardis

print(f"Sardis version: {sardis.__version__}")

# Test in simulation mode (no API key needed)
from sardis import Wallet, Transaction

wallet = Wallet(initial_balance=100, currency="USDC")
tx = Transaction(
    from_wallet=wallet,
    to="test:merchant",
    amount=10,
    purpose="Test payment"
)
result = tx.execute()
print(f"Transaction status: {result.status.value}")

export SARDIS_API_KEY=sk_live_your_api_key_here

from sardis import SardisClient

client = SardisClient(api_key="sk_live_...")

// ES Modules (recommended)
import { SardisClient } from '@sardis/sdk';

// CommonJS
const { SardisClient } = require('@sardis/sdk');

// Browser (via CDN)
import { SardisClient } from 'https://esm.sh/@sardis/sdk';

import { SardisClient } from '@sardis/sdk';

console.log('Sardis SDK loaded successfully');

// Test connection (optional)
const client = new SardisClient({ 
  apiKey: process.env.SARDIS_API_KEY 
});

// Health check
const health = await client.health();
console.log('API Status:', health.status);

export SARDIS_API_KEY=sk_live_your_api_key_here

import { SardisClient } from '@sardis/sdk';

const client = new SardisClient({
  apiKey: 'sk_live_...',
  baseURL: 'https://api.sardis.sh',  // Optional: custom API endpoint
  timeout: 30000,                     // Optional: request timeout (ms)
});

{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "ESNext",
    "target": "ES2022",
    "lib": ["ES2022"],
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

{
  "mcpServers": {
    "sardis": {
      "command": "npx",
      "args": ["-y", "@sardis/mcp-server"],
      "env": {
        "SARDIS_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "sardis": {
      "command": "npx",
      "args": ["-y", "@sardis/mcp-server"],
      "env": {
        "SARDIS_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

{
  "mcp.servers": {
    "sardis": {
      "command": "npx",
      "args": ["-y", "@sardis/mcp-server"],
      "env": {
        "SARDIS_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

claude mcp add sardis -- npx -y @sardis/mcp-server

export SARDIS_API_KEY=sk_live_your_api_key_here

npx @sardis/mcp-server --demo

pip install langchain langchain-openai sardis

from langchain_core.tools import tool
from sardis import SardisClient

sardis = SardisClient(api_key="sk_live_...")

@tool
def sardis_pay(to: str, amount: str, token: str) -> str:
    """Execute a payment through Sardis."""
    result = sardis.wallets.transfer(
        wallet_id="...",
        destination=to,
        amount=amount,
        token=token,
        chain="base",
    )
    return f"Payment: {result.tx_hash}"

npm install ai @ai-sdk/openai @sardis/sdk zod

import { generateText, tool } from "ai";
import { openai } from "@ai-sdk/openai";
import { z } from "zod";
import { SardisClient } from "@sardis/sdk";

const sardis = new SardisClient({ apiKey: process.env.SARDIS_API_KEY });

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools: {
    sardisPay: tool({
      description: "Execute a payment",
      parameters: z.object({
        to: z.string(),
        amount: z.string(),
        token: z.enum(["USDC", "USDT"]),
      }),
      execute: async ({ to, amount, token }) => {
        const result = await sardis.wallets.transfer(walletId, {
          destination: to,
          amount,
          token,
          chain: "base",
        });
        return result;
      },
    }),
  },
});

pip install openai sardis

from openai import OpenAI
from sardis import SardisClient

sardis = SardisClient(api_key="sk_live_...")
client = OpenAI()

tools = [{
    "type": "function",
    "function": {
        "name": "sardis_pay",
        "description": "Execute a payment through Sardis",
        "parameters": {
            "type": "object",
            "properties": {
                "to": {"type": "string"},
                "amount": {"type": "string"},
                "token": {"type": "string", "enum": ["USDC", "USDT"]},
            },
        },
    },
}]

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Pay $25 to OpenAI"}],
    tools=tools,
)

pip install crewai sardis

from crewai import Agent, Task, Crew
from crewai.tools import tool
from sardis import SardisClient

sardis = SardisClient(api_key="sk_live_...")

@tool("sardis_pay")
def sardis_pay(to: str, amount: str, token: str) -> str:
    """Execute a payment through Sardis."""
    result = sardis.wallets.transfer(...)
    return f"Payment: {result.tx_hash}"

purchaser = Agent(
    role="Procurement Specialist",
    tools=[sardis_pay],
)

crew = Crew(agents=[purchaser], tasks=[...])