Skip to content

Latest commit

 

History

History
98 lines (78 loc) · 4.12 KB

README.md

File metadata and controls

98 lines (78 loc) · 4.12 KB

Moltbot Starter Kit (MultiversX)

Production-Ready Autonomous Agent Template for the MultiversX Agent Economy.

A fully functional, hardened implementation of an OpenClaw Agent with a comprehensive skill library for blockchain interactions.

Features

  • ✅ SDK v15+ — Modern NetworkEntrypoint, ABI factories, controllers
  • ✅ 14+ Agent Skills — Identity, validation, reputation, escrow, transfers, discovery, hiring, manifest
  • ✅ Production Hardened — Central config, SSRF guards, retry logic, timeouts
  • ✅ TDD Verified — 47+ unit tests, mocked SDK for offline testing
  • ✅ OASF Taxonomy — Official 136 skill + 204 domain IDs for agent registration

Quick Start

git clone https://github.com/sasurobert/moltbot-starter-kit.git
cd moltbot-starter-kit
chmod +x setup.sh && ./setup.sh

Or install via the OpenClaw one-liner (includes SKILL.md + references):

curl -sL https://raw.githubusercontent.com/sasurobert/multiversx-openclaw-skills/main/scripts/install.sh | bash

Skills Library

All skills live in src/skills/ and are exported from src/skills/index.ts:

Skill File Functions Description
identity_skills.ts registerAgent, getAgent, setMetadata Agent identity on the Identity Registry
validation_skills.ts initJob, submitProof, isJobVerified, getJobData Job lifecycle on the Validation Registry
reputation_skills.ts submitFeedback, getReputation Feedback and reputation scores
escrow_skills.ts deposit, release, refund, getEscrow Escrow fund management
transfer_skills.ts transfer, multiTransfer EGLD, ESDT, NFT, SFT transfers
discovery_skills.ts discoverAgents, getBalance Agent discovery + balance queries
hire_skills.ts hireAgent Composite: init_job + escrow deposit
manifest_skills.ts buildManifest, buildManifestJSON Registration manifest with OASF validation
oasf_taxonomy.ts validateOASF, lookups Official OASF skill/domain taxonomy

Project Structure

moltbot-starter-kit/
├── src/
│   ├── skills/           ← All agent skills
│   │   ├── index.ts      ← Barrel export
│   │   ├── identity_skills.ts
│   │   ├── validation_skills.ts
│   │   ├── reputation_skills.ts
│   │   ├── escrow_skills.ts
│   │   ├── transfer_skills.ts
│   │   ├── discovery_skills.ts
│   │   ├── hire_skills.ts
│   │   ├── manifest_skills.ts
│   │   └── oasf_taxonomy.ts
│   ├── abis/             ← Smart contract ABIs
│   ├── utils/            ← Entrypoint, ABI patching, Logger
│   ├── config.ts         ← Centralized configuration
│   ├── validator.ts      ← Proof submission logic
│   ├── hiring.ts         ← Employer hiring flow
│   ├── facilitator.ts    ← x402 facilitator client
│   └── index.ts          ← Main agent loop
├── scripts/              ← register.ts, update_manifest.ts, build_manifest.ts
├── tests/                ← 68 unit tests (17 suites)
├── agent.config.json     ← Agent on-chain state (nonce, services, metadata)
└── manifest.config.json  ← Manifest blueprint (OASF skills, endpoints, contact)

Environment Variables

Variable Description Default
MULTIVERSX_CHAIN_ID Network chain ID D (devnet)
MULTIVERSX_API_URL API endpoint devnet API
IDENTITY_REGISTRY_ADDRESS Identity Registry contract —
VALIDATION_REGISTRY_ADDRESS Validation Registry contract —
REPUTATION_REGISTRY_ADDRESS Reputation Registry contract —
ESCROW_CONTRACT_ADDRESS Escrow contract —

Testing

npm test              # All tests
npm run test:coverage # With coverage report

Documentation

License

MIT