<div align="center">

<img src="https://app.olamto.fun/logo.png" width="110" alt="Olamto Logo" style="border-radius: 18px; box-shadow: 0 0 30px rgba(43, 84, 255,0.3);" />

⚡ Olamto Studio

Next-Gen Web3 AI Agentic Platform & Cloudflare One MCP Portals

🌐 Live Studio App • 📖 Developer Docs • 🐙 GitHub • 𝕏 (Twitter) • ✈️ Telegram

</div>

---

🚀 Overview

Olamto Studio is the premier Web3 AI development platform designed for autonomous smart contract engineering, stateful AI agent execution, and Model Context Protocol (MCP) server portals running natively on Cloudflare Workers Edge.

                     ┌───────────────────────────────────────────────┐
                     │          Olamto AI Engine Core                │
                     │       (16 Frontier AI Models Suite)           │
                     └───────────────────────┬───────────────────────┘
                                             │
            ┌────────────────────────────────┼────────────────────────────────┐
            ▼                                ▼                                ▼
┌─────────────────────────┐     ┌─────────────────────────┐     ┌─────────────────────────┐
│   Robinhood EVM Chain   │     │  Solana MCP Autofixer   │     │  Cloudflare One MCP     │
│   Solidity Compiler     │     │   Anchor & Pinocchio    │     │  5x Token Savings       │
│   Chain ID 4663         │     │   Rust Program Repair   │     │  Workers Codemode       │
└─────────────────────────┘     └─────────────────────────┘     └─────────────────────────┘

---

✨ Core Features

• 🤖 Autonomous Agent SDK (@olamtostudio/agents): Event-driven agent base class with edge state persistence via Durable Objects and real-time WebSocket fibers.
• 🟢 Robinhood EVM Chain (Chain ID 4663): Native Solidity compilation, static vulnerability auditing via Blockscout API, and gas estimation.
• 🟣 Solana MCP Program Autofixer: Anchor & Pinocchio Rust smart contract error parsing, IDL generation, and automated code repair.
• ⚡ Cloudflare One MCP Server Portals: 5x Token Savings optimization via minimize_tools() & search_and_execute(), reducing context window usage by up to 80%.
• 𝗤 Cloudflare D1 SQL Vault: Serverless SQL storage for user configurations, API key vaults, and rate limits.

---

📦 Installation

Since @olamtostudio/agents is hosted directly on GitHub, install it directly using npm, yarn, or pnpm:

# Install directly from GitHub Repository
npm install github:olamtostudio/agents

# Using yarn
yarn add olamtostudio/agents

# Using pnpm
pnpm add github:olamtostudio/agents

Or clone and build from source:

git clone https://github.com/olamtostudio/agents.git
cd agents
npm install && npm run build

---

⚡ Quick Start

Create an autonomous Web3 AI agent in TypeScript:

import { Agent, type Connection, type WSMessage, type AgentEnv } from "@olamtostudio/agents";

export class Web3AuditorAgent extends Agent {
  constructor(env: AgentEnv) {
    super(env);
  }

  // 1. Triggered on connection establishment
  async onConnect(connection: Connection): Promise<void> {
    console.log("⚡ Olamto Agent booted on Robinhood EVM Chain ID 4663");
    connection.send(JSON.stringify({
      type: "ready",
      status: "Connected to Olamto Studio Edge"
    }));
  }

  // 2. Triggered on incoming message or tool command
  async onMessage(connection: Connection, message: WSMessage): Promise<void> {
    const data = typeof message === "string" ? JSON.parse(message) : message;

    if (data.action === "audit") {
      await this.setState({ last_contract: data.contract });
      const currentState = await this.getState();

      connection.send(JSON.stringify({
        status: "success",
        state: currentState,
        content: `Audit initiated for contract on Robinhood EVM Chain ID 4663`
      }));
    }
  }

  // 3. Triggered when client disconnects
  async onClose(connection: Connection): Promise<void> {
    console.log("Client disconnected:", connection.id);
  }
}

---

📖 SDK Reference (@olamtostudio/agents)

Agent Abstract Base Class

import { Agent, type Connection, type WSMessage, type AgentEnv } from "@olamtostudio/agents";

export class CustomAgent extends Agent {
  constructor(env: AgentEnv) {
    super(env);
  }

  // Boots up connection context
  async onConnect(connection: Connection): Promise<void> {}

  // Handles incoming messages and tool execution commands
  async onMessage(connection: Connection, message: WSMessage): Promise<void> {}

  // Handles connection teardown
  async onClose(connection: Connection): Promise<void> {}
}

Session State Storage

// Set state
await this.setState({ user_wallet: "0x46633e21a4168923058b71b93f21" });

// Get current state
const currentState = await this.getState();

---

⛓️ Robinhood EVM Chain Integration (Chain ID 4663)

import { RobinhoodEVM } from "@olamtostudio/agents";

const evm = new RobinhoodEVM({
  rpcUrl: "https://rpc.robinhood.olamto.fun",
  chainId: 4663,
});

const auditResult = await evm.auditContract(`
  pragma solidity ^0.8.20;
  contract OlamtoToken {
      mapping(address => uint256) public balances;
      function transfer(address to, uint256 amount) public {
          balances[msg.sender] -= amount;
          balances[to] += amount;
      }
  }
`);

console.log("Audit Status:", auditResult.status);
console.log("Vulnerabilities:", auditResult.issues);

---

☀️ Solana MCP Program Autofixer

import { SolanaMCP } from "@olamtostudio/agents";

const solana = new SolanaMCP();

const fixResult = await solana.autofixProgram({
  sourceCode: rustProgramCode,
  errorMessage: "Error: AccountDiscriminatorMismatch",
});

console.log("Repaired Rust Code:", fixResult.repairedCode);

---

🌐 Official Channels & Resources

• 🌐 Live Application: https://app.olamto.fun
• 📖 Developer Documentation: https://app.olamto.fun/docs
• 🐙 GitHub Repository: https://github.com/olamtostudio/agents

---

<div align="center"> _{MIT License © 2026 Olamto Foundation} </div>