RAINARAINAOpen Cloud
RAINA DEVELOPERS

Build with RAINA.
Start in test mode.

Connect your product to scoped RAINA account, activity, launch and Agent data plus signed production events. Create a test project first, then request production access when your integration is ready.

QUICKSTART

Four steps from idea
to a working connection.

01

Create a test project

Open RAINA Cloud and create a project. Test projects are free and separate from production.

02

Create a scoped key

Choose only the access your app needs. The full key is shown once.

03

Call a RAINA API

Use your key as a Bearer token for account, activity, launch or Agent reads allowed by that project.

04

Add signed events

Approved production projects can receive HMAC-signed payment, launch, Market, Agent and Support events at an HTTPS endpoint.

AUTHENTICATION

Use a project key.

Send the key in the Authorization header. Keep production keys on your server, never inside public browser code.

Authorization: Bearer rk_live_...
KEY CONTROL

Give each key one job.

Scopes cover account, payments, orders, support, activity, launches, Agent and webhook management. Every Cloud request is tied to a project/key and can be revoked.

ENVIRONMENTS

Test safely.
Go live deliberately.

TEST

Build before you pay

Create projects and keys, connect your app and validate response shapes without exposing live customer records.

Free test workspace
PRODUCTION

Live access is reviewed

A paid Cloud plan and production approval are required before a project can issue live credentials and receive live signed webhooks.

Separate activation
WEBHOOKS

Receive signed RAINA events.

Production projects can subscribe to payment.status_changed, launch.status_changed, market.order.status_changed, agent.run.completed and support.ticket.status_changed. Delivery status is recorded in Cloud.

SECURITY

Keys are not wallets.

Cloud keys expose scoped application data only. They do not expose seed phrases, private keys or silent signing authority. Money-moving actions keep their normal product and wallet approvals.

CURRENT API

Use what is
actually available.

GET/api/cloud/v1/account

Account counts allowed by the key's account/payment/order/support scopes.

GET/api/cloud/v1/activity?limit=50

Recent verified RAINA activity for the authenticated Cloud owner.

GET/api/cloud/v1/launches?limit=50

Safe Launch project state for the authenticated Cloud owner.

GET/api/cloud/v1/agent?limit=50

Agent workflow state without wallet execution authority.

SCOPESread · activity:read · launches:read · agent:read

Use the smallest scope set your integration needs; payment/order/support scopes remain independently selectable.

EVENTSpayment · launch · market · agent · support

HMAC-signed production events include a stable RAINA event ID for reconciliation.

PUBLIC NAMES/api/raina/names/resolve?name=name.raina

Resolve active .raina payment records without a Cloud key. Names docs →

ESM SDK/sdk/raina-names.js

Browser-ready public resolver helpers for wallets, dApps and checkout integrations.

DISCOVERY/.well-known/raina-names.json

Machine-readable resolver, SDK and supported-network metadata.

RAINARAINA CLOUD + DEVELOPERS

Build in test mode.
Move to production when ready.

YOUR PRIVACY

You choose what is optional.

Essential storage keeps requested RAINA features working. Analytics and session replay stay off unless you allow them.

Cookies & device storage