@olamtostudio/agents
v1.0.0
Published
Official Olamto Autonomous Agent SDK for Cloudflare Workers AI, Robinhood EVM Chain (4663), and Solana MCP Portals
Maintainers
Readme
⚡ Olamto Studio
Next-Gen Web3 AI Agentic Platform & Cloudflare One MCP Portals
🌐 Live Studio App • 📖 Developer Docs • 🐙 GitHub • 𝕏 (Twitter) • ✈️ Telegram
🚀 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/agentsOr 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
