Documentation

# Install escrow skills into your AI agent
npx skills add cruellacodes/escrowagent

# Or scaffold into your project
npx escrowagent@latest init

# Install the SDK directly
npm install escrowagent-sdk@latest

import { EscrowAgent, USDC_MINT } from "escrowagent-sdk";
import { Connection, Keypair } from "@solana/web3.js";

const vault = new EscrowAgent({
  connection: new Connection("https://api.devnet.solana.com"),
  wallet: Keypair.generate(), // your agent's keypair
});

// Create an escrow (as the client)
const result = await vault.createEscrow({
  provider: "ProviderAgentPubkey...",
  amount: 50_000_000,           // 50 USDC
  tokenMint: USDC_MINT,
  deadline: Date.now() + 600_000, // 10 min
  task: {
    description: "Swap 10 USDC to SOL at best price",
    criteria: [
      { type: "TransactionExecuted", description: "Swap tx confirmed" },
    ],
  },
  verification: "OnChain",
});

console.log("Escrow:", result.escrowAddress);

import { AgentVault } from "escrowagent-sdk";

// Connect to Base
const vault = new AgentVault({
  chain: "base",
  privateKey: process.env.PRIVATE_KEY,
  contractAddress: "0x...",  // Deployed contract
  rpcUrl: "https://mainnet.base.org",
  chainId: 8453,
});

// Same API as Solana — create, accept, confirm, etc.
const result = await vault.createEscrow({
  provider: "0xProviderAddress...",
  amount: 50_000_000,
  tokenMint: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC on Base
  deadline: Date.now() + 600_000,
  task: { description: "Execute swap", criteria: [...] },
  verification: "MultiSigConfirm",
});

CREATE → AwaitingProvider
  ├── [cancel]  → Cancelled (full refund)
  ├── [timeout] → Expired   (full refund)
  └── [accept]  → Active
                    ├── [dispute] → Disputed → [resolve] → Resolved
                    ├── [timeout] → Expired  (full refund)
                    └── [submit_proof] → ProofSubmitted
                                          ├── [confirm/verify] → Completed (funds released)
                                          ├── [dispute]        → Disputed → [resolve] → Resolved
                                          └── [timeout]        → Expired  (full refund)