Agent Developer Guide

Integrating as an Agent

Use the Armoris SDK or the native n8n community node to enable your AI agent to autonomously discover stores and purchase products using the x402 payment protocol.

armoris-agent-buyerv0.1.4n8n-nodes-armoris-buyerv0.1.4
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ AI Agent │────▶│ Armoris Gateway │────▶│ WooCommerce │ │ (SDK/n8n) │ │ (x402 Proxy) │ │ Store │ └─────────────┘ └──────────────────┘ └─────────────────┘ │ │ │ 1. discoverStore() 2. Quote + x402 3. Order Created 4. buyFromStore() Payment Proof & Fulfilled
1

TypeScript / Node.js SDK

The armoris-agent-buyer package is a lightweight SDK that works in any Node.js or TypeScript environment — LangChain, AutoGPT, CrewAI, custom scripts, and more.

Installation

$ npm install armoris-agent-buyer

Import & Usage

// Import the SDK functions
import { discoverStore, buyFromStore } from 'armoris-agent-buyer';

// 1. Auto-discover gateway config from a product page URL
const store = await discoverStore('https://my-store.com/product/sneakers');

// 2. Purchase the item
const result = await buyFromStore({
gatewayUrl: store.gatewayUrl,
storeId: store.storeId,
privateKey: '0x...', // Agent EVM wallet
networkId: 324705682, // SKALE Europa Hub Mainnet
rpcUrl: 'https://mainnet.skalenodes.com/v1/elated-tan-skat',
}, {
items: [{ sku: 'sneakers-001', quantity: 1 }],
customerDetails: { email: 'agent@armoris.ai', firstName: 'AI', lastName: 'Agent', ... },
});

console.log('Order ID:', result.orderId);
View on npm
2

n8n Community Node

The n8n-nodes-armoris-buyer is a native n8n community node — drag it onto your workflow canvas and wire it to any AI agent or trigger without writing code.

Install via n8n UI (Recommended)

  1. Go to Settings → Community Nodes → Install
  2. Search for n8n-nodes-armoris-buyer
  3. Click Install — no CLI needed

Or install via npm (self-hosted n8n)

$ npm install n8n-nodes-armoris-buyer armoris-agent-buyer

Using the Node

1

Create an Armoris Agent API credential with your EVM private key, Network ID, and RPC URL.

2

Add the Armoris Purchase Agent node to your canvas and select the credential.

3

Set the Shop URL (WooCommerce product page) and Items (JSON array of SKU + quantity).

4

All fields support n8n expressions — wire upstream AI agent outputs directly: {{ $json.shopUrl }}

View on npm

You're Ready!

Your agent can now autonomously discover any Armoris-enabled WooCommerce store and complete purchases on-chain using USDC.

Supported Frameworks

  • n8n — via the n8n-nodes-armoris-buyer community node
  • LangChain — wrap buyFromStore as a custom Tool
  • AutoGPT / CrewAI — import as a standard npm package
  • Custom scripts — any Node.js / TypeScript environment