Skill: cyberforexblockchain/nexus-llm-gateway (version 2.1.0)

--- name: nexus-llm-gateway description: "Smart multi-model AI gateway on Cardano. Routes prompts to the best LLM (GPT-5.2, Claude Sonnet 4.5, GPT-4o, Claude Haiku 4.5, GPT-4o-mini) with automatic fallback, tiered pricing, and OpenAI-compatible format. Pay with ADA via Masumi." version: 2.1.0 capabilities: - id: invoke-llm-gateway description: "Smart multi-model AI gateway on Cardano. Routes prompts to the best LLM (GPT-5.2, Claude Sonnet 4.5, GPT-4o, Claude Haiku 4.5, GPT-4o-mini) with automatic fallback, tiered pricing, and OpenAI-compatible format. Pay with ADA via Masumi." permissions: network: true filesystem: false shell: false inputs: - name: prompt type: string required: true description: "The prompt to send" - name: tier type: string required: false description: "The tier parameter" - name: model type: string required: false description: "Optional: specific model override" - name: task_type type: string required: false description: "The task_type parameter" - name: messages type: array required: false description: "OpenAI-compatible messages array" outputs: type: object properties: result: type: string description: "The service response" requires: env: [NEXUS_PAYMENT_PROOF] protocols: - masumi - mpp - x402 - ap2 - xrpl - a2a payment: mpp_standard: "IETF draft-httpauth-payment-00" accepted_currencies: [ADA, DJED, iUSD, USDCx, USDM, USDC, XLM, XRP, RLUSD] supported_chains: [cardano, stellar, xrpl] ap2_supported: true batch_settlement: true mpp_discovery: "https://ai-service-hub-15.emergent.host/api/mpp/discover" ap2_config: "https://ai-service-hub-15.emergent.host/api/ap2/config" xrpl_config: "https://ai-service-hub-15.emergent.host/api/xrpl/config" stablecoin_registry: "https://ai-service-hub-15.emergent.host/api/mpp/stablecoins" metadata: '{"openclaw":{"emoji":"\u26a1","requires":{"env":["NEXUS_PAYMENT_PROOF"]},"primaryEnv":"NEXUS_PAYMENT_PROOF"}}' --- # LLM Gateway > NEXUS Agent-as-a-Service on Cardano + Stellar + XRPL | Price: $0.10/request | Accepts: ADA, DJED, iUSD, USDCx, USDM (Cardano) + USDC, XLM (Stellar) + XRP, RLUSD (XRPL) ## When to use Use when you need to call any LLM (GPT-5.2, Claude Sonnet 4.5, GPT-4o, Claude Haiku 4.5, GPT-4o-mini) through one endpoint. Supports tier-based routing (economy/standard/premium/auto) and OpenAI-compatible message format. ## Steps ### Option A: x402 Standard (Recommended) 1. Call the service endpoint without payment headers. 2. Receive HTTP 402 with `WWW-Authenticate: Payment` header AND x402 `accepts[]` array in response body. 3. Select a `paymentRequirement` from `accepts[]` matching your preferred network + asset. 4. Networks: `cardano:mainnet` (ADA, DJED, iUSD, USDCx, USDM), `stellar:pubnet` (USDC, XLM), `sandbox` (free). 5. Send payment to the `payTo` address for `maxAmountRequired` in the specified asset. 6. **Stellar fee sponsorship:** POST your signed XDR to `https://ai-service-hub-15.emergent.host/api/mpp/stellar/sponsor` — NEXUS pays gas, you need 0 XLM. 7. Retry with `X-PAYMENT: <base64url JSON {x402Version:1, scheme:"exact", network, payload:{tx_hash, currency}}>` header. 8. Parse the JSON response and `X-PAYMENT-RESPONSE` header. ### Option B: MPP Standard 1. Call the service endpoint without payment headers. 2. Receive HTTP 402 with `WWW-Authenticate: Payment` header listing all accepted currencies and amounts. 3. Pick your preferred chain + currency: Cardano (ADA, stablecoins) or Stellar (USDC, XLM). 4. Create payment: Masumi escrow (Cardano) or direct Stellar transfer. 5. **Stellar fee sponsorship:** POST your signed XDR to `https://ai-service-hub-15.emergent.host/api/mpp/stellar/sponsor` — NEXUS pays gas, you need 0 XLM. 6. Retry with `Authorization: Payment <base64url-credential>` header. 7. Parse the JSON response and `Payment-Receipt` header. ### Option C: Legacy Header 1. Send a POST request to the NEXUS API endpoint with your input. 2. Include the `X-Payment-Proof` header (Masumi payment ID or `sandbox_test` for testing). 3. Parse the JSON response and return the result. ### API Call ```bash curl -X POST https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway \ -H "Content-Type: application/json" \ -H "X-Payment-Proof: $NEXUS_PAYMENT_PROOF" \ -d '{"prompt": "Write a Python function to sort a list", "tier": "auto", "task_type": "code"}' ``` **Endpoint:** `https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway` **Method:** POST **Headers:** - `Content-Type: application/json` - `X-PAYMENT: <base64url JSON>` (x402 standard — recommended) - `Authorization: Payment <credential>` (MPP standard) - `X-Payment-Proof: <masumi_payment_id>` (legacy — use `sandbox_test` for free testing) **Accepted Currencies:** ADA, DJED, iUSD, USDCx, USDM (Cardano) | USDC, XLM (Stellar) | XRP, RLUSD (XRPL) **AP2 (Google Agent Payments Protocol):** Pre-authorize payments via mandates, settle atomically. See `https://ai-service-hub-15.emergent.host/api/ap2/config`. **XRPL Batch Settlement:** Settle up to 20 mandates in ONE tx with ~5s finality. See skill `nexus-ap2-batched-settle`. **x402 Discovery:** `GET https://ai-service-hub-15.emergent.host/api/mpp/x402` (all services in native x402 format) **MPP Discovery:** `GET https://ai-service-hub-15.emergent.host/api/mpp/discover` **Stablecoin Registry:** `GET https://ai-service-hub-15.emergent.host/api/mpp/stablecoins` (includes on-chain policy IDs) **Stellar Info:** `GET https://ai-service-hub-15.emergent.host/api/mpp/stellar` (assets, recipient, fee sponsorship) **Fee Sponsorship:** `POST https://ai-service-hub-15.emergent.host/api/mpp/stellar/sponsor` (NEXUS pays Stellar gas — agents need 0 XLM) ## External Endpoints | URL | Method | Data Sent | |-----|--------|-----------| | `https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway` | POST | Input parameters as JSON body | ## Security & Privacy - All data is sent to `https://ai-service-hub-15.emergent.host` over HTTPS/TLS. - No data is stored permanently; requests are processed and discarded. - Payment proofs are verified on the Cardano blockchain via the Masumi Protocol. - No filesystem access or shell execution required. ## Model Invocation Note This skill calls the NEXUS AI service API which uses LLM models (GPT-5.2, Claude Sonnet 4.5, GPT-4o) to process requests. The AI processes your input server-side and returns a structured response. You may opt out by not installing this skill. ## Trust Statement By using this skill, your input data is sent to NEXUS (https://ai-service-hub-15.emergent.host) for AI processing. Payments are non-custodial via the Masumi Protocol on Cardano. Only install if you trust NEXUS as a service provider. Visit https://ai-service-hub-15.emergent.host for full documentation. ## Tags `llm`, `ai`, `gateway`, `multi-model`, `gpt`, `claude`, `router`, `cardano`

path: README.md
content: # nexus-llm-gateway

**LLM Gateway** — Smart multi-model AI gateway on Cardano. Routes prompts to the best LLM (GPT-5.2, Claude Sonnet 4.5, GPT-4o, Claude Haiku 4.5, GPT-4o-mini) with automatic fallback, tiered pricing, and OpenAI-compatible format. Pay with ADA via Masumi.

Part of the [NEXUS Agent-as-a-Service Platform](https://ai-service-hub-15.emergent.host) on Cardano.

## Installation

```bash
clawhub install nexus-llm-gateway
```

Or manually copy the `SKILL.md` to your OpenClaw skills directory:

```bash
cp SKILL.md ~/.openclaw/skills/nexus-llm-gateway/SKILL.md
```

## Usage

This skill is automatically invoked by your OpenClaw agent when a matching task is detected.

### Direct API Usage (x402 / MPP Standard)

Any call without payment returns HTTP 402 with a `WWW-Authenticate: Payment` header AND x402 `accepts[]` array in response body:

```bash
# Step 1: Get the x402/MPP challenge
curl -X POST https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway \
  -H "Content-Type: application/json" \
  -d '{"input": "your query here"}'
# Returns 402 + WWW-Authenticate: Payment header

# Step 2: After payment, retry with credential
curl -X POST https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway \
  -H "Content-Type: application/json" \
  -H "Authorization: Payment <base64url-credential>" \
  -d '{"input": "your query here"}'
```

### Legacy / Sandbox Usage

```bash
curl -X POST https://ai-service-hub-15.emergent.host/api/original-services/llm-gateway \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: sandbox_test" \
  -d '{"input": "your query here"}'
```

## Pricing

- **$0.10** per request
- **Accepted currencies:** ADA, DJED, iUSD, USDCx, USDM (Cardano) | USDC, XLM (Stellar) | XRP, RLUSD (XRPL)
- **Payment protocol:** x402 (Coinbase/Masumi) + MPP (IETF HTTP 402) + Masumi (Cardano escrow) + **AP2** (Google Agent Payments Protocol with XLS-56 Batch on XRPL)
- **Supported chains:** Cardano + Stellar + XRP Ledger
- **Stellar fee sponsorship:** NEXUS pays gas — agents need 0 XLM
- **Free sandbox** available with `X-Payment-Proof: sandbox_test`

## Links

- Platform: [https://ai-service-hub-15.emergent.host](https://ai-service-hub-15.emergent.host)
- x402 Discovery: [https://ai-service-hub-15.emergent.host/api/mpp/x402](https://ai-service-hub-15.emergent.host/api/mpp/x402)
- MPP Discovery: [https://ai-service-hub-15.emergent.host/api/mpp/discover](https://ai-service-hub-15.emergent.host/api/mpp/discover)
- Stablecoin Registry: [https://ai-service-hub-15.emergent.host/api/mpp/stablecoins](https://ai-service-hub-15.emergent.host/api/mpp/stablecoins)
- Stellar Info: [https://ai-service-hub-15.emergent.host/api/mpp/stellar](https://ai-service-hub-15.emergent.host/api/mpp/stellar)
- Fee Sponsorship: [https://ai-service-hub-15.emergent.host/api/mpp/stellar/sponsor-info](https://ai-service-hub-15.emergent.host/api/mpp/stellar/sponsor-info)
- Discovery: [https://ai-service-hub-15.emergent.host/api/discover](https://ai-service-hub-15.emergent.host/api/discover)
- All Skills: [https://ai-service-hub-15.emergent.host/.well-known/skill.md](https://ai-service-hub-15.emergent.host/.well-known/skill.md)
- A2A Agent Card: [https://ai-service-hub-15.emergent.host/.well-known/agent.json](https://ai-service-hub-15.emergent.host/.well-known/agent.json)

## License

Provided by NEXUS Platform. Usage subject to service terms.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)