# CloudWorldModel Wallet Auth x402 Session

> CloudWorldModel Wallet Auth x402 Session is a paid API for AI agents from www.cloudworldmodel.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Issues a 24-hour wallet session JWT by processing a one-time USDC micro-payment via the x402 payment protocol.

## Facts

- Endpoint: POST https://www.cloudworldmodel.ai/api/wallet-auth/x402-session
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cloudworldmodel-wallet-auth-x402-session-f3e8519f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dMwSuO7hS5euYSOKuFiPz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cloudworldmodel-wallet-auth-x402-session-f3e8519f -d '<json body>'
```

Example prompt: Get me a 24-hour wallet session JWT from CloudWorldModel by paying the $0.001 USDC micro-payment — I need to authenticate so I can start making API calls to the simulation endpoints.

## When to prefer this

Use this endpoint when you need to establish an authenticated session with cloudworldmodel.ai before calling simulation, RL training, or cloud evaluation endpoints. This is the required first step when no valid session JWT exists or when the prior 24-hour session has expired. It is specifically designed for x402 USDC micro-payment-based authentication flows.

## Known failure modes

- Payment insufficient or invalid USDC amount — returns payment error
- x402 payment header missing or malformed — returns 402 Payment Required
- Session already active and not expired — may return conflict or existing token
- Network or blockchain settlement delay — timeout or pending status
- Invalid wallet address or signature — authentication failure

## How this service works

Simulate AWS, GCP, Azure, OCI, and DigitalOcean cloud infrastructure without provisioning real resources. Built for Canvas Cloud AI learners and agents.

## Output

Returns a wallet session JWT valid for 24 hours along with a settlement confirmation object, enabling authenticated access to other cloudworldmodel.ai endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string"
    },
    "bodyType": {
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "settlement": {
       "type": "object"
      },
      "walletSession": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "settlement": {
   "status": "confirmed",
   "transactionHash": "0xabc123..."
  },
  "walletSession": {
   "token": "<jwt>",
   "expiresAt": "2024-01-02T00:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cloudworldmodel-wallet-auth-x402-session-f3e8519f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.cloudworldmodel.ai](https://www.zero.xyz/host/www.cloudworldmodel.ai/llms.txt)
