Agent Runtime

Deploy the high-performance Rust services with Docker Compose.

# Clone and start the agent runtime
cd agent-sandbox/rust
docker-compose up -d

# Verify services are healthy
curl http://localhost:4000/health  # Executor
curl http://localhost:4100/health  # Analyzers
curl http://localhost:4200/health  # State Manager

Add the TypeScript SDK to your agent project.

npm install @stablecoin-sde/agent-sdk

# Configure environment
export RUST_EXECUTOR_URL=http://localhost:4000
export RUST_ANALYZER_URL=http://localhost:4100
export RUST_STATE_SERVICE_URL=http://localhost:4200
export AGENT_SANDBOX_API_KEY=your_api_key

Build a cross-chain settlement agent with the SDK.

import { AgentSandbox } from '@stablecoin-sde/agent-sdk';

const sandbox = await AgentSandbox.create({
  apiKey: process.env.AGENT_SANDBOX_API_KEY,
  environment: 'sandbox'
});

// Create wallets for agent operations
const treasury = await sandbox.wallet.create();
const bridge = await sandbox.wallet.create();

// Fund wallets for testing
await sandbox.wallet.fund(treasury.address, '10000');

Add compliance checks and cross-chain operations.

// Screen wallet before bridging
const decision = await sandbox.compliance.check({
  type: 'WALLET_SCREEN',
  address: destinationWallet
});

if (decision.response.status === 'PASS') {
  // Execute cross-chain transfer
  const result = await sandbox.compute.runShell(`
    cast send $BRIDGE_CONTRACT \
      "initiateTransfer(address,uint256)" \
      ${destinationWallet} ${amount} \
      --private-key ${treasury.privateKey}
  `);

  console.log('Bridge TX:', result.stdout);
}

Analyze your agent contracts with Slither and Aderyn.

// Run parallel security analysis (3-5x faster with Rust)
const analysis = await sandbox.compute.runSecurityAnalysis(
  bridgeContractCode
);

console.log('Vulnerabilities found:', analysis.summary);
// { high: 0, medium: 1, low: 3, informational: 5 }

// Review specific issues
analysis.vulnerabilities
  .filter(v => v.severity === 'high')
  .forEach(v => console.log(v.title, v.location));

Capture compliance decisions for deterministic testing.

// Start recording decisions
await sandbox.compliance.startRecording();

// Run your agent workflow
await runCrossChainSettlement();

// Save recording for replay in CI/CD
const decisions = await sandbox.compliance.stopRecording();
const recordingId = await sandbox.compliance.saveRecording(
  'cross-chain-happy-path',
  'Settlement with clean wallets',
  decisions
);

// Later: replay for deterministic tests
await sandbox.compliance.startReplay(
  await sandbox.compliance.loadRecording(recordingId)
);