Skip to content
rdmbtcPublic

About

A digital store protecting gross margin. Agent decision enforces policy before orders are fulfilled. Sub-second USDC settlement on Arc

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Mercenta — Autonomous B2B Digital Procurement Protocol on Arc

Deterministic Policy Boundary Between AI Intent and Onchain Settlement
Built for the Tameion Agents Hackathon (Arc Blockchain · Circle Stack)

Tests Arc Mainnet Circle Stack License


1. Executive Summary

Mercenta is an Autonomous Business Operator and Procurement Gateway designed for digital agencies, AI startups, and autonomous agents operating on the Arc blockchain.

When businesses delegate spending to AI agents, giving them unconstrained corporate cards or raw private keys creates existential risks: runaway API loops, prompt injection, and unauthorized treasury drainage. Mercenta solves this with a Deterministic 5-Step Policy Engine (Rubicon architecture standard) that sits as an unbypassable mathematical gate between model intent and financial execution.

flowchart LR
    A["AI Agent / User Intent"] --> B["Deterministic 5-Step Policy Engine"]
    B -->|Passed 5/5| C["Arc Mainnet Clearing (USDC)"]
    B -->|Failed / Over Limit| D["Human Escalation / Blocked"]
    C --> E["Instant Cryptographic Delivery Receipt"]
    
    subgraph Policy Envelope
        B1["01 Spend Cap: ≤ $100 / 24h"]
        B2["02 Margin Floor: ≥ 15%"]
        B3["03 Counterparty: 100% SLA"]
        B4["04 Velocity: ≤ 3 tx/min"]
        B5["05 Human Gate: > $25 Auto-Limit"]
    end
Loading

2. Live Ecosystem Deployments


3. Autonomous Ecosystem Capabilities

3.1 Official Aomi App & Agent Skill (packages/mercenta-aomi-skill)

Mercenta ships a turnkey agent skill compliant with the aomi-labs/skills specification:

  • Agents Supported: Claude Code, Cursor, Codex, OpenCode, Hermes, and build.aomi.dev.
  • 5 Deterministic Agent Tools: mercenta_catalog, mercenta_quote (5-gate policy simulation), mercenta_checkout (atomic Arc settlement), mercenta_treasury_sweep (Morpho Blue sweep), mercenta_crosschain_topup (Circle CCTP V2).
  • One-Command Installation: npx skills add rdmbtc/mercenta.

3.2 Autonomous Treasury Sweeper (RFB 01)

  • Scenario yield planning and Operating Reserve Floor protection logic (Reserve Floor slider and /api/treasury/sweep simulator) ensuring working capital is never depleted below merchant fulfillment needs before allocating idle surplus to whitelisted yield strategies.

3.3 Universal Cross-Chain Top-Up (Circle CCTP V2)

  • Zero-slippage 1:1 burn-and-mint USDC deposits into Arc Mainnet wallets from Base, Solana, Arbitrum One, Polygon, and Ethereum.
  • Eradicates bridge wrapper vulnerabilities, synthetic token risks, and liquidity fragmentation.

3.4 Official Telegram Bot & TWA Storefront (@mercentabot)

  • Client-Side Non-Custodial Arc Wallet: In-client key generation, local AES encryption, and direct export to MetaMask/Rabby/Frame.
  • Turnkey Merchant Bot Starter: Open-source starter in bot/ enabling non-technical merchants and creators to launch a branded Telegram shop with custom profit margins in under 5 minutes.

3. The 5-Step Policy Engine (Rubicon Standard)

Every purchase request—whether triggered by a conversational copilot, an autonomous cron trigger, or an API key—must pass five independent, non-LLM mathematical checks before funds can move:

Gate Name Boundary Purpose
01 Spend Cap ≤ 100.00 USDC / 24h Hard ceiling on daily outlays per wallet; prevents runaway spending loops.
02 Margin Floor ≥ 15.0% Gross Margin Rejects unfavorable wholesale pricing; guarantees positive business unit economics.
03 Counterparty SLA 100% Verified SLAs Routes orders strictly through vetted institutional suppliers with guaranteed activation.
04 Velocity Cap ≤ 3 orders / min Throttles high-frequency bursts and malicious automated replay attempts.
05 Human Gate > $25.00 USDC Escalation Any transaction exceeding the auto-approval ceiling pauses for an explicit 1-click human signature.

4. Deep Circle Stack Integration

Mercenta leverages the full suite of Circle financial infrastructure:

  1. Circle Onramp Kit 1.0.3:
    • Embedded directly into the workspace (Add USDC).
    • Supports BVNK Bank Transfers (no KYB required) and Transak Cards / Apple Pay / Google Pay.
    • Strict server-side session minting and cryptographic wallet binding; payment credentials never touch client storage.
  2. Circle Agent Stack & x402 Micropayments:
    • HTTP 402 Payment Required gateway for autonomous machine-to-machine transactions.
    • Micro-metered paid agent reports and real-time execution verification.
  3. Native Arc USDC Settlement:
    • Settlements clear natively in USDC on Arc Mainnet (Chain ID 5042) with sub-second finality and near-zero gas costs.

5. Smart Contracts & Onchain Architecture

Entity Address / Ref Network Explorer
MercentaCheckout (Sourcify Verified) 0x06b67adf8d63c8c35a6beda42a3bb93d485af3ed Arc Mainnet (5042) View Code · Sourcify
Clearing Settlement Vault 0x58863e4a739da0e62c2eba258b7783e95d5c48ce Arc Mainnet (5042) View Address
Arc Native USDC 0x3600000000000000000000000000000000000000 Arc Mainnet (5042) View Token
Verified Live Purchase Settlement #1 0xaefe4925821f750bda4815a5fbcbc073e67c87c71f37e4093952ba8d23e595a8 Arc Mainnet (5042) View Tx (0.83 USDC)
Verified Live Purchase Settlement #2 0x3d94ee899e4b6000287cf06c5478c90967db053f36fe213ad4b29bb8b209d747 Arc Mainnet (5042) View Tx (0.98 USDC)
x402 Gateway Acceptance Tx 0xef8037362a4b0e7f07b3c6d81b3327389b9271ab57fd7c5e537e4c7a578835b6 Arc Testnet (5042002) View Tx
Open-Source Primitives PolicyEngine.sol, AgentTreasuryVault.sol MIT Toolkit mercenta-primitives

6. Local Development & Verification

Prerequisites

  • Node.js >= 20.x (Node 24 recommended)
  • npm or pnpm

Setup

git clone https://github.com/rdmbtc/mercenta.git
cd mercenta/web
npm install

Run Test Suite (115 Suites / 3,225 Tests)

npm test

Build Production Bundle

npm run build

7. Security & Privacy Guarantees

  • Hardware/State-Machine Isolation: LLMs are never granted write access to private keys or direct ERC-20 transfer methods.
  • Cryptographic Receipts: Every cleared order produces a deterministic reasonHash binding the intent, 5 policy outcomes, onchain transaction hash, and supplier delivery evidence into an immutable audit record.
  • Non-Custodial Architecture: Deposits and transfers require explicit user wallet confirmation; Mercenta does not pool or custody customer private funds.

8. License

MIT © 2026 Mercenta Protocol Contributors.

About

A digital store protecting gross margin. Agent decision enforces policy before orders are fulfilled. Sub-second USDC settlement on Arc

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages