BranchesTags

Repository files navigation

Agent Builder

A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.

Overview

Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.

Features

  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling

Architecture

Core Components

  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations

Example Categories

Standalone Agents

  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration

Communication Platforms

  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration

Quick Start

Prerequisites

  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server

Installation

# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build

Available Examples

Start a Telegram Bot

npm run start:telegram-bot-vercel

Run Standalone Vercel Agent

npm run start:standalone-vercel

Start LangChain Agent

npm run start:standalone-langchain

Launch Email Agent

npm run start:email

Start XMTP Agent

npm run start:xmtp

Examples

Telegram Bot (src/examples/telegram/)

Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.

Key Features:

  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management

Standalone Agents (src/examples/standalone/)

Vercel AI SDK

Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.

LangChain Integration

Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.

Communication Integrations

Email Agent (src/examples/email/)

Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.

XMTP Integration (src/examples/xmtp/)

Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.

Configuration

Each example includes its own environment configuration. Common environment variables include:

# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server

Documentation

Operation Guides (docs/prompts/)

  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow

Common Utilities (src/common/)

  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation

Development

Workspace Structure

This project uses npm workspaces for managing multiple packages:

src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands

# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp

Adding New Examples

  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json

Boson Protocol Integration

All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:

  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations

Transaction Flow

  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation

Security Considerations

  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging

Dependencies

Core Dependencies

  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework

Development Tools

  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization

Version Management

This project uses Volta for Node.js version management:

  • Node.js: 23.11.1
  • npm: 11.5.2

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request

Support

⚠️ Warning

These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.

About

Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.

www.bosonprotocol.io

Topics

agentic-commercedcommerceecommerce

Resources

Readme
Apache-2.0 license
Activity
Custom properties

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Agent Builder
A collection of AI agents and examples that integrate with Boson Protocol for decentralized commerce operations. This repository provides various implementations and patterns for building intelligent agents that can interact with blockchain networks and perform commerce-related tasks.
Overview
Agent Builder is a comprehensive toolkit for creating AI-powered agents that integrate with Boson Protocol's decentralized commerce infrastructure. It includes multiple example implementations across different platforms and communication channels, demonstrating how to build agents that can handle wallet management, blockchain transactions, and commerce operations.
Features
  • Multiple AI Integrations: Support for Claude AI, LangChain, and other AI frameworks
  • Multi-Platform Examples: Telegram bots, email agents, XMTP messaging, and standalone applications
  • Blockchain Integration: Full Boson Protocol MCP server integration with multi-chain support
  • Wallet Management: Secure private key handling and transaction signing
  • Commerce Operations: Complete decentralized commerce functionality
  • TypeScript Support: Fully typed codebase with modern development tooling
Architecture
Core Components
  • Common Utilities (src/common/): Shared blockchain configurations and utilities
  • Examples (src/examples/): Various agent implementations and patterns
  • Documentation (docs/): Detailed guides and prompts for specific operations
Example Categories
Standalone Agents
  • Vercel AI SDK: Direct AI integration examples
  • LangChain: Structured chat agents with tool integration
Communication Platforms
  • Telegram: Interactive Telegram bots with Claude AI
  • Email: Email-based agent interactions
  • XMTP: Decentralized messaging integration
Quick Start
Prerequisites
  • Node.js 23.11.1+ (managed via Volta)
  • npm 11.5.2+
  • API keys for your chosen AI provider
  • Access to Boson Protocol MCP server
Installation
# Clone the repository
git clone https://github.com/bosonprotocol/agent-builder.git
cd agent-builder
# Install all dependencies
npm ci
# Build examples
npm run build
Available Examples
Start a Telegram Bot
npm run start:telegram-bot-vercel
Run Standalone Vercel Agent
npm run start:standalone-vercel
Start LangChain Agent
npm run start:standalone-langchain
Launch Email Agent
npm run start:email
Start XMTP Agent
npm run start:xmtp
Examples
Telegram Bot (src/examples/telegram/)
Interactive Telegram bot powered by Claude AI with full Boson Protocol integration. Features secure wallet management, multi-chain support, and conversational AI capabilities.
Key Features:
  • Claude AI integration for natural conversations
  • Secure in-memory private key storage
  • Multi-chain blockchain operations
  • Dynamic tool loading per network
  • User context management
Standalone Agents (src/examples/standalone/)
Vercel AI SDK
Direct integration examples using Vercel's AI SDK, demonstrating how to build command-line agents with Boson Protocol tools.
LangChain Integration
Structured chat agents using LangChain framework with GOAT SDK adapter, providing a clean pattern for tool-based AI interactions.
Communication Integrations
Email Agent (src/examples/email/)
Email-based agent that can process commerce operations through email interactions, perfect for asynchronous workflows.
XMTP Integration (src/examples/xmtp/)
Decentralized messaging integration using XMTP protocol, enabling Web3-native communication channels.
Configuration
Each example includes its own environment configuration. Common environment variables include:
# AI Provider KeysANTHROPIC_API_KEY=your_anthropic_key_hereOPENAI_API_KEY=your_openai_key_here# Boson ProtocolBOSON_MCP_URL=https://mcp-staging.bosonprotocol.io/mcp# Platform-specificTG_BOT_TOKEN=your_telegram_bot_token# For Telegram examples# XMTP_BOSON_MCP_URL is OPTIONAL: only set it to your own self-hosted XMTP MCP# server URL. Leave it unset to run the server locally over stdio (the default).# XMTP_BOSON_MCP_URL=http://127.0.0.1:3000/mcp # For XMTP examples - self-hosted HTTP server
Documentation
Operation Guides (docs/prompts/)
  • create-offer.md: Guide for creating offers on Boson Protocol
  • commit-offer.md: Instructions for committing to offers
  • redeem-exchange.md: Exchange redemption process
  • create-seller-if-needed.md: Seller entity creation workflow
Common Utilities (src/common/)
  • chains.ts: Blockchain network configurations
  • README.md: Shared utilities documentation
Development
Workspace Structure
This project uses npm workspaces for managing multiple packages:
src/examples/
├── standalone/vercel/ # Vercel AI SDK examples
├── standalone/langchain/ # LangChain integration
├── telegram/vercel/ # Telegram bot implementation
├── email/ # Email agent
└── xmtp/ # XMTP messaging

Development Commands
# Watch mode for development
npm run watch
# Linting
npm run lint
npm run lint:fix
# Start specific examples
npm run start:telegram-bot-vercel
npm run start:standalone-vercel
npm run start:standalone-langchain
npm run start:email
npm run start:xmtp
Adding New Examples
  1. Create a new directory under src/examples/
  2. Add workspace configuration to root package.json
  3. Create example-specific package.json with dependencies
  4. Implement your agent following existing patterns
  5. Add startup script to root package.json
Boson Protocol Integration
All examples integrate with Boson Protocol's decentralized commerce infrastructure through the MCP (Model Context Protocol) server. This enables agents to:
  • Create and manage seller/buyer entities
  • Create and list offers
  • Handle commitments and exchanges
  • Process redemptions and disputes
  • Manage multi-chain operations
Transaction Flow
  1. Agent receives user request
  2. Calls appropriate Boson Protocol MCP tool
  3. Receives transaction data (to, data fields)
  4. Signs transaction with user's wallet
  5. Broadcasts transaction to blockchain
  6. Monitors transaction confirmation
Security Considerations
  • Private Key Management: All examples implement secure, memory-only private key storage
  • Environment Variables: Sensitive data managed through environment configuration
  • Transaction Validation: All blockchain operations include proper validation
  • Error Handling: Comprehensive error handling with secure logging
Dependencies
Core Dependencies
  • @bosonprotocol/agentic-commerce: Boson Protocol MCP integration
  • @bosonprotocol/chat-sdk: Communication utilities
  • @bosonprotocol/common: Shared protocol utilities
  • grammy: Telegram Bot API framework
Development Tools
  • TypeScript with strict configuration
  • ESLint with comprehensive rule set
  • Prettier for code formatting
  • Turbo for build optimization
Version Management
This project uses Volta for Node.js version management:
  • Node.js: 23.11.1
  • npm: 11.5.2
Contributing
  1. Fork the repository
  2. Create a feature branch
  3. Follow existing code patterns and conventions
  4. Add tests for new functionality
  5. Ensure all linting passes
  6. Submit a pull request
Support
⚠️ Warning
These are just examples showcasing how agent developers can use our agentic commerce tools. The Agent examples are basic ones an do not implement an advanced context management. Deploying them to production might lead to unexpected behaviour.
About
Reference agents and integration examples for Boson Protocol — LangChain, Vercel AI, Telegram, XMTP, and Email. Build AI agents that can buy, sell, and manage commerce flows on Base, Ethereum, Optimism, Arbitrum and Polygon.
www.bosonprotocol.io
Topics
agentic-commercedcommerceecommerce
Resources
Readme
Apache-2.0 license
Activity
Custom properties
Stars
3 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages