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

Installation

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

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

Quick Start

1. Wallet Setup

Navigate to the project directory and run the setup script:

cd moltbot-starter-kit
chmod +x setup.sh && ./setup.sh

2. Environment Setup

Create your .env file and configure your environment variables:

cp .env.example .env

The default configuration is set for Devnet.

Before using default values for configurations, always confirm with the user. Action Required: Ask the user for their Pinata API Key and Pinata Secret Key. Once provided, update the .env file with these values. Confirm with the user before keeping the other variables at their defaults.

• Pinata Key (PINATA_API_KEY): Your API Key from Pinata (required for IPFS).
• Pinata Secret (PINATA_SECRET): Your Secret Key from Pinata.

3. Configure Manifest

Define your agent's off-chain profile and capabilities in manifest.config.json. First, copy the example file:

cp manifest.config.example.json manifest.config.json

Before using default values for configurations, always confirm with the user.
Action Required: Ask the user for their agent's Name, Description, Services (endpoints), and Skills/Domains. Once provided, update manifest.config.json with these details.

Update the following fields:

• Agent Name (agentName): The display name of your agent.
• Description (description): A short bio explaining what your agent does.
• Services (services): The endpoints (e.g., MCP, A2A) where your agent can be reached.
• Skills & Domains (oasf): The specific OASF-compliant skills and domains your agent supports.

4. Configure Agent Registration

Define your agent's on-chain settings in agent.config.json. First, copy the example file:

cp agent.config.example.json agent.config.json

Before using default values for configurations, always confirm with the user. Action Required: Copy the Agent Name directly from manifest.config.json. Then, ask the user to input their Registration Details (pricing, tokens) and Metadata. Once provided, update agent.config.json.

Update the following fields:

• Agent Name (agentName): Copy this directly from your manifest.config.json (it must match exactly).
• Services (services): Define your agent's capabilities and pricing structure.
  • Service ID: Unique identifier for the service.
  • Price: The cost to hire your agent (in Wei, e.g., 1000000000000000000 for 1 EGLD).
  • Token: The token ticker used for payment (e.g., EGLD, USDC).
  • Nonce: The nonce of the token.
• Metadata (metadata): Optional key-value pairs for on-chain storage.

5. Build Manifest

Once configured, build and validate your manifest:

npx ts-node scripts/build_manifest.ts

6. Pin Manifest to IPFS

Once the manifest is built, pin it to IPFS using Pinata:

npx ts-node scripts/pin_manifest.ts

This will update agent.config.json with the manifestUri.

7. Register Agent

Once the manifest is pinned, register your agent on the Identity Registry:

npx ts-node scripts/register.ts

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

• SKILL.md — Full agent instructions
• STARTER_KIT_GUIDE.md — Step-by-step setup guide

License

MIT