API Reference

The Kanari Network provides a suite of APIs for developers to interact with the blockchain, manage metadata, and query transaction data.

Authentication

All API requests require an API key passed in the header:

Authorization: Bearer YOUR_API_KEY

Metadata API

Endpoints for managing file metadata on the Kanari Network.

1. Register Metadata

POST /metadata/register

Register new file metadata on-chain.

Request Body:

{
  "file_hash": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "file_name": "document.pdf",
  "owner_address": "0x1234...abcd",
  "metadata": {
    "version": "1.0",
    "description": "Project specifications"
  }
}

Response:

{
  "status": "success",
  "transaction_hash": "0xabc123...",
  "on_chain_id": "meta_98765"
}

2. Get Metadata

GET /metadata/{file_hash}

Retrieve metadata for a specific file hash.

Response:

{
  "file_hash": "sha256:e3b0c4...",
  "owner": "0x1234...",
  "timestamp": "2024-02-04T12:00:00Z",
  "verified": true
}

Wallet & Token API

Endpoints for managing accounts and token operations.

3. Get Balance

GET /accounts/{address}/balance

Returns the token balance for a specific address.

Response:

{
  "address": "0x1234...",
  "balance": 1500.50,
  "currency": "KARI"
}

4. Initiate Transfer

POST /transfer

Send tokens from one account to another.

Request Body:

{
  "to": "0xrecipient...address",
  "amount": 50.0,
  "memo": "Payment for services"
}

Error Codes

The API uses standard HTTP status codes: