==================================================
PROJECT NAME
RONANIS API BLOCKCHAIN
==================================================

NETWORK TYPE: TEST
CURRENCY: BTC (TESTNET)

VERSION: V2
STATUS: STABLE (TESTING)
DATE: 2026-01-18

--------------------------------------------------
NOTICE
--------------------------------------------------

THIS IS A TEST NETWORK.

This protocol operates on Bitcoin TESTNET.
No real monetary value is involved.

Use this version for:
- Development
- Integration testing
- Automation testing
- Learning and experimentation

Production version is available at:
https://ronanis.com

==================================================
PHILOSOPHY
==================================================

RONANIS is not a wallet.
RONANIS is not an exchange.
RONANIS is not a website.

RONANIS is a blockchain API protocol.

Bitcoin is the blockchain.
The node is the system.
The API is the interface.

Developers build.
The node executes.
Bitcoin settles.

==================================================
DESIGN PRINCIPLES
==================================================

- Single blockchain: Bitcoin (TESTNET)
- Single unit: Satoshi
- Single interface: HTTP API
- Single tool: curl

No UI  
No SDK  
No sessions  
No cookies  

Everything is explicit.  
Everything is programmable.  
Everything is deterministic.

==================================================
API ACCESS
==================================================

Endpoint:
POST https://ronanis.org/api/

Headers:
X-RON-KEY: <KEY>
Content-Type: application/json

All operations are POST.
Action is defined by the `mode` query parameter.

==================================================
CORE MODES (STABLE)
==================================================

Key:
- key_create
- key_status

Wallet:
- wallet_create
- wallet_list
- wallet_balance
- wallet_send

Inbox (Receive):
- inbox_create
- inbox_refresh

System:
- health

==================================================
CURL — VERIFIED WORKING (COPY / PASTE)
==================================================

1) Create KEY (Public)

curl -sS -X POST "https://ronanis.org/api/?mode=key_create" \
  -H "Content-Type: application/json" \
  -d '{}'

--------------------------------------------------

2) Key Status

curl -sS -X POST "https://ronanis.org/api/?mode=key_status" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{}'

--------------------------------------------------

3) Create Wallet (TESTNET)

curl -sS -X POST "https://ronanis.org/api/?mode=wallet_create" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"net":"test"}'

--------------------------------------------------

4) List Wallets

curl -sS -X POST "https://ronanis.org/api/?mode=wallet_list" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{}'

--------------------------------------------------

5) Wallet Balance

curl -sS -X POST "https://ronanis.org/api/?mode=wallet_balance" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"wallet_id":"w_XXXXXXXXXXXX"}'

==================================================
RECEIVE FLOW (INBOX)
==================================================

6) Create Inbox (Receive Address)

curl -sS -X POST "https://ronanis.org/api/?mode=inbox_create" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"wallet_id":"w_XXXXXXXXXXXX","expected_sat":10000}'

Response address format:
tb1...

--------------------------------------------------

7) Refresh Inbox

curl -sS -X POST "https://ronanis.org/api/?mode=inbox_refresh" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"inbox_id":"i_XXXXXXXXXXXX"}'

Inbox States:
- created
- seen_0conf
- confirmed_1

==================================================
SEND FLOW (TESTNET)
==================================================

8) Send Bitcoin (TESTNET only)

curl -sS -X POST "https://ronanis.org/api/?mode=wallet_send" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id":"w_XXXXXXXXXXXX",
    "to":"tb1...",
    "amount_sat":50000,
    "speed":"normal"
  }'

==================================================
SYSTEM
==================================================

9) Health Check

curl -sS -X POST "https://ronanis.org/api/?mode=health" \
  -H "X-RON-KEY: RON-XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{}'

==================================================
RESPONSIBILITY MODEL
==================================================

RONANIS provides infrastructure only.
Developers define behavior.
Bitcoin enforces rules.

==================================================
FINAL STATEMENT
==================================================

RONANIS API BLOCKCHAIN (TESTNET)
is a testing protocol.

No guarantees.
No real value.
No production promises.

Use at your own risk.

==================================================
DOCUMENT INTEGRITY
==================================================

DATE: 2026-01-18
NETWORK: TESTNET
HASH (SHA256):
<GENERATE_AFTER_PUBLISH>

==================================================
END OF DOCUMENT
==================================================

==================================================

DATE: 2026-01-19
HASH (SHA256):
bc27b7f38550376349ba726971a54b79a7e1c64d0f4c7c416d01b527f86fcadd

==================================================
END OF DOCUMENT