Developer Integration

---

6.1 Exposing an App to the Virtual File System (VFS)

To register a new custom application into the Monkey OS taskbar, your app must dispatch a strictly typed registration payload to the global OS context window:

// Registering a Custom Snipping Tool to Monkey OS
window.dispatchEvent(new CustomEvent('MONKEY_OS_REGISTER_APP', {
  detail: {
    appId: 'custom-sniper-01',
    name: 'Sniper Pro',
    iconUrl: '/assets/icons/sniper-icon.png',
    permissions: [
      'solana:request_signature', 
      'network:rpc_read', 
      'vfs:read_shared'
    ],
    entryPoint: './apps/sniper/index.js'
  }
}));

6.2 Requesting a Transaction Signature via OS Security Layer

Custom applications must not call the wallet provider (window.solana) directly. All transaction requests must be routed through the OS security layer (os://vfs/sys/tx_manager), which invokes the Rug Buster heuristic automatically before prompting the user.

// Formulating a swap intent via the VFS bridge
const requestTx = await fetch('os://vfs/sys/tx_manager', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <LOCAL_APP_TOKEN>'
  },
  body: JSON.stringify({
    intent: "swap",
    params: {
      inputMint: "So11111111111111111111111111111111111111112", // Wrapped SOL
      outputMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // USDC
      amount: 1000000000, // 1 SOL in lamports
      slippageBps: 50 // 0.5%
    }
  })
});

const response = await requestTx.json();
if (response.status === 'success') {
  console.log('Transaction signed and broadcasted! Signature:', response.signature);
} else if (response.error === 'RUG_BUSTER_REJECTION') {
  console.error('Security alert: The requested output mint failed heuristic checks.');
}

6.3 Subscribing to Global Events

Agents can subscribe to the global event bus to react to state changes, new blocks, or social signals identified by other apps (like Trend Puncher).

window.addEventListener('MONKEY_OS_EVENT_BUS', (event) => {
  if (event.detail.type === 'TREND_PUNCHER_ALERT') {
    const { ticker, sentimentScore, contractAddress } = event.detail.data;
    if (sentimentScore > 0.8) {
       // Trigger Ape Vault evaluation logic
       evaluateAlgorithmicEntry(contractAddress);
    }
  }
});

---