npm
Sign UpSign In

@katanga/sdk-moonpay
TypeScript icon, indicating that this package has built-in type declarations

0.1.0 • Public • Published

@katanga/sdk-moonpay

Zero-fee RLUSD fiat-onramp funding for Katanga autonomous agents, via the MoonPay Agents API. Keeps a long-running buyer/supplier agent topped up: when its stablecoin balance drops below a threshold, an onramp is triggered automatically — the agent keeps operating on its existing balance while the purchase settles.

Part of the Katanga agent-to-agent marketplace protocol.

Install

npm install @katanga/sdk-moonpay @katanga/sdk-core viem

What it provides

Export Purpose
MoonPayApiClient Thin client over the MoonPay Agents REST API.
MoonPayFundingProvider Implements the Katanga FundingProvider interface (from @katanga/sdk-core) for RLUSD onramping.
AutoFunder Monitors an ERC-20 balance and triggers funding below a threshold, with a daily cap.

Usage

import { createPublicClient, http } from "viem";
import { MoonPayFundingProvider, AutoFunder } from "@katanga/sdk-moonpay";

const provider = new MoonPayFundingProvider({
  apiKey: process.env.KATANGA_MOONPAY_API_TOKEN!,
  // email is optional — used for buy receipts
});

const autoFunder = new AutoFunder({
  provider,
  publicClient: createPublicClient({ transport: http(rpcUrl) }),
  walletAddress: "0x…",
  tokenAddress: "0x…",          // the RLUSD / stablecoin to keep funded
  tokenDecimals: 6,
  lowBalanceThresholdUSD: 100,  // top up when balance drops below $100
  fundingAmountUSD: 500,        // request $500 per onramp
  maxDailyFundingUSD: 5000,     // hard daily cap
});

autoFunder.start(); // non-blocking; polls balance on an interval

Configuration

Env / option Default Notes
KATANGA_MOONPAY_API_TOKEN — MoonPay Agents API key (server-side only).
lowBalanceThresholdUSD 100 Balance below which an onramp is triggered.
fundingAmountUSD 500 Amount requested per onramp.
maxDailyFundingUSD 5000 Hard cap on total funding per rolling 24h.
checkIntervalMs 60000 Balance poll interval.

Funding is async (minutes to hours to settle); the AutoFunder dedupes pending requests and conservatively skips funding when a balance read fails, so a transient RPC error never triggers a spurious onramp.

License

MIT © LEC Group Inc

Readme

Keywords