Agent SDK overview

The @arcenpay/agent package is the official client library for AI agents operating within the ArcenPay ecosystem. It enables LLMs, autonomous background workers, LangChain/OpenAI/Anthropic agents, and MCP-connected bots to perform self-sovereign financial transactions across EVM networks (BOT Chain, Arc, Base Sepolia, Sepolia), Stellar, and Solana.

Installation

npm install @arcenpay/agent

Key Capabilities

x402 Micropayments

Drop-in fetch() replacement that auto-negotiates HTTP 402 responses with zero gas fees per call.

Agentic Payment Links

Discover and pay hosted checkout links programmatically with strict budget safety guardrails.

AI Framework Adapters

Pre-built tool calling adapters for OpenAI, LangChain, Vercel AI SDK, and Anthropic Claude.

15 MCP Tools

Native Anthropic Model Context Protocol integration for Claude Desktop, Cursor, and LLM swarms.

ArcenAuth & Mandates

Autonomous Agent Mandates (AAM), monotonic delegation chains, and deterministic policy rules.

Verify-Then-Settle Escrow

Autonomous commit-reveal escrow locking funds until deliverables match cryptographic commitments.

Multi-Chain Engine

Unified support for BOT Chain (677), Solana (9100000/9100001), Arc Testnet (5042002), Base Sepolia (84532), and Stellar (9000000/9000001).

Quick Setup

import { ArcenAgent, FileStore } from "@arcenpay/agent";

const agent = new ArcenAgent({
  privateKey: process.env.AGENT_PRIVATE_KEY!,
  chainId: 5042002, // Arc Testnet (or 677 BOT, 9100000 Solana, 9000001 Stellar)
  maxAutoApprove: "0.05",
  maxDailySpend: 20.00,
  store: new FileStore("./agent-state.json"),
});

console.log("Agent Address:", agent.address);
console.log("Active Chain ID:", agent.chainId);

Package Exports

Export	Type	Description
`ArcenAgent`	Class	Main client for autonomous payments, mandates, and escrow.
`ArcenPayAgent`	Class	Canonical alias for `ArcenAgent`.
`toOpenAITools`	Function	Formats ArcenPay agent tools for OpenAI, Kilocode, and OpenRouter function calling.
`executeOpenAITool`	Function	Executes an OpenAI tool call against the agent instance.
`toLangChainTools`	Function	Formats tools for LangChain agent executors and LangGraph ToolNodes.
`toVercelTools`	Function	Formats tools for Vercel AI SDK (`generateText`, `streamText`).
`toAnthropicTools`	Function	Formats tools for Anthropic Claude Messages API tool use.
`createArcenAgentMcpTools`	Function	Creates an MCP tool runner exposing all 15 ArcenPay tools to LLMs.
`ARCENPAY_MCP_TOOL_DEFINITIONS`	Array	15 JSON-schema compliant tool definitions for Claude/Cursor.
`FileStore`	Class	JSON filesystem persistence adapter for reboot resilience.
`MemoryStore`	Class	Internal ephemeral in-memory store; defaults when no `store` is provided.
`isScopeSubset`	Function	Monotonic scope restriction validator for delegated sub-mandates.
`computeExactHash`	Function	Deterministic canonical JSON SHA-256 hash generator.

React SDK

Node.js SDK

Agent SDK

Agent SDK overview

Installation

Key Capabilities

x402 Micropayments

Agentic Payment Links

AI Framework Adapters

15 MCP Tools

ArcenAuth & Mandates

Verify-Then-Settle Escrow

Multi-Chain Engine

Quick Setup

Package Exports

​Installation

​Key Capabilities

x402 Micropayments

Agentic Payment Links

AI Framework Adapters

15 MCP Tools

ArcenAuth & Mandates

Verify-Then-Settle Escrow

Multi-Chain Engine

​Quick Setup

​Package Exports

Installation

Key Capabilities

Quick Setup

Package Exports