ATMN Developer Documentation

Complete API reference, Rosetta integration, and blockchain features

Mining Pool API

RESTful API for interacting with the ATMN Mining Pool. Base URL: https://miningpool.carphatian.ro/api

GET /api/stats

Description: Get current pool statistics including workers, hashrate, and blocks found.

curl /api-docs.html

Response:
{
  "workers_count": 1,
  "active_workers": 1,
  "total_hashrate": 0.0,
  "shares_submitted": 0,
  "blocks_found": 0,
  "pool_fee": 0.02,
  "uptime_seconds": 1795
}
GET /api/workers

Description: List all connected workers with their statistics.

curl https://miningpool.carphatian.ro/api/workers

Response:
[
  {
    "id": "worker-uuid",
    "address": "atmn1...",
    "hashrate": 0.0,
    "shares_submitted": 0,
    "last_share": "2025-12-04T21:35:33Z",
    "connected_at": "2025-12-04T21:35:33Z",
    "is_active": true
  }
]
GET /api/blocks

Description: Get recently found blocks.

curl https://miningpool.carphatian.ro/api/blocks
POST /api/connect

Description: Connect a new worker to the pool.

curl -X POST https://miningpool.carphatian.ro/api/connect \
  -H "Content-Type: application/json" \
  -d '{
    "worker_name": "my-miner-1",
    "address": "YOUR_ATMN_ADDRESS"
  }'

Response:
{
  "worker_id": "uuid",
  "status": "connected",
  "message": "Worker successfully connected"
}
POST /api/submit

Description: Submit a mining share.

curl -X POST https://miningpool.carphatian.ro/api/submit \
  -H "Content-Type: application/json" \
  -d '{
    "worker_id": "YOUR_WORKER_ID",
    "nonce": 12345678,
    "block_height": 1000,
    "hash": "00000abcd..."
  }'

Rosetta API Integration

ATMN implements the Rosetta API specification for blockchain integration with exchanges and wallets.

What is Rosetta?

Rosetta is an open standard designed by Coinbase to simplify blockchain integration. It provides a unified API interface for different blockchains.

Network API

Get network status, options, and list supported networks

Account API

Query account balances and transaction history

Block API

Retrieve block data and transaction details

Construction API

Construct, sign, and submit transactions

Rosetta Endpoints

Endpoint Method Description
/network/list POST Get list of available networks
/network/status POST Get current network status
/network/options POST Get network and version information
/account/balance POST Get account balance
/block POST Get block by identifier
/block/transaction POST Get transaction in a block
/construction/metadata POST Get transaction construction metadata
/construction/submit POST Submit signed transaction
Note: The Rosetta API server runs on port 8080. Full documentation available at rosetta-api.org

Blockchain Features

SHA256d Algorithm

Secure double SHA-256 hashing for block mining

12 Second Blocks

Fast block generation for quick confirmations

50 ATMN Reward

Block reward for miners securing the network

500M Total Supply

Fixed maximum supply of 500,000,000 ATMN

50M Premine

10% premine for development and ecosystem growth

P2P Network

Decentralized peer-to-peer network architecture

Technical Specifications

Parameter Value Description
Consensus Proof of Work (PoW) Mining-based consensus mechanism
Hashing Algorithm SHA256d Double SHA-256 hashing
Block Time 12 seconds Target time between blocks
Block Reward 50 ATMN Initial block reward
Total Supply 500,000,000 ATMN Maximum coin supply
Premine 50,000,000 ATMN (10%) Development fund
Difficulty Adjustment Every block Dynamic difficulty targeting
P2P Port 8333 Default network port
RPC Port 8332 JSON-RPC interface port

SDKs & Libraries

Rust SDK

Official Rust implementation for ATMN blockchain integration

# Add to Cargo.toml
[dependencies]
atmn-core = "0.1.0"
atmn-rosetta = "0.1.0"

# Example usage
use atmn_core::Blockchain;

let blockchain = Blockchain::new();
let block = blockchain.get_latest_block();

JavaScript/Node.js

Connect to ATMN network using standard HTTP clients

// Fetch pool stats
const response = await fetch('/api-docs.html');
const stats = await response.json();
console.log('Active workers:', stats.active_workers);

Python

Python SDK for ATMN API integration

import requests

# Get pool statistics
response = requests.get('/api-docs.html')
stats = response.json()
print(f"Total hashrate: {stats['total_hashrate']} H/s")

Getting Started

1. Run a Full Node

git clone https://github.com/antimony/atmn-core
cd atmn-core
cargo build --release
./target/release/atmn-node

2. Start Mining

Connect to the mining pool: Mining Guide

3. Use the Web Wallet

Manage your ATMN: Web Wallet Interface

4. Explore the Blockchain

View blocks and transactions: Block Explorer