WireStable is a production-grade, conversational Web3 stablecoin stack that simplifies remittances and active treasury operations. By leveraging **Circle User-Controlled Smart Wallets** and the **Arc Network's** USDC gas token abstraction, WireStable makes corporate payouts, volatility hedging, and salary streams frictionless.

Quick Start

WireStable integrates seamlessly with standard JavaScript/TypeScript ecosystems, Python backend clients, and standard shell endpoints. Use the language switcher below to inspect setup instructions:

npm install @circle-fin/user-controlled-wallets @circle-fin/app-kit viem

System Architecture

The diagram below visualizes the end-to-end request pipeline, showing how conversational user intent is processed, verified, and settled.

Circle User-Controlled Smart Wallets

User funds are secured via Circle's non-custodial Smart Contract Account (SCA) SDK. During onboarding, a user creates cryptographic keys secured in their device's hardware enclave (WebAuthn/Passkey). Transfers require the client to execute a challenge, ensuring that neither the platform nor the AI agent can ever touch funds without permission.

EIP-7708 Gasless Paymaster

WireStable maps transaction payloads to an off-chain Paymaster. When the Smart Account proposes a transaction execution, the Paymaster automatically funds the gas fee in USDC on the Arc Chain. The end-user is completely isolated from needing L1 gas tokens.

Unified Cross-Chain Portfolio

Through **Circle Gateway APIs**, WireStable aggregates a unified USDC portfolio balance across Ethereum Sepolia, Base, and Solana Devnet. The system manages Gateway minters under the hood to consolidate cross-chain deposits and settle payouts instantly.

Volatility Hedging (ERC-8004 Locks)

Corporations can hedge exchange volatility during remittance corridors. The system deploys cryptographic ERC-8004 FX rate locks on the Arc Chain for 24 hours, securing a fixed exchange rate (e.g. USDC to EURC) for a micro-premium.

Integration Example

// Request 24h FX Option Rate Lock on Arc Chain
const response = await fetch("https://wirestable.xyz/api/fx-hedging/quote", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    amount: 10000,
    corridor: "USDC-EURC",
    targetRate: 0.9245
  })
});

const { lockId, premium } = await response.json();
console.log(`Rate lock secured. ID: #${lockId}, Premium: ${premium} USDC`);

Payout API Reference

Initializes a batch transaction payroll payout. Returns transaction signatures and verification records.

import { CircleDeveloperControlledWallets } from "@circle-fin/developer-controlled-wallets";

const client = new CircleDeveloperControlledWallets({
  apiKey: process.env.CIRCLE_API_KEY,
  entitySecret: process.env.ENTITY_SECRET
});

const response = await client.createTransaction({
  walletId: "0x8922c1...",
  destinationAddress: "0x742d3...",
  amount: ["250.00"],
  feeLevel: "LOW", // Gasless sponsored via Paymaster
  tokenId: "USDC"
});

Nanopayment Stream API Reference

Deploys an off-chain micro-payment streaming channel, establishing continuous salary flows that accumulate per second.

// Initialize streaming remittance channel
const res = await fetch("https://wirestable.xyz/api/nanopay/channel", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    initialDeposit: "500.00",
    recipientAddress: "0x98f3c...",
    flowRatePerSecond: "0.00578" // ~20.8 USDC/hour
  })
});

Error Code Dictionary

WireStable maps raw chain and Circle SDK errors to clear explanations. Below are the most common error codes encountered during integration: